Sockets Network Functions

The network functions and the Berkeley Resolver routines supported by the sockets APIs are:

• _getlong() (Get long byte quantities from a byte stream) is used to retrieve an unsigned long byte quantity.
• _getshort() (Get short byte quantities from a byte stream.) is used to retrieve an unsigned short byte quantity.
• _putlong() (Put long byte quantities into a byte stream.) is used to put an unsigned long byte quantity into a byte stream.
• _putshort() (Put short byte quantities into a byte stream.) is used to put an unsigned short byte quantity into a byte stream.
• dn_comp() (Compress an expanded domain name) is used to compress an expanded domain name.
• dn_comp_ts64() (Compress an expanded domain name) is used to compress an expanded domain name.
• dn_expand() (Expand a compressed domain name.) is used to expand a compressed domain name.
• dn_find() (Search for a compressed domain name from a list of previously compressed domain names) is used to search for an expanded domain name in a list of compressed domain names.
• dn_find_ts64() (Search for a compressed domain name from a list of previously compressed domain names) is used to search for an expanded domain name in a list of compressed domain names.
• dn_skipname() (Skip over a compressed domain name.) is used to skip over a compressed domain name in a DNS packet.
• endhostent() (Close the nameserver database) is used to close the host database file.
• endhostent_r() (Close the nameserver database) is used to close the host database file.
• endnetent() (Close the network database) is used to close the network database file.
• endnetent_r() (Close the network database) is used to close the network database file.
• endprotoent() (Close the protocol database) is used to close the protocols database file.
• endprotoent_r() (Close the protocol database) is used to close the protocol database file.
• endservent() (Close the service database) is used to close the services database file.
• endservent_r() (Close the service database) is used to close the service database file.
• freeaddrinfo() (Free Address Information) frees one or more addrinfo structures returned by getaddrinfo(), along with any additional storage associated with those structures.
• gai_strerror() (Retrieve Address Information Runtime Error Message) retrieves a text string that describes a return value received from calling the getaddrinfo() or getnameinfo() API.
• getaddrinfo() (Get Address Information) translates the name of a service location or a service name and returns a set of socket addresses and associated information to be used in creating a socket with which to address the specified service.
• gethostbyaddr() (Provide information about host given an Internet address) is used to retrieve information about a host.
• gethostbyaddr_r() (Provide information about host given an Internet address) is used to retrieve information about a host.
• gethostbyname() (Provide information about host given a host name) is used to retrieve information about a host.
• gethostbyname_r() (Provide information about host given a host name) is used to retrieve information about a host.
• gethostent() (Get next host entry from the nameserver database) is used to retrieve information from the host database file.
• gethostent_r() (Get next host entry from the nameserver database) is used to retrieve information from the host database file.
• getnameinfo() (Get Name Information for Socket Address) translates a socket address to a node name and service location.
• getnetbyaddr() (Get information from the network database about a given internet address) is used to retrieve information about a network.
• getnetbyaddr_r() (Get information from the network database about a given internet address) is used to retrieve information about a network.
• getnetbyname() (Get information from the network database about a given domain name) is used to retrieve information about a network.
• getnetbyname_r() (Get information from the network database about a given domain name) is used to retrieve information about a network.
• getnetent() (Get network entry from the network database) is used to retrieve network information from the network database file.
• getnetent_r() (Get network entry from the network database) is used to retrieve network information from the network database file.
• getprotobyname() (Get information regarding a protocol given the protocol name) is used to retrieve information about a protocol.
• getprotobyname_r() (Get information regarding a protocol given the protocol name) is used to retrieve information about a protocol.
• getprotobynumber() (Get information regarding a protocol given the protocol number) is used to retrieve information about a protocol.
• getprotobynumber_r() (Get information regarding a protocol given the protocol number) is used to retrieve information about a protocol.
• getprotoent() (Get next protocol entry in the protocol data base) is used to retrieve protocol information from the protocol database file.
• getprotoent_r() (Get next protocol entry in the protocol data base) is used to retrieve protocol information from the protocol database file.
• getservbyname() (Get port number for a given service name.) is used to retrieve information about services (the protocol being used by the service and the port number assigned for the service).
• getservbyname_r() (Get port number for a given service name.) is used to retrieve information about services: the protocol being used by the service and the port number assigned for the service.
• getservbyport() (Get service name given a port number) is used to retrieve information about a service assigned to a port number.
• getservbyport_r() (Get service name given a port number) is used to retrieve information about a service assigned to a port number.
• getservent() (Get next service entry from the service database) is used to retrieve information about services (the protocol being used by the service and the port number assigned for the service).
• getservent_r() (Get next service entry from the service database) is used to retrieve information about services: the protocol being used by the service and the port number assigned for the service.
• hstrerror() (Retrieve resolver error message.) is used to retrieve the text string that describes a resolver h_errno value.
• htonl() (Convert a long (4 byte) integer from local host byte order to the network byte order) is used to convert a long (4-byte) integer from the local host byte order to standard network byte order.
• htons() (Convert a short (2 byte) integer from local host byte order to the network byte order) is used to convert a short (2-byte) integer from the local host byte order to standard network byte order.
• inet_addr() (Translate the full address from dotted decimal format to a 32-bit Internet address) is used to translate an Internet address from dotted decimal format to a 32-bit IP address.
• inet_lnaof() (Separate the local portion of an Internet address.) is used to extract the local host portion of an IP address.
• inet_makeaddr() (Formulate an Internet address that combines a network address with the local address of a host.) is used to generate a 32-bit IP address from the 32-bit network IP address and the local address of the host.
• inet_netof() (Separate the network portion of an Internet address.) is used to extract the network portion of an IP address.
• inet_network() (Translate the network portion of the address from dotted decimal format to a 32-bit Internet address) is used to translate an Internet address from dotted decimal format to a 32-bit network IP address, in which the host part of the IP address is set to zeros.
• inet_ntoa() (Translate from 32-bit Internet address to a dotted decimal format) is used to translate an Internet address from a 32-bit IP address to dotted decimal format.
• inet_ntoa_r() (Translate from 32-bit Internet address to a dotted decimal format) is used to translate an Internet address from a 32-bit IP address to dotted decimal format.
• inet_ntop() (Convert IPv4 and IPv6 Addresses Between Binary and Text Form) converts a numeric address into a text string suitable for presentation.
• inet_pton() (Convert IPv4 and IPv6 Addresses Between Text and Binary Form) converts an address in its standard text presentation form into its numeric binary form.
• ns_addr() (Translate a network services address from human readable format to a 12-byte hexadecimal address) is used to translate a network services address from human readable format to a 12-byte hexadecimal address.
• ns_ntoa() (Translate a network services address from a 12-byte address to a human readable format) is used to translate a network services address from a 12-byte address to a human readable format.
• ns_ntoa_r() (Translate a network services address from a 12-byte address to a human readable format) is used to translate a network services address from a 12-byte address to a human readable format.
• ntohl() (Convert a long (4 byte) integer from network byte order to the local host byte order) is used to convert a long (4-byte) integer from the standard network byte order to the local host byte order.
• ntohs() (Convert a short (2 byte) integer from network byte order to the local host byte order) is used to convert a short (2-byte) integer from the standard network byte order to the local host byte order.
• res_close() (Close a socket and reset the _res structure.) is used to reset the _res structure to the beginning defaults and close a socket that is opened as a result of the RES_STAYOPEN flag.
• res_findzonecut() (Find the enclosing zone and servers) queries name servers until it finds the enclosing zone and its master name servers for the specified domain name.
• res_hostalias() (Retrieve the host alias) looks up the specified name in the host aliases file specified by the environment variable HOSTALIASES.
• res_init() (Initialize _res structure for domain name server.) is used to initialize the _res structure for name resolution.
• res_mkquery() (Form a domain name query and place it in a buffer in memory.) is used to make standard query messages (DNS packets) for name servers.
• res_nclose() (Close socket and reset res structure) is used to reset the _res structure to the beginning defaults and close a socket that is opened as a result of the RES_STAYOPEN flag.
• res_ninit() (Initialize res structure) is used to initialize the _res structure for name resolution.
• res_nisourserver() (Check server address) looks up the specified server address in the ns_addr_list[] of the specified res structure.
• res_nmkquery() (Place domain query in buffer) is used to make standard query messages (DNS packets) for name servers.
• res_nmkupdate() (Construct an update packet) builds a dynamic update packet from the linked list of update records.
• res_nquery() (Send domain query) is used to interface to the server query mechanism.
• res_nquerydomain() (Send 2-string domain query) is used to interface to the server query mechanism.
• res_nsearch() (Search for domain name) is used to make a query message and wait for a response.
• res_nsend() (Send buffered domain query or update) is used to send a query or update message to a name server and retrieve a response.
• res_nsendsigned() (Send authenticated domain query or update) is similar to res_nsend() but it uses the specified key to create a transaction signature (TSIG) to sign the query or update packet and to authenticate the response.
• res_nupdate() (Build and send dynamic updates) separates the linked list of update records into groups so that all records in a group will belong to a single zone on the nameserver.
• res_query() (Form a domain name query and send it to the domain name server.) is used to interface to the server query mechanism.
• res_search() (Search for a domain name from a list of domain names) is used to make a query message and wait for a response.
• res_send() (Send the query formed in res_mkquery to the domain name server.) is used to send a query or update message to a name server and retrieve a response.
• res_xlate() (Translate standard DNS packets between ASCII and EBCDIC) is used to translate a standard DNS packet between ASCII and EBCDIC.
• sethostent() (Open the nameserver database) is used to prepare for sequential access to the host database file. sethostent() opens the file and repositions the file marker to the beginning of the file.
• sethostent_r() (Open the nameserver database) is used in preparation for sequential access to the host database file.
• setnetent() (Open the network database) is used to prepare for sequential access to the network database file.
• setnetent_r() (Open the network database) is used in preparation for sequential access to the network database file.
• setprotoent() (Open the protocol database) is used to prepare for sequential access to the protocol database file.
• setprotoent_r() (Open the protocol database) is used in preparation for sequential access to the protocol database file.
• setservent() (Open the service database) is used to prepare for sequential access to the service database file.
• setservent_r() (Open the service database) is used in preparation for sequential access to the service database file.

¹  IBM^(R) addition to the Berkeley Resolver Routines

Note: These functions use header (include) files from the library QSYSINC, which is optionally installable. Make sure QSYSINC is installed on your system before using any of the functions.