FirebirdSQL logo

-⁠REP[LACE_DATABASE]

Replace database from backup file, overwriting an existing database if it exists.

This switch used to be abbreviated to -⁠r in Firebird 1.5 and older.

Caution

If the target database already exists, it will first be deleted (dropped), before the restore is performed.

Warning

The -⁠REP[LACE_DATABASE] switch is deprecated and may be removed in a future Firebird version.

Use either [gbak-cmdline-create-database] or [gbak-cmdline-recreate-database].Specifically, use -⁠r o or -⁠recreate_database overwrite for the exact equivalent of this switch.

-⁠BU[FFERS]

Configure the database page buffer (cache size).

Syntax
-BU[FFERS] number-of-pages

This switch sets the default database cache size (in number of database pages) for the database being restored.If a database is being overwritten then this setting will overwrite the previous setting for the cache size.

-⁠FIX_FSS_D[ATA]

Fix malformed UNICODE_FSS data.

Syntax
-FIX_FSS_D[ATA] charset-name

This switch forces gbak to fix malformed UNICODE_FSS character data during a restore.

Malformed string data will be attempted to be read using the specified character set charset-name, and then transformed to UNICODE_FSS.Specifying the wrong character set name may result in logical corruption of your data.

Caution

Do not use this switch without a clear understanding of what it does.Incorrect use could corrupt your data instead of fixing things.Always keep a copy of the original database and its backup.

This switch, and the following one, should not be required under normal circumstances.However, if a restore operation fails with a "malformed string" error, the message output from gbak will refer the user to one or both of these switches to fix the malformed UNICODE_FSS data or metadata as appropriate.

Note
Introduced in Firebird 2.5.

-⁠FIX_FSS_M[ETADATA]

Fix malformed UNICODE_FSS metadata.

Syntax
-FIX_FSS_M[ETADATA] charset-name

This switch forces gbak to fix malformed UNICODE_FSS metadata during a restore.

Malformed metadata string will be attempted to be read using the specified character set charset-name, and then transformed to UNICODE_FSS.Specifying the wrong character set name may result in logical corruption of the strings in your metadata.

Caution

Do not use this switch without a clear understanding of what it does.Incorrect use could corrupt your database instead of fixing things.Always keep a copy of the original database and its backup.

This switch, and the preceding one, should not be required under normal circumstances.However, if a restore operation fails with a "malformed string" error, the message output from gbak will refer the user to one or both of these switches to fix the malformed UNICODE_FSS data or metadata as appropriate.

Note
Introduced in Firebird 2.5.