README #2

			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/p4d.conf), or in
a set of configuration files under /etc/p4d.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, the 
Perforce API, and optionally the openssl library (on Ubuntu, you need the 
libssl-dev package). Once you've installed those, simply use:

	jam -sP4=<path to Perforce API>

You will also need to specify your operating system version for Linux builds. For example, for a Linux 2.6 build, I use:

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

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 p4d.conf.sample from the 
distribution into /etc/p4d.conf and edit it to reflect your needs.

USAGE
-----

See 'p4dctl -h' for command-line syntax