help.h File Reference

AERN Help and Guidance Functions. More...

#include "aerncommon.h"
#include "commands.h"
#include "resources.h"

Go to the source code of this file.

Functions
AERN_EXPORT_API void	aern_help_print_context (const char *prompt, aern_command_actions command)
	Print a help string associated with a command action.
AERN_EXPORT_API void	aern_help_print_mode (const char *prompt, aern_console_modes mode, aern_network_designations designation)
	Print a console prompt with help text for the current mode.

Detailed Description

AERN Help and Guidance Functions.

This header declares functions that provide context-sensitive help messages for the AERN console interface. These functions print help strings that explain available command actions and options based on the current console mode (e.g., configuration, enable, or user mode) and the device's network designation (e.g., APS, Client, ADC, ARS). The help functions make use of pre-defined help text strings (stored in the AERN_APPLICATION_HELP_STRINGS array) and output them using the QSC console utilities.

The primary functions provided in this module are:

• aern_help_print_context(): Prints a single help message associated with a specific command action.
• aern_help_print_mode(): Prints a set of help messages tailored to the current console mode and network designation.

These functions are essential for providing users with guidance on how to interact with the AERN system.

Function Documentation

aern_help_print_context()

AERN_EXPORT_API void aern_help_print_context	(	const char *	prompt,
		aern_command_actions	command )

Print a help string associated with a command action.

This function prints a context-specific help message corresponding to the given command action. The help string is printed using the provided console prompt.

Parameters

prompt	[in] The console prompt string.
command	The command action (from the aern_command_actions enumeration) for which to display help.

aern_help_print_mode()

AERN_EXPORT_API void aern_help_print_mode	(	const char *	prompt,
		aern_console_modes	mode,
		aern_network_designations	designation )

Print a console prompt with help text for the current mode.

This function prints a set of help messages that are appropriate for the current console mode and the server type designation. It guides the user by displaying available commands and their context based on whether the console is in configuration, enable, or user mode.

Parameters

prompt	[in] The console prompt string.
mode	The current console mode (from the aern_console_modes enumeration).
designation	The network designation (from the aern_network_designations enumeration) for which the help messages should be tailored.