source: chapter06/coreutils.xml@ 1dc34de7

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<sect1 id="ch-system-coreutils" xreflabel="Coreutils" role="wrap">
<title>Coreutils-&coreutils-version;</title>
<?dbhtml filename="coreutils.html"?>

<indexterm zone="ch-system-coreutils"><primary sortas="a-Coreutils">Coreutils</primary></indexterm>

<sect2 role="package"><title/>
<para>The Coreutils package contains utilities for showing and setting the
basic system characteristics.</para>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.9 SBU</seg><seg>69 MB</seg></seglistitem>
</segmentedlist>

<segmentedlist>
<segtitle>Coreutils installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, GCC,
Gettext, Glibc, Grep, Make, Perl, Sed</seg></seglistitem>
</segmentedlist>
</sect2>

<sect2 role="installation">
<title>Installation of Coreutils</title>

<para>A known issue with the <command>uname</command> program from
this package is that the <parameter>-p</parameter> switch always
returns <computeroutput>unknown</computeroutput>. The following patch
fixes this behavior for Intel architectures:</para>

<screen><userinput>patch -Np1 -i ../coreutils-&coreutils-version;-uname-2.patch</userinput></screen>

<para>Prevent Coreutils from installing binaries that will be later be
installed by other packages:</para>

<screen><userinput>patch -Np1 -i ../coreutils-&coreutils-version;-suppress_uptime_kill_su-1.patch</userinput></screen>

<para>Now prepare Coreutils for compilation:</para>

<screen><userinput>DEFAULT_POSIX2_VERSION=199209 ./configure --prefix=/usr</userinput></screen>

<para>Compile the package:</para>

<screen><userinput>make</userinput></screen>

<para>The test suite of Coreutils makes several assumptions about the
presence of files and users that are not valid this early in the LFS
build. Therefore, additional items need to be set up before running
the tests. Skip down to <quote>Install the package</quote> if you are
not running the test suite.</para>

<para>Create two dummy groups and a dummy user name:</para>

<screen><userinput>echo "dummy1:x:1000" &gt;&gt; /etc/group
echo "dummy2:x:1001:dummy" &gt;&gt; /etc/group
echo "dummy:x:1000:1000:::/bin/bash" &gt;&gt; /etc/passwd</userinput></screen>

<para>Now the test suite is ready to be run. First, run the tests that
are meant to be run as user <emphasis>root</emphasis>:</para>

<screen><userinput>make NON_ROOT_USERNAME=dummy check-root</userinput></screen>

<para>Then run the remainder of the tests as the
<emphasis>dummy</emphasis> user:</para>

<screen><userinput>src/su dummy -c "make RUN_EXPENSIVE_TESTS=yes check"</userinput></screen>

<para>When testing is complete, remove the dummy user and
groups:</para>

<screen><userinput>sed -i '/dummy/d' /etc/passwd /etc/group</userinput></screen>

<para>Install the package:</para>

<screen><userinput>make install</userinput></screen>

<para>Move programs to the proper locations:</para>

