Kernel Functions for Drivers     netprotocolnotifyregister(9F)



NAME
     netprotocolnotifyregister,
     netinstanceprotocolunregister  - add/delete a function to
     be called for changes to a protocol

SYNOPSIS
     #include 
     #include 

     int netprotocolnotifyregister(nethandlet family,
          hooknotifyfnt *callback, void *arg);

     int netprotocolnotifyunregister(nethandlet family,
          hooknotifyfnt *callback);

     typedef int (* hooknotifyfnt)(hooknotifycmdt command,
          void *arg, const char *name1, const char *name2, const char
          *name3);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     family      value returned from netprotocollookup().


     callback    function to call when a change occurs.


     arg         pointer to pass  into  the  callback()  function
                 when a change occurs.


DESCRIPTION
     The  netprotocolnotifyregister()  function  registers   a
     function  represented  by  the pointer callback to be called
     when there is a change to the protocol represented  by  fam-
     ily. The types of changes for which notifications are avail-
     able for is currently limited to the addition and removal of
     protocols.


     The netprotocolnotifyunregister()  function  removes  the
     function  specified by the pointer callback from the list of
     functions to call. This call may fail if the specified func-
     tion cannot be found.


     Multiple callback functions may be registered  through  this
     interface.  The  same  set  of  parameters is passed to each
     callback  function.  The  memory  referenced   through   the



SunOS 5.11          Last change: 30 Oct 2008                    1






Kernel Functions for Drivers     netprotocolnotifyregister(9F)



     pointers  passed to the callback should be treated as point-
     ing to read-only memory.  Changing  this  data  is  strictly
     prohibited.


     The function that is called must not block any other  proto-
     cols.


     The arguments passed through to the callback are as  follows
     (the command is either HNREGISTER or HNUNREGISTER):

     name1    is the name of the protocol


     name2    is NUL.


     name3    is the name of the protocol being added/removed


RETURN VALUES
     If these functions succeed, 0 is  returned.  Otherwise,  the
     following error is returned:

     EXIST    the given callback function is already registered.


CONTEXT
     These functions may be called from user or kernel context.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    
     Interface Stability          Committed                   
    


SEE ALSO
     attributes(5), netprotocollookup(9F)







SunOS 5.11          Last change: 30 Oct 2008                    2