coreutils.xml 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871
  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-coreutils" role="wrap">
  7. <title>Coreutils-&coreutils-version;</title>
  8. <?dbhtml filename="coreutils.html"?>
  9. <indexterm zone="ch-system-coreutils"><primary sortas="a-Coreutils">Coreutils</primary></indexterm>
  10. <sect2 role="package"><title/>
  11. <para>The Coreutils package contains utilities for showing and setting the
  12. basic system characteristics.</para>
  13. <segmentedlist>
  14. <segtitle>&buildtime;</segtitle>
  15. <segtitle>&diskspace;</segtitle>
  16. <seglistitem><seg>0.9 SBU</seg><seg>52.8 MB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>&dependencies;</segtitle>
  20. <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, GCC,
  21. Gettext, Glibc, Grep, Make, Perl, and Sed</seg></seglistitem>
  22. </segmentedlist>
  23. </sect2>
  24. <sect2 role="installation">
  25. <title>Installation of Coreutils</title>
  26. <para>A known issue with the <command>uname</command> program from
  27. this package is that the <parameter>-p</parameter> switch always
  28. returns <computeroutput>unknown</computeroutput>. The following patch
  29. fixes this behavior for Intel architectures:</para>
  30. <screen><userinput>patch -Np1 -i ../&coreutils-uname-patch;</userinput></screen>
  31. <para>Prevent Coreutils from installing binaries that will be installed by
  32. other packages later:</para>
  33. <screen><userinput>patch -Np1 -i ../&coreutils-suppress-patch;</userinput></screen>
  34. <para>POSIX requires that programs from Coreutils recognize character
  35. boundaries correctly even in multibyte locales. The following patch
  36. fixes this non-compliance and other internationalization-related bugs:</para>
  37. <screen><userinput>patch -Np1 -i ../&coreutils-i18n-patch;</userinput></screen>
  38. <para>In order for the tests added by this patch to pass, the permissions for
  39. the test file have to be changed:</para>
  40. <screen><userinput>chmod +x tests/sort/sort-mb-tests</userinput></screen>
  41. <note><para>In the past, many bugs were found in this patch. When reporting
  42. new bugs to Coreutils maintainers, please check first if they are reproducible
  43. without this patch.</para></note>
  44. <para>It has been found that translated messages sometimes overflow a buffer
  45. in the <command>who -Hu</command> command. Increase the buffer size:</para>
  46. <screen><userinput>sed -i 's/_LEN 6/_LEN 20/' src/who.c</userinput></screen>
  47. <para>Now prepare Coreutils for compilation:</para>
  48. <screen><userinput>./configure --prefix=/usr</userinput></screen>
  49. <para>Compile the package:</para>
  50. <screen><userinput>make</userinput></screen>
  51. <para>The test suite of Coreutils makes several assumptions about the presence
  52. of system users and groups that are not valid within the minimal environment
  53. that exists at the moment. Therefore, additional items need to be set up before
  54. running the tests. Skip down to <quote>Install the package</quote> if not
  55. running the test suite.</para>
  56. <para>Create two dummy groups and a dummy user:</para>
  57. <screen><userinput>echo "dummy1:x:1000:" &gt;&gt; /etc/group
  58. echo "dummy2:x:1001:dummy" &gt;&gt; /etc/group
  59. echo "dummy:x:1000:1000::/root:/bin/bash" &gt;&gt; /etc/passwd</userinput></screen>
  60. <para>Now the test suite is ready to be run. First, run the tests that
  61. are meant to be run as user <emphasis>root</emphasis>:</para>
  62. <screen><userinput>make NON_ROOT_USERNAME=dummy check-root</userinput></screen>
  63. <para>Then run the remainder of the tests as the
  64. <emphasis>dummy</emphasis> user:</para>
  65. <screen><userinput>src/su dummy -c "make RUN_EXPENSIVE_TESTS=yes check"</userinput></screen>
  66. <para>When testing is complete, remove the dummy user and
  67. groups:</para>
  68. <screen><userinput>sed -i '/dummy/d' /etc/passwd /etc/group</userinput></screen>
  69. <para>Install the package:</para>
  70. <screen><userinput>make install</userinput></screen>
  71. <para>Move programs to the locations specified by the FHS:</para>
  72. <screen><userinput>mv -v /usr/bin/{cat,chgrp,chmod,chown,cp,date,dd,df,echo} /bin
  73. mv -v /usr/bin/{false,hostname,ln,ls,mkdir,mknod,mv,pwd,rm} /bin
  74. mv -v /usr/bin/{rmdir,stty,sync,true,uname} /bin
  75. mv -v /usr/bin/chroot /usr/sbin</userinput></screen>
  76. <para>Some of the scripts in the LFS-Bootscripts package depend on
  77. <command>head</command> and <command>sleep</command>. As
  78. <filename class="directory">/usr</filename> may not be available during the
  79. early stages of booting, those binaries need to be on the root partition:</para>
  80. <screen><userinput>mv -v /usr/bin/{head,sleep} /bin</userinput></screen>
  81. </sect2>
  82. <sect2 id="contents-coreutils" role="content"><title>Contents of Coreutils</title>
  83. <segmentedlist>
  84. <segtitle>Installed programs</segtitle>
  85. <seglistitem><seg>basename, cat, chgrp, chmod, chown, chroot, cksum,
  86. comm, cp, csplit, cut, date, dd, df, dir, dircolors, dirname, du,
  87. echo, env, expand, expr, factor, false, fmt, fold, groups, head,
  88. hostid, hostname, id, install, join, link, ln, logname, ls, md5sum,
  89. mkdir, mkfifo, mknod, mv, nice, nl, nohup, od, paste, pathchk, pinky,
  90. pr, printenv, printf, ptx, pwd, readlink, rm, rmdir, seq, sha1sum,
  91. shred, sleep, sort, split, stat, stty, sum, sync, tac, tail, tee,
  92. test, touch, tr, true, tsort, tty, uname, unexpand, uniq, unlink,
  93. users, vdir, wc, who, whoami, and yes</seg></seglistitem>
  94. </segmentedlist>
  95. <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
  96. <?dbfo list-presentation="list"?>
  97. <?dbhtml list-presentation="table"?>
  98. <varlistentry id="basename">
  99. <term><command>basename</command></term>
  100. <listitem>
  101. <para>Strips any path and a given suffix from a file name</para>
  102. <indexterm zone="ch-system-coreutils basename"><primary sortas="b-basename">basename</primary></indexterm>
  103. </listitem>
  104. </varlistentry>
  105. <varlistentry id="cat">
  106. <term><command>cat</command></term>
  107. <listitem>
  108. <para>Concatenates files to standard output</para>
  109. <indexterm zone="ch-system-coreutils cat"><primary sortas="b-cat">cat</primary></indexterm>
  110. </listitem>
  111. </varlistentry>
  112. <varlistentry id="chgrp">
  113. <term><command>chgrp</command></term>
  114. <listitem>
  115. <para>Changes the group ownership of files and directories</para>
  116. <indexterm zone="ch-system-coreutils chgrp"><primary sortas="b-chgrp">chgrp</primary></indexterm>
  117. </listitem>
  118. </varlistentry>
  119. <varlistentry id="chmod">
  120. <term><command>chmod</command></term>
  121. <listitem>
  122. <para>Changes the permissions of each file to the given mode; the mode
  123. can be either a symbolic representation of the changes to make or an
  124. octal number representing the new permissions</para>
  125. <indexterm zone="ch-system-coreutils chmod"><primary sortas="b-chmod">chmod</primary></indexterm>
  126. </listitem>
  127. </varlistentry>
  128. <varlistentry id="chown">
  129. <term><command>chown</command></term>
  130. <listitem>
  131. <para>Changes the user and/or group ownership of files and directories</para>
  132. <indexterm zone="ch-system-coreutils chown"><primary sortas="b-chown">chown</primary></indexterm>
  133. </listitem>
  134. </varlistentry>
  135. <varlistentry id="chroot">
  136. <term><command>chroot</command></term>
  137. <listitem>
  138. <para>Runs a command with the specified directory as the
  139. <filename class="directory">/</filename> directory</para>
  140. <indexterm zone="ch-system-coreutils chroot"><primary sortas="b-chroot">chroot</primary></indexterm>
  141. </listitem>
  142. </varlistentry>
  143. <varlistentry id="cksum">
  144. <term><command>cksum</command></term>
  145. <listitem>
  146. <para>Prints the Cyclic Redundancy Check (CRC) checksum and the byte
  147. counts of each specified file</para>
  148. <indexterm zone="ch-system-coreutils cksum"><primary sortas="b-cksum">cksum</primary></indexterm>
  149. </listitem>
  150. </varlistentry>
  151. <varlistentry id="comm">
  152. <term><command>comm</command></term>
  153. <listitem>
  154. <para>Compares two sorted files, outputting in three columns the lines
  155. that are unique and the lines that are common</para>
  156. <indexterm zone="ch-system-coreutils comm"><primary sortas="b-comm">comm</primary></indexterm>
  157. </listitem>
  158. </varlistentry>
  159. <varlistentry id="cp">
  160. <term><command>cp</command></term>
  161. <listitem>
  162. <para>Copies files</para>
  163. <indexterm zone="ch-system-coreutils cp"><primary sortas="b-cp">cp</primary></indexterm>
  164. </listitem>
  165. </varlistentry>
  166. <varlistentry id="csplit">
  167. <term><command>csplit</command></term>
  168. <listitem>
  169. <para>Splits a given file into several new files, separating them
  170. according to given patterns or line numbers and outputting the byte
  171. count of each new file</para>
  172. <indexterm zone="ch-system-coreutils csplit"><primary sortas="b-csplit">csplit</primary></indexterm>
  173. </listitem>
  174. </varlistentry>
  175. <varlistentry id="cut">
  176. <term><command>cut</command></term>
  177. <listitem>
  178. <para>Prints sections of lines, selecting the parts according to given
  179. fields or positions</para>
  180. <indexterm zone="ch-system-coreutils cut"><primary sortas="b-cut">cut</primary></indexterm>
  181. </listitem>
  182. </varlistentry>
  183. <varlistentry id="date">
  184. <term><command>date</command></term>
  185. <listitem>
  186. <para>Displays the current time in the given format, or sets the
  187. system date</para>
  188. <indexterm zone="ch-system-coreutils date"><primary sortas="b-date">date</primary></indexterm>
  189. </listitem>
  190. </varlistentry>
  191. <varlistentry id="dd">
  192. <term><command>dd</command> </term>
  193. <listitem>
  194. <para>Copies a file using the given block size and count, while
  195. optionally performing conversions on it</para>
  196. <indexterm zone="ch-system-coreutils dd"><primary sortas="b-dd">dd</primary></indexterm>
  197. </listitem>
  198. </varlistentry>
  199. <varlistentry id="df">
  200. <term><command>df</command></term>
  201. <listitem>
  202. <para>Reports the amount of disk space available (and used) on all
  203. mounted file systems, or only on the file systems holding the selected
  204. files</para>
  205. <indexterm zone="ch-system-coreutils df"><primary sortas="b-df">df</primary></indexterm>
  206. </listitem>
  207. </varlistentry>
  208. <varlistentry id="dir">
  209. <term><command>dir</command></term>
  210. <listitem>
  211. <para>Lists the contents of each given directory (the same as
  212. the <command>ls</command> command)</para>
  213. <indexterm zone="ch-system-coreutils dir"><primary sortas="b-dir">dir</primary></indexterm>
  214. </listitem>
  215. </varlistentry>
  216. <varlistentry id="dircolors">
  217. <term><command>dircolors</command></term>
  218. <listitem>
  219. <para>Outputs commands to set the <envar>LS_COLOR</envar>
  220. environment variable to change the color scheme used by
  221. <command>ls</command></para>
  222. <indexterm zone="ch-system-coreutils dircolors"><primary sortas="b-dircolors">dircolors</primary></indexterm>
  223. </listitem>
  224. </varlistentry>
  225. <varlistentry id="dirname">
  226. <term><command>dirname</command></term>
  227. <listitem>
  228. <para>Strips the non-directory suffix from a file name</para>
  229. <indexterm zone="ch-system-coreutils dirname"><primary sortas="b-dirname">dirname</primary></indexterm>
  230. </listitem>
  231. </varlistentry>
  232. <varlistentry id="du">
  233. <term><command>du</command></term>
  234. <listitem>
  235. <para>Reports the amount of disk space used by the current directory,
  236. by each of the given directories (including all subdirectories) or by
  237. each of the given files</para>
  238. <indexterm zone="ch-system-coreutils du"><primary sortas="b-du">du</primary></indexterm>
  239. </listitem>
  240. </varlistentry>
  241. <varlistentry id="echo">
  242. <term><command>echo</command></term>
  243. <listitem>
  244. <para>Displays the given strings</para>
  245. <indexterm zone="ch-system-coreutils echo"><primary sortas="b-echo">echo</primary></indexterm>
  246. </listitem>
  247. </varlistentry>
  248. <varlistentry id="env">
  249. <term><command>env</command></term>
  250. <listitem>
  251. <para>Runs a command in a modified environment</para>
  252. <indexterm zone="ch-system-coreutils env"><primary sortas="b-env">env</primary></indexterm>
  253. </listitem>
  254. </varlistentry>
  255. <varlistentry id="expand">
  256. <term><command>expand</command></term>
  257. <listitem>
  258. <para>Converts tabs to spaces</para>
  259. <indexterm zone="ch-system-coreutils expand"><primary sortas="b-expand">expand</primary></indexterm>
  260. </listitem>
  261. </varlistentry>
  262. <varlistentry id="expr">
  263. <term><command>expr</command></term>
  264. <listitem>
  265. <para>Evaluates expressions</para>
  266. <indexterm zone="ch-system-coreutils expr"><primary sortas="b-expr">expr</primary></indexterm>
  267. </listitem>
  268. </varlistentry>
  269. <varlistentry id="factor">
  270. <term><command>factor</command></term>
  271. <listitem>
  272. <para>Prints the prime factors of all specified integer numbers</para>
  273. <indexterm zone="ch-system-coreutils factor"><primary sortas="b-factor">factor</primary></indexterm>
  274. </listitem>
  275. </varlistentry>
  276. <varlistentry id="false">
  277. <term><command>false</command></term>
  278. <listitem>
  279. <para>Does nothing, unsuccessfully; it always exits with a status code
  280. indicating failure</para>
  281. <indexterm zone="ch-system-coreutils false"><primary sortas="b-false">false</primary></indexterm>
  282. </listitem>
  283. </varlistentry>
  284. <varlistentry id="fmt">
  285. <term><command>fmt</command></term>
  286. <listitem>
  287. <para>Reformats the paragraphs in the given files</para>
  288. <indexterm zone="ch-system-coreutils fmt"><primary sortas="b-fmt">fmt</primary></indexterm>
  289. </listitem>
  290. </varlistentry>
  291. <varlistentry id="fold">
  292. <term><command>fold</command></term>
  293. <listitem>
  294. <para>Wraps the lines in the given files</para>
  295. <indexterm zone="ch-system-coreutils fold"><primary sortas="b-fold">fold</primary></indexterm>
  296. </listitem>
  297. </varlistentry>
  298. <varlistentry id="groups">
  299. <term><command>groups</command></term>
  300. <listitem>
  301. <para>Reports a user's group memberships</para>
  302. <indexterm zone="ch-system-coreutils groups"><primary sortas="b-groups">groups</primary></indexterm>
  303. </listitem>
  304. </varlistentry>
  305. <varlistentry id="head">
  306. <term><command>head</command></term>
  307. <listitem>
  308. <para>Prints the first ten lines (or the given number of lines) of each given file</para>
  309. <indexterm zone="ch-system-coreutils head"><primary sortas="b-head">head</primary></indexterm>
  310. </listitem>
  311. </varlistentry>
  312. <varlistentry id="hostid">
  313. <term><command>hostid</command></term>
  314. <listitem>
  315. <para>Reports the numeric identifier (in hexadecimal) of the host</para>
  316. <indexterm zone="ch-system-coreutils hostid"><primary sortas="b-hostid">hostid</primary></indexterm>
  317. </listitem>
  318. </varlistentry>
  319. <varlistentry id="hostname">
  320. <term><command>hostname</command></term>
  321. <listitem>
  322. <para>Reports or sets the name of the host</para>
  323. <indexterm zone="ch-system-coreutils hostname"><primary sortas="b-hostname">hostname</primary></indexterm>
  324. </listitem>
  325. </varlistentry>
  326. <varlistentry id="id">
  327. <term><command>id</command></term>
  328. <listitem>
  329. <para>Reports the effective user ID, group ID, and
  330. group memberships of the current user or specified user</para>
  331. <indexterm zone="ch-system-coreutils id"><primary sortas="b-id">id</primary></indexterm>
  332. </listitem>
  333. </varlistentry>
  334. <varlistentry id="install">
  335. <term><command>install</command> </term>
  336. <listitem>
  337. <para>Copies files while setting their
  338. permission modes and, if possible, their owner and group</para>
  339. <indexterm zone="ch-system-coreutils install"><primary sortas="b-install">install</primary></indexterm>
  340. </listitem>
  341. </varlistentry>
  342. <varlistentry id="join">
  343. <term><command>join</command></term>
  344. <listitem>
  345. <para>Joins the lines that have identical join fields from two
  346. separate files</para>
  347. <indexterm zone="ch-system-coreutils join"><primary sortas="b-join">join</primary></indexterm>
  348. </listitem>
  349. </varlistentry>
  350. <varlistentry id="link">
  351. <term><command>link</command></term>
  352. <listitem>
  353. <para>Creates a hard link with the given name to a file</para>
  354. <indexterm zone="ch-system-coreutils link"><primary sortas="b-link">link</primary></indexterm>
  355. </listitem>
  356. </varlistentry>
  357. <varlistentry id="ln">
  358. <term><command>ln</command></term>
  359. <listitem>
  360. <para>Makes hard links or soft (symbolic) links between files</para>
  361. <indexterm zone="ch-system-coreutils ln"><primary sortas="b-ln">ln</primary></indexterm>
  362. </listitem>
  363. </varlistentry>
  364. <varlistentry id="logname">
  365. <term><command>logname</command></term>
  366. <listitem>
  367. <para>Reports the current user's login name</para>
  368. <indexterm zone="ch-system-coreutils logname"><primary sortas="b-logname">logname</primary></indexterm>
  369. </listitem>
  370. </varlistentry>
  371. <varlistentry id="ls">
  372. <term><command>ls</command></term>
  373. <listitem>
  374. <para>Lists the contents of each given directory</para>
  375. <indexterm zone="ch-system-coreutils ls"><primary sortas="b-ls">ls</primary></indexterm>
  376. </listitem>
  377. </varlistentry>
  378. <varlistentry id="md5sum">
  379. <term><command>md5sum</command></term>
  380. <listitem>
  381. <para>Reports or checks Message Digest 5 (MD5) checksums</para>
  382. <indexterm zone="ch-system-coreutils md5sum"><primary sortas="b-md5sum">md5sum</primary></indexterm>
  383. </listitem>
  384. </varlistentry>
  385. <varlistentry id="mkdir">
  386. <term><command>mkdir</command></term>
  387. <listitem>
  388. <para>Creates directories with the given names</para>
  389. <indexterm zone="ch-system-coreutils mkdir"><primary sortas="b-mkdir">mkdir</primary></indexterm>
  390. </listitem>
  391. </varlistentry>
  392. <varlistentry id="mkfifo">
  393. <term><command>mkfifo</command></term>
  394. <listitem>
  395. <para>Creates First-In, First-Outs (FIFOs), a <quote>named
  396. pipe</quote> in UNIX parlance, with the given names</para>
  397. <indexterm zone="ch-system-coreutils mkfifo"><primary sortas="b-mkfifo">mkfifo</primary></indexterm>
  398. </listitem>
  399. </varlistentry>
  400. <varlistentry id="mknod">
  401. <term><command>mknod</command></term>
  402. <listitem>
  403. <para>Creates device nodes with the given names; a device node is a
  404. character special file, a block special file, or a FIFO</para>
  405. <indexterm zone="ch-system-coreutils mknod"><primary sortas="b-mknod">mknod</primary></indexterm>
  406. </listitem>
  407. </varlistentry>
  408. <varlistentry id="mv">
  409. <term><command>mv</command></term>
  410. <listitem>
  411. <para>Moves or renames files or directories</para>
  412. <indexterm zone="ch-system-coreutils mv"><primary sortas="b-mv">mv</primary></indexterm>
  413. </listitem>
  414. </varlistentry>
  415. <varlistentry id="nice">
  416. <term><command>nice</command></term>
  417. <listitem>
  418. <para>Runs a program with modified scheduling priority</para>
  419. <indexterm zone="ch-system-coreutils nice"><primary sortas="b-nice">nice</primary></indexterm>
  420. </listitem>
  421. </varlistentry>
  422. <varlistentry id="nl">
  423. <term><command>nl</command></term>
  424. <listitem>
  425. <para>Numbers the lines from the given files</para>
  426. <indexterm zone="ch-system-coreutils nl"><primary sortas="b-nl">nl</primary></indexterm>
  427. </listitem>
  428. </varlistentry>
  429. <varlistentry id="nohup">
  430. <term><command>nohup</command></term>
  431. <listitem>
  432. <para>Runs a command immune to hangups, with its output redirected to
  433. a log file</para>
  434. <indexterm zone="ch-system-coreutils nohup"><primary sortas="b-nohup">nohup</primary></indexterm>
  435. </listitem>
  436. </varlistentry>
  437. <varlistentry id="od">
  438. <term><command>od</command></term>
  439. <listitem>
  440. <para>Dumps files in octal and other formats</para>
  441. <indexterm zone="ch-system-coreutils od"><primary sortas="b-od">od</primary></indexterm>
  442. </listitem>
  443. </varlistentry>
  444. <varlistentry id="paste">
  445. <term><command>paste</command></term>
  446. <listitem>
  447. <para>Merges the given files, joining sequentially corresponding lines
  448. side by side, separated by tab characters</para>
  449. <indexterm zone="ch-system-coreutils paste"><primary sortas="b-paste">paste</primary></indexterm>
  450. </listitem>
  451. </varlistentry>
  452. <varlistentry id="pathchk">
  453. <term><command>pathchk</command></term>
  454. <listitem>
  455. <para>Checks if file names are valid or portable</para>
  456. <indexterm zone="ch-system-coreutils pathchk"><primary sortas="b-pathchk">pathchk</primary></indexterm>
  457. </listitem>
  458. </varlistentry>
  459. <varlistentry id="pinky">
  460. <term><command>pinky</command></term>
  461. <listitem>
  462. <para>Is a lightweight finger client; it reports some information about the given users</para>
  463. <indexterm zone="ch-system-coreutils pinky"><primary sortas="b-pinky">pinky</primary></indexterm>
  464. </listitem>
  465. </varlistentry>
  466. <varlistentry id="pr">
  467. <term><command>pr</command></term>
  468. <listitem>
  469. <para>Paginates and columnates files for printing</para>
  470. <indexterm zone="ch-system-coreutils pr"><primary sortas="b-pr">pr</primary></indexterm>
  471. </listitem>
  472. </varlistentry>
  473. <varlistentry id="printenv">
  474. <term><command>printenv</command></term>
  475. <listitem>
  476. <para>Prints the environment</para>
  477. <indexterm zone="ch-system-coreutils printenv"><primary sortas="b-printenv">printenv</primary></indexterm>
  478. </listitem>
  479. </varlistentry>
  480. <varlistentry id="printf">
  481. <term><command>printf</command></term>
  482. <listitem>
  483. <para>Prints the given arguments according to the given format, much
  484. like the C printf function</para>
  485. <indexterm zone="ch-system-coreutils printf"><primary sortas="b-printf">printf</primary></indexterm>
  486. </listitem>
  487. </varlistentry>
  488. <varlistentry id="ptx">
  489. <term><command>ptx</command></term>
  490. <listitem>
  491. <para>Produces a permuted index from the contents of the given files,
  492. with each keyword in its context</para>
  493. <indexterm zone="ch-system-coreutils ptx"><primary sortas="b-ptx">ptx</primary></indexterm>
  494. </listitem>
  495. </varlistentry>
  496. <varlistentry id="pwd">
  497. <term><command>pwd</command></term>
  498. <listitem>
  499. <para>Reports the name of the current working directory</para>
  500. <indexterm zone="ch-system-coreutils pwd"><primary sortas="b-pwd">pwd</primary></indexterm>
  501. </listitem>
  502. </varlistentry>
  503. <varlistentry id="readlink">
  504. <term><command>readlink</command></term>
  505. <listitem>
  506. <para>Reports the value of the given symbolic link</para>
  507. <indexterm zone="ch-system-coreutils readlink"><primary sortas="b-readlink">readlink</primary></indexterm>
  508. </listitem>
  509. </varlistentry>
  510. <varlistentry id="rm">
  511. <term><command>rm</command></term>
  512. <listitem>
  513. <para>Removes files or directories</para>
  514. <indexterm zone="ch-system-coreutils rm"><primary sortas="b-rm">rm</primary></indexterm>
  515. </listitem>
  516. </varlistentry>
  517. <varlistentry id="rmdir">
  518. <term><command>rmdir</command></term>
  519. <listitem>
  520. <para>Removes directories if they are empty</para>
  521. <indexterm zone="ch-system-coreutils rmdir"><primary sortas="b-rmdir">rmdir</primary></indexterm>
  522. </listitem>
  523. </varlistentry>
  524. <varlistentry id="seq">
  525. <term><command>seq</command></term>
  526. <listitem>
  527. <para>Prints a sequence of numbers within a given range and with a
  528. given increment</para>
  529. <indexterm zone="ch-system-coreutils seq"><primary sortas="b-seq">seq</primary></indexterm>
  530. </listitem>
  531. </varlistentry>
  532. <varlistentry id="sha1sum">
  533. <term><command>sha1sum</command></term>
  534. <listitem>
  535. <para>Prints or checks 160-bit Secure Hash Algorithm 1 (SHA1) checksums</para>
  536. <indexterm zone="ch-system-coreutils sha1sum"><primary sortas="b-sha1sum">sha1sum</primary></indexterm>
  537. </listitem>
  538. </varlistentry>
  539. <varlistentry id="shred">
  540. <term><command>shred</command></term>
  541. <listitem>
  542. <para>Overwrites the given files repeatedly with complex patterns,
  543. making it difficult to recover the data</para>
  544. <indexterm zone="ch-system-coreutils shred"><primary sortas="b-shred">shred</primary></indexterm>
  545. </listitem>
  546. </varlistentry>
  547. <varlistentry id="sleep">
  548. <term><command>sleep</command></term>
  549. <listitem>
  550. <para>Pauses for the given amount of time</para>
  551. <indexterm zone="ch-system-coreutils sleep"><primary sortas="b-sleep">sleep</primary></indexterm>
  552. </listitem>
  553. </varlistentry>
  554. <varlistentry id="sort">
  555. <term><command>sort</command></term>
  556. <listitem>
  557. <para>Sorts the lines from the given files</para>
  558. <indexterm zone="ch-system-coreutils sort"><primary sortas="b-sort">sort</primary></indexterm>
  559. </listitem>
  560. </varlistentry>
  561. <varlistentry id="split">
  562. <term><command>split</command></term>
  563. <listitem>
  564. <para>Splits the given file into pieces, by size or by number of lines</para>
  565. <indexterm zone="ch-system-coreutils split"><primary sortas="b-split">split</primary></indexterm>
  566. </listitem>
  567. </varlistentry>
  568. <varlistentry id="stat">
  569. <term><command>stat</command></term>
  570. <listitem>
  571. <para>Displays file or filesystem status</para>
  572. <indexterm zone="ch-system-coreutils stat"><primary sortas="b-stat">stat</primary></indexterm>
  573. </listitem>
  574. </varlistentry>
  575. <varlistentry id="stty">
  576. <term><command>stty</command></term>
  577. <listitem>
  578. <para>Sets or reports terminal line settings</para>
  579. <indexterm zone="ch-system-coreutils stty"><primary sortas="b-stty">stty</primary></indexterm>
  580. </listitem>
  581. </varlistentry>
  582. <varlistentry id="sum">
  583. <term><command>sum</command></term>
  584. <listitem>
  585. <para>Prints checksum and block counts for each given file</para>
  586. <indexterm zone="ch-system-coreutils sum"><primary sortas="b-sum">sum</primary></indexterm>
  587. </listitem>
  588. </varlistentry>
  589. <varlistentry id="sync">
  590. <term><command>sync</command></term>
  591. <listitem>
  592. <para>Flushes file system buffers; it forces changed blocks to disk
  593. and updates the super block</para>
  594. <indexterm zone="ch-system-coreutils sync"><primary sortas="b-sync">sync</primary></indexterm>
  595. </listitem>
  596. </varlistentry>
  597. <varlistentry id="tac">
  598. <term><command>tac</command></term>
  599. <listitem>
  600. <para>Concatenates the given files in reverse</para>
  601. <indexterm zone="ch-system-coreutils tac"><primary sortas="b-tac">tac</primary></indexterm>
  602. </listitem>
  603. </varlistentry>
  604. <varlistentry id="tail">
  605. <term><command>tail</command></term>
  606. <listitem>
  607. <para>Prints the last ten lines (or the given number of lines) of each
  608. given file</para>
  609. <indexterm zone="ch-system-coreutils tail"><primary sortas="b-tail">tail</primary></indexterm>
  610. </listitem>
  611. </varlistentry>
  612. <varlistentry id="tee">
  613. <term><command>tee</command></term>
  614. <listitem>
  615. <para>Reads from standard input while writing both to standard output
  616. and to the given files</para>
  617. <indexterm zone="ch-system-coreutils tee"><primary sortas="b-tee">tee</primary></indexterm>
  618. </listitem>
  619. </varlistentry>
  620. <varlistentry id="test">
  621. <term><command>test</command></term>
  622. <listitem>
  623. <para>Compares values and checks file types</para>
  624. <indexterm zone="ch-system-coreutils test"><primary sortas="b-test">test</primary></indexterm>
  625. </listitem>
  626. </varlistentry>
  627. <varlistentry id="touch">
  628. <term><command>touch</command></term>
  629. <listitem>
  630. <para>Changes file timestamps, setting the access and modification
  631. times of the given files to the current time; files that do not exist
  632. are created with zero length</para>
  633. <indexterm zone="ch-system-coreutils touch"><primary sortas="b-touch">touch</primary></indexterm>
  634. </listitem>
  635. </varlistentry>
  636. <varlistentry id="tr">
  637. <term><command>tr</command></term>
  638. <listitem>
  639. <para>Translates, squeezes, and deletes the given characters from
  640. standard input</para>
  641. <indexterm zone="ch-system-coreutils tr"><primary sortas="b-tr">tr</primary></indexterm>
  642. </listitem>
  643. </varlistentry>
  644. <varlistentry id="true">
  645. <term><command>true</command></term>
  646. <listitem>
  647. <para>Does nothing, successfully; it always exits with a status code
  648. indicating success</para>
  649. <indexterm zone="ch-system-coreutils true"><primary sortas="b-true">true</primary></indexterm>
  650. </listitem>
  651. </varlistentry>
  652. <varlistentry id="tsort">
  653. <term><command>tsort</command></term>
  654. <listitem>
  655. <para>Performs a topological sort; it writes a completely ordered list
  656. according to the partial ordering in a given file</para>
  657. <indexterm zone="ch-system-coreutils tsort"><primary sortas="b-tsort">tsort</primary></indexterm>
  658. </listitem>
  659. </varlistentry>
  660. <varlistentry id="tty">
  661. <term><command>tty</command></term>
  662. <listitem>
  663. <para>Reports the file name of the terminal connected to standard
  664. input</para>
  665. <indexterm zone="ch-system-coreutils tty"><primary sortas="b-tty">tty</primary></indexterm>
  666. </listitem>
  667. </varlistentry>
  668. <varlistentry id="uname">
  669. <term><command>uname</command></term>
  670. <listitem>
  671. <para>Reports system information</para>
  672. <indexterm zone="ch-system-coreutils uname"><primary sortas="b-uname">uname</primary></indexterm>
  673. </listitem>
  674. </varlistentry>
  675. <varlistentry id="unexpand">
  676. <term><command>unexpand</command></term>
  677. <listitem>
  678. <para>Converts spaces to tabs</para>
  679. <indexterm zone="ch-system-coreutils unexpand"><primary sortas="b-unexpand">unexpand</primary></indexterm>
  680. </listitem>
  681. </varlistentry>
  682. <varlistentry id="uniq">
  683. <term><command>uniq</command></term>
  684. <listitem>
  685. <para>Discards all but one of successive identical lines</para>
  686. <indexterm zone="ch-system-coreutils uniq"><primary sortas="b-uniq">uniq</primary></indexterm>
  687. </listitem>
  688. </varlistentry>
  689. <varlistentry id="unlink">
  690. <term><command>unlink</command></term>
  691. <listitem>
  692. <para>Removes the given file</para>
  693. <indexterm zone="ch-system-coreutils unlink"><primary sortas="b-unlink">unlink</primary></indexterm>
  694. </listitem>
  695. </varlistentry>
  696. <varlistentry id="users">
  697. <term><command>users</command></term>
  698. <listitem>
  699. <para>Reports the names of the users currently logged on</para>
  700. <indexterm zone="ch-system-coreutils users"><primary sortas="b-users">users</primary></indexterm>
  701. </listitem>
  702. </varlistentry>
  703. <varlistentry id="vdir">
  704. <term><command>vdir</command></term>
  705. <listitem>
  706. <para>Is the same as <command>ls -l</command></para>
  707. <indexterm zone="ch-system-coreutils vdir"><primary sortas="b-vdir">vdir</primary></indexterm>
  708. </listitem>
  709. </varlistentry>
  710. <varlistentry id="wc">
  711. <term><command>wc</command></term>
  712. <listitem>
  713. <para>Reports the number of lines, words, and bytes for each given
  714. file, as well as a total line when more than one file is given</para>
  715. <indexterm zone="ch-system-coreutils wc"><primary sortas="b-wc">wc</primary></indexterm>
  716. </listitem>
  717. </varlistentry>
  718. <varlistentry id="who">
  719. <term><command>who</command></term>
  720. <listitem>
  721. <para>Reports who is logged on</para>
  722. <indexterm zone="ch-system-coreutils who"><primary sortas="b-who">who</primary></indexterm>
  723. </listitem>
  724. </varlistentry>
  725. <varlistentry id="whoami">
  726. <term><command>whoami</command></term>
  727. <listitem>
  728. <para>Reports the user name associated with the current effective user ID</para>
  729. <indexterm zone="ch-system-coreutils whoami"><primary sortas="b-whoami">whoami</primary></indexterm>
  730. </listitem>
  731. </varlistentry>
  732. <varlistentry id="yes">
  733. <term><command>yes</command></term>
  734. <listitem>
  735. <para>Repeatedly outputs <quote>y</quote> or a given string until
  736. killed</para>
  737. <indexterm zone="ch-system-coreutils yes"><primary sortas="b-yes">yes</primary></indexterm>
  738. </listitem>
  739. </varlistentry>
  740. </variablelist>
  741. </sect2>
  742. </sect1>