gsplit command-line options

<< Introduction | Firebird Backup File Splitting Filter | gsplit command parameters >>

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.

back to top of page
<< Introduction | Firebird Backup File Splitting Filter | gsplit command parameters >>