RPC\_GSS\_GET\_PRINCIPAL\_NAME(3) Library Functions Manual RPC\_GSS\_GET\_PRINCIPAL\_NAME(3)

# [NAME](#NAME)

`rpc_gss_get_principal_name` — Get a principal name

# [SYNOPSIS](#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](#DESCRIPTION)

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

# [PARAMETERS](#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](#RETURN_VALUES)

Returns `TRUE` if the principal was created or `FALSE` otherwise

# [AVAILABILITY](#AVAILABILITY)

The [`rpc_gss_get_principal_name`](#rpc_gss_get_principal_name)() function is part of libtirpc.

# [SEE ALSO](#SEE_ALSO)

[rpc(3)](/man/os/libtirpc/rpc.3), [gssapi(3)](/man/os/libtirpc/gssapi.3), [gss\_export\_name(3)](/man/os/libtirpc/gss_export_name.3), [rpcsec\_gss(3)](/man/os/libtirpc/rpcsec_gss.3)

# [AUTHORS](#AUTHORS)

This manual page was written by Doug Rabson ⟨dfr@FreeBSD.org⟩.

January 26, 2010 Linux 4.19.0-gvisor

---

Document: rpc_gss_get_principal_name(3t) from libtirpc 1.3.8-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/project/libtirpc/libtirpc/1.3.8/libtirpc-1.3.8.tar.bz2