Content-type: text/html Man page of rpc_gss_get_mechanisms

rpc_gss_get_mechanisms

Section: Networking Services Library Functions (3NSL)
Updated: 29 Jun 2001
Index Return to Main Contents
 

NAME

rpc_gss_get_mechanisms, rpc_gss_get_mech_info, rpc_gss_get_versions, rpc_gss_is_installed - get information on mechanisms and RPC version  

SYNOPSIS

#include <rpc/rpcsec_gss.h> 

char **rpc_gss_get_mechanisms();

char **rpc_gss_get_mech_info(char *mech, rpc_gss_service_t *service);

bool_t rpc_gss_get_versions(u_int *vers_hi, u_int *vers_lo);

bool_t rpc_gss_is installed(char *mech);  

DESCRIPTION

These "convenience functions" return information on available security mechanisms and versions of RPCSEC_GSS .

rpc_gss_get_mechanisms() Returns a list of supported security mechanisms as a null-terminated list of character strings.

rpc_gss_get_mech_info() Takes two arguments: an ASCII string representing a mechanism type, for example, kerberosv5, and a pointer to a rpc_gss_service_t enum. rpc_gss_get_mech_info() will return NULL upon error or if no /etc/gss/qop file is present. Otherwise, it returns a null-terminated list of character strings of supported Quality of Protections (QOPs) for this mechanism. NULL or empty list implies only that the default QOP is available and can be specified to routines that need to take a QOP string parameter as NULL or as an empty string.

rpc_gss_get_versions() Returns the highest and lowest versions of RPCSEC_GSS supported.

rpc_gss_is_installed() Takes an ASCII string representing a mechanism, and returns TRUE if the mechanism is installed.

 

PARAMETERS

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

mech An ASCII string representing the security mechanism in use. Valid strings may also be found in the /etc/gss/mech file.

service A pointer to a rpc_gss_service_t enum, representing the current security service (privacy, integrity, or none).

vers_hi
vers_lo The highest and lowest versions of RPCSEC_GSS supported.

 

FILES

/etc/gss/mech File containing valid security mechanisms

/etc/gss/qop File containing valid QOP values

 

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),rpcsec_gss(3NSL), mech(4), qop(4), attributes(5)

ONC+ Developer's Guide

Linn, J. RFC 2743, Generic Security Service Application Program Interface Version 2, Update 1. Network Working Group. January 2000.  

NOTES

This function will change in a future release.


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
FILES
ATTRIBUTES
SEE ALSO
NOTES

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