added coreutils files

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2662 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

5 files changed, 376 insertions, 0 deletions

diff --git a/appendixa/coreutils-dep.xml b/appendixa/coreutils-dep.xml
new file mode 100644
index 000000000..fe3e3303f
--- /dev/null
+++ b/appendixa/coreutils-dep.xml
@@ -0,0 +1,28 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2>
+<title>Coreutils Installation Dependencies</title>
+
+<para>Not yet checked but probably something like this:</para>
+
+<literallayout>Autoconf: autoconf, autoheader
+Automake: aclocal, automake
+Bash: sh
+Binutils: ar, as, ld, ranlib
+Coreutils: basename, cat, chmod, chown, echo, expr, hostname,
+              install, ls, mv, rm, sleep, tr, uname
+Diffutils: cmp
+Gettext: msgfmt, xgettext
+Gcc: cc, cc1, collect2, cpp0, gcc
+Glibc: getconf
+Grep: egrep, fgrep, grep
+M4: m4
+Make: make
+Gawk: gawk
+Perl: perl
+Sed: sed
+Tar: tar
+Texinfo: install-info, makeinfo</literallayout>
+
+</sect2>
+
diff --git a/appendixa/coreutils-desc.xml b/appendixa/coreutils-desc.xml
new file mode 100644
index 000000000..3381ca2ff
--- /dev/null
+++ b/appendixa/coreutils-desc.xml
@@ -0,0 +1,311 @@
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2><title>Descriptions</title>
+
+<para>Not yet fully checked.</para>
+
+<sect3><title>Program file descriptions</title>
+
+<sect4><title>basename</title>
+<para>basename strips directory and suffixes from filenames.</para></sect4>
+
+<sect4><title>cat</title>
+<para>cat concatenates file(s) or standard input to 
+standard output.</para></sect4>
+
+<sect4><title>chgrp</title>
+<para>chgrp changes the group ownership of each given file to the named group, 
+which can be either a group name or a numeric group ID.</para></sect4>
+
+<sect4><title>chmod</title>
+<para>chmod changes the permissions of each given file according to mode, which 
+can be either a symbolic representation of changes to make or an octal 
+number representing the bit pattern for the new permissions.</para></sect4>
+
+<sect4><title>chown</title>
+<para>chown changes the user and/or group ownership of each 
+given file.</para></sect4>
+
+<sect4><title>chroot</title>
+<para>chroot runs a command or interactive shell with special 
+root directory.</para></sect4>
+
+<sect4><title>cksum</title>
+<para>cksum prints CRC checksum and byte counts of each specified
+file.</para></sect4>
+
+<sect4><title>comm</title>
+<para>comm compares two sorted files line by line.</para></sect4>
+
+<sect4><title>cp</title>
+<para>cp copies files from one place to another.</para></sect4>
+
+<sect4><title>csplit</title>
+<para>csplit outputs pieces of a file separated by (a) pattern(s) to files
+xx01, xx02, ..., and outputs byte counts of each piece to standard 
+output.</para></sect4>
+
+<sect4><title>cut</title>
+<para>cut prints selected parts of lines from specified files to standard 
+output.</para></sect4>
+
+<sect4><title>date</title>
+<para>date displays the current time in a specified format, or sets 
+the system date.</para></sect4>
+
+<sect4><title>dd</title>
+<para>dd copies a file (from the standard input to the standard output, by 
+default) with a user-selectable blocksize, while optionally performing 
+conversions on it.</para></sect4>
+
+<sect4><title>df</title>
+<para>df displays the amount of disk space available on the filesystem
+containing each file name argument. If no file name is given, the space 
+available on all currently mounted filesystems is shown.</para></sect4>
+
+<sect4><title>dir, ls and vdir</title>
+<para>dir and vdir are versions of ls with different default output formats. 
+These programs list each given file or directory name. Directory contents 
+are sorted alphabetically. For ls, files are, by default, listed in columns 
+sorted vertically if the standard output is a terminal; otherwise they 
+are listed one per line. For dir, files are, by default, listed in columns
+sorted vertically. For vdir, files are, by default, listed in 
+long format.</para></sect4>
+
+<sect4><title>dircolors</title>
+<para>dircolors outputs commands to set the LS_COLOR environment variable.
+The LS_COLOR variable is use to change the default color scheme used by
+ls and related utilities.</para></sect4>
+
+<sect4><title>dirname</title>
+<para>dirname strips non-directory suffixes from file name.</para></sect4>
+
+<sect4><title>du</title>
+<para>du displays the amount of disk space used by each file or directory
+listed on the command-line and by each of their subdirectories.</para></sect4>
+
+<sect4><title>echo</title>
+<para>echo displays a line of text.</para></sect4>
+
+<sect4><title>env</title>
+<para>env runs a program in a modified environment.</para></sect4>
+
+<sect4><title>expand</title>
+<para>expand converts tabs in files to spaces, writing to standard 
+output.</para></sect4>
+
+<sect4><title>expr</title>
+<para>expr evaluates expressions.</para></sect4>
+
+<sect4><title>factor</title>
+<para>factor prints the prime factors of all specified 
+integer numbers.</para></sect4>
+
+<sect4><title>false</title>
+<para>false always exits with a status code indicating failure.</para></sect4>
+
+<sect4><title>fmt</title>
+<para>fmt reformats each paragraph in the specified file(s), writing to 
+standard output.</para></sect4>
+
+<sect4><title>fold</title>
+<para>fold wraps input lines in each specified file (standard input by default),
+writing to standard output.</para></sect4>
+
+<sect4><title>groups</title>
+<para>groups prints a user's group memberships.</para></sect4>
+
+<sect4><title>head</title>
+<para>head prints the first xx (10 by default) lines of each specified file to
+standard output.</para></sect4>
+
+<sect4><title>hostid</title>
+<para>hostid prints the numeric identifier (in hexadecimal) for the current 
+host.</para></sect4>
+
+<sect4><title>id</title>
+<para>id prints the effective user and group IDs of the current
+user or a given user.</para></sect4>
+
+<sect4><title>install</title>
+<para>install copies files and sets their permission modes and, if possible, 
+their owner and group.</para></sect4>
+
+<sect4><title>join</title>
+<para>join joins lines of two files on a common field.</para></sect4>
+
+<sect4><title>ln</title>
+<para>ln makes hard or soft (symbolic) links between files.</para></sect4>
+
+<sect4><title>logname</title>
+<para>logname prints the current user's login name.</para></sect4>
+
+<sect4><title>md5sum</title>
+<para>md5sum prints or checks MD5 checksums.</para></sect4>
+
+<sect4><title>mkdir</title>
+<para>mkdir creates directories with a given name.</para></sect4>
+
+<sect4><title>mkfifo</title>
+<para>mkfifo creates a FIFO with each given name.</para></sect4>
+
+<sect4><title>mknod</title>
+<para>mknod creates a FIFO, character special file or block special file 
+with the given file name.</para></sect4>
+
+<sect4><title>mv</title>
+<para>mv moves files from one directory to another or renames files, depending
+on the arguments given to mv.</para></sect4>
+
+<sect4><title>nice</title>
+<para>nice runs a program with modified scheduling priority.</para></sect4>
+
+<sect4><title>nl</title>
+<para>nl writes each specified file to standard output, with line numbers
+added.</para></sect4>
+
+<sect4><title>nohup</title>
+<para>nohup runs a command immune to hangups, with output to a 
+log file.</para></sect4>
+
+<sect4><title>od</title>
+<para>od writes an unambiguous representation, octal bytes by default, of a
+specified file to standard output.</para></sect4>
+
+<sect4><title>paste</title>
+<para>paste writes lines consisting of the sequentially corresponding
+lines from each specified file, separated by TABs, 
+to standard output.</para></sect4>
+
+<sect4><title>pathchk</title>
+<para>pathchk checks whether file names are valid or portable.</para></sect4>
+
+<sect4><title>pinky</title>
+<para>pinky is a lightweight finger utility which retrieves information about
+a certain user.</para></sect4>
+
+<sect4><title>pr</title>
+<para>pr paginates or columnates files for printing.</para></sect4>
+
+<sect4><title>printenv</title>
+<para>printenv prints all or part of the environment.</para></sect4>
+
+<sect4><title>printf</title>
+<para>printf formats and prints data (the same as the C printf 
+function).</para></sect4>
+
+<sect4><title>ptx</title>
+<para>ptx produces a permuted index of file contents.</para></sect4>
+
+<sect4><title>pwd</title>
+<para>pwd prints the name of the current/working directory.</para></sect4>
+
+<sect4><title>rm</title>
+<para>rm removes files or directories.</para></sect4>
+
+<sect4><title>rmdir</title>
+<para>rmdir removes directories, if they are empty.</para></sect4>
+
+<sect4><title>seq</title>
+<para>seq prints numbers in a certain range with a certain 
+increment.</para></sect4>
+
+<sect4><title>shred</title>
+<para>shred deletes a file securely, overwriting it first so that its 
+contents can't be recovered.</para></sect4>
+
+<sect4><title>sleep</title>
+<para>sleep delays for a specified amount of time.</para></sect4>
+
+<sect4><title>sort</title>
+<para>sort writes sorted concatenation of files to standard 
+output.</para></sect4>
+
+<sect4><title>split</title>
+<para>split outputs fixed-size pieces of an input file to 
+PREFIXaa, PREFIXab, ...</para></sect4>
+
+<sect4><title>stty</title>
+<para>stty changes and prints terminal line settings.</para></sect4>
+
+<sect4><title>su</title>
+<para>su runs a shell with substitute user and group IDs.</para></sect4>
+
+<sect4><title>sum</title>
+<para>sum prints checksum and block counts for each specified 
+file.</para></sect4>
+
+<sect4><title>sync</title>
+<para>sync forces changed blocks to disk and updates the 
+super block.</para></sect4>
+
+<sect4><title>tac</title>
+<para>tac writes each specified file to standard output, last line
+first.</para></sect4>
+
+<sect4><title>tail</title>
+<para>tail print the last xx (10 by default) lines of each specified file to 
+standard output.</para></sect4>
+
+<sect4><title>tee</title>
+<para>tee reads from standard input and writes to standard output and 
+files.</para></sect4>
+
+<sect4><title>test</title>
+<para>test checks file types and compares values.</para></sect4>
+
+<sect4><title>touch</title>
+<para>touch changes the access and modification times of each given file to the 
+current time. Files that do not exist are created empty.</para></sect4>
+
+<sect4><title>tr</title>
+<para>tr translates, squeezes, and/or deletes characters from standard
+input, writing to standard output.</para></sect4>
+
+<sect4><title>true</title>
+<para>true always exits with a status code indicating success.</para></sect4>
+
+<sect4><title>tsort</title>
+<para>tsort writes totally ordered lists consistent with the partial ordering 
+in specified files.</para></sect4>
+
+<sect4><title>tty</title>
+<para>tty prints the file name of the terminal connected to standard 
+input.</para></sect4>
+
+<sect4><title>uname</title>
+<para>uname prints system information.</para></sect4>
+
+<sect4><title>unexpand</title>
+<para>unexpand converts spaces in each file to tabs, writing to standard
+output.</para></sect4>
+
+<sect4><title>uniq</title>
+<para>uniq removes duplicate lines from a sorted file.</para></sect4>
+
+<sect4><title>uptime</title>
+<para>uptime tells how long the system has been running.</para></sect4>
+
+<sect4><title>users</title>
+<para>users prints the user names of users currently logged in to the 
+current host.</para></sect4>
+
+<sect4><title>wc</title>
+<para>wc prints line, word and byte counts for each specified file and a
+total line, if more than one file is specified.</para></sect4>
+
+<sect4><title>who</title>
+<para>who shows who is logged on.</para></sect4>
+
+<sect4><title>whoami</title>
+<para>whoami prints the user name associated with the current
+effective user ID.</para></sect4>
+
+<sect4><title>yes</title>
+<para>yes outputs 'y' or a given string repeatedly,
+until killed.</para></sect4>
+
+</sect3>
+
+</sect2>
+
diff --git a/appendixa/coreutils-down.xml b/appendixa/coreutils-down.xml
new file mode 100644
index 000000000..b238dfe4d
--- /dev/null
+++ b/appendixa/coreutils-down.xml
@@ -0,0 +1,6 @@
+<sect2>
+<title>Official Download Location</title>
+
+<para><literallayout>Coreutils (&coreutils-version;):
+<ulink url="ftp://ftp.gnu.org/gnu/coreutils/"/></literallayout></para>
+</sect2>
diff --git a/appendixa/coreutils-shortdesc.xml b/appendixa/coreutils-shortdesc.xml
new file mode 100644
index 000000000..711786ba9
--- /dev/null
+++ b/appendixa/coreutils-shortdesc.xml
@@ -0,0 +1,20 @@
+<sect2><title>Contents of Coreutils</title>
+
+<para>Not yet fully checked.</para>
+
+<para>The Coreutils package contains a whole series of basic shell utilities.</para>
+
+<para>Coreutils installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>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,
+kill, 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, yes</para></sect3>
+
+</sect2>
+
diff --git a/appendixa/coreutils.xml b/appendixa/coreutils.xml
new file mode 100644
index 000000000..0cb99bda2
--- /dev/null
+++ b/appendixa/coreutils.xml
@@ -0,0 +1,11 @@
+<sect1 id="aa-coreutils">
+<title>Coreutils</title>
+<?dbhtml filename="coreutils.html" dir="appendixa"?>
+
+&aa-coreutils-down;
+&aa-coreutils-shortdesc;
+&aa-coreutils-desc;
+&aa-coreutils-dep;
+
+</sect1>
+