diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/split.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/split.1 | 108 |
1 files changed, 108 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/split.1 b/upstream/debian-bookworm/man1/split.1 new file mode 100644 index 00000000..87f676ed --- /dev/null +++ b/upstream/debian-bookworm/man1/split.1 @@ -0,0 +1,108 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SPLIT "1" "September 2022" "GNU coreutils 9.1" "User Commands" +.SH NAME +split \- split a file into pieces +.SH SYNOPSIS +.B split +[\fI\,OPTION\/\fR]... [\fI\,FILE \/\fR[\fI\,PREFIX\/\fR]] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Output pieces of FILE to PREFIXaa, PREFIXab, ...; +default size is 1000 lines, and default PREFIX is 'x'. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-suffix\-length\fR=\fI\,N\/\fR +generate suffixes of length N (default 2) +.TP +\fB\-\-additional\-suffix\fR=\fI\,SUFFIX\/\fR +append an additional SUFFIX to file names +.TP +\fB\-b\fR, \fB\-\-bytes\fR=\fI\,SIZE\/\fR +put SIZE bytes per output file +.TP +\fB\-C\fR, \fB\-\-line\-bytes\fR=\fI\,SIZE\/\fR +put at most SIZE bytes of records per output file +.TP +\fB\-d\fR +use numeric suffixes starting at 0, not alphabetic +.TP +\fB\-\-numeric\-suffixes\fR[=\fI\,FROM\/\fR] +same as \fB\-d\fR, but allow setting the start value +.TP +\fB\-x\fR +use hex suffixes starting at 0, not alphabetic +.TP +\fB\-\-hex\-suffixes\fR[=\fI\,FROM\/\fR] +same as \fB\-x\fR, but allow setting the start value +.TP +\fB\-e\fR, \fB\-\-elide\-empty\-files\fR +do not generate empty output files with '\-n' +.TP +\fB\-\-filter\fR=\fI\,COMMAND\/\fR +write to shell COMMAND; file name is $FILE +.TP +\fB\-l\fR, \fB\-\-lines\fR=\fI\,NUMBER\/\fR +put NUMBER lines/records per output file +.TP +\fB\-n\fR, \fB\-\-number\fR=\fI\,CHUNKS\/\fR +generate CHUNKS output files; see explanation below +.TP +\fB\-t\fR, \fB\-\-separator\fR=\fI\,SEP\/\fR +use SEP instead of newline as the record separator; +\&'\e0' (zero) specifies the NUL character +.TP +\fB\-u\fR, \fB\-\-unbuffered\fR +immediately copy input to output with '\-n r/...' +.TP +\fB\-\-verbose\fR +print a diagnostic just before each +output file is opened +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SS "CHUNKS may be:" +.TP +N +split into N files based on size of input +.TP +K/N +output Kth of N to stdout +.TP +l/N +split into N files without splitting lines/records +.TP +l/K/N +output Kth of N to stdout without splitting lines/records +.TP +r/N +like 'l' but use round robin distribution +.TP +r/K/N +likewise but only output Kth of N to stdout +.SH AUTHOR +Written by Torbjorn Granlund and Richard M. Stallman. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2022 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/split> +.br +or available locally via: info \(aq(coreutils) split invocation\(aq |