From 9c72dd78f25be4a7ffa5af5a242670ec76930d6f Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Sat, 12 Mar 2005 22:34:38 +0000 Subject: Use new definition of , fixes a bunch of validity errors. (This used to be commit 3eb5c35e47951f320f7c2f4cd478a95f6d48236e) --- docs/Samba-HOWTO-Collection/NetworkBrowsing.xml | 172 ++++++++++++------------ 1 file changed, 86 insertions(+), 86 deletions(-) (limited to 'docs/Samba-HOWTO-Collection/NetworkBrowsing.xml') diff --git a/docs/Samba-HOWTO-Collection/NetworkBrowsing.xml b/docs/Samba-HOWTO-Collection/NetworkBrowsing.xml index 54c4846c66..42da719334 100644 --- a/docs/Samba-HOWTO-Collection/NetworkBrowsing.xml +++ b/docs/Samba-HOWTO-Collection/NetworkBrowsing.xml @@ -107,26 +107,26 @@ The Samba application that controls browse list management and name resolution i called nmbd. The configuration parameters involved in nmbd's operation are: -Browsing options: os level(*), - lm announce, - lm interval, - preferred master(*), - local master(*), - domain master(*), - browse list, - enhanced browsing. +Browsing options: (*), + , + , + (*), + (*), + (*), + , + . Name Resolution Method: - name resolve order(*). + (*). WINS options: - dns proxy, - wins proxy, - wins server(*), - wins support(*), - wins hook. + , + , + (*), + (*), + . @@ -166,9 +166,9 @@ UDP messages can be broadcast or unicast. UDP Normally, only uni-cast UDP messaging can be forwarded by routers. The -remote announce parameter to smb.conf helps to project browse announcements + parameter to smb.conf helps to project browse announcements to remote network segments via uni-cast UDP. Similarly, the -remote browse sync parameter of &smb.conf; + parameter of &smb.conf; implements browse list collation using uni-cast UDP. @@ -213,16 +213,16 @@ In those networks where Samba is the only SMB server technology, wherever possib server. This makes it easy to manage the browsing environment. If each network segment is configured with its own Samba WINS server, then the only way to get cross-segment browsing to work is by using the -remote announce and the -remote browse sync + and the + parameters to your &smb.conf; file. WINS If only one WINS server is used for an entire multi-segment network, then -the use of the remote announce and the -remote browse sync parameters should not be necessary. +the use of the and the + parameters should not be necessary. @@ -238,7 +238,7 @@ Right now Samba WINS does not support MS-WINS replication. This means that when setting up Samba as a WINS server, there must only be one nmbd configured as a WINS server on the network. Some sites have used multiple Samba WINS servers for redundancy (one server per subnet) and then used -remote browse sync and remote announce + and to effect browse list collation across all segments. Note that this means clients will only resolve local names, and must be configured to use DNS to resolve names on other subnets in order to resolve the IP addresses of the servers they can see @@ -535,7 +535,7 @@ 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). + parameter). @@ -573,13 +573,13 @@ inability to use the network services. Samba supports a feature that allows forced synchronization of browse lists across -routed networks using the remote browse sync +routed networks using the parameter in the &smb.conf; file. This causes Samba to contact the local master browser on a remote network and to request browse list synchronization. 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 + parameter provides browse list synchronization &smbmdash; 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 @@ -613,7 +613,7 @@ of the &smb.conf; file: -domain masteryes +yes @@ -628,10 +628,10 @@ file as shown in the following example: Domain Master Browser smb.conf [global] -domain masteryes -local masteryes -preferred masteryes -os level65 +yes +yes +yes +65 @@ -653,10 +653,10 @@ shown in following example: Local master browser smb.conf [global] -domain masterno -local masteryes -preferred masteryes -os level65 +no +yes +yes +65 @@ -666,9 +666,9 @@ each other over which is to be the Local Master Browser. -The local master parameter allows Samba to act as a -Local Master Browser. The preferred master causes nmbd -to force a browser election on startup and the os level +The parameter allows Samba to act as a +Local Master Browser. The causes nmbd +to force a browser election on startup and the parameter sets Samba high enough so it should win any browser elections. @@ -682,10 +682,10 @@ becoming a Local Master Browser by setting the following options in the smb.conf for not being a Master Browser [global] -domain masterno -local masterno -preferred masterno -os level0 +no +no +no +0 @@ -711,16 +711,16 @@ of the &smb.conf; file as shown in following example Local Master Browser smb.conf [global] -domain masterno -local masteryes -preferred masteryes -os level65 +no +yes +yes +65 If you wish to have a Samba server fight the election with machines on the same subnet you -may set the os level parameter to lower levels. +may set the parameter to lower levels. By doing this you can tune the order of machines that will become Local Master Browsers if they are running. For more details on this refer to Forcing Samba to Be the Master section. @@ -736,10 +736,10 @@ and ever becoming a Local Master Browser by setting the following options in the &smb.conf; for not being a master browser [global] -domain masterno -local masterno -preferred masterno -os level0 +no +no +no +0 @@ -755,29 +755,29 @@ elections to just about every Windows network server or client. -If you want Samba to win elections, set the os level +If you want Samba to win elections, set the global option in &smb.conf; to a higher number. It defaults to 20. Using 34 would make it win all elections every other system (except other samba systems). -An os level of two would make it beat Windows for Workgroups and Windows 9x/Me, but not MS Windows +An of two would make it beat Windows for Workgroups and Windows 9x/Me, but not MS Windows NT/200x Server. An MS Windows NT/200x Server Domain Controller uses level 32. The maximum os level is 255. If you want Samba to force an election on startup, set the -preferred master global option in &smb.conf; to yes. + global option in &smb.conf; to yes. Samba will then have a slight advantage over other potential master browsers that are not Preferred Master Browsers. Use this parameter with care, as if you have two hosts (whether they are Windows 9x/Me or -NT/200x/XP or Samba) on the same local subnet both set with preferred master +NT/200x/XP or Samba) on the same local subnet both set with to yes, then periodically and continually they will force an election in order to become the Local Master Browser. If you want Samba to be a Domain Master Browser, then it is recommended that -you also set preferred master to yes, because +you also set to yes, because Samba will not become a Domain Master Browser for the whole of your LAN or WAN if it is not also a Local Master Browser on its own broadcast isolated subnet. @@ -796,7 +796,7 @@ the current Domain Master Browser fail. The domain master is responsible for collating the browse lists of multiple subnets so browsing can occur between subnets. You can -make Samba act as the Domain Master by setting domain masteryes +make Samba act as the Domain Master by setting yes in &smb.conf;. By default it will not be a Domain Master. @@ -815,8 +815,8 @@ other subnets and then contact them to synchronize browse lists. If you want Samba to be the domain master, you should also set the -os level high enough to make sure it wins elections, and -set preferred master to yes, to + high enough to make sure it wins elections, and +set to yes, to get Samba to force an election on startup. @@ -877,22 +877,22 @@ does not seem to support a zeros broadcast and you will probably find that brows Samba supports machines with multiple network interfaces. If you have multiple interfaces, you will -need to use the interfaces option in &smb.conf; to configure them. +need to use the option in &smb.conf; to configure them. Use of the Remote Announce Parameter -The remote announce parameter of +The parameter of &smb.conf; can be used to forcibly ensure that all the NetBIOS names on a network get announced to a remote network. -The syntax of the remote announce parameter is: +The syntax of the parameter is: -remote announcea.b.c.d [e.f.g.h] ... +a.b.c.d [e.f.g.h] ... or -remote announcea.b.c.d/WORKGROUP [e.f.g.h/WORKGROUP] ... +a.b.c.d/WORKGROUP [e.f.g.h/WORKGROUP] ... where: @@ -925,17 +925,17 @@ where: Use of the Remote Browse Sync Parameter -The remote browse sync parameter of +The parameter of &smb.conf; is used to announce to another LMB that it must synchronize its NetBIOS name list with our Samba LMB. This works only if the Samba server that has this option is simultaneously the LMB on its network segment. -The syntax of the remote browse sync parameter is: +The syntax of the parameter is: -remote browse synca.b.c.d +a.b.c.d where a.b.c.d is either the IP address of the @@ -1000,19 +1000,19 @@ errors. To configure Samba as a WINS server just add -wins supportyes to the &smb.conf; +yes to the &smb.conf; file [global] section. To configure Samba to register with a WINS server just add -wins servera.b.c.d +a.b.c.d to your &smb.conf; file [global] section. -Never use both wins supportyes together -with wins servera.b.c.d +Never use both yes together +with a.b.c.d particularly not using its own IP address. Specifying both will cause &nmbd; to refuse to start! @@ -1028,7 +1028,7 @@ the [global] section: -wins supportyes +yes @@ -1040,13 +1040,13 @@ least set the parameter to no on all these machines. -Machines configured with wins supportyes will keep a list of +Machines configured with yes will keep a list of all NetBIOS names registered with them, acting as a DNS for NetBIOS names. It is strongly recommended to set up only one WINS server. Do not set the -wins supportyes option on more than one Samba +yes option on more than one Samba server. @@ -1061,7 +1061,7 @@ participate in these replications. It is possible in the future that a Samba-to-Samba WINS replication protocol may be defined, in which case more than one Samba machine could be set up as a WINS server. Currently only one Samba server should have the -wins supportyes parameter set. +yes parameter set. @@ -1077,7 +1077,7 @@ all &smb.conf; files: -wins server<name or IP address> +<name or IP address> @@ -1089,8 +1089,8 @@ machine or its IP address. This line must not be set in the &smb.conf; file of the Samba server acting as the WINS server itself. If you set both the -wins supportyes option and the -wins server<name> option then +yes option and the +<name> option then nmbd will fail to start. @@ -1244,15 +1244,15 @@ Many sites want to restrict DNS lookups and avoid broadcast name resolution traffic. The name resolve order parameter is of great help here. The syntax of the name resolve order parameter is: -name resolve orderwins lmhosts bcast host +wins lmhosts bcast host or -name resolve orderwins lmhosts (eliminates bcast and host) +wins lmhosts (eliminates bcast and host) The default is: -name resolve orderhost lmhost wins bcast +host lmhost wins bcast where host refers to the native methods used by the UNIX system to implement the gethostbyname() function call. This is normally @@ -1266,7 +1266,7 @@ controlled by /etc/host.conf, /etc/nsswitch.conf< SMB networking provides a mechanism by which clients can access a list -of machines in a network, a so-called browse list. This list +of machines in a network, a so-called . This list contains machines that are ready to offer file and/or print services to other machines within the network. Thus it does not include machines that aren't currently able to do server tasks. The browse @@ -1327,7 +1327,7 @@ recommended that you use one and only one Samba server as the WINS server. To get browsing to work you need to run nmbd as usual, but will need -to use the workgroup option in &smb.conf; +to use the option in &smb.conf; to control what workgroup Samba becomes a part of. @@ -1335,7 +1335,7 @@ to control what workgroup Samba becomes a part of. Samba also has a useful option for a Samba server to offer itself for browsing on another subnet. It is recommended that this option is only used for unusual purposes: announcements over the Internet, for -example. See remote announce in the +example. See in the &smb.conf; man page. @@ -1345,7 +1345,7 @@ example. See remote announce in the If something does not work, the log.nmbd file will help -to track down the problem. Try a log level of 2 or 3 for finding +to track down the problem. Try a of 2 or 3 for finding problems. Also note that the current browse list usually gets stored in text form in a file called browse.dat. @@ -1358,7 +1358,7 @@ press enter and filemanager should display the list of availa Some people find browsing fails because they do not have the global -guest account set to a valid account. Remember that the + set to a valid account. Remember that the IPC$ connection that lists the shares is done as guest and, thus, you must have a valid guest account. @@ -1373,7 +1373,7 @@ server resources. The other big problem people have is that their broadcast address, -netmask or IP address is wrong (specified with the interfaces option +netmask or IP address is wrong (specified with the option in &smb.conf;) @@ -1703,7 +1703,7 @@ guest account for browsing in smbd. Check that your guest acc valid. -Also see guest account in the &smb.conf; man page. +Also see in the &smb.conf; man page. -- cgit