From e4840f0db911eaf3aee1195030c6efca70d78f14 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Thu, 6 Dec 2001 07:37:58 +0000 Subject: merge from 2.2 (This used to be commit c5ee06b7c8fc9f1fec679acc7d7f47f333707456) --- docs/htmldocs/smb.conf.5.html | 874 ++++++++++++++++++++++++++++-------------- 1 file changed, 589 insertions(+), 285 deletions(-) (limited to 'docs/htmldocs/smb.conf.5.html') diff --git a/docs/htmldocs/smb.conf.5.html b/docs/htmldocs/smb.conf.5.html index 5fe4f3cf97..f60cd595cf 100644 --- a/docs/htmldocs/smb.conf.5.html +++ b/docs/htmldocs/smb.conf.5.html @@ -638,8 +638,8 @@ CLASS="VARIABLELIST" >

the architecture of the remote machine. Only some are recognized, and those may not be - 100% reliable. It currently recognizes Samba, WfWg, - WinNT and Win95. Anything else will be known as + 100% reliable. It currently recognizes Samba, WfWg, Win95, + WinNT and Win2k. Anything else will be known as "UNKNOWN". If it gets it wrong then sending a level 3 log to

  • ldap admin dn

  • ldap filter

  • ldap port

  • ldap server

  • ldap ssl

  • ldap suffix

  • nt acl support

  • ssl egd socket

  • ssl entropy bytes

  • ssl entropy file

  • use mmap

  • COMPLETE LIST OF SERVICE PARAMETERS

  • nt acl support

  • strict allocate

  • EXPLANATION OF EACH PARAMETER

    it is in. Samba 2.2 also has limited capability to act as a domain controller for Windows NT 4 Domains. For more details on setting up this feature see - the file DOMAINS.txt in the Samba documentation directory docs/ - shipped with the source code.

    htmldocs/     + directory shipped with the source code.

    Default: parameter is applied.

    Note that by default this parameter does not apply to permissions - set by Windows NT/2000 ACL editors. If the administrator wishes to enforce - this mask on access control lists also, they need to set the restrict acl with - mask to true.

    See also the parameter is applied.

    Note that by default this parameter does not apply to permissions - set by Windows NT/2000 ACL editors. If the administrator wishes to enforce - this mask on access control lists also, they need to set the restrict acl with - mask to true.

    See also the parameter

    Default : Default : large readwrite = no

    ldap admin dn (G)

    This parameter is only available if Samba has been + configure to include the --with-ldapsam option + at compile time. This option should be considered experimental and + under active development. +

    The ldap admin dn defines the Distinguished + Name (DN) name used by Samba to contact the ldap + server when retreiving user account information. The ldap + admin dn is used in conjunction with the admin dn password + stored in the private/secrets.tdb file. See the + smbpasswd(8) man + page for more information on how to accmplish this. +

    Default : none

    ldap filter (G)

    This parameter is only available if Samba has been + configure to include the --with-ldapsam option + at compile time. This option should be considered experimental and + under active development. +

    This parameter specifies the RFC 2254 compliant LDAP search filter. + The default is to match the login name with the uid + attribute for all entries matching the sambaAccount + objectclass. Note that this filter should only return one entry. +

    Default : ldap filter = (&(uid=%u)(objectclass=sambaAccount))

    ldap port (G)

    This parameter is only available if Samba has been + configure to include the --with-ldapsam option + at compile time. This option should be considered experimental and + under active development. +

    This option is used to control the tcp port number used to contact + the ldap server. + The default is to use the stand LDAP port 389. +

    Default : ldap port = 389

    ldap server (G)

    This parameter is only available if Samba has been + configure to include the --with-ldapsam option + at compile time. This option should be considered experimental and + under active development. +

    This parameter should contains the FQDN of the ldap directory + server which should be queried to locate user account information. +

    Default : ldap server = localhost

    ldap ssl (G)

    This parameter is only available if Samba has been + configure to include the --with-ldapsam option + at compile time. This option should be considered experimental and + under active development. +

    This option is used to define whether or not Samba should + use SSL when connecting to the ldap + server. This is NOT related to + Samba SSL support which is enabled by specifying the + --with-ssl option to the configure + script (see ssl). +

    The ldap ssl can be set to one of three values: + (a) on - Always use SSL when contacting the + ldap server, (b) off - + Never use SSL when querying the directory, or (c) start + tls - Use the LDAPv3 StartTLS extended operation + (RFC2830) for communicating with the directory server. +

    Default : ldap ssl = off

    ldap suffix (G)

    This parameter is only available if Samba has been + configure to include the large readwrite = no--with-ldapsam option + at compile time. This option should be considered experimental and + under active development. +

    Default : none

    --with-msdfs option. If set to yes>yes, Samba treats the share as a Dfs root and allows clients to browse the distributed file system tree rooted at the share directory. @@ -12038,7 +12382,7 @@ CLASS="FILENAME" CLASS="FILENAME" >/etc/nsswitch.conf - file). Note that this method is only used if the NetBIOS name + file. Note that this method is only used if the NetBIOS name type being queried is the 0x20 (server) name type, otherwise it is ignored.

    • nt acl support (G)nt acl support (S)

    This boolean parameter controls whether @@ -12237,7 +12581,9 @@ HREF="smbd.8.html" TARGET="_top" >smbd(8) will attempt to map - UNIX permissions into Windows NT access control lists.

    Default: parameter is set to true, the chat pairs - may be matched in any order, and sucess is determined by the PAM result, + may be matched in any order, and success is determined by the PAM result, not any particular output. The \n macro is ignored for PAM conversions.

    will be replaced by the appropriate printer name. The - spool file name is generated automatically by the server, the printer - name is discussed below.

    %J     macro can be used to access the job + name as transmitted by the client.

    The print command MUST

    For printing = SYS or HPUX :printing = SYSV or HPUX :

    if specified in the [global] section.

    Currently eight printing styles are supported. They are +>Currently nine printing styles are supported. They are BSD

    restrict acl with mask (S)

    This is a boolean parameter. If set to false (default), then - creation of files with access control lists (ACLS) and modification of ACLs - using the Windows NT/2000 ACL editor will be applied directly to the file - or directory.

    If set to true, then all requests to set an ACL on a file will have the - parameters create mask, - force create mode - applied before setting the ACL, and all requests to set an ACL on a directory will - have the parameters directory - mask, force - directory mode applied before setting the ACL. -

    See also create mask, - force create mode, - directory mask, - force directory mode -

    Default: restrict acl with mask = no

    restrict anonymous (G)
    .

    In versions of Samba prior to 2..0, the default was +>In versions of Samba prior to 2.0.0, the default was security = share was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This variable enables or disables the entire SSL mode. If it is set to was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This variable defines where to look up the Certification Authorities. The given directory should contain one file for each CA that Samba will trust. The file name must be the hash @@ -16383,14 +16617,6 @@ CLASS="COMMAND" > was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This variable is a second way to define the trusted CAs. The certificates of the trusted CAs are collected in one big file and this variable points to the file. You will probably @@ -16421,14 +16647,6 @@ CLASS="COMMAND" > was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This variable defines the ciphers that should be offered during SSL negotiation. You should not set this variable unless you know what you are doing.

    was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    The certificate in this file is used by was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This is the private key for was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This variable defines whether SSLeay should be configured +>This variable defines whether OpenSSL should be configured for bug compatibility with other SSL implementations. This is probably not desirable because currently no clients with SSL - implementations other than SSLeay exist.

    Default:

    ssl egd socket (G)

    This variable is part of SSL-enabled Samba. This + is only available if the SSL libraries have been compiled on your + system and the configure option --with-ssl was + given at configure time.

    This option is used to define the location of the communiation socket of + an EGD or PRNGD daemon, from which entropy can be retrieved. This option + can be used instead of or together with the ssl entropy file + directive. 255 bytes of entropy will be retrieved from the daemon. +

    Default: none

    ssl entropy bytes (G)

    This variable is part of SSL-enabled Samba. This + is only available if the SSL libraries have been compiled on your + system and the configure option --with-ssl was + given at configure time.

    This parameter is used to define the number of bytes which should + be read from the ssl entropy + file If a -1 is specified, the entire file will + be read. +

    Default: ssl entropy bytes = 255

    ssl entropy file (G)

    This variable is part of SSL-enabled Samba. This + is only available if the SSL libraries have been compiled on your + system and the configure option --with-ssl was + given at configure time.

    This parameter is used to specify a file from which processes will + read "random bytes" on startup. In order to seed the internal pseudo + random number generator, entropy must be provided. On system with a + /dev/urandom device file, the processes + will retrieve its entropy from the kernel. On systems without kernel + entropy support, a file can be supplied that will be read on startup + and that will be used to seed the PRNG. +

    Default: none

    ssl hosts (G)
    was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    These two variables define whether Samba will go into SSL mode or not. If none of them is defined, Samba will allow only SSL connections. If the was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    If this variable is set to yes was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    If this variable is set to yes was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This is the file containing the server's certificate. The server must was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This file contains the private key of the server. If this variable is not defined, the key is looked up in the certificate file (it may be appended to the certificate). @@ -16853,14 +17105,6 @@ CLASS="COMMAND" > was given at configure time.

    Note that for export control reasons - this code is NOT enabled by default in any - current binary version of Samba.

    This enumeration variable defines the versions of the SSL protocol that will be used.

    strict allocate (S)

    This is a boolean that controls the handling of + disk space allocation in the server. When this is set to yes + the server will change from UNIX behaviour of not committing real + disk storage blocks when a file is extended to the Windows behaviour + of actually forcing the disk system to allocate real storage blocks + when a file is created or extended to be a given size. In UNIX + terminology this means that Samba will stop creating sparse files. + This can be slow on some systems.

    When strict allocate is no the server does sparse + disk block allocation when a file is extended.

    Setting this to yes can help Samba return + out of quota messages on systems that are restricting the disk quota + of users.

    Default: strict allocate = no

    strict locking (S)
    use mmap (G)

    This global parameter determines if the tdb internals of Samba can + depend on mmap working correctly on the running system. Samba requires a coherent + mmap/read-write system memory cache. Currently only HPUX does not have such a + coherent cache, and so this parameter is set to false by + default on HPUX. On all other systems this parameter should be left alone. This + parameter is provided to help the Samba developers track down problems with + the tdb internal code. +

    Default: use mmap = yes

    use rhosts (G)
    	   ; Veto any files containing the word Security, 
-    	; any ending in .tmp, and any directory containing the
-    	; word root.
-		veto files = /*Security*/*.tmp/*root*/
+>; Veto any files containing the word Security, 
+; any ending in .tmp, and any directory containing the
+; word root.
+veto files = /*Security*/*.tmp/*root*/
 
-		; Veto the Apple specific files that a NetAtalk server
-    	; creates.
-		veto files = /.AppleDouble/.bin/.AppleDesktop/Network Trash Folder/
-

    Default: winbind enum groups = no winbind enum groups = yes

    WARNINGS

    VERSION

    SEE ALSO

    AUTHOR