dce_svc_intro(3dce)
Introduction to the DCE serviceability interface
Description
The routines listed below are intended to be used by servers that export the serviceability interface defined in service.idl. The complete list of these
remote serviceability implementation calls is as follows (the remote operation name is given in the left column, and the corresponding implementation routine is given in the right column).
| dce_svc_set_route | dce_svc_routing |
| dce_svc_set_dbg_route | dce_svc_debug_routing |
| dce_svc_set_dbg_levels | dce_svc_debug_set_levels |
| dce_svc_inq_components | dce_svc_components |
| dce_svc_inq_table | dce_svc_table |
| dce_svc_filter_control | dce_svc_filter |
| dce_svc_inq_stats | dce_svc_inq_stats |
Note that most of these routines have little meaning except as implementations of remote operations. However, the dce_svc_routing( ), dce_svc_filter( ), dce_svc_debug_routing( ) and dce_svc_debug_set_levels( ) routines can conceivably be used by servers as purely local operations (for example, in order to allow routing and debug levels to be set via command line flags when the server is invoked).
The dce_svc_log_ routines provide read access to BINFILE format logs which are created and written by the DCE serviceability routines; see svcroute(5) for further information. The dce_svc_log_handle_t typedef is an opaque pointer to a handle for an opened log file.
Applications that use the serviceability interface can install a routine that will be effectively hooked into the operation of the interface. If a filter is installed, it will be called whenever one of the serviceability output routines (dce_svc_printf( )) is about to output a message; whenever this happens, the filter will receive a group of parameters that describe the message that is about to be output and the circumstances that provoked the action. The filter can then allow the message output to proceed, or suppress the message.
Along with the filter routine itself, the application also installs a filter control routine, whose purpose is to permit the behavior of the filter to be altered dynamically while the application is running. The dce_svc_filter( ) routine is the interface's call-in to such an installed filter control.
More:
The DCE Serviceability Routines