Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

split


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 linecounNtumber  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 diag-
                             nostic  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 result-
              ing  from  the split operation. If no name argument
              is given, x will be used as the prefix of the  out-
              put  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)










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments