Signed-off-by: Dave Reisner
---
Makefile | 14 +--
lsinitcpio.1.txt | 68 -----------
man/lsinitcpio.1.txt | 68 +++++++++++
man/mkinitcpio.8.txt | 297 ++++++++++++++++++++++++++++++++++++++++++++++
man/mkinitcpio.conf.5.txt | 82 +++++++++++++
mkinitcpio.8.txt | 297 ----------------------------------------------
mkinitcpio.conf.5.txt | 82 -------------
7 files changed, 454 insertions(+), 454 deletions(-)
delete mode 100644 lsinitcpio.1.txt
create mode 100644 man/lsinitcpio.1.txt
create mode 100644 man/mkinitcpio.8.txt
create mode 100644 man/mkinitcpio.conf.5.txt
delete mode 100644 mkinitcpio.8.txt
delete mode 100644 mkinitcpio.conf.5.txt
diff --git a/Makefile b/Makefile
index 88f82db..756d42f 100644
--- a/Makefile
+++ b/Makefile
@@ -16,9 +16,9 @@ DIRS = \
all: doc
MANPAGES = \
- mkinitcpio.8 \
- mkinitcpio.conf.5 \
- lsinitcpio.1
+ man/mkinitcpio.8 \
+ man/mkinitcpio.conf.5 \
+ man/lsinitcpio.1
install: all
mkdir -p $(DESTDIR)
@@ -47,14 +47,14 @@ install: all
cp -at $(DESTDIR)/usr/lib/initcpio/install install/*
cp -at $(DESTDIR)/etc/mkinitcpio.d mkinitcpio.d/*
- install -m644 mkinitcpio.8 $(DESTDIR)/usr/share/man/man8/mkinitcpio.8
- install -m644 mkinitcpio.conf.5 $(DESTDIR)/usr/share/man/man5/mkinitcpio.conf.5
- install -m644 lsinitcpio.1 $(DESTDIR)/usr/share/man/man1/lsinitcpio.1
+ install -m644 man/mkinitcpio.8 $(DESTDIR)/usr/share/man/man8/mkinitcpio.8
+ install -m644 man/mkinitcpio.conf.5 $(DESTDIR)/usr/share/man/man5/mkinitcpio.conf.5
+ install -m644 man/lsinitcpio.1 $(DESTDIR)/usr/share/man/man1/lsinitcpio.1
install -m644 bash-completion $(DESTDIR)/usr/share/bash-completion/completions/mkinitcpio
ln -s mkinitcpio $(DESTDIR)/usr/share/bash-completion/completions/lsinitcpio
doc: $(MANPAGES)
-%: %.txt Makefile
+man/%: man/%.txt Makefile
a2x -d manpage \
-f manpage \
-a manversion=$(VERSION) \
diff --git a/lsinitcpio.1.txt b/lsinitcpio.1.txt
deleted file mode 100644
index 98bd756..0000000
--- a/lsinitcpio.1.txt
+++ /dev/null
@@ -1,68 +0,0 @@
-/////
-vim:set ts=4 sw=4 syntax=asciidoc noet:
-/////
-lsinitcpio(1)
-=============
-
-Name
-----
-lsinitcpio - Examine an initramfs
-
-Synopsis
---------
-'lsinitcpio' [action] [options] 'image'
-
-Description
------------
-Examines the contents of an initcpio image. Without any options, 'lsinitcpio'
-simply lists the contents of an image.
-
-Actions
--------
-*-a, \--analyze*::
- Analyze the contents of the specified image and print output in human
- readable form.
-
-*-c, \--config*::
- Show the configuration file the given image was built with.
-
-*-l, \--list*::
- List the contents of the archive. This is the default action. Pass the *-v*
- flag for more detailed results.
-
-*-x, \--extract*::
- Extract the given image to the current working directory.
-
-Options
--------
-
-*-h, \--help*::
- Output a short overview of available command-line switches.
-
-*-n, \--nocolor*::
- Disable color output.
-
-*-V, \--version*::
- Display version information.
-
-*-v, \--verbose*::
- Be more verbose. In particular, show long style output when listing
- the contents of an image, and show files as they are extracted when
- the *-x* option is given.
-
-Bugs
-----
-Upon writing this manpage, there were no noticeable bugs present. Please visit
-http://bugs.archlinux.org/ for an up to date list.
-
-See Also
---------
-*mkinitcpio*(8)
-
-Authors
--------
-lsinitcpio was created by Dave Reisner
-
-Copyright
----------
-Copyright (c) Arch Linux 2011-2012
diff --git a/man/lsinitcpio.1.txt b/man/lsinitcpio.1.txt
new file mode 100644
index 0000000..98bd756
--- /dev/null
+++ b/man/lsinitcpio.1.txt
@@ -0,0 +1,68 @@
+/////
+vim:set ts=4 sw=4 syntax=asciidoc noet:
+/////
+lsinitcpio(1)
+=============
+
+Name
+----
+lsinitcpio - Examine an initramfs
+
+Synopsis
+--------
+'lsinitcpio' [action] [options] 'image'
+
+Description
+-----------
+Examines the contents of an initcpio image. Without any options, 'lsinitcpio'
+simply lists the contents of an image.
+
+Actions
+-------
+*-a, \--analyze*::
+ Analyze the contents of the specified image and print output in human
+ readable form.
+
+*-c, \--config*::
+ Show the configuration file the given image was built with.
+
+*-l, \--list*::
+ List the contents of the archive. This is the default action. Pass the *-v*
+ flag for more detailed results.
+
+*-x, \--extract*::
+ Extract the given image to the current working directory.
+
+Options
+-------
+
+*-h, \--help*::
+ Output a short overview of available command-line switches.
+
+*-n, \--nocolor*::
+ Disable color output.
+
+*-V, \--version*::
+ Display version information.
+
+*-v, \--verbose*::
+ Be more verbose. In particular, show long style output when listing
+ the contents of an image, and show files as they are extracted when
+ the *-x* option is given.
+
+Bugs
+----
+Upon writing this manpage, there were no noticeable bugs present. Please visit
+http://bugs.archlinux.org/ for an up to date list.
+
+See Also
+--------
+*mkinitcpio*(8)
+
+Authors
+-------
+lsinitcpio was created by Dave Reisner
+
+Copyright
+---------
+Copyright (c) Arch Linux 2011-2012
diff --git a/man/mkinitcpio.8.txt b/man/mkinitcpio.8.txt
new file mode 100644
index 0000000..f19250f
--- /dev/null
+++ b/man/mkinitcpio.8.txt
@@ -0,0 +1,297 @@
+/////
+vim:set ts=4 sw=4 syntax=asciidoc noet:
+/////
+mkinitcpio(8)
+=============
+
+Name
+----
+mkinitcpio - Create an initial ramdisk environment
+
+Synopsis
+--------
+'mkinitcpio' [options]
+
+Description
+-----------
+Creates an initial ramdisk environment for booting the linux kernel. The
+initial ramdisk is in essence a very small environment (early userspace) which
+loads various kernel modules and sets up necessary things before handing over
+control to init. This makes it possible to have, for example, encrypted root
+filesystems and root filesystems on a software RAID array. mkinitcpio allows
+for easy extension with custom hooks, has autodetection at runtime, and many
+other features.
+
+Options
+-------
+*-A, \--addhooks* 'hooks'::
+ Add the additional 'hooks' to the image. These will be processed in order
+ after all other hooks from the config file. Multiple hooks should be
+ comma-separated. This option can be specified multiple times.
+
+*-c, \--config* 'config'::
+ Use 'config' file to generate the ramdisk. Default: /etc/mkinitcpio.conf
+
+*-g, \--generate* 'filename'::
+ Generate a CPIO image as 'filename'. Default: no; this means nothing will be
+ written to the filesystem unless this option is specified.
+
+*-H, \--hookhelp* 'hookname'::
+ Output help for hookname 'hookname'.
+
+*-h, \--help*::
+ Output a short overview of available command-line switches.
+
+*-k, \--kernel* 'kernelversion'::
+ Use 'kernelversion', instead of the current running kernel. This may be a
+ path to a kernel image or a specific kernel version.
+
+*-L, \--listhooks*::
+ List all available hooks.
+
+*-M, \--automods*::
+ Display modules found via autodetection. mkinitcpio will automatically try to
+ determine which kernel modules are needed to start your computer. This option
+ lists which modules were detected.
+
+*-n, \--nocolor*::
+ Disable color output.
+
+*-p, \--preset* 'preset'::
+ Build initramfs image(s) according to specified 'preset'. This may be a file in
+ /etc/mkinitcpio.d (without the .preset extension) or a full, absolute path to a
+ file.
+
+*-r, \--moduleroot* 'root'::
+ Specifies the root directory to find modules in, defaulting to '/'.
+
+*-S, \--skiphooks* 'hooks'::
+ Skip 'hooks' when generating the image. Multiple hooks should be comma-separated.
+ This option can be specified multiple times.
+
+*-s, \--save*::
+ Saves the build directory for the initial ramdisk. Default: no; This means
+ the directory will not be retained if this option isn't specified. Useful for
+ debugging purposes.
+
+*-t, \--builddir* 'tmpdir'::
+ Use 'tmpdir' as the temporary build directory instead of /tmp. 'tmpdir'
+ must exist. The 'TMPDIR' environment variable is also honored to set this
+ location, but the command line option will take precedence.
+
+*-V, \--version*::
+ Display version information.
+
+*-v, \--verbose*::
+ Verbose output. Outputs more information about what's happening during
+ creation of the ramdisk.
+
+*-z, \--compress* 'compress'::
+ Override the compression method with the 'compress' program.
+
+About Presets
+-------------
+A preset is a pre-defined definition on how to create an initial ramdisk.
+Instead of specifying the configuration file and which output file, every time
+you generate a new initial ramdisk, you define a preset and use the -p switch
+to generate an initial ramdisk according to your preset. Presets are located in
+/etc/mkinitcpio.d
+
+About Install Hooks
+-------------------
+Install hooks are bash scripts which are sourced during mkinitcpio runtime in
+order to add modules, binaries, and other files to the image. A variety of
+functions exist to facilitate this.
+
+*add_module* 'modname'::
+
+ Adds the module specified by 'modname' to the image. Dependencies are derived
+ and added automatically.
+
+*add_binary* 'binary' [ 'destination' ] [ 'mode' ]::
+
+ Adds a binary to the image. The argument 'binary' need not be an absolute
+ path and, if needed, a lookup will be performed. If the binary is a dynamically
+ linked ELF binary, dependencies will be automatically added. Optionally, a
+ destination within the initramfs image as well as a file mode can be specified.
+ By default, the destintation and mode be taken from the source derived from
+ 'binary'.
+
+*add_file* 'path' [ 'destination' ] [ 'mode' ]::
+
+ Adds a file and any needed parent directories to the image. Optionally, a
+ destination within the initramfs image as well as a file mode can be specified.
+ By default, the destination and mode will be taken from the source and mode of
+ the file specified by the 'path'.
+
+*add_dir* 'path'::
+
+ Adds a directory and its parents to the image.
+
+*add_full_dir* 'directory'::
+
+ Recursively adds a directory to the image by walking the given path and
+ calling *add_file*, *add_dir*, and *add_symlink* accordingly. This function
+ will not follow symlinks, nor will it add the targets of symlinks.
+
+*add_symlink* 'path' [ 'link-target' ]::
+
+ Adds a symlink to the image at the specified `path`, optionally pointing to
+ the specified `link-target`. If the `link-target` is not provided, it is assumed
+ that this symlink exists in the real filesystem, and the target will be read
+ using readlink. There is no checking done to ensure that the target of the
+ symlink exists, and symlinks will not be followed recursively.
+
+*add_all_modules* [ '-f filter' ] *pattern*::
+
+ Adds modules to the image, without regard for the autodetect whitelist. *pattern*
+ should be a subdirectory within the kernel tree describing a subset of modules to
+ be included. Further refinement can be provided via the -f flag with an extended
+ regular expression.
+
+*add_checked_modules* [ '-f filter' ] *pattern*::
+
+ Similar to *add_all_modules* with the constraint that only modules matching the
+ whitelist generated by the autodetect hook will be added to the image. If the
+ autodetect hook is not present in the image, this function is identical to
+ *add_all_modules*.
+
+*add_runscript* [ 'scriptname' ]::
+
+ Adds a runtime hook to the image, which is a busybox ash compatible shell
+ script. The name of the script is guaranteed to match the name of the hook the
+ script is called from.
+
+About Runtime Hooks
+-------------------
+Runtime hooks added to the image via the *add_runscript* function from an
+install hook are able to provide extra functionality during early userspace.
+Specific functions in these files will run at different times. A hook can
+define one or more of these. At each hook point, hooks are run in the order
+that they are defined in the HOOKS variable, except for cleanup hooks which are
+run in reverse.
+
+*run_earlyhook*::
+
+ Functions of this name will be run once the API mounts have been setup and the
+ kernel command line has been parsed. Daemons needed for early userspace should
+ be started from this hook point.
+
+*run_hook*::
+
+ Functions of this name will be run after any early hooks, and after user
+ defined modules have been installed. This is the most common hook point, and
+ functionality such as scanning for LVM volumes and mapping encrypted volumes
+ should be performed here.
+
+*run_latehook*::
+
+ Functions of this name will be run after root has been mounted. This is generally
+ used for further necessary setup in the real root, such as mounting other system
+ partitions.
+
+*run_cleanuphook*::
+
+ Functions of this name are run as late as possible. Any daemons started
+ from a run_earlyhook function should be shut down here in preparation for
+ switching to the real root.
+
+Early Init Environment
+----------------------
+mkinitcpio gives special treatment to certain environment variables passed on
+the kernel command line:
+
+*break*['=']::
+ If specified, mkinitcpio will start a shell during early init. The optional
+ parameter controls when this occurs: when 'premount' or no parameter are
+ specified, the shell will be launched prior to mounting root. If 'postmount'
+ is specified, the shell will be launched after mounting root.
+
+*disablehooks=*'hooklist'::
+ This is a comma separated list of hooks which will be skipped during early
+ init.
+
+*earlymodules=*'modulelist'::
+ This is a comma separated list of modules which will be loaded prior to any
+ others. This is generally not needed, and usually points to a configuration
+ or kernel problem.
+
+*quiet*::
+ Causes mkinitcpio to output fewer messages during boot. Errors will not be
+ suppressed.
+
+*ro*::
+ Specifies that root should be mounted with readonly permissions. This is the
+ default behavior.
+
+*rw*::
+ Specifies that root should be mounted with readwrite permissions. This is
+ generally only useful if your initramfs uses the 'fsck' hook.
+
+*root=*'rootdevice'::
+ This variable describes the root partition which early init will mount
+ before passing control to the real init. mkinitcpio understands a variety of
+ formats, the most basic of which is the path to the block device, either
+ directly such as '/dev/sda2', or using a udev symlink such as
+ '/dev/disk/by-label/CorsairF80-root'. Support for identification by LABEL or
+ UUID tags are also supported, such as, 'LABEL=CorsairF80-root'. As of
+ util-linux 2.22, PARTUUID is also supported. Identification via hex encoded
+ major/minor device ID is supported for legacy reasons, but should not be used.
+
+*rootdelay=*'seconds'::
+ Sets the delay, in seconds, that mkinitcpio is willing to wait for the root
+ device to show up, if it is not available immediately. This defaults to 5
+ seconds. If an invalid integer is passed, this variable will have no effect.
+
+These are only the variables that the core of mkinitcpio honor. Additional
+hooks may look for other environment variables and should be documented by the
+help output for the hook.
+
+Files
+-----
+'/etc/mkinitcpio.conf'::
+ Default configuration file for mkinitcpio.
+
+'/etc/mkinitcpio.d'::
+ Folder containing mkinitcpio presets.
+
+'/usr/lib/initcpio/install'::
+'/lib/initcpio/install'::
+ Search path for build time hooks.
+
+'/usr/lib/initcpio/hooks'::
+'/lib/initcpio/hooks'::
+ Search path for early userspace runtime hooks.
+
+Examples
+--------
+*mkinitcpio*::
+ Perform a 'dry-run'. This will generate an initial ramdisk but will not
+ write anything. Use -g to create the real image.
+
+*mkinitcpio -p linux*::
+ Create an initial ramdisk based on the 'linux' preset.
+
+*mkinitcpio -g /boot/initramfs-linux.img -k /boot/vmlinuz-linux*::
+ Create an initial ramdisk for the kernel at /boot/vmlinuz-linux. The
+ resulting image will be written to /boot/initramfs-linux.img.
+
+See also
+--------
+A more thorough article on configuring mkinitcpio:
+http://wiki.archlinux.org/index.php/Mkinitcpio
+
+*initrd*(4), *lsinitcpio*(1), *mkinitcpio.conf*(5)
+
+Bugs
+----
+Upon writing this manpage, there were no noticeable bugs present. Please visit
+http://bugs.archlinux.org/ for an up to date list.
+
+Authors
+-------
+mkinitcpio is created and maintained by the Arch Linux Developer community.
+
+Copyright
+---------
+Copyright (c) Arch Linux 2006-2012
diff --git a/man/mkinitcpio.conf.5.txt b/man/mkinitcpio.conf.5.txt
new file mode 100644
index 0000000..c2519c9
--- /dev/null
+++ b/man/mkinitcpio.conf.5.txt
@@ -0,0 +1,82 @@
+/////
+vim:set ts=4 sw=4 syntax=asciidoc noet:
+/////
+mkinitcpio.conf(5)
+==================
+
+Name
+----
+mkinitcpio.conf - mkinitcpio configuration file
+
+Synopsis
+--------
+/etc/mkinitcpio.conf
+
+Description
+-----------
+mkinitcpio will attempt to read from a config file each time it is invoked,
+`/etc/mkinitcpio.conf' by default. This file defines several variables which
+describe the contents of the image to be generated.
+
+Variables
+---------
+*MODULES*::
+
+ Defines additional modules, space delimited, which should be added to the
+ image. Dependencies (including other modules and necessary firmware), will
+ also be added to the image. At runtime, the modules in this array which
+ were successfully added to the image will be explicitly loaded.
+
+*FILES*::
+
+ Defines additional files, space delimited, which should be added to the image.
+ Files are added as is, and parent directories will be added if needed. Files
+ specified in this variable will override previously added files of the same
+ path.
+
+*BINARIES*::
+
+ Defines additional binaries, space delimited, which should be added to the
+ image. These are assumed to be dynamic ELF binaries, and necessary shared
+ library dependencies will automatically be added. However, it is not
+ considered an error to specify a non-ELF binary in this variable. Parent
+ directories will be added if needed. Files specified in this variable will
+ override previously added files of the same path.
+
+*HOOKS*::
+
+ This variable defines the hooks which will be run during the build process.
+ Order is important, as it defines the order in which hooks will be run
+ during bootup. Use mkinitcpio's '-L' flag to list all available hooks,
+ and the '-H' flag to display the help text for a specific hook.
+
+*COMPRESSION*::
+
+ Defines a program to filter the generated image through. As of linux 2.6.38,
+ the kernel understands the compression formats yielded by the *gzip*, *bzip2*,
+ *lzop*, *lzma*, and *xz* compressors. If unspecified, this setting defaults to
+ *gzip* compression. In order to create an uncompressed image, define this
+ variable as *cat*.
++
+It's not hard to realize that a filter such as a *tac* or *rev* will cause
+*mkinitcpio* to report success but generate a useless image. Similarly, using a
+compression program not listed above may generate an equally useless image,
+despite being "valid".
+
+*COMPRESSION_OPTIONS*::
+
+ Defines additional options to be passed to the compression program. This option
+ is generally not used. It can be potentially dangerous and may cause
+ invalid images to be generated without any sign of an error.
+
+See Also
+--------
+*mkinitcpio*(8)
+
+Authors
+-------
+mkinitcpio is created and maintained by the Arch Linux Developer community.
+
+Copyright
+---------
+Copyright (c) Arch Linux 2006-2012
diff --git a/mkinitcpio.8.txt b/mkinitcpio.8.txt
deleted file mode 100644
index f19250f..0000000
--- a/mkinitcpio.8.txt
+++ /dev/null
@@ -1,297 +0,0 @@
-/////
-vim:set ts=4 sw=4 syntax=asciidoc noet:
-/////
-mkinitcpio(8)
-=============
-
-Name
-----
-mkinitcpio - Create an initial ramdisk environment
-
-Synopsis
---------
-'mkinitcpio' [options]
-
-Description
------------
-Creates an initial ramdisk environment for booting the linux kernel. The
-initial ramdisk is in essence a very small environment (early userspace) which
-loads various kernel modules and sets up necessary things before handing over
-control to init. This makes it possible to have, for example, encrypted root
-filesystems and root filesystems on a software RAID array. mkinitcpio allows
-for easy extension with custom hooks, has autodetection at runtime, and many
-other features.
-
-Options
--------
-*-A, \--addhooks* 'hooks'::
- Add the additional 'hooks' to the image. These will be processed in order
- after all other hooks from the config file. Multiple hooks should be
- comma-separated. This option can be specified multiple times.
-
-*-c, \--config* 'config'::
- Use 'config' file to generate the ramdisk. Default: /etc/mkinitcpio.conf
-
-*-g, \--generate* 'filename'::
- Generate a CPIO image as 'filename'. Default: no; this means nothing will be
- written to the filesystem unless this option is specified.
-
-*-H, \--hookhelp* 'hookname'::
- Output help for hookname 'hookname'.
-
-*-h, \--help*::
- Output a short overview of available command-line switches.
-
-*-k, \--kernel* 'kernelversion'::
- Use 'kernelversion', instead of the current running kernel. This may be a
- path to a kernel image or a specific kernel version.
-
-*-L, \--listhooks*::
- List all available hooks.
-
-*-M, \--automods*::
- Display modules found via autodetection. mkinitcpio will automatically try to
- determine which kernel modules are needed to start your computer. This option
- lists which modules were detected.
-
-*-n, \--nocolor*::
- Disable color output.
-
-*-p, \--preset* 'preset'::
- Build initramfs image(s) according to specified 'preset'. This may be a file in
- /etc/mkinitcpio.d (without the .preset extension) or a full, absolute path to a
- file.
-
-*-r, \--moduleroot* 'root'::
- Specifies the root directory to find modules in, defaulting to '/'.
-
-*-S, \--skiphooks* 'hooks'::
- Skip 'hooks' when generating the image. Multiple hooks should be comma-separated.
- This option can be specified multiple times.
-
-*-s, \--save*::
- Saves the build directory for the initial ramdisk. Default: no; This means
- the directory will not be retained if this option isn't specified. Useful for
- debugging purposes.
-
-*-t, \--builddir* 'tmpdir'::
- Use 'tmpdir' as the temporary build directory instead of /tmp. 'tmpdir'
- must exist. The 'TMPDIR' environment variable is also honored to set this
- location, but the command line option will take precedence.
-
-*-V, \--version*::
- Display version information.
-
-*-v, \--verbose*::
- Verbose output. Outputs more information about what's happening during
- creation of the ramdisk.
-
-*-z, \--compress* 'compress'::
- Override the compression method with the 'compress' program.
-
-About Presets
--------------
-A preset is a pre-defined definition on how to create an initial ramdisk.
-Instead of specifying the configuration file and which output file, every time
-you generate a new initial ramdisk, you define a preset and use the -p switch
-to generate an initial ramdisk according to your preset. Presets are located in
-/etc/mkinitcpio.d
-
-About Install Hooks
--------------------
-Install hooks are bash scripts which are sourced during mkinitcpio runtime in
-order to add modules, binaries, and other files to the image. A variety of
-functions exist to facilitate this.
-
-*add_module* 'modname'::
-
- Adds the module specified by 'modname' to the image. Dependencies are derived
- and added automatically.
-
-*add_binary* 'binary' [ 'destination' ] [ 'mode' ]::
-
- Adds a binary to the image. The argument 'binary' need not be an absolute
- path and, if needed, a lookup will be performed. If the binary is a dynamically
- linked ELF binary, dependencies will be automatically added. Optionally, a
- destination within the initramfs image as well as a file mode can be specified.
- By default, the destintation and mode be taken from the source derived from
- 'binary'.
-
-*add_file* 'path' [ 'destination' ] [ 'mode' ]::
-
- Adds a file and any needed parent directories to the image. Optionally, a
- destination within the initramfs image as well as a file mode can be specified.
- By default, the destination and mode will be taken from the source and mode of
- the file specified by the 'path'.
-
-*add_dir* 'path'::
-
- Adds a directory and its parents to the image.
-
-*add_full_dir* 'directory'::
-
- Recursively adds a directory to the image by walking the given path and
- calling *add_file*, *add_dir*, and *add_symlink* accordingly. This function
- will not follow symlinks, nor will it add the targets of symlinks.
-
-*add_symlink* 'path' [ 'link-target' ]::
-
- Adds a symlink to the image at the specified `path`, optionally pointing to
- the specified `link-target`. If the `link-target` is not provided, it is assumed
- that this symlink exists in the real filesystem, and the target will be read
- using readlink. There is no checking done to ensure that the target of the
- symlink exists, and symlinks will not be followed recursively.
-
-*add_all_modules* [ '-f filter' ] *pattern*::
-
- Adds modules to the image, without regard for the autodetect whitelist. *pattern*
- should be a subdirectory within the kernel tree describing a subset of modules to
- be included. Further refinement can be provided via the -f flag with an extended
- regular expression.
-
-*add_checked_modules* [ '-f filter' ] *pattern*::
-
- Similar to *add_all_modules* with the constraint that only modules matching the
- whitelist generated by the autodetect hook will be added to the image. If the
- autodetect hook is not present in the image, this function is identical to
- *add_all_modules*.
-
-*add_runscript* [ 'scriptname' ]::
-
- Adds a runtime hook to the image, which is a busybox ash compatible shell
- script. The name of the script is guaranteed to match the name of the hook the
- script is called from.
-
-About Runtime Hooks
--------------------
-Runtime hooks added to the image via the *add_runscript* function from an
-install hook are able to provide extra functionality during early userspace.
-Specific functions in these files will run at different times. A hook can
-define one or more of these. At each hook point, hooks are run in the order
-that they are defined in the HOOKS variable, except for cleanup hooks which are
-run in reverse.
-
-*run_earlyhook*::
-
- Functions of this name will be run once the API mounts have been setup and the
- kernel command line has been parsed. Daemons needed for early userspace should
- be started from this hook point.
-
-*run_hook*::
-
- Functions of this name will be run after any early hooks, and after user
- defined modules have been installed. This is the most common hook point, and
- functionality such as scanning for LVM volumes and mapping encrypted volumes
- should be performed here.
-
-*run_latehook*::
-
- Functions of this name will be run after root has been mounted. This is generally
- used for further necessary setup in the real root, such as mounting other system
- partitions.
-
-*run_cleanuphook*::
-
- Functions of this name are run as late as possible. Any daemons started
- from a run_earlyhook function should be shut down here in preparation for
- switching to the real root.
-
-Early Init Environment
-----------------------
-mkinitcpio gives special treatment to certain environment variables passed on
-the kernel command line:
-
-*break*['=']::
- If specified, mkinitcpio will start a shell during early init. The optional
- parameter controls when this occurs: when 'premount' or no parameter are
- specified, the shell will be launched prior to mounting root. If 'postmount'
- is specified, the shell will be launched after mounting root.
-
-*disablehooks=*'hooklist'::
- This is a comma separated list of hooks which will be skipped during early
- init.
-
-*earlymodules=*'modulelist'::
- This is a comma separated list of modules which will be loaded prior to any
- others. This is generally not needed, and usually points to a configuration
- or kernel problem.
-
-*quiet*::
- Causes mkinitcpio to output fewer messages during boot. Errors will not be
- suppressed.
-
-*ro*::
- Specifies that root should be mounted with readonly permissions. This is the
- default behavior.
-
-*rw*::
- Specifies that root should be mounted with readwrite permissions. This is
- generally only useful if your initramfs uses the 'fsck' hook.
-
-*root=*'rootdevice'::
- This variable describes the root partition which early init will mount
- before passing control to the real init. mkinitcpio understands a variety of
- formats, the most basic of which is the path to the block device, either
- directly such as '/dev/sda2', or using a udev symlink such as
- '/dev/disk/by-label/CorsairF80-root'. Support for identification by LABEL or
- UUID tags are also supported, such as, 'LABEL=CorsairF80-root'. As of
- util-linux 2.22, PARTUUID is also supported. Identification via hex encoded
- major/minor device ID is supported for legacy reasons, but should not be used.
-
-*rootdelay=*'seconds'::
- Sets the delay, in seconds, that mkinitcpio is willing to wait for the root
- device to show up, if it is not available immediately. This defaults to 5
- seconds. If an invalid integer is passed, this variable will have no effect.
-
-These are only the variables that the core of mkinitcpio honor. Additional
-hooks may look for other environment variables and should be documented by the
-help output for the hook.
-
-Files
------
-'/etc/mkinitcpio.conf'::
- Default configuration file for mkinitcpio.
-
-'/etc/mkinitcpio.d'::
- Folder containing mkinitcpio presets.
-
-'/usr/lib/initcpio/install'::
-'/lib/initcpio/install'::
- Search path for build time hooks.
-
-'/usr/lib/initcpio/hooks'::
-'/lib/initcpio/hooks'::
- Search path for early userspace runtime hooks.
-
-Examples
---------
-*mkinitcpio*::
- Perform a 'dry-run'. This will generate an initial ramdisk but will not
- write anything. Use -g to create the real image.
-
-*mkinitcpio -p linux*::
- Create an initial ramdisk based on the 'linux' preset.
-
-*mkinitcpio -g /boot/initramfs-linux.img -k /boot/vmlinuz-linux*::
- Create an initial ramdisk for the kernel at /boot/vmlinuz-linux. The
- resulting image will be written to /boot/initramfs-linux.img.
-
-See also
---------
-A more thorough article on configuring mkinitcpio:
-http://wiki.archlinux.org/index.php/Mkinitcpio
-
-*initrd*(4), *lsinitcpio*(1), *mkinitcpio.conf*(5)
-
-Bugs
-----
-Upon writing this manpage, there were no noticeable bugs present. Please visit
-http://bugs.archlinux.org/ for an up to date list.
-
-Authors
--------
-mkinitcpio is created and maintained by the Arch Linux Developer community.
-
-Copyright
----------
-Copyright (c) Arch Linux 2006-2012
diff --git a/mkinitcpio.conf.5.txt b/mkinitcpio.conf.5.txt
deleted file mode 100644
index c2519c9..0000000
--- a/mkinitcpio.conf.5.txt
+++ /dev/null
@@ -1,82 +0,0 @@
-/////
-vim:set ts=4 sw=4 syntax=asciidoc noet:
-/////
-mkinitcpio.conf(5)
-==================
-
-Name
-----
-mkinitcpio.conf - mkinitcpio configuration file
-
-Synopsis
---------
-/etc/mkinitcpio.conf
-
-Description
------------
-mkinitcpio will attempt to read from a config file each time it is invoked,
-`/etc/mkinitcpio.conf' by default. This file defines several variables which
-describe the contents of the image to be generated.
-
-Variables
----------
-*MODULES*::
-
- Defines additional modules, space delimited, which should be added to the
- image. Dependencies (including other modules and necessary firmware), will
- also be added to the image. At runtime, the modules in this array which
- were successfully added to the image will be explicitly loaded.
-
-*FILES*::
-
- Defines additional files, space delimited, which should be added to the image.
- Files are added as is, and parent directories will be added if needed. Files
- specified in this variable will override previously added files of the same
- path.
-
-*BINARIES*::
-
- Defines additional binaries, space delimited, which should be added to the
- image. These are assumed to be dynamic ELF binaries, and necessary shared
- library dependencies will automatically be added. However, it is not
- considered an error to specify a non-ELF binary in this variable. Parent
- directories will be added if needed. Files specified in this variable will
- override previously added files of the same path.
-
-*HOOKS*::
-
- This variable defines the hooks which will be run during the build process.
- Order is important, as it defines the order in which hooks will be run
- during bootup. Use mkinitcpio's '-L' flag to list all available hooks,
- and the '-H' flag to display the help text for a specific hook.
-
-*COMPRESSION*::
-
- Defines a program to filter the generated image through. As of linux 2.6.38,
- the kernel understands the compression formats yielded by the *gzip*, *bzip2*,
- *lzop*, *lzma*, and *xz* compressors. If unspecified, this setting defaults to
- *gzip* compression. In order to create an uncompressed image, define this
- variable as *cat*.
-+
-It's not hard to realize that a filter such as a *tac* or *rev* will cause
-*mkinitcpio* to report success but generate a useless image. Similarly, using a
-compression program not listed above may generate an equally useless image,
-despite being "valid".
-
-*COMPRESSION_OPTIONS*::
-
- Defines additional options to be passed to the compression program. This option
- is generally not used. It can be potentially dangerous and may cause
- invalid images to be generated without any sign of an error.
-
-See Also
---------
-*mkinitcpio*(8)
-
-Authors
--------
-mkinitcpio is created and maintained by the Arch Linux Developer community.
-
-Copyright
----------
-Copyright (c) Arch Linux 2006-2012
--
1.8.0