jfclere 2003/09/16 04:55:08 Modified: daemon/xdocs index.xml Added: daemon/xdocs jsvc.xml procrun.xml Log: Start adding documentation about how to build and to use jsvc. Revision Changes Path 1.2 +3 -8 jakarta-commons/daemon/xdocs/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/jakarta-commons/daemon/xdocs/index.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- index.xml 4 Sep 2003 23:28:20 -0000 1.1 +++ index.xml 16 Sep 2003 11:55:08 -0000 1.2 @@ -75,14 +75,9 @@ <section name="Platforms"> <p> - Actualy only the UNIX like platforms are supported. - For win32 platfroms the cygwin emulation layer is used. See - <a href="http://www.cygwin.com/";> cygwin</a> for more informations. -</p> -<p> - In the futur <a href="http://apr.apache.org/";> APR </a> will be used - to provide more convinient platform support. - support + Actualy win32 and the UNIX like platforms are supported. + For win32 platfroms use <a href="procrun.html">procrun</a>. + For UNIX like platforms use <a href="jsvc.html">jsvc</a>. </p> </section> <section name="Initial Source of the Package"> 1.1 jakarta-commons/daemon/xdocs/jsvc.xml Index: jsvc.xml =================================================================== <?xml version="1.0"?> <document> <properties> <title>Daemon : Java Service</title> <author email="[EMAIL PROTECTED]">Jean-Frederic Clere</author> </properties> <body> <section name="Introduction"> <p> Actualy only the UNIX like platforms are supported. The sources are located in the src/native/unix subdirectory of the project sources. For win32 platfroms the cygwin emulation layer is used. See <a href="http://www.cygwin.com/";> cygwin</a> for more informations. </p> <p> In the futur <a href="http://apr.apache.org/";> APR </a> may be used to provide more convinient platform support. </p> </section> <section name="Building from cvs"> <p> To build under an UNIX operating system you will need: <ul> <li>GNU AutoConf</li> <li>An ANSI-C compliant compiler (GCC is good)</li> <li>GNU Make</li> <li>A Java Platform 2 compliant SDK</li> </ul> You need to build the "configure" program with: sh support/buildconf.sh (Note it is possible to replace sh by any compatible shell like bash, ksh). The result should be something like: <source> support/buildconf.sh support/buildconf.sh: configure script generated successfully </source> Once the configure script is generated, follow the next section. </p> </section> <section name="Building for a release tarball"> <p> To build the binary under an UNIX operating system you will need: <ul> <li>An ANSI-C compliant compiler (GCC is good)</li> <li>GNU Make</li> <li>A Java Platform 2 compliant SDK</li> </ul> You have to specify the JAVA_HOME of the SDK either the --with-java=<dir> parameter or set the JAVA_HOME environment to point to your SDK installation. For example: <source> ./configure --with-java=/usr/java </source> or <source> export JAVA_HOME ./configure </source> If your operating system is supported, configure will go thru cleanly, otherwise it will report an error (please send us the details of your OS/JDK, or a patch against the sources). To build the binaries and libraries simply do: <source> make </source> This will generate the executable file jsvc. </p> </section> <section name="Using jsvc"> <p> To check the allowed parameters for the jsvc binary simply do: <source> ./jsvc -help Usage: jsvc [-options] class [args...] Where options include: -jvm <JVM name> use a specific Java Virtual Machine. Available JVMs: '(null)' -cp / -classpath <directories and zip/jar files> set search path for service classes and resouces -home <directory> set the path of your JDK or JRE installation (or set the JAVA_HOME environment variable) -version show the current Java environment version (to check correctness of -home and -jvm. Implies -nodetach) -help / -? show this help page (implies -nodetach) -nodetach don't detach from parent process and become a daemon -debug verbosely print debugging information -check only check service (implies -nodetach) -user user used to run the daemon (defaults to current user) -verbose[:class|gc|jni] enable verbose output -outfile </full/path/to/file> Location for output from stdout (defaults to /dev/null) Use the value '&2' to simulate '1>&2' -errfile </full/path/to/file> Location for output from stderr (defaults to /dev/null) Use the value '&1' to simulate '2>&1' -pidfile </full/path/to/file> Location for output from the file containing the pid of jsvc (defaults to /var/run/jsvc.pid) -D<name>=<value> set a Java system property -X<option> set Virtual Machine specific option </source> </p> </section> </body> </document> 1.1 jakarta-commons/daemon/xdocs/procrun.xml Index: procrun.xml =================================================================== <?xml version="1.0"?> <document> <properties> <title>Daemon : Procrun</title> <author email="[EMAIL PROTECTED]">Jean-Frederic Clere</author> </properties> <body> <section name="Introduction"> <p> Actualy only the win32 platforms are supported. </p> </section> <section name="Building"> <p> It is possible to use cygwin to build procrun. <a href="http://www.cygwin.com/";> cygwin</a> for more informations. </p> <todo/> </section> <section name="Using procrun"> <todo/> </section> </body> </document>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
