zephyr/doc/reference
Andy Ross 6564974bae userspace: Support for split 64 bit arguments
System call arguments, at the arch layer, are single words.  So
passing wider values requires splitting them into two registers at
call time.  This gets even more complicated for values (e.g
k_timeout_t) that may have different sizes depending on configuration.
This patch adds a feature to gen_syscalls.py to detect functions with
wide arguments and automatically generates code to split/unsplit them.

Unfortunately the current scheme of Z_SYSCALL_DECLARE_* macros won't
work with functions like this, because for N arguments (our current
maximum N is 10) there are 2^N possible configurations of argument
widths.  So this generates the complete functions for each handler and
wrapper, effectively doing in python what was originally done in the
preprocessor.

Another complexity is that traditional the z_hdlr_*() function for a
system call has taken the raw list of word arguments, which does not
work when some of those arguments must be 64 bit types.  So instead of
using a single Z_SYSCALL_HANDLER macro, this splits the job of
z_hdlr_*() into two steps: An automatically-generated unmarshalling
function, z_mrsh_*(), which then calls a user-supplied verification
function z_vrfy_*().  The verification function is typesafe, and is a
simple C function with exactly the same argument and return signature
as the syscall impl function.  It is also not responsible for
validating the pointers to the extra parameter array or a wide return
value, that code gets automatically generated.

This commit includes new vrfy/msrh handling for all syscalls invoked
during CI runs.  Future commits will port the less testable code.

Signed-off-by: Andy Ross <andrew.j.ross@intel.com>
2019-09-12 11:31:50 +08:00
..
bluetooth docs: fix misspelling across the tree 2019-06-19 15:34:13 -05:00
display doc: introduce final structure 2019-02-05 07:04:40 -05:00
drivers doc: drivers: add diagram and clarify a note 2019-08-29 17:33:56 -04:00
file_system doc: Add documentation for file system subsystem 2019-03-29 09:38:33 -04:00
kernel doc: mailbox: fix typos and clarify meaning of struct field 2019-09-07 10:01:34 -04:00
logging doc: add custom logger frontend description 2019-07-18 11:50:52 +02:00
misc jwt: Add JSON web token library 2019-02-08 15:32:58 -06:00
networking doc: net: ppp: Enhance PPP documentation 2019-08-14 08:28:46 +03:00
peripherals doc: introduce final structure 2019-02-05 07:04:40 -05:00
power_management doc: update power management subystem documentation 2019-03-26 13:27:55 -04:00
shell doc: shell: document Ctrl+N and Ctrl+P meta-keys 2019-06-24 07:17:53 -04:00
storage doc/reference/storage/settings: fix misleading examples 2019-08-09 17:40:59 +02:00
usb doc: Cleanup references to cmake 2019-06-17 10:09:57 -07:00
usermode userspace: Support for split 64 bit arguments 2019-09-12 11:31:50 +08:00
index.rst doc: move usermode under references 2019-03-26 09:50:16 -04:00