diff options
Diffstat (limited to 'databases/tdb1410/files/tdbbackup.8')
-rw-r--r-- | databases/tdb1410/files/tdbbackup.8 | 129 |
1 files changed, 129 insertions, 0 deletions
diff --git a/databases/tdb1410/files/tdbbackup.8 b/databases/tdb1410/files/tdbbackup.8 new file mode 100644 index 000000000000..92f510aecccf --- /dev/null +++ b/databases/tdb1410/files/tdbbackup.8 @@ -0,0 +1,129 @@ +'\" t +.\" Title: tdbbackup +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 2015-04-25 +.\" Manual: System Administration tools +.\" Source: Samba 3.6 +.\" Language: English +.\" +.TH "TDBBACKUP" "8" "2015\-04\-25" "Samba 3\&.6" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +tdbbackup \- tool for backing up and for validating the integrity of samba \&.tdb files +.SH "SYNOPSIS" +.HP \w'\fBtdbbackup\fR\ 'u +\fBtdbbackup\fR [\-s\ suffix] [\-v] [\-h] [\-l] +.SH "DESCRIPTION" +.PP +This tool is part of the +\fBsamba\fR(1) +suite\&. +.PP +\fBtdbbackup\fR +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\&. +.SH "OPTIONS" +.PP +\-h +.RS 4 +Get help information\&. +.RE +.PP +\-s suffix +.RS 4 +The +\fB\-s\fR +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\&. +.RE +.PP +\-v +.RS 4 +The +\fB\-v\fR +will check the database for damages (corrupt data) which if detected causes the backup to be restored\&. +.RE +.PP +\-l +.RS 4 +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 locking\&. +.RE +.SH "COMMANDS" +.PP +\fIGENERAL INFORMATION\fR +.PP +The +\fBtdbbackup\fR +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: +.PP +tdbbackup [\-s suffix] *\&.tdb +.PP +Before restarting samba the following command may be run to validate \&.tdb files: +.PP +tdbbackup \-v [\-s suffix] *\&.tdb +.PP +Samba \&.tdb files are stored in various locations, be sure to run backup all \&.tdb file on the system\&. Important files includes: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBsecrets\&.tdb\fR +\- usual location is in the /usr/local/samba/private directory, or on some systems in /etc/samba\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fBpassdb\&.tdb\fR +\- usual location is in the /usr/local/samba/private directory, or on some systems in /etc/samba\&. +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} + +\fB*\&.tdb\fR +located in the /usr/local/samba/var directory or on some systems in the /var/cache or /var/lib/samba directories\&. +.RE +.SH "VERSION" +.PP +This man page is correct for version 3 of the Samba suite\&. +.SH "AUTHOR" +.PP +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\&. +.PP +The tdbbackup man page was written by John H Terpstra\&. |