unregister_callback(9r) [osf1 man page]

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)

Check Out this Related Man Page

FtpOptions(3)						     Library Functions Manual						     FtpOptions(3)

NAME

       FtpOptions - Set connection options.

SYNOPSIS

       #include <ftplib.h>

       int FtpOptions(int opt, long val, netbuf *nControl);

PARAMETERS

       opt    Specifies  the  option  to  change.  Valid  options  are	FTPLIB_CONNMODE, FTPLIB_CALLBACK, FTPLIB_IDLETIME, FTPLIB_CALLBACKARG, and
	      FTPLIB_CALLBACKBYTES.

       val    Specifies the new value for the option. The value may need to by cast to a long.

       nControl
	      A handle returned by FtpConnect()or FtpAccess().

DESCRIPTION

       FtpOptions() changes the options for a connection handle. A data connection inherits the options assigned to the control connection  it	is
       created from. Callbacks are only called on file data connections.

       The  following  options	and  values  are  recognized.OptionValueFTPLIB_CONNMODE  Specifies  the  connection mode. Either FTPLIB_PASSIVE or
       FTPLIB_PORT.FTPLIB_CALLBACK Specifies the address of a user callback routine.FTPLIB_IDLETIME Specifies the socket idle time in milliseconds
       that  triggers  calling	the  user's  callback  routine.FTPLIB_CALLBACKARG  Specifies  an  argument  to	pass  to  the user's callback rou-
       tine.FTPLIB_CALLBACKBYTES Specifies the number of bytes to transfer between calls to the user's callback routine.

       The connection mode tells ftplib if it should use PASV or PORT to establish data connections. The default is specified as a build option.

       The user's callback routine is specified as:.sp typedef int (*FtpCallback)(netbuf *nControl, int xfered,
	      void *arg); nControlis the data connection in use. xferedspecifies how many bytes of data  have  been  transferred  on  the  connec-
	      tion.argis the value specified with option FTPLIB_CALLBACKARG.

	      The user can request to be called back on either of two events.

	      If  the user wishes to be called when the data socket is idle for some period of time, use FTPLIB_IDLETIME and pass the time in mil-
	      liseconds.

	      If the user wishes to be called when a certain amount of data has been transferred, use FTPLIB_CALLBACKBYTES and	pass  the  minimum
	      number  of  bytes  to  transfer between callbacks. When using this option, ftplib keeps track of the number of bytes transferred and
	      calls the user once the specified number of bytes or more has been transferred. It then resets the count to 0 and starts again.

	      If the user wishes to continue the transfer, the callback routine should return true (non-zero). It can abort the transfer by return
	      zero.

RETURN VALUE

       Returns 1 if a valid option was specified and the value is legal. Otherwise, returns 0.

FTPlib								   24 June 1998 						     FtpOptions(3)

Linux and UNIX Man Pages

unregister_callback(9r) [osf1 man page]

Check Out this Related Man Page