summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--.gitignore1
-rw-r--r--Makefile2
-rw-r--r--mkinitcpio.8.txt2
-rw-r--r--mkinitcpio.conf.5.txt82
4 files changed, 86 insertions, 1 deletions
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:
<http://wiki.archlinux.org/index.php/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