Changeset View
Changeset View
Standalone View
Standalone View
files/man/tdbbackup.8
Property | Old Value | New Value |
---|---|---|
svn:eol-style | null | native \ No newline at end of property |
svn:keywords | null | FreeBSD=%H \ No newline at end of property |
svn:mime-type | null | text/plain \ No newline at end of property |
'\" 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\&. |