rpc_gss_get_principal_name(3t)

rpc_gss_get_principal_name3t

Get a principal name

Usage

#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);

Overview

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

Releases

Unchanged in 5 releases since Debian 10 (Buster).

  1. 10–Arch

Availability

The rpc_gss_get_principal_name() function is part of libtirpc.

Authors

This manual page was written by Doug Rabson ⟨[email protected]⟩.

From libtirpc 1.3.8-1 in Arch Linux 2026-11-07. Parsed by carta from the page's mdoc source.