dxmhelpsystemdisplay(3x) [osf1 man page]
DXmHelpSystemDisplay(3X) DXmHelpSystemDisplay(3X) NAME
DXmHelpSystemDisplay - Displays a topic or directory of the help file in Bookreader. SYNOPSIS
void DXmHelpSystemDisplay( Opaque help_context, char *help_file, char *keyword, char *name, void ((*routine )()), Opaque tag ); PARAMETERS
Used by the DECwindows Motif Help System to pass required LinkWorks and help information from one routine to another. Optional. The file name of the help file. If Null or is supplied, Bookreader will use the help file name passed in to the DXmHelpSystemOpen routine; otherwise a new file name can be passed. One of two values: "topic" or "dir". Pointers to these strings can be passed instead. The topic symbol from the help callback if "topic" is used for the keyword. If "dir" is used, then name refers to the name of the Bookreader directory that should be opened, such as "Contents" or "Index". Either specific strings or pointers to strings may be passed in. Used for error process- ing. If an error occurs within the DECwindows Motif Help System and it cannot be processed by either LinkWorks or Bookreader, the DECwin- dows Motif Help System calls the error processing routine you have included in your application and passes in an integer, or status, to indicate the status of the error processing operation, as follows: -------------------------------------------------------------------- Value Description -------------------------------------------------------------------- 1 The DECwindows Motif Help System could not find the LinkWorks shareable image. 2 The DECwindows Motif Help System could not translate a specified value into a valid file specification. -------------------------------------------------------------------- Note the following: The status parameter is a system-supplied parameter that supplements the routine and tag parameters you have already specified in the application. If an error cannot be processed by either LinkWorks or Bookreader and you have not specified a supplementary error handling routine, your system will generate an access violation error message. The parameter you supply to the previously described routine parameter. Associating a tag with the routine enables you to more easily determine where errors occur. DESCRIPTION
Note This routine is not supported on all operating systems. The DXmHelpSystemDisplay routine (which you use instead of a call to the help widget) displays a topic or directory of the help file in Bookreader, using the DECwindows Motif Help System. This routine can also be used to display topics or directories of books other than the ones passed in to DXmHelpSystemOpen. SEE ALSO
DXmHelpSystemDisplay(3X), DXmHelpSystemOpen(3X) DXmHelpSystemDisplay(3X)
Check Out this Related 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)