9base

revived minimalist port of Plan 9 userland to Unix
git clone git://git.suckless.org/9base
Log | Files | Refs | README | LICENSE

split.1 (1170B)


      1 .TH SPLIT 1
      2 .CT 1 files
      3 .SH NAME
      4 split \- split a file into pieces
      5 .SH SYNOPSIS
      6 .B split
      7 [
      8 .I option ...
      9 ]
     10 [
     11 .I file
     12 ]
     13 .SH DESCRIPTION
     14 .I Split
     15 reads
     16 .I file
     17 (standard input by default)
     18 and writes it in pieces of 1000
     19 lines per output file.
     20 The names of the
     21 output files are
     22 .BR xaa ,
     23 .BR xab ,
     24 and so on to
     25 .BR xzz .
     26 The options are
     27 .TP
     28 .BI -n " n"
     29 Split into
     30 .IR n -line
     31 pieces.
     32 .TP
     33 .BI -l " n"
     34 Synonym for
     35 .B -n
     36 .IR n ,
     37 a nod to Unix's syntax.
     38 .TP
     39 .BI -e " expression"
     40 File divisions occur at each line
     41 that matches a regular
     42 .IR expression ;
     43 see 
     44 .IR regexp (7).
     45 Multiple
     46 .B -e
     47 options may appear.
     48 If a subexpression of
     49 .I expression
     50 is contained in parentheses
     51 .BR ( ... ) ,
     52 the output file name is the portion of the
     53 line which matches the subexpression.
     54 .TP
     55 .BI -f " stem
     56 Use
     57 .I stem
     58 instead of
     59 .B x
     60 in output file names.
     61 .TP
     62 .BI -s " suffix
     63 Append
     64 .I suffix
     65 to names identified under
     66 .BR -e .
     67 .TP
     68 .B -x
     69 Exclude the matched input line from the output file.
     70 .TP
     71 .B -i
     72 Ignore case in option
     73 .BR -e ;
     74 force output file names (excluding the suffix)
     75 to lower case.
     76 .SH SOURCE
     77 .B \*9/src/cmd/split.c
     78 .SH SEE ALSO
     79 .IR sed (1), 
     80 .IR awk (1),
     81 .IR grep (1),
     82 .IR regexp (7)