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