p4 set

Synopsis

Set Perforce system variables.

Syntax

p4 [g-opts] set [-q] [-s] [-S svcname] [var=[value]]

Description

Both Perforce client applications and the shared versioning service make use of certain system variables. Depending on the operating system and other factors, variable definitions may be stored in the file defined by P4CONFIG, in the file defined by P4ENVIRO, or in the Windows registry.

  • On Linux, values defined with p4 set are stored in the P4ENVIRO file.
  • On Windows, values defined with p4 set are stored in the P4ENVIRO file if this is set. If it is not set, they are stored in the Windows registry.

    Windows administrators running Perforce as a service can set environment variables used by the service with p4 set -S svcname var=value. These variables are always stored in the Windows registry.

    To change a variable setting that applies to the current user, use p4 set var=value. Administrators can use p4 set -s var=value to set the variable’s default values for all users on the machine.

For more information, see “P4ENVIRO”.

To unset the value for a particular variable, leave value empty.

To view a list of the values of all Perforce variables, use p4 set without any arguments. If a P4CONFIG file was used to set the variable, its location is displayed.

  • On UNIX, this displays the values of the associated environment variables.
  • On Windows, this displays either the environment variable (if set), or the value in the registry and whether it was defined with p4 set (for the current user) or p4 set -s (for the local machine).

Note how the source of the variable definition is shown in this sample output to the p4 set command. If no source is given, the value is stored in the variable itself rather than in a file containing the definition.

P4CLIENT=symlinks-nix (config)
P4CONFIG=p4config.txt (config
'/home/perforce/p4clients/symlinks-nix/p4config.txt')
P4EDITOR=/usr/bin/vi
P4IGNORE=p4ignore.txt (enviro)
P4PORT=win-jbrown:20151 (config)
P4USER=jbrown (config)
P4_20151_CHARSET=none (enviro)

Please refer to your shell manual for information on setting variables.

Options

-q

Reduce the output.

When listing files, don’t display the origin of the setting. The output is suitable for parsing with scripts.

-s

Set the value of the registry variable for the local machine.

On Windows, without this option, p4 set sets the variables in the HKEY_CURRENT_USER hive; when you use the -s option (and have Windows administrative privileges), the variables are set in the HKEY_LOCAL_MACHINE hive.

The location is reflected in the output of p4 set on Windows.

-S svcname

Set the value of the registry variables as used by service svcname. You must have Windows administrator privileges to do this.

g-opts

See “Global Options”.

Usage Notes

Can File Arguments Use Revision Specifier? Can File Arguments Use Revision Range? Minimal Access Level Required

N/A

N/A

none

  • You’ll find a listing and discussion of the Perforce variables in the “Environment and Registry Variables” section of this manual.
  • Changes to registry settings under Windows affect the local machine only; an administrator setting P4JOURNAL for a Perforce Windows service must be present at the machine running the service.
  • On Windows, variables have the following precedence:

    • Environment variables with the same names have precedence;
    • Values within P4CONFIG files have precedence over both of these;
    • For the Perforce service, configurables set with p4 configure override all environment variables, including registry entries set with p4 set -S;
    • The “Global Options”, specified on the command line, have the highest precedence.
  • If you’re working in a UNIX-like environment on a Windows machine (for example, Cygwin), use environment variables instead of p4 set. (In these cases, the Perforce Command-Line Client behaves just as though it were in a UNIX environment.)

Examples

p4 set

On all platforms, display a list of Perforce variables and their origins without changing their values.

p4 set -q

On all platforms, display a list of Perforce variables in a format suitable for scripts to parse without changing their values.

p4 set P4MERGE=

On Windows or OS X, unset the value of P4MERGE.

p4 set P4PORT=ssl:tea:1666

On Windows, set a variable telling Perforce applications to connect to a Perforce service at host tea, port 1666, via SSL.

The variable is set only for the current local user.

p4 set -s P4PORT=ssl:tea:1666

Set P4PORT as above, but for all users on the system.

You must have administrative privileges to do this.

p4 set -S p4svc P4PORT=1666

For the Windows service p4svc, instruct p4s.exe to listen on port 1666 for incoming connections from Perforce applications.

You must have administrative privileges to do this.

p4 set P4EDITOR="C:\File Editor\editor.exe"

On Windows, for the current local user, set the path for the default text editor.

The presence of spaces in the path to the editor’s executable requires that the path be enclosed in quotation marks.