oysteikt/heimdal
0
0
Fork 0
Code Issues 5 Pull Requests Releases Activity

add krb5_krbhst_format_string and krb5_krbhst_get_addrinfo

Browse Source 
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@10158 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
Assar Westerlund
2001-06-21 14:35:21 +00:00
parent f1ea482295
commit e632f28f2e
1 changed files with 20 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
lib/krb5/krb5_krbhst_init.3
View File

@@ -8,7 +8,9 @@
.Nm krb5_krbhst_next , .Nm krb5_krbhst_next ,
.Nm krb5_krbhst_next_as_string , .Nm krb5_krbhst_next_as_string ,
.Nm krb5_krbhst_reset , .Nm krb5_krbhst_reset ,
.Nm krb5_krbhst_free .Nm krb5_krbhst_free ,
.Nm krb5_krbhst_format_string ,
.Nm krb5_krbhst_get_addrinfo
.Nd lookup Kerberos KDC hosts .Nd lookup Kerberos KDC hosts
.Sh SYNOPSIS .Sh SYNOPSIS
.Fd #include <krb5.h> .Fd #include <krb5.h>
@@ -23,8 +25,11 @@
.Fn krb5_krbhst_reset "krb5_context context" "krb5_krbhst_handle handle" .Fn krb5_krbhst_reset "krb5_context context" "krb5_krbhst_handle handle"
.Ft void .Ft void
.Fn krb5_krbhst_free "krb5_context context" "krb5_krbhst_handle handle" .Fn krb5_krbhst_free "krb5_context context" "krb5_krbhst_handle handle"
.Ft krb5_error_code
.Fn krb5_krbhst_format_string "krb5_context context" "const krb5_krbhst_info *host" "char *hostname" "size_t hostlen"
.Ft krb5_error_code
.Fn krb5_krbhst_get_addrinfo "krb5_context context" "krb5_krbhst_info *host" "struct addrinfo **ai"
.Sh DESCRIPTION .Sh DESCRIPTION
These functions are used to sequence through all Kerberos hosts of a These functions are used to sequence through all Kerberos hosts of a
particular realm and service. The service type can be the KDCs, the particular realm and service. The service type can be the KDCs, the
administrative servers, the password changing servers, or the servers administrative servers, the password changing servers, or the servers
@@ -84,6 +89,17 @@ will return the first host.
When done with the handle, When done with the handle,
.Fn krb5_krbhst_free .Fn krb5_krbhst_free
should be called. should be called.
.Pp
To use a
.Va krb5_krbhst_info ,
there are two functions:
.Fn krb5_krbhst_format_string
that will return a printable representation of that struct
and
.Fn krb5_krbhst_get_addrinfo
that will return a
.Va struct addrinfo
that can then be used for communicating with the server mentioned.
.Sh EXAMPLE .Sh EXAMPLE
The following code will print the KDCs of the realm The following code will print the KDCs of the realm
.Dq MY.REALM . .Dq MY.REALM .
@@ -100,4 +116,5 @@ krb5_krbhst_free(context, handle);
.Sh HISTORY .Sh HISTORY
These functions first appeared in Heimdal 0.3g. These functions first appeared in Heimdal 0.3g.
.Sh SEE ALSO .Sh SEE ALSO
.Xr krb5_get_krbhst 3 .Xr krb5_get_krbhst 3 ,
.Xr getaddrinfo 3