p4 diagnostics

Generate diagnostic data about the Helix Core Server.

Note

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 [email protected].

Syntax

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

Syntax conventions

Description

Important

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 Helix Core 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