Perforce 2003.1 Command Reference
<< Previous Chapter
p4 reviews
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 submit

p4 set

Synopsis

Set Perforce variables in the Windows registry.

Syntax

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

Description

The Perforce client and server require the use of certain system variables.

On Windows, you can set the values of these variables in the registry with p4 set; on other operating systems, Perforce uses environment variables for the same purpose.

To set the value of a registry variable for the current user, use p4 set var=value. Windows administrators can use p4 set -s var=value to set the registry variable's default values for all users on the local machine.

Windows administrators running the Perforce server as a service can set variables used by the service (for instance, P4JOURNAL and others) with p4 set -S svcname var=value.

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. On UNIX, this displays the values of the associated environment variables. On Windows, this displays either the MS-DOS 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).

p4 set can be used on non-Windows operating systems to view the values of variables, but if you try to use p4 set to set variables on non-Windows operating systems, Perforce will display an error message.

Options

-s

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

Without this flag, p4 set sets the variables in the HKEY_CURRENT_USER hive; when you use the -s flag, the variables are set in the HKEY_LOCAL_MACHINE hive.

These locations are 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 administrator privileges to do this.

g-opts

See the Global Options section.

Usage Notes

Can File Arguments Use
Revision Specifier?

Can File Arguments Use
Revision Range?

Minimal Access Level Required

N/A

N/A

list

Examples

p4 set

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

p4 set P4MERGE=

On Windows, unset the value of P4MERGE.

p4 set P4PORT=tea:1666

On Windows, set a registry variable telling Perforce client programs to connect to a Perforce server at host tea, port 1666.

The variable would be set only for the current local user. .

p4 set -s P4PORT=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 NT service p4svc, instruct p4s.exe to listen on port 1666 for incoming connections from Perforce client programs.

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.


Perforce 2003.1 Command Reference
<< Previous Chapter
p4 reviews
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 submit
Please send comments and questions about this manual to [email protected].
Copyright 1999-2003 Perforce Software. All rights reserved.
Last updated: 07/07/03