Global options

Global options for Helix Server commands can be supplied on the command line before any Helix Server command.

Syntax

p4 [-b batchsize -c client -d dir -H host -p port -P pass -v var -u user -x file
     -C charset -Q charset -L language] [-I] [-G] [-Mj] [-s] [-z tag] cmd [args ...]

p4 -V

p4 -h

Syntax conventions

Options

`-b batchsize`	Specifies a batch size (number of arguments) to use when processing a command from a file with the `-x argfile` option. By default, the batch size is `128`.
`-c client`	Overrides any `P4CLIENT` setting with the specified client name.
`-d dir`	Overrides any `PWD` setting (current working directory) and replaces it with the specified directory.
`-I`	Specify that progress indicators, if available, are desired. This option is not compatible with the `-s` and `-G` options.
-i	Although not global, the -i and -o options work with forms and represent standard in and standard out.
`-G`	Causes all output (and batch input for form commands with `-i`) to be formatted as marshaled Python dictionary objects. This is most often used when scripting. Note Use the -G option with the -z tag option. Otherwise the marshaled output might be invalid. See also the Usage Notes.
-Mj	Formats output as line-delimited JSON objects, with non-UTF8 characters replaced with U+FFFD Note Use the -Mj option with the -z tag option. Otherwise the marshaled output might be invalid.
`-H host`	Overrides any `P4HOST` setting and replaces it with the specified hostname.
-o	Although not global, the -i and -o options work with forms and represent standard in and standard out.
`-p port`	Overrides any `P4PORT` setting with the specified `protocol:host:port`.
`-P pass`	Enables a password (or ticket) to be passed on the command line, thus bypassing the password associated with P4PASSWD. If a valid ticket exists, using this option with an invalid `pass` causes access to be granted by the valid ticket.
`-r retries`	Specifies the number of times to retry a command (notably, `p4 sync`) if the network times out.
`-s`	Prepends a descriptive field (for example, `text:`, `info:`, `error:`, `exit:`) to each line of output produced by a Helix Server command. This is most often used when scripting.
`-u user`	Overrides any `P4USER`, `USER`, or `USERNAME` setting with the specified user name.
`-x argfile`	Instructs Helix Server to read arguments, one per line, from the specified file. If argfile is a single hyphen (`-`), instructs Helix Server to read from standard input instead of from a file.
`-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`. Note Use this option for all marshaled output, such as that of -G and -Mj. Otherwise the marshaled output might be invalid. See also the Timestamp and Unix epoch time information.
`-q`	Quiet mode, which suppresses informational messages and reports only warnings or errors.
`-v` `var`	Debug level or configurable represented by `var`, such as: `p4 -v 1 info` or `p4 -v net.autotune=0 info`
`-V`	Displays the version of the `p4` application 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 Helix Server command. Options specified after the Helix Server 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 because it processes a sequence of arguments, line by line, from the specified file. For example, suppose you want an easy way to bring many files into the depot. Create one file that lists many files, each on a separate line. Let's use the UNIX cat command to verify we have such a file:

cat filesToAdd.txt partOne.txt partTwo.txt partThree.txt

The -x option enables the p4 add command to process each line of the file as if we had issued a series of p4 add commands, each time with a different file argument. In this case,

p4 -x filesToAdd.txt add

is the equivalent of:
```
p4 add partOne.txt
```
```
p4 add partTwo.txt
```
```
p4 add partThree.txt
```
Therefore, the result of p4 -x filesToAdd.txt can be:

//depot/repo/partOne.txt#1 - opened for add //depot/repo/partTwo.txt#1 - opened for add //depot/repo/partThree.txt#1 - opened for add

The -x option can be as powerful as whatever generates its input. For example, a UNIX developer who wants to edit any file referring to a file.h file can issue the command:

grep -l file.h *.c | cut -f1 -d: | p4 -x - edit

where:
- the grep command lists occurrences of file.h in the *.c files
- the -l option tells grep to list each file only once
- the cut command splits off the filename from grep's output before passing it to the p4 -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 find the -G option useful for scripting. For instance, to get a dictionary of all the 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 might not be obvious which 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 above, it is necessary to call marshal.load() to read the data in binary ("rb") mode.

Tip
For additional examples and guidance about scripting with this option, see the Support Knowledgebase article, "Using p4 -G".
The progress indicator requested when you use the -I option is only available with p4 -I submit and p4 -I sync -q
p4 help is simpler than p4 -c workspace help and provides the same output.

Examples

p4 -p new_service:1234 sync

Performs a sync after connecting to new_service and port 1234, regardless of the settings of the P4PORT environment variable.

p4 -c new_client submit -c 100

The first -c is the global option to specify the client workspace name.

The second -c specifies a changelist number.

p4 -s -x filelist.txt edit

If filelist.txt contains a list of files, this command opens each file on the list for editing, and produces output suitable for parsing by scripts.

Any errors as a result of the automated p4 edit commands (for example, a file in filelist.txt not being found) can be detected by examining the command’s output for lines beginning with "error:"