Content-type: text/html Man page of rpc_gss_set_svc_name

rpc_gss_set_svc_name

Section: Networking Services Library Functions (3NSL)
Updated: 5 Feb 2002
Index Return to Main Contents
 

NAME

rpc_gss_set_svc_name - send a principal name to a server  

SYNOPSIS

#include <rpc/rpcsec_gss.h> 

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

DESCRIPTION

rpc_gss_set_svc_name() sets the name of a principal the server is to represent. If a server is going to act as more than one principal, this procedure can be invoked for every such principal.  

PARAMETERS

Information on RPCSEC_GSS data types for parameters may be found on the rpcsec_gss(3NSL) man page.

principal An ASCII string representing the server's principal name, given in the form of service@host.

mech An ASCII string representing the security mechanism in use. Valid strings may be found in the /etc/gss/mech file, or by using rpc_gss_get_mechanisms().

req_time The time, in seconds, for which a credential should be valid. Note that the         req_time is a hint to the underlying mechanism. The actual time that the credential will remain
valid is mechanism dependent. In the case of kerberos the actual time will be GSS_C_INDEFINITE.

program The RPC program number for this service.

version The RPC version number for this service.

 

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/mech File containing valid security mechanisms

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelMT-Safe
AvailabilitySUNWrsg (32-bit)
SUNWrsgx (64-bit)

 

SEE ALSO

rpc(3NSL), rpc_gss_get_mechanisms(3NSL), rpc_gss_get_principal_name(3NSL), rpcsec_gss(3NSL), mech(4), attributes(5)

ONC+ Developer's Guide

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
RETURN VALUES
FILES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:38:43 GMT, October 02, 2010