diff options
author | Igor Pashev <pashev.igor@gmail.com> | 2015-07-04 17:13:50 +0300 |
---|---|---|
committer | Igor Pashev <pashev.igor@gmail.com> | 2015-07-04 17:13:50 +0300 |
commit | 71cd8e3a743046573744123777061b64881bf372 (patch) | |
tree | 82522befe647f4fff186a5630cad0cad33f8ef53 /doc/coreutils.info | |
parent | c18578632fd3c9e513e613a86ba2b7c4ebee6c45 (diff) | |
download | coreutils-upstream.tar.gz |
Imported Upstream version 8.24upstream/8.24upstream
Diffstat (limited to 'doc/coreutils.info')
-rw-r--r-- | doc/coreutils.info | 2239 |
1 files changed, 1236 insertions, 1003 deletions
diff --git a/doc/coreutils.info b/doc/coreutils.info index 495797ec..68b00961 100644 --- a/doc/coreutils.info +++ b/doc/coreutils.info @@ -1,10 +1,10 @@ -This is coreutils.info, produced by makeinfo version 5.1 from +This is coreutils.info, produced by makeinfo version 5.2 from coreutils.texi. -This manual documents version 8.23 of the GNU core utilities, including +This manual documents version 8.24 of the GNU core utilities, including the standard programs for text and file manipulation. - Copyright © 1994-2014 Free Software Foundation, Inc. + Copyright © 1994-2015 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, @@ -33,7 +33,7 @@ START-INFO-DIR-ENTRY * 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. -* coreutils: (coreutils)coreutils invocation. Multi-call program. +* coreutils: (coreutils)Multi-call invocation. Multi-call program. * cp: (coreutils)cp invocation. Copy files. * csplit: (coreutils)csplit invocation. Split by context. * cut: (coreutils)cut invocation. Print selected parts of lines. @@ -100,7 +100,7 @@ START-INFO-DIR-ENTRY * stdbuf: (coreutils)stdbuf invocation. Modify stdio buffering. * stty: (coreutils)stty invocation. Print/change terminal settings. * sum: (coreutils)sum invocation. Print traditional checksum. -* sync: (coreutils)sync invocation. Synchronize memory and disk. +* sync: (coreutils)sync invocation. Synchronize memory to 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. @@ -131,10 +131,10 @@ File: coreutils.info, Node: Top, Next: Introduction, Up: (dir) GNU Coreutils ************* -This manual documents version 8.23 of the GNU core utilities, including +This manual documents version 8.24 of the GNU core utilities, including the standard programs for text and file manipulation. - Copyright © 1994-2014 Free Software Foundation, Inc. + Copyright © 1994-2015 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, @@ -170,7 +170,7 @@ the standard programs for text and file manipulation. * Modified command invocation:: chroot env nice nohup stdbuf timeout * Process control:: kill * Delaying:: sleep -* Numeric operations:: factor seq +* Numeric operations:: factor numfmt seq * File permissions:: Access modes * Date input formats:: Specifying date strings * Opening the software toolbox:: The software tools philosophy @@ -193,7 +193,7 @@ Common Options * Traversing symlinks:: Traversing symlinks to directories * Treating / specially:: Treating / specially * Standards conformance:: Standards conformance -* coreutils invocation:: Multi-call binary invocation +* Multi-call invocation:: Multi-call program invocation Output of entire files @@ -206,7 +206,6 @@ Output of entire files Formatting file contents * fmt invocation:: Reformat paragraph text -* numfmt invocation:: Reformat numbers * pr invocation:: Paginate or columnate files for printing * fold invocation:: Wrap input lines to fit in specified width @@ -309,7 +308,7 @@ Disk usage * df invocation:: Report file system disk space usage * du invocation:: Estimate file space usage * stat invocation:: Report file or file system status -* sync invocation:: Synchronize data on disk with memory +* sync invocation:: Synchronize cached writes to persistent storage * truncate invocation:: Shrink or extend the size of a file Printing text @@ -424,6 +423,7 @@ Delaying Numeric operations * factor invocation:: Print prime factors +* numfmt invocation:: Reformat numbers * seq invocation:: Print numeric sequences File permissions @@ -541,11 +541,11 @@ programs, abbreviations of the long options are not always recognized. reads from the file named ‘-r’. A single ‘-’ operand is not really an option, though it looks like -one. It stands for standard input, or for standard output if that is -clear from the context. For example, ‘sort -’ reads from standard -input, and is equivalent to plain ‘sort’, and ‘tee -’ writes an extra -copy of its input to standard output. Unless otherwise specified, ‘-’ -can appear as any operand that requires a file name. +one. It stands for a file operand, and some tools treat it as standard +input, or as standard output if that is clear from the context. For +example, ‘sort -’ reads from standard input, and is equivalent to plain +‘sort’. Unless otherwise specified, a ‘-’ can appear as any operand +that requires a file name. * Menu: @@ -562,7 +562,7 @@ can appear as any operand that requires a file name. * Treating / specially:: –preserve-root and –no-preserve-root. * Special built-in utilities:: ‘break’, ‘:’, … * Standards conformance:: Conformance to the POSIX standard. -* coreutils invocation:: Multi-call binary invocation. +* Multi-call invocation:: Multi-call program invocation. File: coreutils.info, Node: Exit status, Next: Backup options, Up: Common options @@ -682,7 +682,7 @@ byte. number of bytes per block, or it can be ‘human-readable’ or ‘si’ to select a human-readable format. Integers may be followed by suffixes that are upward compatible with the SI prefixes -(http://www.bipm.org/en/si/si_brochure/chapter3/prefixes.html) for +(http://www.bipm.org/en/publications/si-brochure/chapter3.html) for decimal multiples and with the ISO/IEC 80000-13 (formerly IEC 60027-2) prefixes (http://physics.nist.gov/cuu/Units/binary.html) for binary multiples. @@ -787,10 +787,13 @@ Floating-Point Arithmetic (http://www.validlab.com/goldberg/paper.pdf). input use the standard C functions ‘strtod’ and ‘strtold’ to convert from text to floating point numbers. These floating point numbers therefore can use scientific notation like ‘1.0e-34’ and ‘-10e100’. -Modern C implementations also accept hexadecimal floating point numbers -such as ‘-0x.ep-3’, which stands for −14/16 times 2^-3, which equals -−0.109375. The ‘LC_NUMERIC’ locale determines the decimal-point -character. *Note (libc)Parsing of Floats::. +Commands that parse floating point also understand case-insensitive +‘inf’, ‘infinity’, and ‘NaN’, although whether such values are useful +depends on the command in question. Modern C implementations also +accept hexadecimal floating point numbers such as ‘-0x.ep-3’, which +stands for −14/16 times 2^-3, which equals −0.109375. The ‘LC_NUMERIC’ +locale determines the decimal-point character. *Note (libc)Parsing of +Floats::. File: coreutils.info, Node: Signal specifications, Next: Disambiguating names and IDs, Prev: Floating point, Up: Common options @@ -920,7 +923,7 @@ The ‘shuf’, ‘shred’, and ‘sort’ commands sometimes need random data do their work. For example, ‘sort -R’ must choose a hash function at random, and it needs random data to make this selection. - By default these commands use an internal pseudorandom generator + By default these commands use an internal pseudo-random generator initialized by a small amount of entropy, but can be directed to use an external source with the ‘--random-source=FILE’ option. An error is reported if FILE does not contain enough bytes. @@ -930,7 +933,7 @@ source of random data. Typically, this device gathers environmental noise from device drivers and other sources into an entropy pool, and uses the pool to generate random bits. If the pool is short of data, the device reuses the internal pool to produce more bits, using a -cryptographically secure pseudorandom number generator. But be aware +cryptographically secure pseudo-random number generator. But be aware that this device is not designed for bulk random data generation and is relatively slow. @@ -941,7 +944,18 @@ of available sources depends on your operating system. To reproduce the results of an earlier invocation of a command, you can save some random data into a file and then use that file as the -random source in earlier and later invocations of the command. +random source in earlier and later invocations of the command. Rather +than depending on a file, one can generate a reproducible arbitrary +amount of pseudo-random data given a seed value, using for example: + + get_seeded_random() + { + seed="$1" + openssl enc -aes-256-ctr -pass pass:"$seed" -nosalt \ + </dev/zero 2>/dev/null + } + + shuf -i1-100 --random-source=<(get_seeded_random 42) File: coreutils.info, Node: Target directory, Next: Trailing slashes, Prev: Random sources, Up: Common options @@ -1128,7 +1142,7 @@ the command ‘nice suspend’ generates an error message instead of suspending. -File: coreutils.info, Node: Standards conformance, Next: coreutils invocation, Prev: Special built-in utilities, Up: Common options +File: coreutils.info, Node: Standards conformance, Next: Multi-call invocation, Prev: Special built-in utilities, Up: Common options 2.13 Standards conformance ========================== @@ -1158,17 +1172,20 @@ any compatibility problems by setting ‘_POSIX2_VERSION=199209’ in your environment. -File: coreutils.info, Node: coreutils invocation, Prev: Standards conformance, Up: Common options +File: coreutils.info, Node: Multi-call invocation, Prev: Standards conformance, Up: Common options -2.14 ‘coreutils’: Multi-call binary -=================================== +2.14 ‘coreutils’: Multi-call program +==================================== -‘coreutils’ invokes an individual utility, either implicitly selected by -the last component of ‘argv[0]’, or by explicitly calling ‘coreutils’ -with the ‘--coreutils-prog’ option. Synopsis: +The ‘coreutils’ command invokes an individual utility, either implicitly +selected by the last component of the name used to invoke ‘coreutils’, +or explicitly with the ‘--coreutils-prog’ option. Synopsis: coreutils --coreutils-prog=PROGRAM … + The ‘coreutils’ command is not installed by default, so portable +scripts should not rely on its existence. + File: coreutils.info, Node: Output of entire files, Next: Formatting file contents, Prev: Common options, Up: Top @@ -1688,12 +1705,11 @@ These commands reformat the contents of files. * Menu: * fmt invocation:: Reformat paragraph text. -* numfmt invocation:: Reformat numbers. * pr invocation:: Paginate or columnate files for printing. * fold invocation:: Wrap input lines to fit in specified width. -File: coreutils.info, Node: fmt invocation, Next: numfmt invocation, Up: Formatting file contents +File: coreutils.info, Node: fmt invocation, Next: pr invocation, Up: Formatting file contents 4.1 ‘fmt’: Reformat paragraph text ================================== @@ -1771,292 +1787,9 @@ options::. indicates failure. -File: coreutils.info, Node: numfmt invocation, Next: pr invocation, Prev: fmt invocation, Up: Formatting file contents - -4.2 ‘numfmt’: Reformat numbers -============================== - -‘numfmt’ reads numbers in various representations and reformats them as -requested. The most common usage is converting numbers to/from _human_ -representation (e.g. ‘4G’ ↦ ‘4,000,000,000’). - - numfmt [OPTION]… [NUMBER] - - ‘numfmt’ converts each NUMBER on the command-line according to the -specified options (see below). If no NUMBERs are given, it reads -numbers from standard input. ‘numfmt’ can optionally extract numbers -from specific columns, maintaining proper line padding and alignment. - - An exit status of zero indicates success, and a nonzero value -indicates failure. - - See ‘--invalid’ for additional information regarding exit status. - -4.2.1 General options ---------------------- - -The program accepts the following options. Also see *note Common -options::. - -‘--debug’ - Print (to standard error) warning messages about possible erroneous - usage. - -‘-d D’ -‘--delimiter=D’ - Use the character D as input field separator (default: whitespace). - _Note_: Using non-default delimiter turns off automatic padding. - -‘--field=N’ - Convert the number in input field N (default: 1). - -‘--format=FORMAT’ - Use printf-style floating FORMAT string. The FORMAT string must - contain one ‘%f’ directive, optionally with ‘'’, ‘-’, ‘0’, or width - modifiers. The ‘'’ modifier will enable ‘--grouping’, the ‘-’ - modifier will enable left-aligned ‘--padding’ and the width - modifier will enable right-aligned ‘--padding’. The ‘0’ width - modifier (without the ‘-’ modifier) will generate leading zeros on - the number, up to the specified width. - -‘--from=UNIT’ - Auto-scales input numbers according to UNIT. See UNITS below. The - default is no scaling, meaning suffixes (e.g. ‘M’, ‘G’) will - trigger an error. - -‘--from-unit=N’ - Specify the input unit size (instead of the default 1). Use this - option when the input numbers represent other units (e.g. if the - input number ‘10’ represents 10 units of 512 bytes, use - ‘--from=unit=512’). - -‘--grouping’ - Group digits in output numbers according to the current locale’s - grouping rules (e.g _Thousands Separator_ character, commonly ‘.’ - (dot) or ‘,’ comma). This option has no effect in ‘POSIX/C’ - locale. - -‘--header[=N]’ - Print the first N (default: 1) lines without any conversion. - -‘--invalid=MODE’ - The default action on input errors is to exit immediately with - status code 2. ‘--invalid=‘abort’’ explicitly specifies this - default mode. With a MODE of ‘fail’, print a warning for _each_ - conversion error, and exit with status 2. With a MODE of ‘warn’, - exit with status 0, even in the presence of conversion errors, and - with a MODE of ‘ignore’ do not even print diagnostics. - -‘--padding=N’ - Pad the output numbers to N characters, by adding spaces. If N is - a positive number, numbers will be right-aligned. If N is a - negative number, numbers will be left-aligned. By default, numbers - are automatically aligned based on the input line’s width (only - with the default delimiter). - -‘--round=METHOD’ - When converting number representations, round the number according - to METHOD, which can be ‘up’, ‘down’, ‘from-zero’ (the default), - ‘towards-zero’, ‘nearest’. - -‘--suffix=SUFFIX’ - Add ‘SUFFIX’ to the output numbers, and accept optional ‘SUFFIX’ in - input numbers. - -‘--to=UNIT’ - Auto-scales output numbers according to UNIT. See _Units_ below. - The default is no scaling, meaning all the digits of the number are - printed. - -‘--to-unit=N’ - Specify the output unit size (instead of the default 1). Use this - option when the output numbers represent other units (e.g. to - represent ‘4,000,000’ bytes in blocks of 1KB, use ‘--to=si - --to=units=1000’). - -4.2.2 Possible UNITs: ---------------------- - -The following are the possible UNIT options with ‘--from=UNITS’ and -‘--to=UNITS’: - -NONE - No scaling is performed. For input numbers, no suffixes are - accepted, and any trailing characters following the number will - trigger an error. For output numbers, all digits of the numbers - will be printed. - -SI - Auto-scale numbers according to the _International System of Units - (SI)_ standard. For input numbers, accept one of the following - suffixes. For output numbers, values larger than 1000 will be - rounded, and printed with one of the following suffixes: - - ‘K’ => 1000^1 = 10^3 (Kilo) - ‘M’ => 1000^2 = 10^6 (Mega) - ‘G’ => 1000^3 = 10^9 (Giga) - ‘T’ => 1000^4 = 10^{12} (Tera) - ‘P’ => 1000^5 = 10^{15} (Peta) - ‘E’ => 1000^6 = 10^{18} (Exa) - ‘Z’ => 1000^7 = 10^{21} (Zetta) - ‘Y’ => 1000^8 = 10^{24} (Yotta) - -IEC - Auto-scale numbers according to the _International Electronical - Commission (IEC)_ standard. For input numbers, accept one of the - following suffixes. For output numbers, values larger than 1024 - will be rounded, and printed with one of the following suffixes: - - ‘K’ => 1024^1 = 2^{10} (Kibi) - ‘M’ => 1024^2 = 2^{20} (Mebi) - ‘G’ => 1024^3 = 2^{30} (Gibi) - ‘T’ => 1024^4 = 2^{40} (Tebi) - ‘P’ => 1024^5 = 2^{50} (Pebi) - ‘E’ => 1024^6 = 2^{60} (Exbi) - ‘Z’ => 1024^7 = 2^{70} (Zebi) - ‘Y’ => 1024^8 = 2^{80} (Yobi) - - The ‘iec’ option uses a single letter suffix (e.g. ‘G’), which is - not fully standard, as the _iec_ standard recommends a two-letter - symbol (e.g ‘Gi’) - but in practice, this method common. Compare - with the ‘iec-i’ option. - -IEC-I - Auto-scale numbers according to the _International Electronical - Commission (IEC)_ standard. For input numbers, accept one of the - following suffixes. For output numbers, values larger than 1024 - will be rounded, and printed with one of the following suffixes: - - ‘Ki’ => 1024^1 = 2^{10} (Kibi) - ‘Mi’ => 1024^2 = 2^{20} (Mebi) - ‘Gi’ => 1024^3 = 2^{30} (Gibi) - ‘Ti’ => 1024^4 = 2^{40} (Tebi) - ‘Pi’ => 1024^5 = 2^{50} (Pebi) - ‘Ei’ => 1024^6 = 2^{60} (Exbi) - ‘Zi’ => 1024^7 = 2^{70} (Zebi) - ‘Yi’ => 1024^8 = 2^{80} (Yobi) - - The ‘iec-i’ option uses a two-letter suffix symbol (e.g. ‘Gi’), as - the _iec_ standard recommends, but this is not always common in - practice. Compare with the ‘iec’ option. - -AUTO - ‘auto’ can only be used with ‘--from’. With this method, numbers - with ‘K’,‘M’,‘G’,‘T’,‘P’,‘E’,‘Z’,‘Y’ suffixes are interpreted as - _SI_ values, and numbers with ‘Ki’, - ‘Mi’,‘Gi’,‘Ti’,‘Pi’,‘Ei’,‘Zi’,‘Yi’ suffixes are interpreted as - _IEC_ values. - -4.2.3 Examples of using ‘numfmt’ --------------------------------- - -Converting a single number from/to _human_ representation: - $ numfmt --to=si 500000 - 500K - - $ numfmt --to=iec 500000 - 489K - - $ numfmt --to=iec-i 500000 - 489Ki - - $ numfmt --from=si 1M - 1000000 - - $ numfmt --from=iec 1M - 1048576 - - # with '--from=auto', M=Mega, Mi=Mebi - $ numfmt --from=auto 1M - 1000000 - $ numfmt --from=auto 1Mi - 1048576 - - Converting from ‘SI’ to ‘IEC’ scales (e.g. when a harddisk capacity -is advertised as ‘1TB’, while checking the drive’s capacity gives lower -values): - - $ numfmt --from=si --to=iec 1T - 932G - - Converting a single field from an input file / piped input (these -contrived examples are for demonstration purposes only, as both ‘ls’ and -‘df’ support the ‘--human-readable’ option to output sizes in -human-readable format): - - # Third field (file size) will be shown in SI representation - $ ls -log | numfmt --field 3 --header --to=si | head -n4 - -rw-r--r-- 1 94K Aug 23 2011 ABOUT-NLS - -rw-r--r-- 1 3.7K Jan 7 16:15 AUTHORS - -rw-r--r-- 1 36K Jun 1 2011 COPYING - -rw-r--r-- 1 0 Jan 7 15:15 ChangeLog - - # Second field (size) will be shown in IEC representation - $ df --block-size=1 | numfmt --field 2 --header --to=iec | head -n4 - File system 1B-blocks Used Available Use% Mounted on - rootfs 132G 104741408 26554036 80% / - tmpfs 794M 7580 804960 1% /run/shm - /dev/sdb1 694G 651424756 46074696 94% /home - - Output can be tweaked using ‘--padding’ or ‘--format’: - - # Pad to 10 characters, right-aligned - $ du -s * | numfmt --to=si --padding=10 - 2.5K config.log - 108 config.status - 1.7K configure - 20 configure.ac - - # Pad to 10 characters, left-aligned - $ du -s * | numfmt --to=si --padding=-10 - 2.5K config.log - 108 config.status - 1.7K configure - 20 configure.ac - - # Pad to 10 characters, left-aligned, using 'format' - $ du -s * | numfmt --to=si --format="%10f" - 2.5K config.log - 108 config.status - 1.7K configure - 20 configure.ac - - # Pad to 10 characters, left-aligned, using 'format' - $ du -s * | numfmt --to=si --padding="%-10f" - 2.5K config.log - 108 config.status - 1.7K configure - 20 configure.ac - - With locales that support grouping digits, using ‘--grouping’ or -‘--format’ enables grouping. In ‘POSIX’ locale, grouping is silently -ignored: - - $ LC_ALL=C numfmt --from=iec --grouping 2G - 2147483648 - - $ LC_ALL=en_US.utf8 numfmt --from=iec --grouping 2G - 2,147,483,648 - - $ LC_ALL=ta_IN numfmt --from=iec --grouping 2G - 2,14,74,83,648 - - $ LC_ALL=C ./src/numfmt --from=iec --format="==%'15f==" 2G - == 2147483648== - - $ LC_ALL=en_US.utf8 ./src/numfmt --from=iec --format="==%'15f==" 2G - == 2,147,483,648== - - $ LC_ALL=en_US.utf8 ./src/numfmt --from=iec --format="==%'-15f==" 2G - ==2,147,483,648 == - - $ LC_ALL=ta_IN ./src/numfmt --from=iec --format="==%'15f==" 2G - == 2,14,74,83,648== - - -File: coreutils.info, Node: pr invocation, Next: fold invocation, Prev: numfmt invocation, Up: Formatting file contents +File: coreutils.info, Node: pr invocation, Next: fold invocation, Prev: fmt invocation, Up: Formatting file contents -4.3 ‘pr’: Paginate or columnate files for printing +4.2 ‘pr’: Paginate or columnate files for printing ================================================== ‘pr’ writes each FILE (‘-’ means standard input), or standard input if @@ -2310,7 +2043,7 @@ indicates failure. File: coreutils.info, Node: fold invocation, Prev: pr invocation, Up: Formatting file contents -4.4 ‘fold’: Wrap input lines to fit in specified width +4.3 ‘fold’: Wrap input lines to fit in specified width ====================================================== ‘fold’ writes each FILE (‘-’ means standard input), or standard input if @@ -2670,7 +2403,8 @@ options::. ‘-l LINES’ ‘--lines=LINES’ - Put LINES lines of INPUT into each output file. + Put LINES lines of INPUT into each output file. If ‘--separator’ + is specified, then LINES determines the number of records. For compatibility ‘split’ also supports an obsolete option syntax ‘-LINES’. New scripts should use ‘-l LINES’ instead. @@ -2692,9 +2426,10 @@ options::. ‘-C SIZE’ ‘--line-bytes=SIZE’ Put into each output file as many complete lines of INPUT as - possible without exceeding SIZE bytes. Individual lines longer - than SIZE bytes are broken into multiple files. SIZE has the same - format as for the ‘--bytes’ option. + possible without exceeding SIZE bytes. Individual lines or records + longer than SIZE bytes are broken into multiple files. SIZE has + the same format as for the ‘--bytes’ option. If ‘--separator’ is + specified, then LINES determines the number of records. ‘--filter=COMMAND’ With this option, rather than simply writing to each output file, @@ -2718,7 +2453,7 @@ options::. N generate N files based on current size of INPUT K/N only output Kth of N to stdout - l/N generate N files without splitting lines + l/N generate N files without splitting lines or records l/K/N likewise but only output Kth of N to stdout r/N like ‘l’ but use round robin distribution r/K/N likewise but only output Kth of N to stdout @@ -2733,10 +2468,10 @@ options::. For ‘l’ mode, chunks are approximately INPUT size / N. The INPUT is partitioned into N equal sized portions, with the last assigned any excess. If a line _starts_ within a partition it is written - completely to the corresponding file. Since lines are not split - even if they overlap a partition, the files written can be larger - or smaller than the partition size, and even empty if a line is so - long as to completely overlap the partition. + completely to the corresponding file. Since lines or records are + not split even if they overlap a partition, the files written can + be larger or smaller than the partition size, and even empty if a + line/record is so long as to completely overlap the partition. For ‘r’ mode, the size of INPUT is irrelevant, and so can be a pipe for example. @@ -2752,10 +2487,15 @@ options::. ‘-d’ ‘--numeric-suffixes[=FROM]’ Use digits in suffixes rather than lower-case letters. The - numerical suffix counts from FROM if specified, 0 otherwise. Note - specifying a FROM value also disables the default auto suffix - length expansion described above, and so you may also want to - specify ‘-a’ to allow suffixes beyond ‘99’. + numerical suffix counts from FROM if specified, 0 otherwise. + + FROM is used to either set the initial suffix for a single run, or + to set the suffix offset for independently split inputs, and + consequently the auto suffix length expansion described above is + disabled. Therefore you may also want to use option ‘-a’ to allow + suffixes beyond ‘99’. Note if option ‘--number’ is specified and + the number of files is less than FROM, a single run is assumed and + the minimum suffix length required is automatically determined. ‘--additional-suffix=SUFFIX’ Append an additional SUFFIX to output file names. SUFFIX must not @@ -2769,6 +2509,13 @@ options::. completely span a chunk. The output file sequence numbers, always run consecutively even when this option is specified. +‘-t SEPARATOR’ +‘--separator=SEPARATOR’ + Use character SEPARATOR as the record separator instead of the + default newline character (ASCII LF). To specify ASCII NUL as the + separator, use the two-character string ‘\0’, e.g., ‘split -t + '\0'’. + ‘-u’ ‘--unbuffered’ Immediately copy input to output in ‘--number r/…’ mode, which is a @@ -2920,7 +2667,7 @@ options::. Do not remove output files when errors are encountered. ‘--suppress-matched’ - Do not output lines matching the specified PATTERN. I.E. suppress + Do not output lines matching the specified PATTERN. I.e., suppress the boundary line from the start of the second and subsequent splits. @@ -3064,7 +2811,9 @@ options::. ‘-L’ ‘--max-line-length’ - Print only the maximum line lengths. + Print only the maximum display widths. Tabs are set at every 8th + column. Display widths of wide characters are considered. + Non-printable characters are given 0 width. ‘--files0-from=FILE’ Disallow processing files named on the command line, and instead @@ -3182,12 +2931,15 @@ determine whether a file and checksum are consistent. Synopsis: md5sum [OPTION]… [FILE]… - For each FILE, ‘md5sum’ outputs the MD5 checksum, a flag indicating -binary or text input mode, and the file name. If FILE contains a -backslash or newline, the line is started with a backslash, and each -problematic character in the file name is escaped with a backslash, -making the output unambiguous even in the presence of arbitrary file -names. If FILE is omitted or specified as ‘-’, standard input is read. + For each FILE, ‘md5sum’ outputs by default, the MD5 checksum, a +space, a flag indicating binary or text input mode, and the file name. +Binary mode is indicated with ‘*’, text mode with ‘ ’ (space). Binary +mode is the default on systems where it’s significant, otherwise text +mode is the default. If FILE contains a backslash or newline, the line +is started with a backslash, and each problematic character in the file +name is escaped with a backslash, making the output unambiguous even in +the presence of arbitrary file names. If FILE is omitted or specified +as ‘-’, standard input is read. The program accepts the following options. Also see *note Common options::. @@ -3208,9 +2960,12 @@ options::. (or from stdin if no FILE was specified) and report whether the checksums match the contents of the named files. The input to this mode of ‘md5sum’ is usually the output of a prior, - checksum-generating run of ‘md5sum’. Each valid line of input - consists of an MD5 checksum, a binary/text flag, and then a file - name. Binary mode is indicated with ‘*’, text with ‘ ’ (space). + checksum-generating run of ‘md5sum’. Three input formats are + supported. Either the default output format described above, the + ‘--tag’ output format, or the BSD reversed mode format which is + similar to the default mode, but doesn’t use a character to + distinguish binary and text modes. + For each such line, ‘md5sum’ reads the named file and computes its MD5 checksum. Then, if the computed message digest does not match the one on the line with the file name, the file is noted as having @@ -3298,8 +3053,8 @@ File: coreutils.info, Node: sha2 utilities, Prev: sha1sum invocation, Up: Sum The commands ‘sha224sum’, ‘sha256sum’, ‘sha384sum’ and ‘sha512sum’ compute checksums of various lengths (respectively 224, 256, 384 and 512 bits), collectively known as the SHA-2 hashes. The usage and options of -these commands are precisely the same as for ‘md5sum’. *Note md5sum -invocation::. +these commands are precisely the same as for ‘md5sum’ and ‘sha1sum’. +*Note md5sum invocation::. Note: The SHA384 and SHA512 digests are considerably slower to compute, especially on 32-bit computers, than SHA224 or SHA256. @@ -6047,7 +5802,8 @@ These options affect the appearance of the overall output. ‘-1’ ‘--format=single-column’ List one file per line. This is the default for ‘ls’ when standard - output is not a terminal. + output is not a terminal. See also the ‘-b’ and ‘-q’ options to + suppress direct output of newline characters within a file name. ‘-C’ ‘--format=vertical’ @@ -6368,6 +6124,8 @@ File: coreutils.info, Node: vdir invocation, Next: dircolors invocation, Prev in long format and special characters are represented by backslash escape sequences. + *Note ‘ls’: ls invocation. + File: coreutils.info, Node: dircolors invocation, Prev: vdir invocation, Up: Directory listing @@ -6664,10 +6422,12 @@ options::. ‘--preserve=mode,ownership,timestamps’. In the absence of this option, the permissions of existing - destination files are unchanged, while each new file is created - with the mode bits of the corresponding source file, minus the bits - set in the umask and minus the set-user-ID and set-group-ID bits. - *Note File permissions::. + destination files are unchanged. Each new file is created with the + mode of the corresponding source file minus the set-user-ID, + set-group-ID, and sticky bits as the create mode; the operating + system then applies either the umask or a default ACL, possibly + resulting in a more restrictive file mode. *Note File + permissions::. ‘--no-preserve=ATTRIBUTE_LIST’ Do not preserve the specified attributes. The ATTRIBUTE_LIST has @@ -6715,7 +6475,7 @@ options::. ‘auto’ If the copy-on-write operation is not supported then fall back - to the standard copy behaviour. + to the standard copy behavior. This option is overridden by the ‘--link’, ‘--symbolic-link’ and ‘--attributes-only’ options, thus allowing it to be used to @@ -6891,19 +6651,26 @@ inspired by the DD (data definition) statement of OS/360 JCL. traditional POSIX specified behavior of counting input read operations. -‘status=WHICH’ +‘status=LEVEL’ Transfer information is normally output to stderr upon receipt of - the ‘INFO’ signal or when ‘dd’ exits. Specifying WHICH will - identify which information to suppress. - - ‘noxfer’ - Do not print the transfer rate and volume statistics that - normally make up the last status line. + the ‘INFO’ signal or when ‘dd’ exits. Specifying LEVEL will adjust + the amount of information printed, with the last LEVEL specified + taking precedence. ‘none’ Do not print any informational or warning messages to stderr. Error messages are output as normal. + ‘noxfer’ + Do not print the final transfer rate and volume statistics + that normally make up the last status line. + + ‘progress’ + Print the transfer rate and volume statistics on stderr, when + processing each input block. Statistics are output on a + single line at most once every second, but updates can be + delayed when waiting on I/O. + ‘conv=CONVERSION[,CONVERSION]…’ Convert the file as specified by the CONVERSION argument(s). (No spaces around any comma(s).) @@ -7028,7 +6795,7 @@ inspired by the DD (data definition) statement of OS/360 JCL. Use direct I/O for data, avoiding the buffer cache. Note that the kernel may impose restrictions on read or write buffer sizes. For example, with an ext4 destination file system and - a linux-based kernel, using ‘oflag=direct’ will cause writes + a Linux-based kernel, using ‘oflag=direct’ will cause writes to fail with ‘EINVAL’ if the output buffer size is not a multiple of 512. @@ -7170,21 +6937,35 @@ occur on disk based devices): # Rescue data from an (unmounted!) partition of a failing disk. dd conv=noerror,sync iflag=fullblock </dev/sda1 > /mnt/rescue.img - Sending an ‘INFO’ signal to a running ‘dd’ process makes it print I/O -statistics to standard error and then resume copying. In the example -below, ‘dd’ is run in the background to copy 10 million blocks. The -‘kill’ command makes it output intermediate I/O statistics, and when -‘dd’ completes normally or is killed by the ‘SIGINT’ signal, it outputs -the final statistics. - - $ dd if=/dev/zero of=/dev/null count=10MB & pid=$! - $ kill -s INFO $pid; wait $pid - 3385223+0 records in - 3385223+0 records out - 1733234176 bytes (1.7 GB) copied, 6.42173 seconds, 270 MB/s - 10000000+0 records in - 10000000+0 records out - 5120000000 bytes (5.1 GB) copied, 18.913 seconds, 271 MB/s + Sending an ‘INFO’ signal (or ‘USR1’ signal where that is unavailable) +to a running ‘dd’ process makes it print I/O statistics to standard +error and then resume copying. In the example below, ‘dd’ is run in the +background to copy 5GB of data. The ‘kill’ command makes it output +intermediate I/O statistics, and when ‘dd’ completes normally or is +killed by the ‘SIGINT’ signal, it outputs the final statistics. + + # Ignore the signal so we never inadvertently terminate the dd child. + # Note this is not needed when SIGINFO is available. + trap '' USR1 + + # Run dd with the fullblock iflag to avoid short reads + # which can be triggered by reception of signals. + dd iflag=fullblock if=/dev/zero of=/dev/null count=5000000 bs=1000 & pid=$! + + # Output stats every half second + until ! kill -s USR1 $pid 2>/dev/null; do sleep .5; done + + The above script will output in the following format + + 859+0 records in + 859+0 records out + 4295000000 bytes (4.3 GB) copied, 0.539934 s, 8.0 GB/s + 1000+0 records in + 1000+0 records out + 5000000000 bytes (5.0 GB) copied, 0.630785 s, 7.9 GB/s + + Note also the ‘status=progress’ option which periodically updates the +last line of the transfer statistics above. On systems lacking the ‘INFO’ signal ‘dd’ responds to the ‘USR1’ signal instead, unless the ‘POSIXLY_CORRECT’ environment variable is @@ -7573,7 +7354,7 @@ or: rm ./-f The Unix ‘rm’ program’s use of a single ‘-’ for this purpose predates -the development of the getopt standard syntax. +the development of the ‘getopt’ standard syntax. An exit status of zero indicates success, and a nonzero value indicates failure. @@ -7985,10 +7766,10 @@ options::. '/tmp/file' -> '../a/file' Relative symbolic links are generated based on their canonicalized - containing directory, and canonicalized targets. I.E. all symbolic - links in these file names will be resolved. *Note realpath - invocation::, which gives greater control over relative file name - generation, as demonstrated in the following example: + containing directory, and canonicalized targets. I.e., all + symbolic links in these file names will be resolved. *Note + realpath invocation::, which gives greater control over relative + file name generation, as demonstrated in the following example: ln--relative() { test "$1" = --no-symlinks && { nosym=$1; shift; } @@ -8140,7 +7921,7 @@ communicate. One process opens the FIFO file for writing, and another for reading, after which data can flow as with the usual anonymous pipe in shells or elsewhere. - The program accepts the following option. Also see *note Common + The program accepts the following options. Also see *note Common options::. ‘-m MODE’ @@ -8204,7 +7985,7 @@ device number begins with ‘0x’ or ‘0X’, it is interpreted as hexadecimal; otherwise, if it begins with ‘0’, as octal; otherwise, as decimal. - The program accepts the following option. Also see *note Common + The program accepts the following options. Also see *note Common options::. ‘-m MODE’ @@ -8899,7 +8680,7 @@ status information, and write buffers to disk. * df invocation:: Report file system disk space usage. * du invocation:: Estimate file space usage. * stat invocation:: Report file or file system status. -* sync invocation:: Synchronize memory and disk. +* sync invocation:: Synchronize cached writes to persistent storage. * truncate invocation:: Shrink or extend the size of a file. @@ -8944,25 +8725,21 @@ options::. ‘-a’ ‘--all’ - Include in the listing dummy file systems, which are omitted by - default. Such file systems are typically special-purpose - pseudo-file-systems, such as automounter entries. + Include in the listing dummy, duplicate, or inaccessible file + systems, which are omitted by default. Dummy file systems are + typically special purpose pseudo file systems such as ‘/proc’, with + no associated storage. Duplicate file systems are local or remote + file systems that are mounted at separate locations in the local + file hierarchy, or bind mounted locations. Inaccessible file + systems are those which are mounted but subsequently over-mounted + by another file system at that point, or otherwise inaccessible due + to permissions of the mount point etc. ‘-B SIZE’ ‘--block-size=SIZE’ Scale sizes by SIZE before printing them (*note Block size::). For example, ‘-BG’ prints sizes in units of 1,073,741,824 bytes. -‘--total’ - Print a grand total of all arguments after all arguments have been - processed. This can be used to find out the total disk size, usage - and available space of all listed devices. - - For the grand total line, ‘df’ prints ‘"total"’ into the SOURCE - column, and ‘"-"’ into the TARGET column. If there is no SOURCE - column (see ‘--output’), then ‘df’ prints ‘"total"’ into the TARGET - column, if present. - ‘-h’ ‘--human-readable’ Append a size letter to each size, such as ‘M’ for mebibytes. @@ -9041,7 +8818,7 @@ options::. The fields for block and inodes statistics are affected by the scaling options like ‘-h’ as usual. - The definition of the FIELD_LIST can even be splitted among several + The definition of the FIELD_LIST can even be split among several ‘--output’ uses. #!/bin/sh @@ -9085,6 +8862,19 @@ options::. results, but in general this option makes ‘df’ much slower, especially when there are many or very busy file systems. +‘--total’ + Print a grand total of all arguments after all arguments have been + processed. This can be used to find out the total disk size, usage + and available space of all listed devices. If no arguments are + specified df will try harder to elide file systems insignificant to + the total available space, by suppressing duplicate remote file + systems. + + For the grand total line, ‘df’ prints ‘"total"’ into the SOURCE + column, and ‘"-"’ into the TARGET column. If there is no SOURCE + column (see ‘--output’), then ‘df’ prints ‘"total"’ into the TARGET + column, if present. + ‘-t FSTYPE’ ‘--type=FSTYPE’ Limit the listing to file systems of type FSTYPE. Multiple file @@ -9123,6 +8913,9 @@ options::. ‘-v’ Ignored; for compatibility with System V versions of ‘df’. + ‘df’ is installed only on systems that have usable mount tables, so +portable scripts should not rely on its existence. + An exit status of zero indicates success, and a nonzero value indicates failure. Failure includes the case where no output is generated, so you can inspect the exit status of a command like ‘df -t @@ -9140,8 +8933,8 @@ File: coreutils.info, Node: du invocation, Next: stat invocation, Prev: df in 14.2 ‘du’: Estimate file space usage ==================================== -‘du’ reports the amount of disk space used by the specified files and -for each subdirectory (of directory arguments). Synopsis: +‘du’ reports the amount of disk space used by the set of specified files +and for each subdirectory (of directory arguments). Synopsis: du [OPTION]… [FILE]… @@ -9152,8 +8945,8 @@ are rounded up to the next higher unit. If two or more hard links point to the same file, only one of the hard links is counted. The FILE argument order affects which links are -counted, and changing the argument order may change the numbers that -‘du’ outputs. +counted, and changing the argument order may change the numbers and +entries that ‘du’ outputs. The program accepts the following options. Also see *note Common options::. @@ -9464,6 +9257,17 @@ stat …’) to avoid interference from the shell. Print the information in terse form, suitable for parsing by other programs. + The output of the following commands are identical and the + ‘--format’ also identifies the items printed (in fuller form) in + the default format. Note the format string would include another + ‘%C’ at the end with an active SELinux security context. + $ stat --format="%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o" ... + $ stat --terse ... + + The same illustrating terse output in ‘--file-system’ mode: + $ stat -f --format="%n %i %l %t %s %S %b %f %a %c %d" ... + $ stat -f --terse ... + The valid FORMAT directives for files with ‘--format’ and ‘--printf’ are: @@ -9561,21 +9365,49 @@ indicates failure. File: coreutils.info, Node: sync invocation, Next: truncate invocation, Prev: stat invocation, Up: Disk usage -14.4 ‘sync’: Synchronize data on disk with memory -================================================= +14.4 ‘sync’: Synchronize cached writes to persistent storage +============================================================ + +‘sync’ synchronizes in memory files or file systems to persistent +storage. Synopsis: + + sync [OPTION] [FILE]… -‘sync’ writes any data buffered in memory out to disk. This can include -(but is not limited to) modified superblocks, modified inodes, and -delayed reads and writes. This must be implemented by the kernel; The -‘sync’ program does nothing but exercise the ‘sync’ system call. + ‘sync’ writes any data buffered in memory out to disk. This can +include (but is not limited to) modified superblocks, modified inodes, +and delayed reads and writes. This must be implemented by the kernel; +The ‘sync’ program does nothing but exercise the ‘sync’, ‘syncfs’, +‘fsync’, and ‘fdatasync’ system calls. The kernel keeps data in memory to avoid doing (relatively slow) disk reads and writes. This improves performance, but if the computer crashes, data may be lost or the file system corrupted as a result. The -‘sync’ command ensures everything in memory is written to disk. +‘sync’ command instructs the kernel to write data in memory to +persistent storage. - Any arguments are ignored, except for a lone ‘--help’ or ‘--version’ -(*note Common options::). + If any argument is specified then only those files will be +synchronized using the fsync(2) syscall by default. + + If at least one file is specified, it is possible to change the +synchronization method with the following options. Also see *note +Common options::. + +‘-d’ +‘--data’ + Use fdatasync(2) to sync only the data for the file, and any + metadata required to maintain file system consistency. + +‘-f’ +‘--file-system’ + Synchronize all the I/O waiting for the file systems that contain + the file, using the syscall syncfs(2). Note you would usually + _not_ specify this option if passing a device node like ‘/dev/sda’ + for example, as that would sync the containing file system rather + than the referenced one. Note also that depending on the system, + passing individual device nodes or files may have different sync + characteristics than using no arguments. I.e., arguments passed to + fsync(2) may provide greater guarantees through write barriers, + than a global sync(2) used when no arguments are provided. An exit status of zero indicates success, and a nonzero value indicates failure. @@ -9627,7 +9459,7 @@ options::. and so on for ‘T’, ‘P’, ‘E’, ‘Z’, and ‘Y’. SIZE may also be prefixed by one of the following to adjust the - size of each FILE based on their current size: + size of each FILE based on its current size: ‘+’ => extend by ‘-’ => reduce by ‘<’ => at most @@ -10394,9 +10226,11 @@ send some data down a pipe, but also to save a copy. Synopsis: a file being written to already exists, the data it previously contained is overwritten unless the ‘-a’ option is used. - A FILE of ‘-’ causes ‘tee’ to send another copy of input to standard -output, but this is typically not that useful as the copies are -interleaved. + In previous versions of GNU coreutils (v5.3.0 - v8.23), a FILE of ‘-’ +caused ‘tee’ to send another copy of input to standard output. However, +as the interleaved output was not very useful, ‘tee’ now conforms to +POSIX which explicitly mandates it to treat ‘-’ as a file with such +name. The program accepts the following options. Also see *note Common options::. @@ -10410,6 +10244,28 @@ options::. ‘--ignore-interrupts’ Ignore interrupt signals. +‘-p’ +‘--output-error[=MODE]’ + Select the behavior with errors on the outputs, where MODE is one + of the following: + + ‘warn’ + Warn on error opening or writing any output, including pipes. + Writing is continued to still open files/pipes. Exit status + indicates failure if any output has an error. + + ‘warn-nopipe’ + Warn on error opening or writing any output, except pipes. + Writing is continued to still open files/pipes. Exit status + indicates failure if any non pipe output had an error. This + is the default MODE when not specified. + + ‘exit’ + Exit on error opening or writing any output, including pipes. + + ‘exit-nopipe’ + Exit on error opening or writing any output, except pipes. + The ‘tee’ command is useful when you happen to be transferring a large amount of data and also want to summarize that data without reading it a second time. For example, when you are downloading a DVD @@ -11010,6 +10866,10 @@ description. On non-POSIX systems, those or other settings also may not be available, but it’s not feasible to document all the variations: just try it and see. + ‘stty’ is installed only on platforms with the POSIX terminal +interface, so portable scripts should not rely on its existence on +non-POSIX platforms. + An exit status of zero indicates success, and a nonzero value indicates failure. @@ -11256,6 +11116,12 @@ File: coreutils.info, Node: Local, Next: Combination, Prev: Output, Up: stty line as indicated by the ‘echoprt’ and ‘echoe’ settings, instead of by the ‘echoctl’ and ‘echok’ settings. Non-POSIX. May be negated. +‘extproc’ + Enable ‘LINEMODE’, which is used to avoid echoing each character + over high latency links. See also Internet RFC 1116 + (ftp://ftp.rfc-editor.org/in-notes/rfc1116.txt). Non-POSIX. May + be negated. + File: coreutils.info, Node: Combination, Next: Characters, Prev: Local, Up: stty invocation @@ -11284,11 +11150,11 @@ Combination settings: ‘sane’ Same as: - cread -ignbrk brkint -inlcr -igncr icrnl -ixoff - -iuclc -ixany imaxbel opost -olcuc -ocrnl onlcr - -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0 vt0 - ff0 isig icanon iexten echo echoe echok -echonl - -noflsh -xcase -tostop -echoprt echoctl echoke + cread -ignbrk brkint -inlcr -igncr icrnl + icanon iexten echo echoe echok -echonl -noflsh + -ixoff -iutf8 -iuclc -ixany imaxbel -xcase -olcuc -ocrnl + opost -ofill onlcr -onocr -onlret nl0 cr0 tab0 bs0 vt0 ff0 + isig -tostop -ofdel -echoprt echoctl echoke -extproc and also sets all special characters to their default values. @@ -11302,8 +11168,8 @@ Combination settings: Same as: -ignbrk -brkint -ignpar -parmrk -inpck -istrip - -inlcr -igncr -icrnl -ixon -ixoff -iuclc -ixany - -imaxbel -opost -isig -icanon -xcase min 1 time 0 + -inlcr -igncr -icrnl -ixon -ixoff -icanon -opost + -isig -iuclc -ixany -imaxbel -xcase min 1 time 0 May be negated. If negated, same as ‘cooked’. @@ -11374,9 +11240,15 @@ like any other, namely to set that special character to <U>.) ‘eol2’ Alternate character to end the line. Non-POSIX. +‘discard’ + Alternate character to toggle discarding of output. Non-POSIX. + ‘swtch’ Switch to a different shell layer. Non-POSIX. +‘status’ + Send an info signal. Not currently supported on Linux. Non-POSIX. + ‘start’ Restart the output after stopping it. @@ -11683,6 +11555,10 @@ is ‘/var/log/wtmp’. The only options are ‘--help’ and ‘--version’. *Note Common options::. + The ‘users’ command is installed only on platforms with the POSIX +‘<utmpx.h>’ include file or equivalent, so portable scripts should not +rely on its existence on non-POSIX platforms. + An exit status of zero indicates success, and a nonzero value indicates failure. @@ -11787,6 +11663,10 @@ options::. ‘-’ disallowing ‘write’ messages ‘?’ cannot find terminal device + The ‘who’ command is installed only on platforms with the POSIX +‘<utmpx.h>’ include file or equivalent, so portable scripts should not +rely on its existence on non-POSIX platforms. + An exit status of zero indicates success, and a nonzero value indicates failure. @@ -12365,6 +12245,9 @@ File: coreutils.info, Node: arch invocation, Next: nproc invocation, Prev: da The program accepts the *note Common options:: only. + ‘arch’ is not installed by default, so portable scripts should not +rely on its existence. + An exit status of zero indicates success, and a nonzero value indicates failure. @@ -12495,6 +12378,10 @@ name. Synopsis: The only options are ‘--help’ and ‘--version’. *Note Common options::. + ‘hostname’ is not installed by default, and other packages also +supply a ‘hostname’ command, so portable scripts should not rely on its +existence or on the exact behavior documented above. + An exit status of zero indicates success, and a nonzero value indicates failure. @@ -12516,6 +12403,9 @@ hexadecimal. This command accepts no arguments. The only options are On that system, the 32-bit quantity happens to be closely related to the system’s Internet address, but that isn’t always the case. + ‘hostid’ is installed only on systems that have the ‘gethostid’ +function, so portable scripts should not rely on its existence. + An exit status of zero indicates success, and a nonzero value indicates failure. @@ -12547,6 +12437,14 @@ also include processes in the uninterruptible sleep state (that is, those processes which are waiting for disk I/O). The Linux kernel includes uninterruptible processes. + ‘uptime’ is installed only on platforms with infrastructure for +obtaining the boot time, and other packages also supply an ‘uptime’ +command, so portable scripts should not rely on its existence or on the +exact behavior documented above. + + An exit status of zero indicates success, and a nonzero value +indicates failure. + File: coreutils.info, Node: SELinux context, Next: Modified command invocation, Prev: System context, Up: Top @@ -12719,22 +12617,28 @@ File: coreutils.info, Node: chroot invocation, Next: env invocation, Up: Modi ============================================================ ‘chroot’ runs a command with a specified root directory. On many -systems, only the super-user can do this.(1) Synopses: +systems, only the super-user can do this.(1). Synopses: chroot OPTION NEWROOT [COMMAND [ARGS]…] chroot OPTION Ordinarily, file names are looked up starting at the root of the directory structure, i.e., ‘/’. ‘chroot’ changes the root to the -directory NEWROOT (which must exist) and then runs COMMAND with optional -ARGS. If COMMAND is not specified, the default is the value of the -‘SHELL’ environment variable or ‘/bin/sh’ if not set, invoked with the -‘-i’ option. COMMAND must not be a special built-in utility (*note -Special built-in utilities::). +directory NEWROOT (which must exist), then changes the working directory +to ‘/’, and finally runs COMMAND with optional ARGS. If COMMAND is not +specified, the default is the value of the ‘SHELL’ environment variable +or ‘/bin/sh’ if not set, invoked with the ‘-i’ option. COMMAND must not +be a special built-in utility (*note Special built-in utilities::). The program accepts the following options. Also see *note Common options::. Options must precede operands. +‘--groups=GROUPS’ + Use this option to override the supplementary GROUPS to be used by + the new process. The items in the list (names or numeric IDs) must + be separated by commas. Use ‘--groups=''’ to disable the + supplementary group look-up implicit in the ‘--userspec’ option. + ‘--userspec=USER[:GROUP]’ By default, COMMAND is run with the same credentials as the invoking process. Use this option to run it as a different USER @@ -12742,11 +12646,13 @@ options::. Options must precede operands. the supplementary groups are set according to the system defined list for that user, unless overridden with the ‘--groups’ option. -‘--groups=GROUPS’ - Use this option to override the supplementary GROUPS to be used by - the new process. The items in the list (names or numeric IDs) must - be separated by commas. Use ‘--groups=''’ to disable the - supplementary group look-up implicit in the ‘--userspec’ option. +‘--skip-chdir’ + Use this option to not change the working directory to ‘/’ after + changing the root directory to NEWROOT, i.e., inside the chroot. + This option is only permitted when NEWROOT is the old ‘/’ + directory, and therefore is mostly useful together with the + ‘--groups’ and ‘--userspec’ options to retain the previous working + directory. The user and group name look-up performed by the ‘--userspec’ and ‘--groups’ options, is done both outside and inside the chroot, with @@ -12779,6 +12685,9 @@ required positions under your intended new root directory. Finally, if the executable requires any other files (e.g., data, state, device files), copy them into place, too. + ‘chroot’ is installed only on systems that have the ‘chroot’ +function, so portable scripts should not rely on its existence. + Exit status: 125 if ‘chroot’ itself fails @@ -12792,7 +12701,9 @@ files), copy them into place, too. certain regular users to use the ‘chroot’ system call, and hence to run this program. Also, on Cygwin, anyone can run the ‘chroot’ command, because the underlying function is non-privileged due to lack of support -in MS-Windows. +in MS-Windows. Furthermore, the ‘chroot’ command avoids the ‘chroot’ +system call when NEWROOT is identical to the old ‘/’ directory for +consistency with systems where this is allowed for non-privileged users. File: coreutils.info, Node: env invocation, Next: nice invocation, Prev: chroot invocation, Up: Modified command invocation @@ -12929,7 +12840,7 @@ lets applications determine the order in which threads are scheduled to run. Unlike a priority, a niceness is merely advice to the scheduler, which the scheduler is free to ignore. Also, as a point of terminology, POSIX defines the behavior of ‘nice’ in terms of a "nice value", which -is the nonnegative difference between a niceness and the minimum +is the non-negative difference between a niceness and the minimum niceness. Though ‘nice’ conforms to POSIX, its documentation and diagnostics use the term “niceness” for compatibility with historical practice. @@ -12958,6 +12869,10 @@ options::. Options must precede operands. For compatibility ‘nice’ also supports an obsolete option syntax ‘-ADJUSTMENT’. New scripts should use ‘-n ADJUSTMENT’ instead. + ‘nice’ is installed only on systems that have the POSIX ‘setpriority’ +function, so portable scripts should not rely on its existence on +non-POSIX platforms. + Exit status: 0 if no COMMAND is specified and the niceness is output @@ -13016,10 +12931,12 @@ Synopsis: nohup COMMAND [ARG]… - If standard input is a terminal, it is redirected from ‘/dev/null’ so -that terminal sessions do not mistakenly consider the terminal to be -used by the command. This is a GNU extension; programs intended to be -portable to non-GNU hosts should use ‘nohup COMMAND [ARG]… </dev/null’ + If standard input is a terminal, redirect it so that terminal +sessions do not mistakenly consider the terminal to be used by the +command. Make the substitute file descriptor unreadable, so that +commands that mistakenly attempt to read from standard input can report +an error. This redirection is a GNU extension; programs intended to be +portable to non-GNU hosts can use ‘nohup COMMAND [ARG]… 0>/dev/null’ instead. If standard output is a terminal, the command’s standard output is @@ -13125,6 +13042,10 @@ options::. ‘G’ => 1024*1024*1024 (GibiBytes) and so on for ‘T’, ‘P’, ‘E’, ‘Z’, and ‘Y’. + ‘stdbuf’ is installed only on platforms that use the Executable and +Linkable Format (ELF) and support the ‘constructor’ attribute, so +portable scripts should not rely on its existence. + Exit status: 125 if ‘stdbuf’ itself fails @@ -13152,7 +13073,7 @@ options::. Options must precede operands. ‘--preserve-status’ Return the exit status of the managed COMMAND on timeout, rather than a specific exit status indicating a timeout. This is useful - if the managed COMMAND supports running for an indeterminite amount + if the managed COMMAND supports running for an indeterminate amount of time. ‘--foreground’ @@ -13166,7 +13087,10 @@ options::. Options must precede operands. from the terminal (like Ctrl-C for example) Note in this mode of operation, any children of COMMAND will not be - timed out. + timed out. Also SIGCONT will not be sent to COMMAND, as it’s + generally not needed with foreground processes, and can cause + intermittent signal delivery issues with programs that are monitors + themselves (like GDB for example). ‘-k DURATION’ ‘--kill-after=DURATION’ @@ -13336,10 +13260,11 @@ These programs do numerically-related operations. * Menu: * factor invocation:: Show factors of numbers. +* numfmt invocation:: Reformat numbers. * seq invocation:: Print sequences of numbers. -File: coreutils.info, Node: factor invocation, Next: seq invocation, Up: Numeric operations +File: coreutils.info, Node: factor invocation, Next: numfmt invocation, Up: Numeric operations 26.1 ‘factor’: Print prime factors ================================== @@ -13390,9 +13315,301 @@ algorithm which is designed for factoring smaller numbers. indicates failure. -File: coreutils.info, Node: seq invocation, Prev: factor invocation, Up: Numeric operations +File: coreutils.info, Node: numfmt invocation, Next: seq invocation, Prev: factor invocation, Up: Numeric operations + +26.2 ‘numfmt’: Reformat numbers +=============================== + +‘numfmt’ reads numbers in various representations and reformats them as +requested. The most common usage is converting numbers to/from _human_ +representation (e.g. ‘4G’ ↦ ‘4,000,000,000’). + + numfmt [OPTION]… [NUMBER] + + ‘numfmt’ converts each NUMBER on the command-line according to the +specified options (see below). If no NUMBERs are given, it reads +numbers from standard input. ‘numfmt’ can optionally extract numbers +from specific columns, maintaining proper line padding and alignment. + + An exit status of zero indicates success, and a nonzero value +indicates failure. + + See ‘--invalid’ for additional information regarding exit status. + +26.2.1 General options +---------------------- + +The program accepts the following options. Also see *note Common +options::. + +‘--debug’ + Print (to standard error) warning messages about possible erroneous + usage. + +‘-d D’ +‘--delimiter=D’ + Use the character D as input field separator (default: whitespace). + _Note_: Using non-default delimiter turns off automatic padding. + +‘--field=FIELDS’ + Convert the number in input field FIELDS (default: 1). FIELDS + supports ‘cut’ style field ranges: -26.2 ‘seq’: Print numeric sequences + N N'th field, counted from 1 + N- from N'th field, to end of line + N-M from N'th to M'th field (inclusive) + -M from first to M'th field (inclusive) + - all fields + +‘--format=FORMAT’ + Use printf-style floating FORMAT string. The FORMAT string must + contain one ‘%f’ directive, optionally with ‘'’, ‘-’, ‘0’, width or + precision modifiers. The ‘'’ modifier will enable ‘--grouping’, + the ‘-’ modifier will enable left-aligned ‘--padding’ and the width + modifier will enable right-aligned ‘--padding’. The ‘0’ width + modifier (without the ‘-’ modifier) will generate leading zeros on + the number, up to the specified width. A precision specification + like ‘%.1f’ will override the precision determined from the input + data or set due to ‘--to’ option auto scaling. + +‘--from=UNIT’ + Auto-scales input numbers according to UNIT. See UNITS below. The + default is no scaling, meaning suffixes (e.g. ‘M’, ‘G’) will + trigger an error. + +‘--from-unit=N’ + Specify the input unit size (instead of the default 1). Use this + option when the input numbers represent other units (e.g. if the + input number ‘10’ represents 10 units of 512 bytes, use + ‘--from-unit=512’). Suffixes are handled as with ‘--from=auto’. + +‘--grouping’ + Group digits in output numbers according to the current locale’s + grouping rules (e.g _Thousands Separator_ character, commonly ‘.’ + (dot) or ‘,’ comma). This option has no effect in ‘POSIX/C’ + locale. + +‘--header[=N]’ + Print the first N (default: 1) lines without any conversion. + +‘--invalid=MODE’ + The default action on input errors is to exit immediately with + status code 2. ‘--invalid=‘abort’’ explicitly specifies this + default mode. With a MODE of ‘fail’, print a warning for _each_ + conversion error, and exit with status 2. With a MODE of ‘warn’, + exit with status 0, even in the presence of conversion errors, and + with a MODE of ‘ignore’ do not even print diagnostics. + +‘--padding=N’ + Pad the output numbers to N characters, by adding spaces. If N is + a positive number, numbers will be right-aligned. If N is a + negative number, numbers will be left-aligned. By default, numbers + are automatically aligned based on the input line’s width (only + with the default delimiter). + +‘--round=METHOD’ + When converting number representations, round the number according + to METHOD, which can be ‘up’, ‘down’, ‘from-zero’ (the default), + ‘towards-zero’, ‘nearest’. + +‘--suffix=SUFFIX’ + Add ‘SUFFIX’ to the output numbers, and accept optional ‘SUFFIX’ in + input numbers. + +‘--to=UNIT’ + Auto-scales output numbers according to UNIT. See _Units_ below. + The default is no scaling, meaning all the digits of the number are + printed. + +‘--to-unit=N’ + Specify the output unit size (instead of the default 1). Use this + option when the output numbers represent other units (e.g. to + represent ‘4,000,000’ bytes in blocks of 1KB, use ‘--to=si + --to-unit=1000’). Suffixes are handled as with ‘--from=auto’. + +26.2.2 Possible UNITs: +---------------------- + +The following are the possible UNIT options with ‘--from=UNITS’ and +‘--to=UNITS’: + +NONE + No scaling is performed. For input numbers, no suffixes are + accepted, and any trailing characters following the number will + trigger an error. For output numbers, all digits of the numbers + will be printed. + +SI + Auto-scale numbers according to the _International System of Units + (SI)_ standard. For input numbers, accept one of the following + suffixes. For output numbers, values larger than 1000 will be + rounded, and printed with one of the following suffixes: + + ‘K’ => 1000^1 = 10^3 (Kilo) + ‘M’ => 1000^2 = 10^6 (Mega) + ‘G’ => 1000^3 = 10^9 (Giga) + ‘T’ => 1000^4 = 10^{12} (Tera) + ‘P’ => 1000^5 = 10^{15} (Peta) + ‘E’ => 1000^6 = 10^{18} (Exa) + ‘Z’ => 1000^7 = 10^{21} (Zetta) + ‘Y’ => 1000^8 = 10^{24} (Yotta) + +IEC + Auto-scale numbers according to the _International Electrotechnical + Commission (IEC)_ standard. For input numbers, accept one of the + following suffixes. For output numbers, values larger than 1024 + will be rounded, and printed with one of the following suffixes: + + ‘K’ => 1024^1 = 2^{10} (Kibi) + ‘M’ => 1024^2 = 2^{20} (Mebi) + ‘G’ => 1024^3 = 2^{30} (Gibi) + ‘T’ => 1024^4 = 2^{40} (Tebi) + ‘P’ => 1024^5 = 2^{50} (Pebi) + ‘E’ => 1024^6 = 2^{60} (Exbi) + ‘Z’ => 1024^7 = 2^{70} (Zebi) + ‘Y’ => 1024^8 = 2^{80} (Yobi) + + The ‘iec’ option uses a single letter suffix (e.g. ‘G’), which is + not fully standard, as the _iec_ standard recommends a two-letter + symbol (e.g ‘Gi’) - but in practice, this method common. Compare + with the ‘iec-i’ option. + +IEC-I + Auto-scale numbers according to the _International Electrotechnical + Commission (IEC)_ standard. For input numbers, accept one of the + following suffixes. For output numbers, values larger than 1024 + will be rounded, and printed with one of the following suffixes: + + ‘Ki’ => 1024^1 = 2^{10} (Kibi) + ‘Mi’ => 1024^2 = 2^{20} (Mebi) + ‘Gi’ => 1024^3 = 2^{30} (Gibi) + ‘Ti’ => 1024^4 = 2^{40} (Tebi) + ‘Pi’ => 1024^5 = 2^{50} (Pebi) + ‘Ei’ => 1024^6 = 2^{60} (Exbi) + ‘Zi’ => 1024^7 = 2^{70} (Zebi) + ‘Yi’ => 1024^8 = 2^{80} (Yobi) + + The ‘iec-i’ option uses a two-letter suffix symbol (e.g. ‘Gi’), as + the _iec_ standard recommends, but this is not always common in + practice. Compare with the ‘iec’ option. + +AUTO + ‘auto’ can only be used with ‘--from’. With this method, numbers + with ‘K’,‘M’,‘G’,‘T’,‘P’,‘E’,‘Z’,‘Y’ suffixes are interpreted as + _SI_ values, and numbers with ‘Ki’, + ‘Mi’,‘Gi’,‘Ti’,‘Pi’,‘Ei’,‘Zi’,‘Yi’ suffixes are interpreted as + _IEC_ values. + +26.2.3 Examples of using ‘numfmt’ +--------------------------------- + +Converting a single number from/to _human_ representation: + $ numfmt --to=si 500000 + 500K + + $ numfmt --to=iec 500000 + 489K + + $ numfmt --to=iec-i 500000 + 489Ki + + $ numfmt --from=si 1M + 1000000 + + $ numfmt --from=iec 1M + 1048576 + + # with '--from=auto', M=Mega, Mi=Mebi + $ numfmt --from=auto 1M + 1000000 + $ numfmt --from=auto 1Mi + 1048576 + + Converting from ‘SI’ to ‘IEC’ scales (e.g. when a harddisk capacity +is advertised as ‘1TB’, while checking the drive’s capacity gives lower +values): + + $ numfmt --from=si --to=iec 1T + 932G + + Converting a single field from an input file / piped input (these +contrived examples are for demonstration purposes only, as both ‘ls’ and +‘df’ support the ‘--human-readable’ option to output sizes in +human-readable format): + + # Third field (file size) will be shown in SI representation + $ ls -log | numfmt --field 3 --header --to=si | head -n4 + -rw-r--r-- 1 94K Aug 23 2011 ABOUT-NLS + -rw-r--r-- 1 3.7K Jan 7 16:15 AUTHORS + -rw-r--r-- 1 36K Jun 1 2011 COPYING + -rw-r--r-- 1 0 Jan 7 15:15 ChangeLog + + # Second field (size) will be shown in IEC representation + $ df --block-size=1 | numfmt --field 2 --header --to=iec | head -n4 + File system 1B-blocks Used Available Use% Mounted on + rootfs 132G 104741408 26554036 80% / + tmpfs 794M 7580 804960 1% /run/shm + /dev/sdb1 694G 651424756 46074696 94% /home + + Output can be tweaked using ‘--padding’ or ‘--format’: + + # Pad to 10 characters, right-aligned + $ du -s * | numfmt --to=si --padding=10 + 2.5K config.log + 108 config.status + 1.7K configure + 20 configure.ac + + # Pad to 10 characters, left-aligned + $ du -s * | numfmt --to=si --padding=-10 + 2.5K config.log + 108 config.status + 1.7K configure + 20 configure.ac + + # Pad to 10 characters, left-aligned, using 'format' + $ du -s * | numfmt --to=si --format="%10f" + 2.5K config.log + 108 config.status + 1.7K configure + 20 configure.ac + + # Pad to 10 characters, left-aligned, using 'format' + $ du -s * | numfmt --to=si --padding="%-10f" + 2.5K config.log + 108 config.status + 1.7K configure + 20 configure.ac + + With locales that support grouping digits, using ‘--grouping’ or +‘--format’ enables grouping. In ‘POSIX’ locale, grouping is silently +ignored: + + $ LC_ALL=C numfmt --from=iec --grouping 2G + 2147483648 + + $ LC_ALL=en_US.utf8 numfmt --from=iec --grouping 2G + 2,147,483,648 + + $ LC_ALL=ta_IN numfmt --from=iec --grouping 2G + 2,14,74,83,648 + + $ LC_ALL=C ./src/numfmt --from=iec --format="==%'15f==" 2G + == 2147483648== + + $ LC_ALL=en_US.utf8 ./src/numfmt --from=iec --format="==%'15f==" 2G + == 2,147,483,648== + + $ LC_ALL=en_US.utf8 ./src/numfmt --from=iec --format="==%'-15f==" 2G + ==2,147,483,648 == + + $ LC_ALL=ta_IN ./src/numfmt --from=iec --format="==%'15f==" 2G + == 2,14,74,83,648== + + +File: coreutils.info, Node: seq invocation, Prev: numfmt invocation, Up: Numeric operations + +26.3 ‘seq’: Print numeric sequences =================================== ‘seq’ prints a sequence of numbers to standard output. Synopses: @@ -15548,7 +15765,7 @@ Index * ‘-’, removing files beginning with: rm invocation. (line 99) * --: Common options. (line 43) * --across: pr invocation. (line 62) -* --additional-suffix: split invocation. (line 121) +* --additional-suffix: split invocation. (line 128) * --address-radix: od invocation. (line 36) * --adjustment: nice invocation. (line 51) * --all: unexpand invocation. (line 37) @@ -15564,7 +15781,7 @@ Index * --almost-all: Which files are listed. (line 17) * --apparent-size: du invocation. (line 35) -* --append: tee invocation. (line 25) +* --append: tee invocation. (line 27) * --archive: cp invocation. (line 63) * --attributes-only: cp invocation. (line 72) * --author: What information is listed. @@ -15576,9 +15793,9 @@ Index * --backup <4>: ln invocation. (line 80) * --batch-size: sort invocation. (line 255) * --before: tac invocation. (line 21) -* --binary: md5sum invocation. (line 37) +* --binary: md5sum invocation. (line 40) * --block-size: Block size. (line 121) -* --block-size <1>: df invocation. (line 48) +* --block-size <1>: df invocation. (line 54) * --block-size <2>: du invocation. (line 52) * --block-size=SIZE: Block size. (line 12) * --body-numbering: nl invocation. (line 45) @@ -15589,7 +15806,7 @@ Index * --bytes: fold invocation. (line 23) * --bytes <1>: head invocation. (line 24) * --bytes <2>: tail invocation. (line 32) -* --bytes <3>: split invocation. (line 40) +* --bytes <3>: split invocation. (line 41) * --bytes <4>: wc invocation. (line 43) * --bytes <5>: cut invocation. (line 26) * --bytes <6>: du invocation. (line 57) @@ -15609,16 +15826,16 @@ Index * --check <1>: sort invocation. (line 26) * --check-chars: uniq invocation. (line 135) * --classify: General output formatting. - (line 46) + (line 47) * --color: General output formatting. - (line 21) + (line 22) * --columns: pr invocation. (line 49) * --compare: install invocation. (line 46) * --complement: cut invocation. (line 82) * --compute: runcon invocation. (line 27) * --context: What information is listed. (line 255) -* --context <1>: cp invocation. (line 376) +* --context <1>: cp invocation. (line 378) * --context <2>: install invocation. (line 138) * --context <3>: mv invocation. (line 112) * --context <4>: mkdir invocation. (line 56) @@ -15631,13 +15848,14 @@ Index * --crown-margin: fmt invocation. (line 34) * --csh: dircolors invocation. (line 40) +* --data: sync invocation. (line 32) * --date: touch invocation. (line 86) * --date <1>: Options for date. (line 11) * --dead: who invocation. (line 43) * --debug: numfmt invocation. (line 29) * --decode: base64 invocation. (line 30) -* --delimiter: numfmt invocation. (line 34) -* --delimiter <1>: cut invocation. (line 62) +* --delimiter: cut invocation. (line 62) +* --delimiter <1>: numfmt invocation. (line 34) * --delimiters: paste invocation. (line 61) * --dereference: Which files are listed. (line 83) @@ -15665,7 +15883,7 @@ Index * --double-space: pr invocation. (line 74) * --dry-run: mktemp invocation. (line 97) * --echo: shuf invocation. (line 19) -* --elide-empty-files: split invocation. (line 126) +* --elide-empty-files: split invocation. (line 133) * --elide-empty-files <1>: csplit invocation. (line 93) * --endian: od invocation. (line 51) * --error: stdbuf invocation. (line 34) @@ -15673,7 +15891,7 @@ Index (line 11) * --exact: shred invocation. (line 143) * --exclude-from=FILE: du invocation. (line 250) -* --exclude-type: df invocation. (line 214) +* --exclude-type: df invocation. (line 223) * --exclude=PATTERN: du invocation. (line 255) * --expand-tabs: pr invocation. (line 98) * --field: numfmt invocation. (line 38) @@ -15682,12 +15900,13 @@ Index * --file: stty invocation. (line 31) * --file <1>: Options for date. (line 26) * --file-system: stat invocation. (line 28) +* --file-system <1>: sync invocation. (line 37) * --file-type: General output formatting. - (line 57) -* --files0-from=FILE: wc invocation. (line 62) + (line 58) +* --files0-from=FILE: wc invocation. (line 64) * --files0-from=FILE <1>: sort invocation. (line 217) * --files0-from=FILE <2>: du invocation. (line 79) -* --filter: split invocation. (line 60) +* --filter: split invocation. (line 62) * --first-line-number: pr invocation. (line 174) * --follow: tail invocation. (line 48) * --footer-numbering: nl invocation. (line 70) @@ -15699,22 +15918,22 @@ Index * --foreground: timeout invocation. (line 24) * --form-feed: pr invocation. (line 106) * --format: od invocation. (line 89) -* --format <1>: numfmt invocation. (line 41) -* --format <2>: What information is listed. +* --format <1>: What information is listed. (line 131) -* --format <3>: General output formatting. +* --format <2>: General output formatting. (line 10) +* --format <3>: General output formatting. + (line 16) * --format <4>: General output formatting. - (line 15) + (line 93) * --format <5>: General output formatting. - (line 92) -* --format <6>: General output formatting. - (line 102) + (line 103) +* --format <6>: numfmt invocation. (line 48) * --format=FORMAT: stat invocation. (line 34) * --format=FORMAT <1>: seq invocation. (line 26) -* --from: numfmt invocation. (line 50) -* --from <1>: chown invocation. (line 83) -* --from-unit: numfmt invocation. (line 55) +* --from: chown invocation. (line 83) +* --from <1>: numfmt invocation. (line 59) +* --from-unit: numfmt invocation. (line 64) * --full-time: What information is listed. (line 100) * --general-numeric-sort: sort invocation. (line 104) @@ -15724,16 +15943,16 @@ Index * --group <2>: id invocation. (line 29) * --group-directories-first: Which files are listed. (line 50) -* --grouping: numfmt invocation. (line 61) +* --grouping: numfmt invocation. (line 70) * --groups: id invocation. (line 33) -* --groups <1>: chroot invocation. (line 31) +* --groups <1>: chroot invocation. (line 24) * --hardware-platform: uname invocation. (line 35) * --head-count: shuf invocation. (line 31) -* --header: numfmt invocation. (line 67) -* --header <1>: pr invocation. (line 111) -* --header <2>: join invocation. (line 87) +* --header: pr invocation. (line 111) +* --header <1>: join invocation. (line 87) +* --header <2>: numfmt invocation. (line 76) * --header-numbering: nl invocation. (line 74) -* --header=N: numfmt invocation. (line 67) +* --header=N: numfmt invocation. (line 76) * --heading: who invocation. (line 47) * --help: Common options. (line 36) * --hide-control-chars: Formatting the file names. @@ -15744,7 +15963,7 @@ Index * --human-readable: Block size. (line 121) * --human-readable <1>: What information is listed. (line 116) -* --human-readable <2>: df invocation. (line 63) +* --human-readable <2>: df invocation. (line 59) * --human-readable <3>: du invocation. (line 96) * --ignore: nproc invocation. (line 25) * --ignore-backups: Which files are listed. @@ -15755,24 +15974,24 @@ Index * --ignore-environment: env invocation. (line 94) * --ignore-fail-on-non-empty: rmdir invocation. (line 17) * --ignore-garbage: base64 invocation. (line 36) -* --ignore-interrupts: tee invocation. (line 30) +* --ignore-interrupts: tee invocation. (line 32) * --ignore-leading-blanks: sort invocation. (line 78) * --ignore-nonprinting: sort invocation. (line 142) * --ignore=PATTERN: Which files are listed. (line 69) * --indent: pr invocation. (line 180) * --indicator-style: General output formatting. - (line 46) + (line 47) * --indicator-style <1>: General output formatting. - (line 57) + (line 58) * --indicator-style <2>: General output formatting. - (line 61) + (line 62) * --indicator-style <3>: General output formatting. - (line 97) + (line 98) * --initial: expand invocation. (line 33) * --inode: What information is listed. (line 123) -* --inodes: df invocation. (line 73) +* --inodes: df invocation. (line 69) * --inodes <1>: du invocation. (line 102) * --input: stdbuf invocation. (line 26) * --input-range: shuf invocation. (line 23) @@ -15780,7 +15999,7 @@ Index * --interactive <1>: mv invocation. (line 67) * --interactive <2>: rm invocation. (line 54) * --interactive <3>: ln invocation. (line 96) -* --invalid: numfmt invocation. (line 70) +* --invalid: numfmt invocation. (line 79) * --io-blocks: truncate invocation. (line 26) * --iso-8601[=TIMESPEC]: Options for date. (line 34) * --iterations=NUMBER: shred invocation. (line 106) @@ -15792,10 +16011,10 @@ Index * --kernel-version: uname invocation. (line 76) * --key: sort invocation. (line 230) * --kibibytes: General output formatting. - (line 80) -* --kill-after: timeout invocation. (line 38) + (line 81) +* --kill-after: timeout invocation. (line 41) * --length: pr invocation. (line 133) -* --line-bytes: split invocation. (line 54) +* --line-bytes: split invocation. (line 55) * --line-increment: nl invocation. (line 78) * --lines: head invocation. (line 39) * --lines <1>: tail invocation. (line 162) @@ -15804,7 +16023,7 @@ Index * --link: cp invocation. (line 144) * --literal: Formatting the file names. (line 17) -* --local: df invocation. (line 84) +* --local: df invocation. (line 80) * --logical: ln invocation. (line 100) * --logical <1>: realpath invocation. (line 30) * --logical <2>: pwd invocation. (line 15) @@ -15847,9 +16066,9 @@ Index * --no-preserve-root <4>: chcon invocation. (line 43) * --no-renumber: nl invocation. (line 101) * --no-symlinks: realpath invocation. (line 69) -* --no-sync: df invocation. (line 88) +* --no-sync: df invocation. (line 84) * --no-target-directory: Target directory. (line 15) -* --no-target-directory <1>: cp invocation. (line 347) +* --no-target-directory <1>: cp invocation. (line 349) * --no-target-directory <2>: install invocation. (line 129) * --no-target-directory <3>: mv invocation. (line 107) * --no-target-directory <4>: ln invocation. (line 173) @@ -15858,43 +16077,44 @@ Index * --null <1>: printenv invocation. (line 19) * --null <2>: env invocation. (line 82) * --number: cat invocation. (line 31) -* --number <1>: split invocation. (line 76) +* --number <1>: split invocation. (line 78) * --number-format: nl invocation. (line 90) * --number-lines: pr invocation. (line 153) * --number-nonblank: cat invocation. (line 20) * --number-separator: nl invocation. (line 105) * --number-width: nl invocation. (line 115) * --numeric-sort: sort invocation. (line 159) -* --numeric-suffixes: split invocation. (line 114) +* --numeric-suffixes: split invocation. (line 116) * --numeric-uid-gid: What information is listed. (line 222) * --omit-header: pr invocation. (line 210) * --omit-pagination: pr invocation. (line 220) -* --one-file-system: cp invocation. (line 370) +* --one-file-system: cp invocation. (line 372) * --one-file-system <1>: rm invocation. (line 65) * --one-file-system <2>: du invocation. (line 261) * --only-delimited: cut invocation. (line 70) * --operating-system: uname invocation. (line 57) * --output: sort invocation. (line 281) * --output <1>: shuf invocation. (line 36) -* --output <2>: df invocation. (line 95) +* --output <2>: df invocation. (line 91) * --output <3>: stdbuf invocation. (line 30) * --output-delimiter: cut invocation. (line 75) * --output-duplicates: od invocation. (line 149) +* --output-error: tee invocation. (line 36) * --output-tabs: pr invocation. (line 117) * --owner: install invocation. (line 91) -* --padding: numfmt invocation. (line 78) +* --padding: numfmt invocation. (line 87) * --pages=PAGE_RANGE: pr invocation. (line 39) * --page_width: pr invocation. (line 239) * --parallel: sort invocation. (line 351) -* --parents: cp invocation. (line 236) +* --parents: cp invocation. (line 238) * --parents <1>: mkdir invocation. (line 34) * --parents <2>: rmdir invocation. (line 22) * --physical: ln invocation. (line 125) * --physical <1>: realpath invocation. (line 35) * --physical <2>: pwd invocation. (line 22) * --pid: tail invocation. (line 130) -* --portability: df invocation. (line 152) +* --portability: df invocation. (line 148) * --portability <1>: pathchk invocation. (line 44) * --prefix: csplit invocation. (line 61) * --preserve: cp invocation. (line 168) @@ -15908,14 +16128,14 @@ Index * --preserve-timestamps: install invocation. (line 103) * --print-database: dircolors invocation. (line 45) -* --print-type: df invocation. (line 191) +* --print-type: df invocation. (line 200) * --printf=FORMAT: stat invocation. (line 43) * --process: who invocation. (line 65) * --processor: uname invocation. (line 50) * --quiet: head invocation. (line 46) * --quiet <1>: tail invocation. (line 170) * --quiet <2>: csplit invocation. (line 104) -* --quiet <3>: md5sum invocation. (line 68) +* --quiet <3>: md5sum invocation. (line 74) * --quiet <4>: readlink invocation. (line 56) * --quiet <5>: chown invocation. (line 79) * --quiet <6>: chgrp invocation. (line 30) @@ -15943,7 +16163,7 @@ Index * --real: id invocation. (line 42) * --recursive: Which files are listed. (line 90) -* --recursive <1>: cp invocation. (line 249) +* --recursive <1>: cp invocation. (line 251) * --recursive <2>: rm invocation. (line 93) * --recursive <3>: chown invocation. (line 143) * --recursive <4>: chgrp invocation. (line 70) @@ -15956,13 +16176,13 @@ Index * --reference <4>: truncate invocation. (line 30) * --reference <5>: Options for date. (line 59) * --reference <6>: chcon invocation. (line 30) -* --reflink[=WHEN]: cp invocation. (line 262) +* --reflink[=WHEN]: cp invocation. (line 264) * --regex: tac invocation. (line 26) * --relative: ln invocation. (line 134) * --relative-base: realpath invocation. (line 49) * --relative-to: realpath invocation. (line 44) * --remove: shred invocation. (line 123) -* --remove-destination: cp invocation. (line 288) +* --remove-destination: cp invocation. (line 290) * --remove=unlink: shred invocation. (line 123) * --remove=wipe: shred invocation. (line 123) * --remove=wipesync: shred invocation. (line 123) @@ -15976,12 +16196,12 @@ Index * --rfc-822: Options for date. (line 65) * --role: chcon invocation. (line 69) * --role <1>: runcon invocation. (line 35) -* --round: numfmt invocation. (line 85) -* --round=down: numfmt invocation. (line 85) -* --round=from-zero: numfmt invocation. (line 85) -* --round=nearest: numfmt invocation. (line 85) -* --round=towards-zero: numfmt invocation. (line 85) -* --round=up: numfmt invocation. (line 85) +* --round: numfmt invocation. (line 94) +* --round=down: numfmt invocation. (line 94) +* --round=from-zero: numfmt invocation. (line 94) +* --round=nearest: numfmt invocation. (line 94) +* --round=towards-zero: numfmt invocation. (line 94) +* --round=up: numfmt invocation. (line 94) * --runlevel: who invocation. (line 74) * --save: stty invocation. (line 41) * --section-delimiter: nl invocation. (line 63) @@ -15989,6 +16209,7 @@ Index * --separate-dirs: du invocation. (line 138) * --separator: tac invocation. (line 30) * --separator <1>: pr invocation. (line 192) +* --separator <2>: split invocation. (line 141) * --serial: paste invocation. (line 52) * --set: Options for date. (line 106) * --sh: dircolors invocation. @@ -16004,9 +16225,9 @@ Index * --si: Block size. (line 121) * --si <1>: What information is listed. (line 247) -* --si <2>: df invocation. (line 171) +* --si <2>: df invocation. (line 167) * --si <3>: du invocation. (line 145) -* --signal: timeout invocation. (line 45) +* --signal: timeout invocation. (line 48) * --silent: head invocation. (line 46) * --silent <1>: tail invocation. (line 170) * --silent <2>: csplit invocation. (line 104) @@ -16021,6 +16242,7 @@ Index * --size=BYTES: shred invocation. (line 117) * --skip-bytes: od invocation. (line 59) * --skip-chars: uniq invocation. (line 41) +* --skip-chdir: chroot invocation. (line 37) * --skip-fields: uniq invocation. (line 31) * --sleep-interval: tail invocation. (line 120) * --sort: sort invocation. (line 104) @@ -16034,49 +16256,49 @@ Index * --sort <8>: Sorting the output. (line 56) * --sort <9>: Sorting the output. (line 63) * --spaces: fold invocation. (line 29) -* --sparse=WHEN: cp invocation. (line 292) +* --sparse=WHEN: cp invocation. (line 294) * --split-only: fmt invocation. (line 47) * --squeeze-blank: cat invocation. (line 36) * --stable: sort invocation. (line 299) * --starting-line-number: nl invocation. (line 110) -* --status: md5sum invocation. (line 76) -* --strict: md5sum invocation. (line 109) +* --status: md5sum invocation. (line 82) +* --strict: md5sum invocation. (line 115) * --strings: od invocation. (line 80) * --strip: install invocation. (line 113) * --strip <1>: realpath invocation. (line 69) * --strip-program: install invocation. (line 116) -* --strip-trailing-slashes: cp invocation. (line 325) +* --strip-trailing-slashes: cp invocation. (line 327) * --strip-trailing-slashes <1>: mv invocation. (line 93) * --suffix: Backup options. (line 49) -* --suffix <1>: numfmt invocation. (line 90) -* --suffix <2>: csplit invocation. (line 65) -* --suffix <3>: cp invocation. (line 338) -* --suffix <4>: install invocation. (line 120) -* --suffix <5>: mv invocation. (line 98) -* --suffix <6>: ln invocation. (line 164) -* --suffix <7>: basename invocation. (line 38) -* --suffix <8>: mktemp invocation. (line 113) -* --suffix-length: split invocation. (line 106) +* --suffix <1>: csplit invocation. (line 65) +* --suffix <2>: cp invocation. (line 340) +* --suffix <3>: install invocation. (line 120) +* --suffix <4>: mv invocation. (line 98) +* --suffix <5>: ln invocation. (line 164) +* --suffix <6>: basename invocation. (line 38) +* --suffix <7>: mktemp invocation. (line 113) +* --suffix <8>: numfmt invocation. (line 99) +* --suffix-length: split invocation. (line 108) * --summarize: du invocation. (line 153) * --suppress-matched: csplit invocation. (line 87) * --symbolic: ln invocation. (line 158) -* --symbolic-link: cp invocation. (line 330) -* --sync: df invocation. (line 178) +* --symbolic-link: cp invocation. (line 332) +* --sync: df invocation. (line 174) * --sysv: sum invocation. (line 31) * --tabs: expand invocation. (line 22) * --tabs <1>: unexpand invocation. (line 24) * --tabsize: General output formatting. - (line 106) -* --tag: md5sum invocation. (line 85) + (line 107) +* --tag: md5sum invocation. (line 91) * --tagged-paragraph: fmt invocation. (line 40) * --target-directory: Target directory. (line 31) -* --target-directory <1>: cp invocation. (line 343) +* --target-directory <1>: cp invocation. (line 345) * --target-directory <2>: install invocation. (line 125) * --target-directory <3>: mv invocation. (line 103) * --target-directory <4>: ln invocation. (line 169) * --temporary-directory: sort invocation. (line 343) * --terse: stat invocation. (line 54) -* --text: md5sum invocation. (line 95) +* --text: md5sum invocation. (line 101) * --threshold: du invocation. (line 157) * --time: Sorting the output. (line 13) * --time <1>: Sorting the output. (line 42) @@ -16090,31 +16312,31 @@ Index (line 24) * --time-style <1>: du invocation. (line 212) * --tmpdir: mktemp invocation. (line 105) -* --to: numfmt invocation. (line 94) -* --to-unit: numfmt invocation. (line 99) -* --total: df invocation. (line 52) +* --to: numfmt invocation. (line 103) +* --to-unit: numfmt invocation. (line 108) +* --total: df invocation. (line 180) * --total <1>: du invocation. (line 61) * --traditional: od invocation. (line 199) -* --type: df invocation. (line 185) +* --type: df invocation. (line 194) * --type <1>: chcon invocation. (line 73) * --type <2>: runcon invocation. (line 39) -* --unbuffered: split invocation. (line 134) +* --unbuffered: split invocation. (line 148) * --uniform-spacing: fmt invocation. (line 53) * --unique: sort invocation. (line 359) * --unique <1>: uniq invocation. (line 129) * --universal: Options for date. (line 112) * --unset: env invocation. (line 88) -* --update: cp invocation. (line 352) +* --update: cp invocation. (line 354) * --update <1>: mv invocation. (line 80) * --user: id invocation. (line 47) * --user <1>: chcon invocation. (line 65) * --user <2>: runcon invocation. (line 31) -* --userspec: chroot invocation. (line 24) +* --userspec: chroot invocation. (line 30) * --utc: Options for date. (line 112) * --verbose: head invocation. (line 50) * --verbose <1>: tail invocation. (line 174) -* --verbose <2>: split invocation. (line 138) -* --verbose <3>: cp invocation. (line 366) +* --verbose <2>: split invocation. (line 152) +* --verbose <3>: cp invocation. (line 368) * --verbose <4>: install invocation. (line 134) * --verbose <5>: mv invocation. (line 90) * --verbose <6>: rm invocation. (line 97) @@ -16129,13 +16351,13 @@ Index * --verbose <15>: chcon invocation. (line 61) * --version: Common options. (line 40) * --version-sort: sort invocation. (line 176) -* --warn: md5sum invocation. (line 104) +* --warn: md5sum invocation. (line 110) * --width: od invocation. (line 156) * --width <1>: fmt invocation. (line 59) * --width <2>: pr invocation. (line 229) * --width <3>: fold invocation. (line 35) * --width <4>: General output formatting. - (line 117) + (line 118) * --words: wc invocation. (line 51) * --wrap: base64 invocation. (line 22) * --writable: who invocation. (line 94) @@ -16163,7 +16385,7 @@ Index * -A <1>: od invocation. (line 36) * -a: od invocation. (line 168) * -a <1>: pr invocation. (line 62) -* -a <2>: split invocation. (line 106) +* -a <2>: split invocation. (line 108) * -a <3>: join invocation. (line 72) * -a <4>: unexpand invocation. (line 37) * -a <5>: Which files are listed. @@ -16176,7 +16398,7 @@ Index * -a <9>: du invocation. (line 32) * -a <10>: Connectives for test. (line 12) -* -a <11>: tee invocation. (line 25) +* -a <11>: tee invocation. (line 27) * -a <12>: basename invocation. (line 32) * -a <13>: stty invocation. (line 26) * -a <14>: who invocation. (line 35) @@ -16187,9 +16409,9 @@ Index * -b <3>: nl invocation. (line 45) * -b <4>: od invocation. (line 171) * -b <5>: fold invocation. (line 23) -* -b <6>: split invocation. (line 40) +* -b <6>: split invocation. (line 41) * -b <7>: csplit invocation. (line 65) -* -b <8>: md5sum invocation. (line 37) +* -b <8>: md5sum invocation. (line 40) * -b <9>: sort invocation. (line 78) * -b <10>: cut invocation. (line 26) * -B: Which files are listed. @@ -16202,7 +16424,7 @@ Index * -b <14>: install invocation. (line 41) * -b <15>: mv invocation. (line 56) * -b <16>: ln invocation. (line 80) -* -B <1>: df invocation. (line 48) +* -B <1>: df invocation. (line 54) * -B <2>: du invocation. (line 52) * -b <17>: du invocation. (line 57) * -b <18>: File type tests. (line 10) @@ -16212,7 +16434,7 @@ Index * -c <2>: pr invocation. (line 68) * -c <3>: head invocation. (line 24) * -c <4>: tail invocation. (line 32) -* -C: split invocation. (line 54) +* -C: split invocation. (line 55) * -c <5>: wc invocation. (line 43) * -c <6>: sort invocation. (line 18) * -c <7>: sort invocation. (line 26) @@ -16221,7 +16443,7 @@ Index * -c <10>: cut invocation. (line 34) * -c <11>: Sorting the output. (line 13) * -C <1>: General output formatting. - (line 15) + (line 16) * -c <12>: dircolors invocation. (line 40) * -C <2>: install invocation. (line 46) @@ -16239,34 +16461,34 @@ Index * -d: nl invocation. (line 63) * -d <1>: od invocation. (line 178) * -d <2>: base64 invocation. (line 30) -* -d <3>: numfmt invocation. (line 34) -* -d <4>: pr invocation. (line 74) -* -d <5>: split invocation. (line 114) -* -d <6>: sort invocation. (line 86) -* -d <7>: uniq invocation. (line 63) +* -d <3>: pr invocation. (line 74) +* -d <4>: split invocation. (line 116) +* -d <5>: sort invocation. (line 86) +* -d <6>: uniq invocation. (line 63) * -D: uniq invocation. (line 69) -* -d <8>: cut invocation. (line 62) -* -d <9>: paste invocation. (line 61) -* -d <10>: Which files are listed. +* -d <7>: cut invocation. (line 62) +* -d <8>: paste invocation. (line 61) +* -d <9>: Which files are listed. (line 28) * -D <1>: What information is listed. (line 16) -* -d <11>: cp invocation. (line 109) +* -d <10>: cp invocation. (line 109) * -D <2>: install invocation. (line 60) -* -d <12>: install invocation. (line 67) -* -d <13>: rm invocation. (line 35) -* -d <14>: ln invocation. (line 86) -* -d <15>: touch invocation. (line 86) +* -d <11>: install invocation. (line 67) +* -d <12>: rm invocation. (line 35) +* -d <13>: ln invocation. (line 86) +* -d <14>: touch invocation. (line 86) * -D <3>: du invocation. (line 67) -* -d <16>: File type tests. (line 16) -* -d <17>: mktemp invocation. (line 85) -* -d <18>: who invocation. (line 43) -* -d <19>: Options for date. (line 11) +* -d <15>: File type tests. (line 16) +* -d <16>: mktemp invocation. (line 85) +* -d <17>: who invocation. (line 43) +* -d <18>: Options for date. (line 11) +* -d <19>: numfmt invocation. (line 34) * -d DEPTH: du invocation. (line 74) * -e: cat invocation. (line 23) * -E: cat invocation. (line 27) * -e <1>: pr invocation. (line 98) -* -e <2>: split invocation. (line 126) +* -e <2>: split invocation. (line 133) * -e <3>: join invocation. (line 83) * -e <4>: readlink invocation. (line 37) * -e <5>: echo invocation. (line 25) @@ -16290,7 +16512,7 @@ Index * -f <7>: cut invocation. (line 43) * -f <8>: Sorting the output. (line 20) * -F <2>: General output formatting. - (line 46) + (line 47) * -f <9>: cp invocation. (line 115) * -f <10>: mv invocation. (line 61) * -f <11>: rm invocation. (line 39) @@ -16338,8 +16560,8 @@ Index * -h <6>: chgrp invocation. (line 39) * -H <4>: chgrp invocation. (line 74) * -h <7>: touch invocation. (line 100) -* -h <8>: df invocation. (line 63) -* -H <5>: df invocation. (line 69) +* -h <8>: df invocation. (line 59) +* -H <5>: df invocation. (line 65) * -H <6>: du invocation. (line 92) * -h <9>: du invocation. (line 96) * -h <10>: File type tests. (line 23) @@ -16364,8 +16586,8 @@ Index * -i <12>: rm invocation. (line 43) * -I <1>: rm invocation. (line 48) * -i <13>: ln invocation. (line 96) -* -i <14>: df invocation. (line 73) -* -i <15>: tee invocation. (line 30) +* -i <14>: df invocation. (line 69) +* -i <15>: tee invocation. (line 32) * -i <16>: uname invocation. (line 35) * -i <17>: env invocation. (line 94) * -i <18>: stdbuf invocation. (line 26) @@ -16376,12 +16598,12 @@ Index * -k <1>: csplit invocation. (line 84) * -k <2>: sort invocation. (line 230) * -k <3>: General output formatting. - (line 80) -* -k <4>: df invocation. (line 78) + (line 81) +* -k <4>: df invocation. (line 74) * -k <5>: du invocation. (line 111) * -k <6>: Access permission tests. (line 12) -* -k <7>: timeout invocation. (line 38) +* -k <7>: timeout invocation. (line 41) * -L: Traversing symlinks. (line 22) * -l: nl invocation. (line 82) * -l <1>: od invocation. (line 187) @@ -16398,7 +16620,7 @@ Index * -L <4>: ln invocation. (line 100) * -L <5>: chown invocation. (line 151) * -L <6>: chgrp invocation. (line 79) -* -l <7>: df invocation. (line 84) +* -l <7>: df invocation. (line 80) * -L <7>: du invocation. (line 117) * -l <8>: du invocation. (line 123) * -L <8>: stat invocation. (line 22) @@ -16416,7 +16638,7 @@ Index * -m <2>: sort invocation. (line 32) * -M: sort invocation. (line 149) * -m <3>: General output formatting. - (line 92) + (line 93) * -m <4>: install invocation. (line 79) * -m <5>: mkdir invocation. (line 19) * -m <6>: mkfifo invocation. (line 21) @@ -16434,7 +16656,7 @@ Index * -N <1>: pr invocation. (line 174) * -n <3>: head invocation. (line 39) * -n <4>: tail invocation. (line 162) -* -n <5>: split invocation. (line 76) +* -n <5>: split invocation. (line 78) * -n <6>: csplit invocation. (line 79) * -n <7>: sort invocation. (line 159) * -n <8>: shuf invocation. (line 31) @@ -16475,7 +16697,7 @@ Index * -P: Traversing symlinks. (line 26) * -p: nl invocation. (line 101) * -p <1>: General output formatting. - (line 97) + (line 98) * -p <2>: dircolors invocation. (line 45) * -P <1>: cp invocation. (line 161) @@ -16486,16 +16708,17 @@ Index * -p <6>: rmdir invocation. (line 22) * -P <3>: chown invocation. (line 155) * -P <4>: chgrp invocation. (line 83) -* -P <5>: df invocation. (line 152) +* -P <5>: df invocation. (line 148) * -P <6>: du invocation. (line 133) * -p <7>: File type tests. (line 28) -* -p <8>: pathchk invocation. (line 27) +* -p <8>: tee invocation. (line 36) +* -p <9>: pathchk invocation. (line 27) * -P <7>: pathchk invocation. (line 40) -* -p <9>: mktemp invocation. (line 105) +* -p <10>: mktemp invocation. (line 105) * -P <8>: realpath invocation. (line 35) * -P <9>: pwd invocation. (line 22) -* -p <10>: who invocation. (line 65) -* -p <11>: uname invocation. (line 50) +* -p <11>: who invocation. (line 65) +* -p <12>: uname invocation. (line 50) * -P <10>: chcon invocation. (line 56) * -q: head invocation. (line 46) * -q <1>: tail invocation. (line 170) @@ -16517,8 +16740,8 @@ Index * -R <1>: Which files are listed. (line 90) * -r <5>: Sorting the output. (line 27) -* -R <2>: cp invocation. (line 249) -* -r <6>: cp invocation. (line 249) +* -R <2>: cp invocation. (line 251) +* -r <6>: cp invocation. (line 251) * -r <7>: rm invocation. (line 93) * -R <3>: rm invocation. (line 93) * -r <8>: ln invocation. (line 134) @@ -16557,8 +16780,8 @@ Index * -s <13>: What information is listed. (line 232) * -S <4>: Sorting the output. (line 32) -* -s <14>: cp invocation. (line 330) -* -S <5>: cp invocation. (line 338) +* -s <14>: cp invocation. (line 332) +* -S <5>: cp invocation. (line 340) * -s <15>: install invocation. (line 113) * -S <6>: install invocation. (line 120) * -S <7>: mv invocation. (line 98) @@ -16577,7 +16800,7 @@ Index * -s <24>: who invocation. (line 78) * -s <25>: Options for date. (line 106) * -s <26>: uname invocation. (line 65) -* -s <27>: timeout invocation. (line 45) +* -s <27>: timeout invocation. (line 48) * -s BYTES: shred invocation. (line 117) * -t: cat invocation. (line 40) * -T: cat invocation. (line 44) @@ -16585,40 +16808,41 @@ Index * -t <2>: fmt invocation. (line 40) * -t <3>: pr invocation. (line 210) * -T <1>: pr invocation. (line 220) -* -t <4>: md5sum invocation. (line 95) -* -t <5>: sort invocation. (line 322) +* -t <4>: split invocation. (line 141) +* -t <5>: md5sum invocation. (line 101) +* -t <6>: sort invocation. (line 322) * -T <2>: sort invocation. (line 343) -* -t <6>: expand invocation. (line 22) -* -t <7>: unexpand invocation. (line 24) -* -t <8>: Sorting the output. (line 36) +* -t <7>: expand invocation. (line 22) +* -t <8>: unexpand invocation. (line 24) +* -t <9>: Sorting the output. (line 36) * -T <3>: General output formatting. - (line 106) -* -t <9>: cp invocation. (line 343) -* -T <4>: cp invocation. (line 347) -* -t <10>: install invocation. (line 125) + (line 107) +* -t <10>: cp invocation. (line 345) +* -T <4>: cp invocation. (line 349) +* -t <11>: install invocation. (line 125) * -T <5>: install invocation. (line 129) -* -t <11>: mv invocation. (line 103) +* -t <12>: mv invocation. (line 103) * -T <6>: mv invocation. (line 107) -* -t <12>: ln invocation. (line 169) +* -t <13>: ln invocation. (line 169) * -T <7>: ln invocation. (line 173) -* -t <13>: df invocation. (line 185) -* -T <8>: df invocation. (line 191) -* -t <14>: du invocation. (line 157) -* -t <15>: stat invocation. (line 54) -* -t <16>: File type tests. (line 34) -* -t <17>: mktemp invocation. (line 121) -* -t <18>: who invocation. (line 82) +* -t <14>: df invocation. (line 194) +* -T <8>: df invocation. (line 200) +* -t <15>: du invocation. (line 157) +* -t <16>: stat invocation. (line 54) +* -t <17>: File type tests. (line 34) +* -t <18>: mktemp invocation. (line 121) +* -t <19>: who invocation. (line 82) * -T <9>: who invocation. (line 94) -* -t <19>: chcon invocation. (line 73) -* -t <20>: runcon invocation. (line 39) +* -t <20>: chcon invocation. (line 73) +* -t <21>: runcon invocation. (line 39) * -u: cat invocation. (line 47) * -u <1>: fmt invocation. (line 53) -* -u <2>: split invocation. (line 134) +* -u <2>: split invocation. (line 148) * -u <3>: sort invocation. (line 359) * -u <4>: uniq invocation. (line 129) * -u <5>: Sorting the output. (line 42) * -U: Sorting the output. (line 49) -* -u <6>: cp invocation. (line 352) +* -u <6>: cp invocation. (line 354) * -u <7>: mv invocation. (line 80) * -u <8>: shred invocation. (line 123) * -u <9>: Access permission tests. @@ -16638,7 +16862,7 @@ Index * -v <5>: tail invocation. (line 174) * -V: sort invocation. (line 176) * -v <6>: Sorting the output. (line 56) -* -v <7>: cp invocation. (line 366) +* -v <7>: cp invocation. (line 368) * -v <8>: install invocation. (line 134) * -v <9>: mv invocation. (line 90) * -v <10>: rm invocation. (line 97) @@ -16660,10 +16884,10 @@ Index * -W: pr invocation. (line 239) * -w <5>: fold invocation. (line 35) * -w <6>: wc invocation. (line 51) -* -w <7>: md5sum invocation. (line 104) +* -w <7>: md5sum invocation. (line 110) * -w <8>: uniq invocation. (line 135) * -w <9>: General output formatting. - (line 117) + (line 118) * -w <10>: Access permission tests. (line 21) * -w <11>: who invocation. (line 94) @@ -16671,10 +16895,10 @@ Index * -x: od invocation. (line 196) * -X: Sorting the output. (line 63) * -x <1>: General output formatting. - (line 102) -* -x <2>: cp invocation. (line 370) + (line 103) +* -x <2>: cp invocation. (line 372) * -x <3>: shred invocation. (line 143) -* -x <4>: df invocation. (line 214) +* -x <4>: df invocation. (line 223) * -x <5>: du invocation. (line 261) * -x <6>: Access permission tests. (line 24) @@ -16686,7 +16910,7 @@ Index * -z <4>: join invocation. (line 155) * -Z: What information is listed. (line 255) -* -Z <1>: cp invocation. (line 376) +* -Z <1>: cp invocation. (line 378) * -Z <2>: install invocation. (line 138) * -Z <3>: mv invocation. (line 112) * -z <5>: shred invocation. (line 154) @@ -16736,14 +16960,14 @@ Index * access permission tests: Access permission tests. (line 6) * access permissions, changing: chmod invocation. (line 6) -* access time: dd invocation. (line 246) +* access time: dd invocation. (line 253) * access time, changing: touch invocation. (line 78) * access time, printing or sorting files by: Sorting the output. (line 42) * access time, show the most recent: du invocation. (line 208) * across columns: pr invocation. (line 62) * across, listing files: General output formatting. - (line 102) + (line 103) * adding permissions: Setting Permissions. (line 35) * addition: Numeric expressions. (line 12) * ago in date strings: Relative items in date strings. @@ -16752,17 +16976,17 @@ Index * all repeated lines, outputting: uniq invocation. (line 69) * alnum: Character sets. (line 88) * alpha: Character sets. (line 90) -* alternate ebcdic, converting to: dd invocation. (line 96) +* alternate ebcdic, converting to: dd invocation. (line 103) * always color option: General output formatting. - (line 25) + (line 26) * always interactive option: rm invocation. (line 59) * am i: who invocation. (line 21) * am in date strings: Time of day items. (line 21) * and operator: Connectives for test. (line 12) * and operator <1>: Relations for expr. (line 17) -* append: dd invocation. (line 185) -* appending to the output file: dd invocation. (line 185) +* append: dd invocation. (line 192) +* appending to the output file: dd invocation. (line 192) * appropriate privileges: install invocation. (line 91) * appropriate privileges <1>: Setting the time. (line 6) * appropriate privileges <2>: hostname invocation. (line 6) @@ -16772,7 +16996,7 @@ Index * arch: arch invocation. (line 6) * arithmetic tests: Numeric tests. (line 6) * ASCII dump of files: od invocation. (line 6) -* ascii, converting to: dd invocation. (line 85) +* ascii, converting to: dd invocation. (line 92) * atime, changing: touch invocation. (line 78) * atime, printing or sorting files by: Sorting the output. (line 42) * atime, show the most recent: du invocation. (line 208) @@ -16781,8 +17005,7 @@ Index * authors of ‘parse_datetime’: Authors of parse_datetime. (line 6) * auto color option: General output formatting. - (line 24) -* automounter file systems: df invocation. (line 42) + (line 25) * b for block special file: mknod invocation. (line 31) * background jobs, stopping at terminal write: Local. (line 41) * backslash escapes: Character sets. (line 14) @@ -16817,15 +17040,15 @@ Index * Berry, K.: Introduction. (line 19) * Berry, K. <1>: Authors of parse_datetime. (line 19) -* binary: dd invocation. (line 263) -* binary I/O: dd invocation. (line 263) -* binary input files: md5sum invocation. (line 37) +* binary: dd invocation. (line 270) +* binary I/O: dd invocation. (line 270) +* binary input files: md5sum invocation. (line 40) * bind mount: rm invocation. (line 69) -* bind mount <1>: stat invocation. (line 123) +* bind mount <1>: stat invocation. (line 134) * blank: Character sets. (line 92) * blank lines, numbering: nl invocation. (line 82) * blanks, ignoring leading: sort invocation. (line 78) -* block (space-padding): dd invocation. (line 106) +* block (space-padding): dd invocation. (line 113) * block size: Block size. (line 6) * block size <1>: dd invocation. (line 34) * block size of conversion: dd invocation. (line 41) @@ -16843,12 +17066,12 @@ Index * breaks, ignoring: Input. (line 9) * brkint: Input. (line 12) * bs: dd invocation. (line 34) -* BSD output: md5sum invocation. (line 85) +* BSD output: md5sum invocation. (line 91) * BSD ‘sum’: sum invocation. (line 25) * BSD ‘tail’: tail invocation. (line 19) * BSD ‘touch’ compatibility: touch invocation. (line 96) * bsN: Output. (line 55) -* btrfs file system type: df invocation. (line 202) +* btrfs file system type: df invocation. (line 211) * bugs, reporting: Introduction. (line 12) * built-in shell commands, conflicts with: mknod invocation. (line 20) * built-in shell commands, conflicts with <1>: stat invocation. @@ -16869,13 +17092,13 @@ Index (line 31) * byte count: wc invocation. (line 6) * byte-swapping: od invocation. (line 51) -* byte-swapping <1>: dd invocation. (line 137) +* byte-swapping <1>: dd invocation. (line 144) * c for character special file: mknod invocation. (line 34) * C shell syntax for color setup: dircolors invocation. (line 40) * C-s/C-q flow control: Input. (line 40) * calendar date item: Calendar date items. (line 6) -* calling combined multi-call binary: coreutils invocation. +* calling combined multi-call program: Multi-call invocation. (line 6) * canonical file name: readlink invocation. (line 6) * canonical file name <1>: realpath invocation. (line 6) @@ -16887,8 +17110,8 @@ Index * cat: cat invocation. (line 6) * cbreak: Combination. (line 52) * cbs: dd invocation. (line 41) -* CD-ROM file system type: df invocation. (line 206) -* cdfs file system type: df invocation. (line 206) +* CD-ROM file system type: df invocation. (line 215) +* cdfs file system type: df invocation. (line 215) * cdtrdsr: Control. (line 44) * change or print terminal settings: stty invocation. (line 6) * change SELinux context: chcon invocation. (line 6) @@ -16926,13 +17149,13 @@ Index * chmod: chmod invocation. (line 6) * chown: chown invocation. (line 6) * chroot: chroot invocation. (line 6) -* cio: dd invocation. (line 193) +* cio: dd invocation. (line 200) * cksum: cksum invocation. (line 6) * clocal: Control. (line 38) * clock skew: Formatting file timestamps. (line 11) * clock skew <1>: touch invocation. (line 17) -* clone: cp invocation. (line 262) +* clone: cp invocation. (line 264) * cmspar: Control. (line 16) * cntrl: Character sets. (line 94) * color database, printing: dircolors invocation. @@ -16940,15 +17163,15 @@ Index * color setup: dircolors invocation. (line 6) * color, distinguishing file types with: General output formatting. - (line 21) + (line 22) * cols: Special. (line 27) * column to wrap data after: base64 invocation. (line 22) * COLUMNS: General output formatting. - (line 117) + (line 118) * COLUMNS <1>: Special. (line 30) * columns: Special. (line 27) * combination settings: Combination. (line 6) -* combined: coreutils invocation. +* combined: Multi-call invocation. (line 6) * combined date and time of day item: Combined date and time of day items. (line 6) @@ -16968,7 +17191,7 @@ Index * commands for SELinux context: SELinux context. (line 6) * commands for system context: System context. (line 6) * commas, outputting between files: General output formatting. - (line 92) + (line 93) * comments, in dates: General date syntax. (line 60) * common field, joining on: join invocation. (line 6) * common lines: comm invocation. (line 18) @@ -16977,7 +17200,7 @@ Index * comparing sorted files: comm invocation. (line 6) * comparison operators: Relations for expr. (line 22) * concatenate and write files: cat invocation. (line 6) -* concurrent I/O: dd invocation. (line 193) +* concurrent I/O: dd invocation. (line 200) * conditional executability: Conditional Executability. (line 6) * conditions: Conditions. (line 6) @@ -16998,8 +17221,8 @@ Index * context, system: System context. (line 6) * control characters, using ‘^C’: Local. (line 51) * control settings: Control. (line 6) -* controlling terminal: dd invocation. (line 251) -* conv: dd invocation. (line 79) +* controlling terminal: dd invocation. (line 258) +* conv: dd invocation. (line 86) * conversion block size: dd invocation. (line 41) * conversion specifiers, date: Date conversion specifiers. (line 6) @@ -17011,27 +17234,27 @@ Index * converting while copying a file: dd invocation. (line 6) * cooked: Combination. (line 37) * Coordinated Universal Time: Options for date. (line 112) -* copy on write: cp invocation. (line 262) +* copy on write: cp invocation. (line 264) * copying directories recursively: cp invocation. (line 96) -* copying directories recursively <1>: cp invocation. (line 249) +* copying directories recursively <1>: cp invocation. (line 251) * copying existing permissions: Copying Permissions. (line 6) * copying files: cat invocation. (line 6) * copying files and directories: cp invocation. (line 6) * copying files and setting attributes: install invocation. (line 6) * core utilities: Top. (line 18) * count: dd invocation. (line 56) -* count_bytes: dd invocation. (line 281) -* COW: cp invocation. (line 262) +* count_bytes: dd invocation. (line 288) +* COW: cp invocation. (line 264) * cp: cp invocation. (line 6) -* crashes and corruption: sync invocation. (line 11) +* crashes and corruption: sync invocation. (line 17) * CRC checksum: cksum invocation. (line 6) * cread: Control. (line 35) * creating directories: mkdir invocation. (line 6) * creating FIFOs (named pipes): mkfifo invocation. (line 6) * creating links (hard only): link invocation. (line 6) * creating links (hard or soft): ln invocation. (line 6) -* creating output file, avoiding: dd invocation. (line 154) -* creating output file, requiring: dd invocation. (line 150) +* creating output file, avoiding: dd invocation. (line 161) +* creating output file, requiring: dd invocation. (line 157) * crN: Output. (line 45) * crown margin: fmt invocation. (line 34) * crt: Combination. (line 75) @@ -17067,7 +17290,7 @@ Index (line 29) * day of week item: Day of week items. (line 6) * dd: dd invocation. (line 6) -* ddrescue: dd invocation. (line 330) +* ddrescue: dd invocation. (line 337) * dec: Combination. (line 78) * decctlq: Combination. (line 63) * Decode base64 data: base64 invocation. (line 30) @@ -17078,8 +17301,8 @@ Index * descriptor follow option: tail invocation. (line 48) * destination directory: Target directory. (line 15) * destination directory <1>: Target directory. (line 31) -* destination directory <2>: cp invocation. (line 343) -* destination directory <3>: cp invocation. (line 347) +* destination directory <2>: cp invocation. (line 345) +* destination directory <3>: cp invocation. (line 349) * destination directory <4>: install invocation. (line 125) * destination directory <5>: install invocation. (line 129) * destination directory <6>: mv invocation. (line 103) @@ -17097,23 +17320,23 @@ Index * dir: dir invocation. (line 6) * dircolors: dircolors invocation. (line 6) -* direct: dd invocation. (line 199) -* direct I/O: dd invocation. (line 199) +* direct: dd invocation. (line 206) +* direct I/O: dd invocation. (line 206) * directories, copying: cp invocation. (line 6) * directories, copying recursively: cp invocation. (line 96) -* directories, copying recursively <1>: cp invocation. (line 249) +* directories, copying recursively <1>: cp invocation. (line 251) * directories, creating: mkdir invocation. (line 6) * directories, creating with given attributes: install invocation. (line 67) * directories, removing: rm invocation. (line 35) * directories, removing (recursively): rm invocation. (line 93) * directories, removing empty: rmdir invocation. (line 6) -* directory: dd invocation. (line 207) +* directory: dd invocation. (line 214) * directory check: File type tests. (line 16) * directory components, printing: dirname invocation. (line 6) * directory deletion, ignoring failures: rmdir invocation. (line 17) * directory deletion, reporting: rmdir invocation. (line 31) -* directory I/O: dd invocation. (line 207) +* directory I/O: dd invocation. (line 214) * directory listing: ls invocation. (line 6) * directory listing, brief: dir invocation. (line 6) * directory listing, recursive: Which files are listed. @@ -17128,14 +17351,15 @@ Index * disabling special characters: Characters. (line 12) * disambiguating group names and IDs: Disambiguating names and IDs. (line 6) -* discarding file cache: dd invocation. (line 224) +* discard: Characters. (line 39) +* discarding file cache: dd invocation. (line 231) * disk allocation: What information is listed. (line 232) * disk device file: df invocation. (line 30) * disk usage: Disk usage. (line 6) * disk usage by file system: df invocation. (line 6) * disk usage for files: du invocation. (line 6) -* disks, failing: dd invocation. (line 330) +* disks, failing: dd invocation. (line 337) * displacement of dates: Relative items in date strings. (line 6) * displaying text: echo invocation. (line 6) @@ -17143,16 +17367,16 @@ Index * division: Numeric expressions. (line 16) * do nothing, successfully: true invocation. (line 6) * do nothing, unsuccessfully: false invocation. (line 6) -* DOS file system: df invocation. (line 210) +* DOS file system: df invocation. (line 219) * double spacing: pr invocation. (line 74) * down columns: pr invocation. (line 49) -* dsusp: Characters. (line 51) -* dsync: dd invocation. (line 213) +* dsusp: Characters. (line 57) +* dsync: dd invocation. (line 220) * DTR/DSR flow control: Control. (line 44) * du: du invocation. (line 6) * DU_BLOCK_SIZE: Block size. (line 12) -* DVD file system type: df invocation. (line 206) -* ebcdic, converting to: dd invocation. (line 91) +* DVD file system type: df invocation. (line 215) +* ebcdic, converting to: dd invocation. (line 98) * echo: echo invocation. (line 6) * echo <1>: Local. (line 18) * echoctl: Local. (line 51) @@ -17201,35 +17425,35 @@ Index * examples of ‘date’: Examples of date. (line 6) * examples of ‘expr’: Examples of expr. (line 6) * exbibyte, definition of: Block size. (line 109) -* excl: dd invocation. (line 150) +* excl: dd invocation. (line 157) * excluding files from ‘du’: du invocation. (line 250) * excluding files from ‘du’ <1>: du invocation. (line 255) * executable file check: Access permission tests. (line 24) * executables and file type, marking: General output formatting. - (line 46) + (line 47) * execute/search permission: Mode Structure. (line 16) * execute/search permission, symbolic: Setting Permissions. (line 56) * existence-of-file check: File characteristic tests. (line 9) * existing backup method: Backup options. (line 39) * exit status commands: Conditions. (line 6) -* exit status of ‘chroot’: chroot invocation. (line 67) +* exit status of ‘chroot’: chroot invocation. (line 78) * exit status of ‘env’: env invocation. (line 97) * exit status of ‘expr’: expr invocation. (line 43) * exit status of ‘false’: false invocation. (line 6) * exit status of ‘ls’: ls invocation. (line 29) * exit status of ‘mktemp’: mktemp invocation. (line 128) -* exit status of ‘nice’: nice invocation. (line 59) -* exit status of ‘nohup’: nohup invocation. (line 46) +* exit status of ‘nice’: nice invocation. (line 63) +* exit status of ‘nohup’: nohup invocation. (line 48) * exit status of ‘pathchk’: pathchk invocation. (line 47) * exit status of ‘printenv’: printenv invocation. (line 23) * exit status of ‘realpath’: realpath invocation. (line 80) * exit status of ‘runcon’: runcon invocation. (line 45) * exit status of ‘sort’: sort invocation. (line 57) -* exit status of ‘stdbuf’: stdbuf invocation. (line 65) +* exit status of ‘stdbuf’: stdbuf invocation. (line 69) * exit status of ‘test’: test invocation. (line 41) -* exit status of ‘timeout’: timeout invocation. (line 58) +* exit status of ‘timeout’: timeout invocation. (line 61) * exit status of ‘true’: true invocation. (line 6) * exit status of ‘tty’: tty invocation. (line 20) * expand: expand invocation. (line 6) @@ -17238,17 +17462,18 @@ Index * expression evaluation <1>: expr invocation. (line 6) * expressions, numeric: Numeric expressions. (line 6) * expressions, string: String expressions. (line 6) -* ext2 file system type: df invocation. (line 202) -* ext3 file system type: df invocation. (line 202) -* ext4 file system type: df invocation. (line 202) +* ext2 file system type: df invocation. (line 211) +* ext3 file system type: df invocation. (line 211) +* ext4 file system type: df invocation. (line 211) * extended attributes, xattr: install invocation. (line 34) * extended attributes, xattr <1>: mv invocation. (line 33) * extension, sorting files by: Sorting the output. (line 63) +* extproc: Local. (line 61) * factor: factor invocation. (line 6) * failure exit status: false invocation. (line 6) * false: false invocation. (line 6) -* fat file system file: df invocation. (line 210) -* fdatasync: dd invocation. (line 166) +* fat file system file: df invocation. (line 219) +* fdatasync: dd invocation. (line 173) * ffN: Output. (line 63) * field separator character: sort invocation. (line 322) * fields, padding numeric: Padding and other flags. @@ -17259,7 +17484,7 @@ Index * file characteristic tests: File characteristic tests. (line 6) * file contents, dumping unambiguously: od invocation. (line 6) -* file information, preserving: cp invocation. (line 232) +* file information, preserving: cp invocation. (line 234) * file information, preserving, extended attributes, xattr: cp invocation. (line 168) * file mode bits, numeric: Numeric Modes. (line 6) @@ -17277,29 +17502,29 @@ Index * file space usage: du invocation. (line 6) * file status: stat invocation. (line 6) * file system disk usage: df invocation. (line 6) -* file system sizes: df invocation. (line 48) +* file system sizes: df invocation. (line 54) * file system space, retrieving current data more slowly: df invocation. - (line 178) + (line 174) * file system space, retrieving old data more quickly: df invocation. - (line 88) + (line 84) * file system status: stat invocation. (line 6) * file system types, limiting output to certain: df invocation. - (line 84) + (line 80) * file system types, limiting output to certain <1>: df invocation. - (line 185) -* file system types, printing: df invocation. (line 191) + (line 194) +* file system types, printing: df invocation. (line 200) * file systems: stat invocation. (line 28) * file systems and hard links: ln invocation. (line 6) -* file systems, omitting copying to different: cp invocation. (line 370) +* file systems, omitting copying to different: cp invocation. (line 372) * file timestamp resolution: touch invocation. (line 26) * file timestamps, changing: touch invocation. (line 6) * file type and executables, marking: General output formatting. - (line 46) + (line 47) * file type tests: File type tests. (line 6) * file type, marking: General output formatting. - (line 57) + (line 58) * file type, marking <1>: General output formatting. - (line 97) + (line 98) * file types: Special file types. (line 9) * file types, special: Special file types. (line 6) * file utilities: Top. (line 18) @@ -17320,6 +17545,7 @@ Index * flow control, hardware: Control. (line 41) * flow control, hardware <1>: Control. (line 44) * flow control, software: Input. (line 45) +* flush: Characters. (line 39) * flushing, disabling: Local. (line 32) * fmt: fmt invocation. (line 6) * fold: fold invocation. (line 6) @@ -17333,8 +17559,8 @@ Index * formatting times <1>: date invocation. (line 20) * fortnight in date strings: Relative items in date strings. (line 15) -* fsync: dd invocation. (line 170) -* fullblock: dd invocation. (line 271) +* fsync: dd invocation. (line 177) +* fullblock: dd invocation. (line 278) * general date syntax: General date syntax. (line 6) * general numeric sort: sort invocation. (line 104) * gibibyte, definition of: Block size. (line 94) @@ -17343,7 +17569,7 @@ Index (line 12) * GMT: Options for date. (line 112) * grand total of disk size, usage and available space: df invocation. - (line 52) + (line 180) * grand total of disk space: du invocation. (line 61) * graph: Character sets. (line 98) * Greenwich Mean Time: Options for date. (line 112) @@ -17363,7 +17589,7 @@ Index * hard link check: File characteristic tests. (line 23) * hard link, defined: ln invocation. (line 30) -* hard links: dd invocation. (line 260) +* hard links: dd invocation. (line 267) * hard links to directories: ln invocation. (line 86) * hard links to symbolic links: ln invocation. (line 180) * hard links, counting in ‘du’: du invocation. (line 123) @@ -17381,10 +17607,10 @@ Index * headers, numbering: nl invocation. (line 17) * help, online: Common options. (line 36) * hex dump of files: od invocation. (line 6) -* holes, copying files with: cp invocation. (line 292) +* holes, copying files with: cp invocation. (line 294) * holes, creating files with: truncate invocation. (line 13) * horizontal, listing files: General output formatting. - (line 102) + (line 103) * host processor type: uname invocation. (line 50) * hostid: hostid invocation. (line 6) * hostname: hostname invocation. (line 6) @@ -17395,7 +17621,7 @@ Index * human-readable output: Block size. (line 42) * human-readable output <1>: What information is listed. (line 116) -* human-readable output <2>: df invocation. (line 63) +* human-readable output <2>: df invocation. (line 59) * human-readable output <3>: du invocation. (line 96) * hup[cl]: Control. (line 28) * hurd, author, printing: What information is listed. @@ -17408,7 +17634,7 @@ Index * IEEE floating point: Floating point. (line 6) * iexten: Local. (line 15) * if: dd invocation. (line 18) -* iflag: dd invocation. (line 174) +* iflag: dd invocation. (line 181) * ignbrk: Input. (line 9) * igncr: Input. (line 31) * ignore file systems: df invocation. (line 42) @@ -17426,10 +17652,10 @@ Index * inlcr: Input. (line 28) * inode number, printing: What information is listed. (line 123) -* inode usage: df invocation. (line 73) +* inode usage: df invocation. (line 69) * inode usage, dereferencing in ‘du’: du invocation. (line 102) * inode, and hard links: ln invocation. (line 30) -* inodes, written buffered: sync invocation. (line 6) +* inodes, written buffered: sync invocation. (line 11) * inpck: Input. (line 22) * input block size: dd invocation. (line 26) * input encoding, UTF-8: Input. (line 37) @@ -17445,8 +17671,8 @@ Index (line 6) * ISO 8601 date format: Calendar date items. (line 30) * ISO/IEC 10646: printf invocation. (line 68) -* ISO9660 file system type: df invocation. (line 206) -* iso9660 file system type: df invocation. (line 206) +* ISO9660 file system type: df invocation. (line 215) +* iso9660 file system type: df invocation. (line 215) * ispeed: Special. (line 16) * istrip: Input. (line 25) * items in date strings: General date syntax. (line 6) @@ -17462,7 +17688,7 @@ Index * kernel version: uname invocation. (line 76) * kibibyte, definition of: Block size. (line 82) * kibibytes for file sizes: du invocation. (line 111) -* kibibytes for file system sizes: df invocation. (line 78) +* kibibytes for file system sizes: df invocation. (line 74) * kill: kill invocation. (line 6) * kill <1>: Characters. (line 27) * kilobyte, definition of: Block size. (line 78) @@ -17476,7 +17702,7 @@ Index * last part of files, outputting: tail invocation. (line 6) * lcase: Combination. (line 71) * LCASE: Combination. (line 71) -* lcase, converting to: dd invocation. (line 117) +* lcase, converting to: dd invocation. (line 124) * lchown: chown invocation. (line 106) * lchown <1>: chown invocation. (line 111) * lchown <2>: chgrp invocation. (line 34) @@ -17531,6 +17757,7 @@ Index * line buffered: stdbuf invocation. (line 6) * line count: wc invocation. (line 6) * line numbering: nl invocation. (line 6) +* line separator character: split invocation. (line 141) * line settings of terminal: stty invocation. (line 6) * line-breaking: fmt invocation. (line 19) * line-by-line comparison: comm invocation. (line 6) @@ -17538,14 +17765,14 @@ Index * link: link invocation. (line 6) * links, creating: link invocation. (line 6) * links, creating <1>: ln invocation. (line 6) -* Linux file system types: df invocation. (line 202) +* Linux file system types: df invocation. (line 211) * literal conversion specifiers: Literal conversion specifiers. (line 6) * litout: Combination. (line 59) * ln: ln invocation. (line 6) * ln format for ‘nl’: nl invocation. (line 93) -* lnext: Characters. (line 60) -* local file system types: df invocation. (line 202) +* lnext: Characters. (line 66) +* local file system types: df invocation. (line 211) * local settings: Local. (line 6) * logging out and continuing to run: nohup invocation. (line 6) * logical and operator: Connectives for test. @@ -17569,7 +17796,7 @@ Index * ls: ls invocation. (line 6) * LS_BLOCK_SIZE: Block size. (line 12) * LS_COLORS: General output formatting. - (line 31) + (line 32) * LS_COLORS <1>: dircolors invocation. (line 23) * lutimes: touch invocation. (line 100) @@ -17628,15 +17855,15 @@ Index * month names in date strings: Calendar date items. (line 38) * months, sorting by: sort invocation. (line 149) * months, written-out: General date syntax. (line 32) -* MS-DOS file system: df invocation. (line 210) -* MS-Windows file system: df invocation. (line 210) +* MS-DOS file system: df invocation. (line 219) +* MS-Windows file system: df invocation. (line 219) * mtime, changing: touch invocation. (line 115) -* multicall: coreutils invocation. +* multicall: Multi-call invocation. (line 6) * multicolumn output, generating: pr invocation. (line 6) * multiple changes to permissions: Multiple Changes. (line 6) * multiplication: Numeric expressions. (line 16) -* multipliers after numbers: dd invocation. (line 305) +* multipliers after numbers: dd invocation. (line 312) * multithreaded sort: sort invocation. (line 351) * mv: mv invocation. (line 6) * name follow option: tail invocation. (line 48) @@ -17645,7 +17872,7 @@ Index * named pipes, creating: mkfifo invocation. (line 6) * network node name: uname invocation. (line 46) * never interactive option: rm invocation. (line 56) -* newer files, copying only: cp invocation. (line 352) +* newer files, copying only: cp invocation. (line 354) * newer files, moving only: mv invocation. (line 80) * newer-than file check: File characteristic tests. (line 15) @@ -17656,7 +17883,7 @@ Index * next DAY: Day of week items. (line 15) * next DAY <1>: Options for date. (line 11) * next in date strings: General date syntax. (line 22) -* NFS file system type: df invocation. (line 197) +* NFS file system type: df invocation. (line 206) * NFS mounts from BSD to HP-UX: What information is listed. (line 240) * NFS mounts from BSD to HP-UX <1>: du invocation. (line 264) @@ -17667,28 +17894,28 @@ Index * nlN: Output. (line 39) * no dereference: chcon invocation. (line 26) * no-op: true invocation. (line 6) -* noatime: dd invocation. (line 246) -* nocache: dd invocation. (line 224) -* nocreat: dd invocation. (line 154) -* noctty: dd invocation. (line 251) +* noatime: dd invocation. (line 253) +* nocache: dd invocation. (line 231) +* nocreat: dd invocation. (line 161) +* noctty: dd invocation. (line 258) * node name: uname invocation. (line 46) -* noerror: dd invocation. (line 163) +* noerror: dd invocation. (line 170) * noflsh: Local. (line 32) -* nofollow: dd invocation. (line 257) +* nofollow: dd invocation. (line 264) * nohup: nohup invocation. (line 6) * nohup.out: nohup invocation. (line 6) -* nohup.out <1>: nohup invocation. (line 18) -* nolinks: dd invocation. (line 260) +* nohup.out <1>: nohup invocation. (line 20) +* nolinks: dd invocation. (line 267) * non-directories, copying as special files: cp invocation. (line 96) * non-directories, copying as special files <1>: cp invocation. - (line 249) + (line 251) * non-directory suffix, stripping: dirname invocation. (line 6) -* nonblock: dd invocation. (line 243) -* nonblocking I/O: dd invocation. (line 243) +* nonblock: dd invocation. (line 250) +* nonblocking I/O: dd invocation. (line 250) * none backup method: Backup options. (line 31) * none color option: General output formatting. - (line 23) -* none dd status=: dd invocation. (line 75) + (line 24) +* none dd status=: dd invocation. (line 72) * none, sorting option for ‘ls’: Sorting the output. (line 49) * nonempty file check: File characteristic tests. (line 12) @@ -17696,13 +17923,13 @@ Index * nonzero-length string check: String tests. (line 19) * noon in date strings: Time of day items. (line 21) * not-equal string check: String tests. (line 28) -* notrunc: dd invocation. (line 160) +* notrunc: dd invocation. (line 167) * now in date strings: Relative items in date strings. (line 33) -* noxfer dd status=: dd invocation. (line 71) +* noxfer dd status=: dd invocation. (line 76) * nproc: nproc invocation. (line 6) -* NTFS file system: df invocation. (line 210) -* ntfs file system file: df invocation. (line 210) +* NTFS file system: df invocation. (line 219) +* ntfs file system file: df invocation. (line 219) * number of inputs to merge, nmerge: sort invocation. (line 255) * numbered backup method: Backup options. (line 35) * numbering lines: nl invocation. (line 6) @@ -17730,14 +17957,14 @@ Index * of: dd invocation. (line 21) * ofdel: Output. (line 34) * ofill: Output. (line 30) -* oflag: dd invocation. (line 178) +* oflag: dd invocation. (line 185) * olcuc: Output. (line 12) * older-than file check: File characteristic tests. (line 19) * once interactive option: rm invocation. (line 57) * one file system, restricting ‘du’ to: du invocation. (line 261) * one file system, restricting ‘rm’ to: rm invocation. (line 65) -* one-line output format: df invocation. (line 152) +* one-line output format: df invocation. (line 148) * onlcr: Output. (line 19) * onlret: Output. (line 27) * onocr: Output. (line 23) @@ -17761,7 +17988,7 @@ Index * output file name suffix: csplit invocation. (line 65) * output format: stat invocation. (line 34) * output format <1>: stat invocation. (line 43) -* output format, portable: df invocation. (line 152) +* output format, portable: df invocation. (line 148) * output NUL-byte-terminated lines: readlink invocation. (line 64) * output NUL-byte-terminated lines <1>: du invocation. (line 26) * output NUL-byte-terminated lines <2>: basename invocation. (line 42) @@ -17791,7 +18018,7 @@ Index (line 6) * paragraphs, reformatting: fmt invocation. (line 6) * parenb: Control. (line 9) -* parent directories and ‘cp’: cp invocation. (line 236) +* parent directories and ‘cp’: cp invocation. (line 238) * parent directories, creating: mkdir invocation. (line 34) * parent directories, creating missing: install invocation. (line 67) * parent directories, removing: rmdir invocation. (line 22) @@ -17833,16 +18060,16 @@ Index * platform, hardware: uname invocation. (line 35) * pm in date strings: Time of day items. (line 21) * portable file names, checking for: pathchk invocation. (line 6) -* portable output format: df invocation. (line 152) +* portable output format: df invocation. (line 148) * POSIX: Introduction. (line 11) -* POSIX output format: df invocation. (line 152) +* POSIX output format: df invocation. (line 148) * POSIXLY_CORRECT: Common options. (line 11) * POSIXLY_CORRECT <1>: Standards conformance. (line 6) * POSIXLY_CORRECT <2>: pr invocation. (line 85) * POSIXLY_CORRECT <3>: sort invocation. (line 289) * POSIXLY_CORRECT <4>: sort invocation. (line 406) -* POSIXLY_CORRECT <5>: dd invocation. (line 360) +* POSIXLY_CORRECT <5>: dd invocation. (line 381) * POSIXLY_CORRECT <6>: echo invocation. (line 65) * POSIXLY_CORRECT <7>: printf invocation. (line 47) * POSIXLY_CORRECT <8>: id invocation. (line 15) @@ -17880,6 +18107,7 @@ Index * process zero-terminated items <2>: uniq invocation. (line 141) * process zero-terminated items <3>: join invocation. (line 155) * processes, commands for controlling: Process control. (line 6) +* progress dd status=: dd invocation. (line 80) * prompting, and ‘ln’: ln invocation. (line 96) * prompting, and ‘mv’: mv invocation. (line 37) * prompting, and ‘rm’: rm invocation. (line 11) @@ -17896,6 +18124,7 @@ Index * quoting style: Formatting the file names. (line 34) * radix for file offsets: od invocation. (line 36) +* random seed: Random sources. (line 31) * random sort: sort invocation. (line 188) * random source for shredding: shred invocation. (line 112) * random source for shuffling: shuf invocation. (line 42) @@ -17903,12 +18132,12 @@ Index * random sources: Random sources. (line 6) * ranges: Character sets. (line 44) * raw: Combination. (line 43) -* read errors, ignoring: dd invocation. (line 163) +* read errors, ignoring: dd invocation. (line 170) * read from stdin and write to stdout and files: tee invocation. (line 6) * read permission: Mode Structure. (line 12) * read permission, symbolic: Setting Permissions. (line 52) -* read system call, and holes: cp invocation. (line 292) +* read system call, and holes: cp invocation. (line 294) * readable file check: Access permission tests. (line 15) * readlink: readlink invocation. (line 6) @@ -17917,13 +18146,14 @@ Index * realpath <1>: realpath invocation. (line 6) * realpath <2>: realpath invocation. (line 6) * realpath <3>: realpath invocation. (line 6) +* record separator character: split invocation. (line 141) * recursive directory listing: Which files are listed. (line 90) * recursively changing access permissions: chmod invocation. (line 69) * recursively changing file ownership: chown invocation. (line 143) * recursively changing group ownership: chgrp invocation. (line 70) * recursively copying directories: cp invocation. (line 96) -* recursively copying directories <1>: cp invocation. (line 249) +* recursively copying directories <1>: cp invocation. (line 251) * redirection: Redirection. (line 6) * reference file: chcon invocation. (line 30) * reformatting paragraph text: fmt invocation. (line 6) @@ -17975,7 +18205,7 @@ Index * root directory, running a program in a specified: chroot invocation. (line 6) * rows: Special. (line 22) -* rprnt: Characters. (line 54) +* rprnt: Characters. (line 60) * RTS/CTS flow control: Control. (line 41) * run commands with bounded time: timeout invocation. (line 6) * run with security context: runcon invocation. (line 6) @@ -17997,7 +18227,7 @@ Index * section delimiters of pages: nl invocation. (line 63) * security context: What information is listed. (line 255) -* security context <1>: cp invocation. (line 376) +* security context <1>: cp invocation. (line 378) * security context <2>: install invocation. (line 96) * security context <3>: install invocation. (line 138) * security context <4>: mv invocation. (line 112) @@ -18006,7 +18236,7 @@ Index * security context <7>: mknod invocation. (line 53) * security context <8>: id invocation. (line 51) * seek: dd invocation. (line 51) -* seek_bytes: dd invocation. (line 293) +* seek_bytes: dd invocation. (line 300) * self-backups: cp invocation. (line 51) * SELinux: What information is listed. (line 255) @@ -18015,7 +18245,7 @@ Index * SELinux context: SELinux context. (line 6) * SELinux, context: SELinux context. (line 6) * SELinux, restoring security context: mv invocation. (line 112) -* SELinux, setting/restoring security context: cp invocation. (line 376) +* SELinux, setting/restoring security context: cp invocation. (line 378) * SELinux, setting/restoring security context <1>: install invocation. (line 138) * SELinux, setting/restoring security context <2>: mkdir invocation. @@ -18052,7 +18282,7 @@ Index * sha384sum: sha2 utilities. (line 6) * sha512sum: sha2 utilities. (line 6) * SHELL environment variable, and color: General output formatting. - (line 31) + (line 32) * SHELL environment variable, and color <1>: dircolors invocation. (line 23) * shell utilities: Top. (line 18) @@ -18062,7 +18292,7 @@ Index * SI output: Block size. (line 42) * SI output <1>: What information is listed. (line 247) -* SI output <2>: df invocation. (line 171) +* SI output <2>: df invocation. (line 167) * SI output <3>: du invocation. (line 145) * signals, specifying: Signal specifications. (line 6) @@ -18077,7 +18307,7 @@ Index (line 232) * size of files, sorting files by: Sorting the output. (line 32) * skip: dd invocation. (line 46) -* skip_bytes: dd invocation. (line 287) +* skip_bytes: dd invocation. (line 294) * sleep: sleep invocation. (line 6) * socket check: File type tests. (line 31) * software flow control: Input. (line 45) @@ -18093,8 +18323,8 @@ Index * sorting ‘ls’ output: Sorting the output. (line 6) * space: Character sets. (line 106) * space parity: Control. (line 16) -* sparse: dd invocation. (line 125) -* sparse files, copying: cp invocation. (line 292) +* sparse: dd invocation. (line 132) +* sparse files, copying: cp invocation. (line 294) * sparse files, creating: truncate invocation. (line 13) * special characters: Characters. (line 6) * special file types: Special file types. (line 6) @@ -18112,9 +18342,10 @@ Index * standard input: Common options. (line 47) * standard output: Common options. (line 47) * standard streams, buffering: stdbuf invocation. (line 6) -* start: Characters. (line 42) +* start: Characters. (line 48) * stat: stat invocation. (line 6) * status: dd invocation. (line 66) +* status <1>: Characters. (line 45) * status time, printing or sorting by: Sorting the output. (line 13) * status time, show the most recent: du invocation. (line 203) * stdbuf: stdbuf invocation. (line 6) @@ -18122,7 +18353,7 @@ Index * sticky: Mode Structure. (line 49) * sticky bit check: Access permission tests. (line 12) -* stop: Characters. (line 45) +* stop: Characters. (line 51) * stop bits: Control. (line 32) * strftime and ‘date’: date invocation. (line 20) * string constants, outputting: od invocation. (line 80) @@ -18132,7 +18363,7 @@ Index (line 6) * stripping non-directory suffix: dirname invocation. (line 6) * stripping symbol table information: install invocation. (line 113) -* stripping trailing slashes: cp invocation. (line 325) +* stripping trailing slashes: cp invocation. (line 327) * stripping trailing slashes <1>: mv invocation. (line 93) * stty: stty invocation. (line 6) * substr: String expressions. (line 40) @@ -18142,12 +18373,12 @@ Index * suffix, stripping from file names: basename invocation. (line 6) * sum: sum invocation. (line 6) * summarizing files: Summarizing files. (line 6) -* superblock, writing: sync invocation. (line 6) +* superblock, writing: sync invocation. (line 11) * supplementary groups, printing: groups invocation. (line 6) -* susp: Characters. (line 48) -* swab (byte-swapping): dd invocation. (line 137) +* susp: Characters. (line 54) +* swab (byte-swapping): dd invocation. (line 144) * swap space, saving text image in: Mode Structure. (line 49) -* swtch: Characters. (line 39) +* swtch: Characters. (line 42) * symbol table information, stripping: install invocation. (line 113) * symbol table information, stripping, program: install invocation. (line 116) @@ -18190,7 +18421,7 @@ Index * symbolic links, changing time: touch invocation. (line 100) * symbolic links, copying: cp invocation. (line 109) * symbolic links, copying <1>: cp invocation. (line 161) -* symbolic links, copying with: cp invocation. (line 330) +* symbolic links, copying with: cp invocation. (line 332) * symbolic links, dereferencing: Which files are listed. (line 36) * symbolic links, dereferencing <1>: Which files are listed. @@ -18200,19 +18431,21 @@ Index * symbolic links, dereferencing in ‘du’: du invocation. (line 117) * symbolic links, dereferencing in ‘du’ <1>: du invocation. (line 133) * symbolic links, dereferencing in ‘stat’: stat invocation. (line 22) -* symbolic links, following: dd invocation. (line 257) +* symbolic links, following: dd invocation. (line 264) * symbolic links, permissions of: chmod invocation. (line 10) * symbolic modes: Symbolic Modes. (line 6) * symlinks, resolution: realpath invocation. (line 6) * sync: sync invocation. (line 6) -* sync <1>: dd invocation. (line 221) -* sync (padding with ASCII NULs): dd invocation. (line 142) +* sync <1>: dd invocation. (line 228) +* sync (padding with ASCII NULs): dd invocation. (line 149) +* Synchronize cached writes to persistent storage: sync invocation. + (line 6) * synchronize disk and memory: sync invocation. (line 6) -* synchronized data and metadata I/O: dd invocation. (line 221) +* synchronized data and metadata I/O: dd invocation. (line 228) * synchronized data and metadata writes, before finishing: dd invocation. - (line 170) -* synchronized data reads: dd invocation. (line 213) -* synchronized data writes, before finishing: dd invocation. (line 166) + (line 177) +* synchronized data reads: dd invocation. (line 220) +* synchronized data writes, before finishing: dd invocation. (line 173) * system context: System context. (line 6) * system information, printing: arch invocation. (line 6) * system information, printing <1>: nproc invocation. (line 6) @@ -18230,8 +18463,8 @@ Index * target directory: Target directory. (line 6) * target directory <1>: Target directory. (line 15) * target directory <2>: Target directory. (line 31) -* target directory <3>: cp invocation. (line 343) -* target directory <4>: cp invocation. (line 347) +* target directory <3>: cp invocation. (line 345) +* target directory <4>: cp invocation. (line 349) * target directory <5>: install invocation. (line 125) * target directory <6>: install invocation. (line 129) * target directory <7>: mv invocation. (line 103) @@ -18249,13 +18482,13 @@ Index * terminal lines, currently used: who invocation. (line 11) * terminal settings: stty invocation. (line 6) * terminal, using color iff: General output formatting. - (line 24) + (line 25) * terse output: stat invocation. (line 54) * test: test invocation. (line 6) -* text: dd invocation. (line 267) -* text I/O: dd invocation. (line 267) +* text: dd invocation. (line 274) +* text I/O: dd invocation. (line 274) * text image, saving in swap space: Mode Structure. (line 49) -* text input files: md5sum invocation. (line 95) +* text input files: md5sum invocation. (line 101) * text utilities: Top. (line 18) * text, displaying: echo invocation. (line 6) * text, reformatting: fmt invocation. (line 6) @@ -18273,7 +18506,7 @@ Index * time style: Formatting file timestamps. (line 24) * time style <1>: du invocation. (line 212) -* time units: timeout invocation. (line 49) +* time units: timeout invocation. (line 52) * time units <1>: sleep invocation. (line 11) * time zone correction: Time of day items. (line 29) * time zone item: General date syntax. (line 40) @@ -18302,7 +18535,7 @@ Index * translating characters: Translating. (line 6) * true: true invocation. (line 6) * truncate: truncate invocation. (line 6) -* truncating output file, avoiding: dd invocation. (line 160) +* truncating output file, avoiding: dd invocation. (line 167) * truncating, file sizes: truncate invocation. (line 6) * tsort: tsort invocation. (line 6) * tty: tty invocation. (line 6) @@ -18312,18 +18545,18 @@ Index * TZ <1>: Formatting file timestamps. (line 17) * TZ <2>: touch invocation. (line 65) -* TZ <3>: stat invocation. (line 144) +* TZ <3>: stat invocation. (line 155) * TZ <4>: who invocation. (line 26) * TZ <5>: date invocation. (line 16) * TZ <6>: Options for date. (line 112) * TZ <7>: Specifying time zone rules. (line 6) * u, and disabling special characters: Characters. (line 12) -* ucase, converting to: dd invocation. (line 120) +* ucase, converting to: dd invocation. (line 127) * umask and modes: Umask and Protection. (line 6) * uname: uname invocation. (line 6) -* unblock: dd invocation. (line 111) +* unblock: dd invocation. (line 118) * unexpand: unexpand invocation. (line 6) * Unicode: printf invocation. (line 68) * uniq: uniq invocation. (line 6) @@ -18359,10 +18592,10 @@ Index * vdir: vdir invocation. (line 6) * verbose ls format: What information is listed. (line 131) -* verifying MD5 checksums: md5sum invocation. (line 68) -* verifying MD5 checksums <1>: md5sum invocation. (line 76) -* verifying MD5 checksums <2>: md5sum invocation. (line 104) -* verifying MD5 checksums <3>: md5sum invocation. (line 109) +* verifying MD5 checksums: md5sum invocation. (line 74) +* verifying MD5 checksums <1>: md5sum invocation. (line 82) +* verifying MD5 checksums <2>: md5sum invocation. (line 110) +* verifying MD5 checksums <3>: md5sum invocation. (line 115) * version number sort: sort invocation. (line 176) * version number, finding: Common options. (line 40) * version of kernel: uname invocation. (line 76) @@ -18374,12 +18607,12 @@ Index * VERSION_CONTROL <3>: mv invocation. (line 56) * VERSION_CONTROL <4>: ln invocation. (line 80) * vertical sorted files in columns: General output formatting. - (line 15) + (line 16) * vtN: Output. (line 59) * wc: wc invocation. (line 6) * week in date strings: Relative items in date strings. (line 15) -* werase: Characters. (line 57) +* werase: Characters. (line 63) * who: who invocation. (line 6) * who am i: who invocation. (line 21) * whoami: whoami invocation. (line 6) @@ -18397,7 +18630,7 @@ Index * wtmp <1>: who invocation. (line 15) * xcase: Local. (line 36) * xdigit: Character sets. (line 110) -* xfs file system type: df invocation. (line 202) +* xfs file system type: df invocation. (line 211) * XON/XOFF flow control: Input. (line 40) * year in date strings: Relative items in date strings. (line 15) @@ -18413,228 +18646,228 @@ Index Tag Table: -Node: Top8459 -Node: Introduction22529 -Node: Common options24088 -Node: Exit status27550 -Node: Backup options28366 -Node: Block size30412 -Node: Floating point35747 -Node: Signal specifications37170 -Node: Disambiguating names and IDs39340 -Ref: Disambiguating names and IDs-Footnote-140957 -Node: Random sources41027 -Node: Target directory42681 -Node: Trailing slashes46331 -Node: Traversing symlinks47370 -Node: Treating / specially48502 -Node: Special built-in utilities50136 -Node: Standards conformance51331 -Node: coreutils invocation52971 -Node: Output of entire files53404 -Node: cat invocation54005 -Node: tac invocation55947 -Node: nl invocation57254 -Node: od invocation61316 -Node: base64 invocation69045 -Node: Formatting file contents70455 -Node: fmt invocation70956 -Node: numfmt invocation73942 -Node: pr invocation84605 -Node: fold invocation96885 -Node: Output of parts of files98400 -Node: head invocation98897 -Node: tail invocation101245 -Node: split invocation111356 -Node: csplit invocation118533 -Node: Summarizing files123763 -Node: wc invocation124411 -Node: sum invocation127596 -Node: cksum invocation129062 -Node: md5sum invocation130242 -Node: sha1sum invocation136010 -Node: sha2 utilities136802 -Node: Operating on sorted files137447 -Node: sort invocation138034 -Ref: sort invocation-Footnote-1163176 -Node: shuf invocation163786 -Node: uniq invocation166987 -Node: comm invocation173050 -Node: ptx invocation175553 -Node: General options in ptx178387 -Node: Charset selection in ptx178987 -Node: Input processing in ptx179900 -Node: Output formatting in ptx185433 -Node: Compatibility in ptx192269 -Node: tsort invocation195652 -Node: tsort background198856 -Node: Operating on fields200564 -Node: cut invocation200926 -Node: paste invocation205025 -Node: join invocation206738 -Node: Operating on characters213794 -Node: tr invocation214217 -Node: Character sets215984 -Node: Translating220732 -Node: Squeezing222890 -Node: expand invocation226096 -Node: unexpand invocation227620 -Node: Directory listing229493 -Node: ls invocation229991 -Ref: ls invocation-Footnote-1232126 -Node: Which files are listed232370 -Node: What information is listed236380 -Node: Sorting the output246006 -Node: Details about version sort248473 -Node: General output formatting250282 -Node: Formatting file timestamps255551 -Node: Formatting the file names261090 -Node: dir invocation264150 -Node: vdir invocation264577 -Node: dircolors invocation264967 -Node: Basic operations266773 -Node: cp invocation267393 -Node: dd invocation285251 -Node: install invocation300707 -Node: mv invocation306965 -Node: rm invocation311947 -Node: shred invocation316615 -Node: Special file types325658 -Node: link invocation327175 -Node: ln invocation328432 -Node: mkdir invocation337293 -Node: mkfifo invocation340067 -Node: mknod invocation341533 -Node: readlink invocation344062 -Node: rmdir invocation346483 -Node: unlink invocation347800 -Node: Changing file attributes348794 -Node: chown invocation349610 -Node: chgrp invocation356188 -Node: chmod invocation359614 -Node: touch invocation362494 -Node: Disk usage370171 -Node: df invocation370832 -Node: du invocation379946 -Node: stat invocation391031 -Node: sync invocation397070 -Node: truncate invocation398054 -Node: Printing text399994 -Node: echo invocation400368 -Node: printf invocation403092 -Node: yes invocation408828 -Node: Conditions409480 -Node: false invocation410075 -Node: true invocation411160 -Node: test invocation412489 -Node: File type tests414626 -Node: Access permission tests415545 -Node: File characteristic tests416461 -Node: String tests417245 -Node: Numeric tests418015 -Node: Connectives for test418850 -Node: expr invocation419218 -Node: String expressions421730 -Node: Numeric expressions424435 -Node: Relations for expr425143 -Node: Examples of expr426372 -Node: Redirection427121 -Node: tee invocation427582 -Node: File name manipulation432496 -Node: basename invocation433071 -Node: dirname invocation435290 -Node: pathchk invocation437107 -Node: mktemp invocation438918 -Node: realpath invocation444736 -Node: Working context447864 -Node: pwd invocation448508 -Node: stty invocation449927 -Node: Control452754 -Node: Input453830 -Node: Output455584 -Node: Local457002 -Node: Combination458731 -Node: Characters461127 -Node: Special462783 -Node: printenv invocation464530 -Node: tty invocation465541 -Node: User information466270 -Node: id invocation466905 -Node: logname invocation469408 -Node: whoami invocation470065 -Node: groups invocation470572 -Node: users invocation471807 -Node: who invocation472792 -Node: System context475935 -Node: date invocation476600 -Node: Time conversion specifiers478374 -Node: Date conversion specifiers481028 -Node: Literal conversion specifiers484332 -Node: Padding and other flags484704 -Node: Setting the time486972 -Node: Options for date488135 -Node: Examples of date492678 -Ref: %s-examples494169 -Node: arch invocation497390 -Node: nproc invocation497851 -Node: uname invocation498980 -Node: hostname invocation501676 -Node: hostid invocation502305 -Node: uptime invocation503038 -Node: SELinux context504184 -Node: chcon invocation504559 -Node: runcon invocation506964 -Node: Modified command invocation508501 -Node: chroot invocation509193 -Ref: chroot invocation-Footnote-1512506 -Node: env invocation512816 -Node: nice invocation517238 -Node: nohup invocation521185 -Node: stdbuf invocation523564 -Node: timeout invocation526212 -Node: Process control528779 -Node: kill invocation529002 -Node: Delaying532196 -Node: sleep invocation532393 -Node: Numeric operations533548 -Node: factor invocation533880 -Node: seq invocation535674 -Node: File permissions539760 -Node: Mode Structure540452 -Node: Symbolic Modes544176 -Node: Setting Permissions545290 -Node: Copying Permissions547956 -Node: Changing Special Mode Bits548826 -Node: Conditional Executability550708 -Node: Multiple Changes551260 -Node: Umask and Protection552933 -Node: Numeric Modes554078 -Node: Operator Numeric Modes556247 -Node: Directory Setuid and Setgid557307 -Node: Date input formats560162 -Node: General date syntax562604 -Node: Calendar date items565731 -Node: Time of day items567804 -Node: Time zone items570104 -Node: Combined date and time of day items571405 -Node: Day of week items572274 -Node: Relative items in date strings573358 -Node: Pure numbers in date strings576264 -Node: Seconds since the Epoch577253 -Node: Specifying time zone rules578918 -Node: Authors of parse_datetime581386 -Ref: Authors of get_date581577 -Node: Opening the software toolbox582576 -Node: Toolbox introduction583370 -Node: I/O redirection586114 -Node: The who command588995 -Node: The cut command589920 -Node: The sort command591022 -Node: The uniq command591740 -Node: Putting the tools together592455 -Ref: Putting the tools together-Footnote-1604673 -Node: GNU Free Documentation License604747 -Node: Concept index630119 +Node: Top8458 +Node: Introduction22547 +Node: Common options24106 +Node: Exit status27543 +Node: Backup options28359 +Node: Block size30405 +Node: Floating point35741 +Node: Signal specifications37351 +Node: Disambiguating names and IDs39521 +Ref: Disambiguating names and IDs-Footnote-141138 +Node: Random sources41208 +Node: Target directory43217 +Node: Trailing slashes46867 +Node: Traversing symlinks47906 +Node: Treating / specially49038 +Node: Special built-in utilities50672 +Node: Standards conformance51867 +Node: Multi-call invocation53508 +Node: Output of entire files54070 +Node: cat invocation54671 +Node: tac invocation56613 +Node: nl invocation57920 +Node: od invocation61982 +Node: base64 invocation69711 +Node: Formatting file contents71121 +Node: fmt invocation71572 +Node: pr invocation74554 +Node: fold invocation86831 +Node: Output of parts of files88346 +Node: head invocation88843 +Node: tail invocation91191 +Node: split invocation101302 +Node: csplit invocation109273 +Node: Summarizing files114504 +Node: wc invocation115152 +Node: sum invocation118479 +Node: cksum invocation119945 +Node: md5sum invocation121125 +Node: sha1sum invocation127189 +Node: sha2 utilities127981 +Node: Operating on sorted files128643 +Node: sort invocation129230 +Ref: sort invocation-Footnote-1154372 +Node: shuf invocation154982 +Node: uniq invocation158183 +Node: comm invocation164246 +Node: ptx invocation166749 +Node: General options in ptx169583 +Node: Charset selection in ptx170183 +Node: Input processing in ptx171096 +Node: Output formatting in ptx176629 +Node: Compatibility in ptx183465 +Node: tsort invocation186848 +Node: tsort background190052 +Node: Operating on fields191760 +Node: cut invocation192122 +Node: paste invocation196221 +Node: join invocation197934 +Node: Operating on characters204990 +Node: tr invocation205413 +Node: Character sets207180 +Node: Translating211928 +Node: Squeezing214086 +Node: expand invocation217292 +Node: unexpand invocation218816 +Node: Directory listing220689 +Node: ls invocation221187 +Ref: ls invocation-Footnote-1223322 +Node: Which files are listed223566 +Node: What information is listed227576 +Node: Sorting the output237202 +Node: Details about version sort239669 +Node: General output formatting241478 +Node: Formatting file timestamps246864 +Node: Formatting the file names252403 +Node: dir invocation255463 +Node: vdir invocation255890 +Node: dircolors invocation256315 +Node: Basic operations258121 +Node: cp invocation258741 +Node: dd invocation276711 +Node: install invocation293051 +Node: mv invocation299309 +Node: rm invocation304291 +Node: shred invocation308965 +Node: Special file types318008 +Node: link invocation319525 +Node: ln invocation320782 +Node: mkdir invocation329644 +Node: mkfifo invocation332418 +Node: mknod invocation333885 +Node: readlink invocation336415 +Node: rmdir invocation338836 +Node: unlink invocation340153 +Node: Changing file attributes341147 +Node: chown invocation341963 +Node: chgrp invocation348541 +Node: chmod invocation351967 +Node: touch invocation354847 +Node: Disk usage362524 +Node: df invocation363205 +Node: du invocation373042 +Node: stat invocation384146 +Node: sync invocation390740 +Node: truncate invocation392911 +Node: Printing text394849 +Node: echo invocation395223 +Node: printf invocation397947 +Node: yes invocation403683 +Node: Conditions404335 +Node: false invocation404930 +Node: true invocation406015 +Node: test invocation407344 +Node: File type tests409481 +Node: Access permission tests410400 +Node: File characteristic tests411316 +Node: String tests412100 +Node: Numeric tests412870 +Node: Connectives for test413705 +Node: expr invocation414073 +Node: String expressions416585 +Node: Numeric expressions419290 +Node: Relations for expr419998 +Node: Examples of expr421227 +Node: Redirection421976 +Node: tee invocation422437 +Node: File name manipulation428314 +Node: basename invocation428889 +Node: dirname invocation431108 +Node: pathchk invocation432925 +Node: mktemp invocation434736 +Node: realpath invocation440554 +Node: Working context443682 +Node: pwd invocation444326 +Node: stty invocation445745 +Node: Control448730 +Node: Input449806 +Node: Output451560 +Node: Local452978 +Node: Combination454942 +Node: Characters457354 +Node: Special459181 +Node: printenv invocation460928 +Node: tty invocation461939 +Node: User information462668 +Node: id invocation463303 +Node: logname invocation465806 +Node: whoami invocation466463 +Node: groups invocation466970 +Node: users invocation468205 +Node: who invocation469385 +Node: System context472721 +Node: date invocation473386 +Node: Time conversion specifiers475160 +Node: Date conversion specifiers477814 +Node: Literal conversion specifiers481118 +Node: Padding and other flags481490 +Node: Setting the time483758 +Node: Options for date484921 +Node: Examples of date489464 +Ref: %s-examples490955 +Node: arch invocation494176 +Node: nproc invocation494735 +Node: uname invocation495864 +Node: hostname invocation498560 +Node: hostid invocation499390 +Node: uptime invocation500263 +Node: SELinux context501743 +Node: chcon invocation502118 +Node: runcon invocation504523 +Node: Modified command invocation506060 +Node: chroot invocation506752 +Ref: chroot invocation-Footnote-1510646 +Node: env invocation511163 +Node: nice invocation515585 +Node: nohup invocation519702 +Node: stdbuf invocation522204 +Node: timeout invocation525049 +Node: Process control527849 +Node: kill invocation528072 +Node: Delaying531266 +Node: sleep invocation531463 +Node: Numeric operations532618 +Node: factor invocation533003 +Node: numfmt invocation534800 +Node: seq invocation546023 +Node: File permissions550109 +Node: Mode Structure550801 +Node: Symbolic Modes554525 +Node: Setting Permissions555639 +Node: Copying Permissions558305 +Node: Changing Special Mode Bits559175 +Node: Conditional Executability561057 +Node: Multiple Changes561609 +Node: Umask and Protection563282 +Node: Numeric Modes564427 +Node: Operator Numeric Modes566596 +Node: Directory Setuid and Setgid567656 +Node: Date input formats570511 +Node: General date syntax572953 +Node: Calendar date items576080 +Node: Time of day items578153 +Node: Time zone items580453 +Node: Combined date and time of day items581754 +Node: Day of week items582623 +Node: Relative items in date strings583707 +Node: Pure numbers in date strings586613 +Node: Seconds since the Epoch587602 +Node: Specifying time zone rules589267 +Node: Authors of parse_datetime591735 +Ref: Authors of get_date591926 +Node: Opening the software toolbox592925 +Node: Toolbox introduction593719 +Node: I/O redirection596463 +Node: The who command599344 +Node: The cut command600269 +Node: The sort command601371 +Node: The uniq command602089 +Node: Putting the tools together602804 +Ref: Putting the tools together-Footnote-1615022 +Node: GNU Free Documentation License615096 +Node: Concept index640469 End Tag Table |