diff options
Diffstat (limited to 'crypto/heimdal/lib/krb5/krb5_krbhst_init.3')
| -rw-r--r-- | crypto/heimdal/lib/krb5/krb5_krbhst_init.3 | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/crypto/heimdal/lib/krb5/krb5_krbhst_init.3 b/crypto/heimdal/lib/krb5/krb5_krbhst_init.3 index 109c64c..6bcf07f 100644 --- a/crypto/heimdal/lib/krb5/krb5_krbhst_init.3 +++ b/crypto/heimdal/lib/krb5/krb5_krbhst_init.3 @@ -1,5 +1,5 @@ .\" Copyright (c) 2001 Kungliga Tekniska Högskolan -.\" $Id: krb5_krbhst_init.3,v 1.3 2001/11/09 09:36:24 joda Exp $ +.\" $Id: krb5_krbhst_init.3,v 1.5 2002/08/28 15:30:54 joda Exp $ .Dd June 17, 2001 .Dt KRB5_KRBHST_INIT 3 .Os HEIMDAL @@ -12,9 +12,10 @@ .Nm krb5_krbhst_format_string , .Nm krb5_krbhst_get_addrinfo .Nd lookup Kerberos KDC hosts +.Sh LIBRARY +Kerberos 5 Library (libkrb5, -lkrb5) .Sh SYNOPSIS .Fd #include <krb5.h> - .Ft krb5_error_code .Fn krb5_krbhst_init "krb5_context context" "const char *realm" "unsigned int type" "krb5_krbhst_handle *handle" .Ft krb5_error_code @@ -36,10 +37,10 @@ administrative servers, the password changing servers, or the servers for Kerberos 4 ticket conversion. .Pp First a handle to a particular service is obtained by calling -.Fn krb5_krbhst_init -with the +.Fn krb5_krbhst_init +with the .Fa realm -of interest and the type of service to lookup. The +of interest and the type of service to lookup. The .Fa type can be one of: .Pp @@ -55,7 +56,7 @@ The is returned to the caller, and should be passed to the other functions. .Pp -For each call to +For each call to .Fn krb5_krbhst_next information a new host is returned. The former function returns in .Fa host @@ -73,7 +74,7 @@ typedef struct krb5_krbhst_info { } krb5_krbhst_info; .Ed .Pp -The related function, +The related function, .Fn krb5_krbhst_next_as_string , return the same information as a url-like string. .Pp @@ -82,11 +83,11 @@ When there are no more hosts, these functions return .Pp To re-iterate over all hosts, call .Fn krb5_krbhst_reset -and the next call to +and the next call to .Fn krb5_krbhst_next will return the first host. .Pp -When done with the handle, +When done with the handle, .Fn krb5_krbhst_free should be called. .Pp @@ -101,13 +102,13 @@ that will return a .Va struct addrinfo that can then be used for communicating with the server mentioned. .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 . .Bd -literal -offset indent krb5_krbhst_handle handle; char host[MAXHOSTNAMELEN]; krb5_krbhst_init(context, "MY.REALM", KRB5_KRBHST_KDC, &handle); -while(krb5_krbhst_next_as_string(context, handle, +while(krb5_krbhst_next_as_string(context, handle, host, sizeof(host)) == 0) printf("%s\\n", host); krb5_krbhst_free(context, handle); |
