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 Availability system/library/security/rpcsec MT-Level MT-Safe

See also

rpc(3NSL), rpc_gss_get_mech_info(3NSL), rpcsec_gss(3NSL), qop(4) , attributes(5)

ONC+ RPC Developer’s Guide

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