|
|
|
[Insert name here] Reference Manual | |
|---|---|---|---|---|
extern void (); const char* gss_check_version (const char *req_version); int gss_oid_equal (gss_OID first_oid, gss_OID second_oid); OM_uint32 gss_copy_oid (OM_uint32 *minor_status, const gss_OID src_oid, gss_OID dest_oid); OM_uint32 gss_duplicate_oid (OM_uint32 *minor_status, const gss_OID src_oid, gss_OID *dest_oid); int gss_userok (const gss_name_t name, const char *username); int gss_encapsulate_token (const gss_buffer_t input_message, gss_OID token_oid, gss_buffer_t output_message); int gss_encapsulate_token_prefix (const gss_buffer_t input_message, const char *prefix, size_t prefixlen, gss_OID token_oid, gss_buffer_t output_message); int gss_decapsulate_token (const gss_buffer_t input_message, const gss_OID token_oid, char **dataptr, size_t *datalen); extern gss_OID_desc GSS_C_NT_USER_NAME_static; extern gss_OID_desc GSS_C_NT_MACHINE_UID_NAME_static; extern gss_OID_desc GSS_C_NT_STRING_UID_NAME_static; extern gss_OID_desc GSS_C_NT_HOSTBASED_SERVICE_X_static; extern gss_OID_desc GSS_C_NT_HOSTBASED_SERVICE_static; extern gss_OID_desc GSS_C_NT_ANONYMOUS_static; extern gss_OID_desc GSS_C_NT_EXPORT_NAME_static;
const char* gss_check_version (const char *req_version);
Check library version.
WARNING: This function is a GNU GSS specific extension, and is not part of the official GSS API.
req_version : |
version string to compare with, or NULL |
| Returns : | Check that the the version of the library is at
minimum the one given as a string in req_version and return the
actual version string of the library; return NULL if the condition
is not met. If NULL is passed to this function no check is done
and only the version string is returned. It is a pretty good idea
to run this function as soon as possible, because it may also
intializes some subsystems. In a multithreaded environment if
should be called before any more threads are created.
|
int gss_oid_equal (gss_OID first_oid,
gss_OID second_oid);
Compare two OIDs for equality. The comparison is "deep", i.e., the actual byte sequences of the OIDs are compared instead of just the pointer equality.
WARNING: This function is a GNU GSS specific extension, and is not part of the official GSS API.
first_oid : |
(Object ID, read) First Object identifier. |
second_oid : |
(Object ID, read) First Object identifier. |
| Returns : | Returns boolean value true when the two OIDs are equal, otherwise false. |
OM_uint32 gss_copy_oid (OM_uint32 *minor_status, const gss_OID src_oid, gss_OID dest_oid);
Make an exact copy of the given OID, that shares no memory areas with the original.
WARNING: This function is a GNU GSS specific extension, and is not part of the official GSS API.
minor_status : |
(integer, modify) Mechanism specific status code. |
src_oid : |
(Object ID, read) The object identifier to copy. |
dest_oid : |
(Object ID, modify) The resultant copy of src_oid.
Storage associated with this name must be freed by the
application, but gss_release_oid() cannot be used generally as it
deallocate the the oid structure itself too (use
gss_duplicate_oid() if you don't want this problem.)
|
| Returns : | `GSS_S_COMPLETE`: Successful completion. |
OM_uint32 gss_duplicate_oid (OM_uint32 *minor_status, const gss_OID src_oid, gss_OID *dest_oid);
Allocate a new OID and make it an exact copy of the given OID, that shares no memory areas with the original.
WARNING: This function is a GNU GSS specific extension, and is not part of the official GSS API.
minor_status : |
(integer, modify) Mechanism specific status code. |
src_oid : |
(Object ID, read) The object identifier to duplicate. |
dest_oid : |
(Object ID, modify) The resultant copy of src_oid.
Storage associated with this name must be freed by the
application, by calling gss_release_oid().
|
| Returns : | `GSS_S_COMPLETE`: Successful completion. |
int gss_userok (const gss_name_t name, const char *username);
Compare the username against the output from gss_export_name()
invoked on name, after removing the leading OID. This answers the
question whether the particular mechanism would authenticate them
as the same principal
WARNING: This function is a GNU GSS specific extension, and is not part of the official GSS API.
name : |
(gss_name_t, read) Name to be compared. |
username : |
Zero terminated string with username. |
| Returns : | Returns 0 if the names match, non-0 otherwise. |
int gss_encapsulate_token (const gss_buffer_t input_message,
gss_OID token_oid,
gss_buffer_t output_message);
input_message : |
|
token_oid : |
|
output_message : |
|
| Returns : |
int gss_encapsulate_token_prefix (const gss_buffer_t input_message,
const char *prefix,
size_t prefixlen,
gss_OID token_oid,
gss_buffer_t output_message);
input_message : |
|
prefix : |
|
prefixlen : |
|
token_oid : |
|
output_message : |
|
| Returns : |
int gss_decapsulate_token (const gss_buffer_t input_message,
const gss_OID token_oid,
char **dataptr,
size_t *datalen);
input_message : |
|
token_oid : |
|
dataptr : |
|
datalen : |
|
| Returns : |