osf1 man page for unregister_callback

unregister_callback(9r) 												   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
       Specifies the name of the routine that you want to deregister.  You must have previously registered this callback routine by calling regis-
       ter_callback.  Specifies the execution point at which the kernel calls the callback routine previously registered by calling register_call-
       back. 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  previ-
       ous 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  previ-
       ously passed to register_callback to deregister a specific routine. Kernel modules call unregister_callback to deregister the callback rou-
       tine 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: 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
SEE ALSO
       Routines: register_callback(9r)

															   unregister_callback(9r)