xref: /freebsd/usr.bin/split/split.1 (revision 9b50d9027575220cb6dd09b3e62f03f511e908b8)
19b50d902SRodney W. Grimes.\" Copyright (c) 1990, 1991, 1993, 1994
29b50d902SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
39b50d902SRodney W. Grimes.\"
49b50d902SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
59b50d902SRodney W. Grimes.\" modification, are permitted provided that the following conditions
69b50d902SRodney W. Grimes.\" are met:
79b50d902SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
89b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
99b50d902SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
109b50d902SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
119b50d902SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
129b50d902SRodney W. Grimes.\" 3. All advertising materials mentioning features or use of this software
139b50d902SRodney W. Grimes.\"    must display the following acknowledgement:
149b50d902SRodney W. Grimes.\"	This product includes software developed by the University of
159b50d902SRodney W. Grimes.\"	California, Berkeley and its contributors.
169b50d902SRodney W. Grimes.\" 4. Neither the name of the University nor the names of its contributors
179b50d902SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
189b50d902SRodney W. Grimes.\"    without specific prior written permission.
199b50d902SRodney W. Grimes.\"
209b50d902SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
219b50d902SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
229b50d902SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
239b50d902SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
249b50d902SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
259b50d902SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
269b50d902SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
279b50d902SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
289b50d902SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
299b50d902SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
309b50d902SRodney W. Grimes.\" SUCH DAMAGE.
319b50d902SRodney W. Grimes.\"
329b50d902SRodney W. Grimes.\"	@(#)split.1	8.3 (Berkeley) 4/16/94
339b50d902SRodney W. Grimes.\"
349b50d902SRodney W. Grimes.Dd April 16, 1994
359b50d902SRodney W. Grimes.Dt SPLIT 1
369b50d902SRodney W. Grimes.Os
379b50d902SRodney W. Grimes.Sh NAME
389b50d902SRodney W. Grimes.Nm split
399b50d902SRodney W. Grimes.Nd split a file into pieces
409b50d902SRodney W. Grimes.Sh SYNOPSIS
419b50d902SRodney W. Grimes.Nm split
429b50d902SRodney W. Grimes.Op Fl b Ar byte_count[k|m]
439b50d902SRodney W. Grimes.Op Fl l Ar line_count
449b50d902SRodney W. Grimes.Op Ar file Op Ar name
459b50d902SRodney W. Grimes.Sh DESCRIPTION
469b50d902SRodney W. GrimesThe
479b50d902SRodney W. Grimes.Nm split
489b50d902SRodney W. Grimesutility reads the given
499b50d902SRodney W. Grimes.Ar file
509b50d902SRodney W. Grimes(or standard input if no file is specified)
519b50d902SRodney W. Grimesand breaks it up into files of 1000 lines each.
529b50d902SRodney W. Grimes.Pp
539b50d902SRodney W. GrimesThe options are as follows:
549b50d902SRodney W. Grimes.Bl -tag -width Ds
559b50d902SRodney W. Grimes.It Fl b
569b50d902SRodney W. GrimesCreate smaller files
579b50d902SRodney W. Grimes.Ar byte_count
589b50d902SRodney W. Grimesbytes in length.
599b50d902SRodney W. GrimesIf
609b50d902SRodney W. Grimes.Dq Li k
619b50d902SRodney W. Grimesis appended to the number, the file is split into
629b50d902SRodney W. Grimes.Ar byte_count
639b50d902SRodney W. Grimeskilobyte pieces.
649b50d902SRodney W. GrimesIf
659b50d902SRodney W. Grimes.Dq Li m
669b50d902SRodney W. Grimesis appended to the number, the file is split into
679b50d902SRodney W. Grimes.Ar byte_count
689b50d902SRodney W. Grimesmegabyte pieces.
699b50d902SRodney W. Grimes.It Fl l
709b50d902SRodney W. GrimesCreate smaller files
719b50d902SRodney W. Grimes.Ar n
729b50d902SRodney W. Grimeslines in length.
739b50d902SRodney W. Grimes.El
749b50d902SRodney W. Grimes.Pp
759b50d902SRodney W. GrimesIf additional arguments are specified, the first is used as the name
769b50d902SRodney W. Grimesof the input file which is to be split.
779b50d902SRodney W. GrimesIf a second additional argument is specified, it is used as a prefix
789b50d902SRodney W. Grimesfor the names of the files into which the file is split.
799b50d902SRodney W. GrimesIn this case, each file into which the file is split is named by the
809b50d902SRodney W. Grimesprefix followed by a lexically ordered suffix in the range of
819b50d902SRodney W. Grimes.Dq Li aa-zz .
829b50d902SRodney W. Grimes.Pp
839b50d902SRodney W. GrimesIf the
849b50d902SRodney W. Grimes.Ar name
859b50d902SRodney W. Grimesargument is not specified, the file is split into lexically ordered
869b50d902SRodney W. Grimesfiles named in the range of
879b50d902SRodney W. Grimes.Dq Li xaa-zzz .
889b50d902SRodney W. Grimes.Sh BUGS
899b50d902SRodney W. GrimesFor historical reasons, if you specify
909b50d902SRodney W. Grimes.Ar name ,
919b50d902SRodney W. Grimes.Nm split
929b50d902SRodney W. Grimescan only create 676 separate
939b50d902SRodney W. Grimesfiles.
949b50d902SRodney W. GrimesThe default naming convention allows 2028 separate files.
959b50d902SRodney W. Grimes.Sh HISTORY
969b50d902SRodney W. GrimesA
979b50d902SRodney W. Grimes.Nm split
989b50d902SRodney W. Grimescommand appeared in
999b50d902SRodney W. Grimes.At v6 .
100