diff options
author | Jim Meyering <meyering@redhat.com> | 2011-04-30 09:52:20 +0200 |
---|---|---|
committer | Jim Meyering <meyering@redhat.com> | 2011-05-06 22:54:51 +0200 |
commit | 09baf2287ee1b4e104f5cea1d1b3495ecd5c9d16 (patch) | |
tree | 69a1f4ce11a99e744229b6b6921e820776b4b0a3 /doc | |
parent | 2644e288e4f12958f34d88976422ff887d1ffed2 (diff) | |
download | coreutils-09baf2287ee1b4e104f5cea1d1b3495ecd5c9d16.tar.xz |
doc: document split's new --filter=CMD option
* doc/coreutils.texi (split invocation): Describe --filter=CMD.
* NEWS (New feature): Mention it.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/coreutils.texi | 23 |
1 files changed, 21 insertions, 2 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index d2377f41b..457ecabb2 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -2992,8 +2992,8 @@ The program accepts the following options. Also see @ref{Common options}. Put @var{lines} lines of @var{input} into each output file. For compatibility @command{split} also supports an obsolete -option syntax @option{-@var{lines}}. New scripts should use @option{-l -@var{lines}} instead. +option syntax @option{-@var{lines}}. New scripts should use +@option{-l @var{lines}} instead. @item -b @var{size} @itemx --bytes=@var{size} @@ -3011,6 +3011,25 @@ possible without exceeding @var{size} bytes. Individual lines longer than @var{size} bytes are broken into multiple files. @var{size} has the same format as for the @option{--bytes} option. +@itemx --filter=@var{command} +@opindex --filter +With this option, rather than simply writing to each output file, +write through a pipe to the specified shell @var{command} for each output file. +@var{command} should use the $FILE environment variable, which is set +to a different output file name for each invocation of the command. +For example, imagine that you have a 1TiB compressed file +that, if uncompressed, would be too large to reside on disk, +yet you must split it into individually-compressed pieces +of a more manageable size. +To do that, you might run this command: + +@example +xz -dc BIG.xz | split -b200G --filter='xz > $FILE.xz' - big- +@end example + +Assuming a 10:1 compression ratio, that would create about fifty 20GiB files +with names @file{big-xaa.xz}, @file{big-xab.xz}, @file{big-xac.xz}, etc. + @item -n @var{chunks} @itemx --number=@var{chunks} @opindex -n |