---
name: "pcp-rocestat"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pcp-rocestat"
---

# pcp-rocestat(1)

Reports statistics for nVidia RoCE devices.

## NAME

**pcp-rocestat** - Reports statistics for nVidia RoCE devices.

## SYNOPSIS

**pcp** \[*pcp options*\] **rocestat** *\[--hw\_stats\|--lane\_stats\]*

## DESCRIPTION

*The* **pcp-rocestat** *tool utilizes ethtool counters for each device and reports* *throughput per priority queue.* *By default* **pcp-rocestat** *reports live data for the local host.* *It has the ability to analyze data from PDP archives as well.*

## OPTIONS

- **--hw\_stats**

  *Display hardware counters.*

- **--lane\_stats**

  *Display lane statistics.*

- **-a** *archive*, **--archive**=*archive*

  Specify the PCP archive to examine.

- **-s** *samples*, **--samples**=*samples*

  Specify number of *samples* to report.

- **-S** *starttime*, **--start**=*starttime*

  Report the samples from the archive from the given time.

- **-T** *endtime*, **--finish**=*endtime*

  Report samples from the archive until the given time.

- **-V**, **--version**

  Display version number and exit.

- **-?**, **--help**

  Display usage message and exit.

## PCP ENVIRONMENT

Environment variables with the prefix **PCP\_** are used to parameterize the file and directory names used by PCP. On each installation, the file */etc/pcp.conf* contains the local values for these variables. The **$PCP\_CONF** variable may be used to specify an alternative configuration file, as described in [**pcp.conf**(5)](/pcp.conf/5.md).

For environment variables affecting PCP tools, see [**pmGetOptions**(3)](/pmGetOptions/3.md).

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md), [**pcp**(1)](/pcp/1.md), [**pmParseInterval**(3)](/pmParseInterval/3.md) and [**environ**(7)](/environ/7.md).