v7 man page for rpc_gss_max_data_length

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)