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$ 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 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. 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 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 129.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. 166