Helix Core is now P4. Product user interfaces will be updated soon. Learn more >>

P4 CLI Reference | 2025.1

# p4 diagnostics

Generate diagnostic data about the P4 Server.

This command is a Technology Preview feature. Features offered in Technology Preview are experimental and not guaranteed to always work as expected. If you have feedback and functionality suggestions, email techpreview@perforce.com.

## Syntax

    p4 g-opts diagnostics [-L limit]
    p4 g-opts diagnostics [-l] [-s] [-a [-L limit]]

Syntax conventions

## Description

Introduced in 2024.2, the output format is subject to change. This command is currently intended for use under guidance by Perforce Support.

The first form of the command, `p4 `g-opts` diagnostics [-L limit]`, generates the basic diagnostic data and downloads it to a number of fixed named files in the current directory:

- `diags` - basic configuration details, configuration, configuration history, server setting, and checkpoint history.

- `monitor` - the monitor records, if monitoring is enabled.

- `topology` - a textual description of the network that contains this server.

- A copy of the current `journal` and `log` files, using the configured names of these files.

The second form of the command, `p4 `g-opts` diagnostics [-l] [-s] [-a [-L limit]]`, provides information that might take more time and require more server resources.

## Options

`-L limit` | Limit the download size of the journal and log files to the last `limit` number of bytes of these files, subject to buffer rounding. The `limit` is in bytes and can be suffixed with a single character to designate a unit multiplier: `k` or `K` for kilobytes, `m` or `M` for megabytes, `g` or `G` for gigabytes, and `t` or `T` for terabytes.
`-l` | Request that the `/usr/bin/lsof` be run to provide locking details of all files in use by P4 Servers on this system. The data from this operation is downloaded into a file named `manuallocks` in the current directory. This option is not supported on Windows.
`-s` | Run an `strace` command on the server processes for 20 seconds and downloads the trace output to a file named `strace` in the current directory. This option is not yet supported on any platform.
-a | Request that the basic diagnostic files of `p4 `g-opts` diagnostics [-L limit]` be produced. Without this option, those files are omitted with the `-l` and `-s` options.

## Usage notes

Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required
--- | --- | ---
N/A | N/A | `admin` available to an operator user

Your search for returned results