commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jfcl...@apache.org
Subject cvs commit: jakarta-commons/daemon/xdocs jsvc.xml procrun.xml index.xml
Date Tue, 16 Sep 2003 11:55:08 GMT
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=&lt;dir&gt; 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 &lt;JVM name&gt;
          use a specific Java Virtual Machine. Available JVMs:
              '(null)'
      -cp / -classpath &lt;directories and zip/jar files&gt;
          set search path for service classes and resouces
      -home &lt;directory&gt;
          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 &lt;/full/path/to/file&gt;
          Location for output from stdout (defaults to /dev/null)
          Use the value '&amp;2' to simulate '1&gt;&amp;2'
      -errfile &lt;/full/path/to/file&gt;
          Location for output from stderr (defaults to /dev/null)
          Use the value '&amp;1' to simulate '2&gt;&amp;1'
      -pidfile &lt;/full/path/to/file&gt;
          Location for output from the file containing the pid of jsvc
          (defaults to /var/run/jsvc.pid)
      -D&lt;name&gt;=&lt;value&gt;
          set a Java system property
      -X&lt;option&gt;
          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>
  
  
  

Mime
View raw message