From db5eb12c7d711b451f9068a1dd00d6427f3ecc2e Mon Sep 17 00:00:00 2001 From: Dave Reisner Date: Sun, 21 Oct 2012 15:25:33 -0400 Subject: add manpage for mkinitcpio.conf Signed-off-by: Dave Reisner --- .gitignore | 1 + Makefile | 2 ++ mkinitcpio.8.txt | 2 +- mkinitcpio.conf.5.txt | 82 +++++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 86 insertions(+), 1 deletion(-) create mode 100644 mkinitcpio.conf.5.txt diff --git a/.gitignore b/.gitignore index aee4ba8..a814a0f 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,5 @@ mkinitcpio.8 +mkinitcpio.conf.5 lsinitcpio.1 *~ *.bak diff --git a/Makefile b/Makefile index 97b041b..3369f96 100644 --- a/Makefile +++ b/Makefile @@ -17,6 +17,7 @@ all: doc MANPAGES = \ mkinitcpio.8 \ + mkinitcpio.conf.5 \ lsinitcpio.1 install: all @@ -47,6 +48,7 @@ install: all 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 bash-completion $(DESTDIR)/usr/share/bash-completion/completions/mkinitcpio ln -s mkinitcpio $(DESTDIR)/usr/share/bash-completion/completions/lsinitcpio diff --git a/mkinitcpio.8.txt b/mkinitcpio.8.txt index efa385f..f7c22ce 100644 --- a/mkinitcpio.8.txt +++ b/mkinitcpio.8.txt @@ -279,7 +279,7 @@ See also A more thorough article on configuring mkinitcpio: -*initrd*(4), *lsinitcpio*(1) +*initrd*(4), *lsinitcpio*(1), *mkinitcpio.conf*(5) Bugs ---- diff --git a/mkinitcpio.conf.5.txt b/mkinitcpio.conf.5.txt new file mode 100644 index 0000000..c2519c9 --- /dev/null +++ b/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 -- cgit v1.2.3-24-g4f1b