Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ./../../../../../../usr/man/man3gss/gss_oid_to_str.3gss
Real path: /usr/share/man/man3gss/gss_oid_to_str.3gss
Zurück
'\" te '\" te .\" Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved. .TH gss_oid_to_str 3gss "22 Aug 2011" "Solaris 11.4" "Generic Security Services API Library Functions" .SH NAME gss_oid_to_str \- convert an OID to a string .SH SYNOPSIS .LP .nf \fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fB\fR\fBgss_oid_to_str\fR(\fBOM_uint32 *\fR\fIminor_status\fR, \fBconst gss_OID\fR \fIoid\fR, \fBgss_buffer_t\fR\fIoid_str\fR); .fi .SH PARAMETERS .sp .ne 2 .mk .na \fB\fIminor_status\fR\fR .ad .RS 16n .rt Status code returned by underlying mechanism. .RE .sp .ne 2 .mk .na \fB\fIoid\fR\fR .ad .RS 16n .rt \fBGSS-API\fR \fBOID\fR structure to convert. .RE .sp .ne 2 .mk .na \fB\fIoid_str\fR\fR .ad .RS 16n .rt String to receive converted \fBOID\fR. .RE .SH DESCRIPTION .sp .LP The \fBgss_oid_to_str()\fR function converts a \fBGSS-API\fR \fBOID\fR structure to a string. You can use the function to convert the name of a mechanism from an \fBOID\fR to a simple string. This function is a convenience function, as is its complementary function, \fBgss_str_to_oid\fR(3GSS). .sp .LP If an \fBOID\fR must be created, use \fBgss_create_empty_oid_set\fR(3GSS) and \fBgss_add_oid_set_member\fR(3GSS) to create it. \fBOID\fRs created in this way must be released with \fBgss_release_oid_set\fR(3GSS). However, it is strongly suggested that applications use the default \fBGSS-API\fR mechanism instead of creating an \fBOID\fR for a specific mechanism. .SH ERRORS .sp .LP The \fBgss_oid_to_str()\fR function returns one of the following status codes: .sp .ne 2 .mk .na \fB\fBGSS_S_CALL_INACCESSIBLE_READ\fR\fR .ad .sp .6 .RS 4n A required input parameter could not be read. .RE .sp .ne 2 .mk .na \fB\fBGSS_S_CALL_INACCESSIBLE_WRITE\fR\fR .ad .sp .6 .RS 4n A required output parameter could not be written. .RE .sp .ne 2 .mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .sp .6 .RS 4n Successful completion. .RE .sp .ne 2 .mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .sp .6 .RS 4n The underlying mechanism detected an error for which no specific \fBGSS\fR status code is defined. The mechanism-specific status code reported by means of the \fIminor_status\fR parameter details the error condition. .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .sp .TS tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPEATTRIBUTE VALUE _ MT-LevelSafe .TE .\" Oracle has added the ARC stability level to this manual page .SH ATTRIBUTES See .BR attributes (7) for descriptions of the following attributes: .sp .TS box; cbp-1 | cbp-1 l | l . ATTRIBUTE TYPE ATTRIBUTE VALUE = Availability security/kerberos-5 = Stability Pass-through committed .TE .PP .SH SEE ALSO .sp .LP \fBgss_add_oid_set_member\fR(3GSS), \fBgss_create_empty_oid_set\fR(3GSS), \fBgss_release_oid_set\fR(3GSS), \fBgss_str_to_oid\fR(3GSS), \fBattributes\fR(7) .sp .LP .SH WARNINGS .sp .LP This function is included for compatibility only with programs using earlier versions of the \fBGSS-API\fR and should not be used for new programs. Other implementations of the \fBGSS-API\fR might not support this function, so portable programs should not rely on it. Sun might not continue to support this function. .SH NOTES .\" Oracle has added source availability information to this manual page Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source-code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from http://web.mit.edu/kerberos/dist/krb5/1.20/krb5-1.20.2.tar.gz. Further information about this software can be found on the open source community website at http://web.mit.edu/kerberos/.