unregister_callback - General: Deregisters a configuration
void (*function) (),
ulong argument );
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.
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.
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
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.
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
[ Back ]