On Wed, Jun 30, 2021 at 04:50:27PM -0600, Theo de Raadt wrote:
> 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.

Do you mean truncation or overflow?

Reply via email to