FirebirdSQL logo

-⁠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.

-⁠I[NACTIVE]

Do not activate indexes after restore.

This switch can be used to restore a database when a previous restore attempt failed due to index errors.All indexes in the restored database will be inactive, and as a consequence all primary key, unique key and foreign key constraints as well.