From 6ab278b85719cb390de316a9632f710d235b2ced Mon Sep 17 00:00:00 2001 From: Alexander Bokovoy Date: Mon, 14 Apr 2003 22:59:57 +0000 Subject: Convert a part of Misc section. More to come after a sleep (This used to be commit 1093c11fd47e5f4a76ce88ac77be2c3e9b1bc694) --- docs/docbook/smbdotconf/misc/addsharecommand.xml | 90 ++++++++++++---------- docs/docbook/smbdotconf/misc/autoservices.xml | 15 ++-- .../docbook/smbdotconf/misc/changesharecommand.xml | 88 ++++++++++++--------- docs/docbook/smbdotconf/misc/configfile.xml | 37 +++++---- docs/docbook/smbdotconf/misc/defaultservice.xml | 48 ++++++------ .../docbook/smbdotconf/misc/deletesharecommand.xml | 79 ++++++++++--------- docs/docbook/smbdotconf/misc/lockdir.xml | 14 ++-- docs/docbook/smbdotconf/misc/lockdirectory.xml | 24 +++--- docs/docbook/smbdotconf/misc/piddirectory.xml | 20 +++-- docs/docbook/smbdotconf/misc/preload.xml | 29 +++---- docs/docbook/smbdotconf/misc/utmp.xml | 39 +++++----- docs/docbook/smbdotconf/misc/utmpdirectory.xml | 34 ++++---- docs/docbook/smbdotconf/misc/wtmpdirectory.xml | 40 +++++----- 13 files changed, 311 insertions(+), 246 deletions(-) diff --git a/docs/docbook/smbdotconf/misc/addsharecommand.xml b/docs/docbook/smbdotconf/misc/addsharecommand.xml index 233d3e7dc4..bd5f2101db 100644 --- a/docs/docbook/smbdotconf/misc/addsharecommand.xml +++ b/docs/docbook/smbdotconf/misc/addsharecommand.xml @@ -1,51 +1,63 @@ - - add share command (G) - Samba 2.2.0 introduced the ability to dynamically - add and delete shares via the Windows NT 4.0 Server Manager. The - add share command is used to define an - external program or script which will add a new service definition - to smb.conf. In order to successfully - execute the add share command, smbd - requires that the administrator be connected using a root account (i.e. - uid == 0). - + + + Samba 2.2.0 introduced the ability to dynamically + add and delete shares via the Windows NT 4.0 Server Manager. The + add share command is used to define an + external program or script which will add a new service definition + to smb.conf. In order to successfully + execute the add share command, smbd + requires that the administrator be connected using a root account (i.e. + uid == 0). + - - When executed, smbd will automatically invoke the - add share command with four parameters. - + + When executed, smbd will automatically invoke the + add share command with four parameters. + - - configFile - the location + + + configFile - the location of the global smb.conf file. - + + - shareName - the name of the new + + shareName - the name of the new share. - + + - pathName - path to an **existing** + + pathName - path to an **existing** directory on disk. - + + - comment - comment string to associate + + comment - comment string to associate with the new share. - - + + + - - This parameter is only used for add file shares. To add printer shares, - see the addprinter - command. - + + This parameter is only used for add file shares. To add printer shares, + see the addprinter + command. + - - See also change share - command, delete share - command. - + + See also change share + command, delete share + command. + - Default: none - Example: add share command = /usr/local/bin/addshare - - + Default: none + + Example: add share command = /usr/local/bin/addshare + + diff --git a/docs/docbook/smbdotconf/misc/autoservices.xml b/docs/docbook/smbdotconf/misc/autoservices.xml index d137f650f8..d94997a6ce 100644 --- a/docs/docbook/smbdotconf/misc/autoservices.xml +++ b/docs/docbook/smbdotconf/misc/autoservices.xml @@ -1,6 +1,9 @@ - - auto services (G) - This is a synonym for the - preload. - - + + + This is a synonym for the + preload. + + diff --git a/docs/docbook/smbdotconf/misc/changesharecommand.xml b/docs/docbook/smbdotconf/misc/changesharecommand.xml index 3fb494c513..d0116594c0 100644 --- a/docs/docbook/smbdotconf/misc/changesharecommand.xml +++ b/docs/docbook/smbdotconf/misc/changesharecommand.xml @@ -1,50 +1,62 @@ - - change share command (G) - Samba 2.2.0 introduced the ability to dynamically - add and delete shares via the Windows NT 4.0 Server Manager. The - change share command is used to define an - external program or script which will modify an existing service definition - in smb.conf. In order to successfully - execute the change share command, smbd - requires that the administrator be connected using a root account (i.e. - uid == 0). - + + + Samba 2.2.0 introduced the ability to dynamically + add and delete shares via the Windows NT 4.0 Server Manager. The + change share command is used to define an + external program or script which will modify an existing service definition + in smb.conf. In order to successfully + execute the change share command, smbd + requires that the administrator be connected using a root account (i.e. + uid == 0). + - - When executed, smbd will automatically invoke the - change share command with four parameters. - + + When executed, smbd will automatically invoke the + change share command with four parameters. + - - configFile - the location + + + configFile - the location of the global smb.conf file. - + + - shareName - the name of the new + + shareName - the name of the new share. - + + - pathName - path to an **existing** + + pathName - path to an **existing** directory on disk. - + + - comment - comment string to associate + + comment - comment string to associate with the new share. - - + + + - - This parameter is only used modify existing file shares definitions. To modify - printer shares, use the "Printers..." folder as seen when browsing the Samba host. - + + This parameter is only used modify existing file shares definitions. To modify + printer shares, use the "Printers..." folder as seen when browsing the Samba host. + - - See also add share - command, delete - share command. - + + See also add share + command, delete + share command. + - Default: none - Example: change share command = /usr/local/bin/addshare - - + Default: none + + Example: change share command = /usr/local/bin/addshare + + diff --git a/docs/docbook/smbdotconf/misc/configfile.xml b/docs/docbook/smbdotconf/misc/configfile.xml index 3edf611b55..855b6460fe 100644 --- a/docs/docbook/smbdotconf/misc/configfile.xml +++ b/docs/docbook/smbdotconf/misc/configfile.xml @@ -1,21 +1,24 @@ - - config file (G) - This allows you to override the config file - to use, instead of the default (usually smb.conf). - There is a chicken and egg problem here as this option is set - in the config file! + + + This allows you to override the config file + to use, instead of the default (usually smb.conf). + There is a chicken and egg problem here as this option is set + in the config file! - For this reason, if the name of the config file has changed - when the parameters are loaded then it will reload them from - the new config file. + For this reason, if the name of the config file has changed + when the parameters are loaded then it will reload them from + the new config file. - This option takes the usual substitutions, which can - be very useful. + This option takes the usual substitutions, which can + be very useful. - If the config file doesn't exist then it won't be loaded - (allowing you to special case the config files of just a few - clients). + If the config file doesn't exist then it won't be loaded + (allowing you to special case the config files of just a few + clients). - Example: config file = /usr/local/samba/lib/smb.conf.%m - - + Example: config file = /usr/local/samba/lib/smb.conf.%m + + diff --git a/docs/docbook/smbdotconf/misc/defaultservice.xml b/docs/docbook/smbdotconf/misc/defaultservice.xml index 7aeedb177a..39e467b1d1 100644 --- a/docs/docbook/smbdotconf/misc/defaultservice.xml +++ b/docs/docbook/smbdotconf/misc/defaultservice.xml @@ -1,29 +1,31 @@ - - default service (G) - This parameter specifies the name of a service - which will be connected to if the service actually requested cannot - be found. Note that the square brackets are NOT - given in the parameter value (see example below). + + + This parameter specifies the name of a service + which will be connected to if the service actually requested cannot + be found. Note that the square brackets are NOT + given in the parameter value (see example below). - 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. + 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 - guest ok, - read-only service. + Typically the default service would be a + guest ok, + read-only 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 macros like %S to make - a wildcard 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 macros like %S to make + a wildcard service. - Note also that any "_" characters in the name of the service - used in the default service will get mapped to a "/". This allows for - interesting things. + Note also that any "_" characters in the name of the service + used in the default service will get mapped to a "/". This allows for + interesting things. - - Example: + Example: [global] @@ -32,5 +34,5 @@ [pub] path = /%S - - + + diff --git a/docs/docbook/smbdotconf/misc/deletesharecommand.xml b/docs/docbook/smbdotconf/misc/deletesharecommand.xml index c3481c86ec..cf60b27752 100644 --- a/docs/docbook/smbdotconf/misc/deletesharecommand.xml +++ b/docs/docbook/smbdotconf/misc/deletesharecommand.xml @@ -1,44 +1,51 @@ - - delete share command (G) - Samba 2.2.0 introduced the ability to dynamically - add and delete shares via the Windows NT 4.0 Server Manager. The - delete share command is used to define an - external program or script which will remove an existing service - definition from smb.conf. In order to successfully - execute the delete share command, smbd - requires that the administrator be connected using a root account (i.e. - uid == 0). - + + + Samba 2.2.0 introduced the ability to dynamically + add and delete shares via the Windows NT 4.0 Server Manager. The + delete share command is used to define an + external program or script which will remove an existing service + definition from smb.conf. In order to successfully + execute the delete share command, smbd + requires that the administrator be connected using a root account (i.e. + uid == 0). + - - When executed, smbd will automatically invoke the - delete share command with two parameters. - + + When executed, smbd will automatically invoke the + delete share command with two parameters. + - - configFile - the location + + + configFile - the location of the global smb.conf file. - + + - shareName - the name of + + shareName - the name of the existing service. - - - - - This parameter is only used to remove file shares. To delete printer shares, - see the deleteprinter - command. - + + + - - See also add share - command, change - share command. - + + This parameter is only used to remove file shares. To delete printer shares, + see the deleteprinter + command. + - Default: none - Example: delete share command = /usr/local/bin/delshare + + See also add share + command, change + share command. + - - + Default: none + + Example: delete share command = /usr/local/bin/delshare + + diff --git a/docs/docbook/smbdotconf/misc/lockdir.xml b/docs/docbook/smbdotconf/misc/lockdir.xml index 2c29b9b61c..4e5f6bce85 100644 --- a/docs/docbook/smbdotconf/misc/lockdir.xml +++ b/docs/docbook/smbdotconf/misc/lockdir.xml @@ -1,5 +1,9 @@ - - lock dir (G) - Synonym for - lock directory. - + + + Synonym for + lock directory. + + diff --git a/docs/docbook/smbdotconf/misc/lockdirectory.xml b/docs/docbook/smbdotconf/misc/lockdirectory.xml index 7945f19864..c877566b31 100644 --- a/docs/docbook/smbdotconf/misc/lockdirectory.xml +++ b/docs/docbook/smbdotconf/misc/lockdirectory.xml @@ -1,11 +1,15 @@ - - lock directory (G) - This option specifies the directory where lock - files will be placed. The lock files are used to implement the - max connections - option. + + + This option specifies the directory where lock + files will be placed. The lock files are used to implement the + max connections + option. - Default: lock directory = ${prefix}/var/locks - Example: lock directory = /var/run/samba/locks - - + Default: lock directory = ${prefix}/var/locks + + Example: lock directory = /var/run/samba/locks + + diff --git a/docs/docbook/smbdotconf/misc/piddirectory.xml b/docs/docbook/smbdotconf/misc/piddirectory.xml index 81c1b13e75..b526a80221 100644 --- a/docs/docbook/smbdotconf/misc/piddirectory.xml +++ b/docs/docbook/smbdotconf/misc/piddirectory.xml @@ -1,9 +1,13 @@ - - pid directory (G) - This option specifies the directory where pid - files will be placed. + + + This option specifies the directory where pid + files will be placed. - Default: pid directory = ${prefix}/var/locks - Example: pid directory = /var/run/ - - + Default: pid directory = ${prefix}/var/locks + + Example: pid directory = /var/run/ + + diff --git a/docs/docbook/smbdotconf/misc/preload.xml b/docs/docbook/smbdotconf/misc/preload.xml index 574ed1a369..96b59e3a43 100644 --- a/docs/docbook/smbdotconf/misc/preload.xml +++ b/docs/docbook/smbdotconf/misc/preload.xml @@ -1,16 +1,19 @@ - - preload (G) - This is a list of services that you want to be - automatically added to the browse lists. This is most useful - for homes and printers services that would otherwise not be - visible. + + + This is a list of services that you want to be + automatically added to the browse lists. This is most useful + for homes and printers services that would otherwise not be + visible. - Note that if you just want all printers in your - printcap file loaded then the - load printers option is easier. + Note that if you just want all printers in your + printcap file loaded then the + load printers option is easier. - Default: no preloaded services + Default: no preloaded services - Example: preload = fred lp colorlp - - + Example: preload = fred lp colorlp + + diff --git a/docs/docbook/smbdotconf/misc/utmp.xml b/docs/docbook/smbdotconf/misc/utmp.xml index 014b85d6bc..3dfa7caa5d 100644 --- a/docs/docbook/smbdotconf/misc/utmp.xml +++ b/docs/docbook/smbdotconf/misc/utmp.xml @@ -1,21 +1,24 @@ - - utmp (G) - This boolean parameter is only available if - Samba has been configured and compiled with the option - --with-utmp. If set to yes then Samba will attempt - to add utmp or utmpx records (depending on the UNIX system) whenever a - connection is made to a Samba server. Sites may use this to record the - user connecting to a Samba share. + + + This boolean parameter is only available if + Samba has been configured and compiled with the option + --with-utmp. If set to yes then Samba will attempt + to add utmp or utmpx records (depending on the UNIX system) whenever a + connection is made to a Samba server. Sites may use this to record the + user connecting to a Samba share. - Due to the requirements of the utmp record, we - are required to create a unique identifier for the - incoming user. Enabling this option creates an n^2 - algorithm to find this number. This may impede - performance on large installations. + Due to the requirements of the utmp record, we + are required to create a unique identifier for the + incoming user. Enabling this option creates an n^2 + algorithm to find this number. This may impede + performance on large installations. - See also the - utmp directory parameter. + See also the + utmp directory parameter. - Default: utmp = no - - + Default: utmp = no + + diff --git a/docs/docbook/smbdotconf/misc/utmpdirectory.xml b/docs/docbook/smbdotconf/misc/utmpdirectory.xml index 9e5574fb39..3b50c3db29 100644 --- a/docs/docbook/smbdotconf/misc/utmpdirectory.xml +++ b/docs/docbook/smbdotconf/misc/utmpdirectory.xml @@ -1,16 +1,20 @@ - - utmp 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 utmp or utmpx files (depending on the UNIX system) that - record user connections to a Samba server. 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/utmp on Linux). + + + 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 utmp or utmpx files (depending on the UNIX system) that + record user connections to a Samba server. 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/utmp on Linux). - Default: no utmp directory - Example: utmp directory = /var/run/utmp - - + Default: no utmp directory + + Example: utmp directory = /var/run/utmp + + diff --git a/docs/docbook/smbdotconf/misc/wtmpdirectory.xml b/docs/docbook/smbdotconf/misc/wtmpdirectory.xml index bb144473ff..2448edfadb 100644 --- a/docs/docbook/smbdotconf/misc/wtmpdirectory.xml +++ b/docs/docbook/smbdotconf/misc/wtmpdirectory.xml @@ -1,20 +1,24 @@ - - 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. + + + 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). + 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 - - + Default: no wtmp directory + + Example: wtmp directory = /var/log/wtmp + + -- cgit