Previous Table of Contents Index Next
Perforce 2009.2: P4 User's Guide

This guide tells you how to use the Perforce Command-Line Client (p4). If you're new to SCM (software configuration management), you don't know basic Perforce concepts, or you've never used Perforce before, read Introducing Perforce before reading this guide. This guide assumes a good basic understanding of SCM.
Command line versus GUIs
Perforce provides many client applications that enable you to manage your files, including the Perforce Command-Line Client, GUIs such as P4V, and plug-ins. The Perforce Command-Line Client enables you to script and to perform administrative tasks that are not supported by Perforce GUIs.
Getting started with Perforce
If this is your first time working with Perforce, here's how to get started:
Read Introducing Perforce to learn the basics.
At a minimum, learn the following concepts: changelist, depot, client workspace, sync, and submit. For short definitions, refer to the glossary at the back of this guide.
If you intend to experiment with Perforce and don't want to risk damaging your production depot, ask the Perforce administrator to start another server for test purposes. For details about installing the Perforce server, refer to the Perforce System Administrator's Guide.
Use this guide to help you install the Perforce Command-Line Client and configure your client workspace, unless your system administrator has already configured your machine. See Chapter 2, Configuring P4, for details.
sync (transfer selected files from the repository to your computer)
submit (transfer changed files from your workspace to the repository)
revert (discard changes)
See Chapter 4, Managing Files and Changelists, for details.
These basic skills enable you to do much of your daily work. Other tasks involving code base maintenance (branching and labeling) and workflow (jobs) tend to be less frequently done. This guide includes details about performing these tasks using p4 commands.
Perforce documentation
This guide, the Perforce Command Reference, and the p4 help command are the primary documentation for the Perforce Command-Line Client. This guide describes the current release. For documentation for older releases, refer to the Perforce web site.
For documentation on other Perforce client programs, see our documentation web page, available from our web site at
Installing and administering the Perforce server, the proxy server, and security settings
p4 command line flags and options (reference)
Getting Started with P4V,
P4V online help
How to use P4Web,
P4Web online help
IDEs: Using IDE Plug-ins
Please give us feedback
We are interested in receiving opinions on this guide from our users. In particular, we'd like to hear from users who have never used Perforce before. Does this guide teach the topic well? Please let us know what you think; we can be reached at [email protected].

Previous Table of Contents Index Next

Perforce 2009.2: P4 User's Guide
Copyright 2005-2009 Perforce Software.