/////
vim:set ts=4 sw=4 syntax=asciidoc noet:
/////

parabola(7)
============

NAME
----
parabola - basic configuration

SYNOPSIS
--------
Overview of the basic configuration of Parabola GNU/Linux-libre.

DESCRIPTION
-----------
Parabola exposes the user to the system without hiding any details.
This man page gives a brief overview of the configuration files that should be set up on a fresh install.

SYSTEM SERVICES[[S]]
--------------------
System services to be started at boot can be enabled using 'rc-update add <name> <runlevel>'.
To view available services, use 'rc-status --all'.

HOSTNAME[[H]]
-------------
The hostname of the machine can be set using 'hostnamectl set-hostname <hostname>'.
It will then be written to /etc/hostname.

LOCALIZATION[[L]]
-----------------
Various locales may be enabled in /etc/locale.gen and are generated by 'locale-gen'.
The system-wide locale to be used can be configured in /etc/locale.conf.
These settings can be overridden on a per-user basis by keeping a user-specific locale.conf in $HOME/.config/locale.conf.
The user-specific file will take precedence if it exists.

VIRTUAL CONSOLE[[V]]
--------------------
The virtual console is configured in /etc/conf.d/keymaps.
It allows you to set a font and a keyboard layout, among other things.
Note that these settings only apply to the console and do not apply if you use X.

TIME[[T]]
---------
A relative *symlink* needs to be created from /etc/localtime to the correct zoneinfo file under /usr/share/zoneinfo/.

   'ln -s /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 local time in /etc/conf.d/hwclock.
The default is UTC.

FILE SYSTEMS[[F]]
-----------------
File systems are configured in /etc/fstab, and encryption mappings are configured in /etc/crypttab.

INITRAMFS[[R]]
--------------
The initramfs is generated by 'mkinitcpio -p <preset>'.
The default preset is "linux-libre".
The initramfs can be configured in /etc/mkinitcpio.conf and must be regenerated after making configuration changes.

PACKAGE MANAGER[[P]]
--------------------
The package manager, pacman, is configured in /etc/pacman.conf.

BOOT LOADER[[B]]
----------------
GRUB's configuration is generated from /etc/default/grub by 'grub-mkconfig -o /boot/grub/grub.cfg'.
Syslinux is configured in /boot/syslinux/syslinux.cfg.

MODULES[[M]]
------------
Most modules should be loaded on-demand.
Modules to be unconditionally loaded at boot can be specified in /etc/modules-load.d/,
and modules to be blacklisted from automatically loading can be configured in /etc/modprobe.d/.

SEE ALSO
--------

*hostname*(5), *locale.conf*(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.
Rebranded for Parabola by Nicolás Reynolds and André Silva.