summaryrefslogtreecommitdiffstats
path: root/man/mkinitcpio.conf.5.txt
diff options
context:
space:
mode:
authorDave Reisner <dreisner@archlinux.org>2012-11-22 23:29:48 +0100
committerDave Reisner <dreisner@archlinux.org>2012-11-24 00:01:34 +0100
commit3c961b3bc3cbffa7537575c8ea85d016a0342f24 (patch)
treefb168bd640663cbc1a21db808ae7f27c17123879 /man/mkinitcpio.conf.5.txt
parentf85d28014134076217904885ea339e2f4c438df1 (diff)
downloadmkinitcpio-3c961b3bc3cbffa7537575c8ea85d016a0342f24.tar.gz
mkinitcpio-3c961b3bc3cbffa7537575c8ea85d016a0342f24.tar.xz
build: move manpages to subdir
Signed-off-by: Dave Reisner <dreisner@archlinux.org>
Diffstat (limited to 'man/mkinitcpio.conf.5.txt')
-rw-r--r--man/mkinitcpio.conf.5.txt82
1 files changed, 82 insertions, 0 deletions
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