Module jcifs
Package org.codelibs.jcifs.smb

Interface NetbiosAddress

All Superinterfaces:
Address
All Known Implementing Classes:
NbtAddress
public interface NetbiosAddress extends Address
This class represents a NetBIOS over TCP/IP address. Under normal conditions, users of jCIFS need not be concerned with this class as name resolution and session services are handled internally by the smb package. * Applications can use the methods getLocalHost, getByName, and getAllByAddress to create a new NbtAddress instance. This class is symmetric with InetAddress. * About NetBIOS: The NetBIOS name service is a dynamic distributed service that allows hosts to resolve names by broadcasting a query, directing queries to a server such as Samba or WINS. NetBIOS is currently the primary networking layer for providing name service, datagram service, and session service to the Microsoft Windows platform. A NetBIOS name can be 15 characters long and hosts usually registers several names on the network. From a Windows command prompt you can see what names a host registers with the nbtstat command. * 
 C:\>nbtstat -a 192.168.1.15

        NetBIOS Remote Machine Name Table

    Name               Type         Status
 ---------------------------------------------
 JMORRIS2        <00>  UNIQUE      Registered
 BILLING-NY      <00>  GROUP       Registered
 JMORRIS2        <03>  UNIQUE      Registered
 JMORRIS2        <20>  UNIQUE      Registered
 BILLING-NY      <1E>  GROUP       Registered
 JMORRIS         <03>  UNIQUE      Registered

 MAC Address = 00-B0-34-21-FA-3B
* The hostname of this machine is JMORRIS2. It is a member of the group(a.k.a workgroup and domain) BILLING-NY. To obtain an InetAddress for a host one might do: 

 InetAddress addr = NbtAddress.getByName("jmorris2").getInetAddress();
* From a UNIX platform with Samba installed you can perform similar diagnostics using the nmblookup utility.
Since:
org.codelibs.jcifs.smb-0.1
Author:
Michael B. Allen
See Also:

  • Method Details

    • isGroupAddress

      boolean isGroupAddress(CIFSContext tc) throws UnknownHostException
      Determines if the address is a group address. This is also known as a workgroup name or group name.
      Parameters:
      tc - context to use
      Returns:
      whether the given address is a group address
      Throws:
      UnknownHostException - if the host cannot be resolved to find out.

    • getNodeType

      int getNodeType(CIFSContext tc) throws UnknownHostException
      Checks the node type of this address.
      Parameters:
      tc - context to use
      Returns:
      NbtAddress.B_NODE, NbtAddress.P_NODE, NbtAddress.M_NODE, NbtAddress.H_NODE
      Throws:
      UnknownHostException - if the host cannot be resolved to find out.

    • isBeingDeleted

      boolean isBeingDeleted(CIFSContext tc) throws UnknownHostException
      Determines if this address in the process of being deleted.
      Parameters:
      tc - context to use
      Returns:
      whether this address is in the process of being deleted
      Throws:
      UnknownHostException - if the host cannot be resolved to find out.

    • isInConflict

      boolean isInConflict(CIFSContext tc) throws UnknownHostException
      Determines if this address in conflict with another address.
      Parameters:
      tc - context to use
      Returns:
      whether this address is in conflict with another address
      Throws:
      UnknownHostException - if the host cannot be resolved to find out.

    • isActive

      boolean isActive(CIFSContext tc) throws UnknownHostException
      Determines if this address is active.
      Parameters:
      tc - context to use
      Returns:
      whether this address is active
      Throws:
      UnknownHostException - if the host cannot be resolved to find out.

    • isPermanent

      boolean isPermanent(CIFSContext tc) throws UnknownHostException
      Determines if this address is set to be permanent.
      Parameters:
      tc - context to use
      Returns:
      whether this address is permanent
      Throws:
      UnknownHostException - if the host cannot be resolved to find out.

    • getMacAddress

      byte[] getMacAddress(CIFSContext tc) throws UnknownHostException
      Retrieves the MAC address of the remote network interface. Samba returns all zeros.
      Parameters:
      tc - context to use
      Returns:
      the MAC address as an array of six bytes
      Throws:
      UnknownHostException - if the host cannot be resolved to determine the MAC address.

    • getNameType

      int getNameType()
      Returned the hex code associated with this name(e.g. 0x20 is for the file service)
      Returns:
      the name type

    • getName

      NetbiosName getName()
      Gets the NetBIOS name associated with this address.
      Returns:
      the name for this address