p4dctl commands

Syntax

Category Syntax

Control services

p4dctl [ options ] start [ -t type ] -a
p4dctl [ options ] start [ -t type ] name
p4dctl [ options ] stop [ -t type ] -a
p4dctl [ options ] stop [ -t type ] name
p4dctl [ options ] restart [ -t type ] -a
p4dctl [ options ] restart [ -t type ] name

Checkpoints and journals

The p4dctl checkpoint command is similar to the p4d -jc command.

p4dctl [ options ] checkpoint -a
p4dctl [ options ] checkpoint name

Query services

p4dctl [ options ] status [ -t type ] -a
p4dctl [ options ] status [ -t type ] name
p4dctl [ options ] list [ -t type ]
p4dctl [ options ] list [ -t type ] name
p4dctl [ options ] env [ -t type ] -a var [var…​]
p4dctl [ options ] status [ -t type ] name var [var…​]

Arbitrary command on
the servers (or services) that match name

p4dctl [options] exec -t type [-r] [-n] [-f] name -- arg

Executes the binary for the specified service matching type and name with the argument(s) specified after the -- separator of two hyphens.

The service binary is executed with the same environment variables that p4dctl start would set.

Examples:

p4dctl exec -t p4d name -- -xu when Upgrading the server
p4dctl exec -t p4d -f master -- -cshow to verify the user, p4d binary, and P4ROOT
p4dctl exec -t p4d -f master -- -V to execute p4d -V without having to check whether the p4d in your path is the p4d specified in the configuration of that instance

Options

See also the meaning of variable names in Configuration file format.

Options Meaning
-a

All servers.

-c configFile

Path to the configuration file

Default: /etc/perforce/p4dctl.conf

-f

Force exec to execute the command even if that p4d instance is currently running.

-n

Used with exec to preview rather than run the command.

-p pidDir

Path to the pid file directory.

Default: /var/run

-q

Send output to syslog instead of STDOUT or STDERR

-r Restricts the arg arguments for exec to those explicitly included with the exec command. Without -r, if the service is configured with arguments, they are honored and any additional arg arguments in this exec command are appended.
-t type The service type of the p4d instance to run, such as p4d, p4p, p4broker, and other.

-v level

Set debug level (0-9)

For more information, see the description of the P4DEBUG environment variable in P4 Command Reference.

-V

Display version and exit.