1nlsgetcall(3NSL)     Networking Services Library Functions    nlsgetcall(3NSL)
2
3
4

NAME

6       nlsgetcall - get client's data passed via the listener
7

SYNOPSIS

9       #include <sys/tiuser.h>
10
11
12
13       struct t_call *nlsgetcall(int fildes);
14
15

DESCRIPTION

17       nlsgetcall() allows server processes started by the listener process to
18       access the client's t_call structure, that is, the sndcall argument  of
19       t_connect(3NSL).
20
21
22       The  t_call  structure  returned  by nlsgetcall() can be released using
23       t_free(3NSL).
24
25
26       nlsgetcall() returns the address of an allocated  t_call  structure  or
27       NULL  if  a t_call structure cannot be allocated. If the t_alloc() suc‐
28       ceeds, undefined environment variables are indicated by a negative  len
29       field in the appropriate netbuf structure.   A len field of zero in the
30       netbuf structure is valid and means that the  original  buffer  in  the
31       listener's t_call structure was NULL.
32

RETURN VALUES

34       A NULL pointer is returned if a t_call structure cannot be allocated by
35       t_alloc(). t_errno can be  inspected  for  further  error  information.
36       Undefined  environment  variables  are  indicated  by a negative length
37       field (len) in the appropriate netbuf structure.
38

FILES

40       /usr/lib/libnls.so.1    shared object
41
42

ATTRIBUTES

44       See attributes(5) for descriptions of the following attributes:
45
46
47
48
49       ┌─────────────────────────────┬─────────────────────────────┐
50       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
51       ├─────────────────────────────┼─────────────────────────────┤
52       │MT-Level                     │Unsafe                       │
53       └─────────────────────────────┴─────────────────────────────┘
54

SEE ALSO

56       nlsadmin(1M),     getenv(3C),      t_alloc(3NSL),      t_connect(3NSL),
57       t_error(3NSL), t_free(3NSL), t_sync(3NSL), attributes(5)
58

WARNINGS

60       The  len field in the netbuf structure is defined as being unsigned. In
61       order to check for error returns, it should first be cast to an int.
62
63
64       The listener process limits the amount of user data (udata) and options
65       data  (opt)  to  128  bytes  each.   Address data addr is limited to 64
66       bytes. If the original data was longer,  no indication of  overflow  is
67       given.
68

NOTES

70       Server processes must call t_sync(3NSL) before calling this routine.
71
72
73       This  interface is unsafe in multithreaded applications.  Unsafe inter‐
74       faces should be called only from the main thread.
75
76
77
78SunOS 5.11                        14 Nov 2002                 nlsgetcall(3NSL)
Impressum