Networking Services Library Functions            nlsgetcall(3NSL)



NAME
     nlsgetcall - get client's data passed via the listener

SYNOPSIS
     #include 



     struct tcall *nlsgetcall(int fildes);


DESCRIPTION
     nlsgetcall() allows server processes started by the listener
     process  to  access  the client's tcall structure, that is,
     the sndcall argument of tconnect(3NSL).


     The  tcall  structure  returned  by  nlsgetcall()  can   be
     released using tfree(3NSL).


     nlsgetcall() returns the  address  of  an  allocated  tcall
     structure or NUL if a tcall structure cannot be allocated.
     If the talloc() succeeds, undefined  environment  variables
     are  indicated  by  a  negative len field in the appropriate
     netbuf structure.   A len field of zero in the netbuf struc-
     ture  is  valid  and  means  that the original buffer in the
     listener's tcall structure was NUL.

RETURN VALUES
     A NUL pointer is returned if a tcall structure  cannot  be
     allocated by talloc(). terrno can be inspected for further
     error information. Undefined environment variables are indi-
     cated  by  a  negative length field (len) in the appropriate
     netbuf structure.

FILES
     /usr/lib/libnls.so.1    shared object


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:












SunOS 5.11          Last change: 14 Nov 2002                    1






Networking Services Library Functions            nlsgetcall(3NSL)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     nlsadmin(1M),  getenv(3C),  talloc(3NSL),  tconnect(3NSL),
     terror(3NSL), tfree(3NSL), tsync(3NSL), attributes(5)

WARNINGS
     The len field in the netbuf structure is  defined  as  being
     unsigned.  In  order  to  check for error returns, it should
     first be cast to an int.


     The listener process limits the amount of user data  (udata)
     and  options  data  (opt)  to 128 bytes each.   Address data
     addr is limited to  64  bytes.  If  the  original  data  was
     longer,  no indication of overflow is given.

NOTES
     Server processes must call tsync(3NSL) before calling  this
     routine.


     This interface  is  unsafe  in  multithreaded  applications.
     Unsafe  interfaces  should  be  called  only  from  the main
     thread.

























SunOS 5.11          Last change: 14 Nov 2002                    2