split.1 (f247324df75b7f55b48b92acb3b42a5ae2deac8a) split.1 (4185049582c7cea327a0571f8d3c2a3afb4a3e34)
1.\" Copyright (c) 1990, 1991, 1993, 1994
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 26 unchanged lines hidden (view full) ---

35.Dd April 16, 1994
36.Dt SPLIT 1
37.Os
38.Sh NAME
39.Nm split
40.Nd split a file into pieces
41.Sh SYNOPSIS
42.Nm
1.\" Copyright (c) 1990, 1991, 1993, 1994
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 26 unchanged lines hidden (view full) ---

35.Dd April 16, 1994
36.Dt SPLIT 1
37.Os
38.Sh NAME
39.Nm split
40.Nd split a file into pieces
41.Sh SYNOPSIS
42.Nm
43.Op Fl a Ar suffix_length
43.Op Fl b Ar byte_count[k|m]
44.Op Fl l Ar line_count
45.Op Fl p Ar pattern
46.Op Ar file Op Ar name
47.Sh DESCRIPTION
48The
49.Nm
50utility reads the given
51.Ar file
52(or standard input if no file is specified)
53and breaks it up into files of 1000 lines each.
54.Pp
55The options are as follows:
56.Bl -tag -width Ds
44.Op Fl b Ar byte_count[k|m]
45.Op Fl l Ar line_count
46.Op Fl p Ar pattern
47.Op Ar file Op Ar name
48.Sh DESCRIPTION
49The
50.Nm
51utility reads the given
52.Ar file
53(or standard input if no file is specified)
54and breaks it up into files of 1000 lines each.
55.Pp
56The options are as follows:
57.Bl -tag -width Ds
58.It Fl a
59Use
60.Ar suffix_length
61letters to form the suffix of the file name.
57.It Fl b
58Create smaller files
59.Ar byte_count
60bytes in length.
61If
62.Dq Li k
63is appended to the number, the file is split into
64.Ar byte_count

--- 19 unchanged lines hidden (view full) ---

84options.
85.El
86.Pp
87If additional arguments are specified, the first is used as the name
88of the input file which is to be split.
89If a second additional argument is specified, it is used as a prefix
90for the names of the files into which the file is split.
91In this case, each file into which the file is split is named by the
62.It Fl b
63Create smaller files
64.Ar byte_count
65bytes in length.
66If
67.Dq Li k
68is appended to the number, the file is split into
69.Ar byte_count

--- 19 unchanged lines hidden (view full) ---

89options.
90.El
91.Pp
92If additional arguments are specified, the first is used as the name
93of the input file which is to be split.
94If a second additional argument is specified, it is used as a prefix
95for the names of the files into which the file is split.
96In this case, each file into which the file is split is named by the
92prefix followed by a lexically ordered suffix in the range of
93.Dq Li aa-zz .
97prefix followed by a lexically ordered suffix using
98.Ar suffix_length
99characters in the range
100.Dq Li a-z .
101If
102.Fl a
103is not specified, two letters are used as the suffix.
94.Pp
95If the
96.Ar name
97argument is not specified, the file is split into lexically ordered
104.Pp
105If the
106.Ar name
107argument is not specified, the file is split into lexically ordered
98files named in the range of
99.Dq Li xaa-zzz .
108files named with prefixes in the range of
109.Dq Li x-z
110and with suffixes as above.
100.Sh BUGS
101For historical reasons, if you specify
102.Ar name ,
103.Nm
104can only create 676 separate
105files.
106The default naming convention allows 2028 separate files.
111.Sh BUGS
112For historical reasons, if you specify
113.Ar name ,
114.Nm
115can only create 676 separate
116files.
117The default naming convention allows 2028 separate files.
118The
119.Fl a
120option can be used to work around this limitation.
107.Pp
108The maximum line length for matching patterns is 65536.
109.Sh SEE ALSO
110.Xr re_format 7
111.Sh HISTORY
112A
113.Nm
114command appeared in
115.At v6 .
121.Pp
122The maximum line length for matching patterns is 65536.
123.Sh SEE ALSO
124.Xr re_format 7
125.Sh HISTORY
126A
127.Nm
128command appeared in
129.At v6 .