README #1

			P4DCTL README
			-------------

P4DCTL is a program for starting and stopping Perforce services on Unix 
platforms. It's designed to be used both by root and non-root users and
to integrate well with init.d or rc scripts for boot/shutdown. It allows
the system administrator to specify the Perforce services they wish to
start on the box in a single configuration file: /etc/perforce/p4dctl.conf, 
or in a set of configuration files under /etc/perforce/p4dctl.conf.d

BUILDING FROM SOURCE
--------------------

If you're building inside Perforce, you can just sync the P4 tree as
well as p4dctl and use jam.

If you're building from the Public Depot sources, you'll need Perforce 
Jam, and the Perforce API. Once you've installed both, simply use:

	jam -sP4=<path to Perforce API>

You may also wish to specify your operating system version. For example, for 
a Linux 2.6 build, I might use:

	jam -sP4=<path to Perforce API> -sOSVER=26 

Then to install the binary, run the command below as root:

	jam -sP4=<path to Perforce API> -sOSVER=<version> install

This will install the binary in /usr/local/bin and make it a setuid root
executable. I believe the program to be secure, though obviously I can't
guarantee that.

INSTALLING A PRE-BUILT BINARY
-----------------------------

If you're using a pre-built binary, just copy it into /usr/local/bin, and run
the following commands:

	chown root:0 /usr/local/bin/p4dctl
	chmod 4711 /usr/local/bin/p4dctl

CONFIGURATION
-------------

The simplest way to get started is to copy the p4dctl.conf.sample from the 
distribution to /etc/perforce/p4dctl.conf and edit it to reflect your needs.

USAGE
-----

See 'p4dctl -h' for command-line syntax