Re: [PATCH v2] mmap.2: MAP_FIXED updated documentation

From: Cyril Hrubis
Date: Mon Dec 04 2017 - 05:57:17 EST


Hi!
I know that we are not touching the rest of the existing description for
MAP_FIXED however the second sentence in the manual page says that "addr
must be a multiple of the page size." Which however is misleading as
this is not enough on some architectures. Code in the wild seems to
(mis)use SHMLBA for aligment purposes but I'm not sure that we should
advise something like that in the manpages.

So what about something as:

"addr must be suitably aligned, for most architectures multiple of page
size is sufficient, however some may impose additional restrictions for
page mapping addresses."

Which should at least hint the reader that this is architecture specific.

--
Cyril Hrubis
chrubis@xxxxxxx