summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPaul Eggert <eggert@cs.ucla.edu>2023-03-07 12:58:12 -0800
committerPaul Eggert <eggert@cs.ucla.edu>2023-03-07 13:41:46 -0800
commitbb9dbcbbfd5c3159f975f39336a33319c6c5df04 (patch)
treef707acbfea996e21bfc6c653951db604e969b041 /doc
parent35ac97e0d601d5a20bf986bad052f0f94a504561 (diff)
downloadcoreutils-bb9dbcbbfd5c3159f975f39336a33319c6c5df04.tar.gz
split: support split -n on larger pipe input
* bootstrap.conf (gnulib_modules): Add free-posix, tmpfile. * src/split.c (copy_to_tmpfile): New function. (input_file_size): Use it to split larger files when sizes cannot easily be determined via fstat or lseek. See Bug#61386#235. * tests/split/l-chunk.sh: Mark tests of /dev/zero as very expensive since they exhaust /tmp.
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi6
1 files changed, 4 insertions, 2 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index f0e46b9ee..7852e9f8a 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -3409,8 +3409,10 @@ are not split even if they overlap a partition, the files written
can be larger or smaller than the partition size, and even empty
if a line/record is so long as to completely overlap the partition.
-For @samp{r} mode, the size of @var{input} is irrelevant,
-and so can be a pipe for example.
+When the input is a pipe or some other special file where the size
+cannot easily be determined, there is no trouble for @samp{r} mode
+because the size of the input is irrelevant. For other modes, such an
+input is first copied to a temporary to determine its size.
@item -a @var{length}
@itemx --suffix-length=@var{length}