Return to split.1 CVS log

Up to [local] / src / usr.bin / split

Annotation of src/usr.bin/split/split.1, Revision 1.1

1.1     ! deraadt     1: .\"    $NetBSD: split.1,v 1.5 1994/12/21 08:20:35 jtc Exp $
        !             2: .\"
        !             3: .\" Copyright (c) 1990, 1991, 1993, 1994
        !             4: .\"    The Regents of the University of California.  All rights reserved.
        !             5: .\"
        !             6: .\" Redistribution and use in source and binary forms, with or without
        !             7: .\" modification, are permitted provided that the following conditions
        !             8: .\" are met:
        !             9: .\" 1. Redistributions of source code must retain the above copyright
        !            10: .\"    notice, this list of conditions and the following disclaimer.
        !            11: .\" 2. Redistributions in binary form must reproduce the above copyright
        !            12: .\"    notice, this list of conditions and the following disclaimer in the
        !            13: .\"    documentation and/or other materials provided with the distribution.
        !            14: .\" 3. All advertising materials mentioning features or use of this software
        !            15: .\"    must display the following acknowledgement:
        !            16: .\"    This product includes software developed by the University of
        !            17: .\"    California, Berkeley and its contributors.
        !            18: .\" 4. Neither the name of the University nor the names of its contributors
        !            19: .\"    may be used to endorse or promote products derived from this software
        !            20: .\"    without specific prior written permission.
        !            21: .\"
        !            22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
        !            23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        !            24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        !            25: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
        !            26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        !            27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        !            28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        !            29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        !            30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        !            31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        !            32: .\" SUCH DAMAGE.
        !            33: .\"
        !            34: .\"    @(#)split.1     8.3 (Berkeley) 4/16/94
        !            35: .\"
        !            36: .Dd April 16, 1994
        !            37: .Dt SPLIT 1
        !            38: .Os
        !            39: .Sh NAME
        !            40: .Nm split
        !            41: .Nd split a file into pieces
        !            42: .Sh SYNOPSIS
        !            43: .Nm split
        !            44: .Op Fl b Ar byte_count[k|m]
        !            45: .Op Fl l Ar line_count
        !            46: .Op Ar file Op Ar name
        !            47: .Sh DESCRIPTION
        !            48: The
        !            49: .Nm split
        !            50: utility reads the given
        !            51: .Ar file
        !            52: (or standard input if no file is specified)
        !            53: and breaks it up into files of 1000 lines each.
        !            54: .Pp
        !            55: The options are as follows:
        !            56: .Bl -tag -width Ds
        !            57: .It Fl b
        !            58: Create smaller files
        !            59: .Ar byte_count
        !            60: bytes in length.
        !            61: If
        !            62: .Dq Li k
        !            63: is appended to the number, the file is split into
        !            64: .Ar byte_count
        !            65: kilobyte pieces.
        !            66: If
        !            67: .Dq Li m
        !            68: is appended to the number, the file is split into
        !            69: .Ar byte_count
        !            70: megabyte pieces.
        !            71: .It Fl l
        !            72: Create smaller files
        !            73: .Ar n
        !            74: lines in length.
        !            75: .El
        !            76: .Pp
        !            77: If additional arguments are specified, the first is used as the name
        !            78: of the input file which is to be split.
        !            79: If a second additional argument is specified, it is used as a prefix
        !            80: for the names of the files into which the file is split.
        !            81: In this case, each file into which the file is split is named by the
        !            82: prefix followed by a lexically ordered suffix in the range of
        !            83: .Dq Li aa-zz .
        !            84: .Pp
        !            85: If the
        !            86: .Ar name
        !            87: argument is not specified, the file is split into lexically ordered
        !            88: files named in the range of
        !            89: .Dq Li xaa-zzz .
        !            90: .Sh BUGS
        !            91: For historical reasons, if you specify
        !            92: .Ar name ,
        !            93: .Nm split
        !            94: can only create 676 separate
        !            95: files.
        !            96: The default naming convention allows 2028 separate files.
        !            97: .Sh HISTORY
        !            98: A
        !            99: .Nm split
        !           100: command appeared in
        !           101: .At v6 .