rpc_gss_max_data_length(3NSL) Networking Services Library Functions rpc_gss_max_data_length(3NSL)
NAME
rpc_gss_max_data_length, rpc_gss_svc_max_data_length - get maximum data length for transmission
SYNOPSIS
#include <rpc/rpcsec_gss.h>
int rpc_gss_max_data_length(AUTH *handle, int max_tp_unit_len);
int rpc_gss_svc_max_data_length(struct svc_req *req, int max_tp_unit_len);
DESCRIPTION
Performing a security transformation on a piece of data generally produces data with a different (usually greater) length. For some
transports, such as UDP, there is a maximum length of data which can be sent out in one data unit. Applications need to know the maximum
size a piece of data can be before it's transformed, so that the resulting data will still "fit" on the transport. These two functions
return that maximum size.
rpc_gss_max_data_length() is the client-side version; rpc_gss_svc_max_data_length() is the server-side version.
PARAMETERS
handle An RPC context handle of type AUTH, returned when a context is created (for example, by rpc_gss_seccreate(). Secu-
rity service and QOP are bound to this handle, eliminating any need to specify them.
max_tp_unit_len The maximum size of a piece of data allowed by the transport.
req A pointer to an RPC svc_req structure, containing information on the context (for example, program number and cre-
dentials).
RETURN VALUES
Both functions return the maximum size of untransformed data allowed, as an int.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
|Availability |SUNWrsg (32-bit) |
+-----------------------------+-----------------------------+
| |SUNWrsgx (64-bit) |
+-----------------------------+-----------------------------+
SEE ALSO
rpc(3NSL), rpcsec_gss(3NSL), attributes(5)
ONC+ Developer's Guide
Linn, J. RFC 2078, Generic Security Service Application Program Interface, Version 2. Network Working Group. January 1997.
SunOS 5.10 5 Feb 2002 rpc_gss_max_data_length(3NSL)
