summaryrefslogtreecommitdiff
path: root/util/sbase/split.1
diff options
context:
space:
mode:
Diffstat (limited to 'util/sbase/split.1')
-rw-r--r--util/sbase/split.146
1 files changed, 46 insertions, 0 deletions
diff --git a/util/sbase/split.1 b/util/sbase/split.1
new file mode 100644
index 00000000..63b3b521
--- /dev/null
+++ b/util/sbase/split.1
@@ -0,0 +1,46 @@
+.Dd October 8, 2015
+.Dt SPLIT 1
+.Os sbase
+.Sh NAME
+.Nm split
+.Nd split up a file
+.Sh SYNOPSIS
+.Nm
+.Op Fl a Ar num
+.Op Fl b Ar num[k|m|g] | Fl l Ar num
+.Op Fl d
+.Op Ar file Op Ar prefix
+.Sh DESCRIPTION
+.Nm
+splits
+.Ar file
+into files with 1000 lines each, named with
+.Ar prefix
+"x" followed by 2-digit alphabetical count suffixes.
+If
+.Nm
+runs out of suffixes, it stops after the last valid filename.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl a Ar num
+Set suffix length to
+.Ar num
+characters.
+The default is 2.
+.It Fl b Ar num[k|m|g] | Fl l Ar num
+Start a new file every
+.Ar num
+bytes | lines.
+The units k, m, and g are case insensitive and powers of 2, not 10.
+The default is 1000 lines.
+.It Fl d
+Use decimal rather than alphabetical suffixes.
+.El
+.Sh SEE ALSO
+.Xr cat 1
+.Sh STANDARDS
+POSIX.1-2013.
+.Pp
+The
+.Op Fl d
+flag and g unit are an extension to that specification.