Perforce p4 Command-Line Cheat Sheet: Query, Sync, Integrate, and Admin Workflows

Perforce command names can look similar when you are under delivery pressure. This updated cheat sheet helps developers, release engineers, and administrators quickly choose the right p4 command for searching history, syncing files, integrating codelines, and managing labels.

Originally published on 2009-06-20; fully revised and updated.

Original reference post: Perforce Web References & Cheatsheet.

Command chooser for Perforce data-mining questions

When the question is clear, the command choice is usually straightforward. Use this mapping to decide whether you need file names, changelists, detailed history, or content differences.

p4 files //depot/...#have
p4 files //depot/...@1541
p4 changes file.c
p4 describe 1231
p4 filelog file.javaCode language: JavaScript (javascript)

Daily workspace workflow

This is the common developer loop: configure workspace, sync, open files, review, and submit.

flowchart TD
    A[Create or update workspace] --> B[Sync files from depot]
    B --> C[Open files for add edit or delete]
    C --> D[Review local changes]
    D --> E{Ready to publish}
    E -- no --> F[Continue editing or revert]
    F --> C
    E -- yes --> G[Submit changelist]
    G --> H[Integrate or share with team]

p4 set P4CLIENT=my_workspace
p4 client -t 1.0dev
p4 sync //depot/eng/...

p4 edit relnotes.txt
p4 diff relnotes.txt
p4 submit relnotes.txt

p4 revert -a
p4 revert file.javaCode language: JavaScript (javascript)

Revision specifiers quick reference

Many Perforce commands become much more useful when you add a revision specifier.

Branching and selective integration

Use branch specifications consistently, then drive integrations with p4 integ (shorthand for p4 integrate) and inspect branch differences with p4 diff2 -b.

# Base to release
p4 integ -b prodxyz-1.0.1 //...@=1232
p4 integ -b prodxyz-1.0.1 //...@129,@134
p4 integ -b prodxyz-1.0.1

# Release to base (reverse mapping from branch spec)
p4 integ -b prodxyz-1.0.1 -r @=1235
p4 integ -b prodxyz-1.0.1 -r //...@127,@128
p4 integ -b prodxyz-1.0.1 -r

# Branch comparison
p4 diff2 -b prodxyz-1.0.1Code language: PHP (php)

Labels and release snapshots

Labels provide a named snapshot of file revisions. The original cheat sheet uses a two-step pattern: create label metadata, then populate label contents.

# Create and populate a label
p4 label xxx
p4 labelsync -l xxx
p4 labelsync -l xxx file1 file2

# Copy one label's contents into a new label
p4 label -t xxx abc
p4 labelsync -l abc //...@xxxCode language: PHP (php)

Working offline and reconciling later

The original guide includes a practical recovery pattern for edits made while disconnected: detect edits, deletions, and additions, then open files in Perforce accordingly.

p4 diff -se | p4 -x - edit
p4 diff -sd | p4 -x - delete
find . -type f -print | p4 -x - add

p4 opened
p4 diffCode language: JavaScript (javascript)

Administration commands from the original sheet

Best practices and common pitfalls

• Check before submit: run p4 opened and p4 diff so your changelist contains only intended files.
• Use p4 revert carefully: the original sheet explicitly warns it is irreversible for unopened/unsubmitted work.
• Be cautious with selective integrations: review merge choices carefully, especially when reversing flow with -r.
• Standardize branch specs: consistent naming makes p4 integ -b ... and p4 diff2 -b ... much safer to reuse.
• Verify behavior against your installed Perforce version: some notes in the 2009-era sheet reference older releases and may differ in modern environments.

Rajesh Kumar

I’m Rajesh Kumar, a DevOps, SRE, DevSecOps, Cloud, and Platform Engineering expert passionate about sharing practical knowledge, real-world experiences, and industry best practices. I have worked at Cotocus and regularly write about technology, travel, investing, health, product reviews, and digital marketing through my various platforms.

I publish technical articles at DevOps School, travel stories at Holiday Landmark, stock market insights at Stocks Mantra, health and fitness guidance at My Medic Plus, product reviews at TrueReviewNow, and SEO and digital marketing strategies at Wizbrand.