addseverity(3)

addseverity3

Introduce new severity classes

Usage


    

    
        

#include <fmtmsg.h>

int addseverity(int severity, const char *s);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

addseverity():

    Since glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 and earlier:
        _SVID_SOURCE

Library

Standard C library (libc, -lc)

Overview

This function allows the introduction of new severity classes which can be addressed by the severity argument of the fmtmsg(3) function. By default, that function knows only how to print messages for severity 0-4 (with strings (none), HALT, ERROR, WARNING, INFO). This call attaches the given string s to the given value severity. If s is NULL, the severity class with the numeric value severity is removed. It is not possible to overwrite or remove one of the default severity classes. The severity value must be nonnegative.

Return value

Upon success, the value MM_OK is returned. Upon error, the return value is MM_NOTOK. Possible errors include: out of memory, attempt to remove a nonexistent or default severity class.

Attributes

For an explanation of the terms used in this section, see attributes(7).

InterfaceAttributeValue
addseverity()Thread safetyMT-Safe

Notes

New severity classes can also be added by setting the environment variable SEV_LEVEL.

Releases

12 releases since Debian 3.1 (Sarge); the text changed 11 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8
  7. 9
  8. 10
  9. 11
  10. 12
  11. 13
  12. Arch

Standards

GNU.

History

glibc 2.1. System V.

From man-pages 6.19-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.