diff options
Diffstat (limited to 'usr/src/man/man3gss')
38 files changed, 262 insertions, 1050 deletions
diff --git a/usr/src/man/man3gss/gss_accept_sec_context.3gss b/usr/src/man/man3gss/gss_accept_sec_context.3gss index 0318dc6ee6..ce700001ab 100644 --- a/usr/src/man/man3gss/gss_accept_sec_context.3gss +++ b/usr/src/man/man3gss/gss_accept_sec_context.3gss @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_accept_sec_context 3GSS "22 May 2006" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_ACCEPT_SEC_CONTEXT 3GSS "May 22, 2006" .SH NAME gss_accept_sec_context \- accept a security context initiated by a peer application @@ -29,7 +29,6 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lgss\fR [ \fIlibrary\fR\&.\|. The parameter descriptions for \fBgss_accept_sec_context()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad @@ -40,7 +39,6 @@ The status code returned by the underlying mechanism. .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad @@ -52,7 +50,6 @@ The context handle to return to the initiator. This should be set to .sp .ne 2 -.mk .na \fB\fIacceptor_cred_handle\fR\fR .ad @@ -66,7 +63,6 @@ function returns \fBGSS_C_NO_CRED\fR. .sp .ne 2 -.mk .na \fB\fIinput_token_buffer\fR\fR .ad @@ -77,7 +73,6 @@ Token received from the context initiative. .sp .ne 2 -.mk .na \fB\fIinput_chan_bindings\fR\fR .ad @@ -90,7 +85,6 @@ channel identification information to the security context. Set to .sp .ne 2 -.mk .na \fB\fIsrc_name\fR\fR .ad @@ -103,7 +97,6 @@ deallocated by passing it to \fBgss_release_name()\fR. See .sp .ne 2 -.mk .na \fB\fImech_type\fR\fR .ad @@ -115,7 +108,6 @@ mechanism is used. .sp .ne 2 -.mk .na \fB\fIoutput_token\fR\fR .ad @@ -128,7 +120,6 @@ is zero, no token need be sent. .sp .ne 2 -.mk .na \fB\fIret_flags\fR\fR .ad @@ -141,7 +132,6 @@ if the given option is supported by the context. \fIret_flags\fR may contain one of the following values: .sp .ne 2 -.mk .na \fB\fBGSS_C_DELEG_FLAG\fR\fR .ad @@ -153,7 +143,6 @@ If true, delegated credentials are available by means of the .sp .ne 2 -.mk .na \fB\fBGSS_C_MUTUAL_FLAG\fR\fR .ad @@ -165,7 +154,6 @@ peer asked for mutual authentication. .sp .ne 2 -.mk .na \fB\fBGSS_C_REPLAY_FLAG\fR\fR .ad @@ -177,7 +165,6 @@ messages will not be detected. .sp .ne 2 -.mk .na \fB\fBGSS_C_SEQUENCE_FLAG\fR\fR .ad @@ -189,7 +176,6 @@ will not be detected. .sp .ne 2 -.mk .na \fB\fBGSS_C_CONF_FLAG\fR\fR .ad @@ -203,7 +189,6 @@ data-origin authentication and integrity services only. .sp .ne 2 -.mk .na \fB\fBGSS_C_INTEG_FLAG\fR\fR .ad @@ -216,7 +201,6 @@ per-message integrity service is not available. .sp .ne 2 -.mk .na \fB\fBGSS_C_ANON_FLAG\fR\fR .ad @@ -229,7 +213,6 @@ initiator has been authenticated normally. .sp .ne 2 -.mk .na \fB\fBGSS_C_PROT_READY_FLAG\fR\fR .ad @@ -244,7 +227,6 @@ only if the accompanying major status return value is \fBGSS_S_COMPLETE\fR. .sp .ne 2 -.mk .na \fB\fBGSS_C_TRANS_FLAG\fR\fR .ad @@ -259,7 +241,6 @@ security context cannot be transferred. .sp .ne 2 -.mk .na \fB\fItime_rec\fR\fR .ad @@ -271,7 +252,6 @@ The number of sections for which the context will remain value Specify .sp .ne 2 -.mk .na \fB\fIdelegated_cred_handle\fR\fR .ad @@ -364,150 +344,124 @@ these codes. \fBgss_accept_sec_context()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 30n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTINUE_NEEDED\fR\fR .ad .RS 30n -.rt A token from the peer application is required to complete the context, and that \fBgss_accept_sec_context()\fR must be called again with that token. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_TOKEN\fR\fR .ad .RS 30n -.rt Consistency checks performed on the \fIinput_token\fR failed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_CREDENTIAL\fR\fR .ad .RS 30n -.rt Consistency checks performed on the credential failed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CRED\fR\fR .ad .RS 30n -.rt The supplied credentials were not valid for context acceptance, or the credential handle did not reference any credentials. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CREDENTIALS_EXPIRED\fR\fR .ad .RS 30n -.rt The referenced credentials have expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_BINDINGS\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR contains different channel bindings than those specified by means of the \fIinput_chan_bindings\fR parameter. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 30n -.rt The supplied context handle did not refer to a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_SIG\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR contains an invalid \fBMIC\fR. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_OLD_TOKEN\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR was too old. This is a fatal error while establishing context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DUPLICATE_TOKEN\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR is valid, but it is duplicate of a token already processed. This is a fatal error while establishing context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_MECH\fR\fR .ad .RS 30n -.rt The token received specified a mechanism that is not supported by the implementation or the provided credential. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 30n -.rt 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. @@ -575,13 +529,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_acquire_cred.3gss b/usr/src/man/man3gss/gss_acquire_cred.3gss index b33cd4dfe3..a8de3f2bbc 100644 --- a/usr/src/man/man3gss/gss_acquire_cred.3gss +++ b/usr/src/man/man3gss/gss_acquire_cred.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_acquire_cred 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_ACQUIRE_CRED 3GSS "Jan 14, 2003" .SH NAME gss_acquire_cred \- acquire a handle for a pre-existing credential by name .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_acquire_cred\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -68,23 +68,19 @@ overhead of a deferred credential acquisition. The parameter descriptions for \fBgss_acquire_cred()\fR follow: .sp .ne 2 -.mk .na \fB\fIdesired_name\fR\fR .ad .RS 22n -.rt The name of the principal for which a credential should be acquired. .RE .sp .ne 2 -.mk .na \fB\fItime_req\fR\fR .ad .RS 22n -.rt The number of seconds that credentials remain valid. Specify \fBGSS_C_INDEFINITE\fR to request that the credentials have the maximum permitted lifetime @@ -92,24 +88,20 @@ permitted lifetime .sp .ne 2 -.mk .na \fB\fIdesired_mechs\fR\fR .ad .RS 22n -.rt The set of underlying security mechanisms that may be used. \fBGSS_C_NO_OID_SET\fR may be used to obtain a default. .RE .sp .ne 2 -.mk .na \fB\fIcred_usage\fR\fR .ad .RS 22n -.rt A flag that indicates how this credential should be used. If the flag is \fBGSS_C_ACCEPT\fR, then credentials will be used only to accept security credentials. \fBGSS_C_INITIATE\fR indicates that credentials will be used only @@ -119,12 +111,10 @@ credentials may be used either to initiate or accept security contexts. .sp .ne 2 -.mk .na \fB\fIoutput_cred_handle\fR\fR .ad .RS 22n -.rt The returned credential handle. Resources associated with this credential handle must be released by the application after use with a call to \fBgss_release_cred\fR(3GSS) @@ -132,12 +122,10 @@ handle must be released by the application after use with a call to .sp .ne 2 -.mk .na \fB\fIactual_mechs\fR\fR .ad .RS 22n -.rt The set of mechanisms for which the credential is valid. Storage associated with the returned \fBOID\fR-set must be released by the application after use with a call to \fBgss_release_oid_set\fR(3GSS). Specify \fBNULL\fR if not @@ -146,24 +134,20 @@ required. .sp .ne 2 -.mk .na \fB\fItime_rec\fR\fR .ad .RS 22n -.rt Actual number of seconds for which the returned credentials will remain valid. Specify \fBNULL\fR if not required. .RE .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 22n -.rt Mechanism specific status code. .RE @@ -173,78 +157,64 @@ Mechanism specific status code. \fBgss_acquire_cred()\fR may return the following status code: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 29n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_MECH\fR\fR .ad .RS 29n -.rt An unavailable mechanism has been requested. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAMETYPE\fR\fR .ad .RS 29n -.rt The type contained within the \fIdesired_name\fR parameter is not supported. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 29n -.rt The value supplied for \fIdesired_name\fR parameter is ill formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CREDENTIALS_EXPIRED\fR\fR .ad .RS 29n -.rt The credentials could not be acquired because they have expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CRED\fR\fR .ad .RS 29n -.rt No credentials were found for the specified name. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 29n -.rt 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. @@ -258,13 +228,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_add_cred.3gss b/usr/src/man/man3gss/gss_add_cred.3gss index 33b59d1024..6c39ac034e 100644 --- a/usr/src/man/man3gss/gss_add_cred.3gss +++ b/usr/src/man/man3gss/gss_add_cred.3gss @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_add_cred 3GSS "30 Jun 2005" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_ADD_CRED 3GSS "Jun 30, 2005" .SH NAME gss_add_cred \- add a credential-element to a credential .SH SYNOPSIS @@ -31,23 +31,19 @@ gss_add_cred \- add a credential-element to a credential The parameter descriptions for \fBgss_add_cred()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 22n -.rt Mechanism specific status code. .RE .sp .ne 2 -.mk .na \fB\fIinput_cred_handle\fR\fR .ad .RS 22n -.rt Credential to which the credential-element is added. If \fBGSS_C_NO_CREDENTIAL\fR is specified, the function composes the new credential based on default behavior. While the credential-handle is not @@ -57,35 +53,29 @@ modified by \fBgss_add_cred()\fR, the underlying credential is modified if .sp .ne 2 -.mk .na \fB\fIdesired_name\fR\fR .ad .RS 22n -.rt Name of the principal for which a credential should be acquired. .RE .sp .ne 2 -.mk .na \fB\fIdesired_mech\fR\fR .ad .RS 22n -.rt Underlying security mechanism with which the credential can be used. GSS_C_NULL_OID can be used to obtain a default. .RE .sp .ne 2 -.mk .na \fB\fIcred_usage\fR\fR .ad .RS 22n -.rt Flag that indicates how a credential is used to initiate or accept security credentials. If the flag is \fBGSS_C_ACCEPT\fR, the credentials are used only to accept security credentials. If the flag is \fBGSS_C_INITIATE\fR, the @@ -96,12 +86,10 @@ contexts. .sp .ne 2 -.mk .na \fB\fIinitiator_time_req\fR\fR .ad .RS 22n -.rt Number of seconds that the credential may remain valid for initiating security contexts. This argument is ignored if the composed credentials are of the \fBGSS_C_ACCEPT\fR type. Specify \fBGSS_C_INDEFINITE\fR to request that the @@ -110,12 +98,10 @@ credentials have the maximum permitted initiator lifetime. .sp .ne 2 -.mk .na \fB\fIacceptor_time_req\fR\fR .ad .RS 22n -.rt Number of seconds that the credential may remain valid for accepting security contexts. This argument is ignored if the composed credentials are of the \fBGSS_C_INITIATE\fR type. Specify \fBGSS_C_INDEFINITE\fR to request that the @@ -124,12 +110,10 @@ credentials have the maximum permitted initiator lifetime. .sp .ne 2 -.mk .na \fB\fIoutput_cred_handle\fR\fR .ad .RS 22n -.rt Returned credential handle that contains the new credential-element and all the credential-elements from \fIinput_cred_handle\fR. If a valid pointer to a \fBgss_cred_id_t\fR is supplied for this parameter, \fBgss_add_cred()\fR @@ -146,12 +130,10 @@ parameter must be released by the application after use by a call to .sp .ne 2 -.mk .na \fB\fIactual_mechs\fR\fR .ad .RS 22n -.rt Complete set of mechanisms for which the new credential is valid. Storage for the returned \fBOID\fR-set must be freed by the application after use by a call to \fBgss_release_oid_set\fR(3GSS). Specify \fBNULL\fR if this parameter is not @@ -160,12 +142,10 @@ required. .sp .ne 2 -.mk .na \fB\fIinitiator_time_rec\fR\fR .ad .RS 22n -.rt Actual number of seconds for which the returned credentials remain valid for initiating contexts using the specified mechanism. If a mechanism does not support expiration of credentials, the value \fBGSS_C_INDEFINITE\fR is @@ -174,12 +154,10 @@ returned. Specify \fBNULL\fR if this parameter is not required. .sp .ne 2 -.mk .na \fB\fIacceptor_time_rec\fR\fR .ad .RS 22n -.rt Actual number of seconds for which the returned credentials remain valid for accepting security contexts using the specified mechanism. If a mechanism does not support expiration of credentials, the value \fBGSS_C_INDEFINITE\fR is @@ -271,90 +249,74 @@ If the value of the \fIinput_cred_handle\fR parameter is The \fBgss_add_cred()\fR function can return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 29n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_MECH\fR\fR .ad .RS 29n -.rt An unavailable mechanism has been requested. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAMETYPE\fR\fR .ad .RS 29n -.rt The type contained within the \fIdesired_name\fR parameter is not supported. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 29n -.rt The value supplied for \fIdesired_name\fR parameter is ill formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DUPLICATE_ELEMENT\fR\fR .ad .RS 29n -.rt The credential already contains an element for the requested mechanism that has overlapping usage and validity period. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CREDENTIALS_EXPIRED\fR\fR .ad .RS 29n -.rt The credentials could not be added because they have expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CRED\fR\fR .ad .RS 29n -.rt No credentials were found for the specified name. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 29n -.rt 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. @@ -368,13 +330,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_add_oid_set_member.3gss b/usr/src/man/man3gss/gss_add_oid_set_member.3gss index 224018a658..2921332d07 100644 --- a/usr/src/man/man3gss/gss_add_oid_set_member.3gss +++ b/usr/src/man/man3gss/gss_add_oid_set_member.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_add_oid_set_member 3GSS "16 Aug 2007" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_ADD_OID_SET_MEMBER 3GSS "Aug 16, 2007" .SH NAME gss_add_oid_set_member \- add an object identifier to an object identifier set .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_add_oid_set_member\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -22,34 +22,28 @@ gss_add_oid_set_member \- add an object identifier to an object identifier set The parameter descriptions for \fBgss_add_oid_set_member()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism specific status code. .RE .sp .ne 2 -.mk .na \fB\fImember_oid\fR\fR .ad .RS 16n -.rt Object identifier to be copied into the set. .RE .sp .ne 2 -.mk .na \fB\fIoid_set\fR\fR .ad .RS 16n -.rt Set in which the object identifier should be inserted. .RE @@ -76,7 +70,6 @@ The \fBgss_add_oid_set_member()\fR function can return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad @@ -87,7 +80,6 @@ Successful completion. .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad @@ -106,13 +98,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_canonicalize_name.3gss b/usr/src/man/man3gss/gss_canonicalize_name.3gss index 224afe5877..f00611d51a 100644 --- a/usr/src/man/man3gss/gss_canonicalize_name.3gss +++ b/usr/src/man/man3gss/gss_canonicalize_name.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_canonicalize_name 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_CANONICALIZE_NAME 3GSS "Jan 14, 2003" .SH NAME gss_canonicalize_name \- convert an internal name to a mechanism name .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_canonicalize_name\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -33,34 +33,28 @@ specifying \fImech_type\fR as the authentication mechanism. The parameter descriptions for \fBgss_canonicalize_name()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt Mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIinput_name\fR\fR .ad .RS 16n -.rt The name for which a canonical form is desired. .RE .sp .ne 2 -.mk .na \fB\fImech_type\fR\fR .ad .RS 16n -.rt The authentication mechanism for which the canonical form of the name is desired. The desired mechanism must be specified explicitly; no default is provided. @@ -68,12 +62,10 @@ provided. .sp .ne 2 -.mk .na \fB\fIoutput_name\fR\fR .ad .RS 16n -.rt The resultant canonical name. Storage associated with this name must be freed by the application after use with a call to \fBgss_release_name\fR(3GSS). .RE @@ -84,57 +76,47 @@ by the application after use with a call to \fBgss_release_name\fR(3GSS). The \fBgss_canonicalize_name()\fR function may return the status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 22n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_MECH\fR\fR .ad .RS 22n -.rt The identified mechanism is not supported. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAMETYPE\fR\fR .ad .RS 22n -.rt The provided internal name contains no elements that could be processed by the specified mechanism. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 22n -.rt The provided internal name was ill-formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 22n -.rt 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. @@ -148,13 +130,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_compare_name.3gss b/usr/src/man/man3gss/gss_compare_name.3gss index 2c81fafb61..15d96e077d 100644 --- a/usr/src/man/man3gss/gss_compare_name.3gss +++ b/usr/src/man/man3gss/gss_compare_name.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_compare_name 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_COMPARE_NAME 3GSS "Jan 14, 2003" .SH NAME gss_compare_name \- compare two internal-form names .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_compare_name\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -33,45 +33,37 @@ identity. The parameter descriptions for \fBgss_compare_name()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt Mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIname1\fR\fR .ad .RS 16n -.rt Internal-form name. .RE .sp .ne 2 -.mk .na \fB\fIname2\fR\fR .ad .RS 16n -.rt Internal-form name. .RE .sp .ne 2 -.mk .na \fB\fIname_equal\fR\fR .ad .RS 16n -.rt If non-zero, the names refer to same entity. If 0, the names refer to different entities. Strictly, the names are not known to refer to the same identity. .RE @@ -82,45 +74,37 @@ entities. Strictly, the names are not known to refer to the same identity. The \fBgss_compare_name()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 22n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAMETYPE\fR\fR .ad .RS 22n -.rt The two names were of incomparable types. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 22n -.rt One or both of \fIname1\fR or \fIname2\fR was ill-formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 22n -.rt 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. @@ -134,13 +118,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_context_time.3gss b/usr/src/man/man3gss/gss_context_time.3gss index 9e6a2cc93a..b8554377f4 100644 --- a/usr/src/man/man3gss/gss_context_time.3gss +++ b/usr/src/man/man3gss/gss_context_time.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_context_time 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_CONTEXT_TIME 3GSS "Jan 15, 2003" .SH NAME gss_context_time \- determine how long a context will remain valid .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_context_time\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -27,34 +27,28 @@ which the specified context will remain valid. The parameter descriptions for \fBgss_context_time()\fR are as follows: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 18n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 18n -.rt A read-only value. Identifies the context to be interrogated. .RE .sp .ne 2 -.mk .na \fB\fItime_rec\fR\fR .ad .RS 18n -.rt Modifies the number of seconds that the context remains valid. If the context has already expired, returns zero. .RE @@ -66,45 +60,37 @@ The \fBgss_context_time()\fR function returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTEXT_EXPIRED\fR\fR .ad .RS 25n -.rt The context has already expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The \fIcontext_handle\fR parameter did not identify a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -118,13 +104,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT LevelSafe +MT Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_create_empty_oid_set.3gss b/usr/src/man/man3gss/gss_create_empty_oid_set.3gss index 41be2427c0..6c0af5043c 100644 --- a/usr/src/man/man3gss/gss_create_empty_oid_set.3gss +++ b/usr/src/man/man3gss/gss_create_empty_oid_set.3gss @@ -3,14 +3,14 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_create_empty_oid_set 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_CREATE_EMPTY_OID_SET 3GSS "Jan 14, 2003" .SH NAME gss_create_empty_oid_set \- create an object-identifier set containing no object identifiers .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_create_empty_oid_set\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -31,23 +31,19 @@ used to construct sets of mechanism object identifiers for input to The parameter descriptions for \fBgss_create_empty_oid_set()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt Mechanism-specific status code .RE .sp .ne 2 -.mk .na \fB\fIoid_set\fR\fR .ad .RS 16n -.rt Empty object identifier set. The function will allocate the \fBgss_OID_set_desc\fR object, which the application must free after use with a call to \fBgss_release_oid_set\fR(3GSS). @@ -60,23 +56,19 @@ The \fBgss_create_empty_oid_set()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -90,13 +82,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_delete_sec_context.3gss b/usr/src/man/man3gss/gss_delete_sec_context.3gss index 09162ebf8c..f336f75624 100644 --- a/usr/src/man/man3gss/gss_delete_sec_context.3gss +++ b/usr/src/man/man3gss/gss_delete_sec_context.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_delete_sec_context 3GSS "15 jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_DELETE_SEC_CONTEXT 3GSS "Jan 15, 2003" .SH NAME gss_delete_sec_context \- delete a GSS-API security context .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_delete_sec_context\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -45,23 +45,19 @@ that no token should be transferred by the application. The parameter descriptions for \fBgss_delete_sec_context()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 18n -.rt A mechanism specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 18n -.rt Context handle identifying specific context to delete. After deleting the context, the \fBGSS-API\fR will set \fIcontext_handle\fR to \fBGSS_C_NO_CONTEXT\fR. @@ -69,12 +65,10 @@ context, the \fBGSS-API\fR will set \fIcontext_handle\fR to .sp .ne 2 -.mk .na \fB\fIoutput_token\fR\fR .ad .RS 18n -.rt A token to be sent to remote applications that instructs them to delete the context. .RE @@ -85,34 +79,28 @@ context. \fBgss_delete_sec_context()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 20n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 20n -.rt No valid context was supplied. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 20n -.rt 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. @@ -126,13 +114,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_display_name.3gss b/usr/src/man/man3gss/gss_display_name.3gss index b718c6cc70..1702ca8e6a 100644 --- a/usr/src/man/man3gss/gss_display_name.3gss +++ b/usr/src/man/man3gss/gss_display_name.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_display_name 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_DISPLAY_NAME 3GSS "Jan 14, 2003" .SH NAME gss_display_name \- convert internal-form name to text .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_display_name\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -39,34 +39,28 @@ specifying \fBGSS_C_NO_OID\fR as the name-type, the GSS-API returns The parameter descriptions for \fBgss_display_name()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 22n -.rt Mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIinput_name\fR\fR .ad .RS 22n -.rt Name in internal form. .RE .sp .ne 2 -.mk .na \fB\fIoutput_name_buffer\fR\fR .ad .RS 22n -.rt Buffer to receive textual name string. The application must free storage associated with this name after use with a call to \fBgss_release_buffer\fR(3GSS). @@ -74,12 +68,10 @@ associated with this name after use with a call to .sp .ne 2 -.mk .na \fB\fIoutput_name_type\fR\fR .ad .RS 22n -.rt The type of the returned name. The returned \fBgss_OID\fR will be a pointer into static storage and should be treated as read-only by the caller. In particular, the application should not attempt to free it. Specify \fINULL\fR @@ -92,34 +84,28 @@ if this parameter is not required. The \fBgss_display_name()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 18n -.rt The \fIinput_name\fR was ill-formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -133,13 +119,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_display_status.3gss b/usr/src/man/man3gss/gss_display_status.3gss index d9a3f2d5f6..d4cd0193ef 100644 --- a/usr/src/man/man3gss/gss_display_status.3gss +++ b/usr/src/man/man3gss/gss_display_status.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_display_status 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_DISPLAY_STATUS 3GSS "Jan 14, 2003" .SH NAME gss_display_status \- convert a GSS-API status code to text .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_display_status\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -47,34 +47,28 @@ subsequent messages are desired. The parameter descriptions for \fBgss_display_status()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 19n -.rt Status code returned by the underlying mechanism. .RE .sp .ne 2 -.mk .na \fB\fIstatus_value\fR\fR .ad .RS 19n -.rt Status value to be converted. .RE .sp .ne 2 -.mk .na \fB\fIstatus_type\fR\fR .ad .RS 19n -.rt If the value is \fBGSS_C_GSS_CODE\fR, \fIstatus_value\fR is a \fBGSS-API\fR status code. If the value is \fBGSS_C_MECH_CODE\fR, then \fIstatus_value\fR is a mechanism status code. @@ -82,24 +76,20 @@ a mechanism status code. .sp .ne 2 -.mk .na \fB\fImech_type\fR\fR .ad .RS 19n -.rt Underlying mechanism that is used to interpret a minor status value. Supply \fBGSS_C_NO_OID\fR to obtain the system default. .RE .sp .ne 2 -.mk .na \fB\fImessage_context\fR\fR .ad .RS 19n -.rt Should be initialized to zero prior to the first call. On return from \fBgss_display_status()\fR, a non-zero \fIstatus_value\fR parameter indicates that additional messages may be extracted from the status code by means of @@ -110,12 +100,10 @@ subsequent calls to \fBgss_display_status()\fR, passing the same .sp .ne 2 -.mk .na \fB\fIstatus_string\fR\fR .ad .RS 19n -.rt Textual representation of the \fIstatus_value\fR. Storage associated with this parameter must be freed by the application after use with a call to \fBgss_release_buffer\fR(3GSS). @@ -127,47 +115,39 @@ parameter must be freed by the application after use with a call to The \fBgss_display_status()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 20n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_MECH\fR\fR .ad .RS 20n -.rt Indicates that translation in accordance with an unsupported mechanism type was requested. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_STATUS\fR\fR .ad .RS 20n -.rt The status value was not recognized, or the status type was neither \fBGSS_C_GSS_CODE\fR nor \fBGSS_C_MECH_CODE\fR. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 20n -.rt 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. @@ -181,13 +161,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_duplicate_name.3gss b/usr/src/man/man3gss/gss_duplicate_name.3gss index 62b9532618..0091ba8d04 100644 --- a/usr/src/man/man3gss/gss_duplicate_name.3gss +++ b/usr/src/man/man3gss/gss_duplicate_name.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_duplicate_name 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_DUPLICATE_NAME 3GSS "Jan 14, 2003" .SH NAME gss_duplicate_name \- create a copy of an internal name .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_duplicate_name\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -30,34 +30,28 @@ other. The parameter descriptions for \fBgss_duplicate_name()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIsrc_name\fR\fR .ad .RS 16n -.rt Internal name to be duplicated. .RE .sp .ne 2 -.mk .na \fB\fIdest_name\fR\fR .ad .RS 16n -.rt The resultant copy of \fIsrc_name\fR. Storage associated with this name must be freed by the application after use with a call to \fBgss_release_name\fR(3GSS). @@ -69,34 +63,28 @@ be freed by the application after use with a call to The \fBgss_duplicate_name()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 18n -.rt The \fIsrc_name\fR parameter was ill-formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -110,13 +98,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_export_name.3gss b/usr/src/man/man3gss/gss_export_name.3gss index 180dbcd792..1ac8762758 100644 --- a/usr/src/man/man3gss/gss_export_name.3gss +++ b/usr/src/man/man3gss/gss_export_name.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_export_name 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_EXPORT_NAME 3GSS "Jan 14, 2003" .SH NAME gss_export_name \- convert a mechanism name to export form .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_export_name\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -32,34 +32,28 @@ must specify a valid mechanism name, that is, an internal name generated by The parameter descriptions for \fBgss_export_name()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 17n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIinput_name\fR\fR .ad .RS 17n -.rt The mechanism name to be exported. .RE .sp .ne 2 -.mk .na \fB\fIexported_name\fR\fR .ad .RS 17n -.rt The canonical contiguous string form of \fIinput_name\fR. Storage associated with this string must freed by the application after use with \fBgss_release_buffer\fR(3GSS). @@ -71,34 +65,28 @@ with this string must freed by the application after use with The \fBgss_export_name()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 21n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NAME_NOT_MN\fR\fR .ad .RS 21n -.rt The provided internal name was not a mechanism name. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 21n -.rt 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. @@ -112,13 +100,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_export_sec_context.3gss b/usr/src/man/man3gss/gss_export_sec_context.3gss index 650cd22fae..286efc5da8 100644 --- a/usr/src/man/man3gss/gss_export_sec_context.3gss +++ b/usr/src/man/man3gss/gss_export_sec_context.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_export_sec_context 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_EXPORT_SEC_CONTEXT 3GSS "Jan 15, 2003" .SH NAME gss_export_sec_context \- transfer a security context to another process .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_export_sec_context\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -62,34 +62,28 @@ transferred to another process. The parameter descriptions for \fBgss_export_sec_context()\fR are as follows: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 22n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 22n -.rt Context handle identifying the context to transfer. .RE .sp .ne 2 -.mk .na \fB\fIinterprocess_token\fR\fR .ad .RS 22n -.rt Token to be transferred to target process. Storage associated with this token must be freed by the application after use with a call to \fBgss_release_buffer\fR(3GSS). @@ -101,56 +95,46 @@ must be freed by the application after use with a call to \fBgss_export_sec_context()\fR returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTEXT_EXPIRED\fR\fR .ad .RS 25n -.rt The context has expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The context was invalid. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_UNAVAILABLE\fR\fR .ad .RS 25n -.rt The operation is not supported. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -164,13 +148,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT LevelSafe +MT Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_get_mic.3gss b/usr/src/man/man3gss/gss_get_mic.3gss index c2dad0fe8c..35b339478d 100644 --- a/usr/src/man/man3gss/gss_get_mic.3gss +++ b/usr/src/man/man3gss/gss_get_mic.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_get_mic 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_GET_MIC 3GSS "Jan 14, 2003" .SH NAME gss_get_mic \- calculate a cryptographic message .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_get_mic\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -35,34 +35,28 @@ Since some application-level protocols may wish to use tokens emitted by The parameter descriptions for \fBgss_get_mic()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 18n -.rt The status code returned by the underlying mechanism. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 18n -.rt Identifies the context on which the message will be sent. .RE .sp .ne 2 -.mk .na \fB\fIqop_req\fR\fR .ad .RS 18n -.rt Specifies the requested quality of protection. Callers are encouraged, on portability grounds, to accept the default quality of protection offered by the chosen mechanism, which may be requested by specifying \fBGSS_C_QOP_DEFAULT\fR @@ -72,23 +66,19 @@ for this parameter. If an unsupported protection strength is requested, .sp .ne 2 -.mk .na \fB\fImessage_buffer\fR\fR .ad .RS 18n -.rt The message to be protected. .RE .sp .ne 2 -.mk .na \fB\fImsg_token\fR\fR .ad .RS 18n -.rt The buffer to receive the token. Storage associated with this message must be freed by the application after use with a call to \fBgss_release_buffer\fR(3GSS). @@ -100,56 +90,46 @@ freed by the application after use with a call to \fBgss_get_mic()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTEXT_EXPIRED\fR\fR .ad .RS 25n -.rt The context has already expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The \fIcontext_handle\fR parameter did not identify a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_QOP\fR\fR .ad .RS 25n -.rt The specified \fBQOP\fR is not supported by the mechanism. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -163,13 +143,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_import_name.3gss b/usr/src/man/man3gss/gss_import_name.3gss index ee3eb81ca5..f3d2b860e0 100644 --- a/usr/src/man/man3gss/gss_import_name.3gss +++ b/usr/src/man/man3gss/gss_import_name.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_import_name 3GSS "30 Jun 2005" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_IMPORT_NAME 3GSS "Jun 30, 2005" .SH NAME gss_import_name \- convert a contiguous string name to GSS_API internal format .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_import_name\fR(\fBOM_uint32 *\fR \fIminor_status\fR, @@ -33,46 +33,38 @@ mechanism name for the mechanism that exported the name. The parameter descriptions for \fBgss_import_name()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 21n -.rt Status code returned by the underlying mechanism. .RE .sp .ne 2 -.mk .na \fB\fIinput_name_buffer\fR\fR .ad .RS 21n -.rt The \fBgss_buffer_desc\fR structure containing the name to be imported. .RE .sp .ne 2 -.mk .na \fB\fIinput_name_type\fR\fR .ad .RS 21n -.rt A \fBgss_OID\fR that specifies the format that the \fIinput_name_buffer\fR is in. .RE .sp .ne 2 -.mk .na \fB\fIoutput_name\fR\fR .ad .RS 21n -.rt The \fBgss_name_t\fR structure to receive the returned name in internal form. Storage associated with this name must be freed by the application after use with a call to \fBgss_release_name()\fR. @@ -84,58 +76,48 @@ with a call to \fBgss_release_name()\fR. The \fBgss_import_name()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 22n -.rt The \fBgss_import_name()\fR function completed successfully. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAMETYPE\fR\fR .ad .RS 22n -.rt The \fIinput_name_type\fR was unrecognized. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 22n -.rt The \fIinput_name\fR parameter could not be interpreted as a name of the specified type. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_MECH\fR\fR .ad .RS 22n -.rt The \fIinput_name_type\fR was \fBGSS_C_NT_EXPORT_NAME\fR, but the mechanism contained within the \fIinput_name\fR is not supported. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 22n -.rt 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. @@ -149,13 +131,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_import_sec_context.3gss b/usr/src/man/man3gss/gss_import_sec_context.3gss index 0a1c4b31cb..f64feb59d0 100644 --- a/usr/src/man/man3gss/gss_import_sec_context.3gss +++ b/usr/src/man/man3gss/gss_import_sec_context.3gss @@ -3,14 +3,14 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_import_sec_context 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_IMPORT_SEC_CONTEXT 3GSS "Jan 15, 2003" .SH NAME gss_import_sec_context \- import security context established by another process .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_import_sec_context\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -29,34 +29,28 @@ be imported only once. See \fBgss_export_sec_context\fR(3GSS). The parameter descriptions for \fBgss_import_sec_context()\fR are as follows: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 22n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIinterprocess_token\fR\fR .ad .RS 22n -.rt Token received from exporting process. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 22n -.rt Context handle of newly reactivated context. Resources associated with this context handle must be released by the application after use with a call to \fBgss_delete_sec_context\fR(3GSS). @@ -68,67 +62,55 @@ context handle must be released by the application after use with a call to \fBgss_import_sec_context()\fR returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The token did not contain a valid context reference. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_TOKEN\fR\fR .ad .RS 25n -.rt The token was invalid. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_UNAVAILABLE\fR\fR .ad .RS 25n -.rt The operation is unavailable. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_UNAUTHORIZED\fR\fR .ad .RS 25n -.rt Local policy prevents the import of this context by the current process. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -142,13 +124,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT LevelSafe +MT Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_indicate_mechs.3gss b/usr/src/man/man3gss/gss_indicate_mechs.3gss index 7224326c7f..53d6e4e314 100644 --- a/usr/src/man/man3gss/gss_indicate_mechs.3gss +++ b/usr/src/man/man3gss/gss_indicate_mechs.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_indicate_mechs 3GSS "14 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_INDICATE_MECHS 3GSS "Jan 14, 2003" .SH NAME gss_indicate_mechs \- determine available security mechanisms .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_indicate_mechs\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -27,23 +27,19 @@ available underlying security mechanisms. The parameter descriptions for \fBgss_indicate_mechs()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fImech_set\fR\fR .ad .RS 16n -.rt Set of supported mechanisms. The returned \fBgss_OID_set\fR value will be a dynamically-allocated \fBOID\fR set that should be released by the caller after use with a call to \fBgss_release_oid_set\fR(3GSS). @@ -55,23 +51,19 @@ use with a call to \fBgss_release_oid_set\fR(3GSS). The \fBgss_indicate_mechs()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -85,13 +77,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_init_sec_context.3gss b/usr/src/man/man3gss/gss_init_sec_context.3gss index bfb885e01a..992eeec3b3 100644 --- a/usr/src/man/man3gss/gss_init_sec_context.3gss +++ b/usr/src/man/man3gss/gss_init_sec_context.3gss @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_init_sec_context 3GSS "22 May 2006" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_INIT_SEC_CONTEXT 3GSS "May 22, 2006" .SH NAME gss_init_sec_context \- initiate a GSS-API security context with a peer application @@ -29,23 +29,19 @@ cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lgss\fR [ \fIlibrary\fR\&.\|. The parameter descriptions for \fBgss_init_sec_context()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 25n -.rt A mechanism specific status code. .RE .sp .ne 2 -.mk .na \fB\fIinitiator_cred_handle\fR\fR .ad .RS 25n -.rt The handle for the credentials claimed. Supply \fBGSS_C_NO_CREDENTIAL\fR to act as a default initiator principal. If no default initiator is defined, the function returns \fBGSS_S_NO_CRED\fR. @@ -53,12 +49,10 @@ function returns \fBGSS_S_NO_CRED\fR. .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 25n -.rt The context handle for a new context. Supply the value \fBGSS_C_NO_CONTEXT\fR for the first call, and use the value returned in any continuation calls. The resources associated with \fIcontext_handle\fR must be released by the @@ -67,71 +61,59 @@ application after use by a call to \fBgss_delete_sec_context\fR(3GSS). .sp .ne 2 -.mk .na \fB\fItarget_name\fR\fR .ad .RS 25n -.rt The name of the context acceptor. .RE .sp .ne 2 -.mk .na \fB\fImech_type\fR\fR .ad .RS 25n -.rt The object \fBID\fR of the desired mechanism. To obtain a specific default, supply the value \fBGSS_C_NO_ID\fR. .RE .sp .ne 2 -.mk .na \fB\fIreq_flags\fR\fR .ad .RS 25n -.rt Contains independent flags, each of which will request that the context support a specific service option. A symbolic name is provided for each flag. Logically-\fBOR\fR the symbolic name to the corresponding required flag to form the bit-mask value. \fIreq_flags\fR may contain one of the following values: .sp .ne 2 -.mk .na \fB\fBGSS_C_DELEG_FLAG\fR\fR .ad .RS 23n -.rt If true, delegate credentials to a remote peer. Do not delegate the credentials if the value is false. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_MUTUAL_FLAG\fR\fR .ad .RS 23n -.rt If true, request that the peer authenticate itself. If false, authenticate to the remote peer only. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_REPLAY_FLAG\fR\fR .ad .RS 23n -.rt If true, enable replay detection for messages protected with \fBgss_wrap\fR(3GSS) or \fBgss_get_mic\fR(3GSS). Do not attempt to detect replayed messages if false. @@ -139,24 +121,20 @@ replayed messages if false. .sp .ne 2 -.mk .na \fB\fBGSS_C_SEQUENCE_FLAG\fR\fR .ad .RS 23n -.rt If true, enable detection of out-of-sequence protected messages. Do not attempt to detect out-of-sequence messages if false. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_CONF_FLAG\fR\fR .ad .RS 23n -.rt If true, request that confidential service be made available by means of \fBgss_wrap\fR(3GSS). If false, no per-message confidential service is required. @@ -164,12 +142,10 @@ required. .sp .ne 2 -.mk .na \fB\fBGSS_C_INTEG_FLAG\fR\fR .ad .RS 23n -.rt If true, request that integrity service be made available by means of \fBgss_wrap\fR(3GSS) or \fBgss_get_mic\fR(3GSS). If false, no per-message integrity service is required. @@ -177,12 +153,10 @@ integrity service is required. .sp .ne 2 -.mk .na \fB\fBGSS_C_ANON_FLAG\fR\fR .ad .RS 23n -.rt If true, do not reveal the initiator's identify to the acceptor. If false, authenticate normally. .RE @@ -191,24 +165,20 @@ authenticate normally. .sp .ne 2 -.mk .na \fB\fItime_req\fR\fR .ad .RS 25n -.rt The number of seconds for which the context will remain valid. Supply a zero value to \fItime_req\fR to request a default validity period. .RE .sp .ne 2 -.mk .na \fB\fIinput_chan_bindings\fR\fR .ad .RS 25n -.rt Optional application-specified bindings. Allows application to securely bind channel identification information to the security context. Set to \fBGSS_C_NO_CHANNEL_BINDINGS\fR if you do not want to use channel bindings. @@ -216,12 +186,10 @@ channel identification information to the security context. Set to .sp .ne 2 -.mk .na \fB\fIinput_token\fR\fR .ad .RS 25n -.rt Token received from the peer application. On the initial call, supply \fBGSS_C_NO_BUFFER\fR or a pointer to a buffer containing the value \fBGSS_C_EMPTY_BUFFER\fR. @@ -229,12 +197,10 @@ Token received from the peer application. On the initial call, supply .sp .ne 2 -.mk .na \fB\fIactual_mech_type\fR\fR .ad .RS 25n -.rt The actual mechanism used. The \fBOID\fR returned by means of this parameter will be pointer to static storage that should be treated as read-only. The application should not attempt to free it. To obtain a specific default, supply @@ -244,12 +210,10 @@ required. .sp .ne 2 -.mk .na \fB\fIoutput_token\fR\fR .ad .RS 25n -.rt The token to send to the peer application. If the length field of the returned buffer is zero, no token need be sent to the peer application. After use storage associated with this buffer must be freed by the application by a call @@ -258,12 +222,10 @@ to \fBgss_release_buffer\fR(3GSS). .sp .ne 2 -.mk .na \fB\fIret_flags\fR\fR .ad .RS 25n -.rt Contains various independent flags, each of which indicates that the context supports a specific service option. If not needed, specify \fBNULL\fR. Test the returned bit-mask \fIret_flags\fR value against its symbolic name to determine @@ -271,60 +233,50 @@ if the given option is supported by the context. \fIret_flags\fR may contain one of the following values: .sp .ne 2 -.mk .na \fB\fBGSS_C_DELEG_FLAG\fR\fR .ad .RS 25n -.rt If true, credentials were delegated to the remote peer. If false, no credentials were delegated. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_MUTUAL_FLAG\fR\fR .ad .RS 25n -.rt If true, the remote peer authenticated itself. If false, the remote peer did not authenticate itself. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_REPLAY_FLAG\fR\fR .ad .RS 25n -.rt If true, replay of protected messages will be detected. If false, replayed messages will not be detected. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_SEQUENCE_FLAG\fR\fR .ad .RS 25n -.rt If true, out of sequence protected messages will be detected. If false, they will not be detected. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_CONF_FLAG\fR\fR .ad .RS 25n -.rt If true, confidential service may be invoked by calling the \fBgss_wrap()\fR routine. If false, no confidentiality service is available by means of \fBgss_wrap\fR(3GSS). \fBgss_wrap()\fR will provide message encapsulation, @@ -333,12 +285,10 @@ data-origin authentication and integrity services only. .sp .ne 2 -.mk .na \fB\fBGSS_C_INTEG_FLAG\fR\fR .ad .RS 25n -.rt If true, integrity service may be invoked by calling either the \fBgss_wrap\fR(3GSS) or \fBgss_get_mic\fR(3GSS) routine. If false, per-message integrity service is not available. @@ -346,12 +296,10 @@ integrity service is not available. .sp .ne 2 -.mk .na \fB\fBGSS_C_ANON_FLAG\fR\fR .ad .RS 25n -.rt If true, the initiator's identity has not been revealed; it will not be revealed if any emitted token is passed to the acceptor. If false, the initiator has been or will be authenticated normally. @@ -359,12 +307,10 @@ initiator has been or will be authenticated normally. .sp .ne 2 -.mk .na \fB\fBGSS_C_PROT_READY_FLAG\fR\fR .ad .RS 25n -.rt If true, the protection services specified by the states of \fBGSS_C_CONF_FLAG\fR and \fBGSS_C_INTEG_FLAG\fR are available if the accompanying major status return value is either \fBGSS_S_COMPLETE\fR or @@ -374,12 +320,10 @@ only if the accompanying major status return value is \fBGSS_S_COMPLETE\fR. .sp .ne 2 -.mk .na \fB\fBGSS_C_TRANS_FLAG\fR\fR .ad .RS 25n -.rt If true, the resultant security context may be transferred to other processes by means of a call to \fBgss_export_sec_context\fR(3GSS). If false, the security context cannot be transferred. @@ -389,12 +333,10 @@ security context cannot be transferred. .sp .ne 2 -.mk .na \fB\fItime_rec\fR\fR .ad .RS 25n -.rt The number of seconds for which the context will remain valid. Specify \fBNULL\fR if the parameter is not required. .RE @@ -504,174 +446,144 @@ Version 1 implementations must special-case these codes. \fBgss_init_sec_context()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 30n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTINUE_NEEDED\fR\fR .ad .RS 30n -.rt A token from the peer application is required to complete the context, and \fBgss_init_sec_context()\fR must be called again with that token. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_TOKEN\fR\fR .ad .RS 30n -.rt Consistency checks performed on the \fIinput_token\fR failed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_CREDENTIAL\fR\fR .ad .RS 30n -.rt Consistency checks performed on the credential failed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CRED\fR\fR .ad .RS 30n -.rt The supplied credentials are not valid for context acceptance, or the credential handle does not reference any credentials. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CREDENTIALS_EXPIRED\fR\fR .ad .RS 30n -.rt The referenced credentials have expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_BINDINGS\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR contains different channel bindings than those specified by means of the \fIinput_chan_bindings\fR parameter. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_SIG\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR contains an invalid \fBMIC\fR or a \fBMIC\fR that cannot be verified. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_OLD_TOKEN\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR is too old. This is a fatal error while establishing context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DUPLICATE_TOKEN\fR\fR .ad .RS 30n -.rt The \fIinput_token\fR is valid, but it is a duplicate of a token already processed. This is a fatal error while establishing context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 30n -.rt The supplied context handle does not refer to a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAMETYPE\fR\fR .ad .RS 30n -.rt The provided \fItarget_name\fR parameter contains an invalid or unsupported \fIname\fR type. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 30n -.rt The supplied \fItarget_name\fR parameter is ill-formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_MECH\fR\fR .ad .RS 30n -.rt The token received specifies a mechanism that is not supported by the implementation or the provided credential. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 30n -.rt 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. @@ -740,13 +652,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_inquire_context.3gss b/usr/src/man/man3gss/gss_inquire_context.3gss index dd39bf1d7a..33e6cefae6 100644 --- a/usr/src/man/man3gss/gss_inquire_context.3gss +++ b/usr/src/man/man3gss/gss_inquire_context.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_inquire_context 3GSS "17 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_INQUIRE_CONTEXT 3GSS "Jan 17, 2003" .SH NAME gss_inquire_context \- obtain information about a security context .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_inquire_context\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -31,34 +31,28 @@ context, although the context need not be fully established. The parameter descriptions for \fBgss_inquire_context()\fR are as follows: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 21n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 21n -.rt A handle that refers to the security context. .RE .sp .ne 2 -.mk .na \fB\fIsrc_name\fR\fR .ad .RS 21n -.rt The name of the context initiator. If the context was established using anonymous authentication, and if the application invoking \fBgss_inquire_context()\fR is the context acceptor, an anonymous name is @@ -69,12 +63,10 @@ parameter is not required. .sp .ne 2 -.mk .na \fB\fItarg_name\fR\fR .ad .RS 21n -.rt The name of the context acceptor. Storage associated with this name must be freed by the application after use with a call to \fBgss_release_name()\fR. If the context acceptor did not authenticate itself, and if the initiator did not @@ -85,12 +77,10 @@ required. .sp .ne 2 -.mk .na \fB\fIlifetime_rec\fR\fR .ad .RS 21n -.rt The number of seconds for which the context will remain valid. If the context has expired, this parameter will be set to zero. Specify \fBNULL\fR if the parameter is not required. @@ -98,12 +88,10 @@ parameter is not required. .sp .ne 2 -.mk .na \fB\fImech_type\fR\fR .ad .RS 21n -.rt The security mechanism providing the context. The returned \fBOID\fR is a pointer to static storage that should be treated as read-only by the application; in particular, the application should not attempt to free it. @@ -112,12 +100,10 @@ Specify \fBNULL\fR if the parameter is not required. .sp .ne 2 -.mk .na \fB\fIctx_flags\fR\fR .ad .RS 21n -.rt Contains various independent flags, each of which indicates that the context supports (or is expected to support, if \fBctx_open\fR is false) a specific service option. If not needed, specify \fBNULL\fR. Symbolic names are provided @@ -126,60 +112,50 @@ should be logically \fBAND\fRed with the \fBret_flags\fR value to test whether a given option is supported by the context. The flags are: .sp .ne 2 -.mk .na \fB\fBGSS_C_DELEG_FLAG\fR\fR .ad .RS 25n -.rt If true, credentials were delegated from the initiator to the acceptor. If false, no credentials were delegated. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_MUTUAL_FLAG\fR\fR .ad .RS 25n -.rt If true, the acceptor was authenticated to the initiator. If false, the acceptor did not authenticate itself. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_REPLAY_FLAG\fR\fR .ad .RS 25n -.rt If true, the replay of protected messages will be detected. If false, replayed messages will not be detected. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_SEQUENCE_FLAG\fR\fR .ad .RS 25n -.rt If true, out-of-sequence protected messages will be detected. If false, out-of-sequence messages will not be detected. .RE .sp .ne 2 -.mk .na \fB\fBGSS_C_CONF_FLAG\fR\fR .ad .RS 25n -.rt If true, confidential service may be invoked by calling the \fBgss_wrap\fR(3GSS) routine. If false, no confidential service is available through \fBgss_wrap()\fR. \fBgss_wrap()\fR provides message encapsulation, @@ -188,12 +164,10 @@ data-origin authentication, and integrity services only. .sp .ne 2 -.mk .na \fB\fBGSS_C_INTEG_FLAG\fR\fR .ad .RS 25n -.rt If true, integrity service can be invoked by calling either the \fBgss_get_mic()\fR or the \fBgss_wrap()\fR routine. If false, per-message integrity service is unavailable. @@ -201,12 +175,10 @@ integrity service is unavailable. .sp .ne 2 -.mk .na \fB\fBGSS_C_ANON_FLAG\fR\fR .ad .RS 25n -.rt If true, the initiator's identity is not revealed to the acceptor. The \fIsrc_name\fR parameter, if requested, contains an anonymous internal name. If false, the initiator has been authenticated normally. @@ -214,12 +186,10 @@ false, the initiator has been authenticated normally. .sp .ne 2 -.mk .na \fB\fBGSS_C_PROT_READY_FLAG\fR\fR .ad .RS 25n -.rt If true, the protection services, as specified by the states of the \fBGSS_C_CONF_FLAG\fR and \fBGSS_C_INTEG_FLAG\fR, are available for use. If false, they are available only if the context is fully established, that is, if @@ -228,12 +198,10 @@ the \fIopen\fR parameter is non-zero. .sp .ne 2 -.mk .na \fB\fBGSS_C_TRANS_FLAG\fR\fR .ad .RS 25n -.rt If true, resultant security context can be transferred to other processes through a call to \fBgss_export_sec_context()\fR. If false, the security context is not transferable. @@ -243,24 +211,20 @@ context is not transferable. .sp .ne 2 -.mk .na \fB\fIlocally_initiated\fR\fR .ad .RS 21n -.rt Non-zero if the invoking application is the context initiator. Specify \fBNULL\fR if the parameter is not required. .RE .sp .ne 2 -.mk .na \fB\fIopen\fR\fR .ad .RS 21n -.rt Non-zero if the context is fully established; zero if a context-establishment token is expected from the peer application. Specify \fBNULL\fR if the parameter is not required. @@ -272,34 +236,28 @@ parameter is not required. \fBgss_inquire_context()\fR returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 20n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 20n -.rt The referenced context could not be accessed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 20n -.rt 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. @@ -313,13 +271,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_inquire_cred.3gss b/usr/src/man/man3gss/gss_inquire_cred.3gss index 6ee81cd410..78e5e9e9b0 100644 --- a/usr/src/man/man3gss/gss_inquire_cred.3gss +++ b/usr/src/man/man3gss/gss_inquire_cred.3gss @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_inquire_cred 3GSS "30 Jan 2004" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_INQUIRE_CRED 3GSS "Jan 30, 2004" .SH NAME gss_inquire_cred \- obtain information about a credential .SH SYNOPSIS @@ -24,35 +24,29 @@ gss_inquire_cred \- obtain information about a credential The parameter descriptions for \fBgss_inquire_cred()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt Mechanism specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcred_handle\fR\fR .ad .RS 16n -.rt Handle that refers to the target credential. Specify \fBGSS_C_NO_CREDENTIAL\fR to inquire about the default initiator principal. .RE .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 16n -.rt Name of the identity asserted by the credential. Any storage associated with this name should be freed by the application after use by a call to \fBgss_release_name\fR(3GSS). @@ -60,12 +54,10 @@ this name should be freed by the application after use by a call to .sp .ne 2 -.mk .na \fB\fIlifetime\fR\fR .ad .RS 16n -.rt Number of seconds for which the credential remains valid. If the credential has expired, this parameter will be set to zero. Specify \fBNULL\fR if the parameter is not required. @@ -73,12 +65,10 @@ parameter is not required. .sp .ne 2 -.mk .na \fB\fIcred_usage\fR\fR .ad .RS 16n -.rt Flag that indicates how a credential is used. The \fIcred_usage\fR parameter may contain one of the following values: \fBGSS_C_INITIATE\fR, \fBGSS_C_ACCEPT\fR, or \fBGSS_C_BOTH\fR. Specify \fBNULL\fR if this parameter @@ -87,12 +77,10 @@ is not required. .sp .ne 2 -.mk .na \fB\fImechanisms\fR\fR .ad .RS 16n -.rt Set of mechanisms supported by the credential. Storage for the returned \fBOID\fR-set must be freed by the application after use by a call to \fBgss_release_oid_set\fR(3GSS). Specify \fBNULL\fR if this parameter is not @@ -110,57 +98,47 @@ credential. The \fBgss_inquire_cred()\fR function can return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 30n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CRED\fR\fR .ad .RS 30n -.rt The referenced credentials could not be accessed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_CREDENTIAL\fR\fR .ad .RS 30n -.rt The referenced credentials were invalid. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CREDENTIALS_EXPIRED\fR\fR .ad .RS 30n -.rt The referenced credentials have expired. If the \fIlifetime\fR parameter was not passed as \fBNULL\fR, it will be set to \fB0\fR. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 30n -.rt 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. @@ -174,13 +152,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_inquire_cred_by_mech.3gss b/usr/src/man/man3gss/gss_inquire_cred_by_mech.3gss index c2e6bdcbef..52ff32fb89 100644 --- a/usr/src/man/man3gss/gss_inquire_cred_by_mech.3gss +++ b/usr/src/man/man3gss/gss_inquire_cred_by_mech.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_inquire_cred_by_mech 3GSS "15 Aug 2007" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_INQUIRE_CRED_BY_MECH 3GSS "Aug 15, 2007" .SH NAME gss_inquire_cred_by_mech \- obtain per-mechanism information about a credential .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_inquire_cred_by_mech\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -21,12 +21,10 @@ gss_inquire_cred_by_mech \- obtain per-mechanism information about a credential .SH PARAMETERS .sp .ne 2 -.mk .na \fB\fIacceptor_lifetime\fR\fR .ad .RS 22n -.rt The number of seconds that the credential is capable of accepting security contexts under the specified mechanism. If the credential can no longer be used to accept contexts, or if the credential usage for this mechanism is @@ -36,24 +34,20 @@ if this parameter is not required. .sp .ne 2 -.mk .na \fB\fIcred_handle\fR\fR .ad .RS 22n -.rt A handle that refers to the target credential. Specify \fBGSS_C_NO_CREDENTIAL\fR to inquire about the default initiator principal. .RE .sp .ne 2 -.mk .na \fB\fIcred_usage\fR\fR .ad .RS 22n -.rt How the credential may be used with the specified mechanism. The \fIcred_usage\fR parameter may contain one of the following values: \fBGSS_C_INITIATE\fR, \fBGSS_C_ACCEPT\fR, or \fBGSS_C_BOTH\fR. Specify @@ -62,12 +56,10 @@ How the credential may be used with the specified mechanism. The .sp .ne 2 -.mk .na \fB\fIinitiator_lifetime\fR\fR .ad .RS 22n -.rt The number of seconds that the credential is capable of initiating security contexts under the specified mechanism. If the credential can no longer be used to initiate contexts, or if the credential usage for this mechanism is @@ -77,34 +69,28 @@ if this parameter is not required. .sp .ne 2 -.mk .na \fB\fImech_type\fR\fR .ad .RS 22n -.rt The mechanism for which the information should be returned. .RE .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 22n -.rt A mechanism specific status code. .RE .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 22n -.rt The name whose identity the credential asserts. Any storage associated with this \fIname\fR must be freed by the application after use by a call to \fBgss_release_name\fR(3GSS). @@ -122,45 +108,37 @@ The \fBgss_inquire_cred_by_mech()\fR function can return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 30n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CREDENTIALS_EXPIRED\fR\fR .ad .RS 30n -.rt The credentials cannot be added because they have expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_CREDENTIAL\fR\fR .ad .RS 30n -.rt The referenced credentials are invalid. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 30n -.rt 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. @@ -168,23 +146,19 @@ of the \fIminor_status\fR parameter details the error condition. .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CRED\fR\fR .ad .RS 30n -.rt The referenced credentials cannot be accessed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_UNAVAILABLE\fR\fR .ad .RS 30n -.rt The \fBgss_inquire_cred_by_mech()\fR function is not available for the specified mechanism type. .RE @@ -197,13 +171,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_inquire_mechs_for_name.3gss b/usr/src/man/man3gss/gss_inquire_mechs_for_name.3gss index 9f540d6191..e7f9386030 100644 --- a/usr/src/man/man3gss/gss_inquire_mechs_for_name.3gss +++ b/usr/src/man/man3gss/gss_inquire_mechs_for_name.3gss @@ -3,14 +3,14 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_inquire_mechs_for_name 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_INQUIRE_MECHS_FOR_NAME 3GSS "Jan 15, 2003" .SH NAME gss_inquire_mechs_for_name \- list mechanisms that support the specified name-type .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_inquire_mechs_for_name\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -43,34 +43,28 @@ The parameter descriptions for \fBgss_inquire_mechs_for_name()\fR follow in alphabetical order: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt Mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIinput_name\fR\fR .ad .RS 16n -.rt The name to which the inquiry relates. .RE .sp .ne 2 -.mk .na \fB\fImech_types\fR\fR .ad .RS 16n -.rt Set of mechanisms that may support the specified name. The returned \fBOID\fR set must be freed by the caller after use with a call to \fBgss_release_oid_set\fR(3GSS). @@ -83,46 +77,38 @@ The \fBgss_inquire_mechs_for_name()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 22n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 22n -.rt The \fIinput_name\fR parameter was ill-formed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAMETYPE\fR\fR .ad .RS 22n -.rt The \fIinput_name\fR parameter contained an invalid or unsupported type of name. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 22n -.rt 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. @@ -136,13 +122,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_inquire_names_for_mech.3gss b/usr/src/man/man3gss/gss_inquire_names_for_mech.3gss index f52da0d4c8..b932af1730 100644 --- a/usr/src/man/man3gss/gss_inquire_names_for_mech.3gss +++ b/usr/src/man/man3gss/gss_inquire_names_for_mech.3gss @@ -3,14 +3,14 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_inquire_names_for_mech 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_INQUIRE_NAMES_FOR_MECH 3GSS "Jan 15, 2003" .SH NAME gss_inquire_names_for_mech \- list the name-types supported by the specified mechanism .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_inquire_names_for_mech\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -28,34 +28,28 @@ supported by the specified mechanism. The parameter descriptions for \fBgss_inquire_names_for_mech()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fImechanism\fR\fR .ad .RS 16n -.rt The mechanism to be interrogated. .RE .sp .ne 2 -.mk .na \fB\fIname_types\fR\fR .ad .RS 16n -.rt Set of name-types supported by the specified mechanism. The returned \fBOID\fR set must be freed by the application after use with a call to \fBgss_release_oid_set\fR(3GSS). @@ -68,23 +62,19 @@ The \fBgss_inquire_names_for_mech()\fR function may return the following values: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -98,13 +88,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_oid_to_str.3gss b/usr/src/man/man3gss/gss_oid_to_str.3gss index 3548d7e7e9..c82d634a5c 100644 --- a/usr/src/man/man3gss/gss_oid_to_str.3gss +++ b/usr/src/man/man3gss/gss_oid_to_str.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_oid_to_str 3GSS "15 Aug 2007" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_OID_TO_STR 3GSS "Aug 15, 2007" .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... ] +\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, @@ -19,34 +19,28 @@ gss_oid_to_str \- convert an OID to a string .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 @@ -70,7 +64,6 @@ instead of creating an \fBOID\fR for a specific mechanism. 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 @@ -81,7 +74,6 @@ A required input parameter could not be read. .sp .ne 2 -.mk .na \fB\fBGSS_S_CALL_INACCESSIBLE_WRITE\fR\fR .ad @@ -92,7 +84,6 @@ A required output parameter could not be written. .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad @@ -103,7 +94,6 @@ Successful completion. .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad @@ -122,13 +112,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_process_context_token.3gss b/usr/src/man/man3gss/gss_process_context_token.3gss index 94bacd16fb..881883e006 100644 --- a/usr/src/man/man3gss/gss_process_context_token.3gss +++ b/usr/src/man/man3gss/gss_process_context_token.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_process_context_token 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_PROCESS_CONTEXT_TOKEN 3GSS "Jan 15, 2003" .SH NAME gss_process_context_token \- pass asynchronous token to security service .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_process_context_token\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -47,34 +47,28 @@ The parameter descriptions for \fBgss_process_context_token()\fR are as follows: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 18n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 18n -.rt Context handle of context on which token is to be processed. .RE .sp .ne 2 -.mk .na \fB\fItoken_buffer\fR\fR .ad .RS 18n -.rt Token to process. .RE @@ -84,45 +78,37 @@ Token to process. \fBgss_process_context_token()\fR returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_TOKEN\fR\fR .ad .RS 25n -.rt Indicates that consistency checks performed on the token failed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The \fIcontext_handle\fR did not refer to a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -136,13 +122,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT LevelSafe +MT Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_release_buffer.3gss b/usr/src/man/man3gss/gss_release_buffer.3gss index 7bcb4d19cb..654b6eec64 100644 --- a/usr/src/man/man3gss/gss_release_buffer.3gss +++ b/usr/src/man/man3gss/gss_release_buffer.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_release_buffer 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_RELEASE_BUFFER 3GSS "Jan 15, 2003" .SH NAME gss_release_buffer \- free buffer storage allocated by a GSS-API function .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_release_buffer\fR(\fBOM_uint32 *\fR\fIminor_status\fR, \fBgss_buffer_t\fR\fIbuffer\fR); @@ -30,23 +30,19 @@ Any buffer object returned by a \fBGSS-API\fR function may be passed to The parameter descriptions for \fBgss_release_buffer()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt Mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIbuffer\fR\fR .ad .RS 16n -.rt The storage associated with the buffer will be deleted. The \fBgss_buffer_desc()\fR object will not be freed; however, its length field will be zeroed. @@ -58,23 +54,19 @@ will be zeroed. The \fBgss_release_buffer()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -88,13 +80,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_release_cred.3gss b/usr/src/man/man3gss/gss_release_cred.3gss index 050e1a13c6..fb54c03d74 100644 --- a/usr/src/man/man3gss/gss_release_cred.3gss +++ b/usr/src/man/man3gss/gss_release_cred.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_release_cred 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_RELEASE_CRED 3GSS "Jan 15, 2003" .SH NAME gss_release_cred \- discard a credential handle .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_release_cred\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -29,23 +29,19 @@ the associated resources. The \fIcred_handle\fR parameter is set to The parameter descriptions for \fBgss_release_cred()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcred_handle\fR\fR .ad .RS 16n -.rt An opaque handle that identifies the credential to be released. If \fBGSS_C_NO_CREDENTIAL\fR is specified, the \fBgss_release_cred()\fR function will complete successfully, but it will do nothing. @@ -57,34 +53,28 @@ will complete successfully, but it will do nothing. \fBgss_release_cred()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CRED\fR\fR .ad .RS 18n -.rt The referenced credentials cannot be accessed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -98,13 +88,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_release_name.3gss b/usr/src/man/man3gss/gss_release_name.3gss index af5a1bdd58..8590e7dfde 100644 --- a/usr/src/man/man3gss/gss_release_name.3gss +++ b/usr/src/man/man3gss/gss_release_name.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_release_name 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_RELEASE_NAME 3GSS "Jan 15, 2003" .SH NAME gss_release_name \- discard an internal-form name .SH SYNOPSIS .LP .nf -\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] +\fBcc\fR [\fIflag \&.\|.\|.\fR] \fIfile\fR\&.\|.\|. \fB-lgss\fR [\fIlibrary \&.\|.\|.\fR] #include <gssapi/gssapi.h \fBOM_uint32\fR \fBgss_release_name\fR(\fBOM_uint32 *\fR\fIminor_status\fR, \fBgss_name_t *\fR\fIname\fR); @@ -27,23 +27,19 @@ associated with an internal-form name. The \fIname\fR is set to The parameter descriptions for \fBgss_release_name()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIname\fR\fR .ad .RS 16n -.rt The name to be deleted. .RE @@ -53,34 +49,28 @@ The name to be deleted. The \fBgss_release_name()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_NAME\fR\fR .ad .RS 18n -.rt The \fIname\fR parameter did not contain a valid name. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -94,13 +84,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_release_oid.3gss b/usr/src/man/man3gss/gss_release_oid.3gss index 707ba59cc2..34828951e6 100644 --- a/usr/src/man/man3gss/gss_release_oid.3gss +++ b/usr/src/man/man3gss/gss_release_oid.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_release_oid 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_RELEASE_OID 3GSS "Jan 15, 2003" .SH NAME gss_release_oid \- release an object identifier .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fB\fR\fBgss_release_oid\fR(\fBOM_uint32 *\fR\fIminor_status\fR, \fBconst gss_OID *\fR\fIoid\fR); @@ -31,23 +31,19 @@ a set of \fBOID\fRs. The parameter descriptions for \fBgss_release_oid()\fR are as follows: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIoid\fR\fR .ad .RS 16n -.rt The object identifier of the mechanism to be deleted. .RE @@ -57,23 +53,19 @@ The object identifier of the mechanism to be deleted. \fBgss_release_oid()\fR returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -87,13 +79,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT LevelSafe +MT Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_release_oid_set.3gss b/usr/src/man/man3gss/gss_release_oid_set.3gss index 7c97a4ffef..c5eee17717 100644 --- a/usr/src/man/man3gss/gss_release_oid_set.3gss +++ b/usr/src/man/man3gss/gss_release_oid_set.3gss @@ -3,14 +3,14 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_release_oid_set 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_RELEASE_OID_SET 3GSS "Jan 15, 2003" .SH NAME gss_release_oid_set \- free storage associated with a GSS-API-generated gss_OID_set object .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_release_oid_set\fR(\fBOM_uint32 *\fR\fIminor_status\fR, \fBgss_OID_set *\fR\fIset\fR); @@ -35,23 +35,19 @@ this function. The parameter descriptions for \fBgss_release_oid_set()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism-specific status code .RE .sp .ne 2 -.mk .na \fB\fIset\fR\fR .ad .RS 16n -.rt Storage associated with the \fBgss_OID_set\fR will be deleted .RE @@ -61,23 +57,19 @@ Storage associated with the \fBgss_OID_set\fR will be deleted The \fBgss_release_oid_set()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -91,13 +83,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_store_cred.3gss b/usr/src/man/man3gss/gss_store_cred.3gss index ca550512f8..c12194bc46 100644 --- a/usr/src/man/man3gss/gss_store_cred.3gss +++ b/usr/src/man/man3gss/gss_store_cred.3gss @@ -3,7 +3,7 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_store_cred 3GSS "30 Jun 2005" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_STORE_CRED 3GSS "Jun 30, 2005" .SH NAME gss_store_cred \- store a credential in the current credential store .SH SYNOPSIS @@ -25,35 +25,29 @@ gss_store_cred \- store a credential in the current credential store The parameter descriptions for \fBgss_store_cred()\fR follow: .sp .ne 2 -.mk .na \fB\fIinput_cred\fR\fR .ad .RS 21n -.rt The credential to be stored. .RE .sp .ne 2 -.mk .na \fB\fIcred_usage\fR\fR .ad .RS 21n -.rt This parameter specifies whether to store an initiator, an acceptor, or both usage components of a credential. .RE .sp .ne 2 -.mk .na \fB\fIdesired_mech\fR\fR .ad .RS 21n -.rt The mechanism-specific component of a credential to be stored. If \fBGSS_C_NULL_OID\fR is specified, the \fBgss_store_cred()\fR function attempts to store all the elements of the given \fIinput_cred_handle\fR. @@ -65,12 +59,10 @@ element. .sp .ne 2 -.mk .na \fB\fIoverwrite_cred\fR\fR .ad .RS 21n -.rt A boolean that indicates whether to overwrite existing credentials in the current store for the same principal as that of the \fIinput_cred_handle\fR. A non-zero value indicates that credentials are overwritten. A zero value @@ -79,12 +71,10 @@ indicates that credentials are not overwritten. .sp .ne 2 -.mk .na \fB\fIdefault_cred\fR\fR .ad .RS 21n -.rt A boolean that indicates whether to set the principal name of the \fIinput_cred_handle\fR parameter as the default of the current credential store. A non-zero value indicates that the principal name is set as the @@ -96,36 +86,30 @@ gss_store_cred(3GSS). .sp .ne 2 -.mk .na \fB\fIelements_stored\fR\fR .ad .RS 21n -.rt The set of mechanism \fBOID\fRs for which \fIinput_cred_handle\fR elements have been stored. .RE .sp .ne 2 -.mk .na \fB\fIcred_usage_stored\fR\fR .ad .RS 21n -.rt The stored \fIinput_cred_handle\fR usage elements: initiator, acceptor, or both. .RE .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 21n -.rt Minor status code that is specific to one of the following: the mechanism identified by the \fIdesired_mech_element\fR parameter, or the element of a single mechanism in the \fIinput_cred_handle\fR. In all other cases, @@ -164,7 +148,6 @@ changing the effective UID before storing a delegated credential. The \fBgss_store_cred()\fR can return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad @@ -175,7 +158,6 @@ Successful completion. .sp .ne 2 -.mk .na \fB\fBGSS_S_CREDENTIALS_EXPIRED\fR\fR .ad @@ -186,7 +168,6 @@ The credentials could not be stored because they have expired. .sp .ne 2 -.mk .na \fB\fBGSS_S_CALL_INACCESSIBLE_READ\fR\fR .ad @@ -197,7 +178,6 @@ No input credentials were given. .sp .ne 2 -.mk .na \fB\fBGSS_S_UNAVAILABLE\fR\fR .ad @@ -208,7 +188,6 @@ The credential store is unavailable. .sp .ne 2 -.mk .na \fB\fBGSS_S_DUPLICATE_ELEMENT\fR\fR .ad @@ -221,7 +200,6 @@ conflicts with a credential in the current credential store. .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad @@ -240,15 +218,14 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -Interface StabilityUnstable +Interface Stability Unstable _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_str_to_oid.3gss b/usr/src/man/man3gss/gss_str_to_oid.3gss index ecef9bb407..cb7d04c68c 100644 --- a/usr/src/man/man3gss/gss_str_to_oid.3gss +++ b/usr/src/man/man3gss/gss_str_to_oid.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_str_to_oid 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_STR_TO_OID 3GSS "Jan 15, 2003" .SH NAME gss_str_to_oid \- convert a string to an OID .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_str_to_oid\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -38,34 +38,28 @@ applications use the default \fBGSS-API\fR mechanism instead of creating an The parameter descriptions for \fBgss_str_to_oid()\fR are as follows: .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 receive converted string. .RE .sp .ne 2 -.mk .na \fB\fIoid_str\fR\fR .ad .RS 16n -.rt String to convert. .RE @@ -75,7 +69,6 @@ String to convert. \fBgss_str_to_oid()\fR returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_CALL_INACCESSIBLE_READ\fR\fR .ad @@ -86,7 +79,6 @@ A required input parameter could not be read. .sp .ne 2 -.mk .na \fB\fBGSS_S_CALL_INACCESSIBLE_WRITE\fR\fR .ad @@ -97,7 +89,6 @@ A required output parameter could not be written. .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad @@ -108,7 +99,6 @@ Successful completion. .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad @@ -127,13 +117,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT LevelSafe +MT Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_test_oid_set_member.3gss b/usr/src/man/man3gss/gss_test_oid_set_member.3gss index d744c48764..c19c954b7d 100644 --- a/usr/src/man/man3gss/gss_test_oid_set_member.3gss +++ b/usr/src/man/man3gss/gss_test_oid_set_member.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_test_oid_set_member 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_TEST_OID_SET_MEMBER 3GSS "Jan 15, 2003" .SH NAME gss_test_oid_set_member \- interrogate an object identifier set .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_test_oid_set_member\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -31,45 +31,37 @@ also work with user-generated sets. The parameter descriptions for \fBgss_test_oid_set_member()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 16n -.rt A mechanism-specific status code .RE .sp .ne 2 -.mk .na \fB\fImember\fR\fR .ad .RS 16n -.rt An object identifier whose presence is to be tested .RE .sp .ne 2 -.mk .na \fB\fIset\fR\fR .ad .RS 16n -.rt An object identifier set. .RE .sp .ne 2 -.mk .na \fB\fIpresent\fR\fR .ad .RS 16n -.rt The value of \fIpresent\fR is non-zero if the specified \fBOID\fR is a member of the set; if not, the value of \fIpresent\fR is zero. .RE @@ -81,23 +73,19 @@ The \fBgss_test_oid_set_member()\fR function may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 18n -.rt Successful completion .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 18n -.rt 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. @@ -111,13 +99,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_unwrap.3gss b/usr/src/man/man3gss/gss_unwrap.3gss index 96285f7c16..9b497e8b89 100644 --- a/usr/src/man/man3gss/gss_unwrap.3gss +++ b/usr/src/man/man3gss/gss_unwrap.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_unwrap 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_UNWRAP 3GSS "Jan 15, 2003" .SH NAME gss_unwrap \- verify a message with attached cryptographic message .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_unwrap\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -38,45 +38,37 @@ wrapping and unwrapping of zero-length messages. The parameter descriptions for \fBgss_unwrap()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 25n -.rt The status code returned by the underlying mechanism. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 25n -.rt Identifies the context on which the message arrived. .RE .sp .ne 2 -.mk .na \fB\fIinput_message_buffer\fR\fR .ad .RS 25n -.rt The message to be protected. .RE .sp .ne 2 -.mk .na \fB\fIoutput_message_buffer\fR\fR .ad .RS 25n -.rt The buffer to receive the unwrapped message. Storage associated with this buffer must be freed by the application after use with a call to \fBgss_release_buffer\fR(3GSS). @@ -84,12 +76,10 @@ buffer must be freed by the application after use with a call to .sp .ne 2 -.mk .na \fB\fIconf_state\fR\fR .ad .RS 25n -.rt If the value of \fIconf_state\fR is non-zero, then confidentiality and integrity protection were used. If the value is zero, only integrity service was used. Specify \fBNULL\fR if this parameter is not required. @@ -97,12 +87,10 @@ was used. Specify \fBNULL\fR if this parameter is not required. .sp .ne 2 -.mk .na \fB\fIqop_state\fR\fR .ad .RS 25n -.rt Specifies the quality of protection provided. Specify \fBNULL\fR if this parameter is not required. .RE @@ -113,81 +101,67 @@ parameter is not required. \fBgss_unwrap()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_TOKEN\fR\fR .ad .RS 25n -.rt The token failed consistency checks. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_SIG\fR\fR .ad .RS 25n -.rt The \fBMIC\fR was incorrect. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DUPLICATE_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid, and contained a correct \fBMIC\fR for the message, but it had already been processed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_OLD_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid, and contained a correct \fBMIC\fR for the message, but it is too old to check for duplication. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_UNSEQ_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid, and contained a correct \fBMIC\fR for the message, but has been verified out of sequence; a later token has already been received. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_GAP_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid, and contained a correct \fBMIC\fR for the message, but has been verified out of sequence; an earlier expected token has not yet been received. @@ -195,34 +169,28 @@ received. .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTEXT_EXPIRED\fR\fR .ad .RS 25n -.rt The context has already expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The \fIcontext_handle\fR parameter did not identify a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -236,13 +204,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_verify_mic.3gss b/usr/src/man/man3gss/gss_verify_mic.3gss index ed2639ede0..2330b2005e 100644 --- a/usr/src/man/man3gss/gss_verify_mic.3gss +++ b/usr/src/man/man3gss/gss_verify_mic.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_verify_mic 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_VERIFY_MIC 3GSS "Jan 15, 2003" .SH NAME gss_verify_mic \- verify integrity of a received message .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_verify_mic\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -35,56 +35,46 @@ calculation and verification of \fBMIC\fRs over zero-length messages. The parameter descriptions for \fBgss_verify_mic()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 18n -.rt The status code returned by the underlying mechanism. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 18n -.rt Identifies the context on which the message arrived. .RE .sp .ne 2 -.mk .na \fB\fImessage_buffer\fR\fR .ad .RS 18n -.rt The message to be verified. .RE .sp .ne 2 -.mk .na \fB\fItoken_buffer\fR\fR .ad .RS 18n -.rt The token associated with the message. .RE .sp .ne 2 -.mk .na \fB\fIqop_state\fR\fR .ad .RS 18n -.rt Specifies the quality of protection gained from the \fBMIC\fR. Specify \fBNULL\fR if this parameter is not required. .RE @@ -95,81 +85,67 @@ Specifies the quality of protection gained from the \fBMIC\fR. Specify \fBgss_verify_mic()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DEFECTIVE_TOKEN\fR\fR .ad .RS 25n -.rt The token failed consistency checks. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_SIG\fR\fR .ad .RS 25n -.rt The \fBMIC\fR was incorrect. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_DUPLICATE_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid and contained a correct \fBMIC\fR for the message, but it had already been processed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_OLD_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid and contained a correct \fBMIC\fR for the message, but it is too old to check for duplication. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_UNSEQ_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid and contained a correct \fBMIC\fR for the message, but it has been verified out of sequence; a later token has already been received. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_GAP_TOKEN\fR\fR .ad .RS 25n -.rt The token was valid and contained a correct \fBMIC\fR for the message, but it has been verified out of sequence; an earlier expected token has not yet been received. @@ -177,34 +153,28 @@ received. .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTEXT_EXPIRED\fR\fR .ad .RS 25n -.rt The context has already expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The \fIcontext_handle\fR parameter did not identify a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -218,13 +188,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_wrap.3gss b/usr/src/man/man3gss/gss_wrap.3gss index 10a85f5038..9748d94399 100644 --- a/usr/src/man/man3gss/gss_wrap.3gss +++ b/usr/src/man/man3gss/gss_wrap.3gss @@ -3,13 +3,13 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_wrap 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_WRAP 3GSS "Jan 15, 2003" .SH NAME gss_wrap \- attach a cryptographic message .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_wrap\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -36,34 +36,28 @@ wrapping of zero-length messages. The parameter descriptions for \fBgss_wrap()\fR follow: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 25n -.rt The status code returned by the underlying mechanism. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 25n -.rt Identifies the context on which the message will be sent. .RE .sp .ne 2 -.mk .na \fB\fIconf_req_flag\fR\fR .ad .RS 25n -.rt If the value of \fIconf_req_flag\fR is non-zero, both confidentiality and integrity services are requested. If the value is zero, then only integrity service is requested. @@ -71,12 +65,10 @@ service is requested. .sp .ne 2 -.mk .na \fB\fIqop_req\fR\fR .ad .RS 25n -.rt Specifies the required quality of protection. A mechanism-specific default may be requested by setting \fIqop_req\fR to \fBGSS_C_QOP_DEFAULT\fR. If an unsupported protection strength is requested, \fBgss_wrap()\fR will return a @@ -85,23 +77,19 @@ unsupported protection strength is requested, \fBgss_wrap()\fR will return a .sp .ne 2 -.mk .na \fB\fIinput_message_buffer\fR\fR .ad .RS 25n -.rt The message to be protected. .RE .sp .ne 2 -.mk .na \fB\fIconf_state\fR\fR .ad .RS 25n -.rt If the value of \fIconf_state\fR is non-zero, confidentiality, data origin authentication, and integrity services have been applied. If the value is zero, then integrity services have been applied. Specify \fBNULL\fR if this parameter @@ -110,12 +98,10 @@ is not required. .sp .ne 2 -.mk .na \fB\fIoutput_message_buffer\fR\fR .ad .RS 25n -.rt The buffer to receive the protected message. Storage associated with this message must be freed by the application after use with a call to \fBgss_release_buffer\fR(3GSS). @@ -127,56 +113,46 @@ message must be freed by the application after use with a call to \fBgss_wrap()\fR may return the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTEXT_EXPIRED\fR\fR .ad .RS 25n -.rt The context has already expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The \fIcontext_handle\fR parameter did not identify a valid context. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_QOP\fR\fR .ad .RS 25n -.rt The specified \fBQOP\fR is not supported by the mechanism. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -190,13 +166,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT-LevelSafe +MT-Level Safe .TE .SH SEE ALSO diff --git a/usr/src/man/man3gss/gss_wrap_size_limit.3gss b/usr/src/man/man3gss/gss_wrap_size_limit.3gss index f7a3d02361..3e2851e04c 100644 --- a/usr/src/man/man3gss/gss_wrap_size_limit.3gss +++ b/usr/src/man/man3gss/gss_wrap_size_limit.3gss @@ -3,14 +3,14 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH gss_wrap_size_limit 3GSS "15 Jan 2003" "SunOS 5.11" "Generic Security Services API Library Functions" +.TH GSS_WRAP_SIZE_LIMIT 3GSS "Jan 15, 2003" .SH NAME gss_wrap_size_limit \- allow application to determine maximum message size with resulting output token of a specified maximum size .SH SYNOPSIS .LP .nf -\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] +\fBcc\fR [ \fIflag\fR... ] \fIfile\fR... \fB-lgss\fR [ \fIlibrary\fR... ] #include <gssapi/gssapi.h> \fBOM_uint32\fR \fBgss_process_context_token\fR(\fBOM_uint32 *\fR\fIminor_status\fR, @@ -44,34 +44,28 @@ of system resources at the time that \fBgss_wrap()\fR is called. The parameter descriptions for \fBgss_wrap_size_limit()\fR are as follows: .sp .ne 2 -.mk .na \fB\fIminor_status\fR\fR .ad .RS 19n -.rt A mechanism-specific status code. .RE .sp .ne 2 -.mk .na \fB\fIcontext_handle\fR\fR .ad .RS 19n -.rt A handle that refers to the security over which the messages will be sent. .RE .sp .ne 2 -.mk .na \fB\fIconf_req_flag\fR\fR .ad .RS 19n -.rt Indicates whether \fBgss_wrap()\fR will be asked to apply confidential protection in addition to integrity protection. See \fBgss_wrap\fR(3GSS) for more details. @@ -79,35 +73,29 @@ more details. .sp .ne 2 -.mk .na \fB\fIqop_req\fR\fR .ad .RS 19n -.rt Indicates the level of protection that \fBgss_wrap()\fR will be asked to provide. See \fBgss_wrap\fR(3GSS) for more details. .RE .sp .ne 2 -.mk .na \fB\fIreq_output_size\fR\fR .ad .RS 19n -.rt The desired maximum size for tokens emitted by \fBgss_wrap()\fR. .RE .sp .ne 2 -.mk .na \fB\fImax_input_size\fR\fR .ad .RS 19n -.rt The maximum input message size that can be presented to \fBgss_wrap()\fR to guarantee that the emitted token will be no larger than \fIreq_output_size\fR bytes. @@ -119,56 +107,46 @@ bytes. \fBgss_wrap_size_limit()\fR returns one of the following status codes: .sp .ne 2 -.mk .na \fB\fBGSS_S_COMPLETE\fR\fR .ad .RS 25n -.rt Successful completion. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_NO_CONTEXT\fR\fR .ad .RS 25n -.rt The referenced context could not be accessed. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_CONTEXT_EXPIRED\fR\fR .ad .RS 25n -.rt The context has expired. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_BAD_QOP\fR\fR .ad .RS 25n -.rt The specified \fBQOP\fR is not supported by the mechanism. .RE .sp .ne 2 -.mk .na \fB\fBGSS_S_FAILURE\fR\fR .ad .RS 25n -.rt 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. @@ -182,13 +160,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes: .sp .TS -tab() box; -cw(2.75i) |cw(2.75i) -lw(2.75i) |lw(2.75i) -. -ATTRIBUTE TYPEATTRIBUTE VALUE +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE _ -MT LevelSafe +MT Level Safe .TE .SH SEE ALSO |