.\" Process this file with .\" groff -man -Tascii foo.1 .\" .TH P4DCTL 1 "JUNE 2013" Linux "User Commands" .SH NAME p4dctl \- Manage Perforce services .SH SYNOPSIS .SS Listing Services .B p4dctl [ .I options .B ] list [ -t .I type .B ] .SS Starting and Stopping Services .B p4dctl [ .I options .B ] start [ -t .I type .B ] -a .br .B p4dctl [ .I options .B ] start [ -t .I type .B ] .I servername .br .B p4dctl [ .I options .B ] stop [ -t .I type .B ] -a .br .B p4dctl [ .I options .B ] stop [ -t .I type .B ] .I servername .br .B p4dctl [ .I options .B ] restart [ -t .I type .B ] -a .br .B p4dctl [ .I options .B ] restart [ -t .I type .B ] .I servername .SS Checkpoints and Journals .B p4dctl [ .I options .B ] checkpoint -a .br .B p4dctl [ .I options .B ] checkpoint .I servername .SS Queries .B p4dctl [ .I options .B ] status [ -t .I type .B ] -a .br .B p4dctl [ .I options .B ] status [ -t .I type .B ] .I servername .br .B p4dctl [ .I options .B ] list [ -t .I type .B ] -a .br .B p4dctl [ .I options .B ] list [ -t .I type .B ] .I servername .br .B p4dctl [ .I options .B ] env [ -t .I type .B ] -a .I var .B [ .I var... .B ] .br .B p4dctl [ .I options .B ] env [ -t .I type .B ] .I servername .I var .B [ .I var... .B ] .SH DESCRIPTION .B P4DCTL allows administrators to manage Perforce services running on the local host. It provides a central place for configuring, starting & stopping all Perforce services, and is designed to allow non-root users to administer services they own, while root may administer all services, but may not own any. .SS Privileges & Pidfiles P4DCTL must be installed as a setuid root executable because it uses root privileges to maintain pidfiles for compatibility with systems that use them. During all other operations, P4DCTL runs with the privileges of the executing user. This allows non-root users to start/stop the services they own, while having the pidfile remain up-to-date. .P .SS Environment Control P4DCTL enforces strict control of the environment of any services it starts. Administrators specify the complete environment for each service in the configuration file and P4DCTL ensures that the environment for the service is exactly what is configured, no more, no less. This prevents the category of failure where services work when started by the user, but not when started by root. If both use P4DCTL, the environment is always identical. .SH OPTIONS .IP "-c config-file" Path to config file. Default: /etc/p4d.conf .IP "-p pid_dir" Path to pid file directory: Default: /var/run .IP -q Send output to syslog instead of stdout/stderr .IP "-v level" Set debug level (0-9) .IP -V Print version and exit List the .SH FILES .I /etc/p4d.conf .RS The system wide configuration file. .RE .SH ENVIRONMENT p4dctl uses no specific environment variables .SH AUTHOR Tony Smith .SH "SEE ALSO" .BR p4 (1), .BR p4d (1)