From 0386a8ac77fcb283f932fa514a16bd3d1aec7ad1 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Mon, 19 Aug 2002 18:05:06 +0000 Subject: More smb.conf manpage updates: add printer command -> addprinter command delete printer command -> deleteprinter command display charset dos charset hide unwriteable -> hide unwriteable files hostname lookups name cache timeout ntlm auth paranoid server security realm smb ports unicode unix charset wtmp directory wins partners block size vfspath (This used to be commit 80a25fe365ac83b7331fa95b3287dd275a229fdc) --- docs/docbook/manpages/smb.conf.5.sgml | 217 ++++++++++++++++++++++++++++++---- 1 file changed, 194 insertions(+), 23 deletions(-) diff --git a/docs/docbook/manpages/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml index 299379659f..9dc3ae3bbf 100644 --- a/docs/docbook/manpages/smb.conf.5.sgml +++ b/docs/docbook/manpages/smb.conf.5.sgml @@ -595,7 +595,7 @@ abort shutdown script add group script - add printer command + addprinter command add share command add user script add user to group script @@ -621,27 +621,30 @@ debuglevel default default service - delete printer command + deleteprinter command delete share command delete user script delete user from group script dfree command disable netbios disable spoolss + disable charset dns proxy domain admin group domain guest group domain logons domain master + dos charset encrypt passwords enhanced browsing enumports command getwd cache hide local users hide unreadable - hide unwriteable + hide unwriteable files homedir map host msdfs + hostname lookups hosts equiv interfaces keepalive @@ -689,11 +692,13 @@ min password length min protocol min wins ttl + name cache timeout name resolve order netbios aliases netbios name netbios scope nis homedir + ntlm auth non unix account range nt pipe support nt status support @@ -704,6 +709,7 @@ os2 driver map pam password change panic action + paranoid server security passdb backend passwd chat passwd chat debug @@ -721,6 +727,7 @@ read bmpx read raw read size + realm remote announce remote browse sync restrict anonymous @@ -732,6 +739,7 @@ show add printer wizard shutdown script smb passwd file + smb ports socket address socket options source environment @@ -747,6 +755,8 @@ time server timestamp logs total print jobs + unicode + unix charset unix extensions unix password sync update encrypted @@ -756,6 +766,7 @@ username map utmp utmp directory + wtmp directory winbind cache time winbind enum users winbind enum groups @@ -764,6 +775,7 @@ winbind uid winbind use default domain wins hook + wins partners wins proxy wins server wins support @@ -784,7 +796,7 @@ allow hosts available blocking locks - block size +block size browsable browseable case sensitive @@ -896,6 +908,7 @@ valid users veto files veto oplock files + vfs path vfs object vfs options volume @@ -930,7 +943,7 @@ - add printer command (G) + addprinter command (G) With the introduction of MS-RPC based printing support for Windows NT/2000 clients in Samba 2.2, The MS Add Printer Wizard (APW) icon is now also available in the @@ -947,7 +960,7 @@ shared by smbd(8) . - The add printer command is + The addprinter command is automatically invoked with the following parameter (in order: @@ -967,14 +980,14 @@ only. The remaining fields in the structure are generated from answers to the APW questions. - Once the add printer command has + Once the addprinter command has been executed, smbd will reparse the smb.conf to determine if the share defined by the APW exists. If the sharename is still invalid, then smbd will return an ACCESS_DENIED error to the client. See also - delete printer command, , printing, show add printer wizard @@ -1024,7 +1037,7 @@ This parameter is only used for add file shares. To add printer shares, - see the add printer + see the addprinter command. @@ -1862,7 +1875,7 @@ - delete printer command (G) + deleteprinter command (G) With the introduction of MS-RPC based printer support for Windows NT/2000 clients in Samba 2.2, it is now possible to delete printer at run time by issuing the @@ -1875,19 +1888,19 @@ from the print system and from smb.conf. - The delete printer command is + The deleteprinter command is automatically called with only one parameter: "printer name". - Once the delete printer command has + Once the deleteprinter command has been executed, smbd will reparse the smb.conf to associated printer no longer exists. If the sharename is still valid, then smbd will return an ACCESS_DENIED error to the client. See also - add printer command, , printing, show add printer wizard @@ -1946,7 +1959,7 @@ This parameter is only used to remove file shares. To delete printer shares, - see the delete printer + see the deleteprinter command. @@ -2230,6 +2243,19 @@ + + display charset (G) + Specifies the charset that samba will use + to print messages to stdout and stderr and SWAT will use. + Should generally be the same as the unix charset. + + + Default: display charset = ASCII + + Example: display charset = UTF8 + + + @@ -2374,7 +2400,20 @@ + + dos charset (G) + DOS SMB clients assume the server has + the same charset as they do. This option specifies which + charset Samba should talk to DOS clients. + + The default depends on which charsets you have instaled. + Samba tries to use charset 850 but falls back to ASCII in + case it is not available. Run testparm(1) + to check the default on your system. + + + dos filemode (S) @@ -2661,8 +2700,7 @@ - force directory - security mode (S) + force directory security mode (S) This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating the UNIX permission on a directory using the native NT security dialog box. @@ -2733,8 +2771,6 @@ - - force security mode (S) This parameter controls what UNIX permission @@ -2768,6 +2804,8 @@ Example: force security mode = 700 + + @@ -2968,7 +3006,7 @@ - hide unwriteable (G) + hide unwriteable files (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. @@ -3028,6 +3066,21 @@ Default: host msdfs = no + + + hostname lookups (G) + Specifies whether samba should use (expensive) + hostname lookups or use the ip addresses instead. An example place + where hostname lookups are currently used is when checking + the hosts deny and hosts allow. + + + Default: hostname lookups = yes + + Example: hostname lookups = no + + + @@ -4228,7 +4281,7 @@ - mangling mathod(G) + mangling method (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 @@ -4780,6 +4833,18 @@ + + name cache timeout (G) + Specifies the number of seconds it takes before + entries in samba's hostname resolve cache time out. If + the timeout is set to 0. the caching is disabled. + + + + Default: name cache timeout = 660 + Example: name cache timeout = 0 + + name resolve order (G) @@ -5127,7 +5192,19 @@ + + ntlm auth (G) + This parameter determines whether or not smbd will + attempt to authenticate users using the NTLM password hash. + If disabled, only the lanman password hashes will be used. + + Please note that at least this option or lanman auth should be enabled in order to be able to log in. + + + Default : ntlm auth = yes + + os level (G) @@ -5208,6 +5285,18 @@ + + paranoid server security (G) + Some version of NT 4.x allow non-guest + users with a bad passowrd. When this option is enabled, samba will not + use a broken NT 4.x server as password server, but instead complain + to the logs and exit. + + + Default: paranoid server security = no + + + passdb backend (G) @@ -6306,6 +6395,18 @@ + + realm (G) + + This option specifies the kerberos realm to use. The realm is + used as the ADS equivalent of the NT4domain. It + is usually set to the DNS name of the kerberos server. + + + Default: realm = + Example: realm = mysambabox.mycompany.com + + remote announce (G) @@ -6965,7 +7066,16 @@ + + smb ports (G) + Specifies which ports the server should listen on + for SMB traffic. + + Default: smb ports = 445 139 + + + socket address (G) @@ -7342,8 +7452,27 @@ + + unicode (G) + Specifies whether Samba should try + to use unicode on the wire by default. + + + Default: unicode = yes + + + + unix charset (G) + Specifies the charset the unix machine + Samba runs on uses. Samba needs to know this in order to be able to + convert text to the charsets other SMB clients use. + + + Default: unix charset = ASCII + + unix extensions(G) @@ -7709,8 +7838,6 @@ - - utmp directory(G) This parameter is only available if Samba has @@ -7724,11 +7851,30 @@ /var/run/utmp on Linux). Default: no utmp directory + Example: utmp directory = /var/run/utmp + + wtmp directory(G) + This parameter is only available if Samba has + been configured and compiled with the option + --with-utmp. It specifies a directory pathname that is + used to store the wtmp or wtmpx files (depending on the UNIX system) that + record user connections to a Samba server. The difference with + the utmp directory is the fact that user info is kept after a user + has logged out. + + See also the + utmp parameter. By default this is + not set, meaning the system will use whatever utmp file the + native system is set to use (usually + /var/run/wtmp on Linux). - + Default: no wtmp directory + Example: wtmp directory = /var/log/wtmp + + @@ -7832,7 +7978,18 @@ veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/ + + vfs path (S) + This parameter specifies the directory + to look in for vfs modules. The name of every vfs object + will be prepended by this directory + + Default: vfs path = + Example: vfs path = /usr/lib/samba/vfs + + + vfs object (S) @@ -8203,6 +8360,20 @@ veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/ + + wins partners (G) + A space separated list of partners' IP addresses for + WINS replication. WINS partners are always defined as push/pull + partners as defining only one way WINS replication is unreliable. + WINS replication is currently experimental and unreliable between + samba servers. + + + Default: wins partners = + + Example: wins partners = 192.168.0.1 172.16.1.2 + + -- cgit