Enum Auditable 

pub enum Auditable<'a> {
    AuditContext(&'a [Auditable<'a>]),
    Bug(u64),
    CurrentTask,
    DirEntry(&'a DirEntry),
    FileObject(&'a FileObject),
    FileSystem(&'a FileSystem),
    FsNode(&'a FsNode),
    IoctlCommand(u16),
    Location(&'a Location<'a>),
    Name(&'a FsStr),
    NamespaceNode(&'a NamespaceNode),
    NlMsgtype(u16),
    None,
    SockOptArguments(u32, u32),
    Task(&'a Task),
    TodoCheck,
}

Container for a reference to kernel state from which to include details when emitting audit logging. Auditable instances are created from references to objects via into(), e.g:

fn my_lovely_hook(current_task: &CurrentTask, …) { let audit_context = current_task.into(); check_permission(…, audit_context) }

Call-sites which need to include context from multiple sources into audit logs can do so by creating an array of Auditable instances from those sources, and using into() to create an Auditable from a reference to that array, e.g:

fn my_lovelier_hook(current_task: &CurrentTask,…, audit_context: Auditable<’_>) { let audit_context = [audit_context, current_task.into()]; check_permission(…, (&audit_context).into()) }

Auditable instances are parameterized with the lifetime of the references they contain, which will be automagically derived by Rust. Since they only consist of a type discriminator and reference they are cheap to copy, avoiding the need to pass them by-reference if the same context is to be applied to multiple permission checks.

Variants

AuditContext(&'a [Auditable<'a>])

Bug(u64)

CurrentTask

DirEntry(&'a DirEntry)

FileObject(&'a FileObject)

FileSystem(&'a FileSystem)

FsNode(&'a FsNode)

IoctlCommand(u16)

Location(&'a Location<'a>)

Name(&'a FsStr)

NamespaceNode(&'a NamespaceNode)

NlMsgtype(u16)

None

SockOptArguments(u32, u32)

Task(&'a Task)

TodoCheck

Trait Implementations

impl<'a> Clone for Auditable<'a>

fn clone(&self) -> Auditable<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Display for Auditable<'_>

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

Formats the value using the given formatter.

impl<'a, const N: usize> From<&'a [Auditable<'a>; N]> for Auditable<'a>

fn from(value: &'a [Auditable<'a>; N]) -> Self

Converts to this type from the input type.

impl<'a> From<&'a Arc<DirEntry>> for Auditable<'a>

fn from(value: &'a DirEntryHandle) -> Self

Converts to this type from the input type.

impl<'a> From<&'a CurrentTask> for Auditable<'a>

fn from(_value: &'a CurrentTask) -> Self

Converts to this type from the input type.

impl<'a> From<&'a DirEntry> for Auditable<'a>

fn from(value: &'a DirEntry) -> Self

Converts to this type from the input type.

impl<'a> From<&'a FileObject> for Auditable<'a>

fn from(value: &'a FileObject) -> Self

Converts to this type from the input type.

impl<'a> From<&'a FileSystem> for Auditable<'a>

fn from(value: &'a FileSystem) -> Self

Converts to this type from the input type.

impl<'a> From<&'a FsNode> for Auditable<'a>

fn from(value: &'a FsNode) -> Self

Converts to this type from the input type.

impl<'a> From<&'a Location<'a>> for Auditable<'a>

fn from(value: &'a Location<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<&'a NamespaceNode> for Auditable<'a>

fn from(value: &'a NamespaceNode) -> Self

Converts to this type from the input type.

impl<'a> From<&'a Task> for Auditable<'a>

fn from(value: &'a Task) -> Self

Converts to this type from the input type.

impl<'a> Copy for Auditable<'a>