netbios(1Mtcp)

netbios -- NetBIOS startup/shutdown script

Synopsis

/etc/netbios [ start | stop ]

Description

The /etc/netbios script starts or stops NetBIOS. The argument (start or stop) specifies the action to be taken. When starting NetBIOS, netbios reads and exports configuration information to be used by the NetBIOS daemon, in.nbd(1Mtcp). If the /etc/lmhosts file exists, the script also calls nbtstat -R which adds all remote host entries in /etc/lmhosts to the internal NetBIOS name cache. netbios reads the file /etc/inet/nb.conf, which should set the following environment variables:

NB_ADDR

Internet address of interface to be used. Possible values are:

IP_addr
"IP_addr [IP_addr]...": Enable NetBIOS only to run over interfaces specified by the given IP addresses. The IP addresses must belong to network adapters in the local system. The configured interface addresses cannot be changed using the -i option to nbtstat(1Mtcp).
"": Allow NetBIOS to configure itself automatically itself for all available subnetworks.
"loopback"
"localhost": Force NetBIOS only to run locally. This should only be used for testing.

NB_DFLTNCB

Default maximum number of pending NetBIOS Control Blocks (NCBs) per NetBIOS user environment.

NB_DFLTSSN

Default maximum number of active sessions per NetBIOS user environment.

NB_KPALIVE

Time in seconds to enable keep alive messages. If set to -1, no keep alive messages will be used. If set to zero, keep alive messages will be enabled for the default idle time.

NB_MAXNAME

Maximum number of names a user may register.

NB_MAXNCB

Maximum number of NCBs that may be configured.

NB_MAXSSN

Maximum number of sessions that may be configured.

NB_NAMESEARCH

The methods that may be employed to search for a NetBIOS service name if it is not found in the NetBIOS name table. Possible values are:

bc: Use the standard NetBIOS broadcast mechanism only.
resolv: Use DNS.
wins: Call WINS (Windows Internet Name Service) name server(s). At least a primary WINS server must be defined using NB_WINS_PRIMARY.

These mechanisms may be combined in any order in a comma-separated list. The default search order is:

NB_NAMESEARCH=bc,resolv

This uses the broadcast mechanism to search for a service name if it is not found in the NetBIOS name table. If this fails, it then tries DNS.

The recommended search order when WINS is in use is:

NB_NAMESEARCH=wins,bc,resolv

NB_SCOPE

NetBIOS scope name string. This is used to fully qualify NetBIOS names. Only use this variable if you have multiple logical NetBIOS networks running on the same physical TCP/IP network. For more information on NetBIOS scope identifiers, see ``Setting the scope identifier'' in Configuring NetBIOS.

NB_WINS_PRIMARY

The IP address (in dotted-decimal format) of the WINS server that will first be approached with a name registration, query, or release request. The default value is 0.0.0.0 which means that no server is defined.

NB_WINS_SECONDARY

The IP address (in dotted-decimal format) of the WINS server that will be approached with a name registration, query, or release request if the primary WINS server does not respond (that is, the request times out). The default value is 0.0.0.0 which means that no server is defined.

The following is a sample /etc/inet/nb.conf file:

   #
   # Copyright 1995-1997 Santa Cruz Operation, Inc.
   #
   NB_ADDR="172.16.24.57 172.16.25.10"
   NB_SCOPE=
   NB_DFLTNCB=8
   NB_DFLTSSN=64
   NB_MAXNAME=16
   NB_MAXNCB=16
   NB_MAXSSN=64
   NB_KPALIVE=0
   NB_NAMESEARCH=wins,bc,resolv
   NB_WINS_PRIMARY=172.16.24.1
   NB_WINS_SECONDARY=0.0.0.0
   export NB_ADDR NB_SCOPE NB_DFLTNCB NB_DFLTSSN NB_MAXNAME NB_MAXNCB
   export NB_MAXSSN NB_KPALIVE NB_NAMESEARCH NB_WINS_PRIMARY NB_WINS_SECONDARY

Files

/etc/inet/nb.conf: NetBIOS configuration file
/etc/lmhosts: NetBIOS remote hosts file

References

in.nbd(1Mtcp), lmhosts(4tcp), nbtstat(1Mtcp), netbios(7tcp)