RPC\_GSS\_SET\_SVC\_NAME(3) Library Functions Manual RPC\_GSS\_SET\_SVC\_NAME(3)

# [NAME](#NAME)

`rpc_gss_set_svc_name` — Associate a GSS-API service principal with an RPC service

# [SYNOPSIS](#SYNOPSIS)

`#include <rpc/rpcsec_gss.h>`

`bool_t`  
`rpc_gss_set_svc_name`(`const char *principal`, `const char *mechanism`, `u_int req_time`, `u_int program`, `u_int version`);

# [DESCRIPTION](#DESCRIPTION)

This function registers a service principal which will be used to authenticate RPCSEC\_GSS security contexts for a given RPC program and version.

# [PARAMETERS](#PARAMETERS)

principal

A string representing the service principal in the form "service@hostname"

mechanism

The name of the security mechanism

req\_time

The time in seconds that the service credentials should remain valid. See [gss\_acquire\_cred(3)](/man/os/libtirpc/gss_acquire_cred.3) for more details. principal.

program

RPC program number for this service

version

RPC program version for this service

# [RETURN VALUES](#RETURN_VALUES)

Returns `TRUE` if the service principal was registered or `FALSE` otherwise.

# [AVAILABILITY](#AVAILABILITY)

The [`rpc_gss_set_svc_name`](#rpc_gss_set_svc_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\_acquire\_cred(3)](/man/os/libtirpc/gss_acquire_cred.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_set_svc_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