Date: Wed, 30 Mar 2022 15:56:47 -0400 From: grarpamp <grarpamp@gmail.com> To: freebsd-doc@freebsd.org Cc: freebsd-hackers@freebsd.org, freebsd-questions@freebsd.org Subject: Sysctl Undoc Problem [was: vfs.nfsd.tcphighwater] Message-ID: <CAD2Ti29H46EE7uQJXFFdhJkUF6Bs-mXG55tXz6cPu_qFfP1FOw@mail.gmail.com>
next in thread | raw e-mail | index | archive | help
> the lack of documentation leaves me wondering what to do > ... > Then there's no indication of what value should be reasonable. In fact it's not even clear what unit we are talking about (bytes? kB? some unspecified count?). > If vfs.nfsd.tcphighwater had a starting value I could think about doubling it, raising it tenfold or whatever; alas it's default value is 0. > Some forums show people used some apparently random value like 300000, while admitting they had no idea what they were doing. Too many undoc sysctl exist. No one should be allowed to commit a new sysctl without documenting its rationale and usage in the same commit, to respective doc files. Existing should be surveyed and reformed. Beneficial thing is sysctl could be made programmatic enough to collate all of them into a table denoting documentation element checkmarks for each, distribute doc effort to subgroups, etc. Maybe some effort already exist to do this.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAD2Ti29H46EE7uQJXFFdhJkUF6Bs-mXG55tXz6cPu_qFfP1FOw>