gss_wrap_size_limit(3) — Subroutines
NAME
gss_wrap_size_limit − set the maximum input message size for the required maximum output token
SYNOPSIS
#include <gssapi/gssapi.h>
OM_uint32 gss_wrap_size_limit(
OM_uint32 ∗ minor_status,
const gss_ctx_id_t context_handle,
int conf_req_flag,
gss_qop_t qop_req,
OM_uint32 req_output_size,
OM_uint32 ∗ max_input_size );
PARAMETERS
minor_status
Kerberos 5 error code.
context_handle
Security context over which the messages are sent.
conf_req_flag
Confidentiality protection that gss_wrap() is to apply in addition to integrity protection. gss_wrap() contains details.
qop_req
Level of protection that gss_wrap() is to provide. gss_wrap() contains details.
req_output_size
Maximum size for tokens emitted by gss_wrap().
max_input_size
Maximum input message size that may be presented to gss_wrap() in order to guarantee that the emitted token is no larger than req_output_size bytes.
DESCRIPTION
The gss_wrap_size_limit() function allows an application to set the maximum input message size for the required maximum output token size. This call is intended for use by applications that communicate over protocols that limit message size. It allows the application to split up and re-assemble messages that are too long.
This function, if presented to gss_wrap() with the same conf_req_flag and qop_req parameters, results in an output token containing no more than req_output_size bytes.
RETURN VALUES
| GSS_S_BAD_QOP | xx0Exxxx |
| GSS_S_CALL_INACCESSIBLE_READ | 01xxxxxx |
| GSS_S_CALL_INACCESSIBLE_WRITE | 02xxxxxx |
| GSS_S_COMPLETE | 00000000 |
| GSS_S_FAILURE | xx0Dxxxx |
| GSS_S_NO_CONTEXT | xx08xxxx |