Enum Resource

pub enum Resource {
    Fd(Fd),
    Process(Process),
    None,
}

Unified resource identifier for all trackable entities in the system.

Resources represent any entity that can participate in data flows within the traceability system. This includes file descriptors (which may point to files or streams), processes, or null resources for uninitialized states.

Variants

Fd(Fd)

File descriptor resource (file or stream)

Process(Process)

Process resource

None

Null or uninitialized resource

Implementations

impl Resource

pub fn new_file(path: String) -> Self

Creates a new file resource with the specified filesystem path.

The path is stored as provided without validation or normalization. Applications should provide valid paths to ensure proper resource tracking.

pub fn new_stream(local_socket: String, peer_socket: String) -> Self

Creates a new stream resource with the specified socket addresses.

Both local and peer socket addresses should be valid network addresses in the format appropriate for the protocol (e.g., “IP:port” for TCP).

pub fn new_process(pid: i32) -> Self

Creates a new process resource by querying the system for process information.

Attempts to retrieve the process start time and executable path from the system process table. If the process is not found, creates a process resource with default values for the metadata fields.

pub fn new_process_mock(pid: i32) -> Self

Creates a mock process resource for testing purposes.

Creates a process resource with the specified PID but default values for start time and executable path. Should only be used in test environments where system process queries are not needed.

pub fn is_file(&self) -> bool

Checks if this resource represents a filesystem file.

Returns true if the resource is a file descriptor pointing to a file, false for streams, processes, or null resources.

pub fn is_stream(&self) -> Option<Self>

Returns the reverse stream resource if this is a stream resource.

For stream resources, returns a new resource with the local and peer socket addresses swapped. This is useful for tracking bidirectional flows. Returns None for non-stream resources.

pub fn is_process(&self) -> bool

Checks if this resource represents a system process.

Returns true if the resource is a process, false for file descriptors or null resources.

Trait Implementations

impl Clone for Resource

fn clone(&self) -> Resource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Resource

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

Formats the value using the given formatter.

impl Default for Resource

fn default() -> Resource

Returns the “default value” for a type.

impl From<Resource> for Resource

Converts Protocol Buffer Resource to internal Resource type.

fn from(proto_resource: Resource) -> Self

Converts to this type from the input type.

impl From<Resource> for Resource

Converts internal Resource to Protocol Buffer Resource type.

fn from(resource: Resource) -> Self

Converts to this type from the input type.

impl Hash for Resource

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Resource

fn eq(&self, other: &Resource) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Resource

impl StructuralPartialEq for Resource