| ## 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
These routines perform all the necessary processing (except for checking clients' authorization) that must be done by the application manager to implement the remote serviceability operations. 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 Data Types and Structures Files Related Information ####