From 4235c93fe8eb638510cea376e569fe6843052fef Mon Sep 17 00:00:00 2001 From: Alexander Bokovoy Date: Wed, 9 Apr 2003 17:10:44 +0000 Subject: [PATCH] Convert Logon parameters. (This used to be commit 7766cf5e2fff429b4769e1183bce0ce560570efe) --- .../smbdotconf/logon/abortshutdownscript.xml | 31 ++++--- docs/docbook/smbdotconf/logon/addgroupscript.xml | 31 ++++--- docs/docbook/smbdotconf/logon/addmachinescript.xml | 39 ++++---- docs/docbook/smbdotconf/logon/adduserscript.xml | 99 ++++++++++---------- .../smbdotconf/logon/addusertogroupscript.xml | 34 +++---- .../docbook/smbdotconf/logon/deletegroupscript.xml | 21 +++-- .../smbdotconf/logon/deleteuserfromgroupscript.xml | 34 +++---- docs/docbook/smbdotconf/logon/deleteuserscript.xml | 43 ++++----- docs/docbook/smbdotconf/logon/domainlogons.xml | 27 +++--- docs/docbook/smbdotconf/logon/logondrive.xml | 31 ++++--- docs/docbook/smbdotconf/logon/logonhome.xml | 85 +++++++++-------- docs/docbook/smbdotconf/logon/logonpath.xml | 94 ++++++++++--------- docs/docbook/smbdotconf/logon/logonscript.xml | 83 +++++++++-------- .../smbdotconf/logon/setprimarygroupscript.xml | 40 ++++---- docs/docbook/smbdotconf/logon/shutdownscript.xml | 101 ++++++++++++--------- 15 files changed, 428 insertions(+), 365 deletions(-) rewrite docs/docbook/smbdotconf/logon/abortshutdownscript.xml (99%) rewrite docs/docbook/smbdotconf/logon/addgroupscript.xml (100%) rewrite docs/docbook/smbdotconf/logon/addmachinescript.xml (99%) rewrite docs/docbook/smbdotconf/logon/adduserscript.xml (99%) rewrite docs/docbook/smbdotconf/logon/addusertogroupscript.xml (99%) rewrite docs/docbook/smbdotconf/logon/deletegroupscript.xml (100%) rewrite docs/docbook/smbdotconf/logon/deleteuserfromgroupscript.xml (99%) rewrite docs/docbook/smbdotconf/logon/deleteuserscript.xml (99%) rewrite docs/docbook/smbdotconf/logon/domainlogons.xml (99%) rewrite docs/docbook/smbdotconf/logon/logondrive.xml (99%) rewrite docs/docbook/smbdotconf/logon/logonhome.xml (99%) rewrite docs/docbook/smbdotconf/logon/logonpath.xml (99%) rewrite docs/docbook/smbdotconf/logon/logonscript.xml (99%) rewrite docs/docbook/smbdotconf/logon/setprimarygroupscript.xml (98%) rewrite docs/docbook/smbdotconf/logon/shutdownscript.xml (89%) diff --git a/docs/docbook/smbdotconf/logon/abortshutdownscript.xml b/docs/docbook/smbdotconf/logon/abortshutdownscript.xml dissimilarity index 99% index 89fd9186bb5..e9a7dba7925 100644 --- a/docs/docbook/smbdotconf/logon/abortshutdownscript.xml +++ b/docs/docbook/smbdotconf/logon/abortshutdownscript.xml @@ -1,13 +1,18 @@ - - abort shutdown script (G) - This parameter only exists in the HEAD cvs branch - This a full path name to a script called by smbd - 8 that - should stop a shutdown procedure issued by the shutdown script. - - This command will be run as user. - - Default: None. - Example: abort shutdown script = /sbin/shutdown -c - - + + + This parameter only exists in the HEAD cvs branch + This a full path name to a script called by smbd + 8 that + should stop a shutdown procedure issued by the + shutdown script. + + This command will be run as user. + + Default: None. + + Example: abort shutdown script = /sbin/shutdown -c + + diff --git a/docs/docbook/smbdotconf/logon/addgroupscript.xml b/docs/docbook/smbdotconf/logon/addgroupscript.xml dissimilarity index 100% index 67441a16454..25906d08899 100644 --- a/docs/docbook/smbdotconf/logon/addgroupscript.xml +++ b/docs/docbook/smbdotconf/logon/addgroupscript.xml @@ -1,14 +1,17 @@ -add group script (G) - This is the full pathname to a script that will - be run AS ROOT by smbd - 8 when a new group is - requested. It will expand any - %g to the group name passed. - This script is only useful for installations using the - Windows NT domain administration tools. The script is - free to create a group with an arbitrary name to - circumvent unix group name restrictions. In that case - the script must print the numeric gid of the created - group on stdout. - - + + + This is the full pathname to a script that will be run + AS ROOT by + smbd8 + when a new group is requested. It will expand any %g to the group name passed. This + script is only useful for installations using the Windows NT + domain administration tools. The script is free to create a + group with an arbitrary name to circumvent unix group name + restrictions. In that case the script must print the numeric gid + of the created group on stdout. + + diff --git a/docs/docbook/smbdotconf/logon/addmachinescript.xml b/docs/docbook/smbdotconf/logon/addmachinescript.xml dissimilarity index 99% index fdc69c9490f..7aef54d8b0f 100644 --- a/docs/docbook/smbdotconf/logon/addmachinescript.xml +++ b/docs/docbook/smbdotconf/logon/addmachinescript.xml @@ -1,18 +1,21 @@ - - add machine script (G) - This is the full pathname to a script that will - be run by smbd - 8 when a machine is added - to it's domain using the administrator username and password method. - - This option is only required when using sam back-ends tied to the - Unix uid method of RID calculation such as smbpasswd. This option is only - available in Samba 3.0. - - Default: add machine script = <empty string> - - - Example: add machine script = /usr/sbin/adduser -n -g machines -c Machine -d /dev/null -s /bin/false %u - - - + + + This is the full pathname to a script that will be run by + smbd + 8 when a machine is added + to it's domain using the administrator username and password + method. + + This option is only required when using sam back-ends tied + to the Unix uid method of RID calculation such as smbpasswd. + This option is only available in Samba 3.0. + + Default: add machine script = <empty string> + + Example: add machine script = /usr/sbin/adduser -n -g + machines -c Machine -d /dev/null -s /bin/false %u + + diff --git a/docs/docbook/smbdotconf/logon/adduserscript.xml b/docs/docbook/smbdotconf/logon/adduserscript.xml dissimilarity index 99% index 3afea231a5d..34d3e7ea586 100644 --- a/docs/docbook/smbdotconf/logon/adduserscript.xml +++ b/docs/docbook/smbdotconf/logon/adduserscript.xml @@ -1,49 +1,50 @@ - - add user script (G) - 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. - - 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. - - 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. - - 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 - security, - password server, - delete user - script. - - Default: add user script = <empty string> - - - Example: add user script = /usr/local/samba/bin/add_user - %u - - + + + 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. + + 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. + + 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. + + 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 + security, + password server, + delete user + script. + + Default: add user script = <empty string> + + Example: add user script = /usr/local/samba/bin/add_user %u + + diff --git a/docs/docbook/smbdotconf/logon/addusertogroupscript.xml b/docs/docbook/smbdotconf/logon/addusertogroupscript.xml dissimilarity index 99% index fe8be5b5044..ed17b9c0d9e 100644 --- a/docs/docbook/smbdotconf/logon/addusertogroupscript.xml +++ b/docs/docbook/smbdotconf/logon/addusertogroupscript.xml @@ -1,16 +1,18 @@ - - add user to group script (G) - Full path to the script that will be called when - a user is added to a group using the Windows NT domain administration - tools. It will be run by smbd - 8 AS ROOT. - Any %g will be replaced with the group name and - any %u will be replaced with the user name. - - - Default: add user to group script = - - Example: add user to group script = /usr/sbin/adduser %u %g - - - + + + Full path to the script that will be called when + a user is added to a group using the Windows NT domain administration + tools. It will be run by smbd + 8 AS ROOT. + Any %g will be replaced with the group name and + any %u will be replaced with the user name. + + + Default: add user to group script = + + Example: add user to group script = /usr/sbin/adduser %u %g + + diff --git a/docs/docbook/smbdotconf/logon/deletegroupscript.xml b/docs/docbook/smbdotconf/logon/deletegroupscript.xml dissimilarity index 100% index 02c413115aa..2e78c6ae7d9 100644 --- a/docs/docbook/smbdotconf/logon/deletegroupscript.xml +++ b/docs/docbook/smbdotconf/logon/deletegroupscript.xml @@ -1,8 +1,13 @@ -delete group script (G) - This is the full pathname to a script that will - be run AS ROOT smbd - 8 when a group is requested to be deleted. - It will expand any %g to the group name passed. - This script is only useful for installations using the Windows NT domain administration tools. - - + + + This is the full pathname to a script that will + be run AS ROOT smbd + 8 when a group is requested to be deleted. + It will expand any %g to the group name passed. + This script is only useful for installations using the Windows NT domain administration tools. + + + diff --git a/docs/docbook/smbdotconf/logon/deleteuserfromgroupscript.xml b/docs/docbook/smbdotconf/logon/deleteuserfromgroupscript.xml dissimilarity index 99% index bb1c5136c1f..76594c75d8e 100644 --- a/docs/docbook/smbdotconf/logon/deleteuserfromgroupscript.xml +++ b/docs/docbook/smbdotconf/logon/deleteuserfromgroupscript.xml @@ -1,16 +1,18 @@ - - delete user from group script (G) - Full path to the script that will be called when - a user is removed from a group using the Windows NT domain administration - tools. It will be run by smbd - 8 AS ROOT. - Any %g will be replaced with the group name and - any %u will be replaced with the user name. - - - Default: delete user from group script = - - Example: delete user from group script = /usr/sbin/deluser %u %g - - - + + + Full path to the script that will be called when + a user is removed from a group using the Windows NT domain administration + tools. It will be run by smbd + 8 AS ROOT. + Any %g will be replaced with the group name and + any %u will be replaced with the user name. + + + Default: delete user from group script = + + Example: delete user from group script = /usr/sbin/deluser %u %g + + diff --git a/docs/docbook/smbdotconf/logon/deleteuserscript.xml b/docs/docbook/smbdotconf/logon/deleteuserscript.xml dissimilarity index 99% index afb75dbe776..233844555b2 100644 --- a/docs/docbook/smbdotconf/logon/deleteuserscript.xml +++ b/docs/docbook/smbdotconf/logon/deleteuserscript.xml @@ -1,21 +1,22 @@ - - delete user script (G) - This is the full pathname to a script that will - be run by smbd - 8 when managing users - with remote RPC (NT) tools. - - - This script is called when a remote client removes a user - from the server, normally using 'User Manager for Domains' or - rpcclient. - - - This script should delete the given UNIX username. - - - Default: delete user script = <empty string> - - Example: delete user script = /usr/local/samba/bin/del_user - %u - + + + This is the full pathname to a script that will + be run by smbd + 8 when managing users + with remote RPC (NT) tools. + + + This script is called when a remote client removes a user + from the server, normally using 'User Manager for Domains' or + rpcclient. + + This script should delete the given UNIX username. + + Default: delete user script = <empty string> + + Example: delete user script = /usr/local/samba/bin/del_user %u + + diff --git a/docs/docbook/smbdotconf/logon/domainlogons.xml b/docs/docbook/smbdotconf/logon/domainlogons.xml dissimilarity index 99% index 9a2f432f7dc..e45621e5534 100644 --- a/docs/docbook/smbdotconf/logon/domainlogons.xml +++ b/docs/docbook/smbdotconf/logon/domainlogons.xml @@ -1,12 +1,15 @@ - - domain logons (G) - If set to yes, the Samba server will serve - Windows 95/98 Domain logons for the - workgroup it is in. Samba 2.2 - has limited capability to act as a domain controller for Windows - NT 4 Domains. For more details on setting up this feature see - the Samba-PDC-HOWTO included in the htmldocs/ - directory shipped with the source code. - - Default: domain logons = no - + + + If set to yes, the Samba server will serve + Windows 95/98 Domain logons for the + workgroup it is in. Samba 2.2 + has limited capability to act as a domain controller for Windows + NT 4 Domains. For more details on setting up this feature see + the Samba-PDC-HOWTO included in the Samba documentation. + + Default: domain logons = no + + diff --git a/docs/docbook/smbdotconf/logon/logondrive.xml b/docs/docbook/smbdotconf/logon/logondrive.xml dissimilarity index 99% index d0aa4d74567..8c6be709bf3 100644 --- a/docs/docbook/smbdotconf/logon/logondrive.xml +++ b/docs/docbook/smbdotconf/logon/logondrive.xml @@ -1,13 +1,18 @@ - - logon drive (G) - This parameter specifies the local path to - which the home directory will be connected (see logon home) - and is only used by NT Workstations. - - Note that this option is only useful if Samba is set up as a - logon server. - - Default: logon drive = z: - Example: logon drive = h: - - + + + This parameter specifies the local path to + which the home directory will be connected (see + logon home) + and is only used by NT Workstations. + + Note that this option is only useful if Samba is set up as a + logon server. + + Default: logon drive = z: + + Example: logon drive = h: + + diff --git a/docs/docbook/smbdotconf/logon/logonhome.xml b/docs/docbook/smbdotconf/logon/logonhome.xml dissimilarity index 99% index ec19c54043c..05c69524c23 100644 --- a/docs/docbook/smbdotconf/logon/logonhome.xml +++ b/docs/docbook/smbdotconf/logon/logonhome.xml @@ -1,40 +1,45 @@ - - logon home (G) - This parameter specifies the home directory - location when a Win95/98 or NT Workstation logs into a Samba PDC. - It allows you to do - - C:\> NET USE H: /HOME - - - from a command prompt, for example. - - This option takes the standard substitutions, allowing - you to have separate logon scripts for each user or machine. - - This parameter can be used with Win9X workstations to ensure - that roaming profiles are stored in a subdirectory of the user's - home directory. This is done in the following way: - - logon home = \\%N\%U\profile - - This tells Samba to return the above string, with - substitutions made when a client requests the info, generally - in a NetUserGetInfo request. Win9X clients truncate the info to - \\server\share when a user does net use /home - but use the whole string when dealing with profiles. - - Note that in prior versions of Samba, the - logon path was returned rather than - logon home. This broke net use - /home but allowed profiles outside the home directory. - The current implementation is correct, and can be used for - profiles if you use the above trick. - - This option is only useful if Samba is set up as a logon - server. - - Default: logon home = "\\%N\%U" - Example: logon home = "\\remote_smb_server\%U" - - + + + This parameter specifies the home directory + location when a Win95/98 or NT Workstation logs into a Samba PDC. + It allows you to do + + C:\> + NET USE H: /HOME + + + from a command prompt, for example. + + This option takes the standard substitutions, allowing + you to have separate logon scripts for each user or machine. + + This parameter can be used with Win9X workstations to ensure + that roaming profiles are stored in a subdirectory of the user's + home directory. This is done in the following way: + + logon home = \\%N\%U\profile + + This tells Samba to return the above string, with + substitutions made when a client requests the info, generally + in a NetUserGetInfo request. Win9X clients truncate the info to + \\server\share when a user does net use /home + but use the whole string when dealing with profiles. + + Note that in prior versions of Samba, the + logon path was returned rather than + logon home. This broke net use /home but allowed profiles outside the home directory. + The current implementation is correct, and can be used for profiles if you use + the above trick. + + This option is only useful if Samba is set up as a logon + server. + + Default: logon home = "\\%N\%U" + + Example: logon home = "\\remote_smb_server\%U" + + diff --git a/docs/docbook/smbdotconf/logon/logonpath.xml b/docs/docbook/smbdotconf/logon/logonpath.xml dissimilarity index 99% index 04a2777862b..9abcf0d702e 100644 --- a/docs/docbook/smbdotconf/logon/logonpath.xml +++ b/docs/docbook/smbdotconf/logon/logonpath.xml @@ -1,45 +1,49 @@ - - logon path (G) - This parameter specifies the home directory - where roaming profiles (NTuser.dat etc files for Windows NT) are - stored. Contrary to previous versions of these manual pages, it has - nothing to do with Win 9X roaming profiles. To find out how to - handle roaming profiles for Win 9X system, see the - logon home parameter. - - This option takes the standard substitutions, allowing you - to have separate logon scripts for each user or machine. It also - specifies the directory from which the "Application Data", - (desktop, start menu, - network neighborhood, programs - and other folders, and their contents, are loaded and displayed on - your Windows NT client. - - The share and the path must be readable by the user for - the preferences and directories to be loaded onto the Windows NT - client. The share must be writeable when the user logs in for the first - time, in order that the Windows NT client can create the NTuser.dat - and other directories. - - Thereafter, the directories and any of the contents can, - if required, be made read-only. It is not advisable that the - NTuser.dat file be made read-only - rename it to NTuser.man to - achieve the desired effect (a MANdatory - profile). - - Windows clients can sometimes maintain a connection to - the [homes] share, even though there is no user logged in. - Therefore, it is vital that the logon path does not include a - reference to the homes share (i.e. setting this parameter to - \%N\%U\profile_path will cause problems). - - This option takes the standard substitutions, allowing - you to have separate logon scripts for each user or machine. - - Note that this option is only useful if Samba is set up - as a logon server. - - Default: logon path = \\%N\%U\profile - Example: logon path = \\PROFILESERVER\PROFILE\%U - - + + + This parameter specifies the home directory + where roaming profiles (NTuser.dat etc files for Windows NT) are + stored. Contrary to previous versions of these manual pages, it has + nothing to do with Win 9X roaming profiles. To find out how to + handle roaming profiles for Win 9X system, see the + logon home parameter. + + This option takes the standard substitutions, allowing you + to have separate logon scripts for each user or machine. It also + specifies the directory from which the "Application Data", + (desktop, start menu, + network neighborhood, programs + and other folders, and their contents, are loaded and displayed on + your Windows NT client. + + The share and the path must be readable by the user for + the preferences and directories to be loaded onto the Windows NT + client. The share must be writeable when the user logs in for the first + time, in order that the Windows NT client can create the NTuser.dat + and other directories. + + Thereafter, the directories and any of the contents can, + if required, be made read-only. It is not advisable that the + NTuser.dat file be made read-only - rename it to NTuser.man to + achieve the desired effect (a MANdatory + profile). + + Windows clients can sometimes maintain a connection to + the [homes] share, even though there is no user logged in. + Therefore, it is vital that the logon path does not include a + reference to the homes share (i.e. setting this parameter to + \%N\%U\profile_path will cause problems). + + This option takes the standard substitutions, allowing + you to have separate logon scripts for each user or machine. + + Note that this option is only useful if Samba is set up + as a logon server. + + Default: logon path = \\%N\%U\profile + + Example: logon path = \\PROFILESERVER\PROFILE\%U + + diff --git a/docs/docbook/smbdotconf/logon/logonscript.xml b/docs/docbook/smbdotconf/logon/logonscript.xml dissimilarity index 99% index 842cf927d2d..65b6253c0c0 100644 --- a/docs/docbook/smbdotconf/logon/logonscript.xml +++ b/docs/docbook/smbdotconf/logon/logonscript.xml @@ -1,39 +1,44 @@ - - logon script (G) - This parameter specifies the batch file (.bat) or - NT command file (.cmd) to be downloaded and run on a machine when - a user successfully logs in. The file must contain the DOS - style CR/LF line endings. Using a DOS-style editor to create the - file is recommended. - - The script must be a relative path to the [netlogon] - service. If the [netlogon] service specifies a - path of /usr/local/samba/netlogon - , and logon script = STARTUP.BAT, then - the file that will be downloaded is: - - /usr/local/samba/netlogon/STARTUP.BAT - - The contents of the batch file are entirely your choice. A - suggested command would be to add NET TIME \\SERVER /SET - /YES, to force every machine to synchronize clocks with - the same time server. Another use would be to add NET USE - U: \\SERVER\UTILS for commonly used utilities, or - NET USE Q: \\SERVER\ISO9001_QA for example. - - Note that it is particularly important not to allow write - access to the [netlogon] share, or to grant users write permission - on the batch files in a secure environment, as this would allow - the batch files to be arbitrarily modified and security to be - breached. - - This option takes the standard substitutions, allowing you - to have separate logon scripts for each user or machine. - - This option is only useful if Samba is set up as a logon - server. - - Default: no logon script defined - Example: logon script = scripts\%U.bat - - + + + This parameter specifies the batch file (.bat) or + NT command file (.cmd) to be downloaded and run on a machine when + a user successfully logs in. The file must contain the DOS + style CR/LF line endings. Using a DOS-style editor to create the + file is recommended. + + The script must be a relative path to the [netlogon] + service. If the [netlogon] service specifies a + path of /usr/local/samba/netlogon, and logon script = STARTUP.BAT, then + the file that will be downloaded is: + + /usr/local/samba/netlogon/STARTUP.BAT + + The contents of the batch file are entirely your choice. A + suggested command would be to add NET TIME \\SERVER /SET + /YES, to force every machine to synchronize clocks with + the same time server. Another use would be to add NET USE + U: \\SERVER\UTILS for commonly used utilities, or + NET USE Q: \\SERVER\ISO9001_QA for example. + + Note that it is particularly important not to allow write + access to the [netlogon] share, or to grant users write permission + on the batch files in a secure environment, as this would allow + the batch files to be arbitrarily modified and security to be + breached. + + This option takes the standard substitutions, allowing you + to have separate logon scripts for each user or machine. + + This option is only useful if Samba is set up as a logon + server. + + Default: no logon script defined + + Example: logon script = scripts\%U.bat + + diff --git a/docs/docbook/smbdotconf/logon/setprimarygroupscript.xml b/docs/docbook/smbdotconf/logon/setprimarygroupscript.xml dissimilarity index 98% index 45380ce4a8f..c19c3074174 100644 --- a/docs/docbook/smbdotconf/logon/setprimarygroupscript.xml +++ b/docs/docbook/smbdotconf/logon/setprimarygroupscript.xml @@ -1,19 +1,21 @@ - -set primary group script (G) - - Thanks to the Posix subsystem in NT a - Windows User has a primary group in addition to the - auxiliary groups. This script sets the primary group - in the unix userdatase when an administrator sets the - primary group from the windows user manager or when - fetching a SAM with net rpc - vampire. %u will be - replaced with the user whose primary group is to be - set. %g will be replaced with - the group to set. - - Default: No default value - - Example: set primary group script = /usr/sbin/usermod -g '%g' '%u' - - + + + + Thanks to the Posix subsystem in NT a Windows User has a + primary group in addition to the auxiliary groups. This script + sets the primary group in the unix userdatase when an + administrator sets the primary group from the windows user + manager or when fetching a SAM with net rpc + vampire. %u will be replaced + with the user whose primary group is to be set. + %g will be replaced with the group to + set. + + Default: No default value + + Example: set primary group script = /usr/sbin/usermod -g '%g' '%u' + + diff --git a/docs/docbook/smbdotconf/logon/shutdownscript.xml b/docs/docbook/smbdotconf/logon/shutdownscript.xml dissimilarity index 89% index ac286393b57..0eaffea7477 100644 --- a/docs/docbook/smbdotconf/logon/shutdownscript.xml +++ b/docs/docbook/smbdotconf/logon/shutdownscript.xml @@ -1,42 +1,59 @@ - - shutdown script (G) - This parameter only exists in the HEAD cvs branch - This a full path name to a script called by - smbd(8) that - should start a shutdown procedure. - - This command will be run as the user connected to the - server. - - %m %t %r %f parameters are expanded - %m will be substituted with the - shutdown message sent to the server. - %t will be substituted with the - number of seconds to wait before effectively starting the - shutdown procedure. - %r will be substituted with the - switch -r. It means reboot after shutdown - for NT. - - %f will be substituted with the - switch -f. It means force the shutdown - even if applications do not respond for NT. - - Default: None. - Example: abort shutdown script = /usr/local/samba/sbin/shutdown %m %t %r %f - Shutdown script example: - -#!/bin/bash - -$time=0 -let "time/60" -let "time++" - -/sbin/shutdown $3 $4 +$time $1 & - - Shutdown does not return so we need to launch it in background. - - - See also abort shutdown script. - - + + + This parameter only exists in the HEAD cvs branch + This a full path name to a script called by smbd + 8 that should start a shutdown procedure. + + This command will be run as the user connected to the server. + + %m %t %r %f parameters are expanded: + + + + %m will be substituted with the + shutdown message sent to the server. + + + + %t will be substituted with the + number of seconds to wait before effectively starting the + shutdown procedure. + + + + %r will be substituted with the + switch -r. It means reboot after shutdown + for NT. + + + + %f will be substituted with the + switch -f. It means force the shutdown + even if applications do not respond for NT. + + + + Default: None. + + Example: abort shutdown script = /usr/local/samba/sbin/shutdown %m %t %r %f + + Shutdown script example: + +#!/bin/bash + +$time=0 +let "time/60" +let "time++" + +/sbin/shutdown $3 $4 +$time $1 & + +Shutdown does not return so we need to launch it in background. + + + See also + abort shutdown script. + + -- 2.11.4.GIT