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 only unless they
are changed again.
PARAMETERS
Information on
RPCSEC_GSS
data types for parameters may be found on the
rpcsec_gss(3N)
manpage.
- 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().
MULTITHREAD USAGE
- Thread Safe:
Yes
- Cancel Safe:
Yes
- Fork Safe:
No
- Async-cancel Safe:
No
- Async-signal Safe:
No
These functions can be called safely in a multithreaded environment.
They may be cancellation points in that they call functions that are
cancel points.
In a multithreaded environment, these functions are
not safe to be called by a child process after
fork()
and before
exec().
These functions should not be called by a multithreaded application
that supports asynchronous cancellation or asynchronous signals.
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 QOP values
SEE ALSO
rpc(3N),
rpc_gss_get_mech_info(3N),
rpcsec_gss(3N),
qop(4).
ONC+ Developer's Guide
Network Working Group RFC 2078