Perforce Command Line Global Options

scmgalaxy K — Tue, 09 Jan 2018 06:17:30 +0000

Perforce Command Line Global Options

Global options for Perforce commands; these options can be supplied on the command line before any Perforce command.

Syntax

p4 [-cclient -ddir -Hhost -pport -Ppass -uuser -xfile -Ccharset -Qcharset -Llanguage] [-G] [-s] [-z tag] cmd [args …]
p4 -V
p4 -h

Options


-c client	Overrides any P4CLIENT setting with the specified client name.
-d dir	Overrides any PWD setting (i.e. current working directory) and replaces it with the specified directory.
-G	Causes all output (and batch input for form commands with -i) to be formatted as marshalled Python dictionary objects. This is most often used when scripting.
-H host	Overrides any P4HOST setting and replaces it with the specified hostname.
-p port	Overrides any P4PORT setting with the specified port number.
-P pass	Overrides any P4PASSWD setting with the specified password.
-s	Prepends a descriptive field (for example, text:, info:, error:, exit:) to each line of output produced by a Perforce command. This is most often used when scripting.
-u user	Overrides any P4USER, USER, or USERNAME setting with the specified user name.
-x file	Instructs Perforce to read arguments, one per line, from the specified file. If file is a single hyphen (-), then standard input is read.
-C charset	Overrides any P4CHARSET setting with the specified character set.
-Q charset	Overrides any P4COMMANDCHARSET setting with the specified character set.
-L language	This feature is reserved for system integrators.
-z tag	Causes output of many reporting commands to be in the same tagged format as that generated by p4 fstat.
-V	Displays the version of the p4 client program and exits.
-h	Displays basic usage information and exits.

Usage Notes

•

Be aware that the global options must be specified on the command line before the Perforce command. Options specified after the Perforce command will not be interpreted as global options, but as options for the command being invoked. It is therefore possible to have the same command line option appearing twice in the same command, being interpreted differently each time.

For example, the command p4 -c anotherclient edit -c 140 file.c will open file file.c for edit in pending changelist 140 under client workspace anotherclient.

•	The -x option is useful for automating tedious tasks; a user adding several files at once could create a text file with the names of these files and invoke p4 -x textfile add to add them all at once.

The -x option can be extremely powerful – as powerful as whatever generates its input. For example, a UNIX developer wishing to edit any file referring to an included file.h file, for instance, could grep -l file.h *.c | cut -f1 -d: | p4 -x – edit.

In this example, the grep command lists occurrences of file.h in the *.c files, the -l option tells grep to list each file only once, and the cut command splits off the filename from grep’s output before passing it to the p4 -x command.

•	The -s option can be useful in automated scripts.

For example, a script could be written as part of an in-house build process which executes p4 -s commands, discards any output lines beginning with “info:”, and alerts the user if any output lines begin with “error:”.

•	Python developers will find the -G option extremely useful for scripting. For instance, to get a dictionary of all fields of a job whose ID is known, use the following:

job_dict = marshal.load(os.popen(‘p4 -G job -o ‘ + job_id, ‘rb’))

In some cases, it may not be intuitively obvious what keys are used by the client program. If you pipe the output of any p4 -G invocation to the following script, you will see every record printed out in key/value pairs:

The post Perforce Command Line Global Options appeared first on scmGalaxy.

Perforce Command Line

scmgalaxy K — Tue, 09 Jan 2018 06:13:04 +0000

	Command	Description
	p4 add	Open file(s) in a client workspace for addition to the depot.
	p4 admin	Perform administrative operations on the server.
	p4 branch	Create or edit a branch specification and its view.
	p4 change	Create or edit a changelist specification.
	p4 changelists	List submitted and pending changelists.
	p4 changelist	Create or edit a changelist specification.
	p4 client	Create or edit a client workspace specification and its view.
	p4 clients	List all client workspaces currently known to the system.
	p4 delete	Open file(s) in a client workspace for deletion from the depot.
	p4 depot	Create or edit a depot specification.
	p4 depots	Display a list of depots known to the Perforce server.
	p4 describe	Provides information about changelists and the changelists’ files.
	p4 groups	List groups of users.
	p4 group	Add or delete users from a group, or set the maxresults, maxscanrows, and timeout limits for the members of a group.
	p4 have	List files and revisions that have been synced to the client workspace
	p4 info	Display information about the current client and server.
	p4 integrate	Open files for branching or merging.
	p4 integrated	Show integrations that have been submitted.
	p4 job	Create or edit a defect, enhancement request, or other job specification.
	p4 jobs	List jobs known to the Perforce server.
	p4 label	Create or edit a label specification and its view.
	p4 labels	Display list of defined labels.
	p4 lock	Lock an opened file against changelist submission.
	p4 login	Log in to a Perforce server by obtaining a ticket.
	p4 logout	Log out of a Perforce server by removing or invalidating a ticket.
	p4 passwd	Change a user’s Perforce password on the server.
	p4 rename	Renaming files under Perforce.
	p4 resolve	Resolve conflicts between file revisions.
	p4 revert	Discard changes made to open files.
	p4 set	Set Perforce variables in the Windows registry.
	p4 submit	Send changes made to open files to the depot.
	p4 sync	Copy files from the depot into the workspace.
	p4 tag	Tag files with a label.
	p4 triggers	Edit a list of scripts to be run conditionally whenever changelists are submitted, forms are updated, or when integrating Perforce with external authentication mechanisms.
	p4 user	Create or edit Perforce user specifications and preferences.
	p4 users	Print a list of all known users of the current server.
	p4 verify	Verify that the server archives are intact.
	p4 workspace	Create or edit a client workspace specification and its view.

The post Perforce Command Line appeared first on scmGalaxy.

Perforce Command Line CheatSheet Archives - scmGalaxy

Perforce Command Line Global Options

Perforce Command Line

Command

Description