diff options
Diffstat (limited to 'coreutils-5.3.0-bin/man/cat1p/csplit.1p.txt')
| -rw-r--r-- | coreutils-5.3.0-bin/man/cat1p/csplit.1p.txt | 260 |
1 files changed, 260 insertions, 0 deletions
diff --git a/coreutils-5.3.0-bin/man/cat1p/csplit.1p.txt b/coreutils-5.3.0-bin/man/cat1p/csplit.1p.txt new file mode 100644 index 0000000..2381d29 --- /dev/null +++ b/coreutils-5.3.0-bin/man/cat1p/csplit.1p.txt @@ -0,0 +1,260 @@ +csplit(P) csplit(P) + + + + + +NAME + csplit - split files based on context + +SYNOPSIS + csplit [-ks][-f prefix][-n number] file arg1 ...argn + +DESCRIPTION + The csplit utility shall read the file named by the file + operand, write all or part of that file into other files + as directed by the arg operands, and write the sizes of + the files. + +OPTIONS + The csplit utility shall conform to the Base Definitions + volume of IEEE Std 1003.1-2001, Section 12.2, Utility + Syntax Guidelines. + + The following options shall be supported: + + -f prefix + Name the created files prefix 00, prefix 01, ..., + prefixn. The default is xx00 ... xx n. If the + prefix argument would create a filename exceeding + {NAME_MAX} bytes, an error shall result, csplit + shall exit with a diagnostic message, and no + files shall be created. + + -k Leave previously created files intact. By + default, csplit shall remove created files if an + error occurs. + + -n number + Use number decimal digits to form filenames for + the file pieces. The default shall be 2. + + -s Suppress the output of file size messages. + + +OPERANDS + The following operands shall be supported: + + file The pathname of a text file to be split. If file + is '-' , the standard input shall be used. + + + The operands arg1 ... argn can be a combination of the + following: + + /rexp/[offset] + + A file shall be created using the content of the + lines from the current line up to, but not + including, the line that results from the evalua- + tion of the regular expression with offset, if + any, applied. The regular expression rexp shall + follow the rules for basic regular expressions + described in the Base Definitions volume of + IEEE Std 1003.1-2001, Section 9.3, Basic Regular + Expressions. The application shall use the + sequence "\/" to specify a slash character within + the rexp. The optional offset shall be a positive + or negative integer value representing a number + of lines. A positive integer value can be pre- + ceded by '+' . If the selection of lines from an + offset expression of this type would create a + file with zero lines, or one with greater than + the number of lines left in the input file, the + results are unspecified. After the section is + created, the current line shall be set to the + line that results from the evaluation of the reg- + ular expression with any offset applied. If the + current line is the first line in the file and a + regular expression operation has not yet been + performed, the pattern match of rexp shall be + applied from the current line to the end of the + file. Otherwise, the pattern match of rexp shall + be applied from the line following the current + line to the end of the file. + + %rexp%[offset] + + Equivalent to /rexp/[offset], except that no file + shall be created for the selected section of the + input file. The application shall use the + sequence "\%" to specify a percent-sign character + within the rexp. + + line_no + Create a file from the current line up to (but + not including) the line number line_no. Lines in + the file shall be numbered starting at one. The + current line becomes line_no. + + {num} Repeat operand. This operand can follow any of + the operands described previously. If it follows + a rexp type operand, that operand shall be + applied num more times. If it follows a line_no + operand, the file shall be split every line_no + lines, num times, from that point. + + + An error shall be reported if an operand does not refer- + ence a line between the current position and the end of + the file. + +STDIN + See the INPUT FILES section. + +INPUT FILES + The input file shall be a text file. + +ENVIRONMENT VARIABLES + The following environment variables shall affect the + execution of csplit: + + LANG Provide a default value for the internationaliza- + tion variables that are unset or null. (See the + Base Definitions volume of IEEE Std 1003.1-2001, + Section 8.2, Internationalization Variables for + the precedence of internationalization variables + used to determine the values of locale cate- + gories.) + + LC_ALL If set to a non-empty string value, override the + values of all the other internationalization + variables. + + LC_COLLATE + + Determine the locale for the behavior of ranges, + equivalence classes, and multi-character collat- + ing elements within regular expressions. + + LC_CTYPE + Determine the locale for the interpretation of + sequences of bytes of text data as characters + (for example, single-byte as opposed to multi- + byte characters in arguments and input files) and + the behavior of character classes within regular + expressions. + + LC_MESSAGES + Determine the locale that should be used to + affect the format and contents of diagnostic mes- + sages written to standard error. + + NLSPATH + Determine the location of message catalogs for + the processing of LC_MESSAGES . + + +ASYNCHRONOUS EVENTS + If the -k option is specified, created files shall be + retained. Otherwise, the default action occurs. + +STDOUT + Unless the -s option is used, the standard output shall + consist of one line per file created, with a format as + follows: + + + "%d\n", <file size in bytes> + +STDERR + The standard error shall be used only for diagnostic + messages. + +OUTPUT FILES + The output files shall contain portions of the original + input file; otherwise, unchanged. + +EXTENDED DESCRIPTION + None. + +EXIT STATUS + The following exit values shall be returned: + + 0 Successful completion. + + >0 An error occurred. + + +CONSEQUENCES OF ERRORS + By default, created files shall be removed if an error + occurs. When the -k option is specified, created files + shall not be removed if an error occurs. + + The following sections are informative. + +APPLICATION USAGE + None. + +EXAMPLES + This example creates four files, cobol00 ... cobol03: + + + csplit -f cobol file '/procedure division/' /par5./ /par16./ + + After editing the split files, they can be recombined as + follows: + + + cat cobol0[0-3] > file + + Note that this example overwrites the original file. + + This example would split the file after the first 99 + lines, and every 100 lines thereafter, up to 9999 lines; + this is because lines in the file are numbered from 1 + rather than zero, for historical reasons: + + + csplit -k file 100 {99} + + Assuming that prog.c follows the C-language coding con- + vention of ending routines with a '}' at the beginning + of the line, this example creates a file containing each + separate C routine (up to 21) in prog.c: + + + csplit -k prog.c '%main(%' '/^}/+1' {20} + +RATIONALE + The -n option was added to extend the range of filenames + that could be handled. + + Consideration was given to adding a -a flag to use the + alphabetic filename generation used by the historical + split utility, but the functionality added by the -n + option was deemed to make alphabetic naming unnecessary. + +FUTURE DIRECTIONS + None. + +SEE ALSO + sed , split + +COPYRIGHT + Portions of this text are reprinted and reproduced in + electronic form from IEEE Std 1003.1, 2003 Edition, + Standard for Information Technology -- Portable Operat- + ing System Interface (POSIX), The Open Group Base Speci- + fications Issue 6, Copyright (C) 2001-2003 by the Insti- + tute of Electrical and Electronics Engineers, Inc and + The Open Group. In the event of any discrepancy between + this version and the original IEEE and The Open Group + Standard, the original IEEE and The Open Group Standard + is the referee document. The original Standard can be + obtained online at http://www.open- + group.org/unix/online.html . + + + +POSIX 2003 csplit(P) |