From 6c2e58987bcb3b5fe527f7f6743c549ed6c0c877 Mon Sep 17 00:00:00 2001 From: John Terpstra Date: Thu, 25 Aug 2005 16:49:40 +0000 Subject: Formatting and other fixes to man pages. (This used to be commit 411025ed0d6ba37ff00f4afc8ccdc9dae94b62e0) --- docs/smbdotconf/logon/adduserscript.xml | 64 ++++++++++++++++++--------------- 1 file changed, 35 insertions(+), 29 deletions(-) (limited to 'docs/smbdotconf/logon/adduserscript.xml') diff --git a/docs/smbdotconf/logon/adduserscript.xml b/docs/smbdotconf/logon/adduserscript.xml index 1dd71b3867..8f50bc0a69 100644 --- a/docs/smbdotconf/logon/adduserscript.xml +++ b/docs/smbdotconf/logon/adduserscript.xml @@ -4,39 +4,45 @@ advanced="1" developer="1" xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> - This is the full pathname to a script that will - be run AS ROOT by smbd - 8 under special circumstances described below. + + This is the full pathname to a script that will be run AS ROOT by + smbd 8 + under special circumstances described below. + - Normally, a Samba server requires that UNIX users are - created for all users accessing files on this server. For sites - that use Windows NT account databases as their primary user database - creating these users and keeping the user list in sync with the - Windows NT PDC is an onerous task. This option allows smbd to create the required UNIX users - ON DEMAND when a user accesses the Samba server. + + Normally, a Samba server requires that UNIX users are created for all users accessing + files on this server. For sites that use Windows NT account databases as their primary + user database creating these users and keeping the user list in sync with the Windows + NT PDC is an onerous task. This option allows smbd to create the required UNIX users + ON DEMAND when a user accesses the Samba server. + - In order to use this option, smbd - 8 must NOT be set to security = share - and add user script - must be set to a full pathname for a script that will create a UNIX - user given one argument of %u, which expands into - the UNIX user name to create. + + In order to use this option, smbd + 8 must NOT be set to + share and + must be set to a full pathname for a script that will create a UNIX user given one argument of + %u, which expands into the UNIX user name to create. + - When the Windows user attempts to access the Samba server, - at login (session setup in the SMB protocol) time, smbd - 8 contacts the password server and - attempts to authenticate the given user with the given password. If the - authentication succeeds then smbd - attempts to find a UNIX user in the UNIX password database to map the - Windows user into. If this lookup fails, and add user script - is set then smbd will - call the specified script AS ROOT, expanding - any %u argument to be the user name to create. + + When the Windows user attempts to access the Samba server, at login (session setup in + the SMB protocol) time, smbd + 8 contacts the + and attempts to authenticate the given user with the given password. If the authentication + succeeds then smbd attempts to find a UNIX user in the UNIX + password database to map the Windows user into. If this lookup fails, and + is set then smbd will + call the specified script AS ROOT, expanding any + %u argument to be the user name to create. + - If this script successfully creates the user then smbd - will continue on as though the UNIX user - already existed. In this way, UNIX users are dynamically created to - match existing Windows NT accounts. + + If this script successfully creates the user then smbd will + continue on as though the UNIX user already existed. In this way, UNIX users are dynamically created to + match existing Windows NT accounts. + See also , , -- cgit