pxltop User Guide

pxltop is a command-line resource monitoring tool for CXL devices, inspired by tools like top. It provides real-time insights into CXL devices and the client processes utilizing them — all within a terminal interface.

---

Overview

pxltop is part of the PXL Resource Monitor system and offers visibility into:

• CXL device status and resource usage
• Client processes interacting with the CXL devices

---

Key Features

• Live Monitoring: Track real-time stats on CXL device usage.
• Device Overview: View SUB utilization and memory usage per CXL device.
• Process Insight: Monitor which processes are using each CXL device and how.

---

Usage

Basic Launch

pxltop

This command starts the interactive monitoring session.

Controls

Key	Function
d	Toggle detailed view (per-process information)
q	Exit pxltop
i	Change Refresh Interval (s)

---

Output Overview

The terminal interface is split into two sections:

Devices Panel

Displays metrics for each managed CXL device, including:

• Device ID
• Total and available SUB
• Total and available memory

Processes Panel

For each process using a CXL device:

• PID, command name, user
• Allocated devices and SUBs per process
• Memory usage on CXL

---