From 7d19f81d96d8474c5ab7a9d950b1e32b41baf8c8 Mon Sep 17 00:00:00 2001 From: Alexander Bokovoy Date: Fri, 11 Apr 2003 14:46:50 +0000 Subject: Finish conversion of WINS options (This used to be commit eb7a35110eac38fb545c34f3b9e33cbd58d60fdc) --- docs/docbook/smbdotconf/wins/dnsproxy.xml | 38 +++++++------ docs/docbook/smbdotconf/wins/winshook.xml | 78 ++++++++++++++++----------- docs/docbook/smbdotconf/wins/winspartners.xml | 27 +++++----- docs/docbook/smbdotconf/wins/winsproxy.xml | 20 ++++--- docs/docbook/smbdotconf/wins/winsserver.xml | 57 +++++++++++--------- docs/docbook/smbdotconf/wins/winssupport.xml | 25 +++++---- 6 files changed, 139 insertions(+), 106 deletions(-) diff --git a/docs/docbook/smbdotconf/wins/dnsproxy.xml b/docs/docbook/smbdotconf/wins/dnsproxy.xml index fd53ae7ded..45ec160c5a 100644 --- a/docs/docbook/smbdotconf/wins/dnsproxy.xml +++ b/docs/docbook/smbdotconf/wins/dnsproxy.xml @@ -1,21 +1,25 @@ - - dns proxy (G) - Specifies that nmbd - 8 when acting as a WINS server and - finding that a NetBIOS name has not been registered, should treat the - NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server - for that name on behalf of the name-querying client. + + + Specifies that nmbd + 8 when acting as a WINS server and + finding that a NetBIOS name has not been registered, should treat the + NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server + for that name on behalf of the name-querying client. - Note that the maximum length for a NetBIOS name is 15 - characters, so the DNS name (or DNS alias) can likewise only be - 15 characters, maximum. + Note that the maximum length for a NetBIOS name is 15 + characters, so the DNS name (or DNS alias) can likewise only be + 15 characters, maximum. - nmbd spawns a second copy of itself to do the - DNS name lookup requests, as doing a name lookup is a blocking - action. + nmbd spawns a second copy of itself to do the + DNS name lookup requests, as doing a name lookup is a blocking + action. - See also the parameter - wins support. + See also the parameter + wins support. - Default: dns proxy = yes - + Default: dns proxy = yes + + diff --git a/docs/docbook/smbdotconf/wins/winshook.xml b/docs/docbook/smbdotconf/wins/winshook.xml index e0c4a87c5b..e38e93f6b5 100644 --- a/docs/docbook/smbdotconf/wins/winshook.xml +++ b/docs/docbook/smbdotconf/wins/winshook.xml @@ -1,43 +1,57 @@ - - wins hook (G) - When Samba is running as a WINS server this - allows you to call an external program for all changes to the - WINS database. The primary use for this option is to allow the - dynamic update of external name resolution databases such as - dynamic DNS. + + + When Samba is running as a WINS server this + allows you to call an external program for all changes to the + WINS database. The primary use for this option is to allow the + dynamic update of external name resolution databases such as + dynamic DNS. - The wins hook parameter specifies the name of a script - or executable that will be called as follows: + The wins hook parameter specifies the name of a script + or executable that will be called as follows: - wins_hook operation name nametype ttl IP_list - + wins_hook operation name nametype ttl IP_list - - The first argument is the operation and is one - of "add", "delete", or "refresh". In most cases the operation can - be ignored as the rest of the parameters provide sufficient - information. Note that "refresh" may sometimes be called when the - name has not previously been added, in that case it should be treated - as an add. + + + The first argument is the operation and is + one of "add", "delete", or + "refresh". In most cases the operation + can be ignored as the rest of the parameters + provide sufficient information. Note that + "refresh" may sometimes be called when + the name has not previously been added, in that + case it should be treated as an add. + - The second argument is the NetBIOS name. If the + + The second argument is the NetBIOS name. If the name is not a legal name then the wins hook is not called. Legal names contain only letters, digits, hyphens, underscores - and periods. + and periods. + - The third argument is the NetBIOS name - type as a 2 digit hexadecimal number. + + The third argument is the NetBIOS name + type as a 2 digit hexadecimal number. + - The fourth argument is the TTL (time to live) - for the name in seconds. + + The fourth argument is the TTL (time to live) + for the name in seconds. + - The fifth and subsequent arguments are the IP + + The fifth and subsequent arguments are the IP addresses currently registered for that name. If this list is - empty then the name should be deleted. - - - An example script that calls the BIND dynamic DNS update - program nsupdate is provided in the examples - directory of the Samba source code. + empty then the name should be deleted. - + + + An example script that calls the BIND dynamic DNS update + program nsupdate is provided in the examples + directory of the Samba source code. + + diff --git a/docs/docbook/smbdotconf/wins/winspartners.xml b/docs/docbook/smbdotconf/wins/winspartners.xml index 840435ae4e..9ec277ed2d 100644 --- a/docs/docbook/smbdotconf/wins/winspartners.xml +++ b/docs/docbook/smbdotconf/wins/winspartners.xml @@ -1,14 +1,17 @@ - - 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. - + + + 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 = + Default: wins partners = - Example: wins partners = 192.168.0.1 172.16.1.2 - - + Example: wins partners = 192.168.0.1 172.16.1.2 + + diff --git a/docs/docbook/smbdotconf/wins/winsproxy.xml b/docs/docbook/smbdotconf/wins/winsproxy.xml index 31978d3b24..11f47e31c7 100644 --- a/docs/docbook/smbdotconf/wins/winsproxy.xml +++ b/docs/docbook/smbdotconf/wins/winsproxy.xml @@ -1,9 +1,13 @@ - - wins proxy (G) - This is a boolean that controls if nmbd(8) will respond to broadcast name - queries on behalf of other hosts. You may need to set this - to yes for some older clients. + + + This is a boolean that controls if nmbd + 8 will respond to broadcast name + queries on behalf of other hosts. You may need to set this + to yes for some older clients. - Default: wins proxy = no - - + Default: wins proxy = no + + diff --git a/docs/docbook/smbdotconf/wins/winsserver.xml b/docs/docbook/smbdotconf/wins/winsserver.xml index ebdb3016c7..12ee635acd 100644 --- a/docs/docbook/smbdotconf/wins/winsserver.xml +++ b/docs/docbook/smbdotconf/wins/winsserver.xml @@ -1,32 +1,37 @@ - - wins server (G) - This specifies the IP address (or DNS name: IP - address for preference) of the WINS server that nmbd - 8 should register with. If you have a WINS server on - your network then you should set this to the WINS server's IP. + + + This specifies the IP address (or DNS name: IP + address for preference) of the WINS server that nmbd + 8 should register with. If you have a WINS server on + your network then you should set this to the WINS server's IP. - You should point this at your WINS server if you have a - multi-subnetted network. + You should point this at your WINS server if you have a + multi-subnetted network. - If you want to work in multiple namespaces, you can - give every wins server a 'tag'. For each tag, only one - (working) server will be queried for a name. The tag should be - seperated from the ip address by a colon. - + If you want to work in multiple namespaces, you can + give every wins server a 'tag'. For each tag, only one + (working) server will be queried for a name. The tag should be + seperated from the ip address by a colon. + - You need to set up Samba to point - to a WINS server if you have multiple subnets and wish cross-subnet - browsing to work correctly. + You need to set up Samba to point + to a WINS server if you have multiple subnets and wish cross-subnet + browsing to work correctly. - See the documentation file Browsing in the samba howto collection. + See the documentation file Browsing in the samba howto collection. - Default: not enabled - Example: wins server = mary:192.9.200.1 fred:192.168.3.199 mary:192.168.2.61 - For this example when querying a certain name, 192.19.200.1 will - be asked first and if that doesn't respond 192.168.2.61. If either - of those doesn't know the name 192.168.3.199 will be queried. - + Default: not enabled - Example: wins server = 192.9.200.1 192.168.2.61 - - + Example: wins server = mary:192.9.200.1 fred:192.168.3.199 mary:192.168.2.61 + + For this example when querying a certain name, 192.19.200.1 will + be asked first and if that doesn't respond 192.168.2.61. If either + of those doesn't know the name 192.168.3.199 will be queried. + + + Example: wins server = 192.9.200.1 192.168.2.61 + + diff --git a/docs/docbook/smbdotconf/wins/winssupport.xml b/docs/docbook/smbdotconf/wins/winssupport.xml index 5ad886a9b1..eef59e708f 100644 --- a/docs/docbook/smbdotconf/wins/winssupport.xml +++ b/docs/docbook/smbdotconf/wins/winssupport.xml @@ -1,12 +1,15 @@ - - wins support (G) - This boolean controls if the nmbd - 8 process in Samba will act as a WINS server. You should - not set this to yes unless you have a multi-subnetted network and - you wish a particular nmbd to be your WINS server. - Note that you should NEVER set this to yes - on more than one machine in your network. + + + This boolean controls if the nmbd + 8 process in Samba will act as a WINS server. You should + not set this to yes unless you have a multi-subnetted network and + you wish a particular nmbd to be your WINS server. + Note that you should NEVER set this to yes + on more than one machine in your network. - Default: wins support = no - - + Default: wins support = no + + -- cgit