path: root/ArchLinux.7.txt
diff options
authorTom Gundersen <teg@jklm.no>2012-07-26 22:00:14 (GMT)
committerTom Gundersen <teg@jklm.no>2012-07-26 22:12:56 (GMT)
commit4a84b51830467ee192cd6bddc0857ad08f6e7ae4 (patch)
treed2dcf3d790ba1ca0ee5b6e7c423eeb0308368942 /ArchLinux.7.txt
parent98baa63c2008aa70c9e95f5fe46a79cec87aad31 (diff)
man: add ArchLinux(7)
This outlines what files needs to be configured to get a well-behaved system. For now it is extremely terse, but the main point is to work as a check-list, and to point people to the correct manpages to learn more. I'll be happy to take patches to extend this in the future. One might argue that this sholud not be part of initscripts, and we might indeed move it to 'filesystem' or something like that in the future. For the time being I'll keep it here for convenience. Suggested-by: Thomas B├Ąchler <thomas@archlinux.org> Signed-off-by: Tom Gundersen <teg@jklm.no>
Diffstat (limited to 'ArchLinux.7.txt')
1 files changed, 80 insertions, 0 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 - basic configuration
+Overview of the basic configuartion of Arch Linux.
+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.
+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.
+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.
+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
+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.
+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 are configured in /etc/fstab, and encryption mappings are configured in /etc/crypttab.
+The initramfs is generated by mkinitcpio, and can be configured in /etc/mkinitcpio.conf.
+The package manager, pacman, is configured in /etc/pacman.conf.
+GRUB's configuration is generated from /etc/default/grub by grub-mkconfig. Syslinux is configured in /boot/syslinux/syslinux.conf
+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/.
+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)
+Written by Tom Gundersen.