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