diff -Nur coreutils-5.2.1.orig/doc/coreutils.texi coreutils-5.2.1/doc/coreutils.texi --- coreutils-5.2.1.orig/doc/coreutils.texi Wed Mar 10 18:50:52 2004 +++ coreutils-5.2.1/doc/coreutils.texi Thu Mar 18 16:40:26 2004 @@ -20,102 +20,93 @@ @syncodeindex pg cp @syncodeindex vr cp -@dircategory Basics +@dircategory Core utilities: @direntry -* Coreutils: (coreutils). Core GNU (file, text, shell) utilities. -* Common options: (coreutils)Common options. Common options. -* File permissions: (coreutils)File permissions. Access modes. -* Date input formats: (coreutils)Date input formats. -@end direntry - -@dircategory Individual utilities -@direntry -* basename: (coreutils)basename invocation. Strip directory and suffix. -* cat: (coreutils)cat invocation. Concatenate and write files. -* chgrp: (coreutils)chgrp invocation. Change file groups. -* chmod: (coreutils)chmod invocation. Change file permissions. -* chown: (coreutils)chown invocation. Change file owners/groups. -* chroot: (coreutils)chroot invocation. Specify the root directory. -* cksum: (coreutils)cksum invocation. Print POSIX CRC checksum. -* comm: (coreutils)comm invocation. Compare sorted files by line. -* cp: (coreutils)cp invocation. Copy files. -* csplit: (coreutils)csplit invocation. Split by context. -* cut: (coreutils)cut invocation. Print selected parts of lines. -* date: (coreutils)date invocation. Print/set system date and time. -* dd: (coreutils)dd invocation. Copy and convert a file. -* df: (coreutils)df invocation. Report filesystem disk usage. -* dir: (coreutils)dir invocation. List directories briefly. -* dircolors: (coreutils)dircolors invocation. Color setup for ls. -* dirname: (coreutils)dirname invocation. Strip non-directory suffix. -* du: (coreutils)du invocation. Report on disk usage. -* echo: (coreutils)echo invocation. Print a line of text. -* env: (coreutils)env invocation. Modify the environment. -* expand: (coreutils)expand invocation. Convert tabs to spaces. -* expr: (coreutils)expr invocation. Evaluate expressions. -* factor: (coreutils)factor invocation. Print prime factors -* false: (coreutils)false invocation. Do nothing, unsuccessfully. -* fmt: (coreutils)fmt invocation. Reformat paragraph text. -* fold: (coreutils)fold invocation. Wrap long input lines. -* groups: (coreutils)groups invocation. Print group names a user is in. -* head: (coreutils)head invocation. Output the first part of files. -* hostid: (coreutils)hostid invocation. Print numeric host identifier. -* hostname: (coreutils)hostname invocation. Print or set system name. -* id: (coreutils)id invocation. Print real/effective uid/gid. -* install: (coreutils)install invocation. Copy and change attributes. -* join: (coreutils)join invocation. Join lines on a common field. -* kill: (coreutils)kill invocation. Send a signal to processes. -* link: (coreutils)link invocation. Make hard links between files. -* ln: (coreutils)ln invocation. Make links between files. -* logname: (coreutils)logname invocation. Print current login name. -* ls: (coreutils)ls invocation. List directory contents. -* md5sum: (coreutils)md5sum invocation. Print or check message-digests. -* mkdir: (coreutils)mkdir invocation. Create directories. -* mkfifo: (coreutils)mkfifo invocation. Create FIFOs (named pipes). -* mknod: (coreutils)mknod invocation. Create special files. -* mv: (coreutils)mv invocation. Rename files. -* nice: (coreutils)nice invocation. Modify scheduling priority. -* nl: (coreutils)nl invocation. Number lines and write files. -* nohup: (coreutils)nohup invocation. Immunize to hangups. -* od: (coreutils)od invocation. Dump files in octal, etc. -* paste: (coreutils)paste invocation. Merge lines of files. -* pathchk: (coreutils)pathchk invocation. Check file name portability. -* pr: (coreutils)pr invocation. Paginate or columnate files. -* printenv: (coreutils)printenv invocation. Print environment variables. -* printf: (coreutils)printf invocation. Format and print data. -* ptx: (coreutils)ptx invocation. Produce permuted indexes. -* pwd: (coreutils)pwd invocation. Print working directory. -* readlink: (coreutils)readlink invocation. Print referent of a symlink. -* rm: (coreutils)rm invocation. Remove files. -* rmdir: (coreutils)rmdir invocation. Remove empty directories. -* seq: (coreutils)seq invocation. Print numeric sequences -* shred: (coreutils)shred invocation. Remove files more securely. -* sleep: (coreutils)sleep invocation. Delay for a specified time. -* sort: (coreutils)sort invocation. Sort text files. -* split: (coreutils)split invocation. Split into fixed-size pieces. -* stat: (coreutils)stat invocation. Report file(system) status. -* stty: (coreutils)stty invocation. Print/change terminal settings. -* su: (coreutils)su invocation. Modify user and group id. -* sum: (coreutils)sum invocation. Print traditional checksum. -* sync: (coreutils)sync invocation. Synchronize memory and disk. -* tac: (coreutils)tac invocation. Reverse files. -* tail: (coreutils)tail invocation. Output the last part of files. -* tee: (coreutils)tee invocation. Redirect to multiple files. -* test: (coreutils)test invocation. File/string tests. -* touch: (coreutils)touch invocation. Change file timestamps. -* tr: (coreutils)tr invocation. Translate characters. -* true: (coreutils)true invocation. Do nothing, successfully. -* tsort: (coreutils)tsort invocation. Topological sort. -* tty: (coreutils)tty invocation. Print terminal name. -* uname: (coreutils)uname invocation. Print system information. -* unexpand: (coreutils)unexpand invocation. Convert spaces to tabs. -* uniq: (coreutils)uniq invocation. Uniquify files. -* unlink: (coreutils)unlink invocation. Removal via unlink(2). -* users: (coreutils)users invocation. Print current user names. -* vdir: (coreutils)vdir invocation. List directories verbosely. -* wc: (coreutils)wc invocation. Line, word, and byte counts. -* who: (coreutils)who invocation. Print who is logged in. -* whoami: (coreutils)whoami invocation. Print effective user id. -* yes: (coreutils)yes invocation. Print a string indefinitely. +* Coreutils: (coreutils). Core GNU (file, text, shell) utilities +* basename: (coreutils)basename. Strip directory and suffix +* cat: (coreutils)cat. Concatenate and write files +* chgrp: (coreutils)chgrp. Change file groups +* chmod: (coreutils)chmod. Change file permissions +* chown: (coreutils)chown. Change file owners/groups +* chroot: (coreutils)chroot. Specify the root directory +* cksum: (coreutils)cksum. Print POSIX CRC checksum +* comm: (coreutils)comm. Compare sorted files by line +* cp: (coreutils)cp. Copy files +* csplit: (coreutils)csplit. Split by context +* cut: (coreutils)cut. Print selected parts of lines +* date: (coreutils)date. Print/set system date and time +* dd: (coreutils)dd. Copy and convert a file +* df: (coreutils)df. Report filesystem disk usage +* dir: (coreutils)dir. List directories briefly +* dircolors: (coreutils)dircolors. Color setup for ls +* dirname: (coreutils)dirname. Strip non-directory suffix +* du: (coreutils)du. Report on disk usage +* echo: (coreutils)echo. Print a line of text +* env: (coreutils)env. Modify the environment +* expand: (coreutils)expand. Convert tabs to spaces +* expr: (coreutils)expr. Evaluate expressions +* factor: (coreutils)factor. Print prime factors +* false: (coreutils)false. Do nothing, unsuccessfully +* fmt: (coreutils)fmt. Reformat paragraph text +* fold: (coreutils)fold. Wrap long input lines +* groups: (coreutils)groups. Print group names a user is in +* head: (coreutils)head. Output the first part of files +* hostid: (coreutils)hostid. Print numeric host identifier +* id: (coreutils)id. Print real/effective uid/gid +* install: (coreutils)install. Copy and change attributes +* join: (coreutils)join. Join lines on a common field +* link: (coreutils)link. Make hard links between files +* ln: (coreutils)ln. Make links between files +* logname: (coreutils)logname. Print current login name +* ls: (coreutils)ls. List directory contents +* md5sum: (coreutils)md5sum. Print or check message-digests +* mkdir: (coreutils)mkdir. Create directories +* mkfifo: (coreutils)mkfifo. Create FIFOs (named pipes) +* mknod: (coreutils)mknod. Create special files +* mv: (coreutils)mv. Rename files +* nice: (coreutils)nice. Modify scheduling priority +* nl: (coreutils)nl. Number lines and write files +* nohup: (coreutils)nohup. Immunize to hangups +* od: (coreutils)od. Dump files in octal, etc. +* paste: (coreutils)paste. Merge lines of files +* pathchk: (coreutils)pathchk. Check file name portability +* pr: (coreutils)pr. Paginate or columnate files +* printenv: (coreutils)printenv. Print environment variables +* printf: (coreutils)printf. Format and print data +* ptx: (coreutils)ptx. Produce permuted indexes +* pwd: (coreutils)pwd. Print working directory +* readlink: (coreutils)readlink. Print referent of a symlink +* rm: (coreutils)rm. Remove files +* rmdir: (coreutils)rmdir. Remove empty directories +* seq: (coreutils)seq. Print numeric sequences +* shred: (coreutils)shred. Remove files more securely +* sleep: (coreutils)sleep. Delay for a specified time +* sort: (coreutils)sort. Sort text files +* split: (coreutils)split. Split into fixed-size pieces +* stat: (coreutils)stat. Report file(system) status +* stty: (coreutils)stty. Print/change terminal settings +* su: (coreutils)su. Modify user and group id +* sum: (coreutils)sum. Print traditional checksum +* sync: (coreutils)sync. Synchronize memory and disk +* tac: (coreutils)tac. Reverse files +* tail: (coreutils)tail. Output the last part of files +* tee: (coreutils)tee. Redirect to multiple files +* test: (coreutils)test. File/string tests +* touch: (coreutils)touch. Change file timestamps +* tr: (coreutils)tr. Translate characters +* true: (coreutils)true. Do nothing, successfully +* tsort: (coreutils)tsort. Topological sort +* tty: (coreutils)tty. Print terminal name +* uname: (coreutils)uname. Print system information +* unexpand: (coreutils)unexpand. Convert spaces to tabs +* uniq: (coreutils)uniq. Uniquify files +* unlink: (coreutils)unlink. Removal via unlink(2) +* users: (coreutils)users. Print current user names +* vdir: (coreutils)vdir. List directories verbosely +* wc: (coreutils)wc. Line, word, and byte counts +* who: (coreutils)who. Print who is logged in +* whoami: (coreutils)whoami. Print effective user id +* yes: (coreutils)yes. Print a string indefinitely @end direntry @copying @@ -179,10 +170,9 @@ * Redirection:: tee * File name manipulation:: dirname basename pathchk * Working context:: pwd stty printenv tty -* User information:: id logname whoami groups users who -* System context:: date uname hostname +* User information:: id logname whoami users who +* System context:: date uname * Modified command invocation:: chroot env nice nohup su -* Process control:: kill * Delaying:: sleep * Numeric operations:: factor seq * File permissions:: Access modes. @@ -207,38 +197,38 @@ Output of entire files -* cat invocation:: Concatenate and write files. -* tac invocation:: Concatenate and write files in reverse. -* nl invocation:: Number lines and write files. -* od invocation:: Write files in octal or other formats. +* cat:: Concatenate and write files. +* tac:: Concatenate and write files in reverse. +* nl:: Number lines and write files. +* od:: Write files in octal or other formats. Formatting file contents -* fmt invocation:: Reformat paragraph text. -* pr invocation:: Paginate or columnate files for printing. -* fold invocation:: Wrap input lines to fit in specified width. +* fmt:: Reformat paragraph text. +* pr:: Paginate or columnate files for printing. +* fold:: Wrap input lines to fit in specified width. Output of parts of files -* head invocation:: Output the first part of files. -* tail invocation:: Output the last part of files. -* split invocation:: Split a file into fixed-size pieces. -* csplit invocation:: Split a file into context-determined pieces. +* head:: Output the first part of files. +* tail:: Output the last part of files. +* split:: Split a file into fixed-size pieces. +* csplit:: Split a file into context-determined pieces. Summarizing files -* wc invocation:: Print newline, word, and byte counts. -* sum invocation:: Print checksum and block counts. -* cksum invocation:: Print CRC checksum and byte counts. -* md5sum invocation:: Print or check message-digests. +* wc:: Print newline, word, and byte counts. +* sum:: Print checksum and block counts. +* cksum:: Print CRC checksum and byte counts. +* md5sum:: Print or check message-digests. Operating on sorted files -* sort invocation:: Sort text files. -* uniq invocation:: Uniquify files. -* comm invocation:: Compare two sorted files line by line. -* ptx invocation:: Produce a permuted index of file contents. -* tsort invocation:: Topological sort. +* sort:: Sort text files. +* uniq:: Uniquify files. +* comm:: Compare two sorted files line by line. +* ptx:: Produce a permuted index of file contents. +* tsort:: Topological sort. @command{ptx}: Produce permuted indexes @@ -250,15 +240,15 @@ Operating on fields within a line -* cut invocation:: Print selected parts of lines. -* paste invocation:: Merge lines of files. -* join invocation:: Join lines on a common field. +* cut:: Print selected parts of lines. +* paste:: Merge lines of files. +* join:: Join lines on a common field. Operating on characters -* tr invocation:: Translate, squeeze, and/or delete characters. -* expand invocation:: Convert tabs to spaces. -* unexpand invocation:: Convert spaces to tabs. +* tr:: Translate, squeeze, and/or delete characters. +* expand:: Convert tabs to spaces. +* unexpand:: Convert spaces to tabs. @command{tr}: Translate, squeeze, and/or delete characters @@ -269,10 +259,10 @@ Directory listing -* ls invocation:: List directory contents -* dir invocation:: Briefly list directory contents -* vdir invocation:: Verbosely list directory contents -* dircolors invocation:: Color setup for @command{ls} +* ls:: List directory contents +* dir:: Briefly list directory contents +* vdir:: Verbosely list directory contents +* dircolors:: Color setup for @command{ls} @command{ls}: List directory contents @@ -285,50 +275,50 @@ Basic operations -* cp invocation:: Copy files and directories -* dd invocation:: Convert and copy a file -* install invocation:: Copy files and set attributes -* mv invocation:: Move (rename) files -* rm invocation:: Remove files or directories -* shred invocation:: Remove files more securely +* cp:: Copy files and directories +* dd:: Convert and copy a file +* install:: Copy files and set attributes +* mv:: Move (rename) files +* rm:: Remove files or directories +* shred:: Remove files more securely Special file types -* link invocation:: Make a hard link via the link syscall -* ln invocation:: Make links between files -* mkdir invocation:: Make directories -* mkfifo invocation:: Make FIFOs (named pipes) -* mknod invocation:: Make block or character special files -* readlink invocation:: Print the referent of a symbolic link -* rmdir invocation:: Remove empty directories -* unlink invocation:: Remove files via unlink syscall +* link:: Make a hard link via the link syscall +* ln:: Make links between files +* mkdir:: Make directories +* mkfifo:: Make FIFOs (named pipes) +* mknod:: Make block or character special files +* readlink:: Print the referent of a symbolic link +* rmdir:: Remove empty directories +* unlink:: Remove files via unlink syscall Changing file attributes -* chown invocation:: Change file owner and group -* chgrp invocation:: Change group ownership -* chmod invocation:: Change access permissions -* touch invocation:: Change file timestamps +* chown:: Change file owner and group +* chgrp:: Change group ownership +* chmod:: Change access permissions +* touch:: Change file timestamps Disk usage -* df invocation:: Report filesystem disk space usage -* du invocation:: Estimate file space usage -* stat invocation:: Report file or filesystem status -* sync invocation:: Synchronize data on disk with memory +* df:: Report filesystem disk space usage +* du:: Estimate file space usage +* stat:: Report file or filesystem status +* sync:: Synchronize data on disk with memory Printing text -* echo invocation:: Print a line of text -* printf invocation:: Format and print data -* yes invocation:: Print a string until interrupted +* echo:: Print a line of text +* printf:: Format and print data +* yes:: Print a string until interrupted Conditions -* false invocation:: Do nothing, unsuccessfully -* true invocation:: Do nothing, successfully -* test invocation:: Check file types and compare values -* expr invocation:: Evaluate expressions +* false:: Do nothing, unsuccessfully +* true:: Do nothing, successfully +* test:: Check file types and compare values +* expr:: Evaluate expressions @command{test}: Check file types and compare values @@ -347,20 +337,20 @@ Redirection -* tee invocation:: Redirect output to multiple files +* tee:: Redirect output to multiple files File name manipulation -* basename invocation:: Strip directory and suffix from a file name -* dirname invocation:: Strip non-directory suffix from a file name -* pathchk invocation:: Check file name portability +* basename:: Strip directory and suffix from a file name +* dirname:: Strip non-directory suffix from a file name +* pathchk:: Check file name portability Working context -* pwd invocation:: Print working directory -* stty invocation:: Print or change terminal characteristics -* printenv invocation:: Print all or some environment variables -* tty invocation:: Print file name of terminal on standard input +* pwd:: Print working directory +* stty:: Print or change terminal characteristics +* printenv:: Print all or some environment variables +* tty:: Print file name of terminal on standard input @command{stty}: Print or change terminal characteristics @@ -374,19 +364,18 @@ User information -* id invocation:: Print real and effective uid and gid -* logname invocation:: Print current login name -* whoami invocation:: Print effective user id -* groups invocation:: Print group names a user is in -* users invocation:: Print login names of users currently logged in -* who invocation:: Print who is currently logged in +* id:: Print real and effective uid and gid +* logname:: Print current login name +* whoami:: Print effective user id +* groups:: Print group names a user is in +* users:: Print login names of users currently logged in +* who:: Print who is currently logged in System context -* date invocation:: Print or set system date and time -* uname invocation:: Print system information -* hostname invocation:: Print or set system name -* hostid invocation:: Print numeric host identifier. +* date:: Print or set system date and time +* uname:: Print system information +* hostid:: Print numeric host identifier @command{date}: Print or set system date and time @@ -400,24 +389,20 @@ Modified command invocation -* chroot invocation:: Run a command with a different root directory -* env invocation:: Run a command in a modified environment -* nice invocation:: Run a command with modified scheduling priority -* nohup invocation:: Run a command immune to hangups -* su invocation:: Run a command with substitute user and group id - -Process control - -* kill invocation:: Sending a signal to processes. +* chroot:: Run a command with a different root directory +* env:: Run a command in a modified environment +* nice:: Run a command with modified scheduling priority +* nohup:: Run a command immune to hangups +* su:: Run a command with substitute user and group id Delaying -* sleep invocation:: Delay for a specified time +* sleep:: Delay for a specified time Numeric operations -* factor invocation:: Print prime factors -* seq invocation:: Print numeric sequences +* factor:: Print prime factors +* seq:: Print numeric sequences File permissions @@ -1099,13 +1084,13 @@ in some way. @menu -* cat invocation:: Concatenate and write files. -* tac invocation:: Concatenate and write files in reverse. -* nl invocation:: Number lines and write files. -* od invocation:: Write files in octal or other formats. +* cat:: Concatenate and write files. +* tac:: Concatenate and write files in reverse. +* nl:: Number lines and write files. +* od:: Write files in octal or other formats. @end menu -@node cat invocation +@node cat @section @command{cat}: Concatenate and write files @pindex cat @@ -1213,7 +1198,7 @@ @exitstatus -@node tac invocation +@node tac @section @command{tac}: Concatenate and write files in reverse @pindex tac @@ -1262,7 +1247,7 @@ @exitstatus -@node nl invocation +@node nl @section @command{nl}: Number lines and write files @pindex nl @@ -1425,7 +1410,7 @@ @exitstatus -@node od invocation +@node od @section @command{od}: Write files in octal or other formats @pindex od @@ -1682,13 +1667,13 @@ These commands reformat the contents of files. @menu -* fmt invocation:: Reformat paragraph text. -* pr invocation:: Paginate or columnate files for printing. -* fold invocation:: Wrap input lines to fit in specified width. +* fmt:: Reformat paragraph text. +* pr:: Paginate or columnate files for printing. +* fold:: Wrap input lines to fit in specified width. @end menu -@node fmt invocation +@node fmt @section @command{fmt}: Reformat paragraph text @pindex fmt @@ -1786,7 +1771,7 @@ @exitstatus -@node pr invocation +@node pr @section @command{pr}: Paginate or columnate files for printing @pindex pr @@ -1928,7 +1913,7 @@ @cindex time formats @cindex formatting times Format header dates using @var{format}, using the same conventions as -for the the command @samp{date +@var{format}}; @xref{date invocation}. +for the the command @samp{date +@var{format}}; @xref{date}. Except for directives, which start with @samp{%}, characters in @var{format} are printed unchanged. You can use this option to specify an arbitrary string in place of the header date, @@ -2157,7 +2142,7 @@ @exitstatus -@node fold invocation +@node fold @section @command{fold}: Wrap input lines to fit in specified width @pindex fold @@ -2225,13 +2210,13 @@ These commands output pieces of the input. @menu -* head invocation:: Output the first part of files. -* tail invocation:: Output the last part of files. -* split invocation:: Split a file into fixed-size pieces. -* csplit invocation:: Split a file into context-determined pieces. +* head:: Output the first part of files. +* tail:: Output the last part of files. +* split:: Split a file into fixed-size pieces. +* csplit:: Split a file into context-determined pieces. @end menu -@node head invocation +@node head @section @command{head}: Output the first part of files @pindex head @@ -2303,7 +2288,7 @@ @exitstatus -@node tail invocation +@node tail @section @command{tail}: Output the last part of files @pindex tail @@ -2483,7 +2468,7 @@ @exitstatus -@node split invocation +@node split @section @command{split}: Split a file into fixed-size pieces @pindex split @@ -2565,7 +2550,7 @@ @exitstatus -@node csplit invocation +@node csplit @section @command{csplit}: Split a file into context-determined pieces @pindex csplit @@ -2705,14 +2690,14 @@ contents of files. @menu -* wc invocation:: Print newline, word, and byte counts. -* sum invocation:: Print checksum and block counts. -* cksum invocation:: Print CRC checksum and byte counts. -* md5sum invocation:: Print or check message-digests. +* wc:: Print newline, word, and byte counts. +* sum:: Print checksum and block counts. +* cksum:: Print CRC checksum and byte counts. +* md5sum:: Print or check message-digests. @end menu -@node wc invocation +@node wc @section @command{wc}: Print newline, word, and byte counts @pindex wc @@ -2796,7 +2781,7 @@ @exitstatus -@node sum invocation +@node sum @section @command{sum}: Print checksum and block counts @pindex sum @@ -2847,7 +2832,7 @@ @exitstatus -@node cksum invocation +@node cksum @section @command{cksum}: Print CRC checksum and byte counts @pindex cksum @@ -2881,7 +2866,7 @@ @exitstatus -@node md5sum invocation +@node md5sum @section @command{md5sum}: Print or check message-digests @pindex md5sum @@ -2988,16 +2973,16 @@ These commands work with (or produce) sorted files. @menu -* sort invocation:: Sort text files. -* uniq invocation:: Uniquify files. -* comm invocation:: Compare two sorted files line by line. -* ptx invocation:: Produce a permuted index of file contents. -* tsort invocation:: Topological sort. +* sort:: Sort text files. +* uniq:: Uniquify files. +* comm:: Compare two sorted files line by line. +* ptx:: Produce a permuted index of file contents. +* tsort:: Topological sort. * tsort background:: Where tsort came from. @end menu -@node sort invocation +@node sort @section @command{sort}: Sort text files @pindex sort @@ -3481,7 +3466,7 @@ @end itemize -@node uniq invocation +@node uniq @section @command{uniq}: Uniquify files @pindex uniq @@ -3618,7 +3603,7 @@ @exitstatus -@node comm invocation +@node comm @section @command{comm}: Compare two sorted files line by line @pindex comm @@ -3661,7 +3646,7 @@ If there is an error it exits with nonzero status. -@node tsort invocation +@node tsort @section @command{tsort}: Topological sort @pindex tsort @@ -3815,7 +3800,7 @@ @exitstatus -@node ptx invocation +@node ptx @section @command{ptx}: Produce permuted indexes @pindex ptx @@ -4284,13 +4269,13 @@ @chapter Operating on fields within a line @menu -* cut invocation:: Print selected parts of lines. -* paste invocation:: Merge lines of files. -* join invocation:: Join lines on a common field. +* cut:: Print selected parts of lines. +* paste:: Merge lines of files. +* join:: Join lines on a common field. @end menu -@node cut invocation +@node cut @section @command{cut}: Print selected parts of lines @pindex cut @@ -4380,7 +4365,7 @@ @exitstatus -@node paste invocation +@node paste @section @command{paste}: Merge lines of files @pindex paste @@ -4450,7 +4435,7 @@ @exitstatus -@node join invocation +@node join @section @command{join}: Join lines on a common field @pindex join @@ -4580,13 +4565,13 @@ This commands operate on individual characters. @menu -* tr invocation:: Translate, squeeze, and/or delete characters. -* expand invocation:: Convert tabs to spaces. -* unexpand invocation:: Convert spaces to tabs. +* tr:: Translate, squeeze, and/or delete characters. +* expand:: Convert tabs to spaces. +* unexpand:: Convert spaces to tabs. @end menu -@node tr invocation +@node tr @section @command{tr}: Translate, squeeze, and/or delete characters @pindex tr @@ -4972,7 +4957,7 @@ Unix versions, which provide no way to preserve zero bytes. -@node expand invocation +@node expand @section @command{expand}: Convert tabs to spaces @pindex expand @@ -5027,7 +5012,7 @@ @exitstatus -@node unexpand invocation +@node unexpand @section @command{unexpand}: Convert spaces to tabs @pindex unexpand @@ -5088,14 +5073,14 @@ and @command{vdir}, which list information about files. @menu -* ls invocation:: List directory contents. -* dir invocation:: Briefly ls. -* vdir invocation:: Verbosely ls. -* dircolors invocation:: Color setup for ls, etc. +* ls:: List directory contents. +* dir:: Briefly ls. +* vdir:: Verbosely ls. +* dircolors:: Color setup for ls, etc. @end menu -@node ls invocation +@node ls @section @command{ls}: List directory contents @pindex ls @@ -5784,7 +5769,7 @@ @item +@var{format} @vindex LC_TIME List timestamps using @var{format}, where @var{format} is interpreted -like the format argument of @command{date} (@pxref{date invocation}). +like the format argument of @command{date} (@pxref{date}). For example, @option{--time-style="+%Y-%m-%d %H:%M:%S"} causes @command{ls} to list timestamps like @samp{2002-03-30 23:45:56}. As with @command{date}, @var{format}'s interpretation is affected by the @@ -5968,7 +5953,7 @@ @end table -@node dir invocation +@node dir @section @command{dir}: Briefly list directory contents @pindex dir @@ -5978,10 +5963,10 @@ -b}; that is, by default files are listed in columns, sorted vertically, and special characters are represented by backslash escape sequences. -@xref{ls invocation, @command{ls}}. +@xref{ls, @command{ls}}. -@node vdir invocation +@node vdir @section @command{vdir}: Verbosely list directory contents @pindex vdir @@ -5991,7 +5976,7 @@ -b}; that is, by default files are listed in long format and special characters are represented by backslash escape sequences. -@node dircolors invocation +@node dircolors @section @command{dircolors}: Color setup for @command{ls} @pindex dircolors @@ -6069,16 +6054,16 @@ copying, moving (renaming), and deleting (removing). @menu -* cp invocation:: Copy files. -* dd invocation:: Convert and copy a file. -* install invocation:: Copy files and set attributes. -* mv invocation:: Move (rename) files. -* rm invocation:: Remove files or directories. -* shred invocation:: Remove files more securely. +* cp:: Copy files. +* dd:: Convert and copy a file. +* install:: Copy files and set attributes. +* mv:: Move (rename) files. +* rm:: Remove files or directories. +* shred:: Remove files more securely. @end menu -@node cp invocation +@node cp @section @command{cp}: Copy files and directories @pindex cp @@ -6407,7 +6392,7 @@ @exitstatus -@node dd invocation +@node dd @section @command{dd}: Convert and copy a file @pindex dd @@ -6580,7 +6565,7 @@ @exitstatus -@node install invocation +@node install @section @command{install}: Copy files and set attributes @pindex install @@ -6699,7 +6684,7 @@ @exitstatus -@node mv invocation +@node mv @section @command{mv}: Move (rename) files @pindex mv @@ -6801,7 +6786,7 @@ @exitstatus -@node rm invocation +@node rm @section @command{rm}: Remove files or directories @pindex rm @@ -6916,7 +6901,7 @@ @exitstatus -@node shred invocation +@node shred @section @command{shred}: Remove files more securely @pindex shred @@ -6926,7 +6911,7 @@ @command{shred} overwrites devices or files, to help prevent even very expensive hardware from recovering the data. -Ordinarily when you remove a file (@pxref{rm invocation}), the data is +Ordinarily when you remove a file (@pxref{rm}), the data is not actually destroyed. Only the index listing where the file is stored is destroyed, and the storage is made available for reuse. There are undelete utilities that will attempt to reconstruct the index @@ -7149,18 +7134,18 @@ (FIFOs), symbolic links, sockets, and so-called @dfn{special files}. @menu -* link invocation:: Make a hard link via the link syscall -* ln invocation:: Make links between files. -* mkdir invocation:: Make directories. -* mkfifo invocation:: Make FIFOs (named pipes). -* mknod invocation:: Make block or character special files. -* readlink invocation:: Print the referent of a symbolic link. -* rmdir invocation:: Remove empty directories. -* unlink invocation:: Remove files via the unlink syscall +* link:: Make a hard link via the link syscall +* ln:: Make links between files. +* mkdir:: Make directories. +* mkfifo:: Make FIFOs (named pipes). +* mknod:: Make block or character special files. +* readlink:: Print the referent of a symbolic link. +* rmdir:: Remove empty directories. +* unlink:: Remove files via the unlink syscall. @end menu -@node link invocation +@node link @section @command{link}: Make a hard link via the link syscall @pindex link @@ -7186,7 +7171,7 @@ @exitstatus -@node ln invocation +@node ln @section @command{ln}: Make links between files @pindex ln @@ -7327,7 +7312,7 @@ @exitstatus -@node mkdir invocation +@node mkdir @section @command{mkdir}: Make directories @pindex mkdir @@ -7383,7 +7368,7 @@ @exitstatus -@node mkfifo invocation +@node mkfifo @section @command{mkfifo}: Make FIFOs (named pipes) @pindex mkfifo @@ -7421,7 +7406,7 @@ @exitstatus -@node mknod invocation +@node mknod @section @command{mknod}: Make block or character special files @pindex mknod @@ -7492,7 +7477,7 @@ @exitstatus -@node readlink invocation +@node readlink @section @command{readlink}: Print the referent of a symbolic link @pindex readlink @@ -7562,7 +7547,7 @@ @exitstatus -@node rmdir invocation +@node rmdir @section @command{rmdir}: Remove empty directories @pindex rmdir @@ -7610,12 +7595,12 @@ @end table -@xref{rm invocation}, for how to remove non-empty directories (recursively). +@xref{rm}, for how to remove non-empty directories (recursively). @exitstatus -@node unlink invocation +@node unlink @section @command{unlink}: Remove files via the unlink syscall @pindex unlink @@ -7660,14 +7645,14 @@ These commands change file attributes. @menu -* chgrp invocation:: Change file groups. -* chmod invocation:: Change access permissions. -* chown invocation:: Change file owners and groups. -* touch invocation:: Change file timestamps. +* chgrp:: Change file groups. +* chmod:: Change access permissions. +* chown:: Change file owners and groups. +* touch:: Change file timestamps. @end menu -@node chown invocation +@node chown @section @command{chown}: Change file owner and group @pindex chown @@ -7864,7 +7849,7 @@ @exitstatus -@node chgrp invocation +@node chgrp @section @command{chgrp}: Change group ownership @pindex chgrp @@ -7972,7 +7957,7 @@ @exitstatus -@node chmod invocation +@node chmod @section @command{chmod}: Change access permissions @pindex chmod @@ -8057,7 +8042,7 @@ @exitstatus -@node touch invocation +@node touch @section @command{touch}: Change file timestamps @pindex touch @@ -8184,14 +8169,14 @@ or some such command.) @menu -* df invocation:: Report filesystem disk space usage. -* du invocation:: Estimate file space usage. -* stat invocation:: Report file or filesystem status. -* sync invocation:: Synchronize memory and disk. +* df:: Report filesystem disk space usage. +* du:: Estimate file space usage. +* stat:: Report file or filesystem status. +* sync:: Synchronize memory and disk. @end menu -@node df invocation +@node df @section @command{df}: Report filesystem disk space usage @pindex df @@ -8387,7 +8372,7 @@ @exitstatus -@node du invocation +@node du @section @command{du}: Estimate file space usage @pindex du @@ -8578,7 +8563,7 @@ @exitstatus -@node stat invocation +@node stat @section @command{stat}: Report file or filesystem status @pindex stat @@ -8679,7 +8664,7 @@ @exitstatus -@node sync invocation +@node sync @section @command{sync}: Synchronize data on disk with memory @pindex sync @@ -8714,13 +8699,13 @@ This section describes commands that display text strings. @menu -* echo invocation:: Print a line of text. -* printf invocation:: Format and print data. -* yes invocation:: Print a string until interrupted. +* echo:: Print a line of text. +* printf:: Format and print data. +* yes:: Print a string until interrupted. @end menu -@node echo invocation +@node echo @section @command{echo}: Print a line of text @pindex echo @@ -8778,7 +8763,7 @@ @exitstatus -@node printf invocation +@node printf @section @command{printf}: Format and print data @pindex printf @@ -8875,7 +8860,7 @@ @exitstatus -@node yes invocation +@node yes @section @command{yes}: Print a string until interrupted @pindex yes @@ -8904,14 +8889,14 @@ pipeline. @menu -* false invocation:: Do nothing, unsuccessfully. -* true invocation:: Do nothing, successfully. -* test invocation:: Check file types and compare values. -* expr invocation:: Evaluate expressions. +* false:: Do nothing, unsuccessfully. +* true:: Do nothing, successfully. +* test:: Check file types and compare values. +* expr:: Evaluate expressions. @end menu -@node false invocation +@node false @section @command{false}: Do nothing, unsuccessfully @pindex false @@ -8937,7 +8922,7 @@ @option{--help} or @option{--version}. -@node true invocation +@node true @section @command{true}: Do nothing, successfully @pindex true @@ -8976,7 +8961,7 @@ more secure and faster than a shell script implementation, and may safely be used as a dummy shell for the purpose of disabling accounts. -@node test invocation +@node test @section @command{test}: Check file types and compare values @pindex test @@ -9287,7 +9272,7 @@ @end table -@node expr invocation +@node expr @section @command{expr}: Evaluate expressions @pindex expr @@ -9553,11 +9538,11 @@ it's described here. @menu -* tee invocation:: Redirect output to multiple files. +* tee:: Redirect output to multiple files. @end menu -@node tee invocation +@node tee @section @command{tee}: Redirect output to multiple files @pindex tee @@ -9608,13 +9593,13 @@ This section describes commands that manipulate file names. @menu -* basename invocation:: Strip directory and suffix from a file name. -* dirname invocation:: Strip non-directory suffix from a file name. -* pathchk invocation:: Check file name portability. +* basename:: Strip directory and suffix from a file name. +* dirname:: Strip non-directory suffix from a file name. +* pathchk:: Check file name portability. @end menu -@node basename invocation +@node basename @section @command{basename}: Strip directory and suffix from a file name @pindex basename @@ -9641,7 +9626,7 @@ @exitstatus -@node dirname invocation +@node dirname @section @command{dirname}: Strip non-directory suffix from a file name @pindex dirname @@ -9665,7 +9650,7 @@ @exitstatus -@node pathchk invocation +@node pathchk @section @command{pathchk}: Check file name portability @pindex pathchk @@ -9729,14 +9714,14 @@ so forth. See also the user-related commands in the next section. @menu -* pwd invocation:: Print working directory. -* stty invocation:: Print or change terminal characteristics. -* printenv invocation:: Print environment variables. -* tty invocation:: Print file name of terminal on standard input. +* pwd:: Print working directory. +* stty:: Print or change terminal characteristics. +* printenv:: Print environment variables. +* tty:: Print file name of terminal on standard input. @end menu -@node pwd invocation +@node pwd @section @command{pwd}: Print working directory @pindex pwd @@ -9761,7 +9746,7 @@ @exitstatus -@node stty invocation +@node stty @section @command{stty}: Print or change terminal characteristics @pindex stty @@ -10409,7 +10394,7 @@ @end table -@node printenv invocation +@node printenv @section @command{printenv}: Print all or some environment variables @pindex printenv @@ -10439,7 +10424,7 @@ @end display -@node tty invocation +@node tty @section @command{tty}: Print file name of terminal on standard input @pindex tty @@ -10489,16 +10474,16 @@ logins, groups, and so forth. @menu -* id invocation:: Print real and effective uid and gid. -* logname invocation:: Print current login name. -* whoami invocation:: Print effective user id. -* groups invocation:: Print group names a user is in. -* users invocation:: Print login names of users currently logged in. -* who invocation:: Print who is currently logged in. +* id:: Print real and effective uid and gid. +* logname:: Print current login name. +* whoami:: Print effective user id. +* groups:: Print group names a user is in. +* users:: Print login names of users currently logged in. +* who:: Print who is currently logged in. @end menu -@node id invocation +@node id @section @command{id}: Print real and effective uid and gid @pindex id @@ -10561,7 +10546,7 @@ @exitstatus -@node logname invocation +@node logname @section @command{logname}: Print current login name @pindex logname @@ -10583,7 +10568,7 @@ @exitstatus -@node whoami invocation +@node whoami @section @command{whoami}: Print effective user id @pindex whoami @@ -10599,7 +10584,7 @@ @exitstatus -@node groups invocation +@node groups @section @command{groups}: Print group names a user is in @pindex groups @@ -10623,7 +10608,7 @@ @exitstatus -@node users invocation +@node users @section @command{users}: Print login names of users currently logged in @pindex users @@ -10653,7 +10638,7 @@ @exitstatus -@node who invocation +@node who @section @command{who}: Print who is currently logged in @pindex who @@ -10804,14 +10789,13 @@ information. @menu -* date invocation:: Print or set system date and time. -* uname invocation:: Print system information. -* hostname invocation:: Print or set system name. -* hostid invocation:: Print numeric host identifier. +* date:: Print or set system date and time. +* uname:: Print system information. +* hostid:: Print numeric host identifier. @end menu -@node date invocation +@node date @section @command{date}: Print or set system date and time @pindex date @@ -11323,7 +11307,7 @@ @end itemize -@node uname invocation +@node uname @section @command{uname}: Print system information @pindex uname @@ -11446,31 +11430,7 @@ @exitstatus -@node hostname invocation -@section @command{hostname}: Print or set system name - -@pindex hostname -@cindex setting the hostname -@cindex printing the hostname -@cindex system name, printing -@cindex appropriate privileges - -With no arguments, @command{hostname} prints the name of the current host -system. With one argument, it sets the current host name to the -specified string. You must have appropriate privileges to set the host -name. Synopsis: - -@example -hostname [@var{name}] -@end example - -The only options are @option{--help} and @option{--version}. @xref{Common -options}. - -@exitstatus - - -@node hostid invocation +@node hostid @section @command{hostid}: Print numeric host identifier. @pindex hostid @@ -11507,15 +11467,15 @@ user, etc. @menu -* chroot invocation:: Modify the root directory. -* env invocation:: Modify environment variables. -* nice invocation:: Modify scheduling priority. -* nohup invocation:: Immunize to hangups. -* su invocation:: Modify user and group id. +* chroot:: Modify the root directory. +* env:: Modify environment variables. +* nice:: Modify scheduling priority. +* nohup:: Immunize to hangups. +* su:: Modify user and group id. @end menu -@node chroot invocation +@node chroot @section @command{chroot}: Run a command with a different root directory @pindex chroot @@ -11580,7 +11540,7 @@ @end display -@node env invocation +@node env @section @command{env}: Run a command in a modified environment @pindex env @@ -11645,7 +11605,7 @@ @end display -@node nice invocation +@node nice @section @command{nice}: Run a command with modified scheduling priority @pindex nice @@ -11750,7 +11710,7 @@ @end example -@node nohup invocation +@node nohup @section @command{nohup}: Run a command immune to hangups @pindex nohup @@ -11802,7 +11762,7 @@ @end display -@node su invocation +@node su @section @command{su}: Run a command with substitute user and group id @pindex su @@ -11959,166 +11919,6 @@ might find this idea strange at first. -@node Process control -@chapter Process control - -@cindex processes, commands for controlling -@cindex commands for controlling processes - -@menu -* kill invocation:: Sending a signal to processes. -@end menu - - -@node kill invocation -@section @command{kill}: Send a signal to processes - -@pindex kill -@cindex send a signal to processes - -The @command{kill} command sends a signal to processes, causing them -to terminate or otherwise act upon receiving the signal in some way. -Alternatively, it lists information about signals. Synopses: - -@example -kill [-s @var{signal} | --signal @var{signal} | -@var{signal}] @var{pid}@dots{} -kill [-l | --list | -t | --table] [@var{signal}]@dots{} -@end example - -The first form of the @command{kill} command sends a signal to all -@var{pid} arguments. The default signal to send if none is specified -is @samp{TERM}. The special signal number @samp{0} does not denote a -valid signal, but can be used to test whether the @var{pid} arguments -specify processes to which a signal could be sent. - -If @var{pid} is positive, the signal is sent to the process with the -process id @var{pid}. If @var{pid} is zero, the signal is sent to all -processes in the process group of the current process. If @var{pid} -is -1, the signal is sent to all processes for which the user has -permission to send a signal. If @var{pid} is less than -1, the signal -is sent to all processes in the process group that equals the absolute -value of @var{pid}. - -If @var{pid} is not positive, a system-dependent set of system -processes is excluded from the list of processes to which the signal -is sent. - -If a negative @var{PID} argument is desired as the first one, either a -signal must be specified as well, or the option parsing -must be interrupted with `--' before the first @var{pid} argument. -The following three commands are equivalent: - -@example -kill -15 -1 -kill -TERM -1 -kill -- -1 -@end example - -The first form of the @command{kill} command succeeds if every @var{pid} -argument specifies at least one process that the signal was sent to. - -The second form of the @command{kill} command lists signal information. -Either the @option{-l} or @option{--list} option, or the @option{-t} -or @option{--table} option must be specified. Without any -@var{signal} argument, all supported signals are listed. The output -of @option{-l} or @option{--list} is a list of the signal names, one -per line; if @var{signal} is already a name, the signal number is -printed instead. The output of @option{-t} or @option{--table} is a -table of signal numbers, names, and descriptions. This form of the -@command{kill} command succeeds if all @var{signal} arguments are valid -and if there is no output error. - -The @command{kill} command also supports the @option{--help} and -@option{--version} options. @xref{Common options}. - -A @var{signal} may be a signal name like @samp{HUP}, or a signal -number like @samp{1}, or an exit status of a process terminated by the -signal. A signal name can be given in canonical form or prefixed by -@samp{SIG}. The case of the letters is ignored, except for the -@option{-@var{signal}} option which must use upper case to avoid -ambiguity with lower case option letters. The following signal names -and numbers are supported on all @acronym{POSIX} compliant systems: - -@table @samp -@item HUP -1. Hangup. -@item INT -2. Terminal interrupt. -@item QUIT -3. Terminal quit. -@item ABRT -6. Process abort. -@item KILL -9. Kill (cannot be caught or ignored). -@item ALRM -14. Alarm Clock. -@item TERM -15. Termination. -@end table - -@noindent -Other supported signal names have system-dependent corresponding -numbers. All systems conforming to @acronym{POSIX} 1003.1-2001 also -support the following signals: - -@table @samp -@item BUS -Access to an undefined portion of a memory object. -@item CHLD -Child process terminated, stopped, or continued. -@item CONT -Continue executing, if stopped. -@item FPE -Erroneous arithmetic operation. -@item ILL -Illegal Instruction. -@item PIPE -Write on a pipe with no one to read it. -@item SEGV -Invalid memory reference. -@item STOP -Stop executing (cannot be caught or ignored). -@item TSTP -Terminal stop. -@item TTIN -Background process attempting read. -@item TTOU -Background process attempting write. -@item URG -High bandwidth data is available at a socket. -@item USR1 -User-defined signal 1. -@item USR2 -User-defined signal 2. -@end table - -@noindent -@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XSI} extension -also support the following signals: - -@table @samp -@item POLL -Pollable event. -@item PROF -Profiling timer expired. -@item SYS -Bad system call. -@item TRAP -Trace/breakpoint trap. -@item VTALRM -Virtual timer expired. -@item XCPU -CPU time limit exceeded. -@item XFSZ -File size limit exceeded. -@end table - -@noindent -@acronym{POSIX} 1003.1-2001 systems that support the @acronym{XRT} extension -also support at least eight real-time signals called @samp{RTMIN}, -@samp{RTMIN+1}, @dots{}, @samp{RTMAX-1}, @samp{RTMAX}. - - @node Delaying @chapter Delaying @@ -12128,11 +11928,11 @@ @c Perhaps @command{wait} or other commands should be described here also? @menu -* sleep invocation:: Delay for a specified time. +* sleep:: Delay for a specified time. @end menu -@node sleep invocation +@node sleep @section @command{sleep}: Delay for a specified time @pindex sleep @@ -12179,12 +11979,12 @@ These programs do numerically-related operations. @menu -* factor invocation:: Show factors of numbers. -* seq invocation:: Print sequences of numbers. +* factor:: Show factors of numbers. +* seq:: Print sequences of numbers. @end menu -@node factor invocation +@node factor @section @command{factor}: Print prime factors @pindex factor @@ -12232,7 +12032,7 @@ @exitstatus -@node seq invocation +@node seq @section @command{seq}: Print numeric sequences @pindex seq