NAME    [Toc]    [Back]

       unregister_callback - General: Deregisters a configuration
       callback routine

SYNOPSIS    [Toc]    [Back]

       int unregister_callback(
               void (*function) (),
               int point,
               int order,
               ulong argument );

ARGUMENTS    [Toc]    [Back]

       Specifies the name of the routine that you want to  deregister.
   You must have previously registered this callback
       routine by calling register_callback.  Specifies the  execution
  point  at which the kernel calls the callback routine
 previously registered by  calling  register_callback.
       The  execution  point you pass to this argument must match
       the value you passed to the point argument in the call  to
       register_callback.   Specifies  the  order  value that you
       specified in a previous call to register_callback.  Specifies
  an  argument that you want the kernel to pass to the
       callback routine that you previously registered by calling
       register_callback.  The argument you pass to this argument
       must match the value you passed to argument in the call to
       register_callback.  You would pass the integer constant 0L
       if you passed this in the previous call to  register_callback
 to indicate there is no argument.

DESCRIPTION    [Toc]    [Back]

       The  unregister_callback routine deregisters a kernel module's
 configuration callback routine.  The  kernel  module
       previously  registered  its routine or routines by calling
       the register_callback routine.  The  values  you  pass  to
       unregister_callback  must  be the same ones you previously
       passed to register_callback to deregister a specific  routine.
  Kernel modules call unregister_callback to deregister
 the callback routine when it is no longer needed.

       A kernel module typically calls  unregister_callback  when
       it  encounters a fatal error during static or dynamic configuration.
 The cfgmgr framework  executes  callback  routines
  scheduled  to  run after single-user mode each time
       the system goes from multiuser mode  to  single-user  mode
       and  back  to  multiuser  mode.  You should unregister any
       callback routines if you do not want this to occur.

NOTES    [Toc]    [Back]

       The kernel maintains an internal callback list that stores
       the  values  you  pass  to  the register_callback routine.
       These callbacks remain registered until the  user  removes
       them.

       The unregister_callback routine searches through the callback
 list for the specified callback routine,  the  specified
  point,  the specified order, and the specified argument
 and removes that routine from the list.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion, the  unregister_callback  routine
 returns the value ESUCCESS.

       Otherwise, unregister_callback returns the following error
       constant,  defined  in  /usr/sys/include/sys/errno.h:  The
       value you passed to the point argument is outside the minimum
 and maximum range.  The callback you specified to  be
       removed does not exist in the callback list.  The callback
       you specified to be removed does not exist in the callback
       list.

FILES    [Toc]    [Back]

SEE ALSO
       Routines: register_callback(9r)



                                          unregister_callback(9r)