Networking Services Library Functions         rpcsvcinput(3NSL)



NAME
     rpcsvcinput, svcaddinput, svcremoveinput - declare  or
     remove a callback on a file descriptor

SYNOPSIS
     #include 

     typedef void (*svccallbackt)(svcinputidt id, int fd,
          unsigned int events, void *cookie);


     svcinputidt svcaddinput(int fd, unsigned int revents,
          svccallbackt callback, void *cookie);


     int svcremoveinput(svcinputt id);


DESCRIPTION
     The following RPC routines are used to declare or  remove  a
     callback on a file descriptor.

  Routines
     See rpc(3NSL) for the definition of the SVCXPRT data  struc-
     ture.

     svcaddinput()       This function is used  to  register  a
                           callback  function  on a file descrip-
                           tor, fd. The file descriptor,  fd,  is
                           the  first  parameter  to be passed to
                           svcaddinput(). This  callback  func-
                           tion  will  be automatically called if
                           any of the  events  specified  in  the
                           events   parameter   occur   on   this
                           descriptor. The  events  parameter  is
                           used  to  specify when the callback is
                           invoked. This parameter is a  mask  of
                           poll events to which the user wants to
                           listen.  See   poll(2)   for   further
                           details  of  the  events  that  can be
                           specified.

                           The callback to be invoked  is  speci-
                           fied using the callback parameter. The
                           cookie parameter can be used  to  pass
                           any  data  to  the  callback function.
                           This parameter is a user-defined value
                           which  is passed as an argument to the
                           callback function, and it is not  used
                           by the Sun RPC library itself.

                           Several callbacks can be registered on



SunOS 5.11           Last change: 6 Jan 2003                    1






Networking Services Library Functions         rpcsvcinput(3NSL)



                           the  same  file  descriptor as long as
                           each callback registration specifies a
                           separate set of event flags.

                           The callback function is  called  with
                           the   registration  id,  the  fd  file
                           descriptor, an revents value, which is
                           a bitmask of all events concerning the
                           file descriptor, and the cookie  user-
                           defined value.

                           Upon successful completion, the  func-
                           tion  returns  a unique identifier for
                           this registration, that  can  be  used
                           later  to  remove  this callback. Upon
                           failure, -1 is returned and  errno  is
                           set to indicate the error.

                           The svcaddinput() function will fail
                           if:

                           EINVAL    The fd or events  parameters
                                     are invalid.


                           EXIST    A   callback   is    already
                                     registered   to   the   file
                                     descriptor with one  of  the
                                     specified events.


                           ENOMEM    Memory is exhausted.



     svcremoveinput()    This function is used to unregister  a
                           callback  function  on a file descrip-
                           tor, fd. The  id  parameter  specifies
                           the registration to be removed.

                           Upon successful completion, the  func-
                           tion returns zero. Upon failure, -1 is
                           returned and errno is set to  indicate
                           the error.

                           The svcremoveinput()  function  will
                           fail if:

                           EINVAL    The id parameter is invalid.






SunOS 5.11           Last change: 6 Jan 2003                    2






Networking Services Library Functions         rpcsvcinput(3NSL)



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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 All                         
    
     Availability                 SUNWcsl (32-bit)            
    
                                  SUNWcslx (64-bit)           
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     poll(2), rpc(3NSL), attributes(5)
































SunOS 5.11           Last change: 6 Jan 2003                    3