1rpc_gss_max_data_lengtNhe(t3wNoSrLk)ing Services Library Frupncc_tgisosn_smax_data_length(3NSL)
2
3
4

NAME

6       rpc_gss_max_data_length, rpc_gss_svc_max_data_length - get maximum data
7       length for  transmission
8

SYNOPSIS

10       #include <rpc/rpcsec_gss.h>
11
12       int rpc_gss_max_data_length(AUTH *handle, int max_tp_unit_len);
13
14
15       int rpc_gss_svc_max_data_length(struct svc_req *req, int max_tp_unit_len);
16
17

DESCRIPTION

19       Performing a security transformation on a piece of data generally  pro‐
20       duces  data with a different (usually greater) length.  For some trans‐
21       ports, such as UDP, there is a maximum length of data which can be sent
22       out  in  one  data  unit.  Applications need to know the maximum size a
23       piece of data can be before it's transformed,  so  that  the  resulting
24       data will still "fit" on the transport. These two functions return that
25       maximum size.
26
27
28       rpc_gss_max_data_length()     is     the      client-side      version;
29       rpc_gss_svc_max_data_length() is the server-side version.
30

PARAMETERS

32       handle              An RPC context handle of type AUTH, returned when a
33                           context is created (for example, by rpc_gss_seccre‐
34                           ate().  Security  service and QOP are bound to this
35                           handle, eliminating any need to specify them.
36
37
38       max_tp_unit_len     The maximum size of a piece of data allowed by  the
39                           transport.
40
41
42       req                 A  pointer  to an RPC svc_req structure, containing
43                           information on the context  (for  example,  program
44                           number and credentials).
45
46

RETURN VALUES

48       Both  functions  return the maximum size of untransformed data allowed,
49       as an int.
50

ATTRIBUTES

52       See attributes(5) for descriptions of the following attributes:
53
54
55
56
57       ┌─────────────────────────────┬─────────────────────────────┐
58       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
59       ├─────────────────────────────┼─────────────────────────────┤
60       │MT-Level                     │MT-Safe                      │
61       ├─────────────────────────────┼─────────────────────────────┤
62       │Availability                 │SUNWrsg (32-bit)             │
63       ├─────────────────────────────┼─────────────────────────────┤
64       │                             │SUNWrsgx (64-bit)            │
65       └─────────────────────────────┴─────────────────────────────┘
66

SEE ALSO

68       rpc(3NSL), rpcsec_gss(3NSL), attributes(5)
69
70
71       ONC+ Developer's Guide
72
73
74       Linn, J. RFC 2078, Generic Security Service Application Program  Inter‐
75       face, Version 2. Network Working Group. January 1997.
76
77
78
79SunOS 5.11                        5 Feb 2002     rpc_gss_max_data_length(3NSL)
Impressum