Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

rpc_gss_set_defaults(3C)

Name

rpc_gss_set_defaults - change service, QOP for a session

Synopsis

#include <rpc/rpcsec_gss.h> 

bool_t rpc_gss_set_defaults(AUTH *auth, rpc_gss_service_t service, char *qop);

Description

rpc_gss_set_defaults() allows an application to change the service (privacy, integrity, authentication, or none) and Quality of Protection (QOP) for a transfer session. New values apply to the rest of the session (unless changed again).

Parameters

Information on RPCSEC_GSS data types for parameters may be found on the rpcsec_gss(3C) man page.

auth

An RPC authentication handle returned by rpc_gss_seccreate()).

service

An enum of type rpc_gss_service_t, representing one of the following types of security service: authentication, privacy, integrity, or none.

qop

A string representing Quality of Protection. Valid strings may be found in the file /etc/gss/qop or by using rpc_gss_get_mech_info().

Return Values

rpc_gss_set_svc_name() returns TRUE if it is successful; otherwise, use rpc_gss_get_error() to get the error associated with the failure.

Files

/etc/gss/qop

File containing valid QOPs

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/library/security/rpcsec
MT-Level
MT-Safe

See Also

rpc(3C), rpc_gss_get_mech_info(3C), rpcsec_gss(3C), qop(5), attributes(7)

ONC+ RPC Developer’s Guide

Linn, J. RFC 2078, Generic Security Service Application Program Interface, Version 2. Network Working Group. January 1997.