Module p2m

Process-to-Middleware (P2M) API service implementation.

This module provides the core service implementation for handling requests from application processes that need traceability tracking for their I/O operations. The P2M API is the primary interface through which applications integrate with the trace2e system.

Service Architecture

The P2mApiService acts as the central coordinator between four key services:

• Sequencer Service: Manages flow ordering and resource reservations
• Provenance Service: Tracks data provenance
• Compliance Service: Enforces policies and authorization decisions
• M2M Client: Communicates with remote middleware for distributed flows

Resource Management

The service maintains two primary data structures:

• Resource Map: Associates process/file descriptor pairs with source/destination resources
• Flow Map: Tracks active flows by grant ID for operation completion reporting

Operation Workflow

1. Enrollment: Processes register their files and streams before use
2. Authorization: Processes request permission for specific I/O operations
3. Execution: Middleware evaluates policies and grants/denies access
4. Reporting: Processes report completion status for audit trails

Cross-Node Coordination

For distributed flows involving remote resources, the service coordinates with remote middleware instances via the M2M API to ensure consistent policy enforcement and provenance tracking across the network.

Structs

P2mApiService

P2M (Process-to-Middleware) API Service.