setlogmask sets a mask (the “logmask”) that determines which
syslog calls shall be ignored. If a program has not
syslog doesn't ignore any calls. You
setlogmask to specify that messages of particular
priorities shall be ignored in the future.
setlogmask call overrides any previous
Note that the logmask exists entirely independently of opening and
closing of Syslog connections.
Setting the logmask has a similar effect to, but is not the same as,
configuring Syslog. The Syslog configuration may cause Syslog to
discard certain messages it receives, but the logmask causes certain
messages never to get submitted to Syslog in the first place.
mask is a bit string with one bit corresponding to each of the
possible message priorities. If the bit is on,
messages of that priority normally. If it is off,
discards messages of that priority. Use the message priority macros
described in syslog; vsyslog and the
LOG_MASK to construct
an appropriate mask value, as in this example:
LOG_MASK(LOG_EMERG) | LOG_MASK(LOG_ERROR)
There is also a
LOG_UPTO macro, which generates a mask with the bits
on for a certain priority and all priorities above it:
The unfortunate naming of the macro is due to the fact that internally,
higher numbers are used for lower message priorities.