split 1.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  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 (6).
  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 /sys/src/cmd/split.c
  78. .SH SEE ALSO
  79. .IR sed (1),
  80. .IR awk (1),
  81. .IR grep (1),
  82. .IR regexp (6)