Name-to-Address Translation APIs
The name-to-address translation APIs allow an application to obtain the
address of a service on a specified host in a transport-independent manner.
These APIs are typically used by the applications that use the expert level
TI-RPC APIs.
The name-to-address translation APIs are:
- netdir_free() (Free netdir structures) frees structures that are allocated by name-to-address translation APIs.
- netdir_getbyaddr() (Translate a netbuf address to a host) maps addresses into host names and service names.
- netdir_getbyname() (Translate a given host-service pair) maps the host name and service name that are specified in the service parameter to a set of addresses that are consistent with the transport identified in the netconfig structure.
- netdir_options() (Access transport-specific capabilities) provides interfaces to transport-specific capabilities such as the broadcast address and reserved port facilities of TCP and UDP.
- netdir_sperror() (Indicate an error in an NTA Routine) issues an informational message that states why one of the name-to-address translation APIs may have failed.
- taddr2uaddr() (Translate a local address) translates a transport-specific (local) address to a transport-independent (universal) address.
- uaddr2taddr() (Translate a universal address) translates a transport-independent (universal) address to a transport-specific (local) address (netbuf structure).