diff -r e4f1a551d45c -r 8d0f25ef038e INSTALL --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/INSTALL Wed Sep 28 09:04:16 2011 -0700 @@ -0,0 +1,66 @@ + +Building volta +=============== + +Volta should build with minimal effort. First, make sure you have +dependencies installed. + + +Dependencies +------------ + +Currently, volta requires the following to compile: + +Regular dependencies: + + - GNU make (http://www.gnu.org/software/make/) + - sqlite3 (http://www.sqlite.org/) + +Development dependencies (optional): + + - ragel (http://www.complang.org/ragel/) + - mercurial (http://mercurial.selenic.com/) + - google-perftools (http://code.google.com/p/google-perftools/) + - graphviz (http://www.graphviz.org/) + - ctags (http://ctags.sourceforge.net/) + + +Compiling +--------- + +Just type 'make'. Depending on your platform, GNU make may have been +installed as 'gmake' If you get any errors, try 'gmake' first. + +It should build without warnings. + + +Installation +------------ + +Volta doesn't contain any installation targets. You can put the binary +wherever makes sense on your system. Note that it should be in a +directory that is writable to Squid, unless you plan to store the +database separately. An example: + + mv volta /usr/local/bin + mkdir -p /var/db/squid + chown squid:squid /var/db/squid + volta -f /var/db/squid/volta.db + +I usually just drop it into the squid configuration directory and run it +from there. + +For usage information, see the README. + + +Development +----------- + +Volta source can be cloned via Mercurial. The repo is found at: + + http://code.martini.nu/volta + +You can use the 'debug' make target to compile a (very noisy) binary +that contains gdb symbols and perftool hooks. Set the CPUPROFILE +environment variable to "cpu.prof" to generate a profile. +