xref: /csrg-svn/usr.bin/split/split.1 (revision 66824)
1*66824Sbostic.\" Copyright (c) 1990, 1991, 1993, 1994
262254Sbostic.\"	The Regents of the University of California.  All rights reserved.
319481Smckusick.\"
450661Scael.\" %sccs.include.redist.roff%
548509Scael.\"
6*66824Sbostic.\"	@(#)split.1	8.3 (Berkeley) 04/16/94
748509Scael.\"
848509Scael.Dd
948509Scael.Dt SPLIT 1
1050661Scael.Os
1148509Scael.Sh NAME
1248509Scael.Nm split
1348509Scael.Nd split a file into pieces
1448509Scael.Sh SYNOPSIS
1548509Scael.Nm split
16*66824Sbostic.Op Fl b Ar byte_count[k|m]
17*66824Sbostic.Op Fl l Ar line_count
1850661Scael.Op Ar file Op Ar name
1948509Scael.Sh DESCRIPTION
2048509ScaelThe
2148509Scael.Nm split
2248509Scaelutility reads the given
2348509Scael.Ar file
24*66824Sbostic(or standard input if no file is specified)
25*66824Sbosticand breaks it up into files of 1000 lines each.
2648509Scael.Pp
2766574SbosticThe options are as follows:
28*66824Sbostic.Bl -tag -width Ds
29*66824Sbostic.It Fl b
3066574SbosticCreate smaller files
31*66824Sbostic.Ar byte_count
32*66824Sbosticbytes in length.
33*66824SbosticIf
34*66824Sbostic.Dq Li k
35*66824Sbosticis appended to the number, the file is split into
36*66824Sbostic.Ar byte_count
37*66824Sbostickilobyte pieces.
38*66824SbosticIf
39*66824Sbostic.Dq Li m
40*66824Sbosticis appended to the number, the file is split into
41*66824Sbostic.Ar byte_count
42*66824Sbosticmegabyte pieces.
43*66824Sbostic.It Fl l
44*66824SbosticCreate smaller files
4566574Sbostic.Ar n
4666574Sbosticlines in length.
4748509Scael.El
4848509Scael.Pp
49*66824SbosticIf additional arguments are specified, the first is used as the name
50*66824Sbosticof the input file which is to be split.
51*66824SbosticIf a second additional argument is specified, it is used as a prefix
52*66824Sbosticfor the names of the files into which the file is split.
53*66824SbosticIn this case, each file into which the file is split is named by the
54*66824Sbosticprefix followed by a lexically ordered suffix in the range of
55*66824Sbostic.Dq Li aa-zz .
56*66824Sbostic.Pp
5748509ScaelIf the
5848509Scael.Ar name
59*66824Sbosticargument is not specified, the file is split into lexically ordered
60*66824Sbosticfiles named in the range of
61*66824Sbostic.Dq Li xaa-zzz .
6248509Scael.Sh BUGS
63*66824SbosticFor historical reasons, if you specify
6448509Scael.Ar name ,
6548509Scael.Nm split
6648509Scaelcan only create 676 separate
6766574Sbosticfiles.
6866574SbosticThe default naming convention allows 2028 separate files.
6948509Scael.Sh HISTORY
7048509ScaelA
7150661Scael.Nm split
7248509Scaelcommand appeared in
7348509Scael.At v6 .
74