source: clfs-sysroot/BOOK/final-system/common/coreutils.xml@ c8591d3

Last change on this file since c8591d3 was 271a409, checked in by Joe Ciccone <jciccone@…>, 16 years ago

Add additional config.cache entries to coreutils that fix compilation errors.

  • Property mode set to 100644
File size: 39.6 KB
RevLine 
[02095ae]1<?xml version="1.0" encoding="ISO-8859-1"?>
[c439b8a]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[02095ae]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-coreutils" role="wrap">
9 <?dbhtml filename="coreutils.html"?>
10
11 <title>Coreutils-&coreutils-version;</title>
12
13 <indexterm zone="ch-system-coreutils">
14 <primary sortas="a-Coreutils">Coreutils</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Coreutils package contains utilities for showing and setting the
21 basic system characteristics.</para>
22
23 </sect2>
24
25 <sect2 role="installation">
26 <title>Installation of Coreutils</title>
27
[2270211]28 <para os="p1">A known issue with the <command>uname</command> program from
[485c2de]29 this package is that the <option>-p</option> switch always
30 returns <computeroutput>unknown</computeroutput>. The following patch
31 fixes this behavior for all architectures:</para>
32
[2270211]33<screen os="p2"><userinput>patch -Np1 -i ../&coreutils-uname-patch;</userinput></screen>
[485c2de]34
[0eb57e6]35 <para os="aa">The above patch modifies the source code for
36 <command>uname</command>. Because it now has a newer timestamp then
37 its man page, the <filename>Makefile</filename> is going to
38 try to regenerate the man page. If executables for the target architecture
[9568bd5]39 can not be executed by the host system, the build will fail. The following
[0eb57e6]40 command fixes this by giving the man page a newer timestamp then its
41 corresponding source file:</para>
[9568bd5]42
[0eb57e6]43<screen os="ab"><userinput>touch man/uname.1</userinput></screen>
[7329dbe]44
45 <para os="s1">Coreutils attempts to use the <command>install</command>
46 program it just built to perform the install. This will not work if the
47 target architecture is incompatible with the host architecture. The
48 following command causes the Makefile to use the host's
49 <command>install</command> to perform the install:</para>
50
51<screen os="s2"><userinput>cp -v src/Makefile.in{,.orig}
[73b1cbb]52sed -e "/binPROGRAMS_INSTALL=/s:./ginstall:install:" src/Makefile.in.orig &gt; src/Makefile.in</userinput></screen>
[3f41ad5]53
[3cf26f7]54 <para os="a">Configure can not properly determine how to get free space
[d30b2ab]55 when cross-compiling - as a result, the <command>df</command> program will
56 not be built. Add the following entry to <filename>config.cache</filename>
57 to correct this:</para>
[9748f02]58
[cc8d737]59<screen os="b"><userinput>cat &gt; config.cache &lt;&lt; EOF
60fu_cv_sys_stat_statfs2_bsize=yes
[271a409]61gl_cv_func_mbrtowc_incomplete_state=yes
62gl_cv_func_mbrtowc_nul_retval=yes
63gl_cv_func_mbrtowc_null_arg=yes
64gl_cv_func_mbrtowc_retval=yes
65gl_cv_func_btowc_eof=yes
66gl_cv_func_wcrtomb_retval=yes
67gl_cv_func_wctob_works=yes
[cc8d737]68EOF</userinput></screen>
[02095ae]69
70 <para os="c">Now prepare Coreutils for compilation:</para>
71
[cee2ca2]72<screen os="d"><userinput>./configure --build=${CLFS_HOST} --host=${CLFS_TARGET} \
[7329dbe]73 --prefix=/usr --cache-file=config.cache \
74 --enable-no-install-program=kill,uptime \
75 --enable-install-program=hostname</userinput></screen>
[02095ae]76
77 <para os="e">Compile the package:</para>
78
79<screen os="f"><userinput>make</userinput></screen>
80
81 <para os="g">Install the package:</para>
82
[586feb7]83<screen os="h"><userinput>make DESTDIR=${CLFS} install</userinput></screen>
[02095ae]84
85 <para os="i">Move programs to the locations specified by the FHS:</para>
86
[586feb7]87<screen os="j"><userinput>mv -v ${CLFS}/usr/bin/{cat,chgrp,chmod,chown,cp,date} ${CLFS}/bin
[a074923]88mv -v ${CLFS}/usr/bin/{dd,df,echo,false,hostname,ln,ls,mkdir} ${CLFS}/bin
[7329dbe]89mv -v ${CLFS}/usr/bin/{mv,pwd,rm,rmdir,stty,true,uname} ${CLFS}/bin
[586feb7]90mv -v ${CLFS}/usr/bin/chroot ${CLFS}/usr/sbin</userinput></screen>
[02095ae]91
[586feb7]92 <para os="k">Other Coreutils programs are used by some of the scripts
[e4f6ff4]93 in the CLFS-Bootscripts package. As <filename
[02095ae]94 class="directory">/usr</filename> may not be available during the early
95 stages of booting, those binaries need to be on the root partition:</para>
96
[586feb7]97<screen os="l"><userinput>mv -v ${CLFS}/usr/bin/{[,basename,head,install,nice} ${CLFS}/bin
98mv -v ${CLFS}/usr/bin/{readlink,sleep,sync,test,touch} ${CLFS}/bin
[394cdeb]99ln -sfv ../../bin/install ${CLFS}/usr/bin</userinput></screen>
[02095ae]100
101 </sect2>
102
103 <sect2 id="contents-coreutils" role="content">
104 <title>Contents of Coreutils</title>
105
106 <segmentedlist>
107 <segtitle>Installed programs</segtitle>
108
109 <seglistitem>
[058bc6b]110 <seg>[, base64, basename, cat, chcon, chgrp, chmod, chown, chroot,
111 cksum, comm, cp, csplit, cut, date, dd, df, dir, dircolors, dirname, du,
[02095ae]112 echo, env, expand, expr, factor, false, fmt, fold, groups, head,
113 hostid, hostname, id, install, join, link, ln, logname, ls, md5sum,
[058bc6b]114 mkdir, mkfifo, mknod, mktemp, mv, nice, nl, nohup, od, paste, pathchk,
115 pinky, pr, printenv, printf, ptx, pwd, readlink, rm, rmdir, runcon, seq,
116 sha1sum, sha224sum, sha256sum, sha384sum, sha512sum, shred, shuf,
117 sleep, sort, split, stat, stty, sum, sync, tac, tail, tee, test,
118 timeout, touch, tr, true, truncate, tsort, tty, uname, unexpand, uniq,
119 unlink, users, vdir, wc, who, whoami, and yes</seg>
[02095ae]120 </seglistitem>
121 </segmentedlist>
122
123 <variablelist>
124 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
125 <?dbfo list-presentation="list"?>
126 <?dbhtml list-presentation="table"?>
127
[d2c51b1]128 <varlistentry id="base64">
129 <term><command>base64</command></term>
130 <listitem>
131 <para>Base64 encode/decode data and print to standard output</para>
132 <indexterm zone="ch-system-coreutils base64">
133 <primary sortas="b-base64">base64</primary>
134 </indexterm>
135 </listitem>
136 </varlistentry>
137
[02095ae]138 <varlistentry id="basename">
139 <term><command>basename</command></term>
140 <listitem>
141 <para>Strips any path and a given suffix from a file name</para>
142 <indexterm zone="ch-system-coreutils basename">
143 <primary sortas="b-basename">basename</primary>
144 </indexterm>
145 </listitem>
146 </varlistentry>
147
148 <varlistentry id="cat">
149 <term><command>cat</command></term>
150 <listitem>
151 <para>Concatenates files to standard output</para>
152 <indexterm zone="ch-system-coreutils cat">
153 <primary sortas="b-cat">cat</primary>
154 </indexterm>
155 </listitem>
156 </varlistentry>
157
[058bc6b]158 <varlistentry id="chcon">
159 <term><command>chcon</command></term>
160 <listitem>
161 <para>Changes security context for files and directories</para>
162 <indexterm zone="ch-system-coreutils chcon">
163 <primary sortas="b-chcon">chcon</primary>
164 </indexterm>
165 </listitem>
166 </varlistentry>
167
[02095ae]168 <varlistentry id="chgrp">
169 <term><command>chgrp</command></term>
170 <listitem>
171 <para>Changes the group ownership of files and directories</para>
172 <indexterm zone="ch-system-coreutils chgrp">
173 <primary sortas="b-chgrp">chgrp</primary>
174 </indexterm>
175 </listitem>
176 </varlistentry>
177
178 <varlistentry id="chmod">
179 <term><command>chmod</command></term>
180 <listitem>
181 <para>Changes the permissions of each file to the given mode; the mode
182 can be either a symbolic representation of the changes to make or an
183 octal number representing the new permissions</para>
184 <indexterm zone="ch-system-coreutils chmod">
185 <primary sortas="b-chmod">chmod</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="chown">
191 <term><command>chown</command></term>
192 <listitem>
193 <para>Changes the user and/or group ownership of files and
194 directories</para>
195 <indexterm zone="ch-system-coreutils chown">
196 <primary sortas="b-chown">chown</primary>
197 </indexterm>
198 </listitem>
199 </varlistentry>
200
201 <varlistentry id="chroot">
202 <term><command>chroot</command></term>
203 <listitem>
204 <para>Runs a command with the specified directory as the
205 <filename class="directory">/</filename> directory</para>
206 <indexterm zone="ch-system-coreutils chroot">
207 <primary sortas="b-chroot">chroot</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="cksum">
213 <term><command>cksum</command></term>
214 <listitem>
215 <para>Prints the Cyclic Redundancy Check (CRC) checksum and the byte
216 counts of each specified file</para>
217 <indexterm zone="ch-system-coreutils cksum">
218 <primary sortas="b-cksum">cksum</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="comm">
224 <term><command>comm</command></term>
225 <listitem>
226 <para>Compares two sorted files, outputting in three columns the lines
227 that are unique and the lines that are common</para>
228 <indexterm zone="ch-system-coreutils comm">
229 <primary sortas="b-comm">comm</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="cp">
235 <term><command>cp</command></term>
236 <listitem>
237 <para>Copies files</para>
238 <indexterm zone="ch-system-coreutils cp">
239 <primary sortas="b-cp">cp</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="csplit">
245 <term><command>csplit</command></term>
246 <listitem>
247 <para>Splits a given file into several new files, separating them
248 according to given patterns or line numbers and outputting the byte
249 count of each new file</para>
250 <indexterm zone="ch-system-coreutils csplit">
251 <primary sortas="b-csplit">csplit</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="cut">
257 <term><command>cut</command></term>
258 <listitem>
259 <para>Prints sections of lines, selecting the parts according to given
260 fields or positions</para>
261 <indexterm zone="ch-system-coreutils cut">
262 <primary sortas="b-cut">cut</primary>
263 </indexterm>
264 </listitem>
265 </varlistentry>
266
267 <varlistentry id="date">
268 <term><command>date</command></term>
269 <listitem>
270 <para>Displays the current time in the given format, or sets the
271 system date</para>
272 <indexterm zone="ch-system-coreutils date">
273 <primary sortas="b-date">date</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="dd">
279 <term><command>dd</command> </term>
280 <listitem>
281 <para>Copies a file using the given block size and count, while
282 optionally performing conversions on it</para>
283 <indexterm zone="ch-system-coreutils dd">
284 <primary sortas="b-dd">dd</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="df">
290 <term><command>df</command></term>
291 <listitem>
292 <para>Reports the amount of disk space available (and used) on all
293 mounted file systems, or only on the file systems holding the selected
294 files</para>
295 <indexterm zone="ch-system-coreutils df">
296 <primary sortas="b-df">df</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="dir">
302 <term><command>dir</command></term>
303 <listitem>
304 <para>Lists the contents of each given directory (the same as
305 the <command>ls</command> command)</para>
306 <indexterm zone="ch-system-coreutils dir">
307 <primary sortas="b-dir">dir</primary>
308 </indexterm>
309 </listitem>
310 </varlistentry>
311
312 <varlistentry id="dircolors">
313 <term><command>dircolors</command></term>
314 <listitem>
315 <para>Outputs commands to set the <envar>LS_COLOR</envar>
316 environment variable to change the color scheme used by
317 <command>ls</command></para>
318 <indexterm zone="ch-system-coreutils dircolors">
319 <primary sortas="b-dircolors">dircolors</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="dirname">
325 <term><command>dirname</command></term>
326 <listitem>
327 <para>Strips the non-directory suffix from a file name</para>
328 <indexterm zone="ch-system-coreutils dirname">
329 <primary sortas="b-dirname">dirname</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="du">
335 <term><command>du</command></term>
336 <listitem>
337 <para>Reports the amount of disk space used by the current directory,
338 by each of the given directories (including all subdirectories) or by
339 each of the given files</para>
340 <indexterm zone="ch-system-coreutils du">
341 <primary sortas="b-du">du</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="echo">
347 <term><command>echo</command></term>
348 <listitem>
349 <para>Displays the given strings</para>
350 <indexterm zone="ch-system-coreutils echo">
351 <primary sortas="b-echo">echo</primary>
352 </indexterm>
353 </listitem>
354 </varlistentry>
355
356 <varlistentry id="env">
357 <term><command>env</command></term>
358 <listitem>
359 <para>Runs a command in a modified environment</para>
360 <indexterm zone="ch-system-coreutils env">
361 <primary sortas="b-env">env</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="expand">
367 <term><command>expand</command></term>
368 <listitem>
369 <para>Converts tabs to spaces</para>
370 <indexterm zone="ch-system-coreutils expand">
371 <primary sortas="b-expand">expand</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="expr">
377 <term><command>expr</command></term>
378 <listitem>
379 <para>Evaluates expressions</para>
380 <indexterm zone="ch-system-coreutils expr">
381 <primary sortas="b-expr">expr</primary>
382 </indexterm>
383 </listitem>
384 </varlistentry>
385
386 <varlistentry id="factor">
387 <term><command>factor</command></term>
388 <listitem>
389 <para>Prints the prime factors of all specified integer numbers</para>
390 <indexterm zone="ch-system-coreutils factor">
391 <primary sortas="b-factor">factor</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="false">
397 <term><command>false</command></term>
398 <listitem>
399 <para>Does nothing, unsuccessfully; it always exits with a status code
400 indicating failure</para>
401 <indexterm zone="ch-system-coreutils false">
402 <primary sortas="b-false">false</primary>
403 </indexterm>
404 </listitem>
405 </varlistentry>
406
407 <varlistentry id="fmt">
408 <term><command>fmt</command></term>
409 <listitem>
410 <para>Reformats the paragraphs in the given files</para>
411 <indexterm zone="ch-system-coreutils fmt">
412 <primary sortas="b-fmt">fmt</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="fold">
418 <term><command>fold</command></term>
419 <listitem>
420 <para>Wraps the lines in the given files</para>
421 <indexterm zone="ch-system-coreutils fold">
422 <primary sortas="b-fold">fold</primary>
423 </indexterm>
424 </listitem>
425 </varlistentry>
426
427 <varlistentry id="groups">
428 <term><command>groups</command></term>
429 <listitem>
430 <para>Reports a user's group memberships</para>
431 <indexterm zone="ch-system-coreutils groups">
432 <primary sortas="b-groups">groups</primary>
433 </indexterm>
434 </listitem>
435 </varlistentry>
436
437 <varlistentry id="head">
438 <term><command>head</command></term>
439 <listitem>
440 <para>Prints the first ten lines (or the given number of lines)
441 of each given file</para>
442 <indexterm zone="ch-system-coreutils head">
443 <primary sortas="b-head">head</primary>
444 </indexterm>
445 </listitem>
446 </varlistentry>
447
448 <varlistentry id="hostid">
449 <term><command>hostid</command></term>
450 <listitem>
451 <para>Reports the numeric identifier (in hexadecimal) of the host</para>
452 <indexterm zone="ch-system-coreutils hostid">
453 <primary sortas="b-hostid">hostid</primary>
454 </indexterm>
455 </listitem>
456 </varlistentry>
457
458 <varlistentry id="hostname">
459 <term><command>hostname</command></term>
460 <listitem>
461 <para>Reports or sets the name of the host</para>
462 <indexterm zone="ch-system-coreutils hostname">
463 <primary sortas="b-hostname">hostname</primary>
464 </indexterm>
465 </listitem>
466 </varlistentry>
467
468 <varlistentry id="id">
469 <term><command>id</command></term>
470 <listitem>
471 <para>Reports the effective user ID, group ID, and group memberships
472 of the current user or specified user</para>
473 <indexterm zone="ch-system-coreutils id">
474 <primary sortas="b-id">id</primary>
475 </indexterm>
476 </listitem>
477 </varlistentry>
478
479 <varlistentry id="install">
480 <term><command>install</command> </term>
481 <listitem>
482 <para>Copies files while setting their permission modes and, if
483 possible, their owner and group</para>
484 <indexterm zone="ch-system-coreutils install">
485 <primary sortas="b-install">install</primary>
486 </indexterm>
487 </listitem>
488 </varlistentry>
489
490 <varlistentry id="join">
491 <term><command>join</command></term>
492 <listitem>
493 <para>Joins the lines that have identical join fields from two
494 separate files</para>
495 <indexterm zone="ch-system-coreutils join">
496 <primary sortas="b-join">join</primary>
497 </indexterm>
498 </listitem>
499 </varlistentry>
500
501 <varlistentry id="link">
502 <term><command>link</command></term>
503 <listitem>
504 <para>Creates a hard link with the given name to a file</para>
505 <indexterm zone="ch-system-coreutils link">
506 <primary sortas="b-link">link</primary>
507 </indexterm>
508 </listitem>
509 </varlistentry>
510
511 <varlistentry id="ln">
512 <term><command>ln</command></term>
513 <listitem>
514 <para>Makes hard links or soft (symbolic) links between files</para>
515 <indexterm zone="ch-system-coreutils ln">
516 <primary sortas="b-ln">ln</primary>
517 </indexterm>
518 </listitem>
519 </varlistentry>
520
521 <varlistentry id="logname">
522 <term><command>logname</command></term>
523 <listitem>
524 <para>Reports the current user's login name</para>
525 <indexterm zone="ch-system-coreutils logname">
526 <primary sortas="b-logname">logname</primary>
527 </indexterm>
528 </listitem>
529 </varlistentry>
530
531 <varlistentry id="ls">
532 <term><command>ls</command></term>
533 <listitem>
534 <para>Lists the contents of each given directory</para>
535 <indexterm zone="ch-system-coreutils ls">
536 <primary sortas="b-ls">ls</primary>
537 </indexterm>
538 </listitem>
539 </varlistentry>
540
541 <varlistentry id="md5sum">
542 <term><command>md5sum</command></term>
543 <listitem>
544 <para>Reports or checks Message Digest 5 (MD5) checksums</para>
545 <indexterm zone="ch-system-coreutils md5sum">
546 <primary sortas="b-md5sum">md5sum</primary>
547 </indexterm>
548 </listitem>
549 </varlistentry>
550
551 <varlistentry id="mkdir">
552 <term><command>mkdir</command></term>
553 <listitem>
554 <para>Creates directories with the given names</para>
555 <indexterm zone="ch-system-coreutils mkdir">
556 <primary sortas="b-mkdir">mkdir</primary>
557 </indexterm>
558 </listitem>
559 </varlistentry>
560
561 <varlistentry id="mkfifo">
562 <term><command>mkfifo</command></term>
563 <listitem>
564 <para>Creates First-In, First-Outs (FIFOs), a <quote>named
565 pipe</quote> in UNIX parlance, with the given names</para>
566 <indexterm zone="ch-system-coreutils mkfifo">
567 <primary sortas="b-mkfifo">mkfifo</primary>
568 </indexterm>
569 </listitem>
570 </varlistentry>
571
572 <varlistentry id="mknod">
573 <term><command>mknod</command></term>
574 <listitem>
575 <para>Creates device nodes with the given names; a device node is a
576 character special file, a block special file, or a FIFO</para>
577 <indexterm zone="ch-system-coreutils mknod">
578 <primary sortas="b-mknod">mknod</primary>
579 </indexterm>
580 </listitem>
581 </varlistentry>
582
[058bc6b]583 <varlistentry id="mktemp">
584 <term><command>mktemp</command></term>
585 <listitem>
586 <para>Creates temporary files in a secure manner; it is used in
587 scripts</para>
588 <indexterm zone="ch-system-coreutils mktemp">
589 <primary sortas="b-mktemp">mktemp</primary>
590 </indexterm>
591 </listitem>
592 </varlistentry>
593
[02095ae]594 <varlistentry id="mv">
595 <term><command>mv</command></term>
596 <listitem>
597 <para>Moves or renames files or directories</para>
598 <indexterm zone="ch-system-coreutils mv">
599 <primary sortas="b-mv">mv</primary>
600 </indexterm>
601 </listitem>
602 </varlistentry>
603
604 <varlistentry id="nice">
605 <term><command>nice</command></term>
606 <listitem>
607 <para>Runs a program with modified scheduling priority</para>
608 <indexterm zone="ch-system-coreutils nice">
609 <primary sortas="b-nice">nice</primary>
610 </indexterm>
611 </listitem>
612 </varlistentry>
613
614 <varlistentry id="nl">
615 <term><command>nl</command></term>
616 <listitem>
617 <para>Numbers the lines from the given files</para>
618 <indexterm zone="ch-system-coreutils nl">
619 <primary sortas="b-nl">nl</primary>
620 </indexterm>
621 </listitem>
622 </varlistentry>
623
624 <varlistentry id="nohup">
625 <term><command>nohup</command></term>
626 <listitem>
627 <para>Runs a command immune to hangups, with its output redirected to
628 a log file</para>
629 <indexterm zone="ch-system-coreutils nohup">
630 <primary sortas="b-nohup">nohup</primary>
631 </indexterm>
632 </listitem>
633 </varlistentry>
634
635 <varlistentry id="od">
636 <term><command>od</command></term>
637 <listitem>
638 <para>Dumps files in octal and other formats</para>
639 <indexterm zone="ch-system-coreutils od">
640 <primary sortas="b-od">od</primary>
641 </indexterm>
642 </listitem>
643 </varlistentry>
644
645 <varlistentry id="paste">
646 <term><command>paste</command></term>
647 <listitem>
648 <para>Merges the given files, joining sequentially corresponding lines
649 side by side, separated by tab characters</para>
650 <indexterm zone="ch-system-coreutils paste">
651 <primary sortas="b-paste">paste</primary>
652 </indexterm>
653 </listitem>
654 </varlistentry>
655
656 <varlistentry id="pathchk">
657 <term><command>pathchk</command></term>
658 <listitem>
659 <para>Checks if file names are valid or portable</para>
660 <indexterm zone="ch-system-coreutils pathchk">
661 <primary sortas="b-pathchk">pathchk</primary>
662 </indexterm>
663 </listitem>
664 </varlistentry>
665
666 <varlistentry id="pinky">
667 <term><command>pinky</command></term>
668 <listitem>
669 <para>Is a lightweight finger client; it reports some information
670 about the given users</para>
671 <indexterm zone="ch-system-coreutils pinky">
672 <primary sortas="b-pinky">pinky</primary>
673 </indexterm>
674 </listitem>
675 </varlistentry>
676
677 <varlistentry id="pr">
678 <term><command>pr</command></term>
679 <listitem>
680 <para>Paginates and columnates files for printing</para>
681 <indexterm zone="ch-system-coreutils pr">
682 <primary sortas="b-pr">pr</primary>
683 </indexterm>
684 </listitem>
685 </varlistentry>
686
687 <varlistentry id="printenv">
688 <term><command>printenv</command></term>
689 <listitem>
690 <para>Prints the environment</para>
691 <indexterm zone="ch-system-coreutils printenv">
692 <primary sortas="b-printenv">printenv</primary>
693 </indexterm>
694 </listitem>
695 </varlistentry>
696
697 <varlistentry id="printf">
698 <term><command>printf</command></term>
699 <listitem>
700 <para>Prints the given arguments according to the given format, much
701 like the C printf function</para>
702 <indexterm zone="ch-system-coreutils printf">
703 <primary sortas="b-printf">printf</primary>
704 </indexterm>
705 </listitem>
706 </varlistentry>
707
708 <varlistentry id="ptx">
709 <term><command>ptx</command></term>
710 <listitem>
711 <para>Produces a permuted index from the contents of the given files,
712 with each keyword in its context</para>
713 <indexterm zone="ch-system-coreutils ptx">
714 <primary sortas="b-ptx">ptx</primary>
715 </indexterm>
716 </listitem>
717 </varlistentry>
718
719 <varlistentry id="pwd">
720 <term><command>pwd</command></term>
721 <listitem>
722 <para>Reports the name of the current working directory</para>
723 <indexterm zone="ch-system-coreutils pwd">
724 <primary sortas="b-pwd">pwd</primary>
725 </indexterm>
726 </listitem>
727 </varlistentry>
728
729 <varlistentry id="readlink">
730 <term><command>readlink</command></term>
731 <listitem>
732 <para>Reports the value of the given symbolic link</para>
733 <indexterm zone="ch-system-coreutils readlink">
734 <primary sortas="b-readlink">readlink</primary>
735 </indexterm>
736 </listitem>
737 </varlistentry>
738
739 <varlistentry id="rm">
740 <term><command>rm</command></term>
741 <listitem>
742 <para>Removes files or directories</para>
743 <indexterm zone="ch-system-coreutils rm">
744 <primary sortas="b-rm">rm</primary>
745 </indexterm>
746 </listitem>
747 </varlistentry>
748
749 <varlistentry id="rmdir">
750 <term><command>rmdir</command></term>
751 <listitem>
752 <para>Removes directories if they are empty</para>
753 <indexterm zone="ch-system-coreutils rmdir">
754 <primary sortas="b-rmdir">rmdir</primary>
755 </indexterm>
756 </listitem>
757 </varlistentry>
758
[058bc6b]759 <varlistentry id="runcon">
760 <term><command>runcon</command></term>
761 <listitem>
762 <para>Runs a command with specified security context</para>
763 <indexterm zone="ch-system-coreutils runcon">
764 <primary sortas="b-runcon">runcon</primary>
765 </indexterm>
766 </listitem>
767 </varlistentry>
768
[02095ae]769 <varlistentry id="seq">
770 <term><command>seq</command></term>
771 <listitem>
772 <para>Prints a sequence of numbers within a given range and with a
773 given increment</para>
774 <indexterm zone="ch-system-coreutils seq">
775 <primary sortas="b-seq">seq</primary>
776 </indexterm>
777 </listitem>
778 </varlistentry>
779
780 <varlistentry id="sha1sum">
781 <term><command>sha1sum</command></term>
782 <listitem>
783 <para>Prints or checks 160-bit Secure Hash Algorithm 1 (SHA1)
784 checksums</para>
785 <indexterm zone="ch-system-coreutils sha1sum">
786 <primary sortas="b-sha1sum">sha1sum</primary>
787 </indexterm>
788 </listitem>
789 </varlistentry>
790
[d2c51b1]791 <varlistentry id="sha224sum">
792 <term><command>sha224sum</command></term>
793 <listitem>
794 <para>Prints or checks SHA224 checksums</para>
795 <indexterm zone="ch-system-coreutils sha224sum">
796 <primary sortas="b-sha224sum">sha224sum</primary>
797 </indexterm>
798 </listitem>
799 </varlistentry>
800
801 <varlistentry id="sha256sum">
802 <term><command>sha256sum</command></term>
803 <listitem>
804 <para>Prints or checks SHA256 checksums</para>
805 <indexterm zone="ch-system-coreutils sha256sum">
806 <primary sortas="b-sha256sum">sha256sum</primary>
807 </indexterm>
808 </listitem>
809 </varlistentry>
810
811 <varlistentry id="sha384sum">
812 <term><command>sha384sum</command></term>
813 <listitem>
814 <para>Prints or checks SHA384 checksums</para>
815 <indexterm zone="ch-system-coreutils sha384sum">
816 <primary sortas="b-sha384sum">sha384sum</primary>
817 </indexterm>
818 </listitem>
819 </varlistentry>
820
821 <varlistentry id="sha512sum">
822 <term><command>sha512sum</command></term>
823 <listitem>
824 <para>Prints or checks SHA512 checksums</para>
825 <indexterm zone="ch-system-coreutils sha512sum">
826 <primary sortas="b-sha512sum">sha512sum</primary>
827 </indexterm>
828 </listitem>
829 </varlistentry>
830
[02095ae]831 <varlistentry id="shred">
832 <term><command>shred</command></term>
833 <listitem>
834 <para>Overwrites the given files repeatedly with complex patterns,
835 making it difficult to recover the data</para>
836 <indexterm zone="ch-system-coreutils shred">
837 <primary sortas="b-shred">shred</primary>
838 </indexterm>
839 </listitem>
840 </varlistentry>
841
[d2c51b1]842 <varlistentry id="shuf">
843 <term><command>shuf</command></term>
844 <listitem>
845 <para>Write a random permutation of the input lines to standard output or a file</para>
846 <indexterm zone="ch-system-coreutils shuf">
847 <primary sortas="b-shuf">shuf</primary>
848 </indexterm>
849 </listitem>
850 </varlistentry>
851
[02095ae]852 <varlistentry id="sleep">
853 <term><command>sleep</command></term>
854 <listitem>
855 <para>Pauses for the given amount of time</para>
856 <indexterm zone="ch-system-coreutils sleep">
857 <primary sortas="b-sleep">sleep</primary>
858 </indexterm>
859 </listitem>
860 </varlistentry>
861
862 <varlistentry id="sort">
863 <term><command>sort</command></term>
864 <listitem>
865 <para>Sorts the lines from the given files</para>
866 <indexterm zone="ch-system-coreutils sort">
867 <primary sortas="b-sort">sort</primary>
868 </indexterm>
869 </listitem>
870 </varlistentry>
871
872 <varlistentry id="split">
873 <term><command>split</command></term>
874 <listitem>
875 <para>Splits the given file into pieces, by size or by number of
876 lines</para>
877 <indexterm zone="ch-system-coreutils split">
878 <primary sortas="b-split">split</primary>
879 </indexterm>
880 </listitem>
881 </varlistentry>
882
883 <varlistentry id="stat">
884 <term><command>stat</command></term>
885 <listitem>
886 <para>Displays file or filesystem status</para>
887 <indexterm zone="ch-system-coreutils stat">
888 <primary sortas="b-stat">stat</primary>
889 </indexterm>
890 </listitem>
891 </varlistentry>
892
893 <varlistentry id="stty">
894 <term><command>stty</command></term>
895 <listitem>
896 <para>Sets or reports terminal line settings</para>
897 <indexterm zone="ch-system-coreutils stty">
898 <primary sortas="b-stty">stty</primary>
899 </indexterm>
900 </listitem>
901 </varlistentry>
902
903 <varlistentry id="sum">
904 <term><command>sum</command></term>
905 <listitem>
906 <para>Prints checksum and block counts for each given file</para>
907 <indexterm zone="ch-system-coreutils sum">
908 <primary sortas="b-sum">sum</primary>
909 </indexterm>
910 </listitem>
911 </varlistentry>
912
913 <varlistentry id="sync">
914 <term><command>sync</command></term>
915 <listitem>
916 <para>Flushes file system buffers; it forces changed blocks to disk
917 and updates the super block</para>
918 <indexterm zone="ch-system-coreutils sync">
919 <primary sortas="b-sync">sync</primary>
920 </indexterm>
921 </listitem>
922 </varlistentry>
923
924 <varlistentry id="tac">
925 <term><command>tac</command></term>
926 <listitem>
927 <para>Concatenates the given files in reverse</para>
928 <indexterm zone="ch-system-coreutils tac">
929 <primary sortas="b-tac">tac</primary>
930 </indexterm>
931 </listitem>
932 </varlistentry>
933
934 <varlistentry id="tail">
935 <term><command>tail</command></term>
936 <listitem>
937 <para>Prints the last ten lines (or the given number of lines) of each
938 given file</para>
939 <indexterm zone="ch-system-coreutils tail">
940 <primary sortas="b-tail">tail</primary>
941 </indexterm>
942 </listitem>
943 </varlistentry>
944
945 <varlistentry id="tee">
946 <term><command>tee</command></term>
947 <listitem>
948 <para>Reads from standard input while writing both to standard output
949 and to the given files</para>
950 <indexterm zone="ch-system-coreutils tee">
951 <primary sortas="b-tee">tee</primary>
952 </indexterm>
953 </listitem>
954 </varlistentry>
955
956 <varlistentry id="test">
[b16b4dc]957 <term><command>test</command> or <command>[</command></term>
[02095ae]958 <listitem>
959 <para>Compares values and checks file types</para>
960 <indexterm zone="ch-system-coreutils test">
961 <primary sortas="b-test">test</primary>
962 </indexterm>
963 </listitem>
964 </varlistentry>
965
[058bc6b]966 <varlistentry id="timeout">
967 <term><command>timeout</command></term>
968 <listitem>
969 <para>Runs a command with a time limit</para>
970 <indexterm zone="ch-system-coreutils timeout">
971 <primary sortas="b-timeout">timeout</primary>
972 </indexterm>
973 </listitem>
974 </varlistentry>
975
[02095ae]976 <varlistentry id="touch">
977 <term><command>touch</command></term>
978 <listitem>
979 <para>Changes file timestamps, setting the access and modification
980 times of the given files to the current time; files that do not exist
981 are created with zero length</para>
982 <indexterm zone="ch-system-coreutils touch">
983 <primary sortas="b-touch">touch</primary>
984 </indexterm>
985 </listitem>
986 </varlistentry>
987
988 <varlistentry id="tr">
989 <term><command>tr</command></term>
990 <listitem>
991 <para>Translates, squeezes, and deletes the given characters from
992 standard input</para>
993 <indexterm zone="ch-system-coreutils tr">
994 <primary sortas="b-tr">tr</primary>
995 </indexterm>
996 </listitem>
997 </varlistentry>
998
999 <varlistentry id="true">
1000 <term><command>true</command></term>
1001 <listitem>
1002 <para>Does nothing, successfully; it always exits with a status code
1003 indicating success</para>
1004 <indexterm zone="ch-system-coreutils true">
1005 <primary sortas="b-true">true</primary>
1006 </indexterm>
1007 </listitem>
1008 </varlistentry>
1009
[058bc6b]1010 <varlistentry id="truncate">
1011 <term><command>truncate</command></term>
1012 <listitem>
1013 <para>Shrinks or expands a file to the specified size</para>
1014 <indexterm zone="ch-system-coreutils truncate">
1015 <primary sortas="b-truncate">truncate</primary>
1016 </indexterm>
1017 </listitem>
1018 </varlistentry>
1019
[02095ae]1020 <varlistentry id="tsort">
1021 <term><command>tsort</command></term>
1022 <listitem>
1023 <para>Performs a topological sort; it writes a completely ordered list
1024 according to the partial ordering in a given file</para>
1025 <indexterm zone="ch-system-coreutils tsort">
1026 <primary sortas="b-tsort">tsort</primary>
1027 </indexterm>
1028 </listitem>
1029 </varlistentry>
1030
1031 <varlistentry id="tty">
1032 <term><command>tty</command></term>
1033 <listitem>
1034 <para>Reports the file name of the terminal connected to standard
1035 input</para>
1036 <indexterm zone="ch-system-coreutils tty">
1037 <primary sortas="b-tty">tty</primary>
1038 </indexterm>
1039 </listitem>
1040 </varlistentry>
1041
1042 <varlistentry id="uname">
1043 <term><command>uname</command></term>
1044 <listitem>
1045 <para>Reports system information</para>
1046 <indexterm zone="ch-system-coreutils uname">
1047 <primary sortas="b-uname">uname</primary>
1048 </indexterm>
1049 </listitem>
1050 </varlistentry>
1051
1052 <varlistentry id="unexpand">
1053 <term><command>unexpand</command></term>
1054 <listitem>
1055 <para>Converts spaces to tabs</para>
1056 <indexterm zone="ch-system-coreutils unexpand">
1057 <primary sortas="b-unexpand">unexpand</primary>
1058 </indexterm>
1059 </listitem>
1060 </varlistentry>
1061
1062 <varlistentry id="uniq">
1063 <term><command>uniq</command></term>
1064 <listitem>
1065 <para>Discards all but one of successive identical lines</para>
1066 <indexterm zone="ch-system-coreutils uniq">
1067 <primary sortas="b-uniq">uniq</primary>
1068 </indexterm>
1069 </listitem>
1070 </varlistentry>
1071
1072 <varlistentry id="unlink">
1073 <term><command>unlink</command></term>
1074 <listitem>
1075 <para>Removes the given file</para>
1076 <indexterm zone="ch-system-coreutils unlink">
1077 <primary sortas="b-unlink">unlink</primary>
1078 </indexterm>
1079 </listitem>
1080 </varlistentry>
1081
1082 <varlistentry id="users">
1083 <term><command>users</command></term>
1084 <listitem>
1085 <para>Reports the names of the users currently logged on</para>
1086 <indexterm zone="ch-system-coreutils users">
1087 <primary sortas="b-users">users</primary>
1088 </indexterm>
1089 </listitem>
1090 </varlistentry>
1091
1092 <varlistentry id="vdir">
1093 <term><command>vdir</command></term>
1094 <listitem>
1095 <para>Is the same as <command>ls -l</command></para>
1096 <indexterm zone="ch-system-coreutils vdir">
1097 <primary sortas="b-vdir">vdir</primary>
1098 </indexterm>
1099 </listitem>
1100 </varlistentry>
1101
1102 <varlistentry id="wc">
1103 <term><command>wc</command></term>
1104 <listitem>
1105 <para>Reports the number of lines, words, and bytes for each given
1106 file, as well as a total line when more than one file is given</para>
1107 <indexterm zone="ch-system-coreutils wc">
1108 <primary sortas="b-wc">wc</primary>
1109 </indexterm>
1110 </listitem>
1111 </varlistentry>
1112
1113 <varlistentry id="who">
1114 <term><command>who</command></term>
1115 <listitem>
1116 <para>Reports who is logged on</para>
1117 <indexterm zone="ch-system-coreutils who">
1118 <primary sortas="b-who">who</primary>
1119 </indexterm>
1120 </listitem>
1121 </varlistentry>
1122
1123 <varlistentry id="whoami">
1124 <term><command>whoami</command></term>
1125 <listitem>
1126 <para>Reports the user name associated with the current effective
1127 user ID</para>
1128 <indexterm zone="ch-system-coreutils whoami">
1129 <primary sortas="b-whoami">whoami</primary>
1130 </indexterm>
1131 </listitem>
1132 </varlistentry>
1133
1134 <varlistentry id="yes">
1135 <term><command>yes</command></term>
1136 <listitem>
1137 <para>Repeatedly outputs <quote>y</quote> or a given string until
1138 killed</para>
1139 <indexterm zone="ch-system-coreutils yes">
1140 <primary sortas="b-yes">yes</primary>
1141 </indexterm>
1142 </listitem>
1143 </varlistentry>
1144
1145 </variablelist>
1146
1147 </sect2>
1148
1149</sect1>
Note: See TracBrowser for help on using the repository browser.