nbackup1

Usage

Overview

nbackup allows making incremental backups of firebird databases. It also allows database files to be locked for copying with OS tools like cp(1).

Commands

-l database

-lock database

Locks database for filesystem copy.

Options of the -lock command:

-s

-size

Print database size (in database pages) after locking.

-un database

-unlock database

Unlocks previously locked database.

-f database

-fixup database

Fixup database after filesystem copy. This needs to be done on the target database before usage.

-b level database file

-backup level database file

Create incremental backup of level level. Level 0 means full backup. Level N includes all the changes since the last backup of level N. file may be "stdout" meaning to write the backup data to the standard output.

Additional options to the -backup command:

-d on|off

-direct on|off

Turns on or off direct I/O during database backup.

Direct I/O may be useful when database is much larger that RAM, because in that case using buffered I/O may cause replacing useful cache contents with database file contents, which are generally read only once.

-r database file0 [file1...]

-restore database file0 [file1...]

Restore incremental backup. file0 is the level 0 backup, file1 is the level 1 backup and so on.

Additional -restore options:

-de command

-decompress command

Decompress backup file contents using the given command.

Note: -restore should be the last argument to nbackup followed only by database and file names. All other options must precede -restore or will be interpreted as backup file names.

Options

-u user

-user user

User name for connecting to the firebird server.

-p password

-password password

Password for connecting to the firebird server.

-fetch_password file

Read password from specified file.

-nod

-nodbtriggers

Do not run database-level triggers.