Initial import
[samba] / docs / manpages / tdbbackup.8
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "TDBBACKUP" 8 "" "" ""
21 .SH NAME
22 tdbbackup \- tool for backing up and for validating the integrity of samba .tdb files
23 .SH "SYNOPSIS"
24 .ad l
25 .hy 0
26 .HP 10
27 \fBtdbbackup\fR [\-s\ suffix] [\-v] [\-h]
28 .ad
29 .hy
30
31 .SH "DESCRIPTION"
32
33 .PP
34 This tool is part of the \fBsamba\fR(1) suite\&.
35
36 .PP
37 \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\&.
38
39 .SH "OPTIONS"
40
41 .TP
42 \-h
43 Get help information\&.
44
45 .TP
46 \-s suffix
47 The \fB\-s\fR 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\&.
48
49 .TP
50 \-v
51 The \fB\-v\fR will check the database for damages (currupt data) which if detected causes the backup to be restored\&.
52
53 .SH "COMMANDS"
54
55 .PP
56 \fBGENERAL INFORMATION\fR
57
58 .PP
59 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:
60
61 .PP
62 tdbbackup [\-s suffix] *\&.tdb
63
64 .PP
65 Before restarting samba the following command may be run to validate \&.tdb files:
66
67 .PP
68 tdbbackup \-v [\-s suffix] *\&.tdb
69
70 .PP
71 Samba \&.tdb files are stored in various locations, be sure to run backup all \&.tdb file on the system\&. Important files includes:
72
73 .TP 3
74 \(bu
75 \fBsecrets\&.tdb\fR \- usual location is in the /usr/local/samba/private directory, or on some systems in /etc/samba\&.
76 .TP
77 \(bu
78 \fBpassdb\&.tdb\fR \- usual location is in the /usr/local/samba/private directory, or on some systems in /etc/samba\&.
79 .TP
80 \(bu
81 \fB*\&.tdb\fR located in the /usr/local/samba/var directory or on some systems in the /var/cache or /var/lib/samba directories\&.
82 .LP
83
84 .SH "VERSION"
85
86 .PP
87 This man page is correct for version 3\&.0 of the Samba suite\&.
88
89 .SH "AUTHOR"
90
91 .PP
92 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\&.
93
94 .PP
95 The tdbbackup man page was written by John H Terpstra\&.
96