Perforce 2003.2 Command Reference
<< Previous Chapter
p4 logger
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 obliterate

p4 monitor

Synopsis

Display Perforce process information

Syntax

p4 [g-opts] monitor show [ -a -l ]
p4 [g-opts] monitor terminate [ id ]
p4 [g-opts] monitor clear [ id | all ]

Description

You must enable monitoring on the Perforce server for p4 monitor to work. This is done by setting the monitor counter with p4 counter, and restarting the server.

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:

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 server.

To list current process information, use p4 monitor show. 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.

To show the list of arguments associated with each command, use the -a (arguments) flag or -l (long) flag. These options require admin level access.

To mark a process for termination, use p4 monitor terminate id. This command requires admin 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 forms require admin level access.

Options

g-opts

See the Global Options section.

-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.

-l

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

Usage Notes

Can File Arguments Use
Revision Specifier?

Can File Arguments Use
Revision Range?

Minimal Access Level Required

No

No

list,
admin

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 admin access.

p4 monitor show -a

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

p4 monitor terminate 123

Instruct the Perforce server to mark process 123 for termination. Requires admin access.

p4 monitor clear all

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

Related Commands

To turn on server monitoring (requires server restart)

p4 counter -f monitor 1

To turn off server monitoring (requires server restart)

p4 counter -f monitor 0


Perforce 2003.2 Command Reference
<< Previous Chapter
p4 logger
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 obliterate
Please send comments and questions about this manual to [email protected].
Copyright 1999-2003 Perforce Software. All rights reserved.
Last updated: 12/12/03