p4 monitor

Synopsis

Display Perforce process information

Syntax


p4 [g-opts] monitor show [ -a ] [ -e ] [ -l ] [-s R|T|P|I ]
p4 [g-opts] monitor terminate id
p4 [g-opts] monitor clear id
p4 [g-opts] monitor clear all
p4 [g-opts] monitor pause id
p4 [g-opts] monitor resume id

Description

p4 monitor allows a system administrator to observe what Perforce-related processes are running on the Perforce server machine. Each line of output consists of the following fields:

pid status owner hh:mm:ss command [args]

where pid is the process ID under UNIX (or thread ID under Windows), status is R or T depending on whether the process is running or marked for termination, owner is the Perforce user name of the user who invoked the command, hh:mm:ss is the time elapsed since the command was called, and command and args are the command and arguments as received by the Perforce service.

To list current process information, use p4 monitor show. By default, all processes are listed, but only the command (for example, sync, edit, submit) is shown, without arguments. This form of p4 monitor requires list level access. Use the -s status (where status refers to Running, Terminated, Paused, or Idle processes) to restrict the display to processes in the specified state.

To show the list of arguments associated with each command, use the -a (arguments) flag or -l (long) flag. For additional information from the user environment, use the -e (environment) flag. These options require admin level access.

To mark a process for termination, use p4 monitor terminate id. This command requires super level access.

To remove an entry from the monitor table, use p4 monitor clear id. You can clear the entire table with p4 monitor clear all. Both of these commands require super level access.

Long-running tasks such as p4 verify or p4 pull can be controlled with the p4 monitor pause and p4 monitor resume commands.

To use p4 monitor, you must enable monitoring on the Perforce service by setting the monitor configurable with p4 configure. You can control process monitoring by setting the monitor configurable to 0 (disable monitoring), 1 (enable monitoring of active processes), or 2 (enable monitoring of both active and idle processes).

Options

-a

Show all arguments associated with the process (for example, edit file.c, or sync -f //depot/src/...).

Perforce user names are truncated to 10 characters, and each line is limited to a total of 80 characters of output.

-e

Show environment information including invoking Perforce application (if known), host IP address, and workspace name.

-l

Show all arguments in long form; that is, without truncating user names or the list of command line arguments.

-s status

Restrict the display to processes in the Running, Terminated, Paused, or Idle states.

g-opts

See the Global Options section.

Usage Notes

Can File Arguments Use Revision Specifier?

Can File Arguments Use Revision Range?

Minimal Access Level Required

No

No

list, super

  • Processes marked as running continue to run to completion even if removed from the monitor table with p4 monitor clear.

  • If a command terminates prematurely on the server side, it may be erroneously listed as running. Superusers can clear such processes with p4 monitor clear.

  • The p4 monitor terminate command will not mark a process for termination unless the process has already been running for at least ten seconds.

  • Some commands (for instance, p4 submit) invoke multiple processes. For example, dm_CommitSubmit or dm_SubmitChange may appear in the output of p4 monitor as two separate phases of the p4 submit command.

  • Some commands, such as p4 obliterate, cannot be terminated.

  • If you have enabled idle process monitoring (by setting the monitor configurable to 2), idle processes appear with a status of R, but with a command of IDLE.

Examples

p4 monitor show

Show Perforce processes information (commands only). Requires list access only.

p4 monitor show -l

Show arguments and commands, without limits on line length. Requires super access.

p4 monitor show -a

Show arguments and commands, limited to 80 characters per line of output. Requires super access.

p4 monitor terminate 123

Instruct the Perforce service to mark process 123 for termination. Requires super access.

p4 monitor clear all

Clears the monitor table of all entries. Requires super access.

Related Commands

To turn on monitoring

p4 configure set monitor=1

To turn off monitoring

p4 configure set monitor=0

Hide partial matches
Highlight matches
0 matching pages