err_append, err_get - error message generation and retrieval
void err_append(const char *msg);
These functions create, modify, and retrieve a global error string. err_append appends msg to the global error string.
err_append does not terminate messages with newlines. The caller should normally do this.
err_append will cause the process to abort if it cannot allocate memory for the global error message.
err_get returns the global error string and then resets it, so that subsequent calls to err_append over write the pre- vious contents. The value returned by err_get belongs to the error message facility and should not be modified by users.
The error message is limited to 64 kilobytes. If it becomes longer than this, the application prints a warning fol- lowed by the current error message, and then the application exits.
Gordon Carrie (dev0 at this site)