Index for Section 9

Alphabetical listing for U

Bottom of page

unregister_callback(9r)
NAME
  unregister_callback - General: Deregisters a configuration callback routine

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

ARGUMENTS
  function
      Specifies the name of the routine that you want to deregister.  You
      must have previously registered this callback routine by calling
      register_callback.

  point
      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.

  order
      Specifies the order value that you specified in a previous call to
      register_callback.

  argument
      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
  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
  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
  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:

  EINVAL  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.

  EINVAL  The callback you specified to be removed does not exist in the
	  callback list.

FILES
  <sysconfig.h>

SEE ALSO
  Routines: register_callback(9r)

Index for Section 9

Alphabetical listing for U

Top of page