rsc | cfa37a7 | 2004-04-10 18:53:55 +0000 | [diff] [blame] | 1 | .TH SPLIT 1 |
| 2 | .CT 1 files |
| 3 | .SH NAME |
| 4 | split \- split a file into pieces |
| 5 | .SH SYNOPSIS |
| 6 | .B split |
| 7 | [ |
| 8 | .I option ... |
| 9 | ] |
| 10 | [ |
| 11 | .I file |
| 12 | ] |
| 13 | .SH DESCRIPTION |
| 14 | .I Split |
| 15 | reads |
| 16 | .I file |
| 17 | (standard input by default) |
| 18 | and writes it in pieces of 1000 |
| 19 | lines per output file. |
| 20 | The names of the |
| 21 | output files are |
| 22 | .BR xaa , |
| 23 | .BR xab , |
| 24 | and so on to |
| 25 | .BR xzz . |
| 26 | The options are |
| 27 | .TP |
| 28 | .BI -n " n" |
| 29 | Split into |
| 30 | .IR n -line |
| 31 | pieces. |
| 32 | .TP |
| 33 | .BI -l " n" |
| 34 | Synonym for |
| 35 | .B -n |
| 36 | .IR n , |
| 37 | a nod to Unix's syntax. |
| 38 | .TP |
| 39 | .BI -e " expression" |
| 40 | File divisions occur at each line |
| 41 | that matches a regular |
| 42 | .IR expression ; |
| 43 | see |
| 44 | .IR regexp (6). |
| 45 | Multiple |
| 46 | .B -e |
| 47 | options may appear. |
| 48 | If a subexpression of |
| 49 | .I expression |
| 50 | is contained in parentheses |
| 51 | .BR ( ... ) , |
| 52 | the output file name is the portion of the |
| 53 | line which matches the subexpression. |
| 54 | .TP |
| 55 | .BI -f " stem |
| 56 | Use |
| 57 | .I stem |
| 58 | instead of |
| 59 | .B x |
| 60 | in output file names. |
| 61 | .TP |
| 62 | .BI -s " suffix |
| 63 | Append |
| 64 | .I suffix |
| 65 | to names identified under |
| 66 | .BR -e . |
| 67 | .TP |
| 68 | .B -x |
| 69 | Exclude the matched input line from the output file. |
| 70 | .TP |
| 71 | .B -i |
| 72 | Ignore case in option |
| 73 | .BR -e ; |
| 74 | force output file names (excluding the suffix) |
| 75 | to lower case. |
| 76 | .SH SOURCE |
rsc | b5fdffe | 2004-04-19 19:22:56 +0000 | [diff] [blame] | 77 | .B /usr/local/plan9/src/cmd/split.c |
rsc | cfa37a7 | 2004-04-10 18:53:55 +0000 | [diff] [blame] | 78 | .SH SEE ALSO |
| 79 | .IR sed (1), |
| 80 | .IR awk (1), |
| 81 | .IR grep (1), |
| 82 | .IR regexp (6) |