On Sat, Jan 20, 2018 at 12:01 PM, Heiko Carstens <heiko.carstens@xxxxxxxxxx> wrote: > On Sun, Jan 14, 2018 at 07:56:39PM +0100, Eugene Syromyatnikov wrote: >> * man2/s390_sthyi.2 (.SH DESCRIPTION): Document the size of the >> resp_buffer when function_code is 0. >> (.SH NOTES): Document various aspects of the current implementation (the >> lifted requirement for the response buffer alignment, the usage of >> hardware STHYI instruction whether available, the presence of in-kernel >> cache), add description for the documentation URL. >> --- >> +The in-kernel implementation of the function code 0 doesn't require the response >> +buffer to be aligned to a page boundary (in contrast to the STHYI instruction >> +requirement). > > Maybe: "When using the system call interface the response buffer doesn't > have to fulfill alignment requirements as described in the STHYI > instruction defintion." ? Yes, that sounds better. >> +.PP >> +The in-kernel implementation uses STHYI function whether available. >> +.PP > > I don't think this should be described in the man page. This is an > implementation detail that can change at any time. Agreed. >> +The kernel caches the response (for one second, currently), so the subsequent >> +calls to the system call within may return previously cached values instead. > > "The kernel caches the response up to one second. Subsequent system call > invocations may return the cached response." ? Yep, that's definitely phrased better. -- Eugene Syromyatnikov mailto:evgsyr@xxxxxxxxx xmpp:esyr@jabber.{ru|org} -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
