Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022

tdbbackup (8)


tdbbackup - tool for backing up and for validating the integrity of samba .tdb files


tdbbackup [-s suffix] [-v] [-h] [-n hashsize] [-l]


System Administration tools                                       TDBBACKUP(8)

       tdbbackup - tool for backing up and for validating the integrity of
       samba .tdb files

       tdbbackup [-s suffix] [-v] [-h] [-n hashsize] [-l]

       This tool is part of the samba(1) suite.

       tdbbackup is a tool that may be used to backup samba .tdb files. This
       tool may also be used to verify the integrity of the .tdb files prior
       to samba startup or during normal operation. If it finds file damage
       and it finds a prior backup the backup file will be restored.

           Get help information.

       -s suffix
           The -s option allows the administrator to specify a file backup
           extension. This way it is possible to keep a history of tdb backup
           files by using a new suffix for each backup.

           The -v will check the database for damages (corrupt data) which if
           detected causes the backup to be restored.

       -n hashsize
           The -n option sets the hash size for the new backup tdb.

           This options disables any locking, by passing TDB_NOLOCK to
           tdb_open_ex(). Only use this for database files which are not used
           by any other process! And also only if it is otherwise not possible
           to open the database, e.g. databases which were created with mutex


       The tdbbackup utility can safely be run at any time. It was designed so
       that it can be used at any time to validate the integrity of tdb files,
       even during Samba operation. Typical usage for the command will be:

       tdbbackup [-s suffix] *.tdb

       Before restarting samba the following command may be run to validate
       .tdb files:

       tdbbackup -v [-s suffix] *.tdb

       Samba .tdb files are stored in various locations, be sure to run backup
       all .tdb file on the system. Important files includes:

       o    secrets.tdb - usual location is in the /usr/local/samba/private
           directory, or on some systems in /etc/samba.

       o    passdb.tdb - usual location is in the /usr/local/samba/private
           directory, or on some systems in /etc/samba.

       o    *.tdb located in the /usr/local/samba/var directory or on some
           systems in the /var/cache or /var/lib/samba directories.

       This man page is correct for version 3 of the Samba suite.

       The original Samba software and related utilities were created by
       Andrew Tridgell. Samba is now developed by the Samba Team as an Open
       Source project similar to the way the Linux kernel is developed.

       The tdbbackup man page was written by John H Terpstra.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | service/network/samba |
       |Stability      | Volatile              |

       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from

       Further information about this software can be found on the open source
       community website at http://www.samba.org/.

Samba 3.6                         2015-04-25                      TDBBACKUP(8)