Todd C. Miller <mill...@openbsd.org> wrote:

> On Thu, 01 Jul 2021 00:14:12 +0200, Ingo Schwarze wrote:
> 
> > Can the current wording below CAVEATS, "confusing behavior", be made
> > more precise, explaining what actually happens rather than merely
> > calling it "confusing"?  For example, saying that they all override
> > each other or something like that?  Or saying that behavior is
> > undefined when more than one of them is used (isn't that what POSIX
> > says)?
> 
> Yes, POSIX says interactions between them are unspecified.

Maybe something like this -- telling people what actually happens

1) makes them aware A uses B

2) explains the mechanism instead of vague handwaving

.Sh DESCRIPTION
-.Bf -symbolic
-This is a simplified interface to
-.Xr setitimer 2 .
-.Ef
+.Fn alarm
+is a simple interface using the
+.Va ITIMER_REAL
+timer with
+.Xr settimer 2 .

ualarm needs a more careful description, maybe starting with this.

.Sh DESCRIPTION
-.Bf -symbolic
-This is a simplified interface to
-.Xr setitimer 2 .
-.Ef
+.Fn ualarm
+is a simple interface using the
+.Va ITIMER_REAL
+timer with
+.Xr settimer 2 .
+Exceedingly large timing arguments are succeptable to truncation.


Rough warning feels like it is enough.

Reply via email to