19b50d902SRodney W. Grimes.\" Copyright (c) 1990, 1991, 1993, 1994 29b50d902SRodney W. Grimes.\" The Regents of the University of California. All rights reserved. 39b50d902SRodney W. Grimes.\" 49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without 59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions 69b50d902SRodney W. Grimes.\" are met: 79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright 89b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer. 99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright 109b50d902SRodney W. Grimes.\" notice, this list of conditions and the following disclaimer in the 119b50d902SRodney W. Grimes.\" documentation and/or other materials provided with the distribution. 129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software 139b50d902SRodney W. Grimes.\" must display the following acknowledgement: 149b50d902SRodney W. Grimes.\" This product includes software developed by the University of 159b50d902SRodney W. Grimes.\" California, Berkeley and its contributors. 169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors 179b50d902SRodney W. Grimes.\" may be used to endorse or promote products derived from this software 189b50d902SRodney W. Grimes.\" without specific prior written permission. 199b50d902SRodney W. Grimes.\" 209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 239b50d902SRodney W. Grimes.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 309b50d902SRodney W. Grimes.\" SUCH DAMAGE. 319b50d902SRodney W. Grimes.\" 329b50d902SRodney W. Grimes.\" @(#)split.1 8.3 (Berkeley) 4/16/94 33c3aac50fSPeter Wemm.\" $FreeBSD$ 349b50d902SRodney W. Grimes.\" 359b50d902SRodney W. Grimes.Dd April 16, 1994 369b50d902SRodney W. Grimes.Dt SPLIT 1 379b50d902SRodney W. Grimes.Os 389b50d902SRodney W. Grimes.Sh NAME 399b50d902SRodney W. Grimes.Nm split 409b50d902SRodney W. Grimes.Nd split a file into pieces 419b50d902SRodney W. Grimes.Sh SYNOPSIS 428fe908efSRuslan Ermilov.Nm 4341850495SMike Barcroft.Op Fl a Ar suffix_length 449b50d902SRodney W. Grimes.Op Fl b Ar byte_count[k|m] 459b50d902SRodney W. Grimes.Op Fl l Ar line_count 462fa6610fSArchie Cobbs.Op Fl p Ar pattern 479b50d902SRodney W. Grimes.Op Ar file Op Ar name 489b50d902SRodney W. Grimes.Sh DESCRIPTION 499b50d902SRodney W. GrimesThe 508fe908efSRuslan Ermilov.Nm 519b50d902SRodney W. Grimesutility reads the given 529b50d902SRodney W. Grimes.Ar file 539b50d902SRodney W. Grimesand breaks it up into files of 1000 lines each. 543e4228c3STim J. RobbinsIf 553e4228c3STim J. Robbins.Ar file 563e4228c3STim J. Robbinsis a single dash 573e4228c3STim J. Robbins.Pq Ql \&- 583e4228c3STim J. Robbinsor absent, 593e4228c3STim J. Robbins.Nm 603e4228c3STim J. Robbinsreads from the standard input. 619b50d902SRodney W. Grimes.Pp 629b50d902SRodney W. GrimesThe options are as follows: 639b50d902SRodney W. Grimes.Bl -tag -width Ds 6441850495SMike Barcroft.It Fl a 6541850495SMike BarcroftUse 6641850495SMike Barcroft.Ar suffix_length 6741850495SMike Barcroftletters to form the suffix of the file name. 689b50d902SRodney W. Grimes.It Fl b 699b50d902SRodney W. GrimesCreate smaller files 709b50d902SRodney W. Grimes.Ar byte_count 719b50d902SRodney W. Grimesbytes in length. 729b50d902SRodney W. GrimesIf 739b50d902SRodney W. Grimes.Dq Li k 749b50d902SRodney W. Grimesis appended to the number, the file is split into 759b50d902SRodney W. Grimes.Ar byte_count 769b50d902SRodney W. Grimeskilobyte pieces. 779b50d902SRodney W. GrimesIf 789b50d902SRodney W. Grimes.Dq Li m 799b50d902SRodney W. Grimesis appended to the number, the file is split into 809b50d902SRodney W. Grimes.Ar byte_count 819b50d902SRodney W. Grimesmegabyte pieces. 829b50d902SRodney W. Grimes.It Fl l 839b50d902SRodney W. GrimesCreate smaller files 849b50d902SRodney W. Grimes.Ar n 859b50d902SRodney W. Grimeslines in length. 862fa6610fSArchie Cobbs.It Fl p Ar pattern 872fa6610fSArchie CobbsThe file is split whenever an input line matches 882fa6610fSArchie Cobbs.Ar pattern , 892fa6610fSArchie Cobbswhich is interpreted as an extended regular expression. 902fa6610fSArchie CobbsThe matching line will be the first line of the next output file. 912fa6610fSArchie CobbsThis option is incompatible with the 922fa6610fSArchie Cobbs.Fl b 932fa6610fSArchie Cobbsand 942fa6610fSArchie Cobbs.Fl l 952fa6610fSArchie Cobbsoptions. 969b50d902SRodney W. Grimes.El 979b50d902SRodney W. Grimes.Pp 989b50d902SRodney W. GrimesIf additional arguments are specified, the first is used as the name 999b50d902SRodney W. Grimesof the input file which is to be split. 1009b50d902SRodney W. GrimesIf a second additional argument is specified, it is used as a prefix 1019b50d902SRodney W. Grimesfor the names of the files into which the file is split. 1029b50d902SRodney W. GrimesIn this case, each file into which the file is split is named by the 10341850495SMike Barcroftprefix followed by a lexically ordered suffix using 10441850495SMike Barcroft.Ar suffix_length 10541850495SMike Barcroftcharacters in the range 10641850495SMike Barcroft.Dq Li a-z . 10741850495SMike BarcroftIf 10841850495SMike Barcroft.Fl a 10941850495SMike Barcroftis not specified, two letters are used as the suffix. 1109b50d902SRodney W. Grimes.Pp 1119b50d902SRodney W. GrimesIf the 1129b50d902SRodney W. Grimes.Ar name 1139b50d902SRodney W. Grimesargument is not specified, the file is split into lexically ordered 11441850495SMike Barcroftfiles named with prefixes in the range of 11541850495SMike Barcroft.Dq Li x-z 11641850495SMike Barcroftand with suffixes as above. 1179b50d902SRodney W. Grimes.Sh BUGS 1189b50d902SRodney W. GrimesFor historical reasons, if you specify 1199b50d902SRodney W. Grimes.Ar name , 1208fe908efSRuslan Ermilov.Nm 1219b50d902SRodney W. Grimescan only create 676 separate 1229b50d902SRodney W. Grimesfiles. 1239b50d902SRodney W. GrimesThe default naming convention allows 2028 separate files. 12441850495SMike BarcroftThe 12541850495SMike Barcroft.Fl a 12641850495SMike Barcroftoption can be used to work around this limitation. 1272fa6610fSArchie Cobbs.Pp 1282fa6610fSArchie CobbsThe maximum line length for matching patterns is 65536. 1292fa6610fSArchie Cobbs.Sh SEE ALSO 1303662a240STim J. Robbins.Xr csplit 1 , 13176a06f84SBen Smithurst.Xr re_format 7 1323662a240STim J. Robbins.Sh STANDARDS 1333662a240STim J. RobbinsThe 1343662a240STim J. Robbins.Nm 1353662a240STim J. Robbinsutility conforms to 1363662a240STim J. Robbins.St -p1003.1-2001 . 1379b50d902SRodney W. Grimes.Sh HISTORY 1389b50d902SRodney W. GrimesA 1398fe908efSRuslan Ermilov.Nm 1409b50d902SRodney W. Grimescommand appeared in 1419b50d902SRodney W. Grimes.At v6 . 142