# rpc_gss_get_principal_name(3t) - man - phpman

RPC_GSS_GET_PRINCIPAL... BSD Library Functions Manual RPC_GSS_GET_PRINCIPAL...

## NAME
     **rpc**___**gss**___**get**___**principal**___**name** — Get a principal name

## SYNOPSIS
     **#include** **<rpc/rpcsec**___**gss.h>**

     _bool_t_
     **rpc**___**gss**___**get**___**principal**___**name**(_rpc_gss_principal_t_ _*principal_, _const_ _char_ _*mech_, _const_ _char_ _*name_,
         _const_ _char_ _*node_, _const_ _char_ _*domain_);

## DESCRIPTION
     This function can be used to generate a client principal name from various strings.

## PARAMETERS
     principal  If the principal is created successfully, _*principal_ will be set to point at the new
                principal in GSS-API exported name form

     mech       The name of the mechanism for this principal

     name       The name part of the principal

     node       If non-null, the hostname or instance part of the principal

     domain     If non-null, the domain or realm part of the principal

## RETURN VALUES
     Returns TRUE if the principal was created or FALSE otherwise

## AVAILABILITY
     The **rpc**___**gss**___**get**___**principal**___**name**() function is part of libtirpc.

## SEE ALSO
     [rpc(3)](https://www.chedong.com/phpMan.php/man/rpc/3/markdown), [gssapi(3)](https://www.chedong.com/phpMan.php/man/gssapi/3/markdown), [gss_export_name(3)](https://www.chedong.com/phpMan.php/man/gssexportname/3/markdown), [rpcsec_gss(3)](https://www.chedong.com/phpMan.php/man/rpcsecgss/3/markdown)

## AUTHORS
     This manual page was written by Doug Rabson <<dfr@FreeBSD.org>>.

BSD                            January 26, 2010                            BSD