aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ArchLinux.7.txt80
-rw-r--r--Makefile9
-rw-r--r--rc.conf9
3 files changed, 91 insertions, 7 deletions
diff --git a/ArchLinux.7.txt b/ArchLinux.7.txt
new file mode 100644
index 0000000..2a2c837
--- /dev/null
+++ b/ArchLinux.7.txt
@@ -0,0 +1,80 @@
+/////
+vim:set ts=4 sw=4 syntax=asciidoc noet:
+/////
+archlinux(7)
+============
+
+NAME
+----
+ArchLinux - basic configuration
+
+SYNOPSIS
+--------
+Overview of the basic configuartion of Arch Linux.
+
+DESCRIPTION
+-----------
+Arch Linux exposes the user to the system without hiding any details. This manpage gives a
+brief overview of the configuration files that should be set up on a fresh install.
+
+INITSCRIPTS[[I]]
+----------------
+The initscripts are configured in rc.conf. Here you configure what daemons to start on boot, what storage
+technologies should be enabled and, optionally, a basic network setup.
+
+HOSTNAME[[H]]
+-------------
+The hostname of the machine should be set in /etc/hostname. Additionally, either /etc/hosts should be
+configured accordingly, or nss-myhostname should be used. This is needed so the hostname can always
+be resolved to the current machine, which is required by some programs.
+
+LOCALIZATION[[L]]
+-----------------
+Various locales may be enabled in /etc/locale-gen, and generated by locale-gen. The system-wide locale to be used
+can be configured in /etc/locale.conf
+
+VIRTUAL CONSOLE[[V]]
+--------------------
+The virtual console is configured in /etc/vconsole.conf. It allows you to set a font and a keyboard layout, among
+other things. Note that these settings only apply to the console, and not if you use X.
+
+TIME[[T]]
+---------
+The local timezone is configured by symlinking /etc/localtime to the correct zoneinfo file under
+/usr/share/zoneinfo/. E.g.,
+
+ /etc/localtime -> /usr/share/zoneinfo/Europe/Paris
+
+The real-time clock, which keeps track of time when the computer is off, can be configured to either
+be in UTC or in localtime in /etc/adjtime. The default is UTC.
+
+FILESYSTEMS[[F]]
+----------------
+Filesystems are configured in /etc/fstab, and encryption mappings are configured in /etc/crypttab.
+
+INITRAMFS[[R]]
+--------------
+The initramfs is generated by mkinitcpio, and can be configured in /etc/mkinitcpio.conf.
+
+PACKAGE MANAGER[[P]]
+--------------------
+The package manager, pacman, is configured in /etc/pacman.conf.
+
+BOOTLOADER[[B]]
+---------------
+GRUB's configuration is generated from /etc/default/grub by grub-mkconfig. Syslinux is configured in /boot/syslinux/syslinux.conf
+
+MODULES[[M]]
+------------
+Most modules should be loaded on-demand. Modules to be unconditioanlly loaded at boot can be specified in /etc/modules-load.d/,
+and modules to be blacklisted from auto-loading can be configured in /etc/modprobe.d/.
+
+SEE ALSO
+--------
+
+rc.conf(5), hostname(5), hosts(5), nsswitch.conf(5), locale.conf(5), vconsole(5), timezone(3), hwclock(8), fstab(5), crypttab(5),
+mkinitcpio(8), pacman(8), pacman.conf(5), grub-mkconfig(8), syslinux(1), modules-load.d(5), modprobe.d(5)
+
+AUTHORS
+-------
+Written by Tom Gundersen.
diff --git a/Makefile b/Makefile
index 5ac71da..1a3fa14 100644
--- a/Makefile
+++ b/Makefile
@@ -10,6 +10,7 @@ DIRS := \
/usr/share/bash-completion/completions \
/usr/share/zsh/site-functions \
/usr/share/man/man5 \
+ /usr/share/man/man7 \
/usr/share/man/man8
all: doc
@@ -26,6 +27,7 @@ install: installdirs doc
install -m755 -t $(DESTDIR)/etc/profile.d locale.sh
install -m755 -t $(DESTDIR)/usr/sbin rc.d
install -m644 -t $(DESTDIR)/usr/share/man/man5 rc.conf.5
+ install -m644 -t $(DESTDIR)/usr/share/man/man7 ArchLinux.7
install -m644 -t $(DESTDIR)/usr/share/man/man8 rc.d.8
install -m644 tmpfiles.conf $(DESTDIR)/usr/lib/tmpfiles.d/initscripts.conf
install -m644 -T bash-completion $(DESTDIR)/usr/share/bash-completion/completions/rc.d
@@ -34,13 +36,16 @@ install: installdirs doc
%.5: %.5.txt
a2x -d manpage -f manpage $<
+%.7: %.7.txt
+ a2x -d manpage -f manpage $<
+
%.8: %.8.txt
a2x -d manpage -f manpage $<
-doc: rc.conf.5 rc.d.8
+doc: rc.conf.5 ArchLinux.7 rc.d.8
clean:
- rm -f rc.conf.5 rc.d.8
+ rm -f rc.conf.5 ArchLinux.7 rc.d.8
tar:
git archive HEAD --prefix=initscripts-$(VER)/ | xz > initscripts-$(VER).tar.xz
diff --git a/rc.conf b/rc.conf
index bf6a9e4..597e9a8 100644
--- a/rc.conf
+++ b/rc.conf
@@ -1,11 +1,10 @@
#
-# /etc/rc.conf - Main Configuration for Arch Linux
+# /etc/rc.conf - configuration file for initscripts
#
-# Most of rc.conf has been replaced by hostname(5),
-# vconsole.conf(5), locale.conf(5) and
-# modules-load.d(5).
+# Most of rc.conf has been replaced by various other configuration
+# files. See archrlinux(7) for details.
#
-# For more details see rc.conf(5).
+# For more details on rc.conf see rc.conf(5).
#
DAEMONS=(syslog-ng network crond)