CAP_WHATIF

Return to Home page

CAP_WHATIF

Return to Home page
The CAP_WHATIF feature provides a configuration troubleshooting / validation tool to Syslogd2. This feature had its genesys in early troubleshooting displays of internal structures, but as features were added and configurations grew more complex, this feature grew more crucial to configuration troubleshooting. Because of its size and the fact that it is not needed for the majority of configurations expected in the field, it has been split off into an optional capability.

CAP_WHATIF enables the --Testconfig command-line option. It also enables the DisplayConfig interrupt routine and command-tool option.

The DisplayConfig interrupt routine will always print the full (running) configuration display to the defined output file. The interactive command-tool display is menu-driven to print selected (currently running) display sections to a choice of locations.
There are 3 points during startup at which a configuration may be displayed. The --TestConfig command-line option is used to display the startup configurations. THis option actually runs through the actual startup process to the desired point, displays the configuration and immediately exits.

The interrupt routine always displays the copmlete (currently-running) configuration to the defined stdout file. The command-tool configuration display is men-driven and will display selected sections to screen (via command-tool), stderr or stdout files.. It requires the CAP_STREAMIN, CAP_HOUSEKEEPING and CAP_COMMAND features.
The --TestConfig command-line option takes 0 to 4 parameters as summarized here.
Return to Home page