jcifs.netbios

Interface NameServiceClient

All Known Implementing Classes:

NameServiceClientImpl

public interface NameServiceClient

Author:

mbechler

Method Summary

Modifier and Type	Method and Description
UniAddress[]	getAllByName(String hostname, boolean possibleNTDomainOrWorkgroup) Lookup addresses for the given hostname.
UniAddress	getByName(String hostname) Determines the address of a host given it's host name.
UniAddress	getByName(String hostname, boolean possibleNTDomainOrWorkgroup) Lookup hostname and return it's UniAddress.
Lmhosts	getLmhosts()
NbtAddress	getLocalHost()
Name	getLocalName()
NbtAddress[]	getNbtAllByAddress(NbtAddress addr) Retrieve all addresses of a host by it's address.
NbtAddress[]	getNbtAllByAddress(String host) Retrieve all addresses of a host by it's address.
NbtAddress[]	getNbtAllByAddress(String host, int type, String scope) Retrieve all addresses of a host by it's address.
NbtAddress[]	getNbtAllByName(String host, int type, String scope, InetAddress svr) Retrieve all addresses of a host by it's name.
NbtAddress	getNbtByName(String host) Determines the address of a host given it's host name.
NbtAddress	getNbtByName(String host, int type, String scope) Determines the address of a host given it's host name.
NbtAddress	getNbtByName(String host, int type, String scope, InetAddress svr) Determines the address of a host given it's host name.
NbtAddress[]	getNodeStatus(NbtAddress nbtAddress)
Name	getUnknownName()

Method Detail

getLocalHost

NbtAddress getLocalHost()

Returns:

local host address

getLocalName

Name getLocalName()

Returns:

the local host name

getLmhosts

Lmhosts getLmhosts()

Returns:

lmhosts file used

getUnknownName

Name getUnknownName()

Returns:

the numknown name

getNbtAllByAddress

NbtAddress[] getNbtAllByAddress(NbtAddress addr)
                         throws UnknownHostException

Retrieve all addresses of a host by it's address. NetBIOS hosts can have many names for a given IP address. The name and IP address make the NetBIOS address. This provides a way to retrieve the other names for a host with the same IP address.

Parameters:

addr - the address to query

Returns:

resolved addresses

Throws:

UnknownHostException - if address cannot be resolved

getNbtAllByAddress

NbtAddress[] getNbtAllByAddress(String host,
                                int type,
                                String scope)
                         throws UnknownHostException

Retrieve all addresses of a host by it's address. NetBIOS hosts can have many names for a given IP address. The name and IP address make the NetBIOS address. This provides a way to retrieve the other names for a host with the same IP address. See getByName(java.lang.String, boolean) for a description of type and scope.

Parameters:

host - hostname to lookup all addresses for

type - the hexcode of the name

scope - the scope of the name

Returns:

resolved addresses

Throws:

UnknownHostException - if there is an error resolving the name

getNbtAllByAddress

NbtAddress[] getNbtAllByAddress(String host)
                         throws UnknownHostException

Retrieve all addresses of a host by it's address. NetBIOS hosts can have many names for a given IP address. The name and IP address make the NetBIOS address. This provides a way to retrieve the other names for a host with the same IP address.

Parameters:

host - hostname to lookup all addresses for

Returns:

resolved addresses

Throws:

UnknownHostException - if there is an error resolving the name

getNbtAllByName

NbtAddress[] getNbtAllByName(String host,
                             int type,
                             String scope,
                             InetAddress svr)
                      throws UnknownHostException

Retrieve all addresses of a host by it's name.

Parameters:

host - hostname to lookup all addresses for

type - the hexcode of the name

scope - the scope of the name

svr - server to query

Returns:

the resolved addresses

Throws:

UnknownHostException

getNbtByName

NbtAddress getNbtByName(String host,
                        int type,
                        String scope,
                        InetAddress svr)
                 throws UnknownHostException

Determines the address of a host given it's host name. NetBIOS names also have a type. Types(aka Hex Codes) are used to distiquish the various services on a host. Here is a fairly complete list of NetBIOS hex codes. Scope is not used but is still functional in other NetBIOS products and so for completeness it has been implemented. A scope of null or "" signifies no scope. The additional svr parameter specifies the address to query. This might be the address of a specific host, a name server, or a broadcast address.

Parameters:

host - the name to resolve

type - the hex code of the name

scope - the scope of the name

svr - server to query

Returns:

the resolved address

Throws:

UnknownHostException - if there is an error resolving the name

getNbtByName

NbtAddress getNbtByName(String host,
                        int type,
                        String scope)
                 throws UnknownHostException

Determines the address of a host given it's host name. NetBIOS names also have a type. Types(aka Hex Codes) are used to distiquish the various services on a host. Here is a fairly complete list of NetBIOS hex codes. Scope is not used but is still functional in other NetBIOS products and so for completeness it has been implemented. A scope of null or "" signifies no scope.

Parameters:

host - the name to resolve

type - the hex code of the name

scope - the scope of the name

Returns:

the resolved address

Throws:

UnknownHostException - if there is an error resolving the name

getNbtByName

NbtAddress getNbtByName(String host)
                 throws UnknownHostException

Determines the address of a host given it's host name. The name can be a NetBIOS name like "freto" or an IP address like "192.168.1.15". It cannot be a DNS name; the analygous UniAddress or InetAddress getByName methods can be used for that.

Parameters:

host - hostname to resolve

Returns:

the resolved address

Throws:

UnknownHostException - if there is an error resolving the name

getNodeStatus

NbtAddress[] getNodeStatus(NbtAddress nbtAddress)
                    throws UnknownHostException

Parameters:

nbtAddress -

Returns:

the node status responses

Throws:

UnknownHostException

getAllByName

UniAddress[] getAllByName(String hostname,
                          boolean possibleNTDomainOrWorkgroup)
                   throws UnknownHostException

Lookup addresses for the given hostname.

Parameters:

hostname -

possibleNTDomainOrWorkgroup -

Returns:

found addresses

Throws:

UnknownHostException

getByName

UniAddress getByName(String hostname,
                     boolean possibleNTDomainOrWorkgroup)
              throws UnknownHostException

Lookup hostname and return it's UniAddress. If the possibleNTDomainOrWorkgroup parameter is true an addtional name query will be performed to locate a master browser.

Parameters:

hostname -

possibleNTDomainOrWorkgroup -

Returns:

the first resolved address

Throws:

UnknownHostException

getByName

UniAddress getByName(String hostname)
              throws UnknownHostException

Determines the address of a host given it's host name. The name can be a machine name like "jcifs.samba.org", or an IP address like "192.168.1.15".

Parameters:

hostname - NetBIOS or DNS hostname to resolve

Returns:

the found address

Throws:

UnknownHostException - if there is an error resolving the name