gsplit command-line options

gsplit has three command line options, although, strictly speaking, the -help option isn't really valid.

These are:

• -split_bk_file <parameters>

Specifies that gsplit is to be used to split the output from gbak into a number of different files as part of a database backup. This option can be shortened as required, provided that at least -s is specified.

• -join_bk_file <parameters>

Specifies that gsplit is to be used to rejoin a number of files and use the result as input to gbak as part of a database restore. This option can be shortened as required, provided that at least -j is specified.

• -help

Using the -help option, specifying an illegal option, or omitting all options, displays the following information:

gsplit: invalid option '-help'
gsplit: Command Line Options Are:

gsplit -S[PLIT_BK_FILE] <file> <size>{k|m|g} [… <file> [<size>{k|m|g}]]

or gsplit -J[OINT_BK_FILE] <file> [… <file>]

gsplit: option can be abbreviated to the unparenthesized characters
gsplit: Exiting before completion due to errors

Note: Take note of the error in the above help text. The correct command line option to join multiple sections of a large backup file is not -JOINT_BK_FILE as shown, but is in fact -JOIN_BK_FILE.