svn commit: r367048 - head/lib/libc/sys

[John-Mark Gurney]

Cy Schubert wrote this message on Sun, Oct 25, 2020 at 18:04 -0700:
> In message <202010260059.09Q0xbxt003944 at slippy.cwsent.com>, Cy Schubert 
> writes:
> > In message <202010260037.09Q0bVpN090953 at repo.freebsd.org>, John-Mark Gurney 
> > wri
> > tes:
> > > Author: jmg
> > > Date: Mon Oct 26 00:37:31 2020
> > > New Revision: 367048
> > > URL: https://svnweb.freebsd.org/changeset/base/367048
> > >
> > > Log:
> > >   update write(2)'s iovec limit w/ info about the iosize_max_clamp sysctl..
> > .
> > >
> > > Modified:
> > >   head/lib/libc/sys/write.2
> > >
> > > Modified: head/lib/libc/sys/write.2
> > > ===========================================================================
> > ==
> > > =
> > > --- head/lib/libc/sys/write.2	Sun Oct 25 23:26:07 2020	(r36704
> > 7)
> > > +++ head/lib/libc/sys/write.2	Mon Oct 26 00:37:31 2020	(r36704
> > 8)
> > > @@ -28,7 +28,7 @@
> > >  .\"     @(#)write.2	8.5 (Berkeley) 4/2/94
> > >  .\" $FreeBSD$
> > >  .\"
> > > -.Dd March 30, 2020
> > > +.Dd October 25, 2020
> > >  .Dt WRITE 2
> > >  .Os
> > >  .Sh NAME
> > > @@ -240,9 +240,13 @@ array was negative.
> > >  .It Bq Er EINVAL
> > >  The sum of the
> > >  .Fa iov_len
> > > -values in the
> > > -.Fa iov
> > > -array overflowed a 32-bit integer.
> > > +values is greater than
> > > +.Dv SSIZE_MAX
> > > +(or greater than
> > > +.Dv INT_MAX ,
> > > +if the sysctl
> > > +.Va debug.iosize_max_clamp
> >
> > Should we also include SEE ALSO reference to sysctl(8) or sysctl(3)? 
> > Personally I think a reference to  sysctl(8) would be more apropos.
> 
> Or maybe both.

Yeah, I was thinking the same thing myself, but decided to go with a
minimal change.  I was thinking of making the mention of sysctl in the
body an Xr in addition to a SEE ALSO, but I couldn't decide which of 3
or 8.  I guess the Xr in the body would be 3.

-- 
  John-Mark Gurney				Voice: +1 415 225 5579

     "All that I will do, has been done, All that I have, has not."