[SCM] Samba Shared Repository - branch v3-2-stable updated -
release-3-2-0rc2-53-g62e485e
Karolin Seeger
kseeger at samba.org
Mon Jun 23 08:29:18 GMT 2008
The branch, v3-2-stable has been updated
via 62e485eebd8a40b5692caa79bb3ed6108f0b835b (commit)
via 9fd1d784cf6044c5c03cf7ab0f2373e08df64295 (commit)
via e4d03d3aede0cd611283a041eafdcd1e836aad33 (commit)
via a7531f4964ac8f861a41e9fa446e5a3aa69eaaa2 (commit)
via 8522db2075f8c9e869c6224f2852ce355bba987d (commit)
via 59bb2b0c9a6397bb0202055d7b00dce30d7bf03b (commit)
from 92912142993bb2b6b9203ad70343dd299c20f6bc (commit)
http://gitweb.samba.org/?p=samba.git;a=shortlog;h=v3-2-stable
- Log -----------------------------------------------------------------
commit 62e485eebd8a40b5692caa79bb3ed6108f0b835b
Author: Karolin Seeger <kseeger at samba.org>
Date: Mon Jun 23 10:15:53 2008 +0200
Samba3 HOWTO: Remove trailing whitespaces.
Karolin
(cherry picked from commit c7a9c903acbba9c70211e6f3c25964533bbc1622)
commit 9fd1d784cf6044c5c03cf7ab0f2373e08df64295
Author: Karolin Seeger <kseeger at samba.org>
Date: Mon Jun 23 10:28:09 2008 +0200
man pages: Correct version in man winbindd again.
Karolin
(cherry picked from commit ef44968276bfde2fdd3370e2558fb469357414be)
commit e4d03d3aede0cd611283a041eafdcd1e836aad33
Author: John H Terpstra <jht at samba.org>
Date: Wed May 28 11:02:26 2008 -0500
Fixed publishing date info.
(cherry picked from commit b96c9d54cfd29ec87d59655839a4136977a98032)
commit a7531f4964ac8f861a41e9fa446e5a3aa69eaaa2
Author: John H Terpstra <jht at samba.org>
Date: Wed May 28 11:00:49 2008 -0500
Added TDB File documentation requested by some users.
(cherry picked from commit 5035311af639336fdc51fa9829e984ff281216f9)
commit 8522db2075f8c9e869c6224f2852ce355bba987d
Author: John H Terpstra <jht at samba.org>
Date: Mon May 19 13:02:08 2008 -0500
Clarification that hosts resolution is done by winbind only on IRIX, all other systems use libnss_wins.so.
(cherry picked from commit 3a8ea6be389bedbcdb5668664d862768c026f669)
commit 59bb2b0c9a6397bb0202055d7b00dce30d7bf03b
Author: John H Terpstra <jht at samba.org>
Date: Mon May 19 13:00:01 2008 -0500
Clarification that hosts resolution is done by winbind only on IRIX, all other systems use libnss_wins.so.
(cherry picked from commit 2a953d6ba252e5ba4e28b7fae5979e7c47fe9bd0)
-----------------------------------------------------------------------
Summary of changes:
docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml | 152 ++++++++++++++++++++++++++++
docs-xml/Samba3-HOWTO/index.xml | 2 +
docs-xml/manpages-3/winbindd.8.xml | 11 ++-
3 files changed, 162 insertions(+), 3 deletions(-)
create mode 100644 docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml
Changeset truncated at 500 lines:
diff --git a/docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml b/docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml
new file mode 100644
index 0000000..cc8b105
--- /dev/null
+++ b/docs-xml/Samba3-HOWTO/TOSHARG-TDBFiles.xml
@@ -0,0 +1,152 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
+<chapter id="msdfs">
+
+<chapterinfo>
+ &author.jht;
+
+ <pubdate>May 28, 2008</pubdate>
+</chapterinfo>
+
+<title>Managing TDB Files</title>
+
+<sect1>
+<title>Features and Benefits</title>
+
+ <para>
+<indexterm><primary>tdb</primary></indexterm>
+<indexterm><primary>Trivial Database</primary></indexterm>
+ Samba uses a lightweight database called Trivial Database (tdb) in which it stores persistent and transient data.
+ Some tdb files can be disposed of before restarting Samba, but others are used to store information that is vital
+ to Samba configuration and behavior. The following information is provided to help administrators who are seeking
+ to better manage their Samba installations.
+ </para>
+
+ <para>
+<indexterm><primary>tdb</primary></indexterm>
+<indexterm><primary>currupted</primary></indexterm>
+<indexterm><primary>backup</primary></indexterm>
+<indexterm><primary>restore</primary></indexterm>
+ Those who package Samba for commercial distribution with operating systems and appliances would do well to take
+ note that tdb files can get corrupted, and for this reason ought to be backed up regularly. An appropriate time
+ is at system shutdown (backup) and startup (restore from backup).
+ </para>
+
+<table frame="all" id="TOSH-TDB">
+ <title>Samba's Trivial Database Files</title>
+ <tgroup align="center" cols="2">
+ <thead>
+ <row><entry>File name</entry><entry>Preserve</entry><entry>Description</entry></row>
+ </thead>
+
+ <tbody>
+ <row><entry>account_policy.tdb</entry><entry>Y</entry>
+ <entry><para>NT account policy settings such as pw expiration, etc...</para></entry></row>
+ <row><entry>brlock.tdb</entry><entry>N</entry>
+ <entry><para>Byte range locks.</para></entry></row>
+ <row><entry>browse.dat</entry><entry>N</entry>
+ <entry><para>Browse lists - gets rebuilt automatically.</para></entry></row>
+ <row><entry>connections.tdb</entry><entry>N</entry>
+ <entry><para>Share connections. Used to enforce max connections, etc.</para></entry></row>
+ <row><entry>gencache.tdb</entry><entry>N</entry>
+ <entry><para>Generic caching database.</para></entry></row>
+ <row><entry>group_mapping.tdb</entry><entry>Y</entry>
+ <entry><para>Stores group mapping information. Not used when using LDAP backend.</para></entry></row>
+ <row><entry> lang_en.tdb</entry><entry>Y</entry>
+ <entry><para>Stores language encoding information.</para></entry></row>
+ <row><entry>locking.tdb</entry><entry>N</entry>
+ <entry><para>Stores share mode and oplock information.</para></entry></row>
+ <row><entry>login_cache.tdb</entry><entry>N</entry>
+ <entry><para>Keeps a log of bad pw attempts.</para></entry></row>
+ <row><entry>messages.tdb</entry><entry>N</entry>
+ <entry><para>Used to keep track of Samba internal messaging.</para></entry></row>
+ <row><entry>netsamlogon_cache.tdb</entry><entry>Y</entry>
+ <entry><para>
+ Cache of user net_info_3 struct from <emphasis>net_samlogon()</emphasis>
+ requests from domain member machines.
+ </para></entry></row>
+ <row><entry>ntdrivers.tdb</entry><entry>Y</entry>
+ <entry><para>Stores installed printer driver information.</para></entry></row>
+ <row><entry>ntforms.tdb</entry><entry>Y</entry>
+ <entry><para>Stores installed printer forms information.</para></entry></row>
+ <row><entry>ntprinters.tdb</entry><entry>Y</entry>
+ <entry><para>Stores installed printers information.</para></entry></row>
+ <row><entry>printing directory</entry><entry>Y</entry>
+ <entry><para>Directory containing tdb per print queue of cached lpq output.</para></entry></row>
+ <row><entry>registry.tdb</entry><entry>Y</entry>
+ <entry><para>Windows registry skeleton (connect via regedit.exe).</para></entry></row>
+ <row><entry>sessionid.tdb</entry><entry>N</entry>
+ <entry><para>Session information to support <literal>utmp = yes</literal> capabilities.</para></entry></row>
+ <row><entry>share_info.tdb</entry><entry>Y</entry>
+ <entry><para>Stores share-level ACL configuration settings.
+ Default ACL is <emphasis>Everyone - Full Control</emphasis>.
+ </para></entry></row>
+ <row><entry>unexpected.tdb</entry><entry>N</entry>
+ <entry><para>
+ Unexpected packet queue needed to support windows clients that respond on a
+ different port that the originating reques.
+ </para></entry></row>
+ <row><entry>winbindd_cache.tdb</entry><entry>N</entry>
+ <entry><para>Winbind's cache of user lists.</para></entry></row>
+ <row><entry>winbindd_idmap.tdb</entry><entry>Y</entry>
+ <entry><para>Winbind's local IDMAP database.</para></entry></row>
+ <row><entry>wins.dat</entry><entry>N</entry>
+ <entry><para>
+ WINS database iused only when <parameter>wins support = yes</parameter>
+ has been set. This gets rebuilt or updated at every restart.
+ </para></entry></row>
+ <row><entry>wins.tdb</entry><entry>Y</entry>
+ <entry><para>
+ The working permanent storage for all WINS data. This database is used only
+ when <parameter>wins support = yes</parameter> has been set in the &smb.conf; file.
+ Note: This retains all manually configured WINS entries. Manual setting can be done use the net utility.
+ </para></entry></row>
+ <row><entry>secrets.tdb</entry><entry>Y</entry>
+ <entry><para>
+ This tdb file stores internal settings such as the machine and the domain SID, secret passwords
+ that are used with LDAP, the machine secret token, etc. This is an essential file that is stored
+ in a secure area. Vendors locate this in various folders. Check <command>smbd -b</command> to
+ find its location on your system.
+ </para></entry></row>
+ <row><entry>schannel_store.tdb</entry><entry>Y</entry>
+ <entry><para>
+ This stores secure channel access token information used with SMB signing.
+ </para></entry></row>
+ <row><entry>passdb.tdb</entry><entry>Y</entry>
+ <entry><para>
+ This stores the Samba SAM account information when using a tdbsam password backend.
+ </para></entry></row>
+ </tbody>
+ </tgroup>
+ </table>
+
+</sect1>
+
+<sect1>
+<title>Managing TDB Files</title>
+
+ <para>
+ The <command>tdbbackup</command> utility 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 it will search for a prior backup the backup
+ file from which the damaged tdb file will be restored. The <command>tdbbackup</command>
+ 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.
+ </para>
+
+ <para>
+ It is recommended to backup all tdb files as part of the Samba start-up scripts on a Samba
+ server. The following command syntax can be used:
+ </para>
+<screen>
+myserver# > cd /var/lib/samba
+myserver@ > tdbbackup *.tdb
+</screen>
+ <para>
+ The default extension is <filename>.bak</filename>. Any alternate extension can be specified
+ by executing <literal>tdbbackup -s 'new_extension' *.tdb</literal> as part of your startup script.
+ </para>
+
+</sect1>
+
+</chapter>
diff --git a/docs-xml/Samba3-HOWTO/index.xml b/docs-xml/Samba3-HOWTO/index.xml
index 1253b03..87b0795 100644
--- a/docs-xml/Samba3-HOWTO/index.xml
+++ b/docs-xml/Samba3-HOWTO/index.xml
@@ -193,6 +193,8 @@ The chapters in this part each cover specific Samba features.
<?latex \cleardoublepage ?>
<xi:include href="TOSHARG-Bugs.xml"/>
<?latex \cleardoublepage ?>
+ <xi:include href="TOSHARG-TDBFiles.xml"/>
+ <?latex \cleardoublepage ?>
</part>
diff --git a/docs-xml/manpages-3/winbindd.8.xml b/docs-xml/manpages-3/winbindd.8.xml
index 8e981fd..a449096 100644
--- a/docs-xml/manpages-3/winbindd.8.xml
+++ b/docs-xml/manpages-3/winbindd.8.xml
@@ -119,12 +119,17 @@
resolve user and group information from <filename>/etc/passwd
</filename> and <filename>/etc/group</filename> and then from the
Windows NT server.
+ </para>
+
<programlisting>
passwd: files winbind
group: files winbind
-## only available on IRIX; Linux users should us libnss_wins.so
-hosts: files dns winbind
-</programlisting></para>
+## only available on IRIX: use winbind to resolve hosts:
+# hosts: files dns winbind
+## All other NSS enabled systems should use libnss_wins.so like this:
+hosts: files dns wins
+
+</programlisting>
<para>The following simple configuration in the
<filename>/etc/nsswitch.conf</filename> file can be used to initially
--
Samba Shared Repository
More information about the samba-cvs
mailing list