zx_restricted_write_state

Summary

Set restricted mode state on the current thread.

Declaration

#include <zircon/syscalls-next.h>

zx_status_t zx_restricted_write(const void *state,
                                size_t state_size);

Description

Sets the restricted mode register state on the current thread according to the structure passed.

The state structure is defined below (and in syscalls-next.h)

   typedef struct zx_restricted_state {
#if __aarch64__
     uint64_t x[31];
     uint64_t sp;
     // Contains only the user-controllable upper 4-bits (NZCV).
     uint32_t cpsr;
     uint8_t padding1[4];
#elif __x86_64__
     // User space active registers
     uint64_t rdi, rsi, rbp, rbx, rdx, rcx, rax, rsp;
     uint64_t r8, r9, r10, r11, r12, r13, r14, r15;
     uint64_t ip, flags;

     uint64_t fs_base, gs_base;
#endif
   } zx_restricted_state_t;

Rights

None

Return value

In the event of failure, a negative error value is returned.

Errors

ZX_ERR_INVALID_ARGS Invalid pointer to state or length is incorrect.