User:SwifT/Complete Handbook/Configuring the system

The fstab file
fstab stands for file system table; when you would take a look at a fully configured file you can easily see why:

Each line declares what storage location (first field) is mounted at a certain location (second field) using a file system (third field) and mounted with one or more options (fourth field). The last two numbers are not that actively used anymore so you can safely set them to.

It is vital that your file is a reflection of your environment. By default, Gentoo offers an almost empty file with illegal storage locations (such as  and ). Any user should change the file, otherwise the system might not boot.

The file is used during the system boot procedure to find out what file systems should be mounted, but also during regular system operation. For instance, when you insert a CD in your CD-ROM player, Linux ought to know where it should mount the CD so that you (and perhaps other users) can reach it.

Mount options
The mount options which you can place in the fourth field in are well documented in the  manual page:

Each set of mount options is documented in a section pertaining to the file system used (for instance, ext2, reiserfs, ...). Some of them are available to all file systems, such as,  , or   (automatically mount file system or not).

Special file systems
Some lines in the file have a none as the storage location. Such file systems are pseudo file systems and do not require any storage on the disk.


 * The proc file system represents kernel information (like statistics, hardware settings, process information, memory data, ...) as regular files on the file system. You can read from those files to obtain the information you need, but these files are never actually written to disk. Every time you read them, the information is recalculated.
 * The tmpfs file system is storage located entirely in memory. Although it is extremely fast, it is also volatile meaning that it loses its content when you reboot the system. The tmpfs file system is often used for temporary file storage (hence the name), but in the previously given example it serves as a storage point for certain applications who want to share memory without using the shared memory functionality offered by the C library.
 * The sysfs file system (not shown in the example as Gentoo mounts automatically when it is present) is the successor of the proc file system. It servers the same purpose, but is restructured so it scales well in larger environments.

Edit /etc/fstab
Don't forget to edit to suit your environment. You can use to open the file:

Purpose of logging
The system logger is an important daemon on the system. A daemon is a tool that runs in the background; you can't work with it interactively.

The job of the system logger is to obtain information from various processes (and in certain configurations even from remote processes) like logon events, web server requests, security events, kernel messages, ... and write them down in separate files: log files.

Such log files can then be used to resolve issues on the machine (hardware errors are usually quite verbose), generate usage statistics (for instance for web servers), backtrack logon events (for security purposes), etc.

Installing a system logger
Gentoo provides various system loggers, each of them with their own pros and cons: metalog, newsyslog, rsyslog, socklog, sysklogd, and syslog-ng. Which one you choose is up to you, but it is quite important that you pick one: if you do not install a system logger, all events will be displayed on your terminal, cluttering up your screen instead of nicely archiving the events in files.

Next you'll need to add the system logger of your choice to the default run level. First find out how the init script is called:

Then, add it to the default runlevel:

Root password
With the tool you can set or change any user account password. At first, you need to set the root user password. Run and enter the new password. The tool will ask you to confirm the password by reentering it after which the password is updated.

You might want to verify that your keyboard settings are correct before you enter the root password. If the keyboard settings deviate a bit from what you expect them to be, your root password might actually differ from the one you thought you have entered. As the tool does not echo the characters on screen, you can not verify the password by just looking at it.

On most Gentoo installations, the password itself will be stored in a hashed format in which is only readable by the root user. Hashed means that the password itself is not shown, but a mathematical result based on the password. A hash gives a theoretically unique value based on certain input (here: the password) but from which you can not revert (i.e. you can not use the hash to obtain the password).

The file, which contains user account information, is readable by any user. Note though that this file does not always contain your user account information - larger networks will probably store this information on a central server (for instance an LDAP server). The system will look for account information according to the field in.

User account
Next, it is heavily recommended to create a user account for daily tasks. The root user is all-powerful; any mistyped command can severely damage your system. Running your applications as the root user also exposes you to security breaches - although not many Linux viruses exist, the damage that a virus can do depends on the privileges it obtains, and it obtains the privileges from the tool whose flaw it has exploited.

To create a user, use and pass on the   option so that the user's home directory ( for the username user) is created. Also add the groups to which you want to make the user part of:

Most groups are self-explanatory, but the wheel group might need a small introduction.

The wheel group contains all users who can run to switch from one user to another (including the root user). Only put trusted users in this group. A better alternative to the wheel access (since it still requires the user to know the passwords of the accounts it wants to switch to) is to use of which an excellent guide exists.

Networking information
Gentoo provides several tools for managing your network connections, see Message from openrc-0.12.4.

Managing network with dhcpcd
The easiest of them to use is dhcpcd. It has perfect integration for wpa_supplicant and automatically switches between wired and wireless connections.

Installation
Install dhcpcd, add it to the default runlevel and start it:

All its configuration goes into but for most installations nothing needs to be done there. Though will be helpful in case of advanced configuration demand.

Wireless
Dhcpcd comes with a built-in hook for wpa_supplicant, so it's best choice to install this for wireless. The necessary wireless device drivers need to be installed. Also note that the older versions (≤2.0-r2) of wpa_supplicant need "env wpa_supplicant_driver=nl80211" in.

Create the configuration file, put the content shown below, install wpa_supplicant and restart dhcpcd:

For any questions or problems with wpa_supplicant see the references.

Static IP address
In case the network interface card should be configured with a static IP address, add their data to the configuration file as shown for the following example.

<!--

Managing network with Gentoo net.* scripts
To configure your wired network, Gentoo uses the file. Its syntax might seem a bit strange at first - you'll find well-documented examples at  - but allows you to configure your entire network easily.

Automatic IP retrieval
If your network interface(s) should retrieve their configuration automatically (using DHCP) you don't need to do anything in this file - you can leave it empty. You will find that Gentoo gives a cosmetical warning that it assumes DHCP since you haven't provided anything. If you don't want any warning, explicitly enable DHCP for each interface:

Don't forget to install a DHCP client. Available clients include, (in the  package), and :

If you want to pass additional options to the DHCP client (we refer you to the man page of each DHCP client for more information about the available options) use the  _  directive. For instance, to set the time out to 10 seconds (the default for most clients is 1 minute) for the client:

Static IP address
If the network interface card should be configured with a static IP address, following information is needed:

For instance, suppose that your IP address is 192.168.0.2 and you're part of a network where all IP addresses start with 192.168.0, then you specify:
 * The IP address and network mask
 * The gateway IP address, where IP packets destined out of your network are forwarded to
 * The Domain Name Server, where hostname lookups are forwarded to

The  tells the configuration that the first three numbers (each number uses 8 bits, so 24 bits in total) define the network and the last number the host. If all of your IP addresses start with 192.168, then the configuration would read.

Next, we need to define where IP packets should go to if they aren't meant for the internal network: the gateway. For instance, if 192.168.0.1 would be the gateway:

The last setting defines which Domain Name Service server your system has to "ask" if it needs to lookup an IP address to a particular host in the internet. These DNS servers translate domain names as www.google.com to an IP address such as 66.249.93.104. Save first and then open :

Automatically starting the network at boot
With the configuration in place, your next step would be to assure that the configuration is loaded when you boot your system. Go to and make symbolic link from the  init script to the interfaces you need. For instance, if you have one interface (called ):

These commands might need some explanation:

-->
 * The command makes a named link to a file (in this case, ) called . This file shouldn't exist before you run this command. There are two types of links one can make:
 * symbolic links merely point to a file or directory. If you remove the destination (like ) then the file is really gone - the symbolic link will point to a non-existing file. You can create a symbolic link using the  option to the  command.
 * hard links don't just point to a file, they are actually a second name for the same file. If you remove the destination file, the hard link still contains the content of that file. More technically, if you create a file, you actually reserve some space on a device and create a hard link to it. just makes a second hard link to it. The advantage to using hard links should be obvious - if you remove one, the content still remains accessible through the other link. However, hard links have one disadvantage to symbolic links: they can not point to files on a different file system. Symbolic links can.
 * The command configures the boot sequence Gentoo Linux goes through when starting the system. By using the   option, you tell the system that the given script (in this case, ) should be added to the default runlevel.
 * A runlevel is a name for a certain set of scripts that need to be started in order for the system to function. By default, Gentoo calls its default runlevel... default. Others are  (which doesn't start network related scripts),   (important scripts that must be started), and   (where only those scripts are started that are needed for an administrator to be able to fix a broken system).
 * The script is an init script. Such scripts are written using a specific syntax and reside in.

The hosts file
The file is a small table the system uses to make immediate translations between hostnames and IP addresses. This file should at least contain one line:

All other lines should be set under that line using the following syntax:

For instance, if you want to assign the host name  to the eth0 interface address (for instance, 192.168.0.2):

If you use a domain name for your network (such as, but it can also be a real reserved domain name like company.com), you should set it like so:

Next to the host names assigned to your interfaces, you can also add in the IP address and hostname information for the other hosts on your system if they aren't known to the DNS servers you've specified (in, perhaps automatically with DHCP).

The /etc/rc.conf file
The file contains system-wide settings for the entire system. You will find lots of variables already defined in the file, accompanied with lots of documentation.

The first variable you'll see is the UNICODE variable. Unicode (also known as UTF-8) is the new standard for character encoding. Character encoding tells the system what sequence of bits resembles what character. Well-known encodings are ASCII, ISO-8859-1, etc. The UTF-8 or Unicode encoding is important because it is able to provide encodings for every possible language (including special characters like ¬ but also Chinese characters, etc.).

If you are interested in using Unicode on your system, please read the UTF-8 guide.

Another variable of importance is DISPLAYMANAGER. A display manager is a tool which shows a graphical logon screen after having booted your system. Most display managers even allow you to automatically log on as a specific user. If you want to use a display manager, you need to install one, add the init script to the default runlevel and make sure that this variable points to the display manager of your choice.

Together with the DISPLAYMANAGER variable you'll find the XSESSION one. This tells the display manager what graphical environment it should load by default if the user didn't specify one explicitly. Well-known graphical environments are KDE, GNOME, XFCE, fluxbox, ... For specific instructions on how this variable influences the graphical logon process please read the comments in the file.

Select keyboard language
If you aren't using a US Qwerty keyboard, you'll need to edit the file to tell the Gentoo system what keyboard layout it should use.