man pages section 3: Networking Library Functions

rpc_gss_set_defaults(3NSL)

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(3NSL) 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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	MT-Safe
Availability	SUNWrsg (32–bit)
	SUNWrsgx (64–bit)