Re: [PATCH] show message when exceeded rlimit of pending signals

[Roland McGrath <roland@redhat.com>]

I have nothing in particular against the logging.  (However, to me it seems
a little odd to use system-wide logging for normal well-defined error cases
of individual programs.)  This seems to me primarily like a failure of
documentation.

If you'd asked me off hand what EAGAIN from timer_create could mean, I
would have told you right off that you have too many timers or too many
aggregate queued signals.  I'm a person who would happen to know, of
course.  But also, if you look in POSIX.1 for the timer_create definition,
under ERRORS it says:

      [EAGAIN] The system lacks sufficient signal queuing resources to
      	       honor the request.
      [EAGAIN] The calling process has already created all of the timers it
      	       is allowed by this implementation.

Now that is a little vague about it potentially relating to the
RLIMIT_SIGPENDING limit (which is not a POSIX.1 feature, though exactly the
sort of thing permitted by the "is allowed by this implementation" clause).
But it certainly points you in some reasonable directions so this doesn't
seem like it would be such a mystery.

But it's certainly unfortunate that man-pages-3.19 for timer_create has only:

       -EAGAIN
              The system could not process the request.

That description is basically content-free, it applies equally to any
potential error from any call.


Thanks,
Roland