p4 fixes

List jobs and the changelists that fix them.

Syntax

p4 [g-opts] fixes [-i] [-m max] [-j job] [-c changelist] [FileSpec[revSpec]]

Syntax conventions

Description

After a job has been linked to a particular numbered changelist with p4 fix, p4 change, or p4 submit, the job is 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 options 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 option with a file pattern argument to include fixes made by changelists that were integrated into the specified files.
  • Use the -m max option to limit the output to the first max fixes.
Note

This command runs in lockless mode if db.peeking is set to r

Options

-c changelist

Limit the displayed fixes to those that include the specified changelist.

-i

Include fixes made by changelists that affected files integrated into the specified files.

-j jobname

Limit the displayed fixes to those that include the specified job.

-m max

List only the first max fixes.

g-opts

See Global options.

Usage Notes

Can File Arguments Use Revision Specifier? Can File Arguments Use Revision Range? Minimal Access Level Required

Yes

Yes

list

The command returns no output if there is no object to report on.

Examples

p4 fixes //depot/proj1/...

Display all fixes made by submitted changelists that included any files under //depot/proj1.

p4 fixes file.c

Display all fixes made by submitted changes that included any and all revisions of file.c.

p4 fixes file.c#5

Display all fixes made by submitted changes that included revisions 1 through 5 of file.c.

p4 fixes file.c#5,5

Display only those fixes associated with the changelist in which file.c#5 was submitted.

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