Networking Services Library Functions
rpcgssmaxdatalength(3NSL)
NAME
rpcgssmaxdatalength, rpcgsssvcmaxdatalength - get
maximum data length for transmission
SYNOPSIS
#include
int rpcgssmaxdatalength(AUTH *handle, int maxtpunitlen);
int rpcgsssvcmaxdatalength(struct svcreq *req, int maxtpunitlen);
DESCRIPTION
Performing a security transformation on a piece of data gen-
erally produces data with a different (usually greater)
length. For some transports, such as UDP, there is a max-
imum 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.
rpcgssmaxdatalength() is the client-side version;
rpcgsssvcmaxdatalength() is the server-side version.
PARAMETERS
handle An RPC context handle of type AUTH,
returned when a context is created (for
example, by rpcgssseccreate(). Secu-
rity service and QOP are bound to this
handle, eliminating any need to specify
them.
maxtpunitlen The maximum size of a piece of data
allowed by the transport.
req A pointer to an RPC svcreq structure,
containing information on the context
(for example, program number and creden-
tials).
RETURN VALUES
Both functions return the maximum size of untransformed data
allowed, as an int.
SunOS 5.11 Last change: 5 Feb 2002 1
Networking Services Library Functions
rpcgssmaxdatalength(3NSL)
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
MT-Level MT-Safe
Availability SUNWrsg (32-bit)
SUNWrsgx (64-bit)
SEE ALSO
rpc(3NSL), rpcsecgss(3NSL), attributes(5)
ONC] Developer's Guide
Linn, J. RFC 2078, Generic Security Service Application Pro-
gram Interface, Version 2. Network Working Group. January
1997.
SunOS 5.11 Last change: 5 Feb 2002 2
Networking Services Library Functions
rpcgssmaxdatalength(3NSL)
SunOS 5.11 Last change: 5 Feb 2002 3
|