Page MenuHomeFreeBSD

Describe FreeBSD's virtual memory in memory(7)
Needs ReviewPublic

Authored by 0mp on Jan 7 2019, 11:00 AM.

Details

Reviewers
bcr
markj
avg
koobs
jhb
Group Reviewers
manpages
Summary
Describe FreeBSD's virtual memory in memory(7)

This manual page is based on the Memory article
from our wiki: https://wiki.freebsd.org/action/recall/Memory
Test Plan

igor, mandoc

Diff Detail

Repository
rS FreeBSD src repository
Lint
Lint OK
Unit
No Unit Test Coverage
Build Status
Buildable 21859
Build 21108: arc lint + arc unit

Event Timeline

0mp created this revision.Jan 7 2019, 11:00 AM
0mp edited the summary of this revision. (Show Details)Jan 7 2019, 11:00 AM
0mp added a subscriber: docs.

First of all: big thanks for creating this man page. I think it is good to have for non-developers and eventually moving the info out of the wiki into a man page.

I'd like to add a few more people (i.e. the ones who edited that wiki page) to get more technical review. I'm also adding John Baldwin who did the tech review for the "Absolute FreeBSD 3rd edition" book, since there are a couple of places where memory is described in lay-mans terms (i.e. the top section). Together with the others, we could fill in some gaps that might be there or add some more explanations when needed.

share/man/man7/memory.7
36

s/for non-developer audience/for a non-developer audience/

115

"Scans check" sounds wrong here (it's from the original). I think it should just be "check" or even "checks" since the scan is appearing again at the end of the sentence.

0mp updated this revision to Diff 52624.Jan 7 2019, 1:13 PM
  • Break long lines.
  • Fix some grammar mistakes reported by @bcr.
0mp marked an inline comment as done.Jan 7 2019, 1:14 PM
danfe added a subscriber: danfe.Fri, Mar 1, 3:18 AM

Thanks for doing this, greatly appreciated! May I also suggest we add how do FreeBSD memory terms correlate and/or can be translated for those coming from GNU/Linux (their top(1) reports total, used, free, and buffers) or Windows environments (reserved vs. committed, see this question). This would make porting software that wants to obtain memory status much easier.

0mp added a comment.Tue, Mar 5, 6:42 PM

Thanks for doing this, greatly appreciated! May I also suggest we add how do FreeBSD memory terms correlate and/or can be translated for those coming from GNU/Linux (their top(1) reports total, used, free, and buffers) or Windows environments (reserved vs. committed, see this question). This would make porting software that wants to obtain memory status much easier.

Great idea. I think we can work on it in a separate revision to stay focused.