Perforce 2009.1: Command Reference

p4 fixes

Synopsis

List jobs and the changelists that fix them.

Syntax

p4 [g-opts] fixes [-i -m max -j job -c changelist#] [file[revRange]...]

Description

After a job has been linked to a particular numbered changelist with p4 fix, p4 change, or p4 submit, the job is said to have been fixed by the changelist (even if the changelist is still pending). The p4 fixes command lists changelists and the jobs they fix.

If invoked without arguments, p4 fixes displays all fix records. Fix records are displayed in the following format:

jobname fixed by change changelist# on date by user (status)

You can limit the listed fixes by combining the following flags when calling p4 fixes:

•	Use the -c changelist option to list only the jobs fixed by that pending or submitted changelist.

•	Use the -j job option to list only those pending or submitted changelists that fix that job.

•

Provide one or more file pattern arguments. If you provide a file argument, only submitted changelists affecting files that match the file patterns are listed; pending changelists are not included. If a revision specifier or revision range is included, only submitted changelists that affected files at the given revisions are listed. You can use the -i flag with a file pattern argument to include fixes made by changelists that were integrated into the specified files.

•	Use the -m max flag to limit the output to the first max fixes.

Options

-c changelist#	Limit the displayed fixes to those that include the specified changelist.
-j jobname	Limit the displayed fixes to those that include the specified job.
-i files...	Include fixes made by changelists that affected files integrated into the specified files.
-m max	List only the first max fixes.
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
Yes	Yes	list

Examples

p4 fixes //depot/proj1/...	Display all fixes made by submitted changelists that included any files under //depot/proj1.
p4 fixes -c 414	Display all jobs fixed by pending or submitted changelist 414.

Related Commands

To create or edit an existing job	p4 job
To list all jobs known to the system	p4 jobs
To attach a job to a particular changelist; the job is fixed by that changelist	p4 fix
To change the format of jobs at your site (superuser only)	p4 jobspec
To read information about the format of jobs at your site	p4 jobspec -o