To compile the Peep server, you'll probably want to do a:
./configure make make install
To install Peep is a non-standard location, the -prefix=
option must be supplied to configure.
Peep can be compiled to use different protocols to fit different needs. As of 0.5.0, Peep supports three different protocols, which are enabled using the following configure switches:
-enable-tcp-server: Compile the server to use the TCP protocol for messaging and use UDP for broadcasting. (Default)
-enable-udp-server: Compile the server to use UDP for all communications.
-enable-openssl: Compile the server to use SSL for messaging and UDP for broadcasting.
The clients can then be configured to use the appropriate protocol at runtime. See the client documentation for further details.
configure also understands some other useful options:
-enable-debug=(0-5): This sets the level of debugging output. The default is to use the lowest level of debugging, 0. To see a list of what information will be printed out with each level of debugging, type ./configure -help.
-with-dynamic-volume: This is the default setting and enables dynamic calculations of volume levels in the mixer.
-with-static-volume: This disables dynamic volume and uses a fixed volume for each sound. This can fix any sort of hesitations in that might result from sound clipping. But this shouldn't happen, so you shouldn't have to do this =) Static volume might give a minor performance increase if your server is getting hit with a lot of events quickly. However, static volume greatly reduces sound output level, so get ready to crank up the stereo. (Default)
-with-alsa-driver: This compiles peepd using the ALSA libraries, rather than /dev/audio. This code currently support ALSA 0.9.x. Most linux systems ship with this version as of time of writing.
-with-oss-driver: This tells peepd to use standard /dev/audio support. This is the default and so this option will most likely never be used.
-with-expat=: This specifies an alternate location
for the expat library and include prefix.
-with-openssl-includes: This specifies the directory containing the openssl include files if they cannot be found by configure.
-with-openssl-libraries: This specifies the directory containing the openssl library files if they cannot be found by configure.
After peepd has been compiled, the next step is to configure peep.conf and deploy the clients. Deploying and configuring the client utlities is a little more involved and is described in their respective sections.