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