split(1)

NAME

     split - split a file into pieces

SYNOPSIS

     split [-linecount | -l linecount]  [-a suffixlength] [  file
     [name]]

     split [ -b  n | nk | nm] [-a suffixlength] [ file [name]]

DESCRIPTION

     The split utility reads file and writes it in linecount-line
     pieces  into  a  set  of output-files. The name of the first
     output-file is name with aa appended, and so on lexicograph-
     ically,  up  to  zz  (a  maximum  of 676 files). The maximum
     length of  name  is  2  characters  less  than  the  maximum
     filename  length  allowed by the filesystem. See statvfs(2).
     If no output name  is  given,  x  is  used  as  the  default
     (output-files will be called xaa, xab, and so forth).

OPTIONS

     The following options are supported:

     -linecount | -l linecount
           Number of lines in each piece. Defaults to 1000 lines.

     -a suffixlength
           Uses suffixlength letters to form the  suffix  portion
           of  the  filenames  of  the  split  file. If -a is not
           specified, the default suffix length is 2. If the  sum
           of  the  name  operand  and  the  suffixlength option-
           argument would create a  filename  exceeding  NAME_MAX
           bytes,  an  error  will result; split will exit with a
           diagnostic message and no files will be created.

     -b n  Splits a file into pieces n bytes in size.

     -b nk Splits a file into pieces n*1024 bytes in size.

     -b nm Splits a file into pieces n*1048576 bytes in size.

OPERANDS

     The following operands are supported:

     file  The path name of the ordinary file to be split. If  no
           input  file  is given or file is -, the standard input
           will be used.

     name  The prefix to be used for each of the files  resulting
           from  the  split  operation.  If  no  name argument is
           given, x will be used as  the  prefix  of  the  output
           files.  The  combined length of the basename of prefix
           and suffixlength cannot  exceed  NAME_MAX  bytes.  See
           OPTIONS.

USAGE

     See largefile(5) for the  description  of  the  behavior  of
     split  when  encountering  files  greater than or equal to 2
     Gbyte ( 2**31 bytes).

ENVIRONMENT VARIABLES

     See environ(5) for descriptions of the following environment
     variables  that affect the execution of split: LANG, LC_ALL,
     LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWesu                     |
    |_____________________________|_____________________________|
    | CSI                         | enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|

SEE ALSO

     csplit(1),  statvfs(2),  attributes(5),  environ(5),  large-
     file(5), standards(5)