docs/98974: Missing tunables in loader(8) manpage

>Number:         98974
>Category:       docs
>Synopsis:       Missing tunables in loader(8) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jun 15 08:50:16 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Jelte Jansen
>Release:        6.*
>Organization:
NLnet Labs
>Environment:
FreeBSD alpha.nlnetlabs.nl 6.0-RELEASE FreeBSD 6.0-RELEASE #0: Thu Nov  3 09:36:13 UTC 2005     root@x64.samsco.home:/usr/obj/usr/src/sys/GENERIC  i386

>Description:

Some tunables (at least kern.maxdsiz, to set the maximum allowed datasize for processes which defaults to 512 mb) are not documented in any manual page i could find. These would probably go in loader(8). The only place i found where it is even mentioned is /boot/defaults/loader.conf, but the information there is too sparse to know what values to use and what it's for.

>How-To-Repeat:
man loader

(no mention here)

grep maxdsiz /usr/src/sys/kern/subr_param.c

(is is a tunable)
>Fix:

Add text to the manpage, i propose something like:

kern.maxdsiz      Set the maximum allowed datasize resource limit for processes. This value defaults to 512 megabytes. The value should be entered in number of bytes, without modifiers. The value may not exceed addressable space.

But someone else can probably do a better job, i'm not sure if the no modifiers is still necessary.

There are probably other tunables that are not mentioned yet.

>Release-Note:
>Audit-Trail:
>Unformatted:
_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"