freebsd man page for rpc_gss_set_svc_name

RPC_GSS_SET_SVC_NAME(3) 				   BSD Library Functions Manual 				   RPC_GSS_SET_SVC_NAME(3)

NAME
     rpc_gss_set_svc_name -- Associate a GSS-API service principal with an RPC service

LIBRARY
     RPC GSS-API Authentication Library (librpcsec_gss, -lrpcsec_gss)

SYNOPSIS
     #include <rpc/rpcsec_gss.h>

     bool_t
     rpc_gss_set_svc_name(const char *principal, const char *mechanism, u_int req_time, u_int program, u_int version);

DESCRIPTION
     This function registers a service principal which will be used to authenticate RPCSEC_GSS security contexts for a given RPC program and ver-
     sion.

PARAMETERS
     principal	A string representing the service principal in the form "service@hostname"

     mechanism	The name of the security mechanism

     req_time	The time in seconds that the service credentials should remain valid.  See gss_acquire_cred(3) for more details.  principal.

     program	RPC program number for this service

     version	RPC program version for this service

RETURN VALUES
     Returns TRUE if the service principal was registered or FALSE otherwise.

SEE ALSO
     gss_acquire_cred(3), gssapi(3), rpc(3), rpcset_gss(3)

HISTORY
     The rpc_gss_set_svc_name function first appeared in FreeBSD 8.0.

AUTHORS
     This manual page was written by Doug Rabson <dfr@FreeBSD.org>.

BSD
								 January 26, 2010							       BSD