createfiles.xml 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352
  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. <sect1 id="ch-system-createfiles">
  8. <?dbhtml filename="createfiles.html"?>
  9. <title>Creating Essential Files and Symlinks</title>
  10. <indexterm zone="ch-system-createfiles">
  11. <primary sortas="e-/etc/passwd">/etc/passwd</primary>
  12. </indexterm>
  13. <indexterm zone="ch-system-createfiles">
  14. <primary sortas="e-/etc/group">/etc/group</primary>
  15. </indexterm>
  16. <indexterm zone="ch-system-createfiles">
  17. <primary sortas="e-/var/run/utmp">/var/run/utmp</primary>
  18. </indexterm>
  19. <indexterm zone="ch-system-createfiles">
  20. <primary sortas="e-/var/log/btmp">/var/log/btmp</primary>
  21. </indexterm>
  22. <indexterm zone="ch-system-createfiles">
  23. <primary sortas="e-/var/log/lastlog">/var/log/lastlog</primary>
  24. </indexterm>
  25. <indexterm zone="ch-system-createfiles">
  26. <primary sortas="e-/var/log/wtmp">/var/log/wtmp</primary>
  27. </indexterm>
  28. <para>Some programs use hard-wired paths to programs which do not exist yet.
  29. In order to satisfy these programs, create a number of symbolic links which
  30. will be replaced by real files throughout the course of this chapter after the
  31. software has been installed:</para>
  32. <screen revision="sysv"><userinput>ln -sv /tools/bin/{bash,cat,dd,echo,ln,pwd,rm,stty} /bin
  33. ln -sv /tools/bin/{install,perl} /usr/bin
  34. ln -sv /tools/lib/libgcc_s.so{,.1} /usr/lib
  35. ln -sv /tools/lib/libstdc++.{a,so{,.6}} /usr/lib
  36. sed 's/tools/usr/' /tools/lib/libstdc++.la > /usr/lib/libstdc++.la
  37. ln -sv bash /bin/sh</userinput></screen>
  38. <screen revision="systemd"><userinput>ln -sv /tools/bin/{bash,cat,dd,echo,ln,pwd,rm,stty} /bin
  39. ln -sv /tools/bin/{env,install,perl} /usr/bin
  40. ln -sv /tools/lib/libgcc_s.so{,.1} /usr/lib
  41. ln -sv /tools/lib/libstdc++.{a,so{,.6}} /usr/lib
  42. sed 's/tools/usr/' /tools/lib/libstdc++.la > /usr/lib/libstdc++.la
  43. for lib in blkid lzma mount uuid
  44. do
  45. ln -sv /tools/lib/lib$lib.so* /usr/lib
  46. sed 's/tools/usr/' /tools/lib/lib${lib}.la > /usr/lib/lib${lib}.la
  47. done
  48. ln -svf /tools/include/blkid /usr/include
  49. ln -svf /tools/include/libmount /usr/include
  50. ln -svf /tools/include/uuid /usr/include
  51. for pc in blkid mount uuid
  52. do
  53. sed 's@tools@usr@g' /tools/lib/pkgconfig/${pc}.pc \
  54. > /usr/lib/pkgconfig/${pc}.pc
  55. done
  56. ln -sv bash /bin/sh</userinput></screen>
  57. <variablelist>
  58. <title>The purpose of each link:</title>
  59. <varlistentry>
  60. <term><parameter><filename>/bin/bash</filename></parameter></term>
  61. <listitem>
  62. <para>Many <command>bash</command> scripts specify
  63. <filename>/bin/bash</filename>.</para>
  64. </listitem>
  65. </varlistentry>
  66. <varlistentry>
  67. <term><parameter><filename>/bin/cat</filename></parameter></term>
  68. <listitem>
  69. <para>This pathname is hard-coded into Glibc's configure script.</para>
  70. </listitem>
  71. </varlistentry>
  72. <varlistentry>
  73. <term><parameter><filename>/bin/dd</filename></parameter></term>
  74. <listitem>
  75. <para>The path to <filename>dd</filename> will be hard-coded into the
  76. <filename>/usr/bin/libtool</filename> utility.</para>
  77. </listitem>
  78. </varlistentry>
  79. <varlistentry>
  80. <term><parameter><filename>/bin/echo</filename></parameter></term>
  81. <listitem>
  82. <para>This is to satisfy one of the tests in Glibc's test suite, which
  83. expects <filename>/bin/echo</filename>.</para>
  84. </listitem>
  85. </varlistentry>
  86. <varlistentry>
  87. <term><parameter><filename>/usr/bin/install</filename></parameter></term>
  88. <listitem>
  89. <para>The path to <filename>install</filename> will be hard-coded into
  90. the <filename>/usr/lib/bash/Makefile.inc</filename> file.</para>
  91. </listitem>
  92. </varlistentry>
  93. <varlistentry>
  94. <term><parameter><filename>/bin/ln</filename></parameter></term>
  95. <listitem>
  96. <para>The path to <filename>ln</filename> will be hard-coded into the
  97. <filename>/usr/lib/perl5/&perl-version;/&lt;target-triplet&gt;/Config_heavy.pl</filename>
  98. file.</para>
  99. </listitem>
  100. </varlistentry>
  101. <varlistentry>
  102. <term><parameter><filename>/bin/pwd</filename></parameter></term>
  103. <listitem>
  104. <para>Some <command>configure</command> scripts, particularly Glibc's,
  105. have this pathname hard-coded.</para>
  106. </listitem>
  107. </varlistentry>
  108. <varlistentry>
  109. <term><parameter><filename>/bin/rm</filename></parameter></term>
  110. <listitem>
  111. <para>The path to <filename>rm</filename> will be hard-coded into the
  112. <filename>/usr/lib/perl5/&perl-version;/&lt;target-triplet&gt;/Config_heavy.pl</filename>
  113. file.</para>
  114. </listitem>
  115. </varlistentry>
  116. <varlistentry>
  117. <term><parameter><filename>/bin/stty</filename></parameter></term>
  118. <listitem>
  119. <para>This pathname is hard-coded into Expect, therefore it is needed
  120. for Binutils and GCC test suites to pass.</para>
  121. </listitem>
  122. </varlistentry>
  123. <varlistentry>
  124. <term><parameter><filename>/usr/bin/perl</filename></parameter></term>
  125. <listitem>
  126. <para>Many Perl scripts hard-code this path to the
  127. <command>perl</command> program.</para>
  128. </listitem>
  129. </varlistentry>
  130. <varlistentry>
  131. <term><parameter><filename>/usr/lib/libgcc_s.so{,.1}</filename></parameter></term>
  132. <listitem>
  133. <para>Glibc needs this for the pthreads library to work.</para>
  134. </listitem>
  135. </varlistentry>
  136. <varlistentry>
  137. <term><parameter><filename>/usr/lib/libstdc++{,.6}</filename></parameter></term>
  138. <listitem>
  139. <para>This is needed by several tests in Glibc's test suite, as well as
  140. for C++ support in GMP.</para>
  141. </listitem>
  142. </varlistentry>
  143. <varlistentry>
  144. <term><parameter><filename>/usr/lib/libstdc++.la</filename></parameter></term>
  145. <listitem>
  146. <para>This prevents a <filename class="directory">/tools</filename>
  147. reference that would otherwise be in
  148. <filename>/usr/lib/libstdc++.la</filename> after GCC is installed.</para>
  149. </listitem>
  150. </varlistentry>
  151. <varlistentry revision="systemd">
  152. <term><parameter><filename>/usr/lib/lib{blkid,lzma,mount,uuid}.{a,la,so*}</filename></parameter></term>
  153. <listitem>
  154. <para>These links prevent systemd utilities from acquiring an
  155. unnecessary reference to the
  156. <filename class="directory">/tools</filename> directory.</para>
  157. </listitem>
  158. </varlistentry>
  159. <varlistentry>
  160. <term><parameter><filename>/bin/sh</filename></parameter></term>
  161. <listitem>
  162. <para>Many shell scripts hard-code <filename>/bin/sh</filename>.</para>
  163. </listitem>
  164. </varlistentry>
  165. </variablelist>
  166. <para>Historically, Linux maintains a list of the mounted file systems in the
  167. file <filename>/etc/mtab</filename>. Modern kernels maintain this list
  168. internally and exposes it to the user via the <filename
  169. class="directory">/proc</filename> filesystem. To satisfy utilities that
  170. expect the presence of <filename>/etc/mtab</filename>, create the following
  171. symbolic link:</para>
  172. <screen><userinput>ln -sv /proc/self/mounts /etc/mtab</userinput></screen>
  173. <para>In order for user <systemitem class="username">root</systemitem> to be
  174. able to login and for the name <quote>root</quote> to be recognized, there
  175. must be relevant entries in the <filename>/etc/passwd</filename> and
  176. <filename>/etc/group</filename> files.</para>
  177. <para>Create the <filename>/etc/passwd</filename> file by running the following
  178. command:</para>
  179. <screen revision="sysv"><userinput>cat &gt; /etc/passwd &lt;&lt; "EOF"
  180. <literal>root:x:0:0:root:/root:/bin/bash
  181. bin:x:1:1:bin:/dev/null:/bin/false
  182. daemon:x:6:6:Daemon User:/dev/null:/bin/false
  183. messagebus:x:18:18:D-Bus Message Daemon User:/var/run/dbus:/bin/false
  184. nobody:x:99:99:Unprivileged User:/dev/null:/bin/false</literal>
  185. EOF</userinput></screen>
  186. <screen revision="systemd"><userinput>cat &gt; /etc/passwd &lt;&lt; "EOF"
  187. <literal>root:x:0:0:root:/root:/bin/bash
  188. bin:x:1:1:bin:/dev/null:/bin/false
  189. daemon:x:6:6:Daemon User:/dev/null:/bin/false
  190. messagebus:x:18:18:D-Bus Message Daemon User:/var/run/dbus:/bin/false
  191. systemd-bus-proxy:x:72:72:systemd Bus Proxy:/:/bin/false
  192. systemd-journal-gateway:x:73:73:systemd Journal Gateway:/:/bin/false
  193. systemd-journal-remote:x:74:74:systemd Journal Remote:/:/bin/false
  194. systemd-journal-upload:x:75:75:systemd Journal Upload:/:/bin/false
  195. systemd-network:x:76:76:systemd Network Management:/:/bin/false
  196. systemd-resolve:x:77:77:systemd Resolver:/:/bin/false
  197. systemd-timesync:x:78:78:systemd Time Synchronization:/:/bin/false
  198. systemd-coredump:x:79:79:systemd Core Dumper:/:/bin/false
  199. nobody:x:99:99:Unprivileged User:/dev/null:/bin/false</literal>
  200. EOF</userinput></screen>
  201. <para>The actual password for <systemitem class="username">root</systemitem>
  202. (the <quote>x</quote> used here is just a placeholder) will be set later.</para>
  203. <para>Create the <filename>/etc/group</filename> file by running the following
  204. command:</para>
  205. <screen revision="sysv"><userinput>cat &gt; /etc/group &lt;&lt; "EOF"
  206. <literal>root:x:0:
  207. bin:x:1:daemon
  208. sys:x:2:
  209. kmem:x:3:
  210. tape:x:4:
  211. tty:x:5:
  212. daemon:x:6:
  213. floppy:x:7:
  214. disk:x:8:
  215. lp:x:9:
  216. dialout:x:10:
  217. audio:x:11:
  218. video:x:12:
  219. utmp:x:13:
  220. usb:x:14:
  221. cdrom:x:15:
  222. adm:x:16:
  223. messagebus:x:18:
  224. systemd-journal:x:23:
  225. input:x:24:
  226. mail:x:34:
  227. nogroup:x:99:
  228. users:x:999:</literal>
  229. EOF</userinput></screen>
  230. <screen revision="systemd"><userinput>cat &gt; /etc/group &lt;&lt; "EOF"
  231. <literal>root:x:0:
  232. bin:x:1:daemon
  233. sys:x:2:
  234. kmem:x:3:
  235. tape:x:4:
  236. tty:x:5:
  237. daemon:x:6:
  238. floppy:x:7:
  239. disk:x:8:
  240. lp:x:9:
  241. dialout:x:10:
  242. audio:x:11:
  243. video:x:12:
  244. utmp:x:13:
  245. usb:x:14:
  246. cdrom:x:15:
  247. adm:x:16:
  248. messagebus:x:18:
  249. systemd-journal:x:23:
  250. input:x:24:
  251. mail:x:34:
  252. systemd-bus-proxy:x:72:
  253. systemd-journal-gateway:x:73:
  254. systemd-journal-remote:x:74:
  255. systemd-journal-upload:x:75:
  256. systemd-network:x:76:
  257. systemd-resolve:x:77:
  258. systemd-timesync:x:78:
  259. systemd-coredump:x:79:
  260. nogroup:x:99:
  261. users:x:999:</literal>
  262. EOF</userinput></screen>
  263. <para>The created groups are not part of any standard&mdash;they are groups
  264. decided on in part by the requirements of the Udev configuration in this
  265. chapter, and in part by common convention employed by a number of existing
  266. Linux distributions. In addition, some test suites rely on specific users
  267. or groups. The Linux Standard Base (LSB, available at <ulink
  268. url="http://www.linuxbase.org"/>) recommends only that, besides the group
  269. <systemitem class="groupname">root</systemitem> with a Group ID (GID) of 0,
  270. a group <systemitem class="groupname">bin</systemitem> with a GID of 1 be
  271. present. All other group names and GIDs can be chosen freely by the system
  272. administrator since well-written programs do not depend on GID numbers, but
  273. rather use the group's name.</para>
  274. <para>To remove the <quote>I have no name!</quote> prompt, start a new
  275. shell. Since a full Glibc was installed in <xref
  276. linkend="chapter-temporary-tools"/> and the
  277. <filename>/etc/passwd</filename> and <filename>/etc/group</filename>
  278. files have been created, user name and group name resolution will now
  279. work:</para>
  280. <screen role="nodump"><userinput>exec /tools/bin/bash --login +h</userinput></screen>
  281. <para>Note the use of the <parameter>+h</parameter> directive. This tells
  282. <command>bash</command> not to use its internal path hashing. Without this
  283. directive, <command>bash</command> would remember the paths to binaries it has
  284. executed. To ensure the use of the newly compiled binaries as soon as they are
  285. installed, the <parameter>+h</parameter> directive will be used for the duration
  286. of this chapter.</para>
  287. <para>The <command>login</command>, <command>agetty</command>, and
  288. <command>init</command> programs (and others) use a number of log
  289. files to record information such as who was logged into the system and
  290. when. However, these programs will not write to the log files if they
  291. do not already exist. Initialize the log files and give them
  292. proper permissions:</para>
  293. <screen><userinput>touch /var/log/{btmp,lastlog,faillog,wtmp}
  294. chgrp -v utmp /var/log/lastlog
  295. chmod -v 664 /var/log/lastlog
  296. chmod -v 600 /var/log/btmp</userinput></screen>
  297. <para>The <filename>/var/log/wtmp</filename> file records all logins and
  298. logouts. The <filename>/var/log/lastlog</filename> file records when each
  299. user last logged in. The <filename>/var/log/faillog</filename> file records
  300. failed login attempts. The <filename>/var/log/btmp</filename> file records
  301. the bad login attempts.</para>
  302. <note><para>The <filename>/run/utmp</filename> file records the users that
  303. are currently logged in. This file is created dynamically in the boot
  304. scripts.</para></note>
  305. </sect1>