:man| Alphabetical   Categories   About us 
 
KRB5_ADDRESS (3) | C library functions | Unix Manual Pages | :man

NAME

krb5_address, krb5_addresses, krb5_sockaddr2address, krb5_sockaddr2port, krb5_addr2sockaddr, krb5_max_sockaddr_size, krb5_sockaddr_uninteresting, krb5_h_addr2sockaddr, krb5_h_addr2addr, krb5_anyaddr, krb5_print_address, krb5_parse_address, krb5_address_order, krb5_address_compare, krb5_address_search, krb5_free_address, krb5_free_addresses, krb5_copy_address, krb5_copy_addresses, krb5_append_addresses, krb5_make_addrport - mange addresses in Kerberos.

CONTENTS

Library
Synopsis
Description
See Also

LIBRARY

Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS


.In krb5.h

krb5_error_code
.Fo krb5_sockaddr2address "krb5_context context" "const struct sockaddr *sa" "krb5_address *addr"
.Fc krb5_error_code
.Fo krb5_sockaddr2port "krb5_context context" "const struct sockaddr *sa" "int16_t *port"
.Fc krb5_error_code
.Fo krb5_addr2sockaddr "krb5_context context" "const krb5_address *addr" "struct sockaddr *sa" "krb5_socklen_t *sa_size" "int port"
.Fc size_t
.Fo krb5_max_sockaddr_size "void"
.Fc "krb5_boolean"
.Fo krb5_sockaddr_uninteresting "const struct sockaddr *sa"
.Fc krb5_error_code
.Fo krb5_h_addr2sockaddr "krb5_context context" "int af" "const char *addr" "struct sockaddr *sa" "krb5_socklen_t *sa_size" "int port"
.Fc krb5_error_code
.Fo krb5_h_addr2addr "krb5_context context" "int af" "const char *haddr" "krb5_address *addr"
.Fc krb5_error_code
.Fo krb5_anyaddr "krb5_context context" "int af" "struct sockaddr *sa" "krb5_socklen_t *sa_size" "int port"
.Fc krb5_error_code
.Fo krb5_print_address "const krb5_address *addr" "char *str" "size_t len" "size_t *ret_len"
.Fc krb5_error_code
.Fo krb5_parse_address "krb5_context context" "const char *string" "krb5_addresses *addresses"
.Fc int
.Fo "krb5_address_order" "krb5_context context" "const krb5_address *addr1" "const krb5_address *addr2"
.Fc "krb5_boolean"
.Fo krb5_address_compare "krb5_context context" "const krb5_address *addr1" "const krb5_address *addr2"
.Fc "krb5_boolean"
.Fo krb5_address_search "krb5_context context" "const krb5_address *addr" "const krb5_addresses *addrlist"
.Fc krb5_error_code
.Fo krb5_free_address "krb5_context context" "krb5_address *address"
.Fc krb5_error_code
.Fo krb5_free_addresses "krb5_context context" "krb5_addresses *addresses"
.Fc krb5_error_code
.Fo krb5_copy_address "krb5_context context" "const krb5_address *inaddr" "krb5_address *outaddr"
.Fc krb5_error_code
.Fo krb5_copy_addresses "krb5_context context" "const krb5_addresses *inaddr" "krb5_addresses *outaddr"
.Fc krb5_error_code
.Fo krb5_append_addresses "krb5_context context" "krb5_addresses *dest" "const krb5_addresses *source"
.Fc krb5_error_code
.Fo krb5_make_addrport "krb5_context context" "krb5_address **res" "const krb5_address *addr" "int16_t port"
.Fc

DESCRIPTION

The krb5_address structure holds a address that can be used in Kerberos API calls. There are help functions to set and extract address information of the address.

The krb5_addresses structure holds a set of krb5_address:es.

krb5_sockaddr2address stores a address a "struct sockaddr" sa in the krb5_address addr.

krb5_sockaddr2port extracts a port (if possible) from a "struct sockaddr" sa.

krb5_addr2sockaddr sets the struct sockaddr sockaddr from addr and port. Sa_size should be initially contain the size of the sa, and after the call, it will contain the actual length of the address.

krb5_max_sockaddr_size returns the max size of the struct sockaddr that the Kerberos library will return.

krb5_sockaddr_uninteresting returns TRUE for all sa that for that the kerberos library thinks are uninteresting. One example are link local addresses.

krb5_h_addr2sockaddr initializes a "struct sockaddr" sa from af and the "struct hostent" (see gethostbyname(3)) h_addr_list component. Sa_size should be initially contain the size of the sa, and after the call, it will contain the actual length of the address. sa argument.

krb5_h_addr2addr works like krb5_h_addr2sockaddr with the exception that it operates on a krb5_address instead of a struct sockaddr

krb5_anyaddr fills in a "struct sockaddr" sa that can be used to
.Xf bind 3 to. Sa_size should be initially contain the size of the sa, and after the call, it will contain the actual length of the address.

krb5_print_address prints the address in addr to the a string string that have the length len. If ret_len if not NULL, it will be filled in length of the string.

krb5_parse_address Returns the resolving a hostname in string to the krb5_addresses addresses.

krb5_address_order compares to addresses addr1 and addr2 so that it can be used for sorting addresses. If the addresses are the same address krb5_address_order will be return 0.

krb5_address_compare compares the addresses addr1 and addr2. returns TRUE if the two addresses are the same.

krb5_address_search checks if the address addr is a member of the address set list addrlist.

krb5_free_address frees the data stored in the address that is alloced with any of the krb5_address functions.

krb5_free_addresses frees the data stored in the addresses that is alloced with any of the krb5_address functions.

krb5_copy_address copies the content of address inaddr to outaddr.

krb5_copy_addresses copies the content of the address list inaddr to outaddr.

krb5_append_addresses adds the set of addresses in source to dest. While copying the addresses, duplicates are also sorted out.

krb5_make_addrport allocates and creates an krb5_address in res of type KRB5_ADDRESS_ADDRPORT from ( addr, port).

SEE ALSO

krb5(3), krb5.conf(5), kerberos(8)

 
Created by Blin Media, 2008-2013