Struct zircon_object::task::ExceptionObject

pub struct ExceptionObject { /* fields omitted */ }

The exception object received from the exception channel.

This will be transmitted to registered exception handlers in userspace and provides them with exception state and control functionality. We do not send exception directly since it’s hard to figure out when will the handle close.

Implementations

impl ExceptionObject

pub fn get_thread_handle(&self) -> Handle

Create a handle for the exception’s thread.

pub fn get_process_handle(&self) -> ZxResult<Handle>

Create a handle for the exception’s process.

pub fn state(&self) -> u32

Get whether closing the exception handle will finish exception processing and resume the underlying thread.

pub fn set_state(&self, state: u32) -> ZxResult

Set whether closing the exception handle will finish exception processing and resume the underlying thread.

pub fn strategy(&self) -> u32

Get whether the debugger gets a ‘second chance’ at handling the exception if the process-level handler fails to do so.

pub fn set_strategy(&self, strategy: u32) -> ZxResult

Set whether the debugger gets a ‘second chance’ at handling the exception if the process-level handler fails to do so.

Trait Implementations

impl Debug for ExceptionObject

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Drop for ExceptionObject

fn drop(&mut self)

Executes the destructor for this type.

impl KernelObject for ExceptionObject

fn id(&self) -> KoID

Get object’s KoID.

fn type_name(&self) -> &str

Get the name of the type of the kernel object.

fn name(&self) -> String

Get object’s name.

fn set_name(&self, name: &str)

Set object’s name.

fn signal(&self) -> Signal

Get the signal status.

fn signal_set(&self, signal: Signal)

Assert signal.

fn signal_clear(&self, signal: Signal)

Deassert signal.

fn signal_change(&self, clear: Signal, set: Signal)

Change signal status: first clear then set indicated bits.

fn add_signal_callback(&self, callback: SignalHandler)

Add callback for signal status changes.

fn get_child(&self, _id: KoID) -> ZxResult<Arc<dyn KernelObject>>

Attempt to find a child of the object with given KoID.

fn peer(&self) -> ZxResult<Arc<dyn KernelObject>>

Attempt to get the object’s peer.

fn related_koid(&self) -> KoID

If the object is related to another (such as the other end of a channel, or the parent of a job), returns the KoID of that object, otherwise returns zero.

fn allowed_signals(&self) -> Signal

Get object’s allowed signals.