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) -> bool

Checks if this resource represents a network stream.

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

pub fn into_localized(self, localization: String) -> LocalizedResource

Converts this resource into a localized resource given the specified localization.

It attempts to convert the resource into a localized stream resource, which infers the peer node from the stream’s peer socket. Otherwise, it creates a localized resource with the specified localization..

pub fn try_into_localized_peer_stream(&self) -> Option<LocalizedResource>

Returns the peer 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 Display for Resource

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

Formats the value using the given formatter.

impl From<Resource> for Resource

Converts Protocol Buffer Resource to internal Resource type.

fn from(req: 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 TryFrom<&str> for Resource

fn try_from(s: &str) -> Result<Self, Self::Error>

Parse a resource string (without node_id) into a Resource.

Supports the following formats:

• file:///path - File resource
• stream://local::peer - Stream resource

type Error = TraceabilityError

The type returned in the event of a conversion error.

impl TryFrom<String> for Resource

type Error = TraceabilityError

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Resource

impl StructuralPartialEq for Resource