From 6cb00e444f3acd7b3339c46813830fbdc3d7d027 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Mon, 19 Aug 2002 15:29:40 +0000 Subject: Adding documentation for options: add user to group script delete group script ads server delete user from group script disable netbios block size hide unwriteable mangling method --- docs/docbook/manpages/smb.conf.5.sgml | 148 +++++++++++++++++++++++++++++----- 1 file changed, 129 insertions(+), 19 deletions(-) (limited to 'docs') diff --git a/docs/docbook/manpages/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml index 54e5f3ed73a..299379659f9 100644 --- a/docs/docbook/manpages/smb.conf.5.sgml +++ b/docs/docbook/manpages/smb.conf.5.sgml @@ -594,10 +594,14 @@ abort shutdown script + add group script add printer command add share command add user script + add user to group script add machine script + delete group script + ads server algorithmic rid base allow trusted domains announce as @@ -620,7 +624,9 @@ delete printer command delete share command delete user script + delete user from group script dfree command + disable netbios disable spoolss dns proxy domain admin group @@ -633,6 +639,7 @@ getwd cache hide local users hide unreadable + hide unwriteable homedir map host msdfs hosts equiv @@ -777,6 +784,7 @@ allow hosts available blocking locks + block size browsable browseable case sensitive @@ -835,6 +843,7 @@ mangled map mangled names mangling char + mangling method map archive map hidden map system @@ -920,7 +929,6 @@ - add printer command (G) With the introduction of MS-RPC based printing @@ -1051,6 +1059,18 @@ + + ads server (G) + If this option is specified, samba does + not try to figure out what ads server to use itself, but + uses the specified ads server. Either one DNS name or IP + address can be used. + + Default: ads server = + + Example: ads server = 192.168.1.2 + + add user script (G) @@ -1102,14 +1122,12 @@ %u -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. - - - - - + + 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. + + admin users (S) @@ -1126,8 +1144,23 @@ Example: admin users = jason - + + 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 + + + allow hosts (S) @@ -1182,8 +1215,6 @@ - - announce as (G) This specifies what type of server @@ -1353,7 +1384,31 @@ - + + + block size (S) + This parameter controls the behavior of + smbd(8) when reporting disk free + sizes. By default, this reports a disk block size of 1024 bytes. + + + Changing this parameter may have some effect on the + efficiency of client writes, this is not yet confirmed. This + parameter was added to allow advanced administrators to change + it (usually to a higher value) and test the effect it has on + client write performance without re-compiling the code. As this + is an experimental option it may be removed in a future release. + + + Changing this option does not change the disk free reporting + size, just the block size unit reported to the client. + + Default: block size = 1024 + Example: block size = 65536 + + + + @@ -1800,7 +1855,11 @@ - + delete group script (G) + This is the full pathname to a script that will + be run AS ROOT by 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. + + delete printer command (G) @@ -1927,9 +1986,22 @@ %u + + 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 + + + delete veto files (S) @@ -2122,10 +2194,24 @@ + + disable netbios (G) + Enabling this parameter will disable netbios support + in Samba. Netbios is the only available form of browsing in + all windows versions except for 2000 and XP. + + Note that clients that only support netbios won't be able to + see your samba server when netbios support is disabled. + + + Default: disable netbios = no + Example: disable netbios = yes + + disable spoolss (G) - Enabling this parameter will disables Samba's support + Enabling this parameter will disable Samba's support for the SPOOLSS set of MS-RPC's and will yield identical behavior as Samba 2.0.x. Windows NT/2000 clients will downgrade to using Lanman style printing commands. Windows 9x/ME will be uneffected by @@ -2873,14 +2959,24 @@ - hide unreadable (S) + hide unreadable (G) This parameter prevents clients from seeing the existance of files that cannot be read. Defaults to off. - Default: hide unreadable = no + Default: hide unreadable = no + + + hide unwriteable (G) + This parameter prevents clients from seeing + the existance of files that cannot be written to. Defaults to off. + Note that unwriteable directories are shown as usual. + + Default: hide unwriteable = no + + homedir map (G) @@ -4131,8 +4227,22 @@ + + mangling mathod(G) + controls the algorithm used for the generating + the mangled names. Can take two different values, "hash" and + "hash2". "hash" is the default and is the algorithm that has been + used in Samba for many years. "hash2" is a newer and considered + a better algorithm (generates less collisions) in the names. + However, many Win32 applications store the mangled names and so + changing to the new algorithm must not be done + lightly as these applications may break unless reinstalled. + New installations of Samba may set the default to hash2. + Default: mangling method = hash + Example: mangling method = hash2 + + - mangled stack (G) This parameter controls the number of mangled names -- cgit