Input flags

Input flags.

These flags control the operation of subsequent input operations.

INF_HELP

High-level menuing and data-validation functions will return the default help action (option `?') to the caller so they can provide their own `help' functionality. If INF_HELP is not set, then the high-level entry/validation functions will deal with help requests on their own, typically printing a longer version of a menu or redisplaying a full prompt.

INF_PASSWD

The mid-level inp_get() function will echo stars instead of the characters typed. This is intended for password entry. This flag is cleared after calling an input function. This is meant to prevent normal data input operations from echoing asterisks because of programmer oversight or bug.

INF_REPROMPT

This variable is set to a non-zero value by the low-level input functions when the user is `injected' with a paged message from another user (or the system). Traditional Major BBS behaviour simulated a carriage return in such cases. We just flag such events and let the caller deal with them. You must always check this value (use the inp_reprompt() function) in mid-to-high-level functions, to see if you need to reprompt the user. You must reprompt the user after an injected message, because the previous prompt may have scrolled off the screen, or it just might be out of context.

INF_NOINJOTH

Disables processing of incoming injoth() injected messages. In this state, the user will not receive pages, audit entries, et cetera. You should use this only when it's necessary. The user should not be cut off from other users and the system for too long.

INF_TIMEOUT

Is set by inp_readstring() to indicate that it exited because of a timeout arranged by inp_timeout() or a signal handler.

INF_HELP

High-level help requests to be handled by caller.

INF_PASSWD

Echo asterisks (for password entry)

INF_REPROMPT

You must reprompt, injoth() received

INF_NOINJOTH

Set to disable incoming injoth()s

INF_TIMEOUT

Set to indicate that a timeout occurred

Alphabetic index