unregister_callback man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

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_call‐
       back.  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 call‐
       ing  register_callback.	The  argument  you  pass to this argument must
       match the value you passed to argument in the  call  to	register_call‐
       back.  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  configu‐
       ration  callback	 routine.  The kernel module previously registered its
       routine or routines by calling the register_callback routine. The  val‐
       ues  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 frame‐
       work 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  reg‐
       istered 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)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net