RPC_GSS_SECCREATE(3) BSD Library Functions Manual RPC_GSS_SECCREATE(3)
NAME
rpc_gss_seccreate -- create a security context using the RPCSEC_GSS protocol
SYNOPSIS
#include <rpc/rpcsec_gss.h>
AUTH *
rpc_gss_seccreate(CLIENT *clnt, const char *principal, const char *mechanism,
rpc_gss_service_t service, const char *qop, rpc_gss_options_req_t *options_req,
rpc_gss_options_ret_t *options_ret);
DESCRIPTION
This function is used to establish a security context between an application and a remote
peer using the RPSEC_GSS protocol.
PARAMETERS
clnt An RPC handle which is connected to the remote peer
principal The name of the service principal on the remote peer. For instance, a princi-
pal such as "nfs AT server.com" might be used by an application which
needs to contact an NFS server
mechanism The name of the GSS_API mechanism to use for the new security context. "ker-
beros_v5" is currently the only supported mechanism.
service Type of service requested.
rpc_gss_svc_default The default - typically the same as rpc_gss_svc_none.
rpc_gss_svc_none RPC headers only are integrity protected by a checksum.
rpc_gss_svc_integrity RPC headers and data are integrity protected by a check-
sum.
rpc_gss_svc_privacy RPC headers are integrity protected by a checksum and
data is encrypted.
qop 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 sup-
ported QOP.
options_req Extra security context options to be passed to the underlying GSS-API mecha-
nism. Pass NULL to supply default values.
options_ret Various values returned by the underlying GSS-API mechanism. Pass NULL if
these values are not required.
RETURN VALUES
If the security context was created successfully, a pointer to an AUTH structure that repre-
sents the context is returned. To use this security context for subsequent RPC calls, set
clnt->cl_auth to this value.
AVAILABILITY
The rpc_gss_seccreate() function is part of libtirpc.
SEE ALSO
rpc(3), gssapi(3), mech(5), qop(5), rpcsec_gss(3)
AUTHORS
This manual page was written by Doug Rabson <dfr AT FreeBSD.org>.
BSD January 26, 2010 BSD
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2026-01-10 13:30 @216.73.216.127 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)