create a security context using the RPCSEC_GSS protocol
const char *principal, const char
*mechanism, rpc_gss_service_t service,
const char *qop, rpc_gss_options_req_t
This function is used to establish a security context between an application and
a remote peer using the RPSEC_GSS protocol.
- An RPC handle which is connected to the remote peer
- The name of the service principal on the remote peer. For instance, a
principal such as “email@example.com” might be used by
an application which needs to contact an NFS server
- The name of the GSS_API mechanism to use for the new security context.
"kerberos_v5" is currently the only supported mechanism.
- Type of service requested.
- The default - typically the same as
- RPC headers only are integrity protected by a checksum.
- RPC headers and data are integrity protected by a checksum.
- RPC headers are integrity protected by a checksum and data is
- The name of the Quality of Protection to use for the new security context,
or NULL to use the default QOP. "GSS_C_QOP_DEFAULT" is currently
the only supported QOP.
- Extra security context options to be passed to the underlying GSS-API
NULL to supply default
- Various values returned by the underlying GSS-API mechanism. Pass
NULL if these values are not required.
If the security context was created successfully, a pointer to an
AUTH structure that represents the context is returned.
To use this security context for subsequent RPC calls, set
clnt->cl_auth to this value.
rpc_gss_seccreate() function is part of libtirpc.
This manual page was written by Doug Rabson