mirror of
https://github.com/samba-team/samba.git
synced 2025-08-02 00:22:11 +03:00
Save your work as you go... :-).
Jeremy.
(This used to be commit f733534147
)
This commit is contained in:
@ -48,35 +48,37 @@ string (no quotes needed) or a boolean, which may be given as yes/no,
|
||||
preserved in string values. Some items such as create modes are
|
||||
numeric.
|
||||
|
||||
label(SERVICEDESCRIPTIONS)
|
||||
manpagesection(SERVICE DESCRIPTIONS)
|
||||
label(SECTIONDESCRIPTIONS)
|
||||
manpagesection(SECTION DESCRIPTIONS)
|
||||
|
||||
Each section in the configuration file describes a service. The
|
||||
section name is the service name and the parameters within the section
|
||||
define the service's attributes.
|
||||
Each section in the configuration file (except for the
|
||||
link(bf([global]))(global) section) describes a shared resource (known
|
||||
as a em("share")). The section name is the name of the shared resource
|
||||
and the parameters within the section define the shares attributes.
|
||||
|
||||
There are three special sections, link(bf([global]))(global),
|
||||
link(bf([homes]))(homes) and link(bf([printers]))(printers), which are
|
||||
described under link(bf('special sections'))(specialsections). The
|
||||
following notes apply to ordinary service descriptions.
|
||||
following notes apply to ordinary section descriptions.
|
||||
|
||||
A service consists of a directory to which access is being given plus
|
||||
A share consists of a directory to which access is being given plus
|
||||
a description of the access rights which are granted to the user of
|
||||
the service. Some housekeeping options are also specifiable.
|
||||
|
||||
Services are either filespace services (used by the client as an
|
||||
Sections are either filespace services (used by the client as an
|
||||
extension of their native file systems) or printable services (used by
|
||||
the client to access print services on the host running the server).
|
||||
|
||||
Services may be guest services, in which case no password is required
|
||||
to access them. A specified UNIX guest account is used to define
|
||||
access privileges in this case.
|
||||
Sections may be designated link(bf(guest))(guestok) services, in which
|
||||
case no password is required to access them. A specified UNIX
|
||||
link(bf(guest account))(guestaccount) is used to define access
|
||||
privileges in this case.
|
||||
|
||||
Services other than guest services will require a password to access
|
||||
Sections other than guest services will require a password to access
|
||||
them. The client provides the username. As older clients only provide
|
||||
passwords and not usernames, you may specify a list of usernames to
|
||||
check against the password using the link(bf("user="))(user) option in
|
||||
the service definition. For modern clients such as Windows 95/98 and
|
||||
the share definition. For modern clients such as Windows 95/98 and
|
||||
Windows NT, this should not be neccessary.
|
||||
|
||||
Note that the access rights granted by the server are masked by the
|
||||
@ -84,9 +86,9 @@ access rights granted to the specified or guest UNIX user by the host
|
||||
system. The server does not grant more access than the host system
|
||||
grants.
|
||||
|
||||
The following sample section defines a file space service. The user
|
||||
has write access to the path tt(/home/bar). The service is accessed via
|
||||
the service name "foo":
|
||||
The following sample section defines a file space share. The user has
|
||||
write access to the path tt(/home/bar). The share is accessed via
|
||||
the share name "foo":
|
||||
|
||||
verb(
|
||||
|
||||
@ -96,7 +98,7 @@ verb(
|
||||
|
||||
)
|
||||
|
||||
The following sample section defines a printable service. The service
|
||||
The following sample section defines a printable share. The share
|
||||
is readonly, but printable. That is, the only write access permitted
|
||||
is via calls to open, write to and close a spool file. The
|
||||
link(bf('guest ok'))(guestok) parameter means access will be permitted
|
||||
@ -107,7 +109,7 @@ verb(
|
||||
path = /usr/spool/public
|
||||
read only = true
|
||||
printable = true
|
||||
public = true
|
||||
guest ok = true
|
||||
)
|
||||
|
||||
label(SPECIALSECTIONS)
|
||||
@ -119,7 +121,7 @@ label(global)
|
||||
dit(bf(The [global] section))
|
||||
|
||||
Parameters in this section apply to the server as a whole, or are
|
||||
defaults for services which do not specifically define certain
|
||||
defaults for sections which do not specifically define certain
|
||||
items. See the notes under link(bf('Parameters'))(Parameters) for more
|
||||
information.
|
||||
|
||||
@ -130,17 +132,17 @@ If a section called tt('homes') is included in the configuration file,
|
||||
services connecting clients to their home directories can be created
|
||||
on the fly by the server.
|
||||
|
||||
When the connection request is made, the existing services are
|
||||
When the connection request is made, the existing sections are
|
||||
scanned. If a match is found, it is used. If no match is found, the
|
||||
requested service name is treated as a user name and looked up in the
|
||||
local passwords file. If the name exists and the correct password has
|
||||
been given, a service is created by cloning the [homes] section.
|
||||
requested section name is treated as a user name and looked up in the
|
||||
local password file. If the name exists and the correct password has
|
||||
been given, a share is created by cloning the [homes] section.
|
||||
|
||||
Some modifications are then made to the newly created section:
|
||||
Some modifications are then made to the newly created share:
|
||||
|
||||
startit()
|
||||
|
||||
it() The service name is changed from tt('homes') to the located
|
||||
it() The share name is changed from tt('homes') to the located
|
||||
username
|
||||
|
||||
it() If no path was given, the path is set to the user's home
|
||||
@ -160,8 +162,8 @@ than for UNIX access.
|
||||
This is a fast and simple way to give a large number of clients access
|
||||
to their home directories with a minimum of fuss.
|
||||
|
||||
A similar process occurs if the requested service name is tt("homes"),
|
||||
except that the service name is not changed to that of the requesting
|
||||
A similar process occurs if the requested section name is tt("homes"),
|
||||
except that the share name is not changed to that of the requesting
|
||||
user. This method of using the [homes] section works well if different
|
||||
users share a client PC.
|
||||
|
||||
@ -183,7 +185,7 @@ access))(readonly).
|
||||
Note that the link(bf(browseable))(browseable) flag for auto home
|
||||
directories will be inherited from the global browseable flag, not the
|
||||
[homes] browseable flag. This is useful as it means setting
|
||||
browseable=no in the [homes] section will hide the [homes] service but
|
||||
browseable=no in the [homes] section will hide the [homes] share but
|
||||
make any auto home directories visible.
|
||||
|
||||
label(printers)
|
||||
@ -195,24 +197,25 @@ If a [printers] section occurs in the configuration file, users are
|
||||
able to connect to any printer specified in the local host's printcap
|
||||
file.
|
||||
|
||||
When a connection request is made, the existing services are
|
||||
When a connection request is made, the existing sections are
|
||||
scanned. If a match is found, it is used. If no match is found, but a
|
||||
link(bf([homes]))(homes) section exists, it is used as described
|
||||
above. Otherwise, the requested service name is treated as a printer
|
||||
above. Otherwise, the requested section name is treated as a printer
|
||||
name and the appropriate printcap file is scanned to see if the
|
||||
requested service name is a valid printer name. If a match is found, a
|
||||
new service is created by cloning the [printers] section.
|
||||
requested section name is a valid printer share name. If a match is
|
||||
found, a new printer share is created by cloning the [printers]
|
||||
section.
|
||||
|
||||
A few modifications are then made to the newly created section:
|
||||
A few modifications are then made to the newly created share:
|
||||
|
||||
startit()
|
||||
|
||||
it() The service name is set to the located printer name
|
||||
it() The share name is set to the located printer name
|
||||
|
||||
it() If no printer name was given, the printer name is set to the
|
||||
located printer name
|
||||
|
||||
it() If the service does not permit guest access and no username was
|
||||
it() If the share does not permit guest access and no username was
|
||||
given, the username is set to the located printer name.
|
||||
|
||||
endit()
|
||||
@ -228,7 +231,7 @@ verb(
|
||||
[printers]
|
||||
path = /usr/spool/public
|
||||
writable = no
|
||||
public = yes
|
||||
guest ok = yes
|
||||
printable = yes
|
||||
)
|
||||
|
||||
@ -263,7 +266,7 @@ enddit()
|
||||
label(PARAMETERS)
|
||||
manpagesection(PARAMETERS)
|
||||
|
||||
Parameters define the specific attributes of services.
|
||||
Parameters define the specific attributes of sections.
|
||||
|
||||
Some parameters are specific to the link(bf([global]))(global) section
|
||||
(eg., link(bf(security))(security)). Some parameters are usable in
|
||||
@ -326,10 +329,10 @@ label(percenth)
|
||||
it() bf(%h) = the internet hostname that Samba is running on.
|
||||
|
||||
label(percentm)
|
||||
it() bf(%m) = the netbios name of the client machine (very useful).
|
||||
it() bf(%m) = the NetBIOS name of the client machine (very useful).
|
||||
|
||||
label(percentL)
|
||||
it() bf(%L) = the netbios name of the server. This allows you to change your
|
||||
it() bf(%L) = the NetBIOS name of the server. This allows you to change your
|
||||
config based on what the client calls you. Your server can have a "dual
|
||||
personality".
|
||||
|
||||
@ -353,12 +356,13 @@ negotiation. It can be one of CORE, COREPLUS, LANMAN1, LANMAN2 or NT1.
|
||||
label(percentd)
|
||||
it() bf(%d) = The process id of the current server process.
|
||||
|
||||
label(percenta)
|
||||
it() bf(%a) = the architecture of the remote machine. Only some are recognised,
|
||||
and those may not be 100% reliable. It currently recognises Samba,
|
||||
WfWg, WinNT and Win95. Anything else will be known as "UNKNOWN". If it
|
||||
gets it wrong then sending a level 3 log to
|
||||
email(samba-bugs@samba.anu.edu.au) should allow it to be fixed.
|
||||
label(percenta)
|
||||
it() bf(%a) = the architecture of the remote
|
||||
machine. Only some are recognised, and those may not be 100%
|
||||
reliable. It currently recognises Samba, WfWg, WinNT and
|
||||
Win95. Anything else will be known as "UNKNOWN". If it gets it wrong
|
||||
then sending a level 3 log to email(samba-bugs@samba.anu.edu.au)
|
||||
should allow it to be fixed.
|
||||
|
||||
label(percentI)
|
||||
it() bf(%I) = The IP address of the client machine.
|
||||
@ -476,8 +480,6 @@ it() link(bf(domain logons))(domainlogons)
|
||||
|
||||
it() link(bf(domain master))(domainmaster)
|
||||
|
||||
it() link(bf(domain sid))(domainsid)
|
||||
|
||||
it() link(bf(encrypt passwords))(encryptpasswords)
|
||||
|
||||
it() link(bf(getwd cache))(getwdcache)
|
||||
@ -1525,7 +1527,8 @@ There is no default value for this parameter. If this parameter is not
|
||||
given, attempting to connect to a nonexistent service results in an
|
||||
error.
|
||||
|
||||
Typically the default service would be a public, read-only service.
|
||||
Typically the default service would be a link(bf(guest ok))(guestok),
|
||||
link(bf(read-only))(readonly) service.
|
||||
|
||||
Also note that the apparent service name will be changed to equal that
|
||||
of the requested service, this is very useful as it allows you to use
|
||||
@ -1819,104 +1822,129 @@ and may fail.
|
||||
bf(Default:)
|
||||
domain master = no
|
||||
|
||||
.SS dont descend (S)
|
||||
There are certain directories on some systems (eg., the /proc tree under
|
||||
Linux) that are either not of interest to clients or are infinitely deep
|
||||
(recursive). This parameter allows you to specify a comma-delimited list
|
||||
of directories that the server should always show as empty.
|
||||
|
||||
label(dont descend)
|
||||
dit(bf(dont descend (S)))
|
||||
|
||||
There are certain directories on some systems (eg., the tt(/proc) tree
|
||||
under Linux) that are either not of interest to clients or are
|
||||
infinitely deep (recursive). This parameter allows you to specify a
|
||||
comma-delimited list of directories that the server should always show
|
||||
as empty.
|
||||
|
||||
Note that Samba can be very fussy about the exact format of the "dont
|
||||
descend" entries. For example you may need "./proc" instead of just
|
||||
"/proc". Experimentation is the best policy :-)
|
||||
descend" entries. For example you may need tt("./proc") instead of
|
||||
just tt("/proc"). Experimentation is the best policy :-)
|
||||
|
||||
.B Default:
|
||||
bf(Default:)
|
||||
none (i.e., all directories are OK to descend)
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
dont descend = /proc,/dev
|
||||
|
||||
.SS dos filetimes (S)
|
||||
label(dosfiletimeresolution)
|
||||
dit(bf(dos filetime resolution (S)))
|
||||
|
||||
Under the DOS and Windows FAT filesystem, the finest granulatity on
|
||||
time resolution is two seconds. Setting this parameter for a share
|
||||
causes Samba to round the reported time down to the nearest two second
|
||||
boundary when a query call that requires one second resolution is made
|
||||
to link(bf(smbd))(smbd.8.html).
|
||||
|
||||
This option is mainly used as a compatibility option for Visual C++
|
||||
when used against Samba shares. If oplocks are enabled on a share,
|
||||
Visual C++ uses two different time reading calls to check if a file
|
||||
has changed since it was last read. One of these calls uses a
|
||||
one-second granularity, the other uses a two second granularity. As
|
||||
the two second call rounds any odd second down, then if the file has a
|
||||
timestamp of an odd number of seconds then the two timestamps will not
|
||||
match and Visual C++ will keep reporting the file has changed. Setting
|
||||
this option causes the two timestamps to match, and Visual C++ is
|
||||
happy.
|
||||
|
||||
bf(Default:)
|
||||
dos filetime resolution = False
|
||||
|
||||
bf(Example:)
|
||||
dos filetime resolution = True
|
||||
|
||||
label(dos filetimes)
|
||||
dit(bf(dos filetimes (S)))
|
||||
|
||||
Under DOS and Windows, if a user can write to a file they can change
|
||||
the timestamp on it. Under POSIX semantics, only the owner of the file
|
||||
or root may change the timestamp. By default, Samba runs with POSIX
|
||||
semantics and refuses to change the timestamp on a file if the user
|
||||
smbd is acting on behalf of is not the file owner. Setting this option
|
||||
to True allows DOS semantics and smbd will change the file timstamp as
|
||||
DOS requires. This is a correct implementation of a previous compile-time
|
||||
options (UTIME_WORKAROUND) which was broken and is now removed.
|
||||
to True allows DOS semantics and smbd will change the file timstamp as
|
||||
DOS requires.
|
||||
|
||||
.B Default:
|
||||
bf(Default:)
|
||||
dos filetimes = False
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
dos filetimes = True
|
||||
|
||||
.SS dos filetime resolution (S)
|
||||
Under the DOS and Windows FAT filesystem, the finest granulatity on
|
||||
time resolution is two seconds. Setting this parameter for a share
|
||||
causes Samba to round the reported time down to the nearest two
|
||||
second boundary when a query call that requires one second resolution
|
||||
is made to smbd.
|
||||
|
||||
This option is mainly used as a compatibility option for Visual C++
|
||||
when used against Samba shares. If oplocks are enabled on a share,
|
||||
Visual C++ uses two different time reading calls to check if a file
|
||||
has changed since it was last read. One of these calls uses a one-second
|
||||
granularity, the other uses a two second granularity. As the two second
|
||||
call rounds any odd second down, then if the file has a timestamp of an
|
||||
odd number of seconds then the two timestamps will not match and Visual
|
||||
C++ will keep reporting the file has changed. Setting this option causes
|
||||
the two timestamps to match, and Visual C++ is happy.
|
||||
|
||||
.B Default:
|
||||
dos filetime resolution = False
|
||||
|
||||
.B Example:
|
||||
dos filetime resolution = True
|
||||
|
||||
.SS encrypt passwords (G)
|
||||
label(encryptpasswords)
|
||||
dit(bf(encrypt passwords (G)))
|
||||
|
||||
This boolean controls whether encrypted passwords will be negotiated
|
||||
with the client. Note that Windows NT 4.0 SP3 and above will by default
|
||||
expect encrypted passwords unless a registry entry is changed. To use
|
||||
encrypted passwords in Samba see the file docs/ENCRYPTION.txt.
|
||||
with the client. Note that Windows NT 4.0 SP3 and above and also
|
||||
Windows 98 will by default expect encrypted passwords unless a
|
||||
registry entry is changed. To use encrypted passwords in Samba see the
|
||||
file ENCRYPTION.txt in the Samba documentation directory tt(docs/)
|
||||
shipped with the source code.
|
||||
|
||||
.SS exec (S)
|
||||
In order for encrypted passwords to work correctly
|
||||
link(bf(smbd))(smbd.8.html) must either have access to a local
|
||||
link(bf(smbpasswd (5)))(smbpasswd.5.html) file (see the
|
||||
link(bf(smbpasswd (8)))(smbpasswd.8.html) program for information on
|
||||
how to set up and maintain this file), or set the
|
||||
link(bf(security=))(security) parameter to either em("server") or
|
||||
em("domain") which causes link(bf(smbd))(smbd.8.html) to authenticate
|
||||
against another server.
|
||||
|
||||
This is an alias for preexec
|
||||
label(exec)
|
||||
dit(bf(exec (S)))
|
||||
|
||||
This is a synonym for link(bf(preexec))(preexec).
|
||||
|
||||
|
||||
label(fake directory create times)
|
||||
dit(bf(fake directory create times (S)))
|
||||
|
||||
.SS fake directory create times (S)
|
||||
NTFS and Windows VFAT file systems keep a create time for all files
|
||||
and directories. This is not the same as the ctime - status change
|
||||
time - that Unix keeps, so Samba by default reports the earliest
|
||||
of the various times Unix does keep. Setting this parameter for a
|
||||
share causes Samba to always report midnight 1-1-1980 as
|
||||
the create time for directories.
|
||||
time - that Unix keeps, so Samba by default reports the earliest of
|
||||
the various times Unix does keep. Setting this parameter for a share
|
||||
causes Samba to always report midnight 1-1-1980 as the create time for
|
||||
directories.
|
||||
|
||||
This option is mainly used as a compatibility option for Visual C++
|
||||
when used against Samba shares. Visual C++ generated makefiles
|
||||
have the object directory as a dependency for each object file,
|
||||
and a make rule to create the directory. Also, when NMAKE
|
||||
compares timestamps it uses the creation time when examining
|
||||
a directory. Thus the object directory will be created if it does
|
||||
not exist, but once it does exist it will always have an earlier
|
||||
timestamp than the object files it contains.
|
||||
This option is mainly used as a compatibility option for Visual C++
|
||||
when used against Samba shares. Visual C++ generated makefiles have
|
||||
the object directory as a dependency for each object file, and a make
|
||||
rule to create the directory. Also, when NMAKE compares timestamps it
|
||||
uses the creation time when examining a directory. Thus the object
|
||||
directory will be created if it does not exist, but once it does exist
|
||||
it will always have an earlier timestamp than the object files it
|
||||
contains.
|
||||
|
||||
However, Unix time semantics mean that the create time reported
|
||||
by Samba will be updated whenever a file is created or deleted
|
||||
in the directory. NMAKE therefore finds all object files in the
|
||||
object directory bar the last one built are out of date compared
|
||||
to the directory and rebuilds them. Enabling this option ensures
|
||||
directories always predate their contents and an NMAKE build will
|
||||
proceed as expected.
|
||||
However, Unix time semantics mean that the create time reported by
|
||||
Samba will be updated whenever a file is created or deleted in the
|
||||
directory. NMAKE therefore finds all object files in the object
|
||||
directory bar the last one built are out of date compared to the
|
||||
directory and rebuilds them. Enabling this option ensures directories
|
||||
always predate their contents and an NMAKE build will proceed as
|
||||
expected.
|
||||
|
||||
.B Default:
|
||||
bf(Default:)
|
||||
fake directory create times = False
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
fake directory create times = True
|
||||
|
||||
.SS fake oplocks (S)
|
||||
label(fakeoplocks)
|
||||
dit(bf(fake oplocks (S)))
|
||||
|
||||
Oplocks are the way that SMB clients get permission from a server to
|
||||
locally cache file operations. If a server grants an oplock
|
||||
@ -1925,158 +1953,211 @@ only one accessing the file and it will aggressively cache file
|
||||
data. With some oplock types the client may even cache file open/close
|
||||
operations. This can give enormous performance benefits.
|
||||
|
||||
When you set "fake oplocks = yes" Samba will always grant oplock
|
||||
requests no matter how many clients are using the file.
|
||||
When you set tt("fake oplocks = yes") link(bf(smbd))(smbd.8.html) will
|
||||
always grant oplock requests no matter how many clients are using the
|
||||
file.
|
||||
|
||||
By enabling this option on all read-only shares or shares that you know
|
||||
will only be accessed from one client at a time you will see a big
|
||||
performance improvement on many operations. If you enable this option
|
||||
on shares where multiple clients may be accessing the files read-write
|
||||
at the same time you can get data corruption. Use this option
|
||||
carefully!
|
||||
It is generally much better to use the real link(bf(oplock))(oplock)
|
||||
support rather than this parameter.
|
||||
|
||||
It is generally much better to use the real oplock support except for
|
||||
physically read-only media such as CDROMs.
|
||||
If you enable this option on all read-only shares or shares that you
|
||||
know will only be accessed from one client at a time such as
|
||||
physically read-only media like CDROMs, you will see a big performance
|
||||
improvement on many operations. If you enable this option on shares
|
||||
where multiple clients may be accessing the files read-write at the
|
||||
same time you can get data corruption. Use this option carefully!
|
||||
|
||||
This option is disabled by default.
|
||||
|
||||
.SS follow symlinks (S)
|
||||
label(followsymlinks)
|
||||
dit(bf(follow symlinks (S)))
|
||||
|
||||
This parameter allows the Samba administrator to stop smbd from
|
||||
following symbolic links in a particular share. Setting this
|
||||
parameter to "No" prevents any file or directory that is a
|
||||
symbolic link from being followed (the user will get an error).
|
||||
This option is very useful to stop users from adding a symbolic
|
||||
link to /etc/pasword in their home directory for instance.
|
||||
However it will slow filename lookups down slightly.
|
||||
This parameter allows the Samba administrator to stop
|
||||
link(bf(smbd))(smbd.8.html) from following symbolic links in a
|
||||
particular share. Setting this parameter to em("No") prevents any file
|
||||
or directory that is a symbolic link from being followed (the user
|
||||
will get an error). This option is very useful to stop users from
|
||||
adding a symbolic link to tt(/etc/pasword) in their home directory for
|
||||
instance. However it will slow filename lookups down slightly.
|
||||
|
||||
This option is enabled (ie. smbd will follow symbolic links)
|
||||
by default.
|
||||
This option is enabled (ie. link(bf(smbd))(smbd.8.html) will follow
|
||||
symbolic links) by default.
|
||||
|
||||
.SS force create mode (S)
|
||||
This parameter specifies a set of UNIX mode bit permissions that
|
||||
will *always* be set on a file created by Samba. This is done
|
||||
by bitwise 'OR'ing these bits onto the mode bits of a file that
|
||||
is being created. The default for this parameter is (in octel)
|
||||
000. The modes in this parameter are bitwise 'OR'ed onto the
|
||||
file mode after the mask set in the "create mask" parameter
|
||||
is applied.
|
||||
label(forcecreatemode)
|
||||
dit(bf(force create mode (S)))
|
||||
|
||||
See also the parameter "create mask" for details on masking mode
|
||||
bits on created files.
|
||||
This parameter specifies a set of UNIX mode bit permissions that will
|
||||
em(*always*) be set on a file created by Samba. This is done by
|
||||
bitwise 'OR'ing these bits onto the mode bits of a file that is being
|
||||
created. The default for this parameter is (in octel) 000. The modes
|
||||
in this parameter are bitwise 'OR'ed onto the file mode after the mask
|
||||
set in the link(bf("create mask"))(createmark) parameter is applied.
|
||||
|
||||
.B Default:
|
||||
See also the parameter link(bf("create mask"))(createmask) for details
|
||||
on masking mode bits on created files.
|
||||
|
||||
bf(Default:)
|
||||
force create mode = 000
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
force create mode = 0755
|
||||
|
||||
would force all created files to have read and execute permissions
|
||||
set for 'group' and 'other' as well as the read/write/execute bits
|
||||
set for the 'user'.
|
||||
would force all created files to have read and execute permissions set
|
||||
for 'group' and 'other' as well as the read/write/execute bits set for
|
||||
the 'user'.
|
||||
|
||||
.SS force directory mode (S)
|
||||
This parameter specifies a set of UNIX mode bit permissions that
|
||||
will *always* be set on a directory created by Samba. This is done
|
||||
by bitwise 'OR'ing these bits onto the mode bits of a directory that
|
||||
is being created. The default for this parameter is (in octel)
|
||||
0000 which will not add any extra permission bits to a created
|
||||
directory. This operation is done after the mode mask in the parameter
|
||||
"directory mask" is applied.
|
||||
label(forcedirectorymode)
|
||||
dit(bf(force directory mode (S)))
|
||||
|
||||
See also the parameter "directory mask" for details on masking mode
|
||||
bits on created directories.
|
||||
This parameter specifies a set of UNIX mode bit permissions that will
|
||||
em(*always*) be set on a directory created by Samba. This is done by
|
||||
bitwise 'OR'ing these bits onto the mode bits of a directory that is
|
||||
being created. The default for this parameter is (in octel) 0000 which
|
||||
will not add any extra permission bits to a created directory. This
|
||||
operation is done after the mode mask in the parameter
|
||||
link(bf("directory mask"))(directorymask) is applied.
|
||||
|
||||
.B Default:
|
||||
See also the parameter link(bf("directory mask"))(directorymask) for
|
||||
details on masking mode bits on created directories.
|
||||
|
||||
bf(Default:)
|
||||
force directory mode = 000
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
force directory mode = 0755
|
||||
|
||||
would force all created directories to have read and execute permissions
|
||||
set for 'group' and 'other' as well as the read/write/execute bits
|
||||
set for the 'user'.
|
||||
would force all created directories to have read and execute
|
||||
permissions set for 'group' and 'other' as well as the
|
||||
read/write/execute bits set for the 'user'.
|
||||
|
||||
.SS force group (S)
|
||||
This specifies a group name that all connections to this service
|
||||
should be made as. This may be useful for sharing files.
|
||||
label(forcegroup)
|
||||
dit(bf(force group (S)))
|
||||
|
||||
.B Default:
|
||||
This specifies a UNIX group name that will be assigned as the default
|
||||
primary group for all users connecting to this service. This is useful
|
||||
for sharing files by ensuring that all access to files on service will
|
||||
use the named group for their permissions checking. Thus, by assigning
|
||||
permissions for this group to the files and directories within this
|
||||
service the Samba administrator can restrict or allow sharing of these
|
||||
files.
|
||||
|
||||
bf(Default:)
|
||||
no forced group
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
force group = agroup
|
||||
|
||||
.SS force user (S)
|
||||
This specifies a user name that all connections to this service
|
||||
should be made as. This may be useful for sharing files. You should
|
||||
also use it carefully as using it incorrectly can cause security
|
||||
problems.
|
||||
label(forceuser)
|
||||
dit(bf(force user (S)))
|
||||
|
||||
This specifies a UNIX user name that will be assigned as the default
|
||||
user for all users connecting to this service. This is useful for
|
||||
sharing files. You should also use it carefully as using it
|
||||
incorrectly can cause security problems.
|
||||
|
||||
This user name only gets used once a connection is established. Thus
|
||||
clients still need to connect as a valid user and supply a valid
|
||||
password. Once connected, all file operations will be performed as the
|
||||
"forced user", not matter what username the client connected as.
|
||||
tt("forced user"), no matter what username the client connected as.
|
||||
|
||||
.B Default:
|
||||
This can be very useful
|
||||
bf(Default:)
|
||||
no forced user
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
force user = auser
|
||||
|
||||
.SS getwd cache (G)
|
||||
This is a tuning option. When this is enabled a cacheing algorithm will
|
||||
be used to reduce the time taken for getwd() calls. This can have a
|
||||
significant impact on performance, especially when widelinks is False.
|
||||
label(fstype)
|
||||
dit(bf(fstype (S)))
|
||||
|
||||
.B Default:
|
||||
This parameter allows the administrator to configure the string that
|
||||
specifies the type of filesystem a share is using that is reported by
|
||||
link(bf(smbd))(smbd.8.html) when a client queries the filesystem type
|
||||
for a share. The default type is bf("NTFS") for compatibility with
|
||||
Windows NT but this can be changed to other strings such as "Samba" or
|
||||
"FAT" if required.
|
||||
|
||||
bf(Default:)
|
||||
fstype = NTFS
|
||||
|
||||
bf(Example:)
|
||||
fstype = Samba
|
||||
|
||||
label(getwdcache)
|
||||
dit(bf(getwd cache (G)))
|
||||
|
||||
This is a tuning option. When this is enabled a cacheing algorithm
|
||||
will be used to reduce the time taken for getwd() calls. This can have
|
||||
a significant impact on performance, especially when the
|
||||
link(bf(widelinks))(widelinks) parameter is set to False.
|
||||
|
||||
bf(Default:)
|
||||
getwd cache = No
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
getwd cache = Yes
|
||||
|
||||
.SS group (S)
|
||||
This is an alias for "force group" and is only kept for compatibility
|
||||
with old versions of Samba. It may be removed in future versions.
|
||||
label(group)
|
||||
dit(bf(group (S)))
|
||||
|
||||
Synonym for link(bf("force group"))(forcegroup).
|
||||
|
||||
label(guestaccount)
|
||||
dit(bf(guest account (S)))
|
||||
|
||||
.SS guest account (S)
|
||||
This is a username which will be used for access to services which are
|
||||
specified as 'guest ok' (see below). Whatever privileges this user has
|
||||
will be available to any client connecting to the guest
|
||||
service. Typically this user will exist in the password file, but will
|
||||
not have a valid login. If a username is specified in a given service,
|
||||
the specified username overrides this one.
|
||||
specified as link(bf('guest ok'))(guestok) (see below). Whatever
|
||||
privileges this user has will be available to any client connecting to
|
||||
the guest service. Typically this user will exist in the password
|
||||
file, but will not have a valid login. The user account bf("ftp") is
|
||||
often a good choice for this parameter. If a username is specified in
|
||||
a given service, the specified username overrides this one.
|
||||
|
||||
One some systems the account "nobody" may not be able to print. Use
|
||||
another account in this case. You should test this by trying to log in
|
||||
as your guest user (perhaps by using the "su \-" command) and trying to
|
||||
print using
|
||||
.BR lpr .
|
||||
One some systems the default guest account "nobody" may not be able to
|
||||
print. Use another account in this case. You should test this by
|
||||
trying to log in as your guest user (perhaps by using the tt("su -")
|
||||
command) and trying to print using the system print command such as
|
||||
bf(lpr (1)) or bf(lp (1)).
|
||||
|
||||
Note that as of version 1.9 of Samba this option may be set
|
||||
differently for each service.
|
||||
bf(Default:)
|
||||
specified at compile time, usually "nobody"
|
||||
|
||||
.B Default:
|
||||
specified at compile time
|
||||
bf(Example:)
|
||||
guest account = ftp
|
||||
|
||||
.B Example:
|
||||
guest account = nobody
|
||||
.SS guest ok (S)
|
||||
See
|
||||
.B public.
|
||||
.SS guest only (S)
|
||||
If this parameter is 'yes' for a service, then only guest connections to the
|
||||
service are permitted. This parameter will have no affect if "guest ok" or
|
||||
"public" is not set for the service.
|
||||
label(guestok)
|
||||
dit(bf(guest ok (S)))
|
||||
|
||||
See the section below on user/password validation for more information about
|
||||
this option.
|
||||
If this parameter is em('yes') for a service, then no password is
|
||||
required to connect to the service. Privileges will be those of the
|
||||
link(bf(guest account))(guestaccount).
|
||||
|
||||
.B Default:
|
||||
See the section below on link(bf(security))(security) for more
|
||||
information about this option.
|
||||
|
||||
bf(Default:)
|
||||
guest ok = no
|
||||
|
||||
bf(Example:)
|
||||
guest ok = yes
|
||||
|
||||
label(guestonly)
|
||||
dit(bf(guest only (S)))
|
||||
|
||||
If this parameter is em('yes') for a service, then only guest
|
||||
connections to the service are permitted. This parameter will have no
|
||||
affect if link(bf("guest ok"))(guestok) or link(bf("public"))(public)
|
||||
is not set for the service.
|
||||
|
||||
See the section below on link(bf(security))(security) for more
|
||||
information about this option.
|
||||
|
||||
bf(Default:)
|
||||
guest only = no
|
||||
|
||||
.B Example:
|
||||
bf(Example:)
|
||||
guest only = yes
|
||||
|
||||
.SS hide dot files (S)
|
||||
This is a boolean parameter that controls whether files starting with
|
||||
a dot appear as hidden files.
|
||||
@ -3622,19 +3703,6 @@ phase in the SMB protocol takes care of choosing the appropriate protocol.
|
||||
.SS public (S)
|
||||
A synonym for this parameter is 'guest ok'.
|
||||
|
||||
If this parameter is 'yes' for a service, then no password is required
|
||||
to connect to the service. Privileges will be those of the guest
|
||||
account.
|
||||
|
||||
See the section below on user/password validation for more information about
|
||||
this option.
|
||||
|
||||
.B Default:
|
||||
public = no
|
||||
|
||||
.B Example:
|
||||
public = yes
|
||||
|
||||
.SS queuepause command (S)
|
||||
This parameter specifies the command to be executed on the server host in
|
||||
order to pause the printerqueue.
|
||||
|
Reference in New Issue
Block a user