Global Options
Synopsis
Global options for Perforce commands; these options can be supplied on the command line before any Perforce command.
Syntax
p4 [-bbatchsize
-cclient
-ddir
-Hhost
-pport
-Ppass
-uuser
-xfile
-Ccharset
-Qcharset
-Llanguage
] [-I] [-G] [-s] [-z tag] cmd [args ...] p4 -V p4 -h
Options
|
Specifies a batch size (number of arguments) to use when processing a
command from a file with the |
|
Overrides any |
|
Overrides any |
|
Specify that progress indicators, if available, are desired. This
option is not compatible with the |
|
Causes all output (and batch input for form commands with |
|
Overrides any |
|
Overrides any |
|
Overrides any |
|
Specifies the number of times to retry a command (notably,
|
|
Prepends a descriptive field (for example, |
|
Overrides any |
|
Instructs Perforce to read arguments, one per line, from the specified
file. If file is a single hyphen ( |
|
Overrides any |
|
Overrides any |
|
This feature is reserved for system integrators. |
|
Causes output of many reporting commands to be in the same tagged
format as that generated by |
|
Quiet mode; suppress all informational message and report only warnings or errors. |
|
Displays the version of the |
|
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 filefile.c
for edit in pending changelist 140 under client workspaceanotherclient
. -
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 invokep4 -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 includedfile.h
file, for instance, could grep -l file.h *.c | cut -f1 -d: | p4 -x - edit.In this example, the
grep
command lists occurrences offile.h
in the*.c
files, the-l
option tellsgrep
to list each file only once, and thecut
command splits off the filename fromgrep
's output before passing it to thep4 -x - edit
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 application. 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:#!/usr/local/bin/python import marshal, sys try: num=0 while 1: num=num+1 print '\n' % num dict = marshal.load(sys.stdin) for key in dict.keys(): print "%s: %s" % (key,dict[key]) except EOFError: pass
Python developers on Windows should be aware of potential CR/LF translation issues; in the example, it is necessary to call
marshal.load()
to read the data in binary ("rb
") mode.For additional information about this option, see
- At present, the progress indicator requested when you use the
-I
option is only available withp4 -I submit
andp4 -I sync -q
. -
Some uses of the global options are absurd.
For example,
p4 -c workspace help
provides exactly the same output asp4 help
.
Examples
|
Performs a sync after connecting to |
|
The first |
|
If Any errors as a result of the automated |