1 GNU coreutils NEWS -*- outline -*-
3 * Noteworthy changes in release ?.? (????-??-??) [?]
7 cp --reflink=auto (the default), mv, and install
8 will again fall back to a standard copy in more cases.
9 Previously copies could fail with permission errors on
10 more restricted systems like android or containers etc.
11 [bug introduced in coreutils-9.2]
13 cp --recursive --backup will again operate correctly.
14 Previousy it may have issued "File exists" errors when
15 it failed to appropriately rename files being replaced.
16 [bug introduced in coreutils-9.2]
18 date --file and dircolors will now diagnose a failure to read a file.
19 Previously they would have silently ignored the failure.
20 [This bug was present in "the beginning".]
22 md5sum --check again correctly prints the status of each file checked.
23 Previously the status for files was printed as 'OK' once any file had passed.
24 This also applies to cksum, sha*sum, and b2sum.
25 [bug introduced in coreutils-9.2]
27 wc will now diagnose if any total counts have overflowed.
28 [This bug was present in "the beginning".]
30 `wc -c` will again correctly update the read offset of inputs.
31 Previously it deduced the size of inputs while leaving the offset unchanged.
32 [bug introduced in coreutils-8.27]
34 Coreutils programs no longer fail for timestamps past the year 2038
35 on obsolete configurations with 32-bit signed time_t, because the
36 build procedure now rejects these configurations.
37 [This bug was present in "the beginning".]
39 ** Changes in behavior
41 'cp -n' and 'mv -n' now issue an error diagnostic if skipping a file,
42 to correspond with -n inducing a nonzero exit status as of coreutils 9.2.
43 Similarly 'cp -v' and 'mv -v' will output a message for each file skipped
48 cp and mv now support --update=none to always skip existing files
49 in the destination, while not affecting the exit status.
50 This is equivalent to the --no-clobber behavior from before v9.2.
53 * Noteworthy changes in release 9.2 (2023-03-20) [stable]
57 'comm --output-delimiter="" --total' now delimits columns in the total
58 line with the NUL character, consistent with NUL column delimiters in
59 the rest of the output. Previously no delimiters were used for the
60 total line in this case.
61 [bug introduced with the --total option in coreutils-8.26]
63 'cp -p' no longer has a security hole when cloning into a dangling
64 symbolic link on macOS 10.12 and later.
65 [bug introduced in coreutils-9.1]
67 'cp -rx / /mnt' no longer complains "cannot create directory /mnt/".
68 [bug introduced in coreutils-9.1]
70 cp, mv, and install avoid allocating too much memory, and possibly
71 triggering "memory exhausted" failures, on file systems like ZFS,
72 which can return varied file system I/O block size values for files.
73 [bug introduced in coreutils-6.0]
75 cp, mv, and install now immediately acknowledge transient errors
76 when creating copy-on-write or cloned reflink files, on supporting
77 file systems like XFS, BTRFS, APFS, etc.
78 Previously they would have tried again with other copy methods
79 which may have resulted in data corruption.
80 [bug introduced in coreutils-7.5 and enabled by default in coreutils-9.0]
82 cp, mv, and install now handle ENOENT failures across CIFS file systems,
83 falling back from copy_file_range to a better supported standard copy.
84 [issue introduced in coreutils-9.0]
86 'mv --backup=simple f d/' no longer mistakenly backs up d/f to f~.
87 [bug introduced in coreutils-9.1]
89 rm now fails gracefully when memory is exhausted.
90 Previously it may have aborted with a failed assertion in some cases.
91 [This bug was present in "the beginning".]
93 rm -d (--dir) now properly handles unreadable empty directories.
94 E.g., before, this would fail to remove d: mkdir -m0 d; src/rm -d d
95 [bug introduced in v8.19 with the addition of this option]
97 runcon --compute no longer looks up the specified command in the $PATH
98 so that there is no mismatch between the inspected and executed file.
99 [bug introduced when runcon was introduced in coreutils-6.9.90]
101 'sort -g' no longer infloops when given multiple NaNs on platforms
102 like x86_64 where 'long double' has padding bits in memory.
103 Although the fix alters sort -g's NaN ordering, that ordering has
104 long been documented to be platform-dependent.
105 [bug introduced 1999-05-02 and only partly fixed in coreutils-8.14]
107 stty ispeed and ospeed options no longer accept and silently ignore
108 invalid speed arguments, or give false warnings for valid speeds.
109 Now they're validated against both the general accepted set,
110 and the system supported set of valid speeds.
111 [This bug was present in "the beginning".]
113 stty now wraps output appropriately for the terminal width.
114 Previously it may have output 1 character too wide for certain widths.
115 [bug introduced in coreutils-5.3]
117 tail --follow=name works again with non seekable files. Previously it
118 exited with an "Illegal seek" error when such a file was replaced.
119 [bug introduced in fileutils-4.1.6]
121 'wc -c' will again efficiently determine the size of large files
122 on all systems. It no longer redundantly reads data from certain
123 sized files larger than SIZE_MAX.
124 [bug introduced in coreutils-8.24]
126 ** Changes in behavior
128 Programs now support the new Ronna (R), and Quetta (Q) SI prefixes,
129 corresponding to 10^27 and 10^30 respectively,
130 along with their binary counterparts Ri (2^90) and Qi (2^100).
131 In some cases (e.g., 'sort -h') these new prefixes simply work;
132 in others, where they exceed integer width limits, they now elicit
133 the same integer overflow diagnostics as other large prefixes.
135 'cp --reflink=always A B' no longer leaves behind a newly created
136 empty file B merely because copy-on-write clones are not supported.
138 'cp -n' and 'mv -n' now exit with nonzero status if they skip their
139 action because the destination exists, and likewise for 'cp -i',
140 'ln -i', and 'mv -i' when the user declines. (POSIX specifies this
141 for 'cp -i' and 'mv -i'.)
143 cp, mv, and install again read in multiples of the reported block size,
144 to support unusual devices that may have this constraint.
145 [behavior inadvertently changed in coreutils-7.2]
147 du --apparent now counts apparent sizes only of regular files and
148 symbolic links. POSIX does not specify the meaning of apparent
149 sizes (i.e., st_size) for other file types, and counting those sizes
150 could cause confusing and unwanted size mismatches.
152 'ls -v' and 'sort -V' go back to sorting ".0" before ".A",
153 reverting to the behavior in coreutils-9.0 and earlier.
154 This behavior is now documented.
156 ls --color now matches a file extension case sensitively
157 if there are different sequences defined for separate cases.
159 printf unicode \uNNNN, \UNNNNNNNN syntax, now supports all valid
160 unicode code points. Previously is was restricted to the C
161 universal character subset, which restricted most points <= 0x9F.
163 runcon now exits with status 125 for internal errors. Previously upon
164 internal errors it would exit with status 1, which was less distinguishable
165 from errors from the invoked command.
167 'split -n N' now splits more evenly when the input size is not a
168 multiple of N, by creating N output files whose sizes differ by at
169 most 1 byte. Formerly, it did this only when the input size was
172 'stat -c %s' now prints sizes as unsigned, consistent with 'ls'.
176 cksum now accepts the --base64 (-b) option to print base64-encoded
177 checksums. It also accepts/checks such checksums.
179 cksum now accepts the --raw option to output a raw binary checksum.
180 No file name or other information is output in this mode.
182 cp, mv, and install now accept the --debug option to
183 print details on how a file is being copied.
185 factor now accepts the --exponents (-h) option to print factors
186 in the form p^e, rather than repeating the prime p, e times.
188 ls now supports the --time=modification option, to explicitly
189 select the default mtime timestamp for display and sorting.
191 mv now supports the --no-copy option, which causes it to fail when
192 asked to move a file to a different file system.
194 split now accepts options like '-n SIZE' that exceed machine integer
195 range, when they can be implemented as if they were infinity.
197 split -n now accepts piped input even when not in round-robin mode,
198 by first copying input to a temporary file to determine its size.
200 wc now accepts the --total={auto,never,always,only} option
201 to give explicit control over when the total is output.
205 cp --sparse=auto (the default), mv, and install,
206 will use the copy_file_range syscall now also with sparse files.
207 This may be more efficient, by avoiding user space copies,
208 and possibly employing copy offloading or reflinking,
209 for the non sparse portion of such sparse files.
211 On macOS, cp creates a copy-on-write clone in more cases.
212 Previously cp would only do this when preserving mode and timestamps.
214 date --debug now diagnoses if multiple --date or --set options are
215 specified, as only the last specified is significant in that case.
217 rm outputs more accurate diagnostics in the presence of errors
218 when removing directories. For example EIO will be faithfully
219 diagnosed, rather than being conflated with ENOTEMPTY.
221 tail --follow=name now works with single non regular files even
222 when their modification time doesn't change when new data is available.
223 Previously tail would not show any new data in this case.
225 tee -p detects when all remaining outputs have become broken pipes, and
226 exits, rather than waiting for more input to induce an exit when written.
228 tee now handles non blocking outputs, which can be seen for example with
229 telnet or mpirun piping through tee to a terminal.
230 Previously tee could truncate data written to such an output and fail,
231 and also potentially output a "Resource temporarily unavailable" error.
234 * Noteworthy changes in release 9.1 (2022-04-15) [stable]
238 chmod -R no longer exits with error status when encountering symlinks.
239 All files would be processed correctly, but the exit status was incorrect.
240 [bug introduced in coreutils-9.0]
242 If 'cp -Z A B' checks B's status and some other process then removes B,
243 cp no longer creates B with a too-generous SELinux security context
244 before adjusting it to the correct value.
245 [bug introduced in coreutils-8.17]
247 'cp --preserve=ownership A B' no longer ignores the umask when creating B.
248 Also, 'cp --preserve-xattr A B' is less likely to temporarily chmod u+w B.
249 [bug introduced in coreutils-6.7]
251 On macOS, 'cp A B' no longer miscopies when A is in an APFS file system
252 and B is in some other file system.
253 [bug introduced in coreutils-9.0]
255 On macOS, fmt no longer corrupts multi-byte characters
256 by misdetecting their component bytes as spaces.
257 [This bug was present in "the beginning".]
259 'id xyz' now uses the name 'xyz' to determine groups, instead of xyz's uid.
260 [bug introduced in coreutils-8.22]
262 'ls -v' and 'sort -V' no longer mishandle corner cases like "a..a" vs "a.+"
263 or lines containing NULs. Their behavior now matches the documentation
264 for file names like ".m4" that consist entirely of an extension,
265 and the documentation has been clarified for unusual cases.
266 [bug introduced in coreutils-7.0]
268 On macOS, 'mv A B' no longer fails with "Operation not supported"
269 when A and B are in the same tmpfs file system.
270 [bug introduced in coreutils-9.0]
272 'mv -T --backup=numbered A B/' no longer miscalculates the backup number
273 for B when A is a directory, possibly inflooping.
274 [bug introduced in coreutils-6.3]
276 ** Changes in behavior
278 cat now uses the copy_file_range syscall if available, when doing
279 simple copies between regular files. This may be more efficient, by avoiding
280 user space copies, and possibly employing copy offloading or reflinking.
282 chown and chroot now warn about usages like "chown root.root f",
283 which have the nonstandard and long-obsolete "." separator that
284 causes problems on platforms where user names contain ".".
285 Applications should use ":" instead of ".".
287 cksum no longer allows abbreviated algorithm names,
288 so that forward compatibility and robustness is improved.
290 date +'%-N' now suppresses excess trailing digits, instead of always
291 padding them with zeros to 9 digits. It uses clock_getres and
292 clock_gettime to infer the clock resolution.
294 dd conv=fsync now synchronizes output even after a write error,
295 and similarly for dd conv=fdatasync.
297 dd now counts bytes instead of blocks if a block count ends in "B".
298 For example, 'dd count=100KiB' now copies 100 KiB of data, not
299 102,400 blocks of data. The flags count_bytes, skip_bytes and
300 seek_bytes are therefore obsolescent and are no longer documented,
301 though they still work.
303 ls no longer colors files with capabilities by default, as file-based
304 capabilties are very rarely used, and lookup increases processing per file by
305 about 30%. It's best to use getcap [-r] to identify files with capabilities.
307 ls no longer tries to automount files, reverting to the behavior
308 before the statx() call was introduced in coreutils-8.32.
310 stat no longer tries to automount files by default, reverting to the
311 behavior before the statx() call was introduced in coreutils-8.32.
312 Only `stat --cached=never` will continue to automount files.
314 timeout --foreground --kill-after=... will now exit with status 137
315 if the kill signal was sent, which is consistent with the behavior
316 when the --foreground option is not specified. This allows users to
317 distinguish if the command was more forcefully terminated.
321 dd now supports the aliases iseek=N for skip=N, and oseek=N for seek=N,
322 like FreeBSD and other operating systems.
324 dircolors takes a new --print-ls-colors option to display LS_COLORS
325 entries, on separate lines, colored according to the entry color code.
327 dircolors will now also match COLORTERM in addition to TERM environment
328 variables. The default config will apply colors with any COLORTERM set.
332 cp, mv, and install now use openat-like syscalls when copying to a directory.
333 This avoids some race conditions and should be more efficient.
335 On macOS, cp creates a copy-on-write clone if source and destination
336 are regular files on the same APFS file system, the destination does
337 not already exist, and cp is preserving mode and timestamps (e.g.,
340 The new 'date' option --resolution outputs the timestamp resolution.
342 With conv=fdatasync or conv=fsync, dd status=progress now reports
343 any extra final progress just before synchronizing output data,
344 since synchronizing can take a long time.
346 printf now supports printing the numeric value of multi-byte characters.
348 sort --debug now diagnoses issues with --field-separator characters
349 that conflict with characters possibly used in numbers.
351 'tail -f file | filter' now exits on Solaris when filter exits.
353 root invoked coreutils, that are built and run in single binary mode,
354 now adjust /proc/$pid/cmdline to be more specific to the utility
355 being run, rather than using the general "coreutils" binary name.
359 AIX builds no longer fail because some library functions are not found.
360 [bug introduced in coreutils-8.32]
363 * Noteworthy changes in release 9.0 (2021-09-24) [stable]
367 chmod -v no longer misreports modes of dangling symlinks.
368 [bug introduced in coreutils-5.3.0]
370 cp -a --attributes-only now never removes destination files,
371 even if the destination files are hardlinked, or the source
372 is a non regular file.
373 [bug introduced in coreutils-8.6]
375 csplit --suppress-matched now elides the last matched line
376 when a specific number of pattern matches are performed.
377 [bug introduced with the --suppress-matched feature in coreutils-8.22]
379 df no longer outputs duplicate remote mounts in the presence of bind mounts.
380 [bug introduced in coreutils-8.26]
382 df no longer mishandles command-line args that it pre-mounts
383 [bug introduced in coreutils-8.29]
385 du no longer crashes on XFS file systems when the directory hierarchy is
386 heavily changed during the run.
387 [bug introduced in coreutils-8.25]
389 env -S no longer crashes when given unusual whitespace characters
390 [bug introduced in coreutils-8.30]
392 expr no longer mishandles unmatched \(...\) in regular expressions.
393 [bug introduced in coreutils-6.0]
395 ls no longer crashes when printing the SELinux context for unstatable files.
396 [bug introduced in coreutils-6.9.91]
398 mkdir -m no longer mishandles modes more generous than the umask.
399 [bug introduced in coreutils-8.22]
401 nl now handles single character --section-delimiter arguments,
402 by assuming a second ':' character has been specified, as specified by POSIX.
403 [This bug was present in "the beginning".]
405 pr again adjusts tabs in input, to maintain alignment in multi column output.
406 [bug introduced in coreutils-6.9]
408 rm no longer skips an extra file when the removal of an empty directory fails.
409 [bug introduced by the rewrite to use fts in coreutils-8.0]
411 split --number=K/N will again correctly split chunk K of N to stdout.
412 Previously a chunk starting after 128KiB, output the wrong part of the file.
413 [bug introduced in coreutils-8.26]
415 tail -f no longer overruns a stack buffer when given too many files
416 to follow and ulimit -n exceeds 1024.
417 [bug introduced in coreutils-7.5]
419 tr no longer crashes when using --complement with certain
420 invalid combinations of case character classes.
421 [bug introduced in coreutils-8.6]
423 basenc --base64 --decode no longer silently discards decoded characters
424 on (1024*5) buffer boundaries
425 [bug introduced in coreutils-8.31]
427 ** Changes in behavior
429 cp and install now default to copy-on-write (COW) if available.
430 I.e., cp now uses --reflink=auto mode by default.
432 cp, install and mv now use the copy_file_range syscall if available.
433 Also, they use lseek+SEEK_HOLE rather than ioctl+FS_IOC_FIEMAP on sparse
434 files, as lseek is simpler and more portable.
436 On GNU/Linux systems, ls no longer issues an error message on a
437 directory merely because it was removed. This reverts a change
438 that was made in release 8.32.
440 ptx -T no longer attempts to substitute old-fashioned TeX escapes
441 for 8-bit non-ASCII alphabetic characters. TeX indexes should
442 instead use '\usepackage[latin1]{inputenc}' or equivalent.
444 stat will use decomposed (major,minor) device numbers in its default format.
445 This is less ambiguous, and more consistent with ls.
447 sum [-r] will output a file name, even if only a single name is passed.
448 This is consistent with sum -s, cksum, and other sum(1) implementations.
452 cksum now supports the -a (--algorithm) option to select any
453 of the existing sum, md5sum, b2sum, sha*sum implementations etc.
454 cksum now subsumes all of these programs, and coreutils
455 will introduce no future standalone checksum utility.
457 cksum -a now supports the 'sm3' argument, to use the SM3 digest algorithm.
459 cksum --check now supports auto detecting the digest type to use,
460 when verifying tagged format checksums.
462 expr and factor now support bignums on all platforms.
464 ls --classify now supports the "always", "auto", or "never" flags,
465 to support only outputting classifier characters if connected to a tty.
467 ls now accepts the --sort=width option, to sort by file name width.
468 This is useful to more compactly organize the default vertical column output.
470 ls now accepts the --zero option, to terminate each output line with
471 NUL instead of newline.
473 nl --line-increment can now take a negative number to decrement the count.
475 stat supports more formats for representing decomposed device numbers.
476 %Hd,%Ld and %Hr,%Lr will output major,minor device numbers and device types
477 respectively. %d corresponds to st_dev and %r to std_rdev.
481 cat --show-ends will now show \r\n as ^M$. Previously the \r was taken
482 literally, thus overwriting the first character in the line with '$'.
484 cksum [-a crc] is now up to 4 times faster by using a slice by 8 algorithm,
485 and at least 8 times faster where pclmul instructions are supported.
486 A new --debug option will indicate if pclmul is being used.
488 md5sum --check now supports checksum files with CRLF line endings.
489 This also applies to cksum, sha*sum, and b2sum.
491 df now recognizes these file systems as remote:
492 acfs, coda, fhgfs, gpfs, ibrix, ocfs2, and vxfs.
494 rmdir now clarifies the error if a symlink_to_dir/ has not been traversed.
495 This is the case on GNU/Linux systems, where the trailing slash is ignored.
497 stat and tail now know about the "devmem", "exfat", "secretmem", "vboxsf",
498 and "zonefs" file system types. stat -f -c%T now reports the file system
499 type, and tail -f uses polling for "vboxsf" and inotify for the others.
501 timeout now supports sub-second timeouts on macOS.
503 wc is up to 5 times faster when counting only new line characters,
504 where avx2 instructions are supported.
505 A new --debug option will indicate if avx2 is being used.
508 * Noteworthy changes in release 8.32 (2020-03-05) [stable]
512 cp now copies /dev/fd/N correctly on platforms like Solaris where
513 it is a character-special file whose minor device number is N.
514 [bug introduced in fileutils-4.1.6]
516 dd conv=fdatasync no longer reports a "Bad file descriptor" error
517 when fdatasync is interrupted, and dd now retries interrupted calls
518 to close, fdatasync, fstat and fsync instead of incorrectly
519 reporting an "Interrupted system call" error.
520 [bugs introduced in coreutils-6.0]
522 df now correctly parses the /proc/self/mountinfo file for unusual entries
523 like ones with '\r' in a field value ("mount -t tmpfs tmpfs /foo$'\r'bar"),
524 when the source field is empty ('mount -t tmpfs "" /mnt'), and when the
525 filesystem type contains characters like a blank which need escaping.
526 [bugs introduced in coreutils-8.24 with the introduction of reading
527 the /proc/self/mountinfo file]
529 factor again outputs immediately when stdout is a tty but stdin is not.
530 [bug introduced in coreutils-8.24]
532 ln works again on old systems without O_DIRECTORY support (like Solaris 10),
533 and on systems where symlink ("x", ".") fails with errno == EINVAL
534 (like Solaris 10 and Solaris 11).
535 [bug introduced in coreutils-8.31]
537 rmdir --ignore-fail-on-non-empty now works correctly for directories
538 that fail to be removed due to permission issues. Previously the exit status
539 was reversed, failing for non empty and succeeding for empty directories.
540 [bug introduced in coreutils-6.11]
542 'shuf -r -n 0 file' no longer mistakenly reads from standard input.
543 [bug introduced with the --repeat feature in coreutils-8.22]
545 split no longer reports a "output file suffixes exhausted" error
546 when the specified number of files is evenly divisible by 10, 16, 26,
547 for --numeric, --hex, or default alphabetic suffixes respectively.
548 [bug introduced in coreutils-8.24]
550 seq no longer prints an extra line under certain circumstances (such as
551 'seq -f "%g " 1000000 1000000').
552 [bug introduced in coreutils-6.10]
554 ** Changes in behavior
556 Several programs now check that numbers end properly. For example,
557 'du -d 1x' now reports an error instead of silently ignoring the 'x'.
558 Affected programs and options include du -d, expr's numeric operands
559 on non-GMP builds, install -g and -o, ls's TABSIZE environment
560 variable, mknod b and c, ptx -g and -w, shuf -n, and sort --batch-size
563 date now parses military time zones in accordance with common usage:
564 "A" to "M" are equivalent to UTC+1 to UTC+12
565 "N" to "Y" are equivalent to UTC-1 to UTC-12
566 "Z" is "zulu" time (UTC).
567 For example, 'date -d "09:00B" is now equivalent to 9am in UTC+2 time zone.
568 Previously, military time zones were parsed according to the obsolete
569 rfc822, with their value negated (e.g., "B" was equivalent to UTC-2).
570 [The old behavior was introduced in sh-utils 2.0.15 ca. 1999, predating
573 date now pads nanoseconds on the right, not the left. For example,
574 if the time is currently 1590020079.003388470 seconds after the
575 Epoch, then "date '+%s.%-N'" formerly output "1590020079.3388470",
576 and it now outputs "1590020079.00338847".
578 ls issues an error message on a removed directory, on GNU/Linux systems.
579 Previously no error and no entries were output, and so indistinguishable
580 from an empty directory, with default ls options.
582 uniq no longer uses strcoll() to determine string equivalence,
583 and so will operate more efficiently and consistently.
587 ls now supports the --time=birth option to display and sort by
588 file creation time, where available.
590 od --skip-bytes now can use lseek even if the input is not a regular
591 file, greatly improving performance in some cases.
593 stat(1) supports a new --cached= option, used on systems with statx(2)
594 to control cache coherency of file system attributes,
595 useful on network file systems.
599 stat and ls now use the statx() system call where available, which can
600 operate more efficiently by only retrieving requested attributes.
602 stat and tail now know about the "binderfs", "dma-buf-fs", "erofs",
603 "ppc-cmm-fs", and "z3fold" file systems.
604 stat -f -c%T now reports the file system type, and tail -f uses inotify.
608 gzip-compressed tarballs are distributed once again
611 * Noteworthy changes in release 8.31 (2019-03-10) [stable]
615 'base64 a b' now correctly diagnoses 'b' as the extra operand, not 'a'.
616 [bug introduced in coreutils-5.3.0]
618 When B already exists, 'cp -il A B' no longer immediately fails
619 after asking the user whether to proceed.
620 [This bug was present in "the beginning".]
622 df no longer corrupts displayed multibyte characters on macOS.
623 [bug introduced with coreutils-8.18]
625 seq no longer outputs inconsistent decimal point characters
626 for the last number, when locales are misconfigured.
627 [bug introduced in coreutils-7.0]
629 shred, sort, and split no longer falsely report ftruncate errors
630 when outputting to less-common file types. For example, the shell
631 command 'sort /dev/null -o /dev/stdout | cat' no longer fails with
632 an "error truncating" diagnostic.
633 [bug was introduced with coreutils-8.18 for sort and split, and
634 (for shared memory objects only) with fileutils-4.1 for shred]
636 sync no longer fails for write-only file arguments.
637 [bug introduced with argument support to sync in coreutils-8.24]
639 'tail -f file | filter' no longer exits immediately on AIX.
640 [bug introduced in coreutils-8.28]
642 'tail -f file | filter' no longer goes into an infinite loop
643 if filter exits and SIGPIPE is ignored.
644 [bug introduced in coreutils-8.28]
646 ** Changes in behavior
648 cksum, dd, hostid, hostname, link, logname, sleep, tsort, unlink,
649 uptime, users, whoami, yes: now always process --help and --version options,
650 regardless of any other arguments present before any optional '--'
651 end-of-options marker.
653 nohup now processes --help and --version as first options even if other
656 'yes a -- b' now outputs 'a b' instead of including the end-of-options
657 marker as before: 'a -- b'.
659 echo now always processes backslash escapes when the POSIXLY_CORRECT
660 environment variable is set.
662 When possible 'ln A B' now merely links A to B and reports an error
663 if this fails, instead of statting A and B before linking. This
664 uses fewer system calls and avoids some races. The old statting
665 approach is still used in situations where hard links to directories
666 are allowed (e.g., NetBSD when superuser).
668 ls --group-directories-first will also group symlinks to directories.
670 'test -a FILE' is not supported anymore. Long ago, there were concerns about
671 the high probability of humans confusing the -a primary with the -a binary
672 operator, so POSIX changed this to 'test -e FILE'. Scripts using it were
673 already broken and non-portable; the -a unary operator was never documented.
675 wc now treats non breaking space characters as word delimiters
676 unless the POSIXLY_CORRECT environment variable is set.
680 id now supports specifying multiple users.
682 'date' now supports the '+' conversion specification flag,
683 introduced in POSIX.1-2017.
685 printf, seq, sleep, tail, and timeout now accept floating point
686 numbers in either the current or the C locale. For example, if the
687 current locale's decimal point is ',', 'sleep 0,1' and 'sleep 0.1'
688 now mean the same thing. Previously, these commands accepted only
689 C-locale syntax with '.' as the decimal point. The new behavior is
690 more compatible with other implementations in non-C locales.
692 test now supports the '-N FILE' unary operator (like e.g. bash) to check
693 whether FILE exists and has been modified since it was last read.
695 env now supports '--default-signal[=SIG]', '--ignore-signal[=SIG]', and
696 '--block-signal[=SIG], to setup signal handling before executing a program.
698 env now supports '--list-signal-handling' to indicate non-default
699 signal handling before executing a program.
703 basenc is added to complement existing base64,base32 commands,
704 and encodes and decodes printable text using various common encodings:
705 base64,base64url,base32,base32hex,base16,base2,z85.
709 ls -l now better aligns abbreviated months containing digits,
710 which is common in Asian locales.
712 stat and tail now know about the "sdcardfs" file system on Android.
713 stat -f -c%T now reports the file system type, and tail -f uses inotify.
715 stat now prints file creation time when supported by the file system,
716 on GNU Linux systems with glibc >= 2.28 and kernel >= 4.11.
719 * Noteworthy changes in release 8.30 (2018-07-01) [stable]
723 'cp --symlink SRC DST' will again correctly validate DST.
724 If DST is a regular file and SRC is a symlink to DST,
725 then cp will no longer allow that operation to clobber DST.
726 Also with -d, if DST is a symlink, then it can always be replaced,
727 even if it points to SRC on a separate device.
728 [bugs introduced with coreutils-8.27]
730 'cp -n -u' and 'mv -n -u' now consistently ignore the -u option.
731 Previously, this option combination suffered from race conditions
732 that caused -u to sometimes override -n.
733 [bug introduced with coreutils-7.1]
735 'cp -a --no-preserve=mode' now sets appropriate default permissions
736 for non regular files like fifos and character device nodes etc.,
737 and leaves mode bits of existing files unchanged.
738 Previously it would have set executable bits on created special files,
739 and set mode bits for existing files as if they had been created.
740 [bug introduced with coreutils-8.20]
742 'cp --remove-destination file symlink' now removes the symlink
743 even if it can't be traversed.
744 [bug introduced with --remove-destination in fileutils-4.1.1]
746 ls no longer truncates the abbreviated month names that have a
747 display width between 6 and 12 inclusive. Previously this would have
748 output ambiguous months for Arabic or Catalan locales.
750 'ls -aA' is now equivalent to 'ls -A', since -A now overrides -a.
751 [bug introduced in coreutils-5.3.0]
753 'mv -n A B' no longer suffers from a race condition that can
754 overwrite a simultaneously-created B. This bug fix requires
755 platform support for the renameat2 or renameatx_np syscalls, found
756 in recent Linux and macOS kernels. As a side effect, 'mv -n A A'
757 now silently does nothing if A exists.
758 [bug introduced with coreutils-7.1]
760 ** Changes in behavior
762 'cp --force file symlink' now removes the symlink even if
763 it is self referential.
765 ls --color now matches file extensions case insensitively.
769 cp --reflink now supports --reflink=never to enforce a standard copy.
771 env supports a new -v/--debug option to show verbose information about
772 each processing step.
774 env supports a new -S/--split-string=S option to split a single argument
775 string into multiple arguments. Used to pass multiple arguments in scripts
778 md5sum accepts a new option: --zero (-z) to delimit the output lines with a
779 NUL instead of a newline character. This also disables file name escaping.
780 This also applies to sha*sum and b2sum.
782 rm --preserve-root now supports the --preserve-root=all option to
783 reject any command line argument that is mounted to a separate file system.
787 cut supports line lengths up to the max file size on 32 bit systems.
788 Previously only offsets up to SIZE_MAX-1 were supported.
790 stat and tail now know about the "exfs" file system, which is a
791 version of XFS. stat -f --format=%T now reports the file system type,
792 and tail -f uses inotify.
794 wc avoids redundant processing of ASCII text in multibyte locales,
795 which is especially significant on macOS.
798 * Noteworthy changes in release 8.29 (2017-12-27) [stable]
802 b2sum no longer crashes when processing certain truncated check files.
803 [bug introduced with b2sum coreutils-8.26]
805 dd now ensures the correct cache ranges are specified for the "nocache"
806 and "direct" flags. Previously some pages in the page cache were not
807 invalidated. [bug introduced for "direct" in coreutils-7.5,
808 and with the "nocache" implementation in coreutils-8.11]
810 df no longer hangs when given a fifo argument.
811 [bug introduced in coreutils-7.3]
813 ptx -S no longer infloops for a pattern which returns zero-length matches.
814 [the bug dates back to the initial implementation]
816 shred --remove will again repeatedly rename files with shortening names
817 to attempt to hide the original length of the file name.
818 [bug introduced in coreutils-8.28]
820 stty no longer crashes when processing settings with -F also specified.
821 [bug introduced in fileutils-4.0]
823 tail --bytes again supports non seekable inputs on all systems.
824 On systems like android it always tried to process as seekable inputs.
825 [bug introduced in coreutils-8.24]
827 timeout will again notice its managed command exiting, even when
828 invoked with blocked CHLD signal, or in a narrow window where
829 this CHLD signal from the exiting child was missed. In each case
830 timeout would have then waited for the time limit to expire.
831 [bug introduced in coreutils-8.27]
835 timeout now supports the --verbose option to diagnose forced termination.
839 dd now supports iflag=direct with arbitrary sized files on all file systems.
841 tail --bytes=NUM will efficiently seek to the end of block devices,
842 rather than reading from the start.
844 Utilities which do not support long options (other than the default --help
845 and --version), e.g. cksum and sleep, now use more consistent error diagnostic
846 for unknown long options.
850 Default man pages are now distributed which are used if perl is
851 not available on the build system, or when cross compiling.
854 * Noteworthy changes in release 8.28 (2017-09-01) [stable]
858 cp and mv now merely warn about any failure to preserve symlink ownership.
859 Before, cp (without -p) would exit with a failure status, and a cross-device
860 mv would leave such symlinks behind in the source file system.
861 [the bug dates back to the initial implementation]
863 When creating numbered backups, cp, install, ln, and mv now avoid
864 races that could lose backup data in unlikely circumstances. Since
865 the fix relies on the renameat2 system call of Linux kernel 3.15 and
866 later, the races are still present on other platforms.
867 [the bug dates back to the initial implementation]
869 cp, install, ln, and mv no longer lose data when asked to copy a
870 backup file to its original via a differently-spelled file name.
871 E.g., 'rm -f a a~; : > a; echo data > a~; cp --backup=simple a~ ./a'
872 now fails instead of losing the data.
873 [the bug dates back to the initial implementation]
875 cp, install, ln, and mv now ignore nonsensical backup suffixes.
876 For example, --suffix='/' and --suffix='' are now no-ops.
877 [the bug dates back to the initial implementation]
879 date and touch no longer overwrite the heap with large
880 user specified TZ values (CVE-2017-7476).
881 [bug introduced in coreutils-8.27]
883 dd status=progress now just counts seconds; e.g., it outputs "6 s"
884 consistently rather than sometimes outputting "6.00001 s".
885 [bug introduced in coreutils-8.24]
887 df no longer interacts with excluded file system types, so for example
888 specifying -x nfs no longer hangs with problematic nfs mounts.
889 [bug introduced in coreutils-8.21]
891 df no longer interacts with dummy file system types, so for example
892 no longer hangs with problematic nfs mounted via system.automount(5).
893 [bug introduced in coreutils-8.21]
895 `groups inva:lid root` no longer exits immediately upon failure.
896 Now, it prints a diagnostic or a line to stdout for each argument.
897 [bug introduced in the bourne-shell-to-C rewrite for coreutils-6.11]
899 kill now converts from number to signal name correctly on AIX.
900 Previously it would have always returned the 'EXIT' name.
901 [bug introduced in fileutils-4.1.9]
903 ls now quotes symlink targets consistently. Previously it may not
904 have quoted the target name if the link name itself didn't need quoting.
905 [bug introduced in coreutils-8.26]
907 split no longer exits when invocations of a --filter return EPIPE.
908 [bug introduced in coreutils-8.26]
910 md5sum --check no longer incorrectly enables BSD reversed format mode when
911 ignoring some non checksum lines. This also affects sha*sum and b2sum.
912 [bug introduced in coreutils-8.14]
914 tail -F 'dir/file' is now monitored even when 'dir' is replaced.
915 [bug introduced with inotify support added in coreutils-7.5]
917 tail -f with --pid=PID now processes all inotify events.
918 Previously events may have been ignored completely upon PID death,
919 or ignored until future events on the monitored files.
920 [bug introduced with inotify support added in coreutils-7.5]
922 tail -f /dev/tty is now supported by not using inotify when any
923 non regular files are specified, as inotify is ineffective with these.
924 [bug introduced with inotify support added in coreutils-7.5]
926 uptime no longer outputs the AM/PM component of the current time,
927 as that's inconsistent with the 24 hour time format used.
928 [bug introduced in coreutils-7.0]
930 expr now returns number of characters matched (instead of incorrect
931 number of bytes matched) with 'match'/':' operators on multibyte strings.
935 expand and unexpand now support specifying an offset for tab stops
936 by prefixing the last specified number like --tabs=1,+8 which is
937 useful for visualizing diff output for example.
939 ls supports a new --hyperlink[=when] option to output file://
940 format links to files, supported by some terminals.
942 split supports a new --hex-suffixes[=from] option to create files with
943 lower case hexadecimal suffixes, similar to the --numeric-suffixes option.
945 env now has a --chdir (-C) option to change the working directory before
946 executing the subsidiary program.
948 expr supports multibyte strings for all string operations.
950 ** Changes in behavior
952 tail -f now exits immediately if the output is piped and the reader of
953 the pipe terminates. That allows `tail -f file | grep -q foo` to return
954 responsively, but does make `tail -f file | :` exit immediately without
955 waiting for data. Instead one should now `tail -f file | grep -q .`
959 mv --verbose now distinguishes rename and copy operations.
961 stat -f -c %l, used to output the max file name length on a file system,
962 is now supported on FreeBSD and OpenBSD.
964 tail -f no longer erroneously warns about being ineffective
965 when following a single tty, as the simple blocking loop used
966 is effective in this case.
969 * Noteworthy changes in release 8.27 (2017-03-08) [stable]
973 cp --parents will now set an SELinux context for created directories,
974 as appropriate for the -a, --preseve=context, or -Z options.
975 [bug present since SELinux support added in coreutils-6.10]
977 date again converts from a specified time zone. Previously output was
978 not converted to the local time zone, and remained in the specified one.
979 [bug introduced in coreutils-8.26]
981 Commands like 'cp --no-dereference -l A B' are no longer quiet no-ops
982 when A is a regular file and B is a symbolic link that points to A.
983 [bug introduced in fileutils-4.0]
985 factor no longer goes into an infinite loop for certain numbers like
986 158909489063877810457 and 222087527029934481871.
987 [bug introduced in coreutils-8.20]
989 tail no longer prints redundant file headers with interleaved inotify events,
990 which could be triggered especially when tail was suspended and resumed.
991 [bug introduced with inotify support added in coreutils-7.5]
993 timeout no longer has a race that may terminate the wrong process.
994 The race is unlikely, as timeout(1) needs to receive a signal right
995 after the command being monitored finishes. Also the system needs
996 to have reallocated that command's pid in that short time window.
997 [bug introduced when timeout was added in coreutils-7.0]
999 wc --bytes --files0-from now correctly reports byte counts.
1000 Previously it may have returned values that were too large,
1001 depending on the size of the first file processed.
1002 [bug introduced in coreutils-8.24]
1006 The new 'date' option --rfc-email is now the long form for -R.
1007 The new option spelling is intended to avoid the need to track the
1008 Internet RFC number for email dates (currently RFC 5322). The old
1009 option spellings --rfc-2822 and --rfc-822 still work.
1011 date now outputs "-00" for a numeric time zone if the time is UTC
1012 and the time zone abbreviation begins with "-", indicating that the
1013 time zone is indeterminate.
1015 nproc now honors the OMP_THREAD_LIMIT environment variable to
1016 set the maximum returned value. OMP_NUM_THREADS continues to
1017 set the minimum returned value, but is updated to support the
1018 nested level syntax allowed in this variable.
1020 stat and tail now know about the "rdt" file system, which is an interface
1021 to Resource Director Technology. stat -f --format=%T now reports the
1022 file system type, and tail -f uses inotify.
1024 stty now validates arguments before interacting with the device,
1025 ensuring there are no side effects to specifying an invalid option.
1027 If the file B already exists, commands like 'ln -f A B' and
1028 'cp -fl A B' no longer remove B before creating the new link.
1029 That is, there is no longer a brief moment when B does not exist.
1033 expand and unexpand now support specifying a tab size to use
1034 after explicitly specified tab stops, by prefixing the last
1035 specified number like --tabs=2,4,/8.
1038 * Noteworthy changes in release 8.26 (2016-11-30) [stable]
1042 cp, mv, and install no longer run into undefined behavior when
1043 handling ACLs on Cygwin and Solaris platforms. [bug introduced in
1046 cp --parents --no-preserve=mode, no longer copies permissions from source
1047 directories, instead using default permissions for created directories.
1048 [bug introduced in coreutils-5.93]
1050 chcon, chgrp, chmod, chown, du, and rm, or specifically utilities
1051 using the FTS interface, now diagnose failures returned by readdir().
1052 [this bug was inherent in the use of fts: thus, for rm the bug was
1053 introduced in coreutils-8.0. du, chmod, chgrp and chown started using
1054 fts in 6.0. chcon was added in coreutils-6.9.91 with fts support. ]
1056 date, du, ls, and pr no longer mishandle time zone abbreviations on
1057 System V style platforms where this information is available only
1058 in the global variable 'tzname'. [bug introduced in coreutils-8.24]
1060 factor again outputs immediately when numbers are input interactively.
1061 [bug introduced in coreutils-8.24]
1063 head no longer tries to process non-seekable input as seekable,
1064 which resulted in failures on FreeBSD 11 at least.
1065 [bug introduced in coreutils-8.24]
1067 install -DZ and mkdir -pZ now set default SELinux context correctly even if
1068 two or more directories nested in each other are created and each of them
1069 defaults to a different SELinux context.
1071 ls --time-style no longer mishandles '%%b' in formats.
1072 [bug introduced in coreutils-7.2]
1074 md5sum --check --ignore-missing no longer treats files with checksums
1075 starting with "00" as missing. This also affects sha*sum.
1076 [bug introduced with the --ignore-missing feature in coreutils-8.25]
1078 nl now resets numbering for each page section rather than just for each page.
1079 [This bug was present in "the beginning".]
1081 pr now handles specified separator strings containing tabs correctly.
1082 Previously it would have output random data from memory.
1083 [This bug was detected with ASAN and present in "the beginning".]
1085 sort -h -k now works even in locales that use blank as thousands separator.
1087 stty --help no longer outputs extraneous gettext header lines
1088 for translated languages. [bug introduced in coreutils-8.24]
1090 stty "sane" again sets "susp" to ^z on Solaris, and leaves "swtch" undefined.
1091 [This bug previously fixed only on some older Solaris systems]
1093 seq now immediately exits upon write errors.
1094 [This bug was present in "the beginning".]
1096 tac no longer crashes when there are issues reading from non-seekable inputs.
1097 [bug introduced in coreutils-8.15]
1099 tail -F now continues to process initially untailable files that are replaced
1100 by a tailable file. This was handled correctly when inotify was available,
1101 and is now handled correctly in all cases.
1102 [bug introduced in fileutils-4.0h]
1104 tail -f - 'untailable file' will now terminate when there is no more data
1105 to read from stdin. Previously it behaved as if --retry was specified.
1106 [This bug was present in "the beginning".]
1108 tail -f 'remote file' will now avoid outputting repeated data on network
1109 file systems that misreport file sizes through stale metadata.
1110 [This bug was present in "the beginning" but exacerbated in coreutils-8.24]
1112 tail -f --retry 'missing file' will now process truncations of that file.
1113 Previously truncation was ignored thus not outputting new data in the file.
1114 [bug introduced in coreutils-5.3.0]
1116 tail -f will no longer continually try to open inaccessible files,
1117 only doing so if --retry is specified.
1118 [This bug was present in "the beginning".]
1120 yes now handles short writes, rather than assuming all writes complete.
1121 [bug introduced in coreutils-8.24]
1123 ** Changes in behavior
1125 rm no longer accepts shortened variants of the --no-preserve-root option.
1127 seq no longer accepts 0 value as increment, and now also rejects NaN
1128 values for any argument.
1130 stat now outputs nanosecond information for timestamps even if
1131 they are out of localtime range.
1133 sort, tail, and uniq now support traditional usage like 'sort +2'
1134 and 'tail +10' on systems conforming to POSIX 1003.1-2008 and later.
1135 The 2008 edition of POSIX dropped the requirement that arguments
1136 like '+2' must be treated as file names.
1140 dd now warns about counts specified with a 0x "prefix", since dd will
1141 interpret those as a zero multiplier rather than a hex constant.
1142 The warning suggests to use 00x if a zero multiplier is really intended.
1144 df now filters the system mount list more efficiently, with 20000
1145 mount entries now being processed in about 1.1s compared to 1.7s.
1147 du, shuf, sort, and uniq no longer fail to process a specified file
1148 when their stdin is closed, which would have happened with glibc >= 2.14.
1150 install -Z now also sets the default SELinux context for created directories.
1152 ls is now fully responsive to signals until the first escape sequence is
1153 written to a terminal.
1155 ls now aligns quoted items with non quoted items, which is easier to read,
1156 and also better indicates that the quote is not part of the actual name.
1158 stat and tail now know about these file systems:
1159 "balloon-kvm-fs" KVM dynamic RAM allocation support,
1160 "cgroup2" Linux Control Groups V2 support,
1161 "daxfs" Optical media file system,
1162 "m1fs" A Plexistor file system,
1163 "prl_fs" A parallels file system,
1164 "smb2" Samba for SMB protocol V2,
1165 "wslfs" Windows Subsystem for Linux,
1166 "zsmalloc" Linux compressed swap support,
1167 stat -f --format=%T now reports the file system type, and
1168 tail -f uses polling for "prl_fs" and "smb2", and inotify for others.
1170 stat --format=%N for quoting file names now honors the
1171 same QUOTING_STYLE environment variable values as ls.
1175 b2sum is added to support the BLAKE2 digest algorithm with
1176 a similar interface to the existing md5sum and sha1sum, etc. commands.
1180 comm now accepts the --total option to output a summary at the end.
1182 date now accepts the --debug option, to annotate the parsed date string,
1183 display timezone information, and warn about potential misuse.
1185 date now accepts the %q format to output the quarter of the year.
1188 * Noteworthy changes in release 8.25 (2016-01-20) [stable]
1192 cp now correctly copies files with a hole at the end of the file,
1193 and extents allocated beyond the apparent size of the file.
1194 That combination resulted in the trailing hole not being reproduced.
1195 [bug introduced in coreutils-8.10]
1197 cut --fields no longer outputs extraneous characters on some uClibc configs.
1198 [bug introduced in coreutils-6.11]
1200 install -D again copies relative file names when absolute file names
1201 are also specified along with an absolute destination directory name.
1202 [bug introduced in coreutils-6.2]
1204 ls no longer prematurely wraps lines when printing short file names.
1205 [bug introduced in coreutils-5.1.0]
1207 mv no longer causes data loss due to removing a source directory specified
1208 multiple times, when that directory is also specified as the destination.
1209 [bug introduced in coreutils-8.24]
1211 shred again uses defined patterns for all iteration counts.
1212 [bug introduced in coreutils-5.93]
1214 sort --debug -b now correctly marks the matching extents for keys
1215 that specify an offset for the first field.
1216 [bug introduced with the --debug feature in coreutils-8.6]
1218 tail -F now works with initially non existent files on a remote file system.
1219 [bug introduced in coreutils-7.5]
1223 base32 is added to complement the existing base64 command,
1224 and encodes and decodes printable text as per RFC 4648.
1228 comm,cut,head,numfmt,paste,tail now have the -z,--zero-terminated option, and
1229 tac --separator accepts an empty argument, to work with NUL delimited items.
1231 dd now summarizes sizes in --human-readable format too, not just --si.
1232 E.g., "3441325000 bytes (3.4 GB, 3.2 GiB) copied". It omits the summaries
1233 if they would not provide useful information, e.g., "3 bytes copied".
1234 Its status=progress output now uses the same format as ordinary status,
1235 perhaps with trailing spaces to erase previous progress output.
1237 md5sum now supports the --ignore-missing option to allow
1238 verifying a subset of files given a larger list of checksums.
1239 This also affects sha1sum, sha224sum, sha256sum, sha384sum and sha512sum.
1241 printf now supports the '%q' format to print arguments in a form that
1242 is reusable by most shells, with non-printable characters escaped
1243 with the POSIX proposed $'...' syntax.
1245 stty now supports the "[-]drain" setting to control whether to wait
1246 for transmission of pending output before application of settings.
1248 ** Changes in behavior
1250 base64 no longer supports hex or oct --wrap parameters,
1251 thus better supporting decimals with leading zeros.
1253 date --iso-8601 now uses +00:00 timezone format rather than +0000.
1254 The standard states to use this "extended" format throughout a timestamp.
1256 df now prefers sources towards the root of a device when
1257 eliding duplicate bind mounted entries.
1259 ls now quotes file names unambiguously and appropriate for use in a shell,
1260 when outputting to a terminal.
1262 join, sort, uniq with --zero-terminated, now treat '\n' as a field delimiter.
1266 All utilities now quote user supplied arguments in error strings,
1267 which avoids confusing error messages in the presence of '\r' chars etc.
1269 Utilities that traverse directories, like chmod, cp, and rm etc., will operate
1270 more efficiently on XFS through the use of "leaf optimization".
1272 md5sum now ensures a single line per file for status on standard output,
1273 by using a '\' at the start of the line, and replacing any newlines with '\n'.
1274 This also affects sha1sum, sha224sum, sha256sum, sha384sum and sha512sum.
1276 dircolors now supports globbing of TERM entries in its database.
1277 For example "TERM *256color*" is now supported.
1279 du no longer stats all mount points at startup, only doing so
1280 upon detection of a directory cycle.
1281 [issue introduced in coreutils-8.20]
1283 ls -w0 is now interpreted as no limit on the length of the outputted line.
1285 stat -f --format=%T now reports the file system type for new Linux
1286 pseudo file systems "bpf_fs", "btrfs_test", "nsfs", "overlayfs"
1287 and "tracefs", and remote file system "acfs".
1289 wc now ensures a single line per file for counts on standard output,
1290 by quoting names containing '\n' characters; appropriate for use in a shell.
1293 * Noteworthy changes in release 8.24 (2015-07-03) [stable]
1297 dd supports more robust SIGINFO/SIGUSR1 handling for outputting statistics.
1298 Previously those signals may have inadvertently terminated the process.
1300 df --local no longer hangs with inaccessible remote mounts.
1301 [bug introduced in coreutils-8.21]
1303 du now silently ignores all directory cycles due to bind mounts.
1304 Previously it would issue a warning and exit with a failure status.
1305 [bug introduced in coreutils-8.1 and partially fixed in coreutils-8.23]
1307 chroot again calls chroot(DIR) and chdir("/"), even if DIR is "/".
1308 This handles separate bind mounted "/" trees, and environments
1309 depending on the implicit chdir("/").
1310 [bugs introduced in coreutils-8.23]
1312 cp no longer issues an incorrect warning about directory hardlinks when a
1313 source directory is specified multiple times. Now, consistent with other
1314 file types, a warning is issued for source directories with duplicate names,
1315 or with -H the directory is copied again using the symlink name.
1317 factor avoids writing partial lines, thus supporting parallel operation.
1318 [the bug dates back to the initial implementation]
1320 head, od, split, tac, tail, and wc no longer mishandle input from files in
1321 /proc and /sys file systems that report somewhat-incorrect file sizes.
1323 mkdir --parents -Z now correctly sets the context for the last component,
1324 even if the parent directory exists and has a different default context.
1325 [bug introduced with the -Z restorecon functionality in coreutils-8.22]
1327 numfmt no longer outputs incorrect overflowed values seen with certain
1328 large numbers, or with numbers with increased precision.
1329 [bug introduced when numfmt was added in coreutils-8.21]
1331 numfmt now handles leading zeros correctly, not counting them when
1332 settings processing limits, and making them optional with floating point.
1333 [bug introduced when numfmt was added in coreutils-8.21]
1335 paste no longer truncates output for large input files. This would happen
1336 for example with files larger than 4GiB on 32 bit systems with a '\n'
1337 character at the 4GiB position.
1338 [the bug dates back to the initial implementation]
1340 rm indicates the correct number of arguments in its confirmation prompt,
1341 on all platforms. [bug introduced in coreutils-8.22]
1343 shuf -i with a single redundant operand, would crash instead of issuing
1344 a diagnostic. [bug introduced in coreutils-8.22]
1346 tail releases inotify resources when unused. Previously it could exhaust
1347 resources with many files, or with -F if files were replaced many times.
1348 [bug introduced in coreutils-7.5]
1350 tail -f again follows changes to a file after it's renamed.
1351 [bug introduced in coreutils-7.5]
1353 tail --follow no longer misses changes to files if those files were
1354 replaced before inotify watches were created.
1355 [bug introduced in coreutils-7.5]
1357 tail --follow consistently outputs all data for a truncated file.
1358 [bug introduced in the beginning]
1360 tail --follow=name correctly outputs headers for multiple files
1361 when those files are being created or renamed.
1362 [bug introduced in coreutils-7.5]
1366 chroot accepts the new --skip-chdir option to not change the working directory
1367 to "/" after changing into the chroot(2) jail, thus retaining the current wor-
1368 king directory. The new option is only permitted if the new root directory is
1369 the old "/", and therefore is useful with the --group and --userspec options.
1371 dd accepts a new status=progress level to print data transfer statistics
1372 on stderr approximately every second.
1374 numfmt can now process multiple fields with field range specifications similar
1375 to cut, and supports setting the output precision with the --format option.
1377 split accepts a new --separator option to select a record separator character
1378 other than the default newline character.
1380 stty allows setting the "extproc" option where supported, which is
1381 a useful setting with high latency links.
1383 sync no longer ignores arguments, and syncs each specified file, or with the
1384 --file-system option, the file systems associated with each specified file.
1386 tee accepts a new --output-error option to control operation with pipes
1387 and output errors in general.
1389 ** Changes in behavior
1391 df no longer suppresses separate exports of the same remote device, as
1392 these are generally explicitly mounted. The --total option does still
1393 suppress duplicate remote file systems.
1394 [suppression was introduced in coreutils-8.21]
1396 mv no longer supports moving a file to a hardlink, instead issuing an error.
1397 The implementation was susceptible to races in the presence of multiple mv
1398 instances, which could result in both hardlinks being deleted. Also on case
1399 insensitive file systems like HFS, mv would just remove a hardlinked 'file'
1400 if called like `mv file File`. The feature was added in coreutils-5.0.1.
1402 numfmt --from-unit and --to-unit options now interpret suffixes as SI units,
1403 and IEC (power of 2) units are now specified by appending 'i'.
1405 tee will exit early if there are no more writable outputs.
1407 tee does not treat the file operand '-' as meaning standard output any longer,
1408 for better conformance to POSIX. This feature was added in coreutils-5.3.0.
1410 timeout --foreground no longer sends SIGCONT to the monitored process,
1411 which was seen to cause intermittent issues with GDB for example.
1415 cp,install,mv will convert smaller runs of NULs in the input to holes,
1416 and cp --sparse=always avoids speculative preallocation on XFS for example.
1418 cp will read sparse files more efficiently when the destination is a
1419 non regular file. For example when copying a disk image to a device node.
1421 mv will try a reflink before falling back to a standard copy, which is
1422 more efficient when moving files across BTRFS subvolume boundaries.
1424 stat and tail now know about IBRIX. stat -f --format=%T now reports the file
1425 system type, and tail -f uses polling for files on IBRIX file systems.
1427 wc -l processes short lines much more efficiently.
1429 References from --help and the man pages of utilities have been corrected
1430 in various cases, and more direct links to the corresponding online
1431 documentation are provided.
1434 * Noteworthy changes in release 8.23 (2014-07-18) [stable]
1438 chmod -Rc no longer issues erroneous warnings for files with special bits set.
1439 [bug introduced in coreutils-6.0]
1441 cp -a, mv, and install --preserve-context, once again set the correct SELinux
1442 context for existing directories in the destination. Previously they set
1443 the context of an existing directory to that of its last copied descendant.
1444 [bug introduced in coreutils-8.22]
1446 cp -a, mv, and install --preserve-context, no longer seg fault when running
1447 with SELinux enabled, when copying from file systems that return an error
1448 when reading the SELinux context for a file.
1449 [bug introduced in coreutils-8.22]
1451 cp -a and mv now preserve xattrs of symlinks copied across file systems.
1452 [bug introduced with extended attribute preservation feature in coreutils-7.1]
1454 date could crash or go into an infinite loop when parsing a malformed TZ="".
1455 [bug introduced with the --date='TZ="" ..' parsing feature in coreutils-5.3.0]
1457 dd's ASCII and EBCDIC conversions were incompatible with common practice and
1458 with POSIX, and have been corrected as follows. First, conv=ascii now
1459 implies conv=unblock, and conv=ebcdic and conv=ibm now imply conv=block.
1460 Second, the translation tables for dd conv=ascii and conv=ebcdic have been
1461 corrected as shown in the following table, where A is the ASCII value, W is
1462 the old, wrong EBCDIC value, and E is the new, corrected EBCDIC value; all
1463 values are in octal.
1476 [These dd bugs were present in "the beginning".]
1478 df has more fixes related to the newer dynamic representation of file systems:
1479 Duplicates are elided for virtual file systems like tmpfs.
1480 Details for the correct device are output for points mounted multiple times.
1481 Placeholder values are output for inaccessible file systems, rather than
1482 than error messages or values for the wrong file system.
1483 [These bugs were present in "the beginning".]
1485 df now outputs all appropriate entries in the presence of bind mounts.
1486 On some systems, entries would have been incorrectly elided due to
1487 them being considered "dummy" mounts.
1488 [bug introduced in coreutils-8.22]
1490 du now silently ignores directory cycles introduced with bind mounts.
1491 Previously it would issue a warning and exit with a failure status.
1492 [bug introduced in coreutils-8.1]
1494 head --bytes=-N and --lines=-N now handles devices more
1495 consistently, not ignoring data from virtual devices like /dev/zero,
1496 or on BSD systems data from tty devices.
1497 [bug introduced in coreutils-5.0.1]
1499 head --bytes=-N - no longer fails with a bogus diagnostic when stdin's
1500 seek pointer is not at the beginning.
1501 [bug introduced with the --bytes=-N feature in coreutils-5.0.1]
1503 head --lines=-0, when the input does not contain a trailing '\n',
1504 now copies all input to stdout. Previously nothing was output in this case.
1505 [bug introduced with the --lines=-N feature in coreutils-5.0.1]
1507 id, when invoked with no user name argument, now prints the correct group ID.
1508 Previously, in the default output format, it would print the default group ID
1509 in the password database, which may be neither real nor effective. For e.g.,
1510 when run set-GID, or when the database changes outside the current session.
1511 [bug introduced in coreutils-8.1]
1513 ln -sf now replaces symbolic links whose targets can't exist. Previously
1514 it would display an error, requiring --no-dereference to avoid the issue.
1515 [bug introduced in coreutils-5.3.0]
1517 ln -sr '' F no longer segfaults. Now works as expected.
1518 [bug introduced with the --relative feature in coreutils-8.16]
1520 numfmt now handles blanks correctly in all unibyte locales. Previously
1521 in locales where character 0xA0 is a blank, numfmt would mishandle it.
1522 [bug introduced when numfmt was added in coreutils-8.21]
1524 ptx --format long option parsing no longer falls through into the --help case.
1525 [bug introduced in TEXTUTILS-1_22i]
1527 ptx now consistently trims whitespace when processing multiple files.
1528 [This bug was present in "the beginning".]
1530 seq again generates correct output with start or end values = -0.
1531 [bug introduced in coreutils-8.20.]
1533 shuf --repeat no longer dumps core if the input is empty.
1534 [bug introduced with the --repeat feature in coreutils-8.22]
1536 sort when using multiple threads now avoids undefined behavior with mutex
1537 destruction, which could cause deadlocks on some implementations.
1538 [bug introduced in coreutils-8.6]
1540 tail -f now uses polling mode for VXFS to cater for its clustered mode.
1541 [bug introduced with inotify support added in coreutils-7.5]
1545 od accepts a new option: --endian=TYPE to handle inputs with different byte
1546 orders, or to provide consistent output on systems with disparate endianness.
1548 configure accepts the new option --enable-single-binary to build all the
1549 selected programs in a single binary called "coreutils". The selected
1550 programs can still be called directly using symlinks to "coreutils" or
1551 shebangs with the option --coreutils-prog= passed to this program. The
1552 install behavior is determined by the option --enable-single-binary=symlinks
1553 or --enable-single-binary=shebangs (the default). With the symlinks option,
1554 you can't make a second symlink to any program because that will change the
1555 name of the called program, which is used by coreutils to determine the
1556 desired program. The shebangs option doesn't suffer from this problem, but
1557 the /proc/$pid/cmdline file might not be updated on all the platforms. The
1558 functionality of each program is not affected but this single binary will
1559 depend on all the required dynamic libraries even to run simple programs.
1560 If you desire to build some tools outside the single binary file, you can
1561 pass the option --enable-single-binary-exceptions=PROG_LIST with the comma
1562 separated list of programs you want to build separately. This flag
1563 considerably reduces the overall size of the installed binaries which makes
1564 it suitable for embedded system.
1566 ** Changes in behavior
1568 chroot with an argument of "/" no longer implicitly changes the current
1569 directory to "/", allowing changing only user credentials for a command.
1571 chroot --userspec will now unset supplemental groups associated with root,
1572 and instead use the supplemental groups of the specified user.
1574 cut -d$'\n' again outputs lines identified in the --fields list, having
1575 not done so in v8.21 and v8.22. Note using this non portable functionality
1576 will result in the delayed output of lines.
1578 ls with none of LS_COLORS or COLORTERM environment variables set,
1579 will now honor an empty or unknown TERM environment variable,
1580 and not output colors even with --colors=always.
1584 chroot has better --userspec and --group look-ups, with numeric IDs never
1585 causing name look-up errors. Also look-ups are first done outside the chroot,
1586 in case the look-up within the chroot fails due to library conflicts etc.
1588 install now allows the combination of the -D and -t options.
1590 numfmt supports zero padding of numbers using the standard printf
1591 syntax of a leading zero, for example --format="%010f".
1592 Also throughput was improved by up to 800% by avoiding redundant processing.
1594 shred now supports multiple passes on GNU/Linux tape devices by rewinding
1595 the tape before each pass, avoids redundant writes to empty files,
1596 uses direct I/O for all passes where possible, and attempts to clear
1597 inode storage used for small files on some file systems.
1599 split avoids unnecessary input buffering, immediately writing input to output
1600 which is significant with --filter or when writing to fifos or stdout etc.
1602 stat and tail work better with HFS+, HFSX, LogFS and ConfigFS. stat -f
1603 --format=%T now reports the file system type, and tail -f now uses inotify,
1604 rather than the default of issuing a warning and reverting to polling.
1607 * Noteworthy changes in release 8.22 (2013-12-13) [stable]
1611 df now processes the mount list correctly in the presence of unstatable
1612 mount points. Previously it may have failed to output some mount points.
1613 [bug introduced in coreutils-8.21]
1615 df now processes symbolic links and relative paths to special files containing
1616 a mounted file system correctly. Previously df displayed the statistics about
1617 the file system the file is stored on rather than the one inside.
1618 [This bug was present in "the beginning".]
1620 df now processes disk device nodes correctly in the presence of bind mounts.
1621 Now df shows the base mounted file system rather than the last one mounted.
1622 [This bug was present in "the beginning".]
1624 install now removes the target file if the strip program failed for any
1625 reason. Before, that file was left behind, sometimes even with wrong
1627 [This bug was present in "the beginning".]
1629 ln --relative now updates existing symlinks correctly. Previously it based
1630 the relative link on the dereferenced path of an existing link.
1631 [This bug was introduced when --relative was added in coreutils-8.16.]
1633 ls --recursive will no longer exit with "serious" exit code (2), if there
1634 is an error reading a directory not specified on the command line.
1635 [Bug introduced in coreutils-5.3.0]
1637 mkdir, mkfifo, and mknod now work better when creating a file in a directory
1638 with a default ACL whose umask disagrees with the process's umask, on a
1639 system such as GNU/Linux where directory ACL umasks override process umasks.
1640 [bug introduced in coreutils-6.0]
1642 mv will now replace empty directories in the destination with directories
1643 from the source, when copying across file systems.
1644 [This bug was present in "the beginning".]
1646 od -wN with N larger than 64K on a system with 32-bit size_t would
1647 print approximately 2*N bytes of extraneous padding.
1648 [Bug introduced in coreutils-7.0]
1650 rm -I now prompts for confirmation before removing a write protected file.
1651 [Bug introduced in coreutils-6.8]
1653 shred once again uses direct I/O on systems requiring aligned buffers.
1654 Also direct I/O failures for odd sized writes at end of file are now handled.
1655 [The "last write" bug was introduced in coreutils-5.3.0 but masked
1656 by the alignment bug introduced in coreutils-6.0]
1658 tail --retry -f now waits for the files specified to appear. Before, tail
1659 would immediately exit when such a file is initially inaccessible.
1660 [This bug was introduced when inotify support was added in coreutils-7.5]
1662 tail -F has improved handling of symlinks. Previously tail didn't respond
1663 to the symlink target (re)appearing after being (re)created.
1664 [This bug was introduced when inotify support was added in coreutils-7.5]
1668 cp, install, mkdir, mknod, mkfifo and mv now support "restorecon"
1669 functionality through the -Z option, to set the SELinux context
1670 appropriate for the new item location in the file system.
1672 csplit accepts a new option: --suppressed-matched, to elide the lines
1673 used to identify the split points.
1675 df --output now accepts a 'file' field, to propagate a specified
1676 command line argument through to the output.
1678 du accepts a new option: --inodes to show the number of inodes instead
1681 id accepts a new option: --zero (-z) to delimit the output entries by
1682 a NUL instead of a white space character.
1684 id and ls with -Z report the SMACK security context where available.
1685 mkdir, mkfifo and mknod with --context set the SMACK context where available.
1687 id can now lookup by user ID, in addition to the existing name lookup.
1689 join accepts a new option: --zero-terminated (-z). As with the sort,uniq
1690 option of the same name, this makes join consume and produce NUL-terminated
1691 lines rather than newline-terminated lines.
1693 uniq accepts a new option: --group to print all items, while separating
1694 unique groups with empty lines.
1696 shred accepts new parameters to the --remove option to give greater
1697 control over that operation, which can greatly reduce sync overhead.
1699 shuf accepts a new option: --repeat (-r), which can repeat items in
1702 ** Changes in behavior
1704 cp --link now dereferences a symbolic link as source before creating the
1705 hard link in the destination unless the -P,--no-deref option is specified.
1706 Previously, it would create a hard link of the symbolic link, even when
1707 the dereferencing options -L or -H were specified.
1709 cp, install, mkdir, mknod and mkfifo no longer accept an argument to the
1710 short -Z option. The --context equivalent still takes an optional argument.
1712 dd status=none now suppresses all non fatal diagnostic messages,
1713 not just the transfer counts.
1715 df no longer accepts the long-obsolescent --megabytes option.
1717 stdbuf now requires at least one buffering mode option to be specified,
1718 as per the documented interface.
1722 base64 encoding throughput for bulk data is increased by about 60%.
1724 md5sum can use libcrypto hash routines where allowed to potentially
1725 get better performance through using more system specific logic.
1726 sha1sum for example has improved throughput by 40% on an i3-2310M.
1727 This also affects sha1sum, sha224sum, sha256sum, sha384sum and sha512sum.
1729 stat and tail work better with EFIVARFS, EXOFS, F2FS, HOSTFS, SMACKFS, SNFS
1730 and UBIFS. stat -f --format=%T now reports the file system type, and tail -f
1731 now uses inotify for files on all those except SNFS, rather than the default
1732 (for unknown file system types) of issuing a warning and reverting to polling.
1734 shuf outputs subsets of large inputs much more efficiently.
1735 Reservoir sampling is used to limit memory usage based on the number of
1736 outputs, rather than the number of inputs.
1738 shred increases the default write block size from 12KiB to 64KiB
1739 to align with other utilities and reduce the system call overhead.
1741 split --line-bytes=SIZE, now only allocates memory as needed rather
1742 than allocating SIZE bytes at program start.
1744 stty now supports configuring "stick" (mark/space) parity where available.
1748 factor now builds on aarch64 based systems [bug introduced in coreutils-8.20]
1751 * Noteworthy changes in release 8.21 (2013-02-14) [stable]
1755 numfmt: reformat numbers
1759 df now accepts the --output[=FIELD_LIST] option to define the list of columns
1760 to include in the output, or all available columns if the FIELD_LIST is
1761 omitted. Note this enables df to output both block and inode fields together.
1763 du now accepts the --threshold=SIZE option to restrict the output to entries
1764 with such a minimum SIZE (or a maximum SIZE if it is negative).
1765 du recognizes -t SIZE as equivalent, for compatibility with FreeBSD.
1767 timeout now accepts the --preserve-status option to always propagate the exit
1768 status, useful for commands that can run for an indeterminate amount of time.
1772 cp --no-preserve=mode now no longer exits non-zero.
1773 [bug introduced in coreutils-8.20]
1775 cut with a range like "N-" no longer allocates N/8 bytes. That buffer
1776 would never be used, and allocation failure could cause cut to fail.
1777 [bug introduced in coreutils-8.10]
1779 cut no longer accepts the invalid range 0-, which made it print empty lines.
1780 Instead, cut now fails and emits an appropriate diagnostic.
1781 [This bug was present in "the beginning".]
1783 cut now handles overlapping to-EOL ranges properly. Before, it would
1784 interpret "-b2-,3-" like "-b3-". Now it's treated like "-b2-".
1785 [This bug was present in "the beginning".]
1787 cut no longer prints extraneous delimiters when a to-EOL range subsumes
1788 another range. Before, "echo 123|cut --output-delim=: -b2-,3" would print
1789 "2:3". Now it prints "23". [bug introduced in 5.3.0]
1791 cut -f no longer inspects input line N+1 before fully outputting line N,
1792 which avoids delayed output for intermittent input.
1793 [bug introduced in TEXTUTILS-1_8b]
1795 factor no longer loops infinitely on 32 bit powerpc or sparc systems.
1796 [bug introduced in coreutils-8.20]
1798 install -m M SOURCE DEST no longer has a race condition where DEST's
1799 permissions are temporarily derived from SOURCE instead of from M.
1801 pr -n no longer crashes when passed values >= 32. Also, line numbers are
1802 consistently padded with spaces, rather than with zeros for certain widths.
1803 [bug introduced in TEXTUTILS-1_22i]
1805 seq -w ensures that for numbers input in scientific notation,
1806 the output numbers are properly aligned and of the correct width.
1807 [This bug was present in "the beginning".]
1809 seq -w ensures correct alignment when the step value includes a precision
1810 while the start value does not, and the number sequence narrows.
1811 [This bug was present in "the beginning".]
1813 seq -s no longer prints an erroneous newline after the first number, and
1814 outputs a newline after the last number rather than a trailing separator.
1815 Also seq no longer ignores a specified step value when the end value is 1.
1816 [bugs introduced in coreutils-8.20]
1818 timeout now ensures that blocking of ALRM signals is not inherited from
1819 its parent, which would cause timeouts to be ignored.
1820 [the bug dates back to the initial implementation]
1822 ** Changes in behavior
1824 df --total now prints '-' into the target column (mount point) of the
1825 summary line, accommodating the --output option where the target field
1826 can be in any column. If there is no source column, then df prints
1827 'total' in the target column.
1829 df now properly outputs file system information with bind mounts present on
1830 the system by skipping duplicate entries (identified by the device number).
1831 Consequently, df also elides the early-boot pseudo file system type "rootfs".
1833 cut -d$'\n' no longer outputs lines identified in the --fields list,
1834 to align with other implementations and to avoid delayed output of lines.
1836 nl no longer supports the --page-increment option, which has been
1837 deprecated since coreutils-7.5. Use --line-increment instead.
1841 readlink now supports multiple arguments, and a complementary
1842 -z, --zero option to delimit output items with the NUL character.
1844 stat and tail now know about CEPH. stat -f --format=%T now reports the file
1845 system type, and tail -f uses polling for files on CEPH file systems.
1847 stty now supports configuring DTR/DSR hardware flow control where available.
1851 Perl is now more of a prerequisite. It has long been required in order
1852 to run (not skip) a significant percentage of the tests. Now, it is
1853 also required in order to generate proper man pages, via help2man. The
1854 generated man/*.1 man pages are no longer distributed. Building without
1855 perl, you would create stub man pages. Thus, while perl is not an
1856 official prerequisite (build and "make check" will still succeed), any
1857 resulting man pages would be inferior. In addition, this fixes a bug
1858 in distributed (not from clone) Makefile.in that could cause parallel
1859 build failure when building from modified sources, as is common practice
1860 for a patched distribution package.
1862 factor now builds on x86_64 with x32 ABI, 32 bit MIPS, and all HPPA systems,
1863 by avoiding incompatible asm. [bug introduced in coreutils-8.20]
1865 A root-only test predicate would always fail. Its job was to determine
1866 whether our dummy user, $NON_ROOT_USERNAME, was able to run binaries from
1867 the build directory. As a result, all dependent tests were always skipped.
1868 Now, those tests may be run once again. [bug introduced in coreutils-8.20]
1871 * Noteworthy changes in release 8.20 (2012-10-23) [stable]
1875 dd now accepts 'status=none' to suppress all informational output.
1877 md5sum now accepts the --tag option to print BSD-style output with GNU
1878 file name escaping. This also affects sha1sum, sha224sum, sha256sum,
1879 sha384sum and sha512sum.
1883 cp could read from freed memory and could even make corrupt copies.
1884 This could happen with a very fragmented and sparse input file,
1885 on GNU/Linux file systems supporting fiemap extent scanning.
1886 This bug also affects mv when it resorts to copying, and install.
1887 [bug introduced in coreutils-8.11]
1889 cp --no-preserve=mode now no longer preserves the original file's
1890 permissions but correctly sets mode specified by 0666 & ~umask
1892 du no longer emits a "disk-corrupted"-style diagnostic when it detects
1893 a directory cycle that is due to a bind-mounted directory. Instead,
1894 it detects this precise type of cycle, diagnoses it as such and
1895 eventually exits nonzero.
1897 factor (when using gmp) would mistakenly declare some composite numbers
1898 to be prime, e.g., 465658903, 2242724851, 6635692801 and many more.
1899 The fix makes factor somewhat slower (~25%) for ranges of consecutive
1900 numbers, and up to 8 times slower for some worst-case individual numbers.
1901 [bug introduced in coreutils-7.0, with GNU MP support]
1903 ls now correctly colors dangling symlinks when listing their containing
1904 directories, with orphaned symlink coloring disabled in LS_COLORS.
1905 [bug introduced in coreutils-8.14]
1907 rm -i -d now prompts the user then removes an empty directory, rather
1908 than ignoring the -d option and failing with an 'Is a directory' error.
1909 [bug introduced in coreutils-8.19, with the addition of --dir (-d)]
1911 rm -r S/ (where S is a symlink-to-directory) no longer gives the invalid
1912 "Too many levels of symbolic links" diagnostic.
1913 [bug introduced in coreutils-8.6]
1915 seq now handles arbitrarily long non-negative whole numbers when the
1916 increment is 1 and when no format-changing option is specified.
1917 Before, this would infloop:
1918 b=100000000000000000000; seq $b $b
1919 [the bug dates back to the initial implementation]
1921 ** Changes in behavior
1923 nproc now diagnoses with an error, non option command line parameters.
1927 factor's core has been rewritten for speed and increased range.
1928 It can now factor numbers up to 2^128, even without GMP support.
1929 Its speed is from a few times better (for small numbers) to over
1930 10,000 times better (just below 2^64). The new code also runs a
1931 deterministic primality test for each prime factor, not just a
1934 seq is now up to 70 times faster than it was in coreutils-8.19 and prior,
1935 but only with non-negative whole numbers, an increment of 1, and no
1936 format-changing options.
1938 stat and tail know about ZFS, VZFS and VMHGFS. stat -f --format=%T now
1939 reports the file system type, and tail -f now uses inotify for files on
1940 ZFS and VZFS file systems, rather than the default (for unknown file
1941 system types) of issuing a warning and reverting to polling. tail -f
1942 still uses polling for files on VMHGFS file systems.
1946 root-only tests now check for permissions of our dummy user,
1947 $NON_ROOT_USERNAME, before trying to run binaries from the build directory.
1948 Before, we would get hard-to-diagnose reports of failing root-only tests.
1949 Now, those tests are skipped with a useful diagnostic when the root tests
1950 are run without following the instructions in README.
1952 We now build most directories using non-recursive make rules. I.e.,
1953 rather than running make in man/, lib/, src/, tests/, instead, the top
1954 level Makefile.am includes a $dir/local.mk that describes how to build
1955 the targets in the corresponding directory. Two directories remain
1956 unconverted: po/, gnulib-tests/. One nice side-effect is that the more
1957 accurate dependencies have eliminated a nagging occasional failure that
1958 was seen when running parallel "make syntax-check".
1961 * Noteworthy changes in release 8.19 (2012-08-20) [stable]
1965 df now fails when the list of mounted file systems (/etc/mtab) cannot
1966 be read, yet the file system type information is needed to process
1967 certain options like -a, -l, -t and -x.
1968 [This bug was present in "the beginning".]
1970 sort -u could fail to output one or more result lines.
1971 For example, this command would fail to print "1":
1972 (yes 7 | head -11; echo 1) | sort --p=1 -S32b -u
1973 [bug introduced in coreutils-8.6]
1975 sort -u could read freed memory.
1976 For example, this evokes a read from freed memory:
1977 perl -le 'print "a\n"."0"x900'|valgrind sort --p=1 -S32b -u>/dev/null
1978 [bug introduced in coreutils-8.6]
1982 rm now accepts the --dir (-d) option which makes it remove empty directories.
1983 Since removing empty directories is relatively safe, this option can be
1984 used as a part of the alias rm='rm --dir'. This improves compatibility
1985 with Mac OS X and BSD systems which also honor the -d option.
1988 * Noteworthy changes in release 8.18 (2012-08-12) [stable]
1992 cksum now prints checksums atomically so that concurrent
1993 processes will not intersperse their output.
1994 [the bug dates back to the initial implementation]
1996 date -d "$(printf '\xb0')" would print 00:00:00 with today's date
1997 rather than diagnosing the invalid input. Now it reports this:
1998 date: invalid date '\260'
1999 [This bug was present in "the beginning".]
2001 df no longer outputs control characters present in the mount point name.
2002 Such characters are replaced with '?', so for example, scripts consuming
2003 lines output by df, can work reliably.
2004 [This bug was present in "the beginning".]
2006 df --total now exits with an appropriate diagnostic and error code, when
2007 file system --type options do not lead to a processed file system.
2008 [This bug dates back to when --total was added in coreutils-7.0]
2010 head --lines=-N (-n-N) now resets the read pointer of a seekable input file.
2011 This means that "head -n-3" no longer consumes all of its input, and lines
2012 not output by head may be processed by other programs. For example, this
2013 command now prints the final line, 2, while before it would print nothing:
2014 seq 2 > k; (head -n-1 > /dev/null; cat) < k
2015 [This bug was present in "the beginning".]
2017 ls --color would mis-color relative-named symlinks in /
2018 [bug introduced in coreutils-8.17]
2020 split now ensures it doesn't overwrite the input file with generated output.
2021 [the bug dates back to the initial implementation]
2023 stat and df now report the correct file system usage,
2024 in all situations on GNU/Linux, by correctly determining the block size.
2025 [df bug since coreutils-5.0.91, stat bug since the initial implementation]
2027 tail -f no longer tries to use inotify on AUFS or PanFS file systems
2028 [you might say this was introduced in coreutils-7.5, along with inotify
2029 support, but even now, its magic number isn't in the usual place.]
2033 stat -f recognizes the new remote file system types: aufs, panfs.
2035 ** Changes in behavior
2037 su: this program has been removed. We stopped installing "su" by
2038 default with the release of coreutils-6.9.90 on 2007-12-01. Now,
2039 that the util-linux package has the union of the Suse and Fedora
2040 patches as well as enough support to build on the Hurd, we no longer
2041 have any reason to include it here.
2045 sort avoids redundant processing in the presence of inaccessible inputs,
2046 or unwritable output. Sort now diagnoses certain errors at start-up,
2047 rather than after potentially expensive processing.
2049 sort now allocates no more than 75% of physical memory by default,
2050 to better share system resources, and thus operate more efficiently.
2051 [The default max memory usage changed from 50% to 100% in coreutils-8.16]
2054 * Noteworthy changes in release 8.17 (2012-05-10) [stable]
2058 id and groups, when invoked with no user name argument, would print
2059 the default group ID listed in the password database, and sometimes
2060 that ID would be neither real nor effective. For example, when run
2061 set-GID, or in a session for which the default group has just been
2062 changed, the new group ID would be listed, even though it is not
2063 yet effective. [bug introduced in coreutils-8.1]
2065 cp S D is no longer subject to a race: if an existing D were removed
2066 between the initial stat and subsequent open-without-O_CREATE, cp would
2067 fail with a confusing diagnostic saying that the destination, D, was not
2068 found. Now, in this unusual case, it retries the open (but with O_CREATE),
2069 and hence usually succeeds. With NFS attribute caching, the condition
2070 was particularly easy to trigger, since there, the removal of D could
2071 precede the initial stat. [This bug was present in "the beginning".]
2073 split --number=C /dev/null no longer appears to infloop on GNU/Hurd
2074 [bug introduced in coreutils-8.8]
2076 stat no longer reports a negative file size as a huge positive number.
2077 [bug present since 'stat' was introduced in fileutils-4.1.9]
2081 split and truncate now allow any seekable files in situations where
2082 the file size is needed, instead of insisting on regular files.
2084 fmt now accepts the --goal=WIDTH (-g) option.
2086 stat -f recognizes new file system types: bdevfs, inodefs, qnx6
2088 ** Changes in behavior
2090 cp,mv,install,cat,split: now read and write a minimum of 64KiB at a time.
2091 This was previously 32KiB and increasing to 64KiB was seen to increase
2092 throughput by about 10% when reading cached files on 64 bit GNU/Linux.
2094 cp --attributes-only no longer truncates any existing destination file,
2095 allowing for more general copying of attributes from one file to another.
2098 * Noteworthy changes in release 8.16 (2012-03-26) [stable]
2102 As a GNU extension, 'chmod', 'mkdir', and 'install' now accept operators
2103 '-', '+', '=' followed by octal modes; for example, 'chmod +40 FOO' enables
2104 and 'chmod -40 FOO' disables FOO's group-read permissions. Operator
2105 numeric modes can be combined with symbolic modes by separating them with
2106 commas; for example, =0,u+r clears all permissions except for enabling
2107 user-read permissions. Unlike ordinary numeric modes, operator numeric
2108 modes do not preserve directory setuid and setgid bits; for example,
2109 'chmod =0 FOO' clears all of FOO's permissions, including setuid and setgid.
2111 Also, ordinary numeric modes with five or more digits no longer preserve
2112 setuid and setgid bits, so that 'chmod 00755 FOO' now clears FOO's setuid
2113 and setgid bits. This allows scripts to be portable to other systems which
2114 lack the GNU extension mentioned previously, and where ordinary numeric
2115 modes do not preserve directory setuid and setgid bits.
2117 dd now accepts the count_bytes, skip_bytes iflags and the seek_bytes
2118 oflag, to more easily allow processing portions of a file.
2120 dd now accepts the conv=sparse flag to attempt to create sparse
2121 output, by seeking rather than writing to the output file.
2123 ln now accepts the --relative option, to generate a relative
2124 symbolic link to a target, irrespective of how the target is specified.
2126 split now accepts an optional "from" argument to --numeric-suffixes,
2127 which changes the start number from the default of 0.
2129 split now accepts the --additional-suffix option, to append an
2130 additional static suffix to output file names.
2132 basename now supports the -a and -s options, which allow processing
2133 of more than one argument at a time. Also the complementary
2134 -z option was added to delimit output items with the NUL character.
2136 dirname now supports more than one argument. Also the complementary
2137 -z option was added to delimit output items with the NUL character.
2141 du --one-file-system (-x) would ignore any non-directory specified on
2142 the command line. For example, "touch f; du -x f" would print nothing.
2143 [bug introduced in coreutils-8.15]
2145 mv now lets you move a symlink onto a same-inode destination file that
2146 has two or more hard links. Before, it would reject that, saying that
2147 they are the same, implicitly warning you that the move would result in
2148 data loss. In this unusual case, when not moving the symlink onto its
2149 referent, there is no risk of data loss, since the symlink will
2150 typically still point to one of the hard links.
2152 "mv A B" could succeed, yet A would remain. This would happen only when
2153 both A and B were hard links to the same symlink, and with a kernel for
2154 which rename("A","B") does nothing and returns 0 (POSIX mandates this
2155 surprising rename no-op behavior). Now, mv handles this case by skipping
2156 the usually-useless rename and simply unlinking A.
2158 realpath no longer mishandles a root directory. This was most
2159 noticeable on platforms where // is a different directory than /,
2160 but could also be observed with --relative-base=/ or
2161 --relative-to=/. [bug since the beginning, in 8.15]
2165 ls can be much more efficient, especially with large directories on file
2166 systems for which getfilecon-, ACL-check- and XATTR-check-induced syscalls
2167 fail with ENOTSUP or similar.
2169 'realpath --relative-base=dir' in isolation now implies '--relative-to=dir'
2170 instead of causing a usage failure.
2172 split now supports an unlimited number of split files as default behavior.
2175 * Noteworthy changes in release 8.15 (2012-01-06) [stable]
2179 realpath: print resolved file names.
2183 du -x no longer counts root directories of other file systems.
2184 [bug introduced in coreutils-5.1.0]
2186 ls --color many-entry-directory was uninterruptible for too long
2187 [bug introduced in coreutils-5.2.1]
2189 ls's -k option no longer affects how ls -l outputs file sizes.
2190 It now affects only the per-directory block counts written by -l,
2191 and the sizes written by -s. This is for compatibility with BSD
2192 and with POSIX 2008. Because -k is no longer equivalent to
2193 --block-size=1KiB, a new long option --kibibyte stands for -k.
2194 [bug introduced in coreutils-4.5.4]
2196 ls -l would leak a little memory (security context string) for each
2197 nonempty directory listed on the command line, when using SELinux.
2198 [bug probably introduced in coreutils-6.10 with SELinux support]
2200 rm -rf DIR would fail with "Device or resource busy" on Cygwin with NWFS
2201 and NcFsd file systems. This did not affect Unix/Linux-based kernels.
2202 [bug introduced in coreutils-8.0, when rm began using fts]
2204 split -n 1/2 FILE no longer fails when operating on a growing file, or
2205 (on some systems) when operating on a non-regular file like /dev/zero.
2206 It would report "/dev/zero: No such file or directory" even though
2207 the file obviously exists. Same for -n l/2.
2208 [bug introduced in coreutils-8.8, with the addition of the -n option]
2210 stat -f now recognizes the FhGFS and PipeFS file system types.
2212 tac no longer fails to handle two or more non-seekable inputs
2213 [bug introduced in coreutils-5.3.0]
2215 tail -f no longer tries to use inotify on GPFS or FhGFS file systems
2216 [you might say this was introduced in coreutils-7.5, along with inotify
2217 support, but the new magic numbers weren't in the usual places then.]
2219 ** Changes in behavior
2221 df avoids long UUID-including file system names in the default listing.
2222 With recent enough kernel/tools, these long names would be used, pushing
2223 second and subsequent columns far to the right. Now, when a long name
2224 refers to a symlink, and no file systems are specified, df prints the
2225 usually-short referent instead.
2227 tail -f now uses polling (not inotify) when any of its file arguments
2228 resides on a file system of unknown type. In addition, for each such
2229 argument, tail -f prints a warning with the FS type magic number and a
2230 request to report it to the bug-reporting address.
2233 * Noteworthy changes in release 8.14 (2011-10-12) [stable]
2237 ls --dereference no longer outputs erroneous "argetm" strings for
2238 dangling symlinks when an 'ln=target' entry is in $LS_COLORS.
2239 [bug introduced in fileutils-4.0]
2241 ls -lL symlink once again properly prints "+" when the referent has an ACL.
2242 [bug introduced in coreutils-8.13]
2244 sort -g no longer infloops for certain inputs containing NaNs
2245 [bug introduced in coreutils-8.5]
2249 md5sum --check now supports the -r format from the corresponding BSD tool.
2250 This also affects sha1sum, sha224sum, sha384sum and sha512sum.
2252 pwd now works also on systems without openat. On such systems, pwd
2253 would fail when run from a directory whose absolute name contained
2254 more than PATH_MAX / 3 components. The df, stat and readlink programs
2255 are also affected due to their use of the canonicalize_* functions.
2257 ** Changes in behavior
2259 timeout now only processes the first signal received from the set
2260 it is handling (SIGTERM, SIGINT, ...). This is to support systems that
2261 implicitly create threads for some timer functions (like GNU/kFreeBSD).
2265 "make dist" no longer builds .tar.gz files.
2266 xz is portable enough and in wide-enough use that distributing
2267 only .tar.xz files is enough.
2270 * Noteworthy changes in release 8.13 (2011-09-08) [stable]
2274 chown and chgrp with the -v --from= options, now output the correct owner.
2275 I.e., for skipped files, the original ownership is output, not the new one.
2276 [bug introduced in sh-utils-2.0g]
2278 cp -r could mistakenly change the permissions of an existing destination
2279 directory. [bug introduced in coreutils-6.8]
2281 cp -u -p would fail to preserve one hard link for each up-to-date copy
2282 of a src-hard-linked name in the destination tree. I.e., if s/a and s/b
2283 are hard-linked and dst/s/a is up to date, "cp -up s dst" would copy s/b
2284 to dst/s/b rather than simply linking dst/s/b to dst/s/a.
2285 [This bug appears to have been present in "the beginning".]
2287 fts-using tools (rm, du, chmod, chgrp, chown, chcon) no longer use memory
2288 proportional to the number of entries in each directory they process.
2289 Before, rm -rf 4-million-entry-directory would consume about 1GiB of memory.
2290 Now, it uses less than 30MB, no matter how many entries there are.
2291 [this bug was inherent in the use of fts: thus, for rm the bug was
2292 introduced in coreutils-8.0. The prior implementation of rm did not use
2293 as much memory. du, chmod, chgrp and chown started using fts in 6.0.
2294 chcon was added in coreutils-6.9.91 with fts support. ]
2296 pr -T no longer ignores a specified LAST_PAGE to stop at.
2297 [bug introduced in textutils-1.19q]
2299 printf '%d' '"' no longer accesses out-of-bounds memory in the diagnostic.
2300 [bug introduced in sh-utils-1.16]
2302 split --number l/... no longer creates extraneous files in certain cases.
2303 [bug introduced in coreutils-8.8]
2305 timeout now sends signals to commands that create their own process group.
2306 timeout is no longer confused when starting off with a child process.
2307 [bugs introduced in coreutils-7.0]
2309 unexpand -a now aligns correctly when there are spaces spanning a tabstop,
2310 followed by a tab. In that case a space was dropped, causing misalignment.
2311 We also now ensure that a space never precedes a tab.
2312 [bug introduced in coreutils-5.3.0]
2314 ** Changes in behavior
2316 chmod, chown and chgrp now output the original attributes in messages,
2317 when -v or -c specified.
2319 cp -au (where --preserve=links is implicit) may now replace newer
2320 files in the destination, to mirror hard links from the source.
2324 date now accepts ISO 8601 date-time strings with "T" as the
2325 separator. It has long parsed dates like "2004-02-29 16:21:42"
2326 with a space between the date and time strings. Now it also parses
2327 "2004-02-29T16:21:42" and fractional-second and time-zone-annotated
2328 variants like "2004-02-29T16:21:42.333-07:00"
2330 md5sum accepts the new --strict option. With --check, it makes the
2331 tool exit non-zero for any invalid input line, rather than just warning.
2332 This also affects sha1sum, sha224sum, sha384sum and sha512sum.
2334 split accepts a new --filter=CMD option. With it, split filters output
2335 through CMD. CMD may use the $FILE environment variable, which is set to
2336 the nominal output file name for each invocation of CMD. For example, to
2337 split a file into 3 approximately equal parts, which are then compressed:
2338 split -n3 --filter='xz > $FILE.xz' big
2339 Note the use of single quotes, not double quotes.
2340 That creates files named xaa.xz, xab.xz and xac.xz.
2342 timeout accepts a new --foreground option, to support commands not started
2343 directly from a shell prompt, where the command is interactive or needs to
2344 receive signals initiated from the terminal.
2348 cp -p now copies trivial NSFv4 ACLs on Solaris 10. Before, it would
2349 mistakenly apply a non-trivial ACL to the destination file.
2351 cp and ls now support HP-UX 11.11's ACLs, thanks to improved support
2354 df now supports disk partitions larger than 4 TiB on MacOS X 10.5
2355 or newer and on AIX 5.2 or newer.
2357 join --check-order now prints "join: FILE:LINE_NUMBER: bad_line" for an
2358 unsorted input, rather than e.g., "join: file 1 is not in sorted order".
2360 shuf outputs small subsets of large permutations much more efficiently.
2361 For example 'shuf -i1-$((2**32-1)) -n2' no longer exhausts memory.
2363 stat -f now recognizes the GPFS, MQUEUE and PSTOREFS file system types.
2365 timeout now supports sub-second timeouts.
2369 Changes inherited from gnulib address a build failure on HP-UX 11.11
2370 when using /opt/ansic/bin/cc.
2372 Numerous portability and build improvements inherited via gnulib.
2375 * Noteworthy changes in release 8.12 (2011-04-26) [stable]
2379 tail's --follow=name option no longer implies --retry on systems
2380 with inotify support. [bug introduced in coreutils-7.5]
2382 ** Changes in behavior
2384 cp's extent-based (FIEMAP) copying code is more reliable in the face
2385 of varying and undocumented file system semantics:
2386 - it no longer treats unwritten extents specially
2387 - a FIEMAP-based extent copy always uses the FIEMAP_FLAG_SYNC flag.
2388 Before, it would incur the performance penalty of that sync only
2389 for 2.6.38 and older kernels. We thought all problems would be
2390 resolved for 2.6.39.
2391 - it now attempts a FIEMAP copy only on a file that appears sparse.
2392 Sparse files are relatively unusual, and the copying code incurs
2393 the performance penalty of the now-mandatory sync only for them.
2397 dd once again compiles on AIX 5.1 and 5.2
2400 * Noteworthy changes in release 8.11 (2011-04-13) [stable]
2404 cp -a --link would not create a hardlink to a symlink, instead
2405 copying the symlink and then not preserving its timestamp.
2406 [bug introduced in coreutils-8.0]
2408 cp now avoids FIEMAP issues with BTRFS before Linux 2.6.38,
2409 which could result in corrupt copies of sparse files.
2410 [bug introduced in coreutils-8.10]
2412 cut could segfault when invoked with a user-specified output
2413 delimiter and an unbounded range like "-f1234567890-".
2414 [bug introduced in coreutils-5.3.0]
2416 du would infloop when given --files0-from=DIR
2417 [bug introduced in coreutils-7.1]
2419 sort no longer spawns 7 worker threads to sort 16 lines
2420 [bug introduced in coreutils-8.6]
2422 touch built on Solaris 9 would segfault when run on Solaris 10
2423 [bug introduced in coreutils-8.8]
2425 wc would dereference a NULL pointer upon an early out-of-memory error
2426 [bug introduced in coreutils-7.1]
2430 dd now accepts the 'nocache' flag to the iflag and oflag options,
2431 which will discard any cache associated with the files, or
2432 processed portion thereof.
2434 dd now warns that 'iflag=fullblock' should be used,
2435 in various cases where partial reads can cause issues.
2437 ** Changes in behavior
2439 cp now avoids syncing files when possible, when doing a FIEMAP copy.
2440 The sync is only needed on Linux kernels before 2.6.39.
2441 [The sync was introduced in coreutils-8.10]
2443 cp now copies empty extents efficiently, when doing a FIEMAP copy.
2444 It no longer reads the zero bytes from the input, and also can efficiently
2445 create a hole in the output file when --sparse=always is specified.
2447 df now aligns columns consistently, and no longer wraps entries
2448 with longer device identifiers, over two lines.
2450 install now rejects its long-deprecated --preserve_context option.
2451 Use --preserve-context instead.
2453 test now accepts "==" as a synonym for "="
2456 * Noteworthy changes in release 8.10 (2011-02-04) [stable]
2460 du would abort with a failed assertion when two conditions are met:
2461 part of the hierarchy being traversed is moved to a higher level in the
2462 directory tree, and there is at least one more command line directory
2463 argument following the one containing the moved sub-tree.
2464 [bug introduced in coreutils-5.1.0]
2466 join --header now skips the ordering check for the first line
2467 even if the other file is empty. [bug introduced in coreutils-8.5]
2469 join -v2 now ensures the default output format prints the match field
2470 at the start of the line when it is different to the match field for
2471 the first file. [bug present in "the beginning".]
2473 rm -f no longer fails for EINVAL or EILSEQ on file systems that
2474 reject file names invalid for that file system.
2476 uniq -f NUM no longer tries to process fields after end of line.
2477 [bug introduced in coreutils-7.0]
2481 cp now copies sparse files efficiently on file systems with FIEMAP
2482 support (ext4, btrfs, xfs, ocfs2). Before, it had to read 2^20 bytes
2483 when copying a 1MiB sparse file. Now, it copies bytes only for the
2484 non-sparse sections of a file. Similarly, to induce a hole in the
2485 output file, it had to detect a long sequence of zero bytes. Now,
2486 it knows precisely where each hole in an input file is, and can
2487 reproduce them efficiently in the output file. mv also benefits
2488 when it resorts to copying, e.g., between file systems.
2490 join now supports -o 'auto' which will automatically infer the
2491 output format from the first line in each file, to ensure
2492 the same number of fields are output for each line.
2494 ** Changes in behavior
2496 join no longer reports disorder when one of the files is empty.
2497 This allows one to use join as a field extractor like:
2498 join -a1 -o 1.3,1.1 - /dev/null
2501 * Noteworthy changes in release 8.9 (2011-01-04) [stable]
2505 split no longer creates files with a suffix length that
2506 is dependent on the number of bytes or lines per file.
2507 [bug introduced in coreutils-8.8]
2510 * Noteworthy changes in release 8.8 (2010-12-22) [stable]
2514 cp -u no longer does unnecessary copying merely because the source
2515 has finer-grained timestamps than the destination.
2517 od now prints floating-point numbers without losing information, and
2518 it no longer omits spaces between floating-point columns in some cases.
2520 sort -u with at least two threads could attempt to read through a
2521 corrupted pointer. [bug introduced in coreutils-8.6]
2523 sort with at least two threads and with blocked output would busy-loop
2524 (spinlock) all threads, often using 100% of available CPU cycles to
2525 do no work. I.e., "sort < big-file | less" could waste a lot of power.
2526 [bug introduced in coreutils-8.6]
2528 sort with at least two threads no longer segfaults due to use of pointers
2529 into the stack of an expired thread. [bug introduced in coreutils-8.6]
2531 sort --compress no longer mishandles subprocesses' exit statuses,
2532 no longer hangs indefinitely due to a bug in waiting for subprocesses,
2533 and no longer generates many more than NMERGE subprocesses.
2535 sort -m -o f f ... f no longer dumps core when file descriptors are limited.
2537 ** Changes in behavior
2539 sort will not create more than 8 threads by default due to diminishing
2540 performance gains. Also the --parallel option is no longer restricted
2541 to the number of available processors.
2545 split accepts the --number/-n option to generate a specific number of
2546 files, as well as the --elide-empty-files/-e and --unbuffered/-u
2547 options to fine-tune the resulting output.
2550 * Noteworthy changes in release 8.7 (2010-11-13) [stable]
2554 cp, install, mv, and touch no longer crash when setting file times
2555 on Solaris 10 Update 9 [Solaris PatchID 144488 and newer expose a
2556 latent bug introduced in coreutils 8.1, and possibly a second latent
2557 bug going at least as far back as coreutils 5.97]
2559 csplit no longer corrupts heap when writing more than 999 files,
2560 nor does it leak memory for every chunk of input processed
2561 [the bugs were present in the initial implementation]
2563 tail -F once again notices changes in a currently unavailable
2564 remote directory [bug introduced in coreutils-7.5]
2566 ** Changes in behavior
2568 cp --attributes-only now completely overrides --reflink.
2569 Previously a reflink was needlessly attempted.
2571 stat's %X, %Y, and %Z directives once again print only the integer
2572 part of seconds since the epoch. This reverts a change from
2573 coreutils-8.6, that was deemed unnecessarily disruptive.
2574 To obtain a nanosecond-precision timestamp for %X use %.X;
2575 if you want (say) just 3 fractional digits, use %.3X.
2576 Likewise for %Y and %Z.
2578 stat's new %W format directive would print floating point seconds.
2579 However, with the above change to %X, %Y and %Z, we've made %W work
2580 the same way as the others.
2582 stat gained support for several printf-style flags, such as %'s for
2583 listing sizes with the current locale's thousands separator.
2586 * Noteworthy changes in release 8.6 (2010-10-15) [stable]
2590 du no longer multiply counts a file that is a directory or whose
2591 link count is 1, even if the file is reached multiple times by
2592 following symlinks or via multiple arguments.
2594 du -H and -L now consistently count pointed-to files instead of
2595 symbolic links, and correctly diagnose dangling symlinks.
2597 du --ignore=D now ignores directory D even when that directory is
2598 found to be part of a directory cycle. Before, du would issue a
2599 "NOTIFY YOUR SYSTEM MANAGER" diagnostic and fail.
2601 split now diagnoses read errors rather than silently exiting.
2602 [bug introduced in coreutils-4.5.8]
2604 tac would perform a double-free when given an input line longer than 16KiB.
2605 [bug introduced in coreutils-8.3]
2607 tail -F once again notices changes in a currently unavailable directory,
2608 and works around a Linux kernel bug where inotify runs out of resources.
2609 [bugs introduced in coreutils-7.5]
2611 tr now consistently handles case conversion character classes.
2612 In some locales, valid conversion specifications caused tr to abort,
2613 while in all locales, some invalid specifications were undiagnosed.
2614 [bugs introduced in coreutils 6.9.90 and 6.9.92]
2618 cp now accepts the --attributes-only option to not copy file data,
2619 which is useful for efficiently modifying files.
2621 du recognizes -d N as equivalent to --max-depth=N, for compatibility
2624 sort now accepts the --debug option, to highlight the part of the
2625 line significant in the sort, and warn about questionable options.
2627 sort now supports -d, -f, -i, -R, and -V in any combination.
2629 stat now accepts the %m format directive to output the mount point
2630 for a file. It also accepts the %w and %W format directives for
2631 outputting the birth time of a file, if one is available.
2633 ** Changes in behavior
2635 df now consistently prints the device name for a bind mounted file,
2636 rather than its aliased target.
2638 du now uses less than half as much memory when operating on trees
2639 with many hard-linked files. With --count-links (-l), or when
2640 operating on trees with no hard-linked files, there is no change.
2642 ls -l now uses the traditional three field time style rather than
2643 the wider two field numeric ISO style, in locales where a style has
2644 not been specified. The new approach has nicer behavior in some
2645 locales, including English, which was judged to outweigh the disadvantage
2646 of generating less-predictable and often worse output in poorly-configured
2647 locales where there is an onus to specify appropriate non-default styles.
2648 [The old behavior was introduced in coreutils-6.0 and had been removed
2649 for English only using a different method since coreutils-8.1]
2651 rm's -d now evokes an error; before, it was silently ignored.
2653 sort -g now uses long doubles for greater range and precision.
2655 sort -h no longer rejects numbers with leading or trailing ".", and
2656 no longer accepts numbers with multiple ".". It now considers all
2659 sort now uses the number of available processors to parallelize
2660 the sorting operation. The number of sorts run concurrently can be
2661 limited with the --parallel option or with external process
2662 control like taskset for example.
2664 stat now provides translated output when no format is specified.
2666 stat no longer accepts the --context (-Z) option. Initially it was
2667 merely accepted and ignored, for compatibility. Starting two years
2668 ago, with coreutils-7.0, its use evoked a warning. Printing the
2669 SELinux context of a file can be done with the %C format directive,
2670 and the default output when no format is specified now automatically
2671 includes %C when context information is available.
2673 stat no longer accepts the %C directive when the --file-system
2674 option is in effect, since security context is a file attribute
2675 rather than a file system attribute.
2677 stat now outputs the full sub-second resolution for the atime,
2678 mtime, and ctime values since the Epoch, when using the %X, %Y, and
2679 %Z directives of the --format option. This matches the fact that
2680 %x, %y, and %z were already doing so for the human-readable variant.
2682 touch's --file option is no longer recognized. Use --reference=F (-r)
2683 instead. --file has not been documented for 15 years, and its use has
2684 elicited a warning since coreutils-7.1.
2686 truncate now supports setting file sizes relative to a reference file.
2687 Also errors are no longer suppressed for unsupported file types, and
2688 relative sizes are restricted to supported file types.
2691 * Noteworthy changes in release 8.5 (2010-04-23) [stable]
2695 cp and mv once again support preserving extended attributes.
2696 [bug introduced in coreutils-8.4]
2698 cp now preserves "capabilities" when also preserving file ownership.
2700 ls --color once again honors the 'NORMAL' dircolors directive.
2701 [bug introduced in coreutils-6.11]
2703 sort -M now handles abbreviated months that are aligned using blanks
2704 in the locale database. Also locales with 8 bit characters are
2705 handled correctly, including multi byte locales with the caveat
2706 that multi byte characters are matched case sensitively.
2708 sort again handles obsolescent key formats (+POS -POS) correctly.
2709 Previously if -POS was specified, 1 field too many was used in the sort.
2710 [bug introduced in coreutils-7.2]
2714 join now accepts the --header option, to treat the first line of each
2715 file as a header line to be joined and printed unconditionally.
2717 timeout now accepts the --kill-after option which sends a kill
2718 signal to the monitored command if it's still running the specified
2719 duration after the initial signal was sent.
2721 who: the "+/-" --mesg (-T) indicator of whether a user/tty is accepting
2722 messages could be incorrectly listed as "+", when in fact, the user was
2723 not accepting messages (mesg no). Before, who would examine only the
2724 permission bits, and not consider the group of the TTY device file.
2725 Thus, if a login tty's group would change somehow e.g., to "root",
2726 that would make it unwritable (via write(1)) by normal users, in spite
2727 of whatever the permission bits might imply. Now, when configured
2728 using the --with-tty-group[=NAME] option, who also compares the group
2729 of the TTY device with NAME (or "tty" if no group name is specified).
2731 ** Changes in behavior
2733 ls --color no longer emits the final 3-byte color-resetting escape
2734 sequence when it would be a no-op.
2736 join -t '' no longer emits an error and instead operates on
2737 each line as a whole (even if they contain NUL characters).
2740 * Noteworthy changes in release 8.4 (2010-01-13) [stable]
2744 nproc --all is now guaranteed to be as large as the count
2745 of available processors, which may not have been the case
2746 on GNU/Linux systems with neither /proc nor /sys available.
2747 [bug introduced in coreutils-8.1]
2751 Work around a build failure when using buggy <sys/capability.h>.
2752 Alternatively, configure with --disable-libcap.
2754 Compilation would fail on systems using glibc-2.7..2.9 due to changes in
2755 gnulib's wchar.h that tickled a bug in at least those versions of glibc's
2756 own <wchar.h> header. Now, gnulib works around the bug in those older
2757 glibc <wchar.h> headers.
2759 Building would fail with a link error (cp/copy.o) when XATTR headers
2760 were installed without the corresponding library. Now, configure
2761 detects that and disables xattr support, as one would expect.
2764 * Noteworthy changes in release 8.3 (2010-01-07) [stable]
2768 cp -p, install -p, mv, and touch -c could trigger a spurious error
2769 message when using new glibc coupled with an old kernel.
2770 [bug introduced in coreutils-6.12].
2772 ls -l --color no longer prints "argetm" in front of dangling
2773 symlinks when the 'LINK target' directive was given to dircolors.
2774 [bug introduced in fileutils-4.0]
2776 pr's page header was improperly formatted for long file names.
2777 [bug introduced in coreutils-7.2]
2779 rm -r --one-file-system works once again.
2780 The rewrite to make rm use fts introduced a regression whereby
2781 a command of the above form would fail for all subdirectories.
2782 [bug introduced in coreutils-8.0]
2784 stat -f recognizes more file system types: k-afs, fuseblk, gfs/gfs2, ocfs2,
2785 and rpc_pipefs. Also Minix V3 is displayed correctly as minix3, not minux3.
2786 [bug introduced in coreutils-8.1]
2788 tail -f (inotify-enabled) once again works with remote files.
2789 The use of inotify with remote files meant that any changes to those
2790 files that was not done from the local system would go unnoticed.
2791 [bug introduced in coreutils-7.5]
2793 tail -F (inotify-enabled) would abort when a tailed file is repeatedly
2794 renamed-aside and then recreated.
2795 [bug introduced in coreutils-7.5]
2797 tail -F (inotify-enabled) could fail to follow renamed files.
2798 E.g., given a "tail -F a b" process, running "mv a b" would
2799 make tail stop tracking additions to "b".
2800 [bug introduced in coreutils-7.5]
2802 touch -a and touch -m could trigger bugs in some file systems, such
2803 as xfs or ntfs-3g, and fail to update timestamps.
2804 [bug introduced in coreutils-8.1]
2806 wc now prints counts atomically so that concurrent
2807 processes will not intersperse their output.
2808 [the issue dates back to the initial implementation]
2811 * Noteworthy changes in release 8.2 (2009-12-11) [stable]
2815 id's use of mgetgroups no longer writes beyond the end of a malloc'd buffer
2816 [bug introduced in coreutils-8.1]
2818 id no longer crashes on systems without supplementary group support.
2819 [bug introduced in coreutils-8.1]
2821 rm once again handles zero-length arguments properly.
2822 The rewrite to make rm use fts introduced a regression whereby
2823 a command like "rm a '' b" would fail to remove "a" and "b", due to
2824 the presence of the empty string argument.
2825 [bug introduced in coreutils-8.0]
2827 sort is now immune to the signal handling of its parent.
2828 Specifically sort now doesn't exit with an error message
2829 if it uses helper processes for compression and its parent
2830 ignores CHLD signals. [bug introduced in coreutils-6.9]
2832 tail without -f no longer accesses uninitialized memory
2833 [bug introduced in coreutils-7.6]
2835 timeout is now immune to the signal handling of its parent.
2836 Specifically timeout now doesn't exit with an error message
2837 if its parent ignores CHLD signals. [bug introduced in coreutils-7.6]
2839 a user running "make distcheck" in the coreutils source directory,
2840 with TMPDIR unset or set to the name of a world-writable directory,
2841 and with a malicious user on the same system
2842 was vulnerable to arbitrary code execution
2843 [bug introduced in coreutils-5.0]
2846 * Noteworthy changes in release 8.1 (2009-11-18) [stable]
2850 chcon no longer exits immediately just because SELinux is disabled.
2851 Even then, chcon may still be useful.
2852 [bug introduced in coreutils-8.0]
2854 chcon, chgrp, chmod, chown and du now diagnose an ostensible directory cycle
2855 and arrange to exit nonzero. Before, they would silently ignore the
2856 offending directory and all "contents."
2858 env -u A=B now fails, rather than silently adding A to the
2859 environment. Likewise, printenv A=B silently ignores the invalid
2860 name. [the bugs date back to the initial implementation]
2862 ls --color now handles files with capabilities correctly. Previously
2863 files with capabilities were often not colored, and also sometimes, files
2864 without capabilites were colored in error. [bug introduced in coreutils-7.0]
2866 md5sum now prints checksums atomically so that concurrent
2867 processes will not intersperse their output.
2868 This also affected sum, sha1sum, sha224sum, sha384sum and sha512sum.
2869 [the bug dates back to the initial implementation]
2871 mktemp no longer leaves a temporary file behind if it was unable to
2872 output the name of the file to stdout.
2873 [the bug dates back to the initial implementation]
2875 nice -n -1 PROGRAM now runs PROGRAM even when its internal setpriority
2876 call fails with errno == EACCES.
2877 [the bug dates back to the initial implementation]
2879 nice, nohup, and su now refuse to execute the subsidiary program if
2880 they detect write failure in printing an otherwise non-fatal warning
2883 stat -f recognizes more file system types: afs, cifs, anon-inode FS,
2884 btrfs, cgroupfs, cramfs-wend, debugfs, futexfs, hfs, inotifyfs, minux3,
2885 nilfs, securityfs, selinux, xenfs
2887 tail -f (inotify-enabled) now avoids a race condition.
2888 Before, any data appended in the tiny interval between the initial
2889 read-to-EOF and the inotify watch initialization would be ignored
2890 initially (until more data was appended), or forever, if the file
2891 were first renamed or unlinked or never modified.
2892 [The race was introduced in coreutils-7.5]
2894 tail -F (inotify-enabled) now consistently tails a file that has been
2895 replaced via renaming. That operation provokes either of two sequences
2896 of inotify events. The less common sequence is now handled as well.
2897 [The bug came with the implementation change in coreutils-7.5]
2899 timeout now doesn't exit unless the command it is monitoring does,
2900 for any specified signal. [bug introduced in coreutils-7.0].
2902 ** Changes in behavior
2904 chroot, env, nice, and su fail with status 125, rather than 1, on
2905 internal error such as failure to parse command line arguments; this
2906 is for consistency with stdbuf and timeout, and avoids ambiguity
2907 with the invoked command failing with status 1. Likewise, nohup
2908 fails with status 125 instead of 127.
2910 du (due to a change in gnulib's fts) can now traverse NFSv4 automounted
2911 directories in which the stat'd device number of the mount point differs
2912 during a traversal. Before, it would fail, because such a mismatch would
2913 usually represent a serious error or a subversion attempt.
2915 echo and printf now interpret \e as the Escape character (0x1B).
2917 rm -f /read-only-fs/nonexistent now succeeds and prints no diagnostic
2918 on systems with an unlinkat syscall that sets errno to EROFS in that case.
2919 Before, it would fail with a "Read-only file system" diagnostic.
2920 Also, "rm /read-only-fs/nonexistent" now reports "file not found" rather
2921 than the less precise "Read-only file system" error.
2925 nproc: Print the number of processing units available to a process.
2929 env and printenv now accept the option --null (-0), as a means to
2930 avoid ambiguity with newlines embedded in the environment.
2932 md5sum --check now also accepts openssl-style checksums.
2933 So do sha1sum, sha224sum, sha384sum and sha512sum.
2935 mktemp now accepts the option --suffix to provide a known suffix
2936 after the substitution in the template. Additionally, uses such as
2937 "mktemp fileXXXXXX.txt" are able to infer an appropriate --suffix.
2939 touch now accepts the option --no-dereference (-h), as a means to
2940 change symlink timestamps on platforms with enough support.
2943 * Noteworthy changes in release 8.0 (2009-10-06) [beta]
2947 cp --preserve=xattr and --archive now preserve extended attributes even
2948 when the source file doesn't have write access.
2949 [bug introduced in coreutils-7.1]
2951 touch -t [[CC]YY]MMDDhhmm[.ss] now accepts a timestamp string ending in .60,
2952 to accommodate leap seconds.
2953 [the bug dates back to the initial implementation]
2955 ls --color now reverts to the color of a base file type consistently
2956 when the color of a more specific type is disabled.
2957 [bug introduced in coreutils-5.90]
2959 ls -LR exits with status 2, not 0, when it encounters a cycle
2961 "ls -is" is now consistent with ls -lis in ignoring values returned
2962 from a failed stat/lstat. For example ls -Lis now prints "?", not "0",
2963 for the inode number and allocated size of a dereferenced dangling symlink.
2965 tail --follow --pid now avoids a race condition where data written
2966 just before the process dies might not have been output by tail.
2967 Also, tail no longer delays at all when the specified pid is not live.
2968 [The race was introduced in coreutils-7.5,
2969 and the unnecessary delay was present since textutils-1.22o]
2973 On Solaris 9, many commands would mistakenly treat file/ the same as
2974 file. Now, even on such a system, path resolution obeys the POSIX
2975 rules that a trailing slash ensures that the preceding name is a
2976 directory or a symlink to a directory.
2978 ** Changes in behavior
2980 id no longer prints SELinux " context=..." when the POSIXLY_CORRECT
2981 environment variable is set.
2983 readlink -f now ignores a trailing slash when deciding if the
2984 last component (possibly via a dangling symlink) can be created,
2985 since mkdir will succeed in that case.
2989 ln now accepts the options --logical (-L) and --physical (-P),
2990 added by POSIX 2008. The default behavior is -P on systems like
2991 GNU/Linux where link(2) creates hard links to symlinks, and -L on
2992 BSD systems where link(2) follows symlinks.
2994 stat: without -f, a command-line argument of "-" now means standard input.
2995 With --file-system (-f), an argument of "-" is now rejected.
2996 If you really must operate on a file named "-", specify it as
2997 "./-" or use "--" to separate options from arguments.
3001 rm: rewrite to use gnulib's fts
3002 This makes rm -rf significantly faster (400-500%) in some pathological
3003 cases, and slightly slower (20%) in at least one pathological case.
3005 rm -r deletes deep hierarchies more efficiently. Before, execution time
3006 was quadratic in the depth of the hierarchy, now it is merely linear.
3007 However, this improvement is not as pronounced as might be expected for
3008 very deep trees, because prior to this change, for any relative name
3009 length longer than 8KiB, rm -r would sacrifice official conformance to
3010 avoid the disproportionate quadratic performance penalty. Leading to
3011 another improvement:
3013 rm -r is now slightly more standards-conformant when operating on
3014 write-protected files with relative names longer than 8KiB.
3017 * Noteworthy changes in release 7.6 (2009-09-11) [stable]
3021 cp, mv now ignore failure to preserve a symlink timestamp, when it is
3022 due to their running on a kernel older than what was implied by headers
3023 and libraries tested at configure time.
3024 [bug introduced in coreutils-7.5]
3026 cp --reflink --preserve now preserves attributes when cloning a file.
3027 [bug introduced in coreutils-7.5]
3029 cp --preserve=xattr no longer leaks resources on each preservation failure.
3030 [bug introduced in coreutils-7.1]
3032 dd now exits with non-zero status when it encounters a write error while
3033 printing a summary to stderr.
3034 [bug introduced in coreutils-6.11]
3036 dd cbs=N conv=unblock would fail to print a final newline when the size
3037 of the input was not a multiple of N bytes.
3038 [the non-conforming behavior dates back to the initial implementation]
3040 df no longer requires that each command-line argument be readable
3041 [bug introduced in coreutils-7.3]
3043 ls -i now prints consistent inode numbers also for mount points.
3044 This makes ls -i DIR less efficient on systems with dysfunctional readdir,
3045 because ls must stat every file in order to obtain a guaranteed-valid
3046 inode number. [bug introduced in coreutils-6.0]
3048 tail -f (inotify-enabled) now flushes any initial output before blocking.
3049 Before, this would print nothing and wait: stdbuf -o 4K tail -f /etc/passwd
3050 Note that this bug affects tail -f only when its standard output is buffered,
3051 which is relatively unusual.
3052 [bug introduced in coreutils-7.5]
3054 tail -f once again works with standard input. inotify-enabled tail -f
3055 would fail when operating on a nameless stdin. I.e., tail -f < /etc/passwd
3056 would say "tail: cannot watch `-': No such file or directory", yet the
3057 relatively baroque tail -f /dev/stdin < /etc/passwd would work. Now, the
3058 offending usage causes tail to revert to its conventional sleep-based
3059 (i.e., not inotify-based) implementation.
3060 [bug introduced in coreutils-7.5]
3064 ln, link: link f z/ would mistakenly succeed on Solaris 10, given an
3065 existing file, f, and nothing named "z". ln -T f z/ has the same problem.
3066 Each would mistakenly create "z" as a link to "f". Now, even on such a
3067 system, each command reports the error, e.g.,
3068 link: cannot create link `z/' to `f': Not a directory
3072 cp --reflink accepts a new "auto" parameter which falls back to
3073 a standard copy if creating a copy-on-write clone is not possible.
3075 ** Changes in behavior
3077 tail -f now ignores "-" when stdin is a pipe or FIFO.
3078 tail-with-no-args now ignores -f unconditionally when stdin is a pipe or FIFO.
3079 Before, it would ignore -f only when no file argument was specified,
3080 and then only when POSIXLY_CORRECT was set. Now, :|tail -f - terminates
3081 immediately. Before, it would block indefinitely.
3084 * Noteworthy changes in release 7.5 (2009-08-20) [stable]
3088 dd's oflag=direct option now works even when the size of the input
3089 is not a multiple of e.g., 512 bytes.
3091 dd now handles signals consistently even when they're received
3092 before data copying has started.
3094 install runs faster again with SELinux enabled
3095 [introduced in coreutils-7.0]
3097 ls -1U (with two or more arguments, at least one a nonempty directory)
3098 would print entry names *before* the name of the containing directory.
3099 Also fixed incorrect output of ls -1RU and ls -1sU.
3100 [introduced in coreutils-7.0]
3102 sort now correctly ignores fields whose ending position is specified
3103 before the start position. Previously in numeric mode the remaining
3104 part of the line after the start position was used as the sort key.
3105 [This bug appears to have been present in "the beginning".]
3107 truncate -s failed to skip all whitespace in the option argument in
3112 stdbuf: A new program to run a command with modified stdio buffering
3113 for its standard streams.
3115 ** Changes in behavior
3117 ls --color: files with multiple hard links are no longer colored differently
3118 by default. That can be enabled by changing the LS_COLORS environment
3119 variable. You can control that using the MULTIHARDLINK dircolors input
3120 variable which corresponds to the 'mh' LS_COLORS item. Note these variables
3121 were renamed from 'HARDLINK' and 'hl' which were available since
3122 coreutils-7.1 when this feature was introduced.
3124 ** Deprecated options
3126 nl --page-increment: deprecated in favor of --line-increment, the new option
3127 maintains the previous semantics and the same short option, -i.
3131 chroot now accepts the options --userspec and --groups.
3133 cp accepts a new option, --reflink: create a lightweight copy
3134 using copy-on-write (COW). This is currently only supported within
3135 a btrfs file system.
3137 cp now preserves timestamps on symbolic links, when possible
3139 sort accepts a new option, --human-numeric-sort (-h): sort numbers
3140 while honoring human readable suffixes like KiB and MB etc.
3142 tail --follow now uses inotify when possible, to be more responsive
3143 to file changes and more efficient when monitoring many files.
3146 * Noteworthy changes in release 7.4 (2009-05-07) [stable]
3150 date -d 'next mon', when run on a Monday, now prints the date
3151 7 days in the future rather than the current day. Same for any other
3152 day-of-the-week name, when run on that same day of the week.
3153 [This bug appears to have been present in "the beginning". ]
3155 date -d tuesday, when run on a Tuesday -- using date built from the 7.3
3156 release tarball, not from git -- would print the date 7 days in the future.
3157 Now, it works properly and prints the current date. That was due to
3158 human error (including not-committed changes in a release tarball)
3159 and the fact that there is no check to detect when the gnulib/ git
3164 make check: two tests have been corrected
3168 There have been some ACL-related portability fixes for *BSD,
3169 inherited from gnulib.
3172 * Noteworthy changes in release 7.3 (2009-05-01) [stable]
3176 cp now diagnoses failure to preserve selinux/xattr attributes when
3177 --preserve=context,xattr is specified in combination with -a.
3178 Also, cp no longer suppresses attribute-preservation diagnostics
3179 when preserving SELinux context was explicitly requested.
3181 ls now aligns output correctly in the presence of abbreviated month
3182 names from the locale database that have differing widths.
3184 ls -v and sort -V now order names like "#.b#" properly
3186 mv: do not print diagnostics when failing to preserve xattr's on file
3187 systems without xattr support.
3189 sort -m no longer segfaults when its output file is also an input file.
3190 E.g., with this, touch 1; sort -m -o 1 1, sort would segfault.
3191 [introduced in coreutils-7.2]
3193 ** Changes in behavior
3195 shred, sort, shuf: now use an internal pseudorandom generator by default.
3196 This is mainly noticeable in shred where the 3 random passes it does by
3197 default should proceed at the speed of the disk. Previously /dev/urandom
3198 was used if available, which is relatively slow on GNU/Linux systems.
3200 ** Improved robustness
3202 cp would exit successfully after copying less than the full contents
3203 of a file larger than ~4000 bytes from a linux-/proc file system to a
3204 destination file system with a fundamental block size of 4KiB or greater.
3205 Reading into a 4KiB-or-larger buffer, cp's "read" syscall would return
3206 a value smaller than 4096, and cp would interpret that as EOF (POSIX
3207 allows this). This optimization, now removed, saved 50% of cp's read
3208 syscalls when copying small files. Affected linux kernels: at least
3209 2.6.9 through 2.6.29.
3210 [the optimization was introduced in coreutils-6.0]
3214 df now pre-mounts automountable directories even with automounters for
3215 which stat-like syscalls no longer provoke mounting. Now, df uses open.
3217 'id -G $USER' now works correctly even on Darwin and NetBSD. Previously it
3218 would either truncate the group list to 10, or go into an infinite loop,
3219 due to their non-standard getgrouplist implementations.
3220 [truncation introduced in coreutils-6.11]
3221 [infinite loop introduced in coreutils-7.1]
3224 * Noteworthy changes in release 7.2 (2009-03-31) [stable]
3228 pwd now accepts the options --logical (-L) and --physical (-P). For
3229 compatibility with existing scripts, -P is the default behavior
3230 unless POSIXLY_CORRECT is requested.
3234 cat once again immediately outputs data it has processed.
3235 Previously it would have been buffered and only output if enough
3236 data was read, or on process exit.
3237 [bug introduced in coreutils-6.0]
3239 comm's new --check-order option would fail to detect disorder on any pair
3240 of lines where one was a prefix of the other. For example, this would
3241 fail to report the disorder: printf 'Xb\nX\n'>k; comm --check-order k k
3242 [bug introduced in coreutils-7.0]
3244 cp once again diagnoses the invalid "cp -rl dir dir" right away,
3245 rather than after creating a very deep dir/dir/dir/... hierarchy.
3246 The bug strikes only with both --recursive (-r, -R) and --link (-l).
3247 [bug introduced in coreutils-7.1]
3249 ls --sort=version (-v) sorted names beginning with "." inconsistently.
3250 Now, names that start with "." are always listed before those that don't.
3252 pr: fix the bug whereby --indent=N (-o) did not indent header lines
3253 [bug introduced in coreutils-6.9.90]
3255 sort now handles specified key ends correctly.
3256 Previously -k1,1b would have caused leading space from field 2 to be
3257 included in the sort while -k2,3.0 would have not included field 3.
3259 ** Changes in behavior
3261 cat,cp,install,mv,split: these programs now read and write a minimum
3262 of 32KiB at a time. This was seen to double throughput when reading
3263 cached files on GNU/Linux-based systems.
3265 cp -a now tries to preserve extended attributes (xattr), but does not
3266 diagnose xattr-preservation failure. However, cp --preserve=all still does.
3268 ls --color: hard link highlighting can be now disabled by changing the
3269 LS_COLORS environment variable. To disable it you can add something like
3270 this to your profile: eval `dircolors | sed s/hl=[^:]*:/hl=:/`
3273 * Noteworthy changes in release 7.1 (2009-02-21) [stable]
3277 Add extended attribute support available on certain filesystems like ext2
3279 cp: Tries to copy xattrs when --preserve=xattr or --preserve=all specified
3280 mv: Always tries to copy xattrs
3281 install: Never copies xattrs
3283 cp and mv accept a new option, --no-clobber (-n): silently refrain
3284 from overwriting any existing destination file
3286 dd accepts iflag=cio and oflag=cio to open the file in CIO (concurrent I/O)
3287 mode where this feature is available.
3289 install accepts a new option, --compare (-C): compare each pair of source
3290 and destination files, and if the destination has identical content and
3291 any specified owner, group, permissions, and possibly SELinux context, then
3292 do not modify the destination at all.
3294 ls --color now highlights hard linked files, too
3296 stat -f recognizes the Lustre file system type
3300 chgrp, chmod, chown --silent (--quiet, -f) no longer print some diagnostics
3301 [bug introduced in coreutils-5.1]
3303 cp uses much less memory in some situations
3305 cp -a now correctly tries to preserve SELinux context (announced in 6.9.90),
3306 doesn't inform about failure, unlike with --preserve=all
3308 du --files0-from=FILE no longer reads all of FILE into RAM before
3309 processing the first file name
3311 seq 9223372036854775807 9223372036854775808 now prints only two numbers
3312 on systems with extended long double support and good library support.
3313 Even with this patch, on some systems, it still produces invalid output,
3314 from 3 to at least 1026 lines long. [bug introduced in coreutils-6.11]
3316 seq -w now accounts for a decimal point added to the last number
3317 to correctly print all numbers to the same width.
3319 wc --files0-from=FILE no longer reads all of FILE into RAM, before
3320 processing the first file name, unless the list of names is known
3323 ** Changes in behavior
3325 cp and mv: the --reply={yes,no,query} option has been removed.
3326 Using it has elicited a warning for the last three years.
3328 dd: user specified offsets that are too big are handled better.
3329 Previously, erroneous parameters to skip and seek could result
3330 in redundant reading of the file with no warnings or errors.
3332 du: -H (initially equivalent to --si) is now equivalent to
3333 --dereference-args, and thus works as POSIX requires
3335 shred: now does 3 overwrite passes by default rather than 25.
3337 ls -l now marks SELinux-only files with the less obtrusive '.',
3338 rather than '+'. A file with any other combination of MAC and ACL
3339 is still marked with a '+'.
3342 * Noteworthy changes in release 7.0 (2008-10-05) [beta]
3346 timeout: Run a command with bounded time.
3347 truncate: Set the size of a file to a specified size.
3351 chgrp, chmod, chown, chcon, du, rm: now all display linear performance,
3352 even when operating on million-entry directories on ext3 and ext4 file
3353 systems. Before, they would exhibit O(N^2) performance, due to linear
3354 per-entry seek time cost when operating on entries in readdir order.
3355 Rm was improved directly, while the others inherit the improvement
3356 from the newer version of fts in gnulib.
3358 comm now verifies that the inputs are in sorted order. This check can
3359 be turned off with the --nocheck-order option.
3361 comm accepts new option, --output-delimiter=STR, that allows specification
3362 of an output delimiter other than the default single TAB.
3364 cp and mv: the deprecated --reply=X option is now also undocumented.
3366 dd accepts iflag=fullblock to make it accumulate full input blocks.
3367 With this new option, after a short read, dd repeatedly calls read,
3368 until it fills the incomplete block, reaches EOF, or encounters an error.
3370 df accepts a new option --total, which produces a grand total of all
3371 arguments after all arguments have been processed.
3373 If the GNU MP library is available at configure time, factor and
3374 expr support arbitrarily large numbers. Pollard's rho algorithm is
3375 used to factor large numbers.
3377 install accepts a new option --strip-program to specify the program used to
3380 ls now colors names of files with capabilities if libcap is available.
3382 ls -v now uses filevercmp function as sort predicate (instead of strverscmp)
3384 md5sum now accepts the new option, --quiet, to suppress the printing of
3385 'OK' messages. sha1sum, sha224sum, sha384sum, and sha512sum accept it, too.
3387 sort accepts a new option, --files0-from=F, that specifies a file
3388 containing a null-separated list of files to sort. This list is used
3389 instead of filenames passed on the command-line to avoid problems with
3390 maximum command-line (argv) length.
3392 sort accepts a new option --batch-size=NMERGE, where NMERGE
3393 represents the maximum number of inputs that will be merged at once.
3394 When processing more than NMERGE inputs, sort uses temporary files.
3396 sort accepts a new option --version-sort (-V, --sort=version),
3397 specifying that ordering is to be based on filevercmp.
3401 chcon --verbose now prints a newline after each message
3403 od no longer suffers from platform bugs in printf(3). This is
3404 probably most noticeable when using 'od -tfL' to print long doubles.
3406 seq -0.1 0.1 2 now prints 2,0 when locale's decimal point is ",".
3407 Before, it would mistakenly omit the final number in that example.
3409 shuf honors the --zero-terminated (-z) option, even with --input-range=LO-HI
3411 shuf --head-count is now correctly documented. The documentation
3412 previously claimed it was called --head-lines.
3416 Improved support for access control lists (ACLs): On MacOS X, Solaris 7..10,
3417 HP-UX 11, Tru64, AIX, IRIX 6.5, and Cygwin, "ls -l" now displays the presence
3418 of an ACL on a file via a '+' sign after the mode, and "cp -p" copies ACLs.
3420 join has significantly better performance due to better memory management
3422 ls now uses constant memory when not sorting and using one_per_line format,
3423 no matter how many files are in a given directory. I.e., to list a directory
3424 with very many files, ls -1U is much more efficient.
3426 od now aligns fields across lines when printing multiple -t
3427 specifiers, and no longer prints fields that resulted entirely from
3428 padding the input out to the least common multiple width.
3430 ** Changes in behavior
3432 stat's --context (-Z) option has always been a no-op.
3433 Now it evokes a warning that it is obsolete and will be removed.
3436 * Noteworthy changes in release 6.12 (2008-05-31) [stable]
3440 cp, install, mv, and touch now preserve nanosecond resolution on
3441 file timestamps, on platforms that have the 'utimensat' and
3442 'futimens' system calls.
3446 chcon, runcon: --help output now includes the bug-reporting address
3448 cp -p copies permissions more portably. For example, on MacOS X 10.5,
3449 "cp -p some-fifo some-file" no longer fails while trying to copy the
3450 permissions from the some-fifo argument.
3452 id with no options now prints the SELinux context only when invoked
3453 with no USERNAME argument.
3455 id and groups once again print the AFS-specific nameless group-ID (PAG).
3456 Printing of such large-numbered, kernel-only (not in /etc/group) group-IDs
3457 was suppressed in 6.11 due to ignorance that they are useful.
3459 uniq: avoid subtle field-skipping malfunction due to isblank misuse.
3460 In some locales on some systems, isblank(240) (aka  ) is nonzero.
3461 On such systems, uniq --skip-fields=N would fail to skip the proper
3462 number of fields for some inputs.
3464 tac: avoid segfault with --regex (-r) and multiple files, e.g.,
3465 "echo > x; tac -r x x". [bug present at least in textutils-1.8b, from 1992]
3467 ** Changes in behavior
3469 install once again sets SELinux context, when possible
3470 [it was deliberately disabled in 6.9.90]
3473 * Noteworthy changes in release 6.11 (2008-04-19) [stable]
3477 configure --enable-no-install-program=groups now works.
3479 "cp -fR fifo E" now succeeds with an existing E. Before this fix, using
3480 -fR to copy a fifo or "special" file onto an existing file would fail
3481 with EEXIST. Now, it once again unlinks the destination before trying
3482 to create the destination file. [bug introduced in coreutils-5.90]
3484 dd once again works with unnecessary options like if=/dev/stdin and
3485 of=/dev/stdout. [bug introduced in fileutils-4.0h]
3487 id now uses getgrouplist, when possible. This results in
3488 much better performance when there are many users and/or groups.
3490 ls no longer segfaults on files in /proc when linked with an older version
3491 of libselinux. E.g., ls -l /proc/sys would dereference a NULL pointer.
3493 md5sum would segfault for invalid BSD-style input, e.g.,
3494 echo 'MD5 (' | md5sum -c - Now, md5sum ignores that line.
3495 sha1sum, sha224sum, sha384sum, and sha512sum are affected, too.
3496 [bug introduced in coreutils-5.1.0]
3498 md5sum -c would accept a NUL-containing checksum string like "abcd\0..."
3499 and would unnecessarily read and compute the checksum of the named file,
3500 and then compare that checksum to the invalid one: guaranteed to fail.
3501 Now, it recognizes that the line is not valid and skips it.
3502 sha1sum, sha224sum, sha384sum, and sha512sum are affected, too.
3503 [bug present in the original version, in coreutils-4.5.1, 1995]
3505 "mkdir -Z x dir" no longer segfaults when diagnosing invalid context "x"
3506 mkfifo and mknod would fail similarly. Now they're fixed.
3508 mv would mistakenly unlink a destination file before calling rename,
3509 when the destination had two or more hard links. It no longer does that.
3510 [bug introduced in coreutils-5.3.0]
3512 "paste -d'\' file" no longer overruns memory (heap since coreutils-5.1.2,
3513 stack before then) [bug present in the original version, in 1992]
3515 "pr -e" with a mix of backspaces and TABs no longer corrupts the heap
3516 [bug present in the original version, in 1992]
3518 "ptx -F'\' long-file-name" would overrun a malloc'd buffer and corrupt
3519 the heap. That was triggered by a lone backslash (or odd number of them)
3520 at the end of the option argument to --flag-truncation=STRING (-F),
3521 --word-regexp=REGEXP (-W), or --sentence-regexp=REGEXP (-S).
3523 "rm -r DIR" would mistakenly declare to be "write protected" -- and
3524 prompt about -- full DIR-relative names longer than MIN (PATH_MAX, 8192).
3526 "rmdir --ignore-fail-on-non-empty" detects and ignores the failure
3527 in more cases when a directory is empty.
3529 "seq -f % 1" would issue the erroneous diagnostic "seq: memory exhausted"
3530 rather than reporting the invalid string format.
3531 [bug introduced in coreutils-6.0]
3535 join now verifies that the inputs are in sorted order. This check can
3536 be turned off with the --nocheck-order option.
3538 sort accepts the new option --sort=WORD, where WORD can be one of
3539 general-numeric, month, numeric or random. These are equivalent to the
3540 options --general-numeric-sort/-g, --month-sort/-M, --numeric-sort/-n
3541 and --random-sort/-R, resp.
3545 id and groups work around an AFS-related bug whereby those programs
3546 would print an invalid group number, when given no user-name argument.
3548 ls --color no longer outputs unnecessary escape sequences
3550 seq gives better diagnostics for invalid formats.
3554 rm now works properly even on systems like BeOS and Haiku,
3555 which have negative errno values.
3559 install, mkdir, rmdir and split now write --verbose output to stdout,
3563 * Noteworthy changes in release 6.10 (2008-01-22) [stable]
3567 Fix a non-portable use of sed in configure.ac.
3568 [bug introduced in coreutils-6.9.92]
3571 * Noteworthy changes in release 6.9.92 (2008-01-12) [beta]
3575 cp --parents no longer uses uninitialized memory when restoring the
3576 permissions of a just-created destination directory.
3577 [bug introduced in coreutils-6.9.90]
3579 tr's case conversion would fail in a locale with differing numbers
3580 of lower case and upper case characters. E.g., this would fail:
3581 env LC_CTYPE=en_US.ISO-8859-1 tr '[:upper:]' '[:lower:]'
3582 [bug introduced in coreutils-6.9.90]
3586 "touch -d now writable-but-owned-by-someone-else" now succeeds
3587 whenever that same command would succeed without "-d now".
3588 Before, it would work fine with no -d option, yet it would
3589 fail with the ostensibly-equivalent "-d now".
3592 * Noteworthy changes in release 6.9.91 (2007-12-15) [beta]
3596 "ls -l" would not output "+" on SELinux hosts unless -Z was also given.
3598 "rm" would fail to unlink a non-directory when run in an environment
3599 in which the user running rm is capable of unlinking a directory.
3600 [bug introduced in coreutils-6.9]
3603 * Noteworthy changes in release 6.9.90 (2007-12-01) [beta]
3607 arch: equivalent to uname -m, not installed by default
3608 But don't install this program on Solaris systems.
3610 chcon: change the SELinux security context of a file
3612 mktemp: create a temporary file or directory (or names)
3614 runcon: run a program in a different SELinux security context
3616 ** Programs no longer installed by default
3620 ** Changes in behavior
3622 cp, by default, refuses to copy through a dangling destination symlink
3623 Set POSIXLY_CORRECT if you require the old, risk-prone behavior.
3625 pr -F no longer suppresses the footer or the first two blank lines in
3626 the header. This is for compatibility with BSD and POSIX.
3628 tr now warns about an unescaped backslash at end of string.
3629 The tr from coreutils-5.2.1 and earlier would fail for such usage,
3630 and Solaris' tr ignores that final byte.
3634 Add SELinux support, based on the patch from Fedora:
3635 * cp accepts new --preserve=context option.
3636 * "cp -a" works with SELinux:
3637 Now, cp -a attempts to preserve context, but failure to do so does
3638 not change cp's exit status. However "cp --preserve=context" is
3639 similar, but failure *does* cause cp to exit with nonzero status.
3640 * install accepts new "-Z, --context=C" option.
3641 * id accepts new "-Z" option.
3642 * stat honors the new %C format directive: SELinux security context string
3643 * ls accepts a slightly modified -Z option.
3644 * ls: contrary to Fedora version, does not accept --lcontext and --scontext
3646 The following commands and options now support the standard size
3647 suffixes kB, M, MB, G, GB, and so on for T, P, Y, Z, and Y:
3648 head -c, head -n, od -j, od -N, od -S, split -b, split -C,
3651 cp -p tries to preserve the GID of a file even if preserving the UID
3654 uniq accepts a new option: --zero-terminated (-z). As with the sort
3655 option of the same name, this makes uniq consume and produce
3656 NUL-terminated lines rather than newline-terminated lines.
3658 wc no longer warns about character decoding errors in multibyte locales.
3659 This means for example that "wc /bin/sh" now produces normal output
3660 (though the word count will have no real meaning) rather than many
3663 ** New build options
3665 By default, "make install" no longer attempts to install (or even build) su.
3666 To change that, use ./configure --enable-install-program=su.
3667 If you also want to install the new "arch" program, do this:
3668 ./configure --enable-install-program=arch,su.
3670 You can inhibit the compilation and installation of selected programs
3671 at configure time. For example, to avoid installing "hostname" and
3672 "uptime", use ./configure --enable-no-install-program=hostname,uptime
3673 Note: currently, "make check" passes, even when arch and su are not
3674 built (that's the new default). However, if you inhibit the building
3675 and installation of other programs, don't be surprised if some parts
3676 of "make check" fail.
3678 ** Remove deprecated options
3680 df no longer accepts the --kilobytes option.
3681 du no longer accepts the --kilobytes or --megabytes options.
3682 ls no longer accepts the --kilobytes option.
3683 ptx longer accepts the --copyright option.
3684 who no longer accepts -i or --idle.
3686 ** Improved robustness
3688 ln -f can no longer silently clobber a just-created hard link.
3689 In some cases, ln could be seen as being responsible for data loss.
3690 For example, given directories a, b, c, and files a/f and b/f, we
3691 should be able to do this safely: ln -f a/f b/f c && rm -f a/f b/f
3692 However, before this change, ln would succeed, and thus cause the
3693 loss of the contents of a/f.
3695 stty no longer silently accepts certain invalid hex values
3696 in its 35-colon command-line argument
3700 chmod no longer ignores a dangling symlink. Now, chmod fails
3701 with a diagnostic saying that it cannot operate on such a file.
3702 [bug introduced in coreutils-5.1.0]
3704 cp attempts to read a regular file, even if stat says it is empty.
3705 Before, "cp /proc/cpuinfo c" would create an empty file when the kernel
3706 reports stat.st_size == 0, while "cat /proc/cpuinfo > c" would "work",
3707 and create a nonempty one. [bug introduced in coreutils-6.0]
3709 cp --parents no longer mishandles symlinks to directories in file
3710 name components in the source, e.g., "cp --parents symlink/a/b d"
3711 no longer fails. Also, 'cp' no longer considers a destination
3712 symlink to be the same as the referenced file when copying links
3713 or making backups. For example, if SYM is a symlink to FILE,
3714 "cp -l FILE SYM" now reports an error instead of silently doing
3715 nothing. The behavior of 'cp' is now better documented when the
3716 destination is a symlink.
3718 "cp -i --update older newer" no longer prompts; same for mv
3720 "cp -i" now detects read errors on standard input, and no longer consumes
3721 too much seekable input; same for ln, install, mv, and rm.
3723 cut now diagnoses a range starting with zero (e.g., -f 0-2) as invalid;
3724 before, it would treat it as if it started with 1 (-f 1-2).
3726 "cut -f 2-0" now fails; before, it was equivalent to "cut -f 2-"
3728 cut now diagnoses the '-' in "cut -f -" as an invalid range, rather
3729 than interpreting it as the unlimited range, "1-".
3731 date -d now accepts strings of the form e.g., 'YYYYMMDD +N days',
3732 in addition to the usual 'YYYYMMDD N days'.
3734 du -s now includes the size of any stat'able-but-inaccessible directory
3737 du (without -s) prints whatever it knows of the size of an inaccessible
3738 directory. Before, du would print nothing for such a directory.
3740 ls -x DIR would sometimes output the wrong string in place of the
3741 first entry. [introduced in coreutils-6.8]
3743 ls --color would mistakenly color a dangling symlink as if it were
3744 a regular symlink. This would happen only when the dangling symlink
3745 was not a command-line argument and in a directory with d_type support.
3746 [introduced in coreutils-6.0]
3748 ls --color, (with a custom LS_COLORS envvar value including the
3749 ln=target attribute) would mistakenly output the string "target"
3750 before the name of each symlink. [introduced in coreutils-6.0]
3752 od's --skip (-j) option now works even when the kernel says that a
3753 nonempty regular file has stat.st_size = 0. This happens at least
3754 with files in /proc and linux-2.6.22.
3756 "od -j L FILE" had a bug: when the number of bytes to skip, L, is exactly
3757 the same as the length of FILE, od would skip *no* bytes. When the number
3758 of bytes to skip is exactly the sum of the lengths of the first N files,
3759 od would skip only the first N-1 files. [introduced in textutils-2.0.9]
3761 ./printf %.10000000f 1 could get an internal ENOMEM error and generate
3762 no output, yet erroneously exit with status 0. Now it diagnoses the error
3763 and exits with nonzero status. [present in initial implementation]
3765 seq no longer mishandles obvious cases like "seq 0 0.000001 0.000003",
3766 so workarounds like "seq 0 0.000001 0.0000031" are no longer needed.
3768 seq would mistakenly reject some valid format strings containing %%,
3769 and would mistakenly accept some invalid ones. e.g., %g%% and %%g, resp.
3771 "seq .1 .1" would mistakenly generate no output on some systems
3773 Obsolete sort usage with an invalid ordering-option character, e.g.,
3774 "env _POSIX2_VERSION=199209 sort +1x" no longer makes sort free an
3775 invalid pointer [introduced in coreutils-6.5]
3777 sorting very long lines (relative to the amount of available memory)
3778 no longer provokes unaligned memory access
3780 split --line-bytes=N (-C N) no longer creates an empty file
3781 [this bug is present at least as far back as textutils-1.22 (Jan, 1997)]
3783 tr -c no longer aborts when translating with Set2 larger than the
3784 complement of Set1. [present in the original version, in 1992]
3786 tr no longer rejects an unmatched [:lower:] or [:upper:] in SET1.
3787 [present in the original version]
3790 * Noteworthy changes in release 6.9 (2007-03-22) [stable]
3794 cp -x (--one-file-system) would fail to set mount point permissions
3796 The default block size and output format for df -P are now unaffected by
3797 the DF_BLOCK_SIZE, BLOCK_SIZE, and BLOCKSIZE environment variables. It
3798 is still affected by POSIXLY_CORRECT, though.
3800 Using pr -m -s (i.e., merging files, with TAB as the output separator)
3801 no longer inserts extraneous spaces between output columns.
3803 * Noteworthy changes in release 6.8 (2007-02-24) [not-unstable]
3807 chgrp, chmod, and chown now honor the --preserve-root option.
3808 Before, they would warn, yet continuing traversing and operating on /.
3810 chmod no longer fails in an environment (e.g., a chroot) with openat
3811 support but with insufficient /proc support.
3813 "cp --parents F/G D" no longer creates a directory D/F when F is not
3814 a directory (and F/G is therefore invalid).
3816 "cp --preserve=mode" would create directories that briefly had
3817 too-generous permissions in some cases. For example, when copying a
3818 directory with permissions 777 the destination directory might
3819 temporarily be setgid on some file systems, which would allow other
3820 users to create subfiles with the same group as the directory. Fix
3821 similar problems with 'install' and 'mv'.
3823 cut no longer dumps core for usage like "cut -f2- f1 f2" with two or
3824 more file arguments. This was due to a double-free bug, introduced
3827 dd bs= operands now silently override any later ibs= and obs=
3828 operands, as POSIX and tradition require.
3830 "ls -FRL" always follows symbolic links on Linux. Introduced in
3833 A cross-partition "mv /etc/passwd ~" (by non-root) now prints
3834 a reasonable diagnostic. Before, it would print this:
3835 "mv: cannot remove `/etc/passwd': Not a directory".
3837 pwd and "readlink -e ." no longer fail unnecessarily when a parent
3838 directory is unreadable.
3840 rm (without -f) could prompt when it shouldn't, or fail to prompt
3841 when it should, when operating on a full name longer than 511 bytes
3842 and getting an ENOMEM error while trying to form the long name.
3844 rm could mistakenly traverse into the wrong directory under unusual
3845 conditions: when a full name longer than 511 bytes specifies a search-only
3846 directory, and when forming that name fails with ENOMEM, rm would attempt
3847 to open a truncated-to-511-byte name with the first five bytes replaced
3848 with "[...]". If such a directory were to actually exist, rm would attempt
3851 "rm -rf /etc/passwd" (run by non-root) now prints a diagnostic.
3852 Before it would print nothing.
3854 "rm --interactive=never F" no longer prompts for an unwritable F
3856 "rm -rf D" would emit a misleading diagnostic when failing to
3857 remove a symbolic link within the unwritable directory, D.
3858 Introduced in coreutils-6.0. Similarly, when a cross-partition
3859 "mv" fails because the source directory is unwritable, it now gives
3860 a reasonable diagnostic. Before, this would print
3861 $ mkdir /tmp/x; touch /tmp/x/y; chmod -w /tmp/x;
3862 $ test $(stat -c %d /tmp/x) -ne $(stat -c %d .) && mv /tmp/x/y .
3863 mv: cannot remove `/tmp/x/y': Not a directory
3865 mv: cannot remove `/tmp/x/y': Permission denied.
3869 sort's new --compress-program=PROG option specifies a compression
3870 program to use when writing and reading temporary files.
3871 This can help save both time and disk space when sorting large inputs.
3873 sort accepts the new option -C, which acts like -c except no diagnostic
3874 is printed. Its --check option now accepts an optional argument, and
3875 --check=quiet and --check=silent are now aliases for -C, while
3876 --check=diagnose-first is an alias for -c or plain --check.
3879 * Noteworthy changes in release 6.7 (2006-12-08) [stable]
3883 When cp -p copied a file with special mode bits set, the same bits
3884 were set on the copy even when ownership could not be preserved.
3885 This could result in files that were setuid to the wrong user.
3886 To fix this, special mode bits are now set in the copy only if its
3887 ownership is successfully preserved. Similar problems were fixed
3888 with mv when copying across file system boundaries. This problem
3889 affects all versions of coreutils through 6.6.
3891 cp --preserve=ownership would create output files that temporarily
3892 had too-generous permissions in some cases. For example, when
3893 copying a file with group A and mode 644 into a group-B sticky
3894 directory, the output file was briefly readable by group B.
3895 Fix similar problems with cp options like -p that imply
3896 --preserve=ownership, with install -d when combined with either -o
3897 or -g, and with mv when copying across file system boundaries.
3898 This bug affects all versions of coreutils through 6.6.
3900 du --one-file-system (-x) would skip subdirectories of any directory
3901 listed as second or subsequent command line argument. This bug affects
3902 coreutils-6.4, 6.5 and 6.6.
3905 * Noteworthy changes in release 6.6 (2006-11-22) [stable]
3909 ls would segfault (dereference a NULL pointer) for a file with a
3910 nameless group or owner. This bug was introduced in coreutils-6.5.
3912 A bug in the latest official m4/gettext.m4 (from gettext-0.15)
3913 made configure fail to detect gettext support, due to the unusual
3914 way in which coreutils uses AM_GNU_GETTEXT.
3916 ** Improved robustness
3918 Now, du (and the other fts clients: chmod, chgrp, chown) honor a
3919 trailing slash in the name of a symlink-to-directory even on
3920 Solaris 9, by working around its buggy fstatat implementation.
3923 * Major changes in release 6.5 (2006-11-19) [stable]
3927 du (and the other fts clients: chmod, chgrp, chown) would exit early
3928 when encountering an inaccessible directory on a system with native
3929 openat support (i.e., linux-2.6.16 or newer along with glibc-2.4
3930 or newer). This bug was introduced with the switch to gnulib's
3931 openat-based variant of fts, for coreutils-6.0.
3933 "ln --backup f f" now produces a sensible diagnostic
3937 rm accepts a new option: --one-file-system
3940 * Major changes in release 6.4 (2006-10-22) [stable]
3944 chgrp and chown would malfunction when invoked with both -R and -H and
3945 with one or more of the following: --preserve-root, --verbose, --changes,
3946 --from=o:g (chown only). This bug was introduced with the switch to
3947 gnulib's openat-based variant of fts, for coreutils-6.0.
3949 cp --backup dir1 dir2, would rename an existing dir2/dir1 to dir2/dir1~.
3950 This bug was introduced in coreutils-6.0.
3952 With --force (-f), rm no longer fails for ENOTDIR.
3953 For example, "rm -f existing-non-directory/anything" now exits
3954 successfully, ignoring the error about a nonexistent file.
3957 * Major changes in release 6.3 (2006-09-30) [stable]
3959 ** Improved robustness
3961 pinky no longer segfaults on Darwin 7.9.0 (MacOS X 10.3.9) due to a
3962 buggy native getaddrinfo function.
3964 rm works around a bug in Darwin 7.9.0 (MacOS X 10.3.9) that would
3965 sometimes keep it from removing all entries in a directory on an HFS+
3966 or NFS-mounted partition.
3968 sort would fail to handle very large input (around 40GB) on systems with a
3969 mkstemp function that returns a file descriptor limited to 32-bit offsets.
3973 chmod would fail unnecessarily in an unusual case: when an initially-
3974 inaccessible argument is rendered accessible by chmod's action on a
3975 preceding command line argument. This bug also affects chgrp, but
3976 it is harder to demonstrate. It does not affect chown. The bug was
3977 introduced with the switch from explicit recursion to the use of fts
3978 in coreutils-5.1.0 (2003-10-15).
3980 cp -i and mv -i occasionally neglected to prompt when the copy or move
3981 action was bound to fail. This bug dates back to before fileutils-4.0.
3983 With --verbose (-v), cp and mv would sometimes generate no output,
3984 or neglect to report file removal.
3986 For the "groups" command:
3988 "groups" no longer prefixes the output with "user :" unless more
3989 than one user is specified; this is for compatibility with BSD.
3991 "groups user" now exits nonzero when it gets a write error.
3993 "groups" now processes options like --help more compatibly.
3995 shuf would infloop, given 8KB or more of piped input
3999 Versions of chmod, chown, chgrp, du, and rm (tools that use openat etc.)
4000 compiled for Solaris 8 now also work when run on Solaris 10.
4003 * Major changes in release 6.2 (2006-09-18) [stable candidate]
4005 ** Changes in behavior
4007 mkdir -p and install -d (or -D) now use a method that forks a child
4008 process if the working directory is unreadable and a later argument
4009 uses a relative file name. This avoids some race conditions, but it
4010 means you may need to kill two processes to stop these programs.
4012 rm now rejects attempts to remove the root directory, e.g., 'rm -fr /'
4013 now fails without removing anything. Likewise for any file name with
4014 a final './' or '../' component.
4016 tail now ignores the -f option if POSIXLY_CORRECT is set, no file
4017 operand is given, and standard input is any FIFO; formerly it did
4018 this only for pipes.
4020 ** Infrastructure changes
4022 Coreutils now uses gnulib via the gnulib-tool script.
4023 If you check the source out from CVS, then follow the instructions
4024 in README-cvs. Although this represents a large change to the
4025 infrastructure, it should cause no change in how the tools work.
4029 cp --backup no longer fails when the last component of a source file
4030 name is "." or "..".
4032 "ls --color" would highlight other-writable and sticky directories
4033 no differently than regular directories on a file system with
4034 dirent.d_type support.
4036 "mv -T --verbose --backup=t A B" now prints the " (backup: B.~1~)"
4037 suffix when A and B are directories as well as when they are not.
4039 mv and "cp -r" no longer fail when invoked with two arguments
4040 where the first one names a directory and the second name ends in
4041 a slash and doesn't exist. E.g., "mv dir B/", for nonexistent B,
4042 now succeeds, once more. This bug was introduced in coreutils-5.3.0.
4045 * Major changes in release 6.1 (2006-08-19) [unstable]
4047 ** Changes in behavior
4049 df now considers BSD "kernfs" file systems to be dummies
4053 printf now supports the 'I' flag on hosts whose underlying printf
4054 implementations support 'I', e.g., "printf %Id 2".
4058 cp --sparse preserves sparseness at the end of a file, even when
4059 the file's apparent size is not a multiple of its block size.
4060 [introduced with the original design, in fileutils-4.0r, 2000-04-29]
4062 df (with a command line argument) once again prints its header
4063 [introduced in coreutils-6.0]
4065 ls -CF would misalign columns in some cases involving non-stat'able files
4066 [introduced in coreutils-6.0]
4068 * Major changes in release 6.0 (2006-08-15) [unstable]
4070 ** Improved robustness
4072 df: if the file system claims to have more available than total blocks,
4073 report the number of used blocks as being "total - available"
4074 (a negative number) rather than as garbage.
4076 dircolors: a new autoconf run-test for AIX's buggy strndup function
4077 prevents malfunction on that system; may also affect cut, expand,
4080 fts no longer changes the current working directory, so its clients
4081 (chmod, chown, chgrp, du) no longer malfunction under extreme conditions.
4083 pwd and other programs using lib/getcwd.c work even on file systems
4084 where dirent.d_ino values are inconsistent with those from stat.st_ino.
4086 rm's core is now reentrant: rm --recursive (-r) now processes
4087 hierarchies without changing the working directory at all.
4089 ** Changes in behavior
4091 basename and dirname now treat // as different from / on platforms
4092 where the two are distinct.
4094 chmod, install, and mkdir now preserve a directory's set-user-ID and
4095 set-group-ID bits unless you explicitly request otherwise. E.g.,
4096 'chmod 755 DIR' and 'chmod u=rwx,go=rx DIR' now preserve DIR's
4097 set-user-ID and set-group-ID bits instead of clearing them, and
4098 similarly for 'mkdir -m 755 DIR' and 'mkdir -m u=rwx,go=rx DIR'. To
4099 clear the bits, mention them explicitly in a symbolic mode, e.g.,
4100 'mkdir -m u=rwx,go=rx,-s DIR'. To set them, mention them explicitly
4101 in either a symbolic or a numeric mode, e.g., 'mkdir -m 2755 DIR',
4102 'mkdir -m u=rwx,go=rx,g+s' DIR. This change is for convenience on
4103 systems where these bits inherit from parents. Unfortunately other
4104 operating systems are not consistent here, and portable scripts
4105 cannot assume the bits are set, cleared, or preserved, even when the
4106 bits are explicitly mentioned. For example, OpenBSD 3.9 'mkdir -m
4107 777 D' preserves D's setgid bit but 'chmod 777 D' clears it.
4108 Conversely, Solaris 10 'mkdir -m 777 D', 'mkdir -m g-s D', and
4109 'chmod 0777 D' all preserve D's setgid bit, and you must use
4110 something like 'chmod g-s D' to clear it.
4112 'cp --link --no-dereference' now works also on systems where the
4113 link system call cannot create a hard link to a symbolic link.
4114 This change has no effect on systems with a Linux-based kernel.
4116 csplit and nl now use POSIX syntax for regular expressions, not
4117 Emacs syntax. As a result, character classes like [[:print:]] and
4118 interval expressions like A\{1,9\} now have their usual meaning,
4119 . no longer matches the null character, and \ must precede the + and
4122 date: a command like date -d '2006-04-23 21 days ago' would print
4123 the wrong date in some time zones. (see the test for an example)
4127 df now considers "none" and "proc" file systems to be dummies and
4128 therefore does not normally display them. Also, inaccessible file
4129 systems (which can be caused by shadowed mount points or by
4130 chrooted bind mounts) are now dummies, too.
4132 df now fails if it generates no output, so you can inspect the
4133 exit status of a command like "df -t ext3 -t reiserfs DIR" to test
4134 whether DIR is on a file system of type "ext3" or "reiserfs".
4136 expr no longer complains about leading ^ in a regular expression
4137 (the anchor is ignored), or about regular expressions like A** (the
4138 second "*" is ignored). expr now exits with status 2 (not 3) for
4139 errors it detects in the expression's values; exit status 3 is now
4140 used only for internal errors (such as integer overflow, which expr
4143 install and mkdir now implement the X permission symbol correctly,
4144 e.g., 'mkdir -m a+X dir'; previously the X was ignored.
4146 install now creates parent directories with mode u=rwx,go=rx (755)
4147 instead of using the mode specified by the -m option; and it does
4148 not change the owner or group of parent directories. This is for
4149 compatibility with BSD and closes some race conditions.
4151 ln now uses different (and we hope clearer) diagnostics when it fails.
4152 ln -v now acts more like FreeBSD, so it generates output only when
4153 successful and the output is easier to parse.
4155 ls now defaults to --time-style='locale', not --time-style='posix-long-iso'.
4156 However, the 'locale' time style now behaves like 'posix-long-iso'
4157 if your locale settings appear to be messed up. This change
4158 attempts to have the default be the best of both worlds.
4160 mkfifo and mknod no longer set special mode bits (setuid, setgid,
4161 and sticky) with the -m option.
4163 nohup's usual diagnostic now more precisely specifies the I/O
4164 redirections, e.g., "ignoring input and appending output to
4165 nohup.out". Also, nohup now redirects stderr to nohup.out (or
4166 $HOME/nohup.out) if stdout is closed and stderr is a tty; this is in
4167 response to Open Group XCU ERN 71.
4169 rm --interactive now takes an optional argument, although the
4170 default of using no argument still acts like -i.
4172 rm no longer fails to remove an empty, unreadable directory
4176 seq defaults to a minimal fixed point format that does not lose
4177 information if seq's operands are all fixed point decimal numbers.
4178 You no longer need the '-f%.f' in 'seq -f%.f 1048575 1024 1050623',
4179 for example, since the default format now has the same effect.
4181 seq now lets you use %a, %A, %E, %F, and %G formats.
4183 seq now uses long double internally rather than double.
4185 sort now reports incompatible options (e.g., -i and -n) rather than
4186 silently ignoring one of them.
4188 stat's --format=FMT option now works the way it did before 5.3.0:
4189 FMT is automatically newline terminated. The first stable release
4190 containing this change was 5.92.
4192 stat accepts the new option --printf=FMT, where FMT is *not*
4193 automatically newline terminated.
4195 stat: backslash escapes are interpreted in a format string specified
4196 via --printf=FMT, but not one specified via --format=FMT. That includes
4197 octal (\ooo, at most three octal digits), hexadecimal (\xhh, one or
4198 two hex digits), and the standard sequences (\a, \b, \f, \n, \r, \t,
4201 With no operand, 'tail -f' now silently ignores the '-f' only if
4202 standard input is a FIFO or pipe and POSIXLY_CORRECT is set.
4203 Formerly, it ignored the '-f' when standard input was a FIFO, pipe,
4206 ** Scheduled for removal
4208 ptx's --copyright (-C) option is scheduled for removal in 2007, and
4209 now evokes a warning. Use --version instead.
4211 rm's --directory (-d) option is scheduled for removal in 2006. This
4212 option has been silently ignored since coreutils 5.0. On systems
4213 that support unlinking of directories, you can use the "unlink"
4214 command to unlink a directory.
4216 Similarly, we are considering the removal of ln's --directory (-d,
4217 -F) option in 2006. Please write to <bug-coreutils@gnu.org> if this
4218 would cause a problem for you. On systems that support hard links
4219 to directories, you can use the "link" command to create one.
4223 base64: base64 encoding and decoding (RFC 3548) functionality.
4224 sha224sum: print or check a SHA224 (224-bit) checksum
4225 sha256sum: print or check a SHA256 (256-bit) checksum
4226 sha384sum: print or check a SHA384 (384-bit) checksum
4227 sha512sum: print or check a SHA512 (512-bit) checksum
4228 shuf: Shuffle lines of text.
4232 chgrp now supports --preserve-root, --no-preserve-root (default),
4233 as it was documented to do, and just as chmod, chown, and rm do.
4235 New dd iflag= and oflag= flags:
4237 'directory' causes dd to fail unless the file is a directory, on
4238 hosts that support this (e.g., Linux kernels, version 2.1.126 and
4239 later). This has limited utility but is present for completeness.
4241 'noatime' causes dd to read a file without updating its access
4242 time, on hosts that support this (e.g., Linux kernels, version
4245 'nolinks' causes dd to fail if the file has multiple hard links,
4246 on hosts that support this (e.g., Solaris 10 and later).
4248 ls accepts the new option --group-directories-first, to make it
4249 list directories before files.
4251 rm now accepts the -I (--interactive=once) option. This new option
4252 prompts once if rm is invoked recursively or if more than three
4253 files are being deleted, which is less intrusive than -i prompting
4254 for every file, but provides almost the same level of protection
4257 shred and sort now accept the --random-source option.
4259 sort now accepts the --random-sort (-R) option and 'R' ordering option.
4261 sort now supports obsolete usages like "sort +1 -2" unless
4262 POSIXLY_CORRECT is set. However, when conforming to POSIX
4263 1003.1-2001 "sort +1" still sorts the file named "+1".
4265 wc accepts a new option --files0-from=FILE, where FILE contains a
4266 list of NUL-terminated file names.
4270 cat with any of the options, -A -v -e -E -T, when applied to a
4271 file in /proc or /sys (linux-specific), would truncate its output,
4272 usually printing nothing.
4274 cp -p would fail in a /proc-less chroot, on some systems
4276 When 'cp -RL' encounters the same directory more than once in the
4277 hierarchy beneath a single command-line argument, it no longer confuses
4278 them with hard-linked directories.
4280 fts-using tools (chmod, chown, chgrp, du) no longer fail due to
4281 a double-free bug -- it could be triggered by making a directory
4282 inaccessible while e.g., du is traversing the hierarchy under it.
4284 fts-using tools (chmod, chown, chgrp, du) no longer misinterpret
4285 a very long symlink chain as a dangling symlink. Before, such a
4286 misinterpretation would cause these tools not to diagnose an ELOOP error.
4288 ls --indicator-style=file-type would sometimes stat a symlink
4291 ls --file-type worked like --indicator-style=slash (-p),
4292 rather than like --indicator-style=file-type.
4294 mv: moving a symlink into the place of an existing non-directory is
4295 now done atomically; before, mv would first unlink the destination.
4297 mv -T DIR EMPTY_DIR no longer fails unconditionally. Also, mv can
4298 now remove an empty destination directory: mkdir -p a b/a; mv a b
4300 rm (on systems with openat) can no longer exit before processing
4301 all command-line arguments.
4303 rm is no longer susceptible to a few low-probability memory leaks.
4305 rm -r no longer fails to remove an inaccessible and empty directory
4307 rm -r's cycle detection code can no longer be tricked into reporting
4308 a false positive (introduced in fileutils-4.1.9).
4310 shred --remove FILE no longer segfaults on Gentoo systems
4312 sort would fail for large inputs (~50MB) on systems with a buggy
4313 mkstemp function. sort and tac now use the replacement mkstemp
4314 function, and hence are no longer subject to limitations (of 26 or 32,
4315 on the maximum number of files from a given template) on HP-UX 10.20,
4316 SunOS 4.1.4, Solaris 2.5.1 and OSF1/Tru64 V4.0F&V5.1.
4318 tail -f once again works on a file with the append-only
4319 attribute (affects at least Linux ext2, ext3, xfs file systems)
4321 * Major changes in release 5.97 (2006-06-24) [stable]
4322 * Major changes in release 5.96 (2006-05-22) [stable]
4323 * Major changes in release 5.95 (2006-05-12) [stable]
4324 * Major changes in release 5.94 (2006-02-13) [stable]
4326 [see the b5_9x branch for details]
4328 * Major changes in release 5.93 (2005-11-06) [stable]
4332 dircolors no longer segfaults upon an attempt to use the new
4333 STICKY_OTHER_WRITABLE (OWT) attribute.
4335 du no longer overflows a counter when processing a file larger than
4336 2^31-1 on some 32-bit systems (at least some AIX 5.1 configurations).
4338 md5sum once again defaults to using the ' ' non-binary marker
4339 (rather than the '*' binary marker) by default on Unix-like systems.
4341 mkdir -p and install -d no longer exit nonzero when asked to create
4342 a directory like 'nonexistent/.'
4344 rm emits a better diagnostic when (without -r) it fails to remove
4345 a directory on e.g., Solaris 9/10 systems.
4347 tac now works when stdin is a tty, even on non-Linux systems.
4349 "tail -c 2 FILE" and "touch 0101000000" now operate as POSIX
4350 1003.1-2001 requires, even when coreutils is conforming to older
4351 POSIX standards, as the newly-required behavior is upward-compatible
4354 The documentation no longer mentions rm's --directory (-d) option.
4356 ** Build-related bug fixes
4358 installing .mo files would fail
4361 * Major changes in release 5.92 (2005-10-22) [stable]
4365 chmod now diagnoses an invalid mode string starting with an octal digit
4367 dircolors now properly quotes single-quote characters
4370 * Major changes in release 5.91 (2005-10-17) [stable candidate]
4374 "mkdir -p /a/b/c" no longer fails merely because a leading prefix
4375 directory (e.g., /a or /a/b) exists on a read-only file system.
4379 tail's --allow-missing option has been removed. Use --retry instead.
4381 stat's --link and -l options have been removed.
4382 Use --dereference (-L) instead.
4384 ** Deprecated options
4386 Using ls, du, or df with the --kilobytes option now evokes a warning
4387 that the long-named option is deprecated. Use '-k' instead.
4389 du's long-named --megabytes option now evokes a warning.
4393 * Major changes in release 5.90 (2005-09-29) [unstable]
4395 ** Bring back support for 'head -NUM', 'tail -NUM', etc. even when
4396 conforming to POSIX 1003.1-2001. The following changes apply only
4397 when conforming to POSIX 1003.1-2001; there is no effect when
4398 conforming to older POSIX versions.
4400 The following usages now behave just as when conforming to older POSIX:
4403 expand -TAB1[,TAB2,...]
4409 join -o FIELD_NAME1 FIELD_NAME2...
4414 tail -[NUM][bcl][f] [FILE]
4416 The following usages no longer work, due to the above changes:
4418 date -I TIMESPEC (use 'date -ITIMESPEC' instead)
4419 od -w WIDTH (use 'od -wWIDTH' instead)
4420 pr -S STRING (use 'pr -SSTRING' instead)
4422 A few usages still have behavior that depends on which POSIX standard is
4423 being conformed to, and portable applications should beware these
4424 problematic usages. These include:
4426 Problematic Standard-conforming replacement, depending on
4427 usage whether you prefer the behavior of:
4428 POSIX 1003.2-1992 POSIX 1003.1-2001
4429 sort +4 sort -k 5 sort ./+4
4430 tail +4 tail -n +4 tail ./+4
4431 tail - f tail f [see (*) below]
4432 tail -c 4 tail -c 10 ./4 tail -c4
4433 touch 12312359 f touch -t 12312359 f touch ./12312359 f
4434 uniq +4 uniq -s 4 uniq ./+4
4436 (*) "tail - f" does not conform to POSIX 1003.1-2001; to read
4437 standard input and then "f", use the command "tail -- - f".
4439 These changes are in response to decisions taken in the January 2005
4440 Austin Group standardization meeting. For more details, please see
4441 "Utility Syntax Guidelines" in the Minutes of the January 2005
4442 Meeting <https://www.opengroup.org/austin/docs/austin_239.html>.
4444 ** Binary input and output are now implemented more consistently.
4445 These changes affect only platforms like MS-DOS that distinguish
4446 between binary and text files.
4448 The following programs now always use text input/output:
4452 The following programs now always use binary input/output to copy data:
4456 The following programs now always use binary input/output to copy
4457 data, except for stdin and stdout when it is a terminal.
4459 head tac tail tee tr
4460 (cat behaves similarly, unless one of the options -bensAE is used.)
4462 cat's --binary or -B option has been removed. It existed only on
4463 MS-DOS-like platforms, and didn't work as documented there.
4465 md5sum and sha1sum now obey the -b or --binary option, even if
4466 standard input is a terminal, and they no longer report files to be
4467 binary if they actually read them in text mode.
4469 ** Changes for better conformance to POSIX
4471 cp, ln, mv, rm changes:
4473 Leading white space is now significant in responses to yes-or-no questions.
4474 For example, if "rm" asks "remove regular file `foo'?" and you respond
4475 with " y" (i.e., space before "y"), it counts as "no".
4479 On a QUIT or PIPE signal, dd now exits without printing statistics.
4481 On hosts lacking the INFO signal, dd no longer treats the USR1
4482 signal as if it were INFO when POSIXLY_CORRECT is set.
4484 If the file F is non-seekable and contains fewer than N blocks,
4485 then before copying "dd seek=N of=F" now extends F with zeroed
4486 blocks until F contains N blocks.
4490 When POSIXLY_CORRECT is set, "fold file -3" is now equivalent to
4491 "fold file ./-3", not the obviously-erroneous "fold file ./-w3".
4495 -p now marks only directories; it is equivalent to the new option
4496 --indicator-style=slash. Use --file-type or
4497 --indicator-style=file-type to get -p's old behavior.
4501 Documentation and diagnostics now refer to "nicenesses" (commonly
4502 in the range -20...19) rather than "nice values" (commonly 0...39).
4506 nohup now ignores the umask when creating nohup.out.
4508 nohup now closes stderr if it is a terminal and stdout is closed.
4510 nohup now exits with status 127 (not 1) when given an invalid option.
4514 It now rejects the empty name in the normal case. That is,
4515 "pathchk -p ''" now fails, and "pathchk ''" fails unless the
4516 current host (contra POSIX) allows empty file names.
4518 The new -P option checks whether a file name component has leading "-",
4519 as suggested in interpretation "Austin-039:XCU:pathchk:pathchk -p"
4520 <https://collaboration.opengroup.org/austin/interps/documents.php?action=show&gdid=6232>.
4521 It also rejects the empty name even if the current host accepts it; see
4522 <https://collaboration.opengroup.org/austin/interps/documents.php?action=show&gdid=6233>.
4524 The --portability option is now equivalent to -p -P.
4528 chmod, mkdir, mkfifo, and mknod formerly mishandled rarely-used symbolic
4529 permissions like =xX and =u, and did not properly diagnose some invalid
4530 strings like g+gr, ug,+x, and +1. These bugs have been fixed.
4532 csplit could produce corrupt output, given input lines longer than 8KB
4534 dd now computes statistics using a realtime clock (if available)
4535 rather than the time-of-day clock, to avoid glitches if the
4536 time-of-day is changed while dd is running. Also, it avoids
4537 using unsafe code in signal handlers; this fixes some core dumps.
4539 expr and test now correctly compare integers of unlimited magnitude.
4541 expr now detects integer overflow when converting strings to integers,
4542 rather than silently wrapping around.
4544 ls now refuses to generate timestamps containing more than 1000 bytes, to
4545 foil potential denial-of-service attacks on hosts with very large stacks.
4547 "mkdir -m =+x dir" no longer ignores the umask when evaluating "+x",
4548 and similarly for mkfifo and mknod.
4550 "mkdir -p /tmp/a/b dir" no longer attempts to create the '.'-relative
4551 directory, dir (in /tmp/a), when, after creating /tmp/a/b, it is unable
4552 to return to its initial working directory. Similarly for "install -D
4553 file /tmp/a/b/file".
4555 "pr -D FORMAT" now accepts the same formats that "date +FORMAT" does.
4557 stat now exits nonzero if a file operand does not exist
4559 ** Improved robustness
4561 Date no longer needs to allocate virtual memory to do its job,
4562 so it can no longer fail due to an out-of-memory condition,
4563 no matter how large the result.
4565 ** Improved portability
4567 hostid now prints exactly 8 hexadecimal digits, possibly with leading zeros,
4568 and without any spurious leading "fff..." on 64-bit hosts.
4570 nice now works on Darwin 7.7.0 in spite of its invalid definition of NZERO.
4572 'rm -r' can remove all entries in a directory even when it is on a
4573 file system for which readdir is buggy and that was not checked by
4574 coreutils' old configure-time run-test.
4576 sleep no longer fails when resumed after being suspended on linux-2.6.8.1,
4577 in spite of that kernel's buggy nanosleep implementation.
4581 chmod -w now complains if its behavior differs from what chmod a-w
4582 would do, and similarly for chmod -r, chmod -x, etc.
4584 cp and mv: the --reply=X option is deprecated
4586 date accepts the new option --rfc-3339=TIMESPEC. The old --iso-8601 (-I)
4587 option is deprecated; it still works, but new applications should avoid it.
4588 date, du, ls, and pr's time formats now support new %:z, %::z, %:::z
4589 specifiers for numeric time zone offsets like -07:00, -07:00:00, and -07.
4591 dd has new iflag= and oflag= flags "binary" and "text", which have an
4592 effect only on nonstandard platforms that distinguish text from binary I/O.
4594 dircolors now supports SETUID, SETGID, STICKY_OTHER_WRITABLE,
4595 OTHER_WRITABLE, and STICKY, with ls providing default colors for these
4596 categories if not specified by dircolors.
4598 du accepts new options: --time[=TYPE] and --time-style=STYLE
4600 join now supports a NUL field separator, e.g., "join -t '\0'".
4601 join now detects and reports incompatible options, e.g., "join -t x -t y",
4603 ls no longer outputs an extra space between the mode and the link count
4604 when none of the listed files has an ACL.
4606 md5sum --check now accepts multiple input files, and similarly for sha1sum.
4608 If stdin is a terminal, nohup now redirects it from /dev/null to
4609 prevent the command from tying up an OpenSSH session after you logout.
4611 "rm -FOO" now suggests "rm ./-FOO" if the file "-FOO" exists and
4612 "-FOO" is not a valid option.
4614 stat -f -c %S outputs the fundamental block size (used for block counts).
4615 stat -f's default output format has been changed to output this size as well.
4616 stat -f recognizes file systems of type XFS and JFS
4618 "touch -" now touches standard output, not a file named "-".
4620 uname -a no longer generates the -p and -i outputs if they are unknown.
4622 * Major changes in release 5.3.0 (2005-01-08) [unstable]
4626 Several fixes to chgrp and chown for compatibility with POSIX and BSD:
4628 Do not affect symbolic links by default.
4629 Now, operate on whatever a symbolic link points to, instead.
4630 To get the old behavior, use --no-dereference (-h).
4632 --dereference now works, even when the specified owner
4633 and/or group match those of an affected symlink.
4635 Check for incompatible options. When -R and --dereference are
4636 both used, then either -H or -L must also be used. When -R and -h
4637 are both used, then -P must be in effect.
4639 -H, -L, and -P have no effect unless -R is also specified.
4640 If -P and -R are both specified, -h is assumed.
4642 Do not optimize away the chown() system call when the file's owner
4643 and group already have the desired value. This optimization was
4644 incorrect, as it failed to update the last-changed time and reset
4645 special permission bits, as POSIX requires.
4647 "chown : file", "chown '' file", and "chgrp '' file" now succeed
4648 without changing the uid or gid, instead of reporting an error.
4650 Do not report an error if the owner or group of a
4651 recursively-encountered symbolic link cannot be updated because
4652 the file system does not support it.
4654 chmod now accepts multiple mode-like options, e.g., "chmod -r -w f".
4656 chown is no longer subject to a race condition vulnerability, when
4657 used with --from=O:G and without the (-h) --no-dereference option.
4659 cut's --output-delimiter=D option works with abutting byte ranges.
4661 dircolors's documentation now recommends that shell scripts eval
4662 "`dircolors`" rather than `dircolors`, to avoid shell expansion pitfalls.
4664 du no longer segfaults when a subdirectory of an operand
4665 directory is removed while du is traversing that subdirectory.
4666 Since the bug was in the underlying fts.c module, it also affected
4667 chown, chmod, and chgrp.
4669 du's --exclude-from=FILE and --exclude=P options now compare patterns
4670 against the entire name of each file, rather than against just the
4673 echo now conforms to POSIX better. It supports the \0ooo syntax for
4674 octal escapes, and \c now terminates printing immediately. If
4675 POSIXLY_CORRECT is set and the first argument is not "-n", echo now
4676 outputs all option-like arguments instead of treating them as options.
4678 expand and unexpand now conform to POSIX better. They check for
4679 blanks (which can include characters other than space and tab in
4680 non-POSIX locales) instead of spaces and tabs. Unexpand now
4681 preserves some blanks instead of converting them to tabs or spaces.
4683 "ln x d/" now reports an error if d/x is a directory and x a file,
4684 instead of incorrectly creating a link to d/x/x.
4686 ls no longer segfaults on systems for which SIZE_MAX != (size_t) -1.
4688 md5sum and sha1sum now report an error when given so many input
4689 lines that their line counter overflows, instead of silently
4690 reporting incorrect results.
4694 If it fails to lower the niceness due to lack of permissions,
4695 it goes ahead and runs the command anyway, as POSIX requires.
4697 It no longer incorrectly reports an error if the current niceness
4700 It no longer assumes that nicenesses range from -20 through 19.
4702 It now consistently adjusts out-of-range nicenesses to the
4703 closest values in range; formerly it sometimes reported an error.
4705 pathchk no longer accepts trailing options, e.g., "pathchk -p foo -b"
4706 now treats -b as a file name to check, not as an invalid option.
4708 'pr --columns=N' was not equivalent to 'pr -N' when also using
4711 pr now supports page numbers up to 2**64 on most hosts, and it
4712 detects page number overflow instead of silently wrapping around.
4713 pr now accepts file names that begin with "+" so long as the rest of
4714 the file name does not look like a page range.
4716 printf has several changes:
4718 It now uses 'intmax_t' (not 'long int') to format integers, so it
4719 can now format 64-bit integers on most modern hosts.
4721 On modern hosts it now supports the C99-inspired %a, %A, %F conversion
4722 specs, the "'" and "0" flags, and the ll, j, t, and z length modifiers
4723 (this is compatible with recent Bash versions).
4725 The printf command now rejects invalid conversion specifications
4726 like %#d, instead of relying on undefined behavior in the underlying
4729 ptx now diagnoses invalid values for its --width=N (-w)
4730 and --gap-size=N (-g) options.
4732 mv (when moving between partitions) no longer fails when
4733 operating on too many command-line-specified nonempty directories.
4735 "readlink -f" is more compatible with prior implementations
4737 rm (without -f) no longer hangs when attempting to remove a symlink
4738 to a file on an off-line NFS-mounted partition.
4740 rm no longer gets a failed assertion under some unusual conditions.
4742 rm no longer requires read access to the current directory.
4744 "rm -r" would mistakenly fail to remove files under a directory
4745 for some types of errors (e.g., read-only file system, I/O error)
4746 when first encountering the directory.
4750 "sort -o -" now writes to a file named "-" instead of to standard
4751 output; POSIX requires this.
4753 An unlikely race condition has been fixed where "sort" could have
4754 mistakenly removed a temporary file belonging to some other process.
4756 "sort" no longer has O(N**2) behavior when it creates many temporary files.
4758 tac can now handle regular, nonseekable files like Linux's
4759 /proc/modules. Before, it would produce no output for such a file.
4761 tac would exit immediately upon I/O or temp-file creation failure.
4762 Now it continues on, processing any remaining command line arguments.
4764 "tail -f" no longer mishandles pipes and fifos. With no operands,
4765 tail now ignores -f if standard input is a pipe, as POSIX requires.
4766 When conforming to POSIX 1003.2-1992, tail now supports the SUSv2 b
4767 modifier (e.g., "tail -10b file") and it handles some obscure cases
4768 more correctly, e.g., "tail +cl" now reads the file "+cl" rather
4769 than reporting an error, "tail -c file" no longer reports an error,
4770 and "tail - file" no longer reads standard input.
4772 tee now exits when it gets a SIGPIPE signal, as POSIX requires.
4773 To get tee's old behavior, use the shell command "(trap '' PIPE; tee)".
4774 Also, "tee -" now writes to standard output instead of to a file named "-".
4776 "touch -- MMDDhhmm[yy] file" is now equivalent to
4777 "touch MMDDhhmm[yy] file" even when conforming to pre-2001 POSIX.
4779 tr no longer mishandles a second operand with leading "-".
4781 who now prints user names in full instead of truncating them after 8 bytes.
4783 The following commands now reject unknown options instead of
4784 accepting them as operands, so that users are properly warned that
4785 options may be added later. Formerly they accepted unknown options
4786 as operands; e.g., "basename -a a" acted like "basename -- -a a".
4788 basename dirname factor hostname link nohup sync unlink yes
4792 For efficiency, 'sort -m' no longer copies input to a temporary file
4793 merely because the input happens to come from a pipe. As a result,
4794 some relatively-contrived examples like 'cat F | sort -m -o F - G'
4795 are no longer safe, as 'sort' might start writing F before 'cat' is
4796 done reading it. This problem cannot occur unless '-m' is used.
4798 When outside the default POSIX locale, the 'who' and 'pinky'
4799 commands now output timestamps like "2004-06-21 13:09" instead of
4800 the traditional "Jun 21 13:09".
4802 pwd now works even when run from a working directory whose name
4803 is longer than PATH_MAX.
4805 cp, install, ln, and mv have a new --no-target-directory (-T) option,
4806 and -t is now a short name for their --target-directory option.
4808 cp -pu and mv -u (when copying) now don't bother to update the
4809 destination if the resulting timestamp would be no newer than the
4810 preexisting timestamp. This saves work in the common case when
4811 copying or moving multiple times to the same destination in a file
4812 system with a coarse timestamp resolution.
4814 cut accepts a new option, --complement, to complement the set of
4815 selected bytes, characters, or fields.
4817 dd now also prints the number of bytes transferred, the time, and the
4818 transfer rate. The new "status=noxfer" operand suppresses this change.
4820 dd has new conversions for the conv= option:
4822 nocreat do not create the output file
4823 excl fail if the output file already exists
4824 fdatasync physically write output file data before finishing
4825 fsync likewise, but also write metadata
4827 dd has new iflag= and oflag= options with the following flags:
4829 append append mode (makes sense for output file only)
4830 direct use direct I/O for data
4831 dsync use synchronized I/O for data
4832 sync likewise, but also for metadata
4833 nonblock use non-blocking I/O
4834 nofollow do not follow symlinks
4835 noctty do not assign controlling terminal from file
4837 stty now provides support (iutf8) for setting UTF-8 input mode.
4839 With stat, a specified format is no longer automatically newline terminated.
4840 If you want a newline at the end of your output, append '\n' to the format
4843 'df', 'du', and 'ls' now take the default block size from the
4844 BLOCKSIZE environment variable if the BLOCK_SIZE, DF_BLOCK_SIZE,
4845 DU_BLOCK_SIZE, and LS_BLOCK_SIZE environment variables are not set.
4846 Unlike the other variables, though, BLOCKSIZE does not affect
4847 values like 'ls -l' sizes that are normally displayed as bytes.
4848 This new behavior is for compatibility with BSD.
4850 du accepts a new option --files0-from=FILE, where FILE contains a
4851 list of NUL-terminated file names.
4853 Date syntax as used by date -d, date -f, and touch -d has been
4856 Dates like 'January 32' with out-of-range components are now rejected.
4858 Dates can have fractional timestamps like 2004-02-27 14:19:13.489392193.
4860 Dates can be entered via integer counts of seconds since 1970 when
4861 prefixed by '@'. For example, '@321' represents 1970-01-01 00:05:21 UTC.
4863 Time zone corrections can now separate hours and minutes with a colon,
4864 and can follow standard abbreviations like "UTC". For example,
4865 "UTC +0530" and "+05:30" are supported, and are both equivalent to "+0530".
4867 Date values can now have leading TZ="..." assignments that override
4868 the environment only while that date is being processed. For example,
4869 the following shell command converts from Paris to New York time:
4871 TZ="America/New_York" date --date='TZ="Europe/Paris" 2004-10-31 06:30'
4873 'date' has a new option --iso-8601=ns that outputs
4874 nanosecond-resolution timestamps.
4876 echo -e '\xHH' now outputs a byte whose hexadecimal value is HH,
4877 for compatibility with bash.
4879 ls now exits with status 1 on minor problems, 2 if serious trouble.
4881 ls has a new --hide=PATTERN option that behaves like
4882 --ignore=PATTERN, except that it is overridden by -a or -A.
4883 This can be useful for aliases, e.g., if lh is an alias for
4884 "ls --hide='*~'", then "lh -A" lists the file "README~".
4886 In the following cases POSIX allows the default GNU behavior,
4887 so when POSIXLY_CORRECT is set:
4889 false, printf, true, unlink, and yes all support --help and --option.
4890 ls supports TABSIZE.
4891 pr no longer depends on LC_TIME for the date format in non-POSIX locales.
4892 printf supports \u, \U, \x.
4893 tail supports two or more files when using the obsolete option syntax.
4895 The usual '--' operand is now supported by chroot, hostid, hostname,
4898 'od' now conforms to POSIX better, and is more compatible with BSD:
4900 The older syntax "od [-abcdfilosx]... [FILE] [[+]OFFSET[.][b]]" now works
4901 even without --traditional. This is a change in behavior if there
4902 are one or two operands and the last one begins with +, or if
4903 there are two operands and the latter one begins with a digit.
4904 For example, "od foo 10" and "od +10" now treat the last operand as
4905 an offset, not as a file name.
4907 -h is no longer documented, and may be withdrawn in future versions.
4908 Use -x or -t x2 instead.
4910 -i is now equivalent to -t dI (not -t d2), and
4911 -l is now equivalent to -t dL (not -t d4).
4913 -s is now equivalent to -t d2. The old "-s[NUM]" or "-s NUM"
4914 option has been renamed to "-S NUM".
4916 The default output format is now -t oS, not -t o2, i.e., short int
4917 rather than two-byte int. This makes a difference only on hosts like
4918 Cray systems where the C short int type requires more than two bytes.
4920 readlink accepts new options: --canonicalize-existing (-e)
4921 and --canonicalize-missing (-m).
4923 The stat option --filesystem has been renamed to --file-system, for
4924 consistency with POSIX "file system" and with cp and du --one-file-system.
4928 md5sum and sha1sum's undocumented --string option has been removed.
4930 tail's undocumented --max-consecutive-size-changes option has been removed.
4932 * Major changes in release 5.2.1 (2004-03-12) [stable]
4936 mv could mistakenly fail to preserve hard links when moving two
4937 or more arguments between partitions.
4939 'cp --sparse=always F /dev/hdx' no longer tries to use lseek to create
4940 holes in the destination.
4942 nohup now sets the close-on-exec flag for its copy of the stderr file
4943 descriptor. This avoids some nohup-induced hangs. For example, before
4944 this change, if you ran 'ssh localhost', then 'nohup sleep 600 </dev/null &',
4945 and then exited that remote shell, the ssh session would hang until the
4946 10-minute sleep terminated. With the fixed nohup, the ssh session
4947 terminates immediately.
4949 'expr' now conforms to POSIX better:
4951 Integers like -0 and 00 are now treated as zero.
4953 The '|' operator now returns 0, not its first argument, if both
4954 arguments are null or zero. E.g., 'expr "" \| ""' now returns 0,
4955 not the empty string.
4957 The '|' and '&' operators now use short-circuit evaluation, e.g.,
4958 'expr 1 \| 1 / 0' no longer reports a division by zero.
4962 'chown user.group file' now has its traditional meaning even when
4963 conforming to POSIX 1003.1-2001, so long as no user has a name
4964 containing '.' that happens to equal 'user.group'.
4967 * Major changes in release 5.2.0 (2004-02-19) [stable]
4974 * Major changes in release 5.1.3 (2004-02-08): candidate to become stable 5.2.0
4978 'cp -d' now works as required even on systems like OSF V5.1 that
4979 declare stat and lstat as 'static inline' functions.
4981 timestamps output by stat now include actual fractional seconds,
4982 when available -- or .0000000 for files without that information.
4984 seq no longer infloops when printing 2^31 or more numbers.
4985 For reference, seq `echo 2^31|bc` > /dev/null takes about one hour
4986 on a 1.6 GHz Athlon 2000 XP. Now it can output 2^53-1 numbers before
4989 * Major changes in release 5.1.2 (2004-01-25):
4993 rmdir -p exits with status 1 on error; formerly it sometimes exited
4994 with status 0 when given more than one argument.
4996 nohup now always exits with status 127 when it finds an error,
4997 as POSIX requires; formerly it sometimes exited with status 1.
4999 Several programs (including cut, date, dd, env, hostname, nl, pr,
5000 stty, and tr) now always exit with status 1 when they find an error;
5001 formerly they sometimes exited with status 2.
5003 factor no longer reports a usage error if stdin has the wrong format.
5005 paste no longer infloops on ppc systems (bug introduced in 5.1.1)
5008 * Major changes in release 5.1.1 (2004-01-17):
5010 ** Configuration option
5012 You can select the default level of POSIX conformance at configure-time,
5013 e.g., by ./configure DEFAULT_POSIX2_VERSION=199209
5017 fold -s works once again on systems with differing sizes for int
5018 and size_t (bug introduced in 5.1.0)
5022 touch -r now specifies the origin for any relative times in the -d
5023 operand, if both options are given. For example, "touch -r FOO -d
5024 '-5 seconds' BAR" sets BAR's modification time to be five seconds
5027 join: The obsolete options "-j1 FIELD", "-j2 FIELD", and
5028 "-o LIST1 LIST2..." are no longer supported on POSIX 1003.1-2001 systems.
5029 Portable scripts should use "-1 FIELD", "-2 FIELD", and
5030 "-o LIST1,LIST2..." respectively. If join was compiled on a
5031 POSIX 1003.1-2001 system, you may enable the old behavior
5032 by setting _POSIX2_VERSION=199209 in your environment.
5033 [This change was reverted in coreutils 5.3.1.]
5036 * Major changes in release 5.1.0 (2003-12-21):
5040 chgrp, chmod, and chown can now process (with -R) hierarchies of virtually
5041 unlimited depth. Before, they would fail to operate on any file they
5042 encountered with a relative name of length PATH_MAX (often 4096) or longer.
5044 chgrp, chmod, chown, and rm accept the new options:
5045 --preserve-root, --no-preserve-root (default)
5047 chgrp and chown now accept POSIX-mandated -L, -H, and -P options
5049 du can now process hierarchies of virtually unlimited depth.
5050 Before, du was limited by the user's stack size and it would get a
5051 stack overflow error (often a segmentation fault) when applied to
5052 a hierarchy of depth around 30,000 or larger.
5054 du works even when run from an inaccessible directory
5056 du -D now dereferences all symlinks specified on the command line,
5057 not just the ones that reference directories
5059 du now accepts -P (--no-dereference), for compatibility with du
5060 of NetBSD and for consistency with e.g., chown and chgrp
5062 du's -H option will soon have the meaning required by POSIX
5063 (--dereference-args, aka -D) rather then the current meaning of --si.
5064 Now, using -H elicits a warning to that effect.
5066 When given -l and similar options, ls now adjusts the output column
5067 widths to fit the data, so that output lines are shorter and have
5068 columns that line up better. This may adversely affect shell
5069 scripts that expect fixed-width columns, but such shell scripts were
5070 not portable anyway, even with old GNU ls where the columns became
5071 ragged when a datum was too wide.
5073 du accepts a new option, -0/--null, to make it produce NUL-terminated
5078 printf, seq, tail, and sleep now parse floating-point operands
5079 and options in the C locale. POSIX requires this for printf.
5081 od -c -w9999999 no longer segfaults
5083 csplit no longer reads from freed memory (dumping core on some systems)
5085 csplit would mistakenly exhaust virtual memory in some cases
5087 ls --width=N (for very large N) is no longer subject to an address
5088 arithmetic bug that could result in bounds violations.
5090 ls --width=N (with -x or -C) no longer allocates more space
5091 (potentially much more) than necessary for a given directory.
5093 dd 'unblock' and 'sync' may now be combined (e.g., dd conv=unblock,sync)
5095 * Major changes in release 5.0.91 (2003-09-08):
5099 date accepts a new option --rfc-2822, an alias for --rfc-822.
5101 split accepts a new option -d or --numeric-suffixes.
5103 cp, install, mv, and touch now preserve microsecond resolution on
5104 file timestamps, on platforms that have the 'utimes' system call.
5105 Unfortunately there is no system call yet to preserve file
5106 timestamps to their full nanosecond resolution; microsecond
5107 resolution is the best we can do right now.
5109 sort now supports the zero byte (NUL) as a field separator; use -t '\0'.
5110 The -t '' option, which formerly had no effect, is now an error.
5112 sort option order no longer matters for the options -S, -d, -i, -o, and -t.
5113 Stronger options override weaker, and incompatible options are diagnosed.
5115 'sha1sum --check' now accepts the BSD format for SHA1 message digests
5116 in addition to the BSD format for MD5 ones.
5118 who -l now means 'who --login', not 'who --lookup', per POSIX.
5119 who's -l option has been eliciting an unconditional warning about
5120 this impending change since sh-utils-2.0.12 (April 2002).
5124 Mistakenly renaming a file onto itself, e.g., via 'mv B b' when 'B' is
5125 the same directory entry as 'b' no longer destroys the directory entry
5126 referenced by both 'b' and 'B'. Note that this would happen only on
5127 file systems like VFAT where two different names may refer to the same
5128 directory entry, usually due to lower->upper case mapping of file names.
5129 Now, the above can happen only on file systems that perform name mapping and
5130 that support hard links (stat.st_nlink > 1). This mitigates the problem
5131 in two ways: few file systems appear to be affected (hpfs and ntfs are),
5132 when the bug is triggered, mv no longer removes the last hard link to a file.
5133 *** ATTENTION ***: if you know how to distinguish the following two cases
5134 without writing to the file system in question, please let me know:
5135 1) B and b refer to the same directory entry on a file system like NTFS
5136 (B may well have a link count larger than 1)
5137 2) B and b are hard links to the same file
5139 stat no longer overruns a buffer for format strings ending in '%'
5141 fold -s -wN would infloop for N < 8 with TABs in the input.
5142 E.g., this would not terminate: printf 'a\t' | fold -w2 -s
5144 'split -a0', although of questionable utility, is accepted once again.
5146 'df DIR' used to hang under some conditions on OSF/1 5.1. Now it doesn't.
5148 seq's --width (-w) option now works properly even when the endpoint
5149 requiring the larger width is negative and smaller than the other endpoint.
5151 seq's default step is 1, even if LAST < FIRST.
5153 paste no longer mistakenly outputs 0xFF bytes for a nonempty input file
5154 without a trailing newline.
5156 'tail -n0 -f FILE' and 'tail -c0 -f FILE' no longer perform what amounted
5157 to a busy wait, rather than sleeping between iterations.
5159 tail's long-undocumented --allow-missing option now elicits a warning
5162 * Major changes in release 5.0.90 (2003-07-29):
5166 sort is now up to 30% more CPU-efficient in some cases
5168 'test' is now more compatible with Bash and POSIX:
5170 'test -t', 'test --help', and 'test --version' now silently exit
5171 with status 0. To test whether standard output is a terminal, use
5172 'test -t 1'. To get help and version info for 'test', use
5173 '[ --help' and '[ --version'.
5175 'test' now exits with status 2 (not 1) if there is an error.
5177 wc count field widths now are heuristically adjusted depending on the input
5178 size, if known. If only one count is printed, it is guaranteed to
5179 be printed without leading spaces.
5181 Previously, wc did not align the count fields if POSIXLY_CORRECT was set,
5182 but POSIX did not actually require this undesirable behavior, so it
5187 kill no longer tries to operate on argv[0] (introduced in 5.0.1)
5188 Why wasn't this noticed? Although many tests use kill, none of
5189 them made an effort to avoid using the shell's built-in kill.
5191 '[' invoked with no arguments no longer evokes a segfault
5193 rm without --recursive (aka -r or -R) no longer prompts regarding
5194 unwritable directories, as required by POSIX.
5196 uniq -c now uses a SPACE, not a TAB between the count and the
5197 corresponding line, as required by POSIX.
5199 expr now exits with status 2 if the expression is syntactically valid,
5200 and with status 3 if an error occurred. POSIX requires this.
5202 expr now reports trouble if string comparison fails due to a collation error.
5204 split now generates suffixes properly on EBCDIC hosts.
5206 split -a0 now works, as POSIX requires.
5208 'sort --version' and 'sort --help' fail, as they should
5209 when their output is redirected to /dev/full.
5211 'su --version > /dev/full' now fails, as it should.
5213 ** Fewer arbitrary limitations
5215 cut requires 97% less memory when very large field numbers or
5216 byte offsets are specified.
5219 * Major changes in release 5.0.1 (2003-07-15):
5222 - new program: '[' (much like 'test')
5225 - head now accepts --lines=-N (--bytes=-N) to print all but the
5226 N lines (bytes) at the end of the file
5227 - md5sum --check now accepts the output of the BSD md5sum program, e.g.,
5228 MD5 (f) = d41d8cd98f00b204e9800998ecf8427e
5229 - date -d DATE can now parse a DATE string like May-23-2003
5230 - chown: '.' is no longer recognized as a separator in the OWNER:GROUP
5231 specifier on POSIX 1003.1-2001 systems. If chown *was not* compiled
5232 on such a system, then it still accepts '.', by default. If chown
5233 was compiled on a POSIX 1003.1-2001 system, then you may enable the
5234 old behavior by setting _POSIX2_VERSION=199209 in your environment.
5235 - chown no longer tries to preserve set-user-ID and set-group-ID bits;
5236 on some systems, the chown syscall resets those bits, and previous
5237 versions of the chown command would call chmod to restore the original,
5238 pre-chown(2) settings, but that behavior is problematic.
5239 1) There was a window whereby a malicious user, M, could subvert a
5240 chown command run by some other user and operating on files in a
5241 directory where M has write access.
5242 2) Before (and even now, on systems with chown(2) that doesn't reset
5243 those bits), an unwary admin. could use chown unwittingly to create e.g.,
5244 a set-user-ID root copy of /bin/sh.
5247 - chown --dereference no longer leaks a file descriptor per symlink processed
5248 - 'du /' once again prints the '/' on the last line
5249 - split's --verbose option works once again [broken in 4.5.10 and 5.0]
5250 - tail -f is no longer subject to a race condition that could make it
5251 delay displaying the last part of a file that had stopped growing. That
5252 bug could also make tail -f give an unwarranted 'file truncated' warning.
5253 - du no longer runs out of file descriptors unnecessarily
5254 - df and 'readlink --canonicalize' no longer corrupt the heap on
5255 non-glibc, non-solaris systems
5256 - 'env -u UNSET_VARIABLE' no longer dumps core on non-glibc systems
5257 - readlink's --canonicalize option now works on systems like Solaris that
5258 lack the canonicalize_file_name function but do have resolvepath.
5259 - mv now removes 'a' in this example on all systems: touch a; ln a b; mv a b
5260 This behavior is contrary to POSIX (which requires that the mv command do
5261 nothing and exit successfully), but I suspect POSIX will change.
5262 - date's %r format directive now honors locale settings
5263 - date's '-' (no-pad) format flag now affects the space-padded-by-default
5264 conversion specifiers, %e, %k, %l
5265 - fmt now diagnoses invalid obsolescent width specifications like '-72x'
5266 - fmt now exits nonzero when unable to open an input file
5267 - tsort now fails when given an odd number of input tokens,
5268 as required by POSIX. Before, it would act as if the final token
5269 appeared one additional time.
5271 ** Fewer arbitrary limitations
5272 - tail's byte and line counts are no longer limited to OFF_T_MAX.
5273 Now the limit is UINTMAX_MAX (usually 2^64).
5274 - split can now handle --bytes=N and --lines=N with N=2^31 or more.
5277 - 'kill -t' now prints signal descriptions (rather than '?') on systems
5278 like Tru64 with __sys_siglist but no strsignal function.
5279 - stat.c now compiles on Ultrix systems
5280 - sleep now works on AIX systems that lack support for clock_gettime
5281 - rm now works around Darwin6.5's broken readdir function
5282 Before 'rm -rf DIR' would fail to remove all files in DIR
5283 if there were more than 338.
5285 * Major changes in release 5.0 (2003-04-02):
5286 - false --help now exits nonzero
5289 * printf no longer treats \x specially when POSIXLY_CORRECT is set
5290 * printf avoids buffer overrun with format ending in a backslash and
5291 * printf avoids buffer overrun with incomplete conversion specifier
5292 * printf accepts multiple flags in a single conversion specifier
5295 * seq no longer requires that a field width be specified
5296 * seq no longer fails when given a field width of '0'
5297 * seq now accepts " " and "'" as valid format flag characters
5298 * df now shows a HOSTNAME: prefix for each remote-mounted file system on AIX 5.1
5299 * portability tweaks for HP-UX, AIX 5.1, DJGPP
5302 * printf no longer segfaults for a negative field width or precision
5303 * shred now always enables --exact for non-regular files
5304 * du no longer lists hard-linked files more than once
5305 * du no longer dumps core on some systems due to "infinite" recursion
5306 via nftw's use of the buggy replacement function in getcwd.c
5307 * portability patches for a few vendor compilers and 64-bit systems
5308 * du -S *really* now works like it did before the change in 4.5.5
5311 * du no longer truncates file sizes or sums to fit in 32-bit size_t
5312 * work around Linux kernel bug in getcwd (fixed in 2.4.21-pre4), so that pwd
5313 now fails if the name of the working directory is so long that getcwd
5314 truncates it. Before it would print the truncated name and exit successfully.
5315 * 'df /some/mount-point' no longer hangs on a GNU libc system when another
5316 hard-mounted NFS file system (preceding /some/mount-point in /proc/mounts)
5318 * rm -rf now gives an accurate diagnostic when failing to remove a file
5319 under certain unusual conditions
5320 * mv and 'cp --preserve=links' now preserve multiple hard links even under
5321 certain unusual conditions where they used to fail
5324 * du -S once again works like it did before the change in 4.5.5
5325 * stat accepts a new file format, %B, for the size of each block reported by %b
5326 * du accepts new option: --apparent-size
5327 * du --bytes (-b) works the same way it did in fileutils-3.16 and before
5328 * du reports proper sizes for directories (not zero) (broken in 4.5.6 or 4.5.7)
5329 * df now always displays under 'Filesystem', the device file name
5330 corresponding to the listed mount point. Before, for a block- or character-
5331 special file command line argument, df would display that argument. E.g.,
5332 'df /dev/hda' would list '/dev/hda' as the 'Filesystem', rather than say
5333 /dev/hda3 (the device on which '/' is mounted), as it does now.
5334 * test now works properly when invoked from a set user ID or set group ID
5335 context and when testing access to files subject to alternate protection
5336 mechanisms. For example, without this change, a set-UID program that invoked
5337 'test -w F' (to see if F is writable) could mistakenly report that it *was*
5338 writable, even though F was on a read-only file system, or F had an ACL
5339 prohibiting write access, or F was marked as immutable.
5342 * du would fail with more than one DIR argument when any but the last did not
5343 contain a slash (due to a bug in ftw.c)
5346 * du no longer segfaults on Solaris systems (fixed heap-corrupting bug in ftw.c)
5347 * du --exclude=FILE works once again (this was broken by the rewrite for 4.5.5)
5348 * du no longer gets a failed assertion for certain hierarchy lay-outs
5349 involving hard-linked directories
5350 * 'who -r' no longer segfaults when using non-C-locale messages
5351 * df now displays a mount point (usually '/') for non-mounted
5352 character-special and block files
5355 * ls --dired produces correct byte offset for file names containing
5356 nonprintable characters in a multibyte locale
5357 * du has been rewritten to use a variant of GNU libc's ftw.c
5358 * du now counts the space associated with a directory's directory entry,
5359 even if it cannot list or chdir into that subdirectory.
5360 * du -S now includes the st_size of each entry corresponding to a subdirectory
5361 * rm on FreeBSD can once again remove directories from NFS-mounted file systems
5362 * ls has a new option --dereference-command-line-symlink-to-dir, which
5363 corresponds to the new default behavior when none of -d, -l -F, -H, -L
5365 * ls dangling-symlink now prints 'dangling-symlink'.
5366 Before, it would fail with 'no such file or directory'.
5367 * ls -s symlink-to-non-dir and ls -i symlink-to-non-dir now print
5368 attributes of 'symlink', rather than attributes of their referents.
5369 * Fix a bug introduced in 4.5.4 that made it so that ls --color would no
5370 longer highlight the names of files with the execute bit set when not
5371 specified on the command line.
5372 * shred's --zero (-z) option no longer gobbles up any following argument.
5373 Before, 'shred --zero file' would produce 'shred: missing file argument',
5374 and worse, 'shred --zero f1 f2 ...' would appear to work, but would leave
5375 the first file untouched.
5376 * readlink: new program
5377 * cut: new feature: when used to select ranges of byte offsets (as opposed
5378 to ranges of fields) and when --output-delimiter=STRING is specified,
5379 output STRING between ranges of selected bytes.
5380 * rm -r can no longer be tricked into mistakenly reporting a cycle.
5381 * when rm detects a directory cycle, it no longer aborts the entire command,
5382 but rather merely stops processing the affected command line argument.
5385 * cp no longer fails to parse options like this: --preserve=mode,ownership
5386 * 'ls --color -F symlink-to-dir' works properly
5387 * ls is much more efficient on directories with valid dirent.d_type.
5388 * stty supports all baud rates defined in linux-2.4.19.
5389 * 'du symlink-to-dir/' would improperly remove the trailing slash
5390 * 'du ""' would evoke a bounds violation.
5391 * In the unlikely event that running 'du /' resulted in 'stat ("/", ...)'
5392 failing, du would give a diagnostic about '' (empty string) rather than '/'.
5393 * printf: a hexadecimal escape sequence has at most two hex. digits, not three.
5394 * The following features have been added to the --block-size option
5395 and similar environment variables of df, du, and ls.
5396 - A leading "'" generates numbers with thousands separators.
5398 $ ls -l --block-size="'1" file
5399 -rw-rw-r-- 1 eggert src 47,483,707 Sep 24 23:40 file
5400 - A size suffix without a leading integer generates a suffix in the output.
5402 $ ls -l --block-size="K"
5403 -rw-rw-r-- 1 eggert src 46371K Sep 24 23:40 file
5404 * ls's --block-size option now affects file sizes in all cases, not
5405 just for --block-size=human-readable and --block-size=si. Fractional
5406 sizes are now always rounded up, for consistency with df and du.
5407 * df now displays the block size using powers of 1000 if the requested
5408 block size seems to be a multiple of a power of 1000.
5409 * nl no longer gets a segfault when run like this 'yes|nl -s%n'
5412 * du --dereference-args (-D) no longer fails in certain cases
5413 * 'ln --target-dir=DIR' no longer fails when given a single argument
5416 * 'rm -i dir' (without --recursive (-r)) no longer recurses into dir
5417 * 'tail -c N FILE' now works with files of size >= 4GB
5418 * 'mkdir -p' can now create very deep (e.g. 40,000-component) directories
5419 * rmdir -p dir-with-trailing-slash/ no longer fails
5420 * printf now honors the '--' command line delimiter
5421 * od's 8-byte formats x8, o8, and u8 now work
5422 * tail now accepts fractional seconds for its --sleep-interval=S (-s) option
5425 * du and ls now report sizes of symbolic links (before they'd always report 0)
5426 * uniq now obeys the LC_COLLATE locale, as per POSIX 1003.1-2001 TC1.
5428 ========================================================================
5429 Here are the NEWS entries made from fileutils-4.1 until the
5430 point at which the packages merged to form the coreutils:
5433 * 'rm symlink-to-unwritable' doesn't prompt [introduced in 4.1.10]
5435 * rm once again gives a reasonable diagnostic when failing to remove a file
5436 owned by someone else in a sticky directory [introduced in 4.1.9]
5437 * df now rounds all quantities up, as per POSIX.
5438 * New ls time style: long-iso, which generates YYYY-MM-DD HH:MM.
5439 * Any time style can be preceded by "posix-"; this causes "ls" to
5440 use traditional timestamp format when in the POSIX locale.
5441 * The default time style is now posix-long-iso instead of posix-iso.
5442 Set TIME_STYLE="posix-iso" to revert to the behavior of 4.1.1 through 4.1.9.
5443 * 'rm dangling-symlink' doesn't prompt [introduced in 4.1.9]
5444 * stat: remove support for --secure/-s option and related %S and %C format specs
5445 * stat: rename --link/-l to --dereference/-L.
5446 The old options will continue to work for a while.
5448 * rm can now remove very deep hierarchies, in spite of any limit on stack size
5449 * new programs: link, unlink, and stat
5450 * New ls option: --author (for the Hurd).
5451 * 'touch -c no-such-file' no longer fails, per POSIX
5453 * mv no longer mistakenly creates links to preexisting destination files
5456 * rm: close a hole that would allow a running rm process to be subverted
5458 * New cp option: --copy-contents.
5459 * cp -r is now equivalent to cp -R. Use cp -R -L --copy-contents to get the
5460 traditional (and rarely desirable) cp -r behavior.
5461 * ls now accepts --time-style=+FORMAT, where +FORMAT works like date's format
5462 * The obsolete usage 'touch [-acm] MMDDhhmm[YY] FILE...' is no longer
5463 supported on systems conforming to POSIX 1003.1-2001. Use touch -t instead.
5464 * cp and inter-partition mv no longer give a misleading diagnostic in some
5467 * cp -r no longer preserves symlinks
5468 * The block size notation is now compatible with SI and with IEC 60027-2.
5469 For example, --block-size=1MB now means --block-size=1000000,
5470 whereas --block-size=1MiB now means --block-size=1048576.
5471 A missing 'B' (e.g. '1M') has the same meaning as before.
5472 A trailing 'B' now means decimal, not binary; this is a silent change.
5473 The nonstandard 'D' suffix (e.g. '1MD') is now obsolescent.
5474 * -H or --si now outputs the trailing 'B', for consistency with the above.
5475 * Programs now output trailing 'K' (not 'k') to mean 1024, as per IEC 60027-2.
5476 * New df, du short option -B is short for --block-size.
5477 * You can omit an integer '1' before a block size suffix,
5478 e.g. 'df -BG' is equivalent to 'df -B 1G' and to 'df --block-size=1G'.
5479 * The following options are now obsolescent, as their names are
5480 incompatible with IEC 60027-2:
5481 df, du: -m or --megabytes (use -BM or --block-size=1M)
5482 df, du, ls: --kilobytes (use --block-size=1K)
5484 * df --local no longer lists smbfs file systems whose name starts with //
5485 * dd now detects the Linux/tape/lseek bug at run time and warns about it.
5487 * ls -R once again outputs a blank line between per-directory groups of files.
5488 This was broken by the cycle-detection change in 4.1.1.
5489 * dd once again uses 'lseek' on character devices like /dev/mem and /dev/kmem.
5490 On systems with the linux kernel (at least up to 2.4.16), dd must still
5491 resort to emulating 'skip=N' behavior using reads on tape devices, because
5492 lseek has no effect, yet appears to succeed. This may be a kernel bug.
5494 * cp no longer fails when two or more source files are the same;
5495 now it just gives a warning and doesn't copy the file the second time.
5496 E.g., cp a a d/ produces this:
5497 cp: warning: source file `a' specified more than once
5498 * chmod would set the wrong bit when given symbolic mode strings like
5499 these: g=o, o=g, o=u. E.g., 'chmod a=,o=w,ug=o f' would give a mode
5500 of --w-r---w- rather than --w--w--w-.
5502 * mv (likewise for cp), now fails rather than silently clobbering one of
5503 the source files in the following example:
5504 rm -rf a b c; mkdir a b c; touch a/f b/f; mv a/f b/f c
5505 * ls -R detects directory cycles, per POSIX. It warns and doesn't infloop.
5506 * cp's -P option now means the same as --no-dereference, per POSIX.
5507 Use --parents to get the old meaning.
5508 * When copying with the -H and -L options, cp can preserve logical
5509 links between source files with --preserve=links
5510 * cp accepts new options:
5511 --preserve[={mode,ownership,timestamps,links,all}]
5512 --no-preserve={mode,ownership,timestamps,links,all}
5513 * cp's -p and --preserve options remain unchanged and are equivalent
5514 to '--preserve=mode,ownership,timestamps'
5515 * mv and cp accept a new option: --reply={yes,no,query}; provides a consistent
5516 mechanism to control whether one is prompted about certain existing
5517 destination files. Note that cp's and mv's -f options don't have the
5518 same meaning: cp's -f option no longer merely turns off '-i'.
5519 * remove portability limitations (e.g., PATH_MAX on the Hurd, fixes for
5521 * mv now prompts before overwriting an existing, unwritable destination file
5522 when stdin is a tty, unless --force (-f) is specified, as per POSIX.
5523 * mv: fix the bug whereby 'mv -uf source dest' would delete source,
5524 even though it's older than dest.
5525 * chown's --from=CURRENT_OWNER:CURRENT_GROUP option now works
5526 * cp now ensures that the set-user-ID and set-group-ID bits are cleared for
5527 the destination file when when copying and not preserving permissions.
5528 * 'ln -f --backup k k' gives a clearer diagnostic
5529 * ls no longer truncates user names or group names that are longer
5531 * ls's new --dereference-command-line option causes it to dereference
5532 symbolic links on the command-line only. It is the default unless
5533 one of the -d, -F, or -l options are given.
5534 * ls -H now means the same as ls --dereference-command-line, as per POSIX.
5535 * ls -g now acts like ls -l, except it does not display owner, as per POSIX.
5536 * ls -n now implies -l, as per POSIX.
5537 * ls can now display dates and times in one of four time styles:
5539 - The 'full-iso' time style gives full ISO-style timestamps like
5540 '2001-05-14 23:45:56.477817180 -0700'.
5541 - The 'iso' time style gives ISO-style timestamps like '2001-05-14 '
5543 - The 'locale' time style gives locale-dependent timestamps like
5544 'touko 14 2001' and 'touko 14 23:45' (in a Finnish locale).
5545 - The 'posix-iso' time style gives traditional POSIX-locale
5546 timestamps like 'May 14 2001' and 'May 14 23:45' unless the user
5547 specifies a non-POSIX locale, in which case it uses ISO-style dates.
5548 This is the default.
5550 You can specify a time style with an option like --time-style='iso'
5551 or with an environment variable like TIME_STYLE='iso'. GNU Emacs 21
5552 and later can parse ISO dates, but older Emacs versions cannot, so
5553 if you are using an older version of Emacs outside the default POSIX
5554 locale, you may need to set TIME_STYLE="locale".
5556 * --full-time is now an alias for "-l --time-style=full-iso".
5559 ========================================================================
5560 Here are the NEWS entries made from sh-utils-2.0 until the
5561 point at which the packages merged to form the coreutils:
5564 * date no longer accepts e.g., September 31 in the MMDDhhmm syntax
5565 * fix a bug in this package's .m4 files and in configure.ac
5567 * nohup's behavior is changed as follows, to conform to POSIX 1003.1-2001:
5568 - nohup no longer adjusts scheduling priority; use "nice" for that.
5569 - nohup now redirects stderr to stdout, if stderr is not a terminal.
5570 - nohup exit status is now 126 if command was found but not invoked,
5571 127 if nohup failed or if command was not found.
5573 * uname and uptime work better on *BSD systems
5574 * pathchk now exits nonzero for a path with a directory component
5575 that specifies a non-directory
5578 * who accepts new options: --all (-a), --boot (-b), --dead (-d), --login,
5579 --process (-p), --runlevel (-r), --short (-s), --time (-t), --users (-u).
5580 The -u option now produces POSIX-specified results and is the same as
5581 the long option '--users'. --idle is no longer the same as -u.
5582 * The following changes apply on systems conforming to POSIX 1003.1-2001:
5583 - 'date -I' is no longer supported. Instead, use 'date --iso-8601'.
5584 - 'nice -NUM' is no longer supported. Instead, use 'nice -n NUM'.
5585 [This change was reverted in coreutils 5.3.1.]
5586 * New 'uname' options -i or --hardware-platform, and -o or --operating-system.
5587 'uname -a' now outputs -i and -o information at the end.
5588 New uname option --kernel-version is an alias for -v.
5589 Uname option --release has been renamed to --kernel-release,
5590 and --sysname has been renamed to --kernel-name;
5591 the old options will work for a while, but are no longer documented.
5592 * 'expr' now uses the LC_COLLATE locale for string comparison, as per POSIX.
5593 * 'expr' now requires '+' rather than 'quote' to quote tokens;
5594 this removes an incompatibility with POSIX.
5595 * date -d 'last friday' would print a date/time that was one hour off
5596 (e.g., 23:00 on *thursday* rather than 00:00 of the preceding friday)
5597 when run such that the current time and the target date/time fall on
5598 opposite sides of a daylight savings time transition.
5599 This problem arose only with relative date strings like 'last monday'.
5600 It was not a problem with strings that include absolute dates.
5601 * factor is twice as fast, for large numbers
5603 * setting the date now works properly, even when using -u
5604 * 'date -f - < /dev/null' no longer dumps core
5605 * some DOS/Windows portability changes
5607 * 'date -d DATE' now parses certain relative DATEs correctly
5609 * fixed a bug introduced in 2.0h that made many programs fail with a
5610 'write error' when invoked with the --version option
5612 * all programs fail when printing --help or --version output to a full device
5613 * printf exits nonzero upon write failure
5614 * yes now detects and terminates upon write failure
5615 * date --rfc-822 now always emits day and month names from the 'C' locale
5616 * portability tweaks for Solaris8, Ultrix, and DOS
5618 * date now handles two-digit years with leading zeros correctly.
5619 * printf interprets unicode, \uNNNN \UNNNNNNNN, on systems with the
5620 required support; from Bruno Haible.
5621 * stty's rprnt attribute now works on HPUX 10.20
5622 * seq's --equal-width option works more portably
5624 * fix build problems with ut_name vs. ut_user
5626 * stty: fix long-standing bug that caused test failures on at least HPUX
5627 systems when COLUMNS was set to zero
5628 * still more portability fixes
5629 * unified lib/: now that directory and most of the configuration framework
5630 is common between fileutils, textutils, and sh-utils
5632 * fix portability problem with sleep vs lib/strtod.c's requirement for -lm
5634 * fix portability problems with nanosleep.c and with the new code in sleep.c
5636 * Regenerate lib/Makefile.in so that nanosleep.c is distributed.
5638 * sleep accepts floating point arguments on command line
5639 * sleep's clock continues counting down when sleep is suspended
5640 * when a suspended sleep process is resumed, it continues sleeping if
5641 there is any time remaining
5642 * who once again prints whatever host information it has, even without --lookup
5644 ========================================================================
5645 For older NEWS entries for the fileutils, textutils, and sh-utils
5646 packages, see ./old/*/NEWS.
5648 This package began as the union of the following:
5649 textutils-2.1, fileutils-4.1.11, sh-utils-2.0.15.
5651 ========================================================================
5653 Copyright (C) 2001-2023 Free Software Foundation, Inc.
5655 Permission is granted to copy, distribute and/or modify this document
5656 under the terms of the GNU Free Documentation License, Version 1.3 or
5657 any later version published by the Free Software Foundation; with no
5658 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
5659 Texts. A copy of the license is included in the "GNU Free
5660 Documentation License" file as part of this distribution.