diff options
| author | Flavio Cruz <flaviocruz@gmail.com> | 2023-03-13 01:41:57 -0400 |
|---|---|---|
| committer | Samuel Thibault <samuel.thibault@ens-lyon.org> | 2023-03-13 20:26:26 +0100 |
| commit | 5447f965f1e109f7ac9aeb91c0e3906969a4adb8 (patch) | |
| tree | b3571bc9da00758100f7bbe8d1a886948933173c /doc | |
| parent | bba59e0f7a3cf1a008325b7919e9eb8a170c7c0a (diff) | |
Use c_string to define host_get_kernel_version and host_get_kernel_boot_info.
The existing definitions for kernel_version_t and kernel_boot_info_t use
(MACH_MSG_TYPE_STRING, length*8) which result in message types that have
a single element of 512 or 4096 bytes (set as msgt_size). This results
in MiG generating mach_msg_type_long_t. Using c_string has the benefit
of moving this size to be defined as msgt_number which doesn't overflow.
This will allow us to simplify the 64 bit RPC ABI since all msgt_size can
be defined with just 8 bits (as it should be expected).
The resulting implementation is the same but we still need to define new
RPCs since server and user expect different mach_msg_type_t.
Message-Id: <ZA63pS8j9J6NwuXY@jupiter.tail36e24.ts.net>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/mach.texi | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/doc/mach.texi b/doc/mach.texi index 3fdba3fc..2c22fa38 100644 --- a/doc/mach.texi +++ b/doc/mach.texi @@ -5577,8 +5577,8 @@ The minimum quantum and unit of quantum in milliseconds. This is a pointer to a @code{struct host_sched_info}. @end deftp -@deftypefun kern_return_t host_kernel_version (@w{host_t @var{host}}, @w{kernel_version_t *@var{version}}) -The @code{host_kernel_version} function returns the version string +@deftypefun kern_return_t host_get_kernel_version (@w{host_t @var{host}}, @w{kernel_version_t *@var{version}}) +The @code{host_get_kernel_version} function returns the version string compiled into the kernel executing on @var{host} at the time it was built in the character string @var{version}. This string describes the version of the kernel. The constant @code{KERNEL_VERSION_MAX} should be @@ -5595,8 +5595,8 @@ inaccessible memory, it returns @code{KERN_INVALID_ADDRESS}, and @code{KERN_SUCCESS} otherwise. @end deftypefun -@deftypefun kern_return_t host_get_boot_info (@w{host_priv_t @var{host_priv}}, @w{kernel_boot_info_t @var{boot_info}}) -The @code{host_get_boot_info} function returns the boot-time information +@deftypefun kern_return_t host_get_kernel_boot_info (@w{host_priv_t @var{host_priv}}, @w{kernel_boot_info_t @var{boot_info}}) +The @code{host_get_kernel_boot_info} function returns the boot-time information string supplied by the operator to the kernel executing on @var{host_priv} in the character string @var{boot_info}. The constant @code{KERNEL_BOOT_INFO_MAX} should be used to dimension storage for the |