Page MenuHomeFreeBSD

Update FAQs 10.21 and 10.22
ClosedPublic

Authored by pauamma_gundo.com on Apr 18 2020, 6:29 PM.
Tags
None
Referenced Files
Unknown Object (File)
Mar 28 2024, 1:51 PM
Unknown Object (File)
Dec 23 2023, 11:27 AM
Unknown Object (File)
Nov 19 2023, 3:57 AM
Unknown Object (File)
Nov 19 2023, 2:20 AM
Unknown Object (File)
Nov 19 2023, 2:19 AM
Unknown Object (File)
Nov 19 2023, 1:56 AM
Unknown Object (File)
Nov 10 2023, 8:26 PM
Unknown Object (File)
Nov 8 2023, 8:17 PM
Subscribers
None

Details

Summary
  • remove mentions of cache queue
  • introduce laundry queue
  • copyedit definition of free memory in FAQ 10.22

PR: 242062

Test Plan

tested with lynx

Diff Detail

Repository
rD FreeBSD doc repository - subversion
Lint
No Lint Coverage
Unit
No Test Coverage
Build Status
Buildable 30588
Build 28329: arc lint + arc unit

Event Timeline

Syntactically and lexicographically, this makes sense to me.
As to whether it matters kernel-defined behavior, that's outside my area of expertise.

en_US.ISO8859-1/books/faq/book.xml
4029

Let's remove the "in the interrupt or process states" qualifier. It is referring to a mechanism we use in the page allocator to reserve free pages for high-priority allocations, but that is just an implementation detail and no longer has anything to do with the "state" being referred to.

4040

"active or inactive"

4045

Let's replace "whether they are active or inactive" with "regardless of their location in the page queues" or something similar.

4046

s/inactive/laundry/

And perhaps update the description of the inactive queue:

"In most common cases, it is best to think of the laundry queue to be a queue of relatively unused, dirty pages that might or might not be in the process of being written to disk. The inactive queue contains a mix of clean and dirty pages; clean pages near the head of the queue are reclaimed immediately to alleviate a free page shortage, and dirty pages are moved to the laundry queue for deferred processing."

Feel free to reword, this is just a suggestion.

4049

Again let's remove this qualifier, or perhaps even the whole sentence.

4068

Maybe qualify with "some other reserved pages".

This should address all of markj's comments.

The patch looks reasonable to me. Thanks for doing this!

This revision is now accepted and ready to land.Apr 20 2020, 9:32 PM

Thanks for reviewing it. Can a docs committer (I'm not one) take care of it?

This revision was automatically updated to reflect the committed changes.