Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
split(1)			 User Commands			      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 lexicographically,	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 linecounNumber 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_MES-
       SAGES, 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWesu			   |
       +-----------------------------+-----------------------------+
       |CSI			     |enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       csplit(1),  statvfs(2),	attributes(5), environ(5), largefile(5), stan-
       dards(5)

SunOS 5.10			  16 Apr 1999			      split(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | USAGE | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=split&sektion=1&manpath=SunOS+5.10>

home | help