Expand description
Resource naming and identification system.
This module defines the core resource identification and naming conventions used throughout the trace2e traceability system. It provides a unified way to represent and identify different types of computational resources including files, network streams, and processes.
§Resource Hierarchy
File Descriptors (Fd): Represent operating system file descriptors that can point to either files in the filesystem or network streams (sockets).
Files: Filesystem resources identified by their path, supporting both absolute and relative path specifications.
Streams: Network communication channels defined by local and peer socket addresses, supporting TCP connections, Unix domain sockets, and other network protocols.
Processes: Running system processes identified by PID with additional metadata including start time and executable path for precise identification across process reuse.
§Resource Construction
Resources can be constructed using dedicated factory methods that handle system queries and validation, or using mock variants for testing purposes.
Structs§
- File
- Represents a file resource in the filesystem.
- Process
- Represents a running system process with identifying metadata.
- Stream
- Represents a network stream or socket connection.
Enums§
- Fd
- Represents a file descriptor that can point to either a file or a stream.
- Resource
- Unified resource identifier for all trackable entities in the system.
Traits§
- NodeId
- Trait for services that have a node identifier in distributed systems.