1.\" Copyright (c) 1990, 1991, 1993, 1994 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by the University of 15.\" California, Berkeley and its contributors. 16.\" 4. Neither the name of the University nor the names of its contributors 17.\" may be used to endorse or promote products derived from this software 18.\" without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)split.1 8.3 (Berkeley) 4/16/94
| 1.\" Copyright (c) 1990, 1991, 1993, 1994 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by the University of 15.\" California, Berkeley and its contributors. 16.\" 4. Neither the name of the University nor the names of its contributors 17.\" may be used to endorse or promote products derived from this software 18.\" without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)split.1 8.3 (Berkeley) 4/16/94
|
33.\" $FreeBSD: head/usr.bin/split/split.1 161172 2006-08-10 10:41:47Z keramida $
| 33.\" $FreeBSD: head/usr.bin/split/split.1 162792 2006-09-29 15:20:48Z ru $
|
34.\" 35.Dd August 10, 2006 36.Dt SPLIT 1 37.Os 38.Sh NAME 39.Nm split 40.Nd split a file into pieces 41.Sh SYNOPSIS 42.Nm 43.Op Fl l Ar line_count 44.Op Fl a Ar suffix_length 45.Op Ar file Op Ar prefix 46.Nm 47.Fl b Ar byte_count Ns 48.Oo
| 34.\" 35.Dd August 10, 2006 36.Dt SPLIT 1 37.Os 38.Sh NAME 39.Nm split 40.Nd split a file into pieces 41.Sh SYNOPSIS 42.Nm 43.Op Fl l Ar line_count 44.Op Fl a Ar suffix_length 45.Op Ar file Op Ar prefix 46.Nm 47.Fl b Ar byte_count Ns 48.Oo
|
49.Cm K Ns | Ns Cm k Ns | Ns Cm M Ns | Ns Cm m Ns | Ns Cm G Ns | Ns Cm g
| 49.Sm off 50.Cm K | k | M | m | G | g 51.Sm on
|
50.Oc 51.Op Fl a Ar suffix_length 52.Op Ar file Op Ar prefix 53.Nm 54.Fl p Ar pattern 55.Op Fl a Ar suffix_length 56.Op Ar file Op Ar prefix 57.Sh DESCRIPTION 58The 59.Nm 60utility reads the given 61.Ar file 62and breaks it up into files of 1000 lines each 63(if no options are specified), leaving the 64.Ar file 65unchanged. 66If 67.Ar file 68is a single dash 69.Pq Sq Fl 70or absent, 71.Nm 72reads from the standard input. 73.Pp 74The options are as follows: 75.Bl -tag -width indent 76.It Fl a Ar suffix_length 77Use 78.Ar suffix_length 79letters to form the suffix of the file name.
| 52.Oc 53.Op Fl a Ar suffix_length 54.Op Ar file Op Ar prefix 55.Nm 56.Fl p Ar pattern 57.Op Fl a Ar suffix_length 58.Op Ar file Op Ar prefix 59.Sh DESCRIPTION 60The 61.Nm 62utility reads the given 63.Ar file 64and breaks it up into files of 1000 lines each 65(if no options are specified), leaving the 66.Ar file 67unchanged. 68If 69.Ar file 70is a single dash 71.Pq Sq Fl 72or absent, 73.Nm 74reads from the standard input. 75.Pp 76The options are as follows: 77.Bl -tag -width indent 78.It Fl a Ar suffix_length 79Use 80.Ar suffix_length 81letters to form the suffix of the file name.
|
80.It Fl b Ar byte_count Ns Op Cm K Ns | Ns Cm k Ns | Ns Cm M Ns | Ns Cm m Ns | Ns Cm G Ns | Ns Cm g
| 82.It Fl b Ar byte_count Ns Oo 83.Sm off 84.Cm K | k | M | m | G | g 85.Sm on 86.Oc
|
81Create smaller files 82.Ar byte_count 83bytes in length. 84If 85.Cm k 86or 87.Cm K 88is appended to the number, the file is split into 89.Ar byte_count 90kilobyte pieces. 91If 92.Cm m 93or 94.Cm M 95is appended to the number, the file is split into 96.Ar byte_count 97megabyte pieces. 98If 99.Cm g 100or 101.Cm G 102is appended to the number, the file is split into 103.Ar byte_count 104gigabyte pieces. 105.It Fl l Ar line_count 106Create smaller files 107.Ar line_count 108lines in length. 109.It Fl p Ar pattern 110The file is split whenever an input line matches 111.Ar pattern , 112which is interpreted as an extended regular expression. 113The matching line will be the first line of the next output file. 114This option is incompatible with the 115.Fl b 116and 117.Fl l 118options. 119.El 120.Pp 121If additional arguments are specified, the first is used as the name 122of the input file which is to be split. 123If a second additional argument is specified, it is used as a prefix 124for the names of the files into which the file is split. 125In this case, each file into which the file is split is named by the 126prefix followed by a lexically ordered suffix using 127.Ar suffix_length 128characters in the range
| 87Create smaller files 88.Ar byte_count 89bytes in length. 90If 91.Cm k 92or 93.Cm K 94is appended to the number, the file is split into 95.Ar byte_count 96kilobyte pieces. 97If 98.Cm m 99or 100.Cm M 101is appended to the number, the file is split into 102.Ar byte_count 103megabyte pieces. 104If 105.Cm g 106or 107.Cm G 108is appended to the number, the file is split into 109.Ar byte_count 110gigabyte pieces. 111.It Fl l Ar line_count 112Create smaller files 113.Ar line_count 114lines in length. 115.It Fl p Ar pattern 116The file is split whenever an input line matches 117.Ar pattern , 118which is interpreted as an extended regular expression. 119The matching line will be the first line of the next output file. 120This option is incompatible with the 121.Fl b 122and 123.Fl l 124options. 125.El 126.Pp 127If additional arguments are specified, the first is used as the name 128of the input file which is to be split. 129If a second additional argument is specified, it is used as a prefix 130for the names of the files into which the file is split. 131In this case, each file into which the file is split is named by the 132prefix followed by a lexically ordered suffix using 133.Ar suffix_length 134characters in the range
|
129.Dq Li a Ns - Ns Li z .
| 135.Dq Li a Ns - Ns Li z .
|
130If 131.Fl a 132is not specified, two letters are used as the suffix. 133.Pp 134If the 135.Ar prefix 136argument is not specified, the file is split into lexically ordered 137files named with the prefix 138.Dq Li x 139and with suffixes as above. 140.Sh ENVIRONMENT 141The 142.Ev LANG , LC_ALL , LC_CTYPE 143and 144.Ev LC_COLLATE 145environment variables affect the execution of 146.Nm 147as described in 148.Xr environ 7 . 149.Sh EXIT STATUS 150.Ex -std 151.Sh SEE ALSO 152.Xr csplit 1 , 153.Xr re_format 7 154.Sh STANDARDS 155The 156.Nm 157utility conforms to 158.St -p1003.1-2001 . 159.Sh HISTORY 160A 161.Nm 162command appeared in 163.At v3 . 164.Sh BUGS 165The maximum line length for matching patterns is 65536.
| 136If 137.Fl a 138is not specified, two letters are used as the suffix. 139.Pp 140If the 141.Ar prefix 142argument is not specified, the file is split into lexically ordered 143files named with the prefix 144.Dq Li x 145and with suffixes as above. 146.Sh ENVIRONMENT 147The 148.Ev LANG , LC_ALL , LC_CTYPE 149and 150.Ev LC_COLLATE 151environment variables affect the execution of 152.Nm 153as described in 154.Xr environ 7 . 155.Sh EXIT STATUS 156.Ex -std 157.Sh SEE ALSO 158.Xr csplit 1 , 159.Xr re_format 7 160.Sh STANDARDS 161The 162.Nm 163utility conforms to 164.St -p1003.1-2001 . 165.Sh HISTORY 166A 167.Nm 168command appeared in 169.At v3 . 170.Sh BUGS 171The maximum line length for matching patterns is 65536.
|