krb5_sname_to_principal(3)

KRB5_PRINCIPAL(3)          UNIX Programmer's Manual          KRB5_PRINCIPAL(3)

NAME

     krb5_sname_to_principal, krb5_sock_to_principal - create a service prin-
     cipal

LIBRARY

     Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS

     krb5_error_code
     krb5_sname_to_principal(krb5_context context, const char *hostname,
             const char *sname, int32_t type, krb5_principal *principal)

     krb5_error_code
     krb5_sock_to_principal(krb5_context context, int socket,
             const char *sname, int32_t type, krb5_principal *principal)

DESCRIPTION

     These functions create a ``service'' principal that can, for instance, be
     used to lookup a key in a keytab. For both these function the sname pa-
     rameter will be used for the first component of the created principal. If
     sname is NULL, ``host'' will be used instead.  krb5_sname_to_principal()
     will use the passed hostname for the second component. If type
     KRB5_NT_SRV_HST this name will be looked up with gethostbyname().  If
     hostname is NULL, the local hostname will be used.

     krb5_sock_to_principal() will use the ``sockname'' of the passed socket,
     which should be a bound AF_INET socket.

SEE ALSO

     krb5_425_conv_principal(3),  krb5_build_principal(3),
     krb5_free_principal(3),  krb5_parse_name(3),  krb5_unparse_name(3)

 HEIMDAL                        August 8, 1997                               1