diff options
Diffstat (limited to 'crypto/heimdal/lib/krb5/krb5_principal_get_realm.3')
| -rw-r--r-- | crypto/heimdal/lib/krb5/krb5_principal_get_realm.3 | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/crypto/heimdal/lib/krb5/krb5_principal_get_realm.3 b/crypto/heimdal/lib/krb5/krb5_principal_get_realm.3 index 07bffa4..bd02ce6 100644 --- a/crypto/heimdal/lib/krb5/krb5_principal_get_realm.3 +++ b/crypto/heimdal/lib/krb5/krb5_principal_get_realm.3 @@ -1,5 +1,5 @@ .\" Copyright (c) 2001 Kungliga Tekniska Högskolan -.\" $Id: krb5_principal_get_realm.3,v 1.2 2001/11/09 09:36:51 joda Exp $ +.\" $Id: krb5_principal_get_realm.3,v 1.4 2002/08/28 15:30:56 joda Exp $ .Dd June 20, 2001 .Dt KRB5_PRINCIPAL_GET_REALM 3 .Os HEIMDAL @@ -7,6 +7,8 @@ .Nm krb5_principal_get_realm , .Nm krb5_principal_get_comp_string .Nd decompose a principal +.Sh LIBRARY +Kerberos 5 Library (libkrb5, -lkrb5) .Sh SYNOPSIS .Fd #include <krb5.h> .Ft "const char *" @@ -20,24 +22,24 @@ either the realm or a specific component. The returned string points to data inside the principal, so they are valid only as long as the principal exists. .Pp -The +The .Fa component argument to .Fn krb5_principal_get_comp_string is the component number to return, from zero to the total number of -components minus one. If a the requested component number is out of range, +components minus one. If a the requested component number is out of range, .Dv NULL is returned. .Pp -These functions can be seen as a replacement for the +These functions can be seen as a replacement for the .Fn krb5_princ_realm , .Fn krb5_princ_component and related macros, described as intermal in the MIT API specification. A difference is that these functions return strings, not .Dv krb5_data . -A reason to return -.Dv krb5_data +A reason to return +.Dv krb5_data was that it was believed that principal components could contain binary data, but this belief was unfounded, and it has been decided that principal components are infact UTF8, so it's safe to use zero |
