From 27eb9d97373c772a2a74d6b0fd27dbabbe7e5912 Mon Sep 17 00:00:00 2001 From: Alexander Bokovoy Date: Tue, 15 Apr 2003 08:09:55 +0000 Subject: Convert another group of options in Misc section (This used to be commit 43f8ae46137ed653c5694a839a5e6757e4a89974) --- docs/docbook/smbdotconf/misc/available.xml | 22 ++++++------ docs/docbook/smbdotconf/misc/dontdescend.xml | 35 +++++++++--------- docs/docbook/smbdotconf/misc/followsymlinks.xml | 35 +++++++++--------- docs/docbook/smbdotconf/misc/fstype.xml | 30 +++++++++------- docs/docbook/smbdotconf/misc/postexec.xml | 34 +++++++++--------- docs/docbook/smbdotconf/misc/preexecclose.xml | 19 +++++----- docs/docbook/smbdotconf/misc/rootpostexec.xml | 26 +++++++------- docs/docbook/smbdotconf/misc/rootpreexec.xml | 28 ++++++++------- docs/docbook/smbdotconf/misc/rootpreexecclose.xml | 23 ++++++------ docs/docbook/smbdotconf/misc/setdirectory.xml | 24 +++++++------ docs/docbook/smbdotconf/misc/sourceenvironment.xml | 42 ++++++++++++---------- docs/docbook/smbdotconf/misc/volume.xml | 18 +++++----- docs/docbook/smbdotconf/misc/widelinks.xml | 28 ++++++++------- 13 files changed, 198 insertions(+), 166 deletions(-) (limited to 'docs') diff --git a/docs/docbook/smbdotconf/misc/available.xml b/docs/docbook/smbdotconf/misc/available.xml index 025c1c06fb..20931b3063 100644 --- a/docs/docbook/smbdotconf/misc/available.xml +++ b/docs/docbook/smbdotconf/misc/available.xml @@ -1,11 +1,13 @@ - - available (S) - This parameter lets you "turn off" a service. If - available = no, then ALL - attempts to connect to the service will fail. Such failures are - logged. + + + This parameter lets you "turn off" a service. If + available = no, then ALL + attempts to connect to the service will fail. Such failures are + logged. - Default: available = yes - - - + Default: available = yes + + diff --git a/docs/docbook/smbdotconf/misc/dontdescend.xml b/docs/docbook/smbdotconf/misc/dontdescend.xml index 8136f293df..d3e9fb2d5c 100644 --- a/docs/docbook/smbdotconf/misc/dontdescend.xml +++ b/docs/docbook/smbdotconf/misc/dontdescend.xml @@ -1,18 +1,21 @@ - - dont descend (S) - There are certain directories on some systems - (e.g., 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. + + + There are certain directories on some systems + (e.g., 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. - 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 :-) + 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 :-) - Default: none (i.e., all directories are OK - to descend) - Example: dont descend = /proc,/dev - - + Default: none (i.e., all directories are OK + to descend) + + Example: dont descend = /proc,/dev + + diff --git a/docs/docbook/smbdotconf/misc/followsymlinks.xml b/docs/docbook/smbdotconf/misc/followsymlinks.xml index 88526da320..1b22eb9e64 100644 --- a/docs/docbook/smbdotconf/misc/followsymlinks.xml +++ b/docs/docbook/smbdotconf/misc/followsymlinks.xml @@ -1,18 +1,21 @@ - - follow symlinks (S) - This parameter allows the Samba administrator - to stop smbd - 8 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/passwd in their home - directory for instance. However it will slow filename lookups - down slightly. + + + This parameter allows the Samba administrator + to stop smbd + 8 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/passwd in their home + directory for instance. However it will slow filename lookups + down slightly. - This option is enabled (i.e. smbd will - follow symbolic links) by default. + This option is enabled (i.e. smbd will + follow symbolic links) by default. - Default: follow symlinks = yes - + Default: follow symlinks = yes + + diff --git a/docs/docbook/smbdotconf/misc/fstype.xml b/docs/docbook/smbdotconf/misc/fstype.xml index 566bccb465..4b9c67b202 100644 --- a/docs/docbook/smbdotconf/misc/fstype.xml +++ b/docs/docbook/smbdotconf/misc/fstype.xml @@ -1,14 +1,18 @@ - - fstype (S) - This parameter allows the administrator to - configure the string that specifies the type of filesystem a share - is using that is reported by smbd - 8 when a client queries the filesystem type - for a share. The default type is NTFS for - compatibility with Windows NT but this can be changed to other - strings such as Samba or FAT - if required. + + + This parameter allows the administrator to + configure the string that specifies the type of filesystem a share + is using that is reported by smbd + 8 when a client queries the filesystem type + for a share. The default type is NTFS for + compatibility with Windows NT but this can be changed to other + strings such as Samba or FAT + if required. - Default: fstype = NTFS - Example: fstype = Samba - + Default: fstype = NTFS + + Example: fstype = Samba + + diff --git a/docs/docbook/smbdotconf/misc/postexec.xml b/docs/docbook/smbdotconf/misc/postexec.xml index 017177be3d..a6b65515ad 100644 --- a/docs/docbook/smbdotconf/misc/postexec.xml +++ b/docs/docbook/smbdotconf/misc/postexec.xml @@ -1,22 +1,22 @@ - - postexec (S) - This option specifies a command to be run - whenever the service is disconnected. It takes the usual - substitutions. The command may be run as the root on some - systems. + + + This option specifies a command to be run + whenever the service is disconnected. It takes the usual + substitutions. The command may be run as the root on some + systems. - An interesting example may be to unmount server - resources: + An interesting example may be to unmount server + resources: - postexec = /etc/umount /cdrom + postexec = /etc/umount /cdrom - See also preexec - . + See also preexec. - Default: none (no command executed) - + Default: none (no command executed) - Example: postexec = echo \"%u disconnected from %S - from %m (%I)\" >> /tmp/log - - + Example: postexec = echo \"%u disconnected from %S from %m (%I)\" >> /tmp/log + + diff --git a/docs/docbook/smbdotconf/misc/preexecclose.xml b/docs/docbook/smbdotconf/misc/preexecclose.xml index c617a7f7fa..346d21dbd8 100644 --- a/docs/docbook/smbdotconf/misc/preexecclose.xml +++ b/docs/docbook/smbdotconf/misc/preexecclose.xml @@ -1,9 +1,12 @@ - - preexec close (S) - This boolean option controls whether a non-zero - return code from preexec - should close the service being connected to. + + + This boolean option controls whether a non-zero + return code from preexec + should close the service being connected to. - Default: preexec close = no - - + Default: preexec close = no + + diff --git a/docs/docbook/smbdotconf/misc/rootpostexec.xml b/docs/docbook/smbdotconf/misc/rootpostexec.xml index ed60646677..baed004327 100644 --- a/docs/docbook/smbdotconf/misc/rootpostexec.xml +++ b/docs/docbook/smbdotconf/misc/rootpostexec.xml @@ -1,14 +1,16 @@ - - root postexec (S) - This is the same as the postexec - parameter except that the command is run as root. This - is useful for unmounting filesystems - (such as CDROMs) after a connection is closed. + + + This is the same as the postexec + parameter except that the command is run as root. This + is useful for unmounting filesystems + (such as CDROMs) after a connection is closed. - See also - postexec. + See also + postexec. - Default: root postexec = <empty string> - - - + Default: root postexec = <empty string> + + diff --git a/docs/docbook/smbdotconf/misc/rootpreexec.xml b/docs/docbook/smbdotconf/misc/rootpreexec.xml index 29802b6d63..4939d1ee48 100644 --- a/docs/docbook/smbdotconf/misc/rootpreexec.xml +++ b/docs/docbook/smbdotconf/misc/rootpreexec.xml @@ -1,15 +1,17 @@ - - root preexec (S) - This is the same as the preexec - parameter except that the command is run as root. This - is useful for mounting filesystems (such as CDROMs) when a - connection is opened. + + + This is the same as the preexec + parameter except that the command is run as root. This + is useful for mounting filesystems (such as CDROMs) when a + connection is opened. - See also - preexec and - preexec close. + See also + preexec and + preexec close. - Default: root preexec = <empty string> - - - + Default: root preexec = <empty string> + + diff --git a/docs/docbook/smbdotconf/misc/rootpreexecclose.xml b/docs/docbook/smbdotconf/misc/rootpreexecclose.xml index d21b0dd7b5..b333cffe90 100644 --- a/docs/docbook/smbdotconf/misc/rootpreexecclose.xml +++ b/docs/docbook/smbdotconf/misc/rootpreexecclose.xml @@ -1,12 +1,15 @@ - - root preexec close (S) - This is the same as the preexec close - parameter except that the command is run as root. + + + This is the same as the preexec close + parameter except that the command is run as root. - See also - preexec and - preexec close. + See also + preexec and + preexec close. - Default: root preexec close = no - - + Default: root preexec close = no + + diff --git a/docs/docbook/smbdotconf/misc/setdirectory.xml b/docs/docbook/smbdotconf/misc/setdirectory.xml index 860632cdaf..b4ff72d4d0 100644 --- a/docs/docbook/smbdotconf/misc/setdirectory.xml +++ b/docs/docbook/smbdotconf/misc/setdirectory.xml @@ -1,13 +1,15 @@ - - set directory (S) - If set directory = no, then - users of the service may not use the setdir command to change - directory. + + + If set directory = no, then + users of the service may not use the setdir command to change + directory. - The setdir command is only implemented - in the Digital Pathworks client. See the Pathworks documentation - for details. + The setdir command is only implemented + in the Digital Pathworks client. See the Pathworks documentation + for details. - Default: set directory = no - - + Default: set directory = no + + diff --git a/docs/docbook/smbdotconf/misc/sourceenvironment.xml b/docs/docbook/smbdotconf/misc/sourceenvironment.xml index 07a8abce4d..c6b4ce368f 100644 --- a/docs/docbook/smbdotconf/misc/sourceenvironment.xml +++ b/docs/docbook/smbdotconf/misc/sourceenvironment.xml @@ -1,23 +1,27 @@ - - source environment (G) - This parameter causes Samba to set environment - variables as per the content of the file named. + + + This parameter causes Samba to set environment + variables as per the content of the file named. - If the value of this parameter starts with a "|" character - then Samba will treat that value as a pipe command to open and - will set the environment variables from the output of the pipe. + If the value of this parameter starts with a "|" character + then Samba will treat that value as a pipe command to open and + will set the environment variables from the output of the pipe. - The contents of the file or the output of the pipe should - be formatted as the output of the standard Unix env(1) - command. This is of the form : - Example environment entry: - SAMBA_NETBIOS_NAME = myhostname + The contents of the file or the output of the pipe should + be formatted as the output of the standard Unix env(1) command. This is of the form: - Default: No default value - Examples: source environment = |/etc/smb.conf.sh - + Example environment entry: - Example: source environment = - /usr/local/smb_env_vars - - + SAMBA_NETBIOS_NAME = myhostname + + Default: No default value + + Examples: source environment = |/etc/smb.conf.sh + + Example: source environment = + /usr/local/smb_env_vars + + diff --git a/docs/docbook/smbdotconf/misc/volume.xml b/docs/docbook/smbdotconf/misc/volume.xml index f0a82c6f0c..0ab5edb522 100644 --- a/docs/docbook/smbdotconf/misc/volume.xml +++ b/docs/docbook/smbdotconf/misc/volume.xml @@ -1,9 +1,11 @@ - - volume (S) - This allows you to override the volume label - returned for a share. Useful for CDROMs with installation programs - that insist on a particular volume label. + + + This allows you to override the volume label + returned for a share. Useful for CDROMs with installation programs + that insist on a particular volume label. - Default: the name of the share - - + Default: the name of the share + + diff --git a/docs/docbook/smbdotconf/misc/widelinks.xml b/docs/docbook/smbdotconf/misc/widelinks.xml index b3474ce26c..ead3569fd9 100644 --- a/docs/docbook/smbdotconf/misc/widelinks.xml +++ b/docs/docbook/smbdotconf/misc/widelinks.xml @@ -1,15 +1,17 @@ - - wide links (S) - This parameter controls whether or not links - in the UNIX file system may be followed by the server. Links - that point to areas within the directory tree exported by the - server are always allowed; this parameter controls access only - to areas that are outside the directory tree being exported. + + + This parameter controls whether or not links + in the UNIX file system may be followed by the server. Links + that point to areas within the directory tree exported by the + server are always allowed; this parameter controls access only + to areas that are outside the directory tree being exported. - Note that setting this parameter can have a negative - effect on your server performance due to the extra system calls - that Samba has to do in order to perform the link checks. + Note that setting this parameter can have a negative + effect on your server performance due to the extra system calls + that Samba has to do in order to perform the link checks. - Default: wide links = yes - - + Default: wide links = yes + + -- cgit