RPC_GSS_GET_VERSIONS(3) BSD Library Functions Manual RPC_GSS_GET_VERSIONS(3)NAME
rpc_gss_get_versions -- Get supported protocol version
LIBRARY
RPC GSS-API Authentication Library (librpcsec_gss, -lrpcsec_gss)
SYNOPSIS
#include <rpc/rpcsec_gss.h>
bool_t
rpc_gss_get_versions(u_int *vers_hi, u_int *vers_lo);
DESCRIPTION
Return the highest and lowest supported versions of the RPCSEC_GSS protocol.
PARAMETERS
vers_hi The value of *vers_hi is set to the highest supported protocol version
vers_lo The value of *vers_lo is set to the lowest supported protocol version
SEE ALSO gssapi(3), rpc(3), rpcset_gss(3)HISTORY
The rpc_gss_get_versions function first appeared in FreeBSD 8.0.
AUTHORS
This manual page was written by Doug Rabson <dfr@FreeBSD.org>.
BSD January 26, 2010 BSD
Check Out this Related Man Page
rpc_gss_get_mechanisms(3NSL) Networking Services Library Functions rpc_gss_get_mechanisms(3NSL)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 Pro-
tections (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 The highest and lowest versions of RPCSEC_GSS supported.
vers_lo
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 TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
|Availability |SUNWrsg (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.
SunOS 5.10 29 Jun 2001 rpc_gss_get_mechanisms(3NSL)