xref: /csrg-svn/usr.bin/split/split.1 (revision 48509)
1*48509Scael.\" Copyright (c) 1990, 1991 Regents of the University of California.
2*48509Scael.\" All rights reserved.
319481Smckusick.\"
4*48509Scael.\" %sccs.include.redist.man%
5*48509Scael.\"
6*48509Scael.\"     @(#)split.1	6.3 (Berkeley) 04/22/91
7*48509Scael.\"
8*48509Scael.Dd
9*48509Scael.Dt SPLIT 1
10*48509Scael.Os BSD 4.4
11*48509Scael.Sh NAME
12*48509Scael.Nm split
13*48509Scael.Nd split a file into pieces
14*48509Scael.Sh SYNOPSIS
15*48509Scael.Nm split
16*48509Scael.Op Fl Ns Ar n
17*48509Scael.Op Fl b Ar bytes
18*48509Scael.Oo Ar file
19*48509Scael.Op Ar name
20*48509Scael.Oc
21*48509Scael.Sh DESCRIPTION
22*48509ScaelThe
23*48509Scael.Nm split
24*48509Scaelutility reads the given
25*48509Scael.Ar file
26*48509Scaeland splits it up in to
27*48509Scaelsmaller files.
28*48509Scael.Pp
29*48509ScaelAvailable options:
30*48509Scael.Bl -tag -width "bb bytesx"
31*48509Scael.It Fl Ns Ar lines
32*48509ScaelCreate files of length
33*48509Scael.Fl Ns Ar n
34*48509Scaellines long.
35*48509Scael.It Fl b Ar bytes
36*48509ScaelCreate files of length
37*48509Scael.Ar bytes .
38*48509ScaelIf no output file length is specified, the file size
39*48509Scaelwill default to a lenght of 1000 lines.
40*48509Scael.El
41*48509Scael.Pp
42*48509ScaelAvailable operands:
43*48509Scael.Bl -tag -width name
44*48509Scael.It Fl
45*48509ScaelRead from the standard input.
46*48509Scael.It Ar file
47*48509ScaelA pathname specifying the
48*48509Scael.Ar file
49*48509Scaelto be split.  If no
50*48509Scael.Ar file
51*48509Scaeloperand is given,
52*48509Scael.Nm split
53*48509Scaelreads from the standard input.
54*48509Scael.It Ar name
55*48509ScaelIf the
56*48509Scael.Ar name
57*48509Scaeloperand is given,
58*48509Scaelthe output files will begin with the prefix
59*48509Scael.Ar name
60*48509Scaeland each sequential portion of the split file
61*48509Scaelreceives a lexically ordered suffix
62*48509Scaelin the range of
63*48509Scael.Bq Em aa-zz .
64*48509ScaelIf the operand
65*48509Scael.Ar name
66*48509Scaelis not specified,
67*48509Scaelthe default prefix of
68*48509Scael.Em x
69*48509Scaelis be used.
70*48509Scael.Pp
71*48509Scael.Sh BUGS
72*48509ScaelIf you provide
73*48509Scael.Ar name ,
74*48509Scael.Nm split
75*48509Scaelcan only create 676 separate
7630125Sbosticfiles.  The default naming convention allows 2028 separate files.
77*48509Scael.Sh HISTORY
78*48509ScaelA
79*48509Scael.Nm
80*48509Scaelcommand appeared in
81*48509Scael.At v6 .
82