---
name: "rpc_gss_get_principal_name"
section: "3t"
platform: "linux"
package: "libtirpc"
version: "1.3.8-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rpc_gss_get_principal_name/3t"
---

# rpc\_gss\_get\_principal\_name(3t)

Get a principal name

## 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)](/rpc/3.md), [gssapi(3)](/gssapi/3.md), [gss\_export\_name(3)](/gss_export_name/3.md), [rpcsec\_gss(3)](/rpcsec_gss/3.md)

## AUTHORS

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