From 83faad0d0e0006d695af25c04c4526e02c39ad46 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Tue, 12 Aug 2003 23:45:58 +0000 Subject: Conform better to the specs (This used to be commit 412934e6d006697426e7adbcc686a5ab2b62742b) --- docs/docbook/projdoc/AccessControls.xml | 21 +++++++++++---------- docs/docbook/projdoc/Backup.xml | 2 -- docs/docbook/projdoc/CUPS-printing.xml | 2 +- docs/docbook/projdoc/DOMAIN_MEMBER.xml | 9 +++++---- docs/docbook/projdoc/InterdomainTrusts.xml | 5 +++-- docs/docbook/projdoc/NT4Migration.xml | 22 +++++++++++----------- docs/docbook/projdoc/NetworkBrowsing.xml | 12 +++++++----- .../projdoc/PAM-Authentication-And-Samba.xml | 2 +- docs/docbook/projdoc/ProfileMgmt.xml | 10 +++++----- docs/docbook/projdoc/Samba-PDC-HOWTO.xml | 12 ++++++------ docs/docbook/projdoc/locking.xml | 3 ++- docs/docbook/projdoc/passdb.xml | 18 ++++++++++-------- docs/docbook/projdoc/printer_driver2.xml | 4 ---- docs/docbook/projdoc/upgrading-to-3.0.xml | 2 +- docs/docbook/projdoc/winbind.xml | 2 +- docs/docbook/xslt/expand-sambadoc.xsl | 4 ++-- 16 files changed, 66 insertions(+), 64 deletions(-) diff --git a/docs/docbook/projdoc/AccessControls.xml b/docs/docbook/projdoc/AccessControls.xml index 22a08e4d08..9789711c0e 100644 --- a/docs/docbook/projdoc/AccessControls.xml +++ b/docs/docbook/projdoc/AccessControls.xml @@ -165,11 +165,11 @@ at how Samba helps to bridge the differences. - 8.3file names Case Sensitivity + 8.3file names MS Windows file names are generally upper case if made up of 8.3 (ie: 8 character file name and 3 character extension. If longer than 8.3 file names are Case Preserving, and Case Insensitive. @@ -231,13 +231,14 @@ at how Samba helps to bridge the differences. - Linkshard - Linkssoft - Short-Cuts Links and Short-Cuts + Linkshard + Linkssoft + Short-Cuts + MS Windows make use of "links and Short-Cuts" that are actually special types of files that will redirect an attempt to execute the file to the real location of the file. UNIX knows of file and directory links, but they are entirely different from what MS Windows users are used to. @@ -404,7 +405,7 @@ Before using any of the following options please refer to the man page for &smb. User and Group Based Controls - + Control Parameter @@ -498,7 +499,7 @@ Before using any of the following options please refer to the man page for &smb.
File and Directory Permission Based Controls - + Control Parameter @@ -588,8 +589,8 @@ Before using any of the following options please refer to the man page for &smb.
Other Controls - - + + Control Parameter @@ -1169,13 +1170,13 @@ are examples taken from the mailing list in recent times. - + This is the same as doing: &prompt;chown jack /foodbar &prompt;chgrp engr /foodbar - + Now do: diff --git a/docs/docbook/projdoc/Backup.xml b/docs/docbook/projdoc/Backup.xml index b3c37aba53..bf391c5c6d 100644 --- a/docs/docbook/projdoc/Backup.xml +++ b/docs/docbook/projdoc/Backup.xml @@ -11,8 +11,6 @@ This chapter did not make it into this release. It is planned for the published release of this document. -If you have something to contribute for this section please email it to -jht@samba.org/ diff --git a/docs/docbook/projdoc/CUPS-printing.xml b/docs/docbook/projdoc/CUPS-printing.xml index e4169aeda3..3be540e886 100644 --- a/docs/docbook/projdoc/CUPS-printing.xml +++ b/docs/docbook/projdoc/CUPS-printing.xml @@ -1680,7 +1680,7 @@ specific model supports): PPD's shipped with CUPS - + PPD filePrinter typedeskjet.ppdolder HP inkjet printers and compatible diff --git a/docs/docbook/projdoc/DOMAIN_MEMBER.xml b/docs/docbook/projdoc/DOMAIN_MEMBER.xml index 94f6716e5d..9a7f2c1628 100644 --- a/docs/docbook/projdoc/DOMAIN_MEMBER.xml +++ b/docs/docbook/projdoc/DOMAIN_MEMBER.xml @@ -165,8 +165,8 @@ There are three ways to create machine trust accounts: corresponding UNIX account are created by hand. - Server Manager + Server Manager Using the MS Windows NT4 Server Manager (either from an NT4 Domain member server, or using the Nexus toolkit available from the Microsoft web site. This tool can be run from any MS Windows machine so long as the user is @@ -189,11 +189,12 @@ The first step in manually creating a machine trust account is to manually create the corresponding UNIX account in /etc/passwd. This can be done using vipw or another 'add user' command that is normally used to create new UNIX accounts. The following is an example for a Linux based Samba server: - - useradd vipw + + + &rootprompt;/usr/sbin/useradd -g 100 -d /dev/null -c "machine nickname" \ @@ -203,9 +204,9 @@ that is normally used to create new UNIX accounts. The following is an example -chpass +chpass On *BSD systems, this can be done using the chpass utility: diff --git a/docs/docbook/projdoc/InterdomainTrusts.xml b/docs/docbook/projdoc/InterdomainTrusts.xml index 1a5953f2ab..04efc6fda6 100644 --- a/docs/docbook/projdoc/InterdomainTrusts.xml +++ b/docs/docbook/projdoc/InterdomainTrusts.xml @@ -101,9 +101,10 @@ security domains in similar manner to MS Windows NT4 style domains. There are two steps to creating an interdomain trust relationship. To effect a two-way trust relationship it is necessary for each domain administrator to create a trust account for the -other domain to use in verifying security credentials. +other domain to use in verifying security credentials. Interdomain Trustscreating + Creating an NT4 Domain Trust @@ -123,12 +124,12 @@ The password needs to be typed twice (for standard confirmation). -Interdomain TrustsCompleting Completing an NT4 Domain Trust +Interdomain Trustscompleting A trust relationship will work only when the other (trusting) domain makes the appropriate connections with the trusted domain. To consummate the trust relationship the administrator will launch the Domain User Manager, from the menu select Policies, then select Trust Relationships, then click on the diff --git a/docs/docbook/projdoc/NT4Migration.xml b/docs/docbook/projdoc/NT4Migration.xml index 23924aed59..8494e06ec8 100644 --- a/docs/docbook/projdoc/NT4Migration.xml +++ b/docs/docbook/projdoc/NT4Migration.xml @@ -346,9 +346,9 @@ Minimise down-stream problems by:
Nature of the Conversion Choices - - - + + + SimpleUpgradedRedesign @@ -392,7 +392,7 @@ Minimise down-stream problems by: Samba-3 Implementation Choices - Authentication database/back end:- + Authentication database/back end: Samba-3 can use an external authentication backend: @@ -414,7 +414,7 @@ Minimise down-stream problems by: - Access Control Points:- + Access Control Points: On the Share itself - using Share ACLs On the file system - using UNIX permissions on files and directories @@ -424,7 +424,7 @@ Minimise down-stream problems by: - Policies (migrate or create new ones):- + Policies (migrate or create new ones): Using Group Policy Editor (NT4) - Watch out for Tattoo effect @@ -432,7 +432,7 @@ Minimise down-stream problems by: - User and Group Profiles:- + User and Group Profiles: Platform specific so use platform tool to change from a Local to a Roaming profile Can use new profiles tool to change SIDs (NTUser.DAT) @@ -440,14 +440,14 @@ Minimise down-stream problems by: - Logon Scripts:- + Logon Scripts: Know how they work - User and Group mapping to Unix/Linux:- + User and Group mapping to Unix/Linux: username map facility may be needed Use 'net groupmap' to connect NT4 groups to Unix groups @@ -462,7 +462,7 @@ Minimise down-stream problems by: - OS specific scripts/programs may be needed:- + OS specific scripts/programs may be needed: Add/Delete Users: Note OS limits on size of name (Linux 8 chars) NT4 up to 254 chars @@ -475,7 +475,7 @@ Minimise down-stream problems by: - Migration Tools:- + Migration Tools: Domain Control (NT4 Style) Profiles, Policies, Access Controls, Security diff --git a/docs/docbook/projdoc/NetworkBrowsing.xml b/docs/docbook/projdoc/NetworkBrowsing.xml index 3f5e7b0ec4..b5d226efed 100644 --- a/docs/docbook/projdoc/NetworkBrowsing.xml +++ b/docs/docbook/projdoc/NetworkBrowsing.xml @@ -761,9 +761,11 @@ where: a.b.c.d and e.f.g.h -LMBLocal Master Browser + + LMBLocal Master Browser Local Master Browser -is either the LMB (Local Master Browser) IP address + + is either the LMB (Local Master Browser) IP address or the broadcast address of the remote network. ie: the LMB is at 192.168.1.10, or the address could be given as 192.168.1.255 where the netmask @@ -1392,7 +1394,7 @@ are done the browse lists look like : - + SubnetBrowse MasterList @@ -1431,7 +1433,7 @@ the browse lists look like. - + SubnetBrowse MasterList @@ -1470,7 +1472,7 @@ are removed or shut off) the browse lists will look like : - + SubnetBrowse MasterList diff --git a/docs/docbook/projdoc/PAM-Authentication-And-Samba.xml b/docs/docbook/projdoc/PAM-Authentication-And-Samba.xml index bb8beb7d26..3a2a6da61e 100644 --- a/docs/docbook/projdoc/PAM-Authentication-And-Samba.xml +++ b/docs/docbook/projdoc/PAM-Authentication-And-Samba.xml @@ -685,7 +685,7 @@ Options recognized by this module are as follows: Options recognized by pam_smbpass - + debuglog more debugging infoauditlike debug, but also logs unknown usernames diff --git a/docs/docbook/projdoc/ProfileMgmt.xml b/docs/docbook/projdoc/ProfileMgmt.xml index 013566b124..ff0c90067e 100644 --- a/docs/docbook/projdoc/ProfileMgmt.xml +++ b/docs/docbook/projdoc/ProfileMgmt.xml @@ -1202,14 +1202,14 @@ The choices are: - Local profiles: - + Local profiles: I know of no registry keys that will allow auto-deletion of LOCAL profiles on log out - Roaming profiles: - + Roaming profiles: As a user logs onto the network a centrally stored profile is copied to the workstation to form a local profile. This local profile will persist (remain on the workstation disk) @@ -1225,7 +1225,7 @@ The Roaming Profile choices are: - Personal Roaming profiles - + Personal Roaming profiles These are typically stored in a profile share on a central (or conveniently located local) server. @@ -1238,12 +1238,12 @@ The Roaming Profile choices are: - Group profiles - + Group profiles These are loaded from a central profile server - Mandatory profiles - + Mandatory profiles Mandatory profiles can be created for a user as well as for any group that a user is a member of. Mandatory profiles can NOT be changed by ordinary users. Only the administrator diff --git a/docs/docbook/projdoc/Samba-PDC-HOWTO.xml b/docs/docbook/projdoc/Samba-PDC-HOWTO.xml index 62aec85f16..ae440a4ee6 100644 --- a/docs/docbook/projdoc/Samba-PDC-HOWTO.xml +++ b/docs/docbook/projdoc/Samba-PDC-HOWTO.xml @@ -28,7 +28,7 @@ that in some magical way is expected to solve all ills.
An Example Domain - +
@@ -445,7 +445,7 @@ The basic options shown above are explained as follows: - passdb backend: + passdb backend This contains all the user and group account information. Acceptable values for a PDC are: smbpasswd, tdbsam, ldapsam. The 'guest' entry provides needed @@ -457,7 +457,7 @@ The basic options shown above are explained as follows: can not effectively be distributed and therefore should not be used. - Domain Control Parameters: + Domain Control Parameters The parameters os level, preferred master, domain master, security, encrypt passwords, domain logons play a central role in assuring domain @@ -471,7 +471,7 @@ The basic options shown above are explained as follows: to do this, refer to . - Environment Parameters: + Environment Parameters The parameters logon path, logon home, logon drive, logon script are environment support settings that help to facilitate client logon operations and that help @@ -479,7 +479,7 @@ The basic options shown above are explained as follows: to the man page information for these parameters. - NETLOGON Share: + NETLOGON Share The NETLOGON share plays a central role in domain logon and domain membership support. This share is provided on all Microsoft domain controllers. It is used to provide logon @@ -487,7 +487,7 @@ The basic options shown above are explained as follows: tools that may be needed for logon processing. This is an essential share on a domain controller. - PROFILE Share: + PROFILE Share This share is used to store user desktop profiles. Eash user must have a directory at the root of this share. This directory must be write enabled for the user and must be globally read enabled. diff --git a/docs/docbook/projdoc/locking.xml b/docs/docbook/projdoc/locking.xml index 9a1ff9e8c8..17dc518226 100644 --- a/docs/docbook/projdoc/locking.xml +++ b/docs/docbook/projdoc/locking.xml @@ -985,11 +985,12 @@ so far: We are seeing lots of errors in the samba logs like: + tdb(/usr/local/samba_2.2.7/var/locks/locking.tdb): rec_read bad magic 0x4d6f4b61 at offset=36116 - + What do these mean? diff --git a/docs/docbook/projdoc/passdb.xml b/docs/docbook/projdoc/passdb.xml index 4bc2634528..5edfba7343 100644 --- a/docs/docbook/projdoc/passdb.xml +++ b/docs/docbook/projdoc/passdb.xml @@ -99,12 +99,14 @@ as follows: + + New Backends + Samba-3 introduces the following new password backend capabilities: - - New Backends + tdbsam: @@ -1140,7 +1142,7 @@ access to attrs=lmPassword,ntPassword Attributes in the sambaSamAccount objectclass (LDAP) - + sambaLMPasswordthe LANMAN password 16-byte hash stored as a character representation of a hexadecimal string. @@ -1377,7 +1379,7 @@ Refer to the logon home parameter in the &smb.conf; man page Basic smb.conf options for MySQL passdb backend - + FieldContents @@ -1410,7 +1412,7 @@ Refer to the logon home parameter in the &smb.conf; man page - + FieldTypeContents @@ -1559,10 +1561,10 @@ Refer to the logon home parameter in the &smb.conf; man page - [globals] - ... + [globals] + ... passdb backendtdbsam, smbpasswd - ... + ... diff --git a/docs/docbook/projdoc/printer_driver2.xml b/docs/docbook/projdoc/printer_driver2.xml index 656b35c608..4c2b77cf5b 100644 --- a/docs/docbook/projdoc/printer_driver2.xml +++ b/docs/docbook/projdoc/printer_driver2.xml @@ -157,9 +157,6 @@ related to printing are used in Samba. See also the &smb.conf; man page for detailed explanations: - - List of printing related parameters in Samba 3 - Global level parameters: addprinter command, deleteprinter command, disable spoolss, @@ -190,7 +187,6 @@ related to printing are used in Samba. See also the queueresume command, total print jobs. - Samba's printing support implements the Microsoft Remote Procedure diff --git a/docs/docbook/projdoc/upgrading-to-3.0.xml b/docs/docbook/projdoc/upgrading-to-3.0.xml index 2b6e461335..95411f429a 100644 --- a/docs/docbook/projdoc/upgrading-to-3.0.xml +++ b/docs/docbook/projdoc/upgrading-to-3.0.xml @@ -277,7 +277,7 @@ complete descriptions of new or modified parameters.
TDB File Descriptions - + diff --git a/docs/docbook/projdoc/winbind.xml b/docs/docbook/projdoc/winbind.xml index d800eae721..2340e93551 100644 --- a/docs/docbook/projdoc/winbind.xml +++ b/docs/docbook/projdoc/winbind.xml @@ -589,7 +589,7 @@ include the following entries in the [global] section: smb.conf for winbind set-up [global] - <...> +... separate domain and username with '+', like DOMAIN+username winbind separator+ use uids from 10000 to 20000 for domain users diff --git a/docs/docbook/xslt/expand-sambadoc.xsl b/docs/docbook/xslt/expand-sambadoc.xsl index 6c09e4a5a5..34496a91fc 100644 --- a/docs/docbook/xslt/expand-sambadoc.xsl +++ b/docs/docbook/xslt/expand-sambadoc.xsl @@ -87,14 +87,14 @@ - + # - + -- cgit