You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by jf...@apache.org on 2003/09/16 13:55:08 UTC
cvs commit: jakarta-commons/daemon/xdocs jsvc.xml procrun.xml index.xml
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="jfrederic.clere@fujitsu-siemens.con">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="jfrederic.clere@fujitsu-siemens.con">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>