source: chapter04/addinguser.xml@ 71ab47c

multilib-10.1 multilib-before-cross
Last change on this file since 71ab47c was 71ab47c, checked in by Thomas Trepl <thomas@…>, 2 years ago

MultiLib: Merge changes from trunk

git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/multilib@11703 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 4.3 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-tools-addinguser">
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>,
14 making a single mistake can damage or destroy a system. Therefore, we
15 recommend building the packages in the next chapter as an unprivileged user.
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>
22
23<screen><userinput>groupadd lfs
24useradd -s /bin/bash -g lfs -m -k /dev/null lfs</userinput></screen>
25
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>
65 <para>This is the actual name for the created group and user.</para>
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>
76
77<screen role="nodump"><userinput>passwd lfs</userinput></screen>
78
79 <para>Grant <systemitem class="username">lfs</systemitem> full access to
80 <filename class="directory">$LFS/tools</filename> by making
81 <systemitem class="username">lfs</systemitem> the directory owner:</para>
82
83<screen><userinput>chown -v lfs $LFS/tools</userinput></screen>
84
85 <para>If a separate working directory was created as suggested, give
86 user <systemitem class="username">lfs</systemitem> ownership of this
87 directory:</para>
88
89<screen><userinput>chown -v lfs $LFS/sources</userinput></screen>
90
91 <note><para>In some host systems, the following command does not complete
92 properly and suspends the login to the lfs user to the background. If the
93 prompt "lfs:~$" does not appear immediately, entering the
94 <command>fg</command> command will fix the issue.</para></note>
95
96 <para>Next, login as user <systemitem class="username">lfs</systemitem>.
97 This can be done via a virtual console, through a display manager, or with
98 the following substitute user command:</para>
99
100<screen role="nodump"><userinput>su - lfs</userinput></screen>
101
102 <para>The <quote><parameter>-</parameter></quote> instructs
103 <command>su</command> to start a login shell as opposed to a non-login shell.
104 The difference between these two types of shells can be found in detail in
105 <filename>bash(1)</filename> and <command>info bash</command>.</para>
106
107</sect1>
Note: See TracBrowser for help on using the repository browser.