Go to main content

man pages section 3: Basic Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

rpc_gss_get_mechanisms(3C)

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(3C) 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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/library/security/rpcsec
MT-Level
MT-Safe

See Also

rpc(3C), rpcsec_gss(3C), mech(5), qop(5), attributes(7)

ONC+ RPC 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.