summaryrefslogtreecommitdiff
path: root/docs/htmldocs/browsing-quick.html
diff options
context:
space:
mode:
authorJelmer Vernooij <jelmer@samba.org>2003-04-02 18:07:52 +0000
committerJelmer Vernooij <jelmer@samba.org>2003-04-02 18:07:52 +0000
commitd00b6f125fd98d1842cba57c7b509d52470c82d7 (patch)
tree3ba63acf2addf1e8fec8e41cd33f2b66f93d06b9 /docs/htmldocs/browsing-quick.html
parent4f59ed8e91a749b84b21187f6c65180ada2b13f4 (diff)
downloadsamba-d00b6f125fd98d1842cba57c7b509d52470c82d7.tar.gz
samba-d00b6f125fd98d1842cba57c7b509d52470c82d7.tar.bz2
samba-d00b6f125fd98d1842cba57c7b509d52470c82d7.zip
Regenerate docs
(This used to be commit 20ee66b661e295cc9fb66f00b16de3b382a7e723)
Diffstat (limited to 'docs/htmldocs/browsing-quick.html')
-rw-r--r--docs/htmldocs/browsing-quick.html85
1 files changed, 76 insertions, 9 deletions
diff --git a/docs/htmldocs/browsing-quick.html b/docs/htmldocs/browsing-quick.html
index aa3dba2ee4..18be543aa4 100644
--- a/docs/htmldocs/browsing-quick.html
+++ b/docs/htmldocs/browsing-quick.html
@@ -141,7 +141,74 @@ CLASS="SECT1"
CLASS="SECT1"
><A
NAME="AEN139"
->2.2. Use of the "Remote Announce" parameter</A
+>2.2. How browsing functions and how to deploy stable and
+dependable browsing using Samba</A
+></H1
+><P
+>As stated above, MS Windows machines register their NetBIOS names
+(i.e.: the machine name for each service type in operation) on start
+up. Also, as stated above, the exact method by which this name registration
+takes place is determined by whether or not the MS Windows client/server
+has been given a WINS server address, whether or not LMHOSTS lookup
+is enabled, or if DNS for NetBIOS name resolution is enabled, etc.</P
+><P
+>In the case where there is no WINS server all name registrations as
+well as name lookups are done by UDP broadcast. This isolates name
+resolution to the local subnet, unless LMHOSTS is used to list all
+names and IP addresses. In such situations Samba provides a means by
+which the samba server name may be forcibly injected into the browse
+list of a remote MS Windows network (using the "remote announce" parameter).</P
+><P
+>Where a WINS server is used, the MS Windows client will use UDP
+unicast to register with the WINS server. Such packets can be routed
+and thus WINS allows name resolution to function across routed networks.</P
+><P
+>During the startup process an election will take place to create a
+local master browser if one does not already exist. On each NetBIOS network
+one machine will be elected to function as the domain master browser. This
+domain browsing has nothing to do with MS security domain control.
+Instead, the domain master browser serves the role of contacting each local
+master browser (found by asking WINS or from LMHOSTS) and exchanging browse
+list contents. This way every master browser will eventually obtain a complete
+list of all machines that are on the network. Every 11-15 minutes an election
+is held to determine which machine will be the master browser. By the nature of
+the election criteria used, the machine with the highest uptime, or the
+most senior protocol version, or other criteria, will win the election
+as domain master browser.</P
+><P
+>Clients wishing to browse the network make use of this list, but also depend
+on the availability of correct name resolution to the respective IP
+address/addresses. </P
+><P
+>Any configuration that breaks name resolution and/or browsing intrinsics
+will annoy users because they will have to put up with protracted
+inability to use the network services.</P
+><P
+>Samba supports a feature that allows forced synchonisation
+of browse lists across routed networks using the "remote
+browse sync" parameter in the smb.conf file. This causes Samba
+to contact the local master browser on a remote network and
+to request browse list synchronisation. This effectively bridges
+two networks that are separated by routers. The two remote
+networks may use either broadcast based name resolution or WINS
+based name resolution, but it should be noted that the "remote
+browse sync" parameter provides browse list synchronisation - and
+that is distinct from name to address resolution, in other
+words, for cross subnet browsing to function correctly it is
+essential that a name to address resolution mechanism be provided.
+This mechanism could be via DNS, <TT
+CLASS="FILENAME"
+>/etc/hosts</TT
+>,
+and so on.</P
+></DIV
+><DIV
+CLASS="SECT1"
+><H1
+CLASS="SECT1"
+><A
+NAME="AEN149"
+>2.3. Use of the "Remote Announce" parameter</A
></H1
><P
>The "remote announce" parameter of smb.conf can be used to forcibly ensure
@@ -198,8 +265,8 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN153"
->2.3. Use of the "Remote Browse Sync" parameter</A
+NAME="AEN163"
+>2.4. Use of the "Remote Browse Sync" parameter</A
></H1
><P
>The "remote browse sync" parameter of smb.conf is used to announce to
@@ -221,8 +288,8 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN158"
->2.4. Use of WINS</A
+NAME="AEN168"
+>2.5. Use of WINS</A
></H1
><P
>Use of WINS (either Samba WINS _or_ MS Windows NT Server WINS) is highly
@@ -284,8 +351,8 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN169"
->2.5. Do NOT use more than one (1) protocol on MS Windows machines</A
+NAME="AEN179"
+>2.6. Do NOT use more than one (1) protocol on MS Windows machines</A
></H1
><P
>A very common cause of browsing problems results from installing more than
@@ -327,8 +394,8 @@ CLASS="SECT1"
><H1
CLASS="SECT1"
><A
-NAME="AEN177"
->2.6. Name Resolution Order</A
+NAME="AEN187"
+>2.7. Name Resolution Order</A
></H1
><P
>Resolution of NetBIOS names to IP addresses can take place using a number