tdbbackup(8) [osx man page]

TDBBACKUP(8)															      TDBBACKUP(8)

NAME

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

SYNOPSIS

       tdbbackup [-ssuffix] [-v] [-h]

DESCRIPTION

       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.

OPTIONS

       -h
	  Get help information.

       -s suffix
	  The -s option allows the adminisistrator 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.

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

COMMANDS

       GENERAL INFORMATION

       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.

VERSION

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

AUTHOR

       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.

																      TDBBACKUP(8)

Check Out this Related Man Page

TDB_FIRSTKEY(3) 					     Linux Programmer's Manual						   TDB_FIRSTKEY(3)

NAME

       tdb_firstkey - return the key of the first record in a tdb database tdb_nextkey - return the key of next record in the tdb database

SYNOPSIS

       #include <tdb.h>

       TDB_DATA tdb_firstkey(TDB_CONTEXT *tdb);
       TDB_DATA tdb_nextkey(TDB_CONTEXT *tdb, TDB_DATA prev_key);

DESCRIPTION

       tdb_firstkey  fetches  the key of the first entry in the tdb database.  tdb_nextkey fetches the key of the entry immediately after prev_key
       in the database.

       The TDB_DATA structure returned by both these functions is defined as:

	      typedef struct {
		   char *dptr;
		   size_t dsize;
	      } TDB_DATA;

       The order in which this traverses the database is its own internal hash order. Do not expect the keys to  be  in  any  recognizably  sorted
       order.

       These  functions are reliable even if other writers are accessing the database (or you are replacing or deleting elements as you traverse),
       except in the case of nested tdb_firstkey or tdb_nextkey calls.	For example, the following outer traversal may fail to	traverse  all  the
       elements, or may even traverse elements twice if other processes are manipulating the database:

		   TDB_DATA i, j;

		   for (i = tdb_firstkey(tdb); i.dptr; i = tdb_nextkey(tdb, i)) {
			for (j = tdb_firstkey(tdb); j.dptr; j = tdb_nextkey(tdb, j)) {
			...
			}
		   }

       If such behaviour is desired, use tdb_traverse instead.

RETURN VALUE

       If  the	call  succeeds, then a TDB_DATA structure is returned with the dptr structure filled in. If the call fails or you have reached the
       end of the database then dptr will be set to NULL.

       NOTE: The caller is responsible for freeing the data pointed to by dptr

AUTHORS

       Software: Andrew Tridgell <tridge@linuxcare.com> and Luke Kenneth Casson Leighton Man page: Ben Woodard <ben@valinux.com>

SEE ALSO

       gdbm(3), tdb(3)

Samba								   Aug 16, 2000 						   TDB_FIRSTKEY(3)

Linux and UNIX Man Pages

tdbbackup(8) [osx man page]

Check Out this Related Man Page