xref: /original-bsd/usr.bin/split/split.1 (revision c3e32dec)
1.\" Copyright (c) 1990, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"	@(#)split.1	8.1 (Berkeley) 06/06/93
7.\"
8.Dd
9.Dt SPLIT 1
10.Os
11.Sh NAME
12.Nm split
13.Nd split a file into pieces
14.Sh SYNOPSIS
15.Nm split
16.Op Fl Ns Ar n
17.Op Fl b Ar bytes
18.Op Ar file Op Ar name
19.Sh DESCRIPTION
20The
21.Nm split
22utility reads the given
23.Ar file
24and splits it up in to
25smaller files.
26.Pp
27Available options:
28.Bl -tag -width "bb bytesx"
29.It Fl Ns Ar lines
30Create files of length
31.Fl Ns Ar n
32lines long.
33.It Fl b Ar bytes
34Create files of length
35.Ar bytes .
36If no output file length is specified, the file size
37will default to a lenght of 1000 lines.
38.El
39.Pp
40Available operands:
41.Bl -tag -width name
42.It Fl
43Read from the standard input.
44.It Ar file
45A pathname specifying the
46.Ar file
47to be split.  If no
48.Ar file
49operand is given,
50.Nm split
51reads from the standard input.
52.It Ar name
53If the
54.Ar name
55operand is given,
56the output files will begin with the prefix
57.Ar name
58and each sequential portion of the split file
59receives a lexically ordered suffix
60in the range of
61.Bq Em aa-zz .
62If the operand
63.Ar name
64is not specified,
65the default prefix of
66.Em x
67is be used.
68.Pp
69.Sh BUGS
70If you provide
71.Ar name ,
72.Nm split
73can only create 676 separate
74files.  The default naming convention allows 2028 separate files.
75.Sh HISTORY
76A
77.Nm split
78command appeared in
79.At v6 .
80