Bug 181808 - Chapter 15.15 (Resource Limits) misses important information
Summary: Chapter 15.15 (Resource Limits) misses important information
Status: Closed Overcome By Events
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: Sergio Carlavilla Delgado
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-09-04 14:00 UTC by pl
Modified: 2023-09-27 17:05 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description pl 2013-09-04 14:00:00 UTC
Problem:

In order to further secure my system I've build a custom kernel and included the RACCT and RCTL options to provide support for rctl, I've basically followed chapter 15.15 from the Handbook:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/security-resourcelimits.html

In my opinion this chapter should either reference or copy the section about resource limits which can be found in chapter 14.4 of the handbook:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/users-limiting.html

I'm referring to (quote:) "Resource limits differ from the default login capabilities in two ways. First, for every limit...".

Motivation:

Because this section claims to be dealing with resource limits as a whole (when looking at the title) I was sort of expecting a section which would try to cover all its bases so to speak. In my opinion the section where it is explained that "most resource limits apply per process to a specific user, not to the user as a whole" is a very important aspect for people new to this.

Fix: 

Please note that these are only suggestions:

Above the line "To enable this feature.." (at the top) a small section could be added:

"Although the command is new the resource limits still comply to certain limitations as mentioned in chapter 14.14 of this handbook" (where "chapter 14.14" could be a link).

Another suggestion: at the bottom, after the line "See rctl(8) to learn about them" this could be added:

"Also see chapter 14.14 of this handbook which explains the differences between the default login capabilities and also provides a list of the most commonly used resource limits." (where "chapter 14.14" could also be a link).
Comment 1 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 08:01:34 UTC
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2021-12-28 13:45:09 UTC
(In reply to pl from comment #0)

<http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/users-limiting.html> now redirects to <https://docs.freebsd.org/en/books/handbook/users-limiting.html>, 404 not found. 

pl, would you like to review what's currently in the Handbook? Thanks.
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-09-27 17:05:36 UTC
I'm gonna close this PR as overcome by events.
We upgraded the chapter in this commit: https://cgit.freebsd.org/doc/commit/?id=99333306