source: BOOK/final-preps/addinguser.xml@ dc13912

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since dc13912 was 3d25b3b, checked in by Joe Ciccone <jciccone@…>, 16 years ago

Apply r2986 from the clfs-1.1 branch to trunk. Remove the descriptions about the -m and -k parameters from the creating the clfs user page.

  • Property mode set to 100644
File size: 3.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-final-preps-addinguser">
9 <?dbhtml filename="addinguser.html"?>
10
11 <title>Adding the CLFS User</title>
12
13 <para>When logged in as user <systemitem class="username">root</systemitem>,
14 making a single mistake can damage or destroy a system. Therefore, we
15 recommend building the packages as an unprivileged user.
16 You could use your own user name, but to make it easier to set up a clean
17 work environment, create a new user called <systemitem
18 class="username">clfs</systemitem> as a member of a new group (also named
19 <systemitem class="groupname">clfs</systemitem>) and use this user during
20 the installation process. As <systemitem class="username">root</systemitem>,
21 issue the following commands to add the new user:</para>
22
23<screen><userinput>groupadd clfs
24useradd -s /bin/bash -g clfs -d /home/clfs clfs
25mkdir -pv /home/clfs
26chown -v clfs:clfs /home/clfs</userinput></screen>
27
28 <variablelist>
29 <title>The meaning of the command line options:</title>
30
31 <varlistentry>
32 <term><parameter>-s /bin/bash</parameter></term>
33 <listitem>
34 <para>This makes <command>bash</command> the default shell for
35 user <systemitem class="username">clfs</systemitem>.</para>
36 </listitem>
37 </varlistentry>
38
39 <varlistentry>
40 <term><parameter>-g clfs</parameter></term>
41 <listitem>
42 <para>This option adds user <systemitem class="username">clfs</systemitem>
43 to group <systemitem class="groupname">clfs</systemitem>.</para>
44 </listitem>
45 </varlistentry>
46
47 <varlistentry>
48 <term><parameter>clfs</parameter></term>
49 <listitem>
50 <para>This is the actual name for the created group and user.</para>
51 </listitem>
52 </varlistentry>
53
54 </variablelist>
55
56 <para>To log in as <systemitem class="username">clfs</systemitem> (as
57 opposed to switching to user <systemitem class="username">clfs</systemitem>
58 when logged in as <systemitem class="username">root</systemitem>, which
59 does not require the <systemitem class="username">clfs</systemitem> user
60 to have a password), give <systemitem class="username">clfs</systemitem>
61 a password:</para>
62
63<screen><userinput>passwd clfs</userinput></screen>
64
65 <para>Grant <systemitem class="username">clfs</systemitem> full access to
66 <filename class="directory">${CLFS}/cross-tools</filename> and
67 <filename class="directory">${CLFS}/tools</filename> by making <systemitem
68 class="username">clfs</systemitem> the directorys' owner:</para>
69
70<screen><userinput>chown -v clfs ${CLFS}/tools
71chown -v clfs ${CLFS}/cross-tools</userinput></screen>
72
73 <para>If a separate working directory was created as suggested,
74 give user <systemitem class="username">clfs</systemitem> ownership of this directory:</para>
75
76<screen><userinput>chown -v clfs ${CLFS}/sources</userinput></screen>
77
78 <para>Next, login as user <systemitem class="username">clfs</systemitem>.
79 This can be done via a virtual console, through a display manager, or
80 with the following substitute user command:</para>
81
82<screen><userinput>su - clfs</userinput></screen>
83
84 <para>The <quote><parameter>-</parameter></quote> instructs
85 <command>su</command> to start a login shell as opposed to a non-login
86 shell. The difference between these two types of shells can be found
87 in detail in <filename>bash(1)</filename> and <command>info
88 bash</command>.</para>
89
90</sect1>
Note: See TracBrowser for help on using the repository browser.