From 8ec5eb4930e835b75ae29fb6a047cd64c7a0f2c0 Mon Sep 17 00:00:00 2001 From: John Terpstra Date: Sat, 26 Apr 2003 19:26:25 +0000 Subject: Adding tdbbackup manpage to Makefile, fix typos, fix incorrect syntax on author entry. (This used to be commit 144d0f5996224edc58d66379214b6e1508f57526) --- docs/docbook/Makefile.in | 2 +- docs/docbook/manpages/tdbbackup.8.sgml | 19 +++++++++++-------- docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml | 2 +- 3 files changed, 13 insertions(+), 10 deletions(-) (limited to 'docs/docbook') diff --git a/docs/docbook/Makefile.in b/docs/docbook/Makefile.in index ce3d009f6c..d55d2daaec 100644 --- a/docs/docbook/Makefile.in +++ b/docs/docbook/Makefile.in @@ -21,7 +21,7 @@ MANPAGES_NAMES=findsmb.1 smbclient.1 \ smbpasswd.8 testprns.1 \ smb.conf.5 wbinfo.1 pdbedit.8 \ smbcacls.1 smbsh.1 winbindd.8 \ - vfstest.1 \ + tdbbackup.8 vfstest.1 \ profiles.1 smbtree.1 ntlm_auth.1 \ editreg.1 smbcquotas.1 diff --git a/docs/docbook/manpages/tdbbackup.8.sgml b/docs/docbook/manpages/tdbbackup.8.sgml index 25b2c27aef..31aa103e81 100644 --- a/docs/docbook/manpages/tdbbackup.8.sgml +++ b/docs/docbook/manpages/tdbbackup.8.sgml @@ -42,27 +42,30 @@ + + -h + + Get help information. + + + -s suffix - The -s option allows the adminisistrator to specify a file + 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. - &stdarg.help; - -v - The -v will check the database for damages (currupt data) + The -v will check the database for damages (currupt data) which if detected causes the backup to be restored. - &popt.common.samba; - @@ -88,8 +91,9 @@ Samba .tdb files are stored in various locations, be sure to run backup all .tdb file on the system. Imporatant files includes: + - + secrets.tdb - usual location is in the /usr/local/samba/private directory, or on some systems in /etc/samba. @@ -104,7 +108,6 @@ *.tdb located in the /usr/local/samba/var directory or on some systems in the /var/cache or /var/lib/samba directories. - diff --git a/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml b/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml index 7250bca824..af6ddff9bf 100644 --- a/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml +++ b/docs/docbook/projdoc/GROUP-MAPPING-HOWTO.sgml @@ -3,8 +3,8 @@ Jean FrançoisMicouleau - &author.jerry; + &author.jerry; Configuring Group Mapping -- cgit From c89d1d71c14a772e6aa0b7f3db947474bf37fa7b Mon Sep 17 00:00:00 2001 From: John Terpstra Date: Sat, 26 Apr 2003 19:45:30 +0000 Subject: Patch from Vorlon. (This used to be commit c5ca926f8fae2d725b56d252b5944e9f96065cb6) --- docs/docbook/projdoc/PAM-Authentication-And-Samba.sgml | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) (limited to 'docs/docbook') diff --git a/docs/docbook/projdoc/PAM-Authentication-And-Samba.sgml b/docs/docbook/projdoc/PAM-Authentication-And-Samba.sgml index 9f03f98b5f..90a07a13bd 100644 --- a/docs/docbook/projdoc/PAM-Authentication-And-Samba.sgml +++ b/docs/docbook/projdoc/PAM-Authentication-And-Samba.sgml @@ -211,16 +211,10 @@ For more information on PAM, see http://ftp.kernel.org/pub/linux/libs/pam/ This module authenticates a local smbpasswd user database. If you require support for authenticating against a remote SMB server, or if you're concerned about the presence of suid root binaries on your system, it is -recommended that you use one of the other two following modules +recommended that you use pam_winbind instead. - pam_smb - http://www.csn.ul.ie/~airlied/pam_smb/ - authenticates against any remote SMB server - - pam_ntdom - ftp://ftp.samba.org/pub/samba/pam_ntdom/ - authenticates against an NT or Samba domain controller - Options recognized by this module are as follows: debug - log more debugging info -- cgit From d2fd4707ab6c53d1dd886c6ec189163d12c8ce8b Mon Sep 17 00:00:00 2001 From: John Terpstra Date: Sat, 26 Apr 2003 20:40:13 +0000 Subject: Fixed typo - tdbbackup is man sect 8 not 1 (This used to be commit 451f32f1fadbe3474e3e52a21ce77c23d106d03b) --- docs/docbook/manpages/tdbbackup.8.sgml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/docbook') diff --git a/docs/docbook/manpages/tdbbackup.8.sgml b/docs/docbook/manpages/tdbbackup.8.sgml index 31aa103e81..9b885e0af7 100644 --- a/docs/docbook/manpages/tdbbackup.8.sgml +++ b/docs/docbook/manpages/tdbbackup.8.sgml @@ -1,11 +1,11 @@ %globalentities; ]> - + tdbbackup - 1 + 8 -- cgit From dcd2dcd05fa8fc877b409dbc669c83e55218df7a Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Sun, 27 Apr 2003 14:03:48 +0000 Subject: Remove documentation for unixsam and plugin. (This used to be commit fa7b703da7bba9cf7daf61039fb495e72fbf7a13) --- docs/docbook/manpages/smb.conf.5.sgml | 29 +++--------------- docs/docbook/smbdotconf/security/passdbbackend.xml | 34 +++------------------- 2 files changed, 8 insertions(+), 55 deletions(-) (limited to 'docs/docbook') diff --git a/docs/docbook/manpages/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml index fa61121f4b..3e98d3f25f 100644 --- a/docs/docbook/manpages/smb.conf.5.sgml +++ b/docs/docbook/manpages/smb.conf.5.sgml @@ -5477,34 +5477,13 @@ df $1 | tail -1 | awk '{print $2" "$4}' nisplussam - The NIS+ based passdb backend. Takes name NIS domain as an optional argument. Only works with sun NIS+ servers. - plugin - Allows Samba to load an - arbitary passdb backend from the .so specified as a compulsary argument. - - - Any characters after the (optional) second : are passed to the plugin - for its own processing - - - unixsam - Allows samba to map all (other) available unix users - - This backend uses the standard unix database for retrieving users. Users included - in this pdb are NOT listed in samba user listings and users included in this pdb won't be - able to login. The use of this backend is to always be able to display the owner of a file - on the samba server - even when the user doesn't have a 'real' samba account in one of the - other passdb backends. - - - This backend should always be the last backend listed, since it contains all users in - the unix passdb and might 'override' mappings if specified earlier. It's meant to only return - accounts for users that aren't covered by the previous backends. - - Default: passdb backend = smbpasswd unixsam - Example: passdb backend = tdbsam:/etc/samba/private/passdb.tdb smbpasswd:/etc/samba/smbpasswd unixsam - Example: passdb backend = ldapsam_nua:ldaps://ldap.example.com unixsam - Example: passdb backend = plugin:/usr/local/samba/lib/my_passdb.so:my_plugin_args tdbsam:/etc/samba/private/passdb.tdb + Default: passdb backend = smbpasswd guest + Example: passdb backend = tdbsam:/etc/samba/private/passdb.tdb smbpasswd:/etc/samba/smbpasswd guest + Example: passdb backend = ldapsam_nua:ldaps://ldap.example.com guest + Example: passdb backend = mysql:my_plugin_args tdbsam:/etc/samba/private/passdb.tdb diff --git a/docs/docbook/smbdotconf/security/passdbbackend.xml b/docs/docbook/smbdotconf/security/passdbbackend.xml index 256b6c9709..d755cfc313 100644 --- a/docs/docbook/smbdotconf/security/passdbbackend.xml +++ b/docs/docbook/smbdotconf/security/passdbbackend.xml @@ -9,8 +9,7 @@ smbpasswd and tdbsam to be used without a recompile. Multiple backends can be specified, separated by spaces. The backends will be searched in the order they are specified. New users are always added - to the first backend specified. Experimental backends must still be - selected (eg --with-tdbsam) at configure time. + to the first backend specified. This parameter is in two parts, the backend's name, and a 'location' string that has meaning only to that particular backed. These are separated @@ -79,41 +78,16 @@ an optional argument. Only works with sun NIS+ servers. - - - plugin - Allows Samba to load an - arbitary passdb backend from the .so specified as a compulsary argument. - - - Any characters after the (optional) second : are passed to the plugin - for its own processing - - - - unixsam - Allows samba to map all (other) - available unix users - This backend uses the standard unix database for retrieving users. Users included - in this pdb are NOT listed in samba user listings and users included in this pdb won't be - able to login. The use of this backend is to always be able to display the owner of a file - on the samba server - even when the user doesn't have a 'real' samba account in one of the - other passdb backends. - - - This backend should always be the last backend listed, since it contains all users in - the unix passdb and might 'override' mappings if specified earlier. It's meant to only return - accounts for users that aren't covered by the previous backends. - - Default: passdb backend = smbpasswd unixsam - Example: passdb backend = tdbsam:/etc/samba/private/passdb.tdb smbpasswd:/etc/samba/smbpasswd unixsam + Example: passdb backend = tdbsam:/etc/samba/private/passdb.tdb smbpasswd:/etc/samba/smbpasswd guest - Example: passdb backend = ldapsam_nua:ldaps://ldap.example.com unixsam + Example: passdb backend = ldapsam_nua:ldaps://ldap.example.com guest - Example: passdb backend = plugin:/usr/local/samba/lib/my_passdb.so:my_plugin_args tdbsam:/etc/samba/private/passdb.tdb + Example: passdb backend = mysql:my_plugin_args tdbsam:/etc/samba/private/passdb.tdb -- cgit From 4f6e82c669da87680c5125a480ad80fd9db74c14 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Sun, 27 Apr 2003 21:46:35 +0000 Subject: Document 'nmblookup -M -- -' (This used to be commit 3df125fd50a5efff97535814f1f4fd9f33dd07e5) --- docs/docbook/manpages/nmblookup.1.sgml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'docs/docbook') diff --git a/docs/docbook/manpages/nmblookup.1.sgml b/docs/docbook/manpages/nmblookup.1.sgml index 176050b9c8..b4a96e96ba 100644 --- a/docs/docbook/manpages/nmblookup.1.sgml +++ b/docs/docbook/manpages/nmblookup.1.sgml @@ -58,7 +58,10 @@ up the NetBIOS name name with a type of 0x1d. If name is "-" then it does a lookup on the special name - __MSBROWSE__. + __MSBROWSE__. Please note that in order to + use the name "-", you need to make sure "-" isn't parsed as an + argument, e.g. use : + nmblookup -M -- -. -- cgit From ecde8fcf7a1cd692562bf75dd44cd8d063f0f8c4 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Mon, 28 Apr 2003 13:07:29 +0000 Subject: Use entities and add overview of directories (This used to be commit 5957e3bf33e8992eda620a6ab0b4f8a1dbe8cb7a) --- docs/docbook/devdoc/Tracing.sgml | 7 +---- docs/docbook/devdoc/architecture.sgml | 53 +++++++++++++++++++++++++++++++++++ docs/docbook/devdoc/dev-doc.sgml | 2 ++ docs/docbook/devdoc/encryption.sgml | 11 +------- docs/docbook/devdoc/gencache.sgml | 4 +-- docs/docbook/devdoc/modules.sgml | 8 +----- docs/docbook/devdoc/packagers.sgml | 4 +-- docs/docbook/devdoc/printing.sgml | 4 +-- docs/docbook/devdoc/rpc_plugin.sgml | 8 +----- docs/docbook/devdoc/sam.sgml | 3 ++ docs/docbook/devdoc/unix-smb.sgml | 4 +-- docs/docbook/devdoc/wins.sgml | 4 +-- 12 files changed, 67 insertions(+), 45 deletions(-) (limited to 'docs/docbook') diff --git a/docs/docbook/devdoc/Tracing.sgml b/docs/docbook/devdoc/Tracing.sgml index ccf1e1c3c8..f55c47bc4e 100644 --- a/docs/docbook/devdoc/Tracing.sgml +++ b/docs/docbook/devdoc/Tracing.sgml @@ -1,11 +1,6 @@ - - AndrewTridgell - - Samba Team - - + &author.tridge; Tracing samba system calls diff --git a/docs/docbook/devdoc/architecture.sgml b/docs/docbook/devdoc/architecture.sgml index 312a63af97..e05039054b 100644 --- a/docs/docbook/devdoc/architecture.sgml +++ b/docs/docbook/devdoc/architecture.sgml @@ -4,6 +4,7 @@ DanShearer November 1997 + &author.jelmer; Samba Architecture @@ -181,4 +182,56 @@ for browsing and WINS support. + + +Samba's subsystems + +Samba's source/ directory contains quite some directories. Here's a small explanation of what each of them contains. + + +aparser - Obsolete +auth - The authentication subsystem, maintained by Andrew Bartlett +bin - Output directory for all the binary files +client - Contains 'plain' SMB client sources: smbclient and +some mount help utilities +groupdb - Group database and mapping code +include - All of samba's include files +intl - Internationalization files. Not used at the moment. +lib - General C helper functions. Not SMB-specific. +libads - Library with ActiveDirectory related functions. +libsmb - Library with SMB specific functions. +locking - Locking functions! +modules - Source files for various modules (VFS and charset). +msdfs - DCE-DFS code +nmbd - Code for the nmbd daemon +nsswitch - Winbind source code +pam_smbpass - Source code for pam module for authenticating against samba's passdb +param - smb.conf parsing code +passdb - User database(SAM) code with the various backends +po - Internationalisation code - not used atm +popt - Samba's internal copy of the popt library +printing - Printing stuff +profile - Profiling support +python - Python bindings for various libsmb functions +registry - Registry backend +rpc_client - RPC Client library for making remote procedure calls +rpc_parse - Functions for parsing RPC structures (???) +rpc_server - Functions for being an RPC server +rpcclient - Command-line client that is a basically a front-end to rpc_client/ +sam - Code for the new (but unused) SAM +script - Various scripts +smbd - Source code for the smbd daemon +smbwrapper - Source code for library that overloads VFS function calls, for usage with LD_PRELOAD=... +stf - Testsuite system? +tdb - Source code of samba's Trivial Database (much like gdbm) +tests - Source code for the larger tests used by configure +torture - 'Torture' utilities, used for testing samba and other cifs servers +ubiqx - The ubiqx library from Chris Hertel +utils - Various small utilities(pdbedit, net, etc) +web - SWAT sourcecode +wrepld - Sourcecode of the WINS replication daemon + + + + diff --git a/docs/docbook/devdoc/dev-doc.sgml b/docs/docbook/devdoc/dev-doc.sgml index 5e1af3d3a0..ee2a40535d 100644 --- a/docs/docbook/devdoc/dev-doc.sgml +++ b/docs/docbook/devdoc/dev-doc.sgml @@ -1,4 +1,5 @@ %globalentities; @@ -26,6 +27,7 @@ SAMBA Team
samba@samba.org
+ &person.jelmer; diff --git a/docs/docbook/devdoc/encryption.sgml b/docs/docbook/devdoc/encryption.sgml index 3ca8aa109c..64ff4262cb 100644 --- a/docs/docbook/devdoc/encryption.sgml +++ b/docs/docbook/devdoc/encryption.sgml @@ -2,16 +2,7 @@ - - JeremyAllison - - Samba Team -
- samba@samba.org -
- - - + &author.jeremy; 19 Apr 1999 diff --git a/docs/docbook/devdoc/gencache.sgml b/docs/docbook/devdoc/gencache.sgml index 1ba2f77c9d..096bdce789 100644 --- a/docs/docbook/devdoc/gencache.sgml +++ b/docs/docbook/devdoc/gencache.sgml @@ -1,8 +1,6 @@ - - RafalSzczesniak - + &author.mimir; April 2003 diff --git a/docs/docbook/devdoc/modules.sgml b/docs/docbook/devdoc/modules.sgml index 0bcdadc66c..c43e8a9118 100644 --- a/docs/docbook/devdoc/modules.sgml +++ b/docs/docbook/devdoc/modules.sgml @@ -1,12 +1,6 @@ - - JelmerVernooij - - Samba Team -
jelmer@samba.org
- - + &author.jelmer; 19 March 2003 diff --git a/docs/docbook/devdoc/packagers.sgml b/docs/docbook/devdoc/packagers.sgml index fb47c7305c..edc581cf05 100644 --- a/docs/docbook/devdoc/packagers.sgml +++ b/docs/docbook/devdoc/packagers.sgml @@ -1,8 +1,6 @@ - - JelmerVernooij - + &author.jelmer; Notes to packagers diff --git a/docs/docbook/devdoc/printing.sgml b/docs/docbook/devdoc/printing.sgml index 363b9fb6e5..150652ac37 100644 --- a/docs/docbook/devdoc/printing.sgml +++ b/docs/docbook/devdoc/printing.sgml @@ -1,8 +1,6 @@ - - GeraldCarter - + &author.jerry; October 2002 diff --git a/docs/docbook/devdoc/rpc_plugin.sgml b/docs/docbook/devdoc/rpc_plugin.sgml index c83742a247..a2d1bd4c35 100644 --- a/docs/docbook/devdoc/rpc_plugin.sgml +++ b/docs/docbook/devdoc/rpc_plugin.sgml @@ -7,13 +7,7 @@
aliguor@us.ibm.com
- - JelmerVernooij - - Samba Team -
jelmer@samba.org
- - + &author.jelmer; January 2003 diff --git a/docs/docbook/devdoc/sam.sgml b/docs/docbook/devdoc/sam.sgml index 84c17d65e2..d4c065ca21 100644 --- a/docs/docbook/devdoc/sam.sgml +++ b/docs/docbook/devdoc/sam.sgml @@ -9,6 +9,9 @@ The Upcoming SAM System +The design as described in this document is _NOT_ the design that +made it into samba 3.0. + Security in the 'new SAM' diff --git a/docs/docbook/devdoc/unix-smb.sgml b/docs/docbook/devdoc/unix-smb.sgml index d6a658089c..eea02012e0 100644 --- a/docs/docbook/devdoc/unix-smb.sgml +++ b/docs/docbook/devdoc/unix-smb.sgml @@ -1,8 +1,6 @@ - - AndrewTridgell - + &author.tridge; April 1995 diff --git a/docs/docbook/devdoc/wins.sgml b/docs/docbook/devdoc/wins.sgml index 53410316c5..5cdf760406 100644 --- a/docs/docbook/devdoc/wins.sgml +++ b/docs/docbook/devdoc/wins.sgml @@ -1,8 +1,6 @@ - - GeraldCarter - + &author.jerry; October 2002 -- cgit From 54c75c0c49af61cb29fc519b3adbebbf09e659dc Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Mon, 28 Apr 2003 13:31:10 +0000 Subject: Bugs should go into bugzilla! (This used to be commit b295c3ac5ecb265b73d3ed0d5210c33ce4107c8a) --- docs/docbook/projdoc/Bugs.sgml | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) (limited to 'docs/docbook') diff --git a/docs/docbook/projdoc/Bugs.sgml b/docs/docbook/projdoc/Bugs.sgml index e7ebde788b..d782920457 100644 --- a/docs/docbook/projdoc/Bugs.sgml +++ b/docs/docbook/projdoc/Bugs.sgml @@ -15,10 +15,7 @@ Introduction - -The email address for bug reports for stable releases is samba@samba.org. -Bug reports for alpha releases should go to samba-technical@samba.org. - +Please report bugs using bugzilla. Please take the time to read this file before you submit a bug -- cgit