t6rhdb_get_host(3N)

NAME
     t6rhdb_get_host, t6rhdb_get_host6 - TSIX Remote Host DataBase get host
     information

SYNOPSIS
     #include <sys/t6rhdb.h>

     int t6rhdb_get_host(struct in_addr *addr, size_t size, t6rhdb_host_buf_t
     *data)
     int t6rhdb_get_host6(struct in6_addr *addr, size_t size,
     t6rhdb_host_buf_t *data)

DESCRIPTION
     These routines return information from the entry pointed to by addr into
     data which has length size.

     Each attribute available in the returned host profile structure will have
     its corresponding bit set in the hp_attributes field of the host data
     structure.

     t6rhdb_get_host() is used for IP version 4 addresses.  t6rhdb_get_host6()
     is used for IP version 6 addresses.

CAPABILITIES
     A process calling this function must have CAP_NETWORK_MGT capability in
     the effective vector of its capability set.

RETURN VALUE
     Upon successful completion, these routines will return zero.  Otherwise
     the appropriate error code will be returned.

ERROR
     [EPERM]        The current process does not have required privileges.

     [EINVAL]       The addr or data arguments are NULL or the entry does not
                    exist.

     [EFAULT]       The addr or data arguments contain an invalid pointer
                    address.

SEE ALSO
     libt6(3N), t6rhdb_put_host(3N), t6rhdb_put_host6(3N), t6rhdb_flush(3N),
     t6rhdb_flush6(3N), t6rhdb_stat(3N).

SOURCE
     Trusted Systems Interoperability Group