[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[b06ca36] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[673b0d8] | 4 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 | ]>
|
---|
[6a3b6af] | 7 |
|
---|
[afcfd74] | 8 | <sect1 id="ch-preps-addinguser">
|
---|
[6a3b6af] | 9 | <?dbhtml filename="addinguser.html"?>
|
---|
| 10 |
|
---|
| 11 | <title>Adding the LFS User</title>
|
---|
| 12 |
|
---|
| 13 | <para>When logged in as user <systemitem class="username">root</systemitem>,
|
---|
[ee714d3] | 14 | making a single mistake can damage or destroy a system. Therefore,
|
---|
| 15 | the packages in the next two chapters are built as an unprivileged user.
|
---|
[6a3b6af] | 16 | You could use your own user name, but to make it easier to set up a clean
|
---|
| 17 | working environment, create a new user called <systemitem
|
---|
| 18 | class="username">lfs</systemitem> as a member of a new group (also named
|
---|
| 19 | <systemitem class="groupname">lfs</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>
|
---|
[673b0d8] | 22 |
|
---|
[1fd5d19] | 23 | <screen><userinput>groupadd lfs
|
---|
| 24 | useradd -s /bin/bash -g lfs -m -k /dev/null lfs</userinput></screen>
|
---|
[673b0d8] | 25 |
|
---|
[6a3b6af] | 26 | <variablelist>
|
---|
| 27 | <title>The meaning of the command line options:</title>
|
---|
| 28 |
|
---|
| 29 | <varlistentry>
|
---|
| 30 | <term><parameter>-s /bin/bash</parameter></term>
|
---|
| 31 | <listitem>
|
---|
| 32 | <para>This makes <command>bash</command> the default shell for user
|
---|
| 33 | <systemitem class="username">lfs</systemitem>.</para>
|
---|
| 34 | </listitem>
|
---|
| 35 | </varlistentry>
|
---|
| 36 |
|
---|
| 37 | <varlistentry>
|
---|
| 38 | <term><parameter>-g lfs</parameter></term>
|
---|
| 39 | <listitem>
|
---|
| 40 | <para>This option adds user <systemitem class="username">lfs</systemitem>
|
---|
| 41 | to group <systemitem class="groupname">lfs</systemitem>.</para>
|
---|
| 42 | </listitem>
|
---|
| 43 | </varlistentry>
|
---|
| 44 |
|
---|
| 45 | <varlistentry>
|
---|
| 46 | <term><parameter>-m</parameter></term>
|
---|
| 47 | <listitem>
|
---|
| 48 | <para>This creates a home directory for <systemitem
|
---|
| 49 | class="username">lfs</systemitem>.</para>
|
---|
| 50 | </listitem>
|
---|
| 51 | </varlistentry>
|
---|
| 52 |
|
---|
| 53 | <varlistentry>
|
---|
| 54 | <term><parameter>-k /dev/null</parameter></term>
|
---|
| 55 | <listitem>
|
---|
| 56 | <para>This parameter prevents possible copying of files from a skeleton
|
---|
| 57 | directory (default is <filename class="directory">/etc/skel</filename>)
|
---|
| 58 | by changing the input location to the special null device.</para>
|
---|
| 59 | </listitem>
|
---|
| 60 | </varlistentry>
|
---|
| 61 |
|
---|
| 62 | <varlistentry>
|
---|
| 63 | <term><parameter>lfs</parameter></term>
|
---|
| 64 | <listitem>
|
---|
[ee714d3] | 65 | <para>This is the actual name for the created user.</para>
|
---|
[6a3b6af] | 66 | </listitem>
|
---|
| 67 | </varlistentry>
|
---|
| 68 |
|
---|
| 69 | </variablelist>
|
---|
| 70 |
|
---|
| 71 | <para>To log in as <systemitem class="username">lfs</systemitem> (as opposed
|
---|
| 72 | to switching to user <systemitem class="username">lfs</systemitem> when logged
|
---|
| 73 | in as <systemitem class="username">root</systemitem>, which does not require
|
---|
| 74 | the <systemitem class="username">lfs</systemitem> user to have a password),
|
---|
| 75 | give <systemitem class="username">lfs</systemitem> a password:</para>
|
---|
[81fd230] | 76 |
|
---|
[d7ec037] | 77 | <screen role="nodump"><userinput>passwd lfs</userinput></screen>
|
---|
[673b0d8] | 78 |
|
---|
[6a3b6af] | 79 | <para>Grant <systemitem class="username">lfs</systemitem> full access to
|
---|
[efcb393] | 80 | all directories under <filename class="directory">$LFS</filename> by making
|
---|
[6a3b6af] | 81 | <systemitem class="username">lfs</systemitem> the directory owner:</para>
|
---|
[81fd230] | 82 |
|
---|
[d7a9421] | 83 | <screen><userinput>chown -v lfs $LFS/{usr{,/*},lib,var,etc,bin,sbin,tools}
|
---|
[70f0882] | 84 | case $(uname -m) in
|
---|
| 85 | x86_64) chown -v lfs $LFS/lib64 ;;
|
---|
| 86 | esac</userinput></screen>
|
---|
[673b0d8] | 87 |
|
---|
[6a3b6af] | 88 | <para>If a separate working directory was created as suggested, give
|
---|
| 89 | user <systemitem class="username">lfs</systemitem> ownership of this
|
---|
| 90 | directory:</para>
|
---|
[81fd230] | 91 |
|
---|
[5998892] | 92 | <screen><userinput>chown -v lfs $LFS/sources</userinput></screen>
|
---|
[673b0d8] | 93 |
|
---|
[bec76ac] | 94 | <note><para>In some host systems, the following command does not complete
|
---|
| 95 | properly and suspends the login to the lfs user to the background. If the
|
---|
| 96 | prompt "lfs:~$" does not appear immediately, entering the
|
---|
| 97 | <command>fg</command> command will fix the issue.</para></note>
|
---|
| 98 |
|
---|
[6a3b6af] | 99 | <para>Next, login as user <systemitem class="username">lfs</systemitem>.
|
---|
| 100 | This can be done via a virtual console, through a display manager, or with
|
---|
[ee714d3] | 101 | the following substitute/switch user command:</para>
|
---|
[81fd230] | 102 |
|
---|
[6a3b6af] | 103 | <screen role="nodump"><userinput>su - lfs</userinput></screen>
|
---|
[673b0d8] | 104 |
|
---|
[6a3b6af] | 105 | <para>The <quote><parameter>-</parameter></quote> instructs
|
---|
| 106 | <command>su</command> to start a login shell as opposed to a non-login shell.
|
---|
| 107 | The difference between these two types of shells can be found in detail in
|
---|
| 108 | <filename>bash(1)</filename> and <command>info bash</command>.</para>
|
---|
[81fd230] | 109 |
|
---|
[673b0d8] | 110 | </sect1>
|
---|