Next: How to use
addseverity, Previous: Printing Formatted Messages, Up: Formatted Messages [Contents][Index]
There is another possibility to introduce severity classes besides using
the environment variable
SEV_LEVEL. This simplifies the task of
introducing new classes in a running program. One could use the
putenv function to set the environment variable,
but this is toilsome.
Preliminary: | MT-Safe | AS-Unsafe heap lock | AC-Unsafe lock mem | See POSIX Safety Concepts.
This function allows the introduction of new severity classes which can be
addressed by the severity parameter of the
The severity parameter of
addseverity must match the value
for the parameter with the same name of
fmtmsg, and string
is the string printed in the actual messages instead of the numeric
If string is
NULL the severity class with the numeric value
according to severity is removed.
It is not possible to overwrite or remove one of the default severity
classes. All calls to
addseverity with severity set to one
of the values for the default classes will fail.
The return value is
MM_OK if the task was successfully performed.
If the return value is
MM_NOTOK something went wrong. This could
mean that no more memory is available or a class is not available when
it has to be removed.
This function is not specified in the X/Open Portability Guide although
fmtsmg function is. It is available on System V systems.