<screen><userinput>mv /usr/bin/{[,basename,cat,chgrp,chmod,chown,cp,dd,df} /bin
mv /usr/bin/{date,echo,false,head,hostname,install,ln} /bin
mv /usr/bin/{ls,mkdir,mknod,mv,pwd,rm,rmdir,sync} /bin
mv /usr/bin/{sleep,stty,test,touch,true,uname} /bin
mv /usr/bin/chroot /usr/sbin</userinput></screen>

<para>Finally, create a symlink to be FHS-compliant:</para>

<screen><userinput>ln -s ../../bin/install /usr/bin</userinput></screen>

</sect2>


<sect2 id="contents-coreutils" role="content"><title>Contents of Coreutils</title>

<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>basename, cat, chgrp, chmod,
chown, chroot, cksum, comm, cp, csplit, cut, date, dd, df, dir, dircolors,
dirname, du, echo, env, expand, expr, factor, false, fmt, fold, groups, head,
hostid, hostname, id, install, join, link, ln, logname, ls, md5sum,
mkdir, mkfifo, mknod, mv, nice, nl, nohup, od, paste, pathchk, pinky, pr,
printenv, printf, ptx, pwd, readlink, rm, rmdir, seq, sha1sum, shred, sleep,
sort, split, stat, stty, su, sum, sync, tac, tail, tee, test, touch, tr, true,
tsort, tty, uname, unexpand, uniq, unlink, uptime, users, vdir, wc, who,
whoami and yes</seg></seglistitem>
</segmentedlist>

<variablelist><title>Short descriptions</title>

<varlistentry id="basename">
<term><command>basename</command></term>
<listitem>
<indexterm zone="ch-system-coreutils basename"><primary sortas="b-basename">basename</primary></indexterm>
<para>strips any path and a given suffix from a given file name.</para>
</listitem>
</varlistentry>

<varlistentry id="cat">
<term><command>cat</command></term>
<listitem>
<indexterm zone="ch-system-coreutils cat"><primary sortas="b-cat">cat</primary></indexterm>
<para>concatenates files to standard output.</para>
</listitem>
</varlistentry>

<varlistentry id="chgrp">
<term><command>chgrp</command></term>
<listitem>
<indexterm zone="ch-system-coreutils chgrp"><primary sortas="b-chgrp">chgrp</primary></indexterm>
<para>changes the group ownership of each given file to the given
group. The group can either be either given a name or a numeric
ID.</para>
</listitem>
</varlistentry>

<varlistentry id="chmod">
<term><command>chmod</command></term>
<listitem>
<indexterm zone="ch-system-coreutils chmod"><primary sortas="b-chmod">chmod</primary></indexterm>
<para>changes the permissions of each file to the given mode. The mode
can be either a symbolic representation of the changes to make or an
octal number representing the new permissions.</para>
</listitem>
</varlistentry>

<varlistentry id="chown">
<term><command>chown</command></term>
<listitem>
<indexterm zone="ch-system-coreutils chown"><primary sortas="b-chown">chown</primary></indexterm>
<para>changes the user and/or group ownership of
each given file to the given user/group pair.</para>
</listitem>
</varlistentry>

<varlistentry id="chroot">
<term><command>chroot</command></term>
<listitem>
<indexterm zone="ch-system-coreutils chroot"><primary sortas="b-chroot">chroot</primary></indexterm>
<para>runs a given command with the specified directory as the 
<filename class="directory">/</filename> directory. The given command can be an interactive shell.
On most systems only <emphasis>root</emphasis> can do this.</para>
</listitem>
</varlistentry>

<varlistentry id="cksum">
<term><command>cksum</command></term>
<listitem>
<indexterm zone="ch-system-coreutils cksum"><primary sortas="b-cksum">cksum</primary></indexterm>
<para>prints the Cyclic Redundancy Check (CRC) checksum and the byte
counts of each specified file.</para>
</listitem>
</varlistentry>

<varlistentry id="comm">
<term><command>comm</command></term>
<listitem>
<indexterm zone="ch-system-coreutils comm"><primary sortas="b-comm">comm</primary></indexterm>
<para>compares two sorted files, outputting in three columns the lines
that are unique and the lines that are common.</para>
</listitem>
</varlistentry>

<varlistentry id="cp">
<term><command>cp</command></term>
<listitem>
<indexterm zone="ch-system-coreutils cp"><primary sortas="b-cp">cp</primary></indexterm>
<para>copies files.</para>
</listitem>
</varlistentry>

<varlistentry id="csplit">
<term><command>csplit</command></term>
<listitem>
<indexterm zone="ch-system-coreutils csplit"><primary sortas="b-csplit">csplit</primary></indexterm>
<para>splits a given file into several new files, separating them
according to given patterns or line numbers and outputting the byte
count of each new file.</para>
</listitem>
</varlistentry>

<varlistentry id="cut">
<term><command>cut</command></term>
<listitem>
<indexterm zone="ch-system-coreutils cut"><primary sortas="b-cut">cut</primary></indexterm>
<para>prints sections of lines, selecting the parts according to given
fields or positions.</para>
</listitem>
</varlistentry>

<varlistentry id="date">
<term><command>date</command></term>
<listitem>
<indexterm zone="ch-system-coreutils date"><primary sortas="b-date">date</primary></indexterm>
<para>displays the current time in the given format, or sets the
system date.</para>
</listitem>
</varlistentry>

<varlistentry id="dd">
<term><command>dd</command> </term>
<listitem>
<indexterm zone="ch-system-coreutils dd"><primary sortas="b-dd">dd</primary></indexterm>
<para>copies a file using the given block size and count, while
optionally performing conversions on it.</para>
</listitem>
</varlistentry>

<varlistentry id="df">
<term><command>df</command></term>
<listitem>
<indexterm zone="ch-system-coreutils df"><primary sortas="b-df">df</primary></indexterm>
<para>reports the amount of disk space available (and used) on all
mounted file systems, or only on the file systems holding the selected
files.</para>
</listitem>
</varlistentry>

<varlistentry id="dir">
<term><command>dir</command></term>
<listitem>
<indexterm zone="ch-system-coreutils dir"><primary sortas="b-dir">dir</primary></indexterm>
<para>lists the contents of each given directory. (the same as
the <command>ls</command> command).</para>
</listitem>
</varlistentry>

<varlistentry id="dircolors">
<term><command>dircolors</command></term>
<listitem>
<indexterm zone="ch-system-coreutils dircolors"><primary sortas="b-dircolors">dircolors</primary></indexterm>
<para>outputs commands to set the <emphasis>LS_COLOR</emphasis>
environment variable to change the color scheme used by
<command>ls</command>.</para>
</listitem>
</varlistentry>

<varlistentry id="dirname">
<term><command>dirname</command></term>
<listitem>
<indexterm zone="ch-system-coreutils dirname"><primary sortas="b-dirname">dirname</primary></indexterm>
<para>strips the non-directory suffix from a file name.</para>
</listitem>
</varlistentry>

<varlistentry id="du">
<term><command>du</command></term>
<listitem>
<indexterm zone="ch-system-coreutils du"><primary sortas="b-du">du</primary></indexterm>
<para>reports the amount of disk space used by the current directory,
by each of the given directories (including all subdirectories), or by
each of the given files.</para>
</listitem>
</varlistentry>

<varlistentry id="echo">
<term><command>echo</command></term>
<listitem>
<indexterm zone="ch-system-coreutils echo"><primary sortas="b-echo">echo</primary></indexterm>
<para>displays the given strings.</para>
</listitem>
</varlistentry>

<varlistentry id="env">
<term><command>env</command></term>
<listitem>
<indexterm zone="ch-system-coreutils env"><primary sortas="b-env">env</primary></indexterm>
<para>runs a command in a modified environment.</para>
</listitem>
</varlistentry>

<varlistentry id="expand">
<term><command>expand</command></term>
<listitem>
<indexterm zone="ch-system-coreutils expand"><primary sortas="b-expand">expand</primary></indexterm>
<para>converts tabs to spaces.</para>
</listitem>
</varlistentry>

<varlistentry id="expr">
<term><command>expr</command></term>
<listitem>
<indexterm zone="ch-system-coreutils expr"><primary sortas="b-expr">expr</primary></indexterm>
<para>evaluates expressions.</para>
</listitem>
</varlistentry>

<varlistentry id="factor">
<term><command>factor</command></term>
<listitem>
<indexterm zone="ch-system-coreutils factor"><primary sortas="b-factor">factor</primary></indexterm>
<para>prints the prime factors of all specified integer numbers.</para>
</listitem>
</varlistentry>

<varlistentry id="false">
<term><command>false</command></term>
<listitem>
<indexterm zone="ch-system-coreutils false"><primary sortas="b-false">false</primary></indexterm>
<para>does nothing, unsuccessfully. It always exits with a status code
indicating failure.</para>
</listitem>
</varlistentry>

<varlistentry id="mt">
<term><command>fmt</command></term>
<listitem>
<indexterm zone="ch-system-coreutils mt"><primary sortas="b-mt">mt</primary></indexterm>
<para>reformats the paragraphs in the given files.</para>
</listitem>
</varlistentry>

<varlistentry id="fold">
<term><command>fold</command></term>
<listitem>
<indexterm zone="ch-system-coreutils fold"><primary sortas="b-fold">fold</primary></indexterm>
<para>wraps the lines in the given files.</para>
</listitem>
</varlistentry>

<varlistentry id="groups-coreutils">
<term><command>groups</command></term>
<listitem>
<indexterm zone="ch-system-coreutils groups-coreutils"><primary sortas="b-groups-coreutils">groups</primary></indexterm>
<para>reports a user's group memberships.</para>
</listitem>
</varlistentry>

<varlistentry id="head">
<term><command>head</command></term>
<listitem>
<indexterm zone="ch-system-coreutils head"><primary sortas="b-head">head</primary></indexterm>
<para>prints the first ten lines (or the given number of lines) of each given file.</para>
</listitem>
</varlistentry>

<varlistentry id="hostid">
<term><command>hostid</command></term>
<listitem>
<indexterm zone="ch-system-coreutils hostid"><primary sortas="b-hostid">hostid</primary></indexterm>
<para>reports the numeric identifier (in hexadecimal) of the host.</para>
</listitem>
</varlistentry>

<varlistentry id="hostname">
<term><command>hostname</command></term>
<listitem>
<indexterm zone="ch-system-coreutils hostname"><primary sortas="b-hostname">hostname</primary></indexterm>
<para>reports or sets the name of the host.</para>
</listitem>
</varlistentry>

<varlistentry id="id">
<term><command>id</command></term>
<listitem>
<indexterm zone="ch-system-coreutils id"><primary sortas="b-id">id</primary></indexterm>
<para>reports the effective user ID, group ID, and
group memberships of the current user or specified user.</para>
</listitem>
</varlistentry>

<varlistentry id="install">
<term><command>install</command> </term>
<listitem>
<indexterm zone="ch-system-coreutils install"><primary sortas="b-install">install</primary></indexterm>
<para>copies files while setting their
permission modes and, if possible, their owner and group.</para>
</listitem>
</varlistentry>

<varlistentry id="join">
<term><command>join</command></term>
<listitem>
<indexterm zone="ch-system-coreutils join"><primary sortas="b-join">join</primary></indexterm>
<para>joins the lines that have identical join fields from two
separate files.</para>
</listitem>
</varlistentry>

<varlistentry id="link">
<term><command>link</command></term>
<listitem>
<indexterm zone="ch-system-coreutils link"><primary sortas="b-link">link</primary></indexterm>
<para>creates a hard link with the given name to a file.</para>
</listitem>
</varlistentry>

<varlistentry id="ln">
<term><command>ln</command></term>
<listitem>
<indexterm zone="ch-system-coreutils ln"><primary sortas="b-ln">ln</primary></indexterm>
<para>makes hard links or soft (symbolic) links between files.</para>
</listitem>
</varlistentry>

<varlistentry id="logname">
<term><command>logname</command></term>
<listitem>
<indexterm zone="ch-system-coreutils logname"><primary sortas="b-logname">logname</primary></indexterm>
<para>reports the current user's login name.</para>
</listitem>
</varlistentry>

<varlistentry id="ls">
<term><command>ls</command></term>
<listitem>
<indexterm zone="ch-system-coreutils ls"><primary sortas="b-ls">ls</primary></indexterm>
<para>lists the contents of each given directory.</para>
</listitem>
</varlistentry>

<varlistentry id="md5sum">
<term><command>md5sum</command></term>
<listitem>
<indexterm zone="ch-system-coreutils md5sum"><primary sortas="b-md5sum">md5sum</primary></indexterm>
<para>reports or checks Message Digest 5 (MD5) checksums.</para>
</listitem>
</varlistentry>

<varlistentry id="mkdir">
<term><command>mkdir</command></term>
<listitem>
<indexterm zone="ch-system-coreutils mkdir"><primary sortas="b-mkdir">mkdir</primary></indexterm>
<para>creates directories with the given names.</para>
</listitem>
</varlistentry>

<varlistentry id="mkfifo">
<term><command>mkfifo</command></term>
<listitem>
<indexterm zone="ch-system-coreutils mkfifo"><primary sortas="b-mkfifo">mkfifo</primary></indexterm>
<para>creates First-In, First-Outs (FIFOs), a <quote>named
pipe</quote> in UNIX parlance, with the given names.</para>
</listitem>
</varlistentry>

<varlistentry id="mknod">
<term><command>mknod</command></term>
<listitem>
<indexterm zone="ch-system-coreutils mknod"><primary sortas="b-mknod">mknod</primary></indexterm>
<para>creates device nodes with the given names. A device node is a
character special file, a block special file, or a FIFO.</para>
</listitem>
</varlistentry>

<varlistentry id="mv">
<term><command>mv</command></term>
<listitem>
<indexterm zone="ch-system-coreutils mv"><primary sortas="b-mv">mv</primary></indexterm>
<para>moves or renames files or directories.</para>
</listitem>
</varlistentry>

<varlistentry id="nice">
<term><command>nice</command></term>
<listitem>
<indexterm zone="ch-system-coreutils nice"><primary sortas="b-nice">nice</primary></indexterm>
<para>runs a program with modified scheduling priority.</para>
</listitem>
</varlistentry>

<varlistentry id="nl">
<term><command>nl</command></term>
<listitem>
<indexterm zone="ch-system-coreutils nl"><primary sortas="b-nl">nl</primary></indexterm>
<para>numbers the lines from the given files.</para>
</listitem>
</varlistentry>

<varlistentry id="nohup">
<term><command>nohup</command></term>
<listitem>
<indexterm zone="ch-system-coreutils nohup"><primary sortas="b-nohup">nohup</primary></indexterm>
<para>runs a command immune to hangups, with its output redirected to
a log file.</para>
</listitem>
</varlistentry>

<varlistentry id="od">
<term><command>od</command></term>
<listitem>
<indexterm zone="ch-system-coreutils od"><primary sortas="b-od">od</primary></indexterm>
<para>dumps files in octal and other formats.</para>
</listitem>
</varlistentry>

<varlistentry id="paste">
<term><command>paste</command></term>
<listitem>
<indexterm zone="ch-system-coreutils paste"><primary sortas="b-paste">paste</primary></indexterm>
<para>merges the given files, joining sequentially corresponding lines
side by side, separated by tab characters.</para>
</listitem>
</varlistentry>

<varlistentry id="pathchk">
<term><command>pathchk</command></term>
<listitem>
<indexterm zone="ch-system-coreutils pathchk"><primary sortas="b-pathchk">pathchk</primary></indexterm>
<para>checks if file names are valid or portable.</para>
</listitem>
</varlistentry>

<varlistentry id="pinky">
<term><command>pinky</command></term>
<listitem>
<indexterm zone="ch-system-coreutils pinky"><primary sortas="b-pinky">pinky</primary></indexterm>
<para>is a lightweight finger client. It reports some information about the given users.</para>
</listitem>
</varlistentry>

<varlistentry id="pr">
<term><command>pr</command></term>
<listitem>
<indexterm zone="ch-system-coreutils pr"><primary sortas="b-pr">pr</primary></indexterm>
<para>paginates and columnates files for printing.</para>
</listitem>
</varlistentry>

<varlistentry id="printenv">
<term><command>printenv</command></term>
<listitem>
<indexterm zone="ch-system-coreutils printenv"><primary sortas="b-printenv">printenv</primary></indexterm>
<para>prints the environment.</para>
</listitem>
</varlistentry>

<varlistentry id="printf">
<term><command>printf</command></term>
<listitem>
<indexterm zone="ch-system-coreutils printf"><primary sortas="b-printf">printf</primary></indexterm>
<para>prints the given arguments according to the given format, much
like the C printf function.</para>
</listitem>
</varlistentry>

<varlistentry id="ptx">
<term><command>ptx</command></term>
<listitem>
<indexterm zone="ch-system-coreutils ptx"><primary sortas="b-ptx">ptx</primary></indexterm>
<para>produces a permuted index from the contents of the given files,
with each keyword in its context.</para>
</listitem>
</varlistentry>

<varlistentry id="pwd">
<term><command>pwd</command></term>
<listitem>
<indexterm zone="ch-system-coreutils pwd"><primary sortas="b-pwd">pwd</primary></indexterm>
<para>reports the name of the current working directory.</para>
</listitem>
</varlistentry>

<varlistentry id="readlink">
<term><command>readlink</command></term>
<listitem>
<indexterm zone="ch-system-coreutils readlink"><primary sortas="b-readlink">readlink</primary></indexterm>
<para>reports the value of the given symbolic link.</para>
</listitem>
</varlistentry>

<varlistentry id="rm">
<term><command>rm</command></term>
<listitem>
<indexterm zone="ch-system-coreutils rm"><primary sortas="b-rm">rm</primary></indexterm>
<para>removes files or directories.</para>
</listitem>
</varlistentry>

<varlistentry id="rmdir">
<term><command>rmdir</command></term>
<listitem>
<indexterm zone="ch-system-coreutils rmdir"><primary sortas="b-rmdir">rmdir</primary></indexterm>
<para>removes directories if they are empty.</para>
</listitem>
</varlistentry>

<varlistentry id="seq">
<term><command>seq</command></term>
<listitem>
<indexterm zone="ch-system-coreutils seq"><primary sortas="b-seq">seq</primary></indexterm>
<para>prints a sequence of numbers within a given range and with a
given increment.</para>
</listitem>
</varlistentry>

<varlistentry id="sha1sum">
<term><command>sha1sum</command></term>
<listitem>
<indexterm zone="ch-system-coreutils sha1sum"><primary sortas="b-sha1sum">sha1sum</primary></indexterm>
<para>prints or checks 160-bit Secure Hash Algorithm 1 (SHA1) checksums.</para>
</listitem>
</varlistentry>

<varlistentry id="shred">
<term><command>shred</command></term>
<listitem>
<indexterm zone="ch-system-coreutils shred"><primary sortas="b-shred">shred</primary></indexterm>
<para>overwrites the given files repeatedly with complex patterns,
making it difficult to recover the data.</para>
</listitem>
</varlistentry>

<varlistentry id="sleep">
<term><command>sleep</command></term>
<listitem>
<indexterm zone="ch-system-coreutils sleep"><primary sortas="b-sleep">sleep</primary></indexterm>
<para>pauses for the given amount of time.</para>
</listitem>
</varlistentry>

<varlistentry id="sort">
<term><command>sort</command></term>
<listitem>
<indexterm zone="ch-system-coreutils sort"><primary sortas="b-sort">sort</primary></indexterm>
<para>sorts the lines from the given files.</para>
</listitem>
</varlistentry>

<varlistentry id="split">
<term><command>split</command></term>
<listitem>
<indexterm zone="ch-system-coreutils split"><primary sortas="b-split">split</primary></indexterm>
<para>splits the given file into pieces, by size or by number of lines.</para>
</listitem>
</varlistentry>

<varlistentry id="stty">
<term><command>stty</command></term>
<listitem>
<indexterm zone="ch-system-coreutils stty"><primary sortas="b-stty">stty</primary></indexterm>
<para>sets or reports terminal line settings.</para>
</listitem>
</varlistentry>

<varlistentry id="su">
<term><command>su</command></term>
<listitem>
<indexterm zone="ch-system-coreutils su"><primary sortas="b-su">su</primary></indexterm>
<para>runs a shell with substitute user and group IDs.</para>
</listitem>
</varlistentry>

<varlistentry id="sum">
<term><command>sum</command></term>
<listitem>
<indexterm zone="ch-system-coreutils sum"><primary sortas="b-sum">sum</primary></indexterm>
<para>prints checksum and block counts for each given file.</para>
</listitem>
</varlistentry>

<varlistentry id="sync">
<term><command>sync</command></term>
<listitem>
<indexterm zone="ch-system-coreutils sync"><primary sortas="b-sync">sync</primary></indexterm>
<para>flushes file system buffers. It forces changed blocks to disk
and updates the super block.</para>
</listitem>
</varlistentry>

<varlistentry id="tac">
<term><command>tac</command></term>
<listitem>
<indexterm zone="ch-system-coreutils tac"><primary sortas="b-tac">tac</primary></indexterm>
<para>concatenates the given files in reverse.</para>
</listitem>
</varlistentry>

<varlistentry id="tail">
<term><command>tail</command></term>
<listitem>
<indexterm zone="ch-system-coreutils tail"><primary sortas="b-tail">tail</primary></indexterm>
<para>prints the last ten lines (or the given number of lines) of each
given file.</para>
</listitem>
</varlistentry>

<varlistentry id="tee">
<term><command>tee</command></term>
<listitem>
<indexterm zone="ch-system-coreutils tee"><primary sortas="b-tee">tee</primary></indexterm>
<para>reads from standard input while writing both to standard output
and to the given files.</para>
</listitem>
</varlistentry>

<varlistentry id="test">
<term><command>test</command></term>
<listitem>
<indexterm zone="ch-system-coreutils test"><primary sortas="b-test">test</primary></indexterm>
<para>compares values and checks file types.</para>
</listitem>
</varlistentry>

<varlistentry id="touch">
<term><command>touch</command></term>
<listitem>
<indexterm zone="ch-system-coreutils touch"><primary sortas="b-touch">touch</primary></indexterm>
<para>changes file timestamps, setting the access and modification
times of the given files to the current time. Files that do not exist
are created with zero length.</para>
</listitem>
</varlistentry>

<varlistentry id="tr">
<term><command>tr</command></term>
<listitem>
<indexterm zone="ch-system-coreutils tr"><primary sortas="b-tr">tr</primary></indexterm>
<para>translates, squeezes, and deletes the given characters from
standard input.</para>
</listitem>
</varlistentry>

<varlistentry id="true">
<term><command>true</command></term>
<listitem>
<indexterm zone="ch-system-coreutils true"><primary sortas="b-true">true</primary></indexterm>
<para>does nothing, successfully. It always exits with a status code
indicating success.</para>
</listitem>
</varlistentry>

<varlistentry id="tsort">
<term><command>tsort</command></term>
<listitem>
<indexterm zone="ch-system-coreutils tsort"><primary sortas="b-tsort">tsort</primary></indexterm>
<para>performs a topological sort. It writes a totally ordered list
according to the partial ordering in a given file.</para>
</listitem>
</varlistentry>

<varlistentry id="tty">
<term><command>tty</command></term>
<listitem>
<indexterm zone="ch-system-coreutils tty"><primary sortas="b-tty">tty</primary></indexterm>
<para>reports the file name of the terminal connected to standard
input.</para>
</listitem>
</varlistentry>

<varlistentry id="uname">
<term><command>uname</command></term>
<listitem>
<indexterm zone="ch-system-coreutils uname"><primary sortas="b-uname">uname</primary></indexterm>
<para>reports system information.</para>
</listitem>
</varlistentry>

<varlistentry id="unexpand">
<term><command>unexpand</command></term>
<listitem>
<indexterm zone="ch-system-coreutils unexpand"><primary sortas="b-unexpand">unexpand</primary></indexterm>
<para>converts spaces to tabs.</para>
</listitem>
</varlistentry>

<varlistentry id="uniq">
<term><command>uniq</command></term>
<listitem>
<indexterm zone="ch-system-coreutils uniq"><primary sortas="b-uniq">uniq</primary></indexterm>
<para>discards all but one of successive identical lines.</para>
</listitem>
</varlistentry>

<varlistentry id="unlink">
<term><command>unlink</command></term>
<listitem>
<indexterm zone="ch-system-coreutils unlink"><primary sortas="b-unlink">unlink</primary></indexterm>
<para>removes the given file.</para>
</listitem>
</varlistentry>

<varlistentry id="uptime-coreutils">
<term><command>uptime</command></term>
<listitem>
<indexterm zone="ch-system-coreutils uptime-coreutils"><primary sortas="b-uptime-coreutils">uptime</primary></indexterm>
<para>reports how long the system has been running, how many users are
logged on, and the system load averages.</para>
</listitem>
</varlistentry>

<varlistentry id="users">
<term><command>users</command></term>
<listitem>
<indexterm zone="ch-system-coreutils users"><primary sortas="b-users">users</primary></indexterm>
<para>reports the names of the users currently logged on.</para>
</listitem>
</varlistentry>

<varlistentry id="vdir">
<term><command>vdir</command></term>
<listitem>
<indexterm zone="ch-system-coreutils vdir"><primary sortas="b-vdir">vdir</primary></indexterm>
<para>is the same as <command>ls -l</command>.</para>
</listitem>
</varlistentry>

<varlistentry id="wc">
<term><command>wc</command></term>
<listitem>
<indexterm zone="ch-system-coreutils wc"><primary sortas="b-wc">wc</primary></indexterm>
<para>reports the number of lines, words, and bytes for each given
file, as well as a total line when more than one file is given.</para>
</listitem>
</varlistentry>

<varlistentry id="who">
<term><command>who</command></term>
<listitem>
<indexterm zone="ch-system-coreutils who"><primary sortas="b-who">who</primary></indexterm>
<para>reports who is logged on.</para>
</listitem>
</varlistentry>

<varlistentry id="whoami">
<term><command>whoami</command></term>
<listitem>
<indexterm zone="ch-system-coreutils whoami"><primary sortas="b-whoami">whoami</primary></indexterm>
<para>reports the user name associated with the current effective user ID.</para>
</listitem>
</varlistentry>

<varlistentry id="yes">
<term><command>yes</command></term>
<listitem>
<indexterm zone="ch-system-coreutils yes"><primary sortas="b-yes">yes</primary></indexterm>
<para>outputs <quote>y</quote>, or a given string, repeatedly until killed.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>