newxml/chapter04/addinguser.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   3   <!ENTITY % general-entities SYSTEM "../general.ent">
   4   %general-entities;
   5 ]>
   6 <sect1 id="ch-tools-addinguser">
   7 <title>Adding the user lfs</title>
   8 <?dbhtml filename="addinguser.html"?>
   9
  10 <para>When logged in as <emphasis>root</emphasis>, making a single mistake
  11 can damage or even wreck your system. Therefore we recommend that you
  12 build the packages in this chapter as an unprivileged user. You could
  13 of course use your own user name, but to make it easier to set up a clean
  14 work environment we'll create a new user <emphasis>lfs</emphasis> and
  15 use this one during the installation process. As <emphasis>root</emphasis>,
  16 issue the following command to add the new user:</para>
  17
  18 <screen><userinput>useradd -s /bin/bash -m -k /dev/null lfs</userinput></screen>
  19
  20 <para>The meaning of the switches:</para>
  21
  22 <itemizedlist>
  23 <listitem><para><userinput>-s /bin/bash</userinput>: This makes
  24 <userinput>bash</userinput> the default shell for user
  25 <emphasis>lfs</emphasis>.</para></listitem>
  26
  27 <listitem><para><userinput>-m</userinput>: This creates a home
  28 directory for <emphasis>lfs</emphasis>.</para></listitem>
  29
  30 <listitem><para><userinput>-k /dev/null</userinput>: This parameter
  31 prevents possible copying of files from a skeleton directory (default
  32 is <filename>/etc/skel</filename>) by changing the input location to
  33 the special null device.</para></listitem>
  34 </itemizedlist>
  35
  36 <para>If you want to be able to log in as <emphasis>lfs</emphasis>, then give
  37 <emphasis>lfs</emphasis> a password:</para>
  38
  39 <screen><userinput>passwd lfs</userinput></screen>
  40
  41 <para>and grant <emphasis>lfs</emphasis> full access to
  42 <filename class="directory">$LFS/tools</filename> by making
  43 <emphasis>lfs</emphasis> the directory owner:</para>
  44
  45 <screen><userinput>chown lfs $LFS/tools</userinput></screen>
  46
  47 <para>If you made a separate working directory as suggested, give user
  48 <emphasis>lfs</emphasis> ownership of this directory too:</para>
  49
  50 <screen><userinput>chown lfs $LFS/sources</userinput></screen>
  51
  52 <para>Next, login as user <emphasis>lfs</emphasis>. This can be done via a
  53 virtual console, through a display manager, or with the following substitute
  54 user command:</para>
  55
  56 <screen><userinput>su - lfs</userinput></screen>
  57
  58 <para>The <quote><command>-</command></quote> instructs <command>su</command> to
  59 start a <emphasis>login</emphasis> shell.</para>
  60
  61 </sect1>