commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jean-frederic clere <jfrederic.cl...@fujitsu-siemens.com>
Subject Re: cvs commit: jakarta-commons-sandbox/daemon/xdocs index.xml
Date Tue, 09 Jul 2002 17:15:49 GMT
Hi,

Add yourself to the developers list in project.xml file or tell me what should I 
put there.

Cheers

Jean-frederic


jfclere@apache.org wrote:
> jfclere     2002/07/09 09:21:07
> 
>   Added:       daemon   LICENSE.txt build-maven.xml project.xml
>                daemon/xdocs index.xml
>   Log:
>   Add maven needed files so a documentation could be generated.
>   
>   Revision  Changes    Path
>   1.1                  jakarta-commons-sandbox/daemon/LICENSE.txt
>   
>   Index: LICENSE.txt
>   ===================================================================
>   /*
>    * $Header: /home/cvs/jakarta-commons-sandbox/daemon/LICENSE.txt,v 1.1 2002/07/09 16:21:06
jfclere Exp $
>    * $Revision: 1.1 $
>    * $Date: 2002/07/09 16:21:06 $
>    *
>    * ====================================================================
>    * 
>    * The Apache Software License, Version 1.1
>    *
>    * Copyright (c) 1999-2002 The Apache Software Foundation.  All rights 
>    * reserved.
>    *
>    * Redistribution and use in source and binary forms, with or without
>    * modification, are permitted provided that the following conditions
>    * are met:
>    *
>    * 1. Redistributions of source code must retain the above copyright
>    *    notice, this list of conditions and the following disclaimer. 
>    *
>    * 2. Redistributions in binary form must reproduce the above copyright
>    *    notice, this list of conditions and the following disclaimer in
>    *    the documentation and/or other materials provided with the
>    *    distribution.
>    *
>    * 3. The end-user documentation included with the redistribution, if
>    *    any, must include the following acknowlegement:  
>    *       "This product includes software developed by the 
>    *        Apache Software Foundation (http://www.apache.org/)."
>    *    Alternately, this acknowlegement may appear in the software itself,
>    *    if and wherever such third-party acknowlegements normally appear.
>    *
>    * 4. The names "The Jakarta Project", "Commons", and "Apache Software
>    *    Foundation" must not be used to endorse or promote products derived
>    *    from this software without prior written permission. For written 
>    *    permission, please contact apache@apache.org.
>    *
>    * 5. Products derived from this software may not be called "Apache"
>    *    nor may "Apache" appear in their names without prior written
>    *    permission of the Apache Group.
>    *
>    * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
>    * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
>    * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
>    * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
>    * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
>    * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
>    * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
>    * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
>    * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
>    * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
>    * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
>    * SUCH DAMAGE.
>    * ====================================================================
>    *
>    * This software consists of voluntary contributions made by many
>    * individuals on behalf of the Apache Software Foundation.  For more
>    * information on the Apache Software Foundation, please see
>    * <http://www.apache.org/>.
>    *
>    */ 
>   
>   
>   
>   
>   
>   
>   
>   
>   1.1                  jakarta-commons-sandbox/daemon/build-maven.xml
>   
>   Index: build-maven.xml
>   ===================================================================
>   <?xml version="1.0"?>
>   
>   <project name="maven" default="maven:jar" basedir=".">
>   
>     <!-- Give user a chance to override without editing this file
>          (and without typing -D each time they invoke a target) -->
>   
>     <!-- Allow any user specific values to override the defaults -->
>     <property file="${user.home}/build.properties" />
>     <!-- Allow user defaults for this build -->
>     <property file="build.properties" />
>     <!-- Set default values for the project -->
>     <property file="project.properties" />
>   
>     <!-- maven:start -->
>     
>     <!-- ================================================================== -->
>     <!-- D E L E G A T O R S                                                -->
>     <!-- ================================================================== -->
>           
>   
>       <target name="maven:site">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="site"/>
>       </target>
>   
>   
>       <target name="maven:dist">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="dist"/>
>       </target>
>   
>   
>       <target name="maven:env">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="env"/>
>       </target>
>   
>   
>       <target name="maven:test">
>         <ant antfile="${maven.home}/plugins/test/build.xml" target="test"/>
>       </target>
>   
>   
>       <target name="maven:announce">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="announce"/>
>       </target>
>   
>   
>       <target name="maven:activity-log">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="activity-log"/>
>       </target>
>   
>   
>       <target name="maven:compile">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="compile"/>
>       </target>
>   
>   
>       <target name="maven:validate-war">
>         <ant antfile="${maven.home}/plugins/j2ee/build.xml" target="validate-war"/>
>       </target>
>   
>   
>       <target name="maven:pdf">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="pdf"/>
>       </target>
>   
>   
>       <target name="maven:iutest">
>         <ant antfile="${maven.home}/plugins/iutest/build.xml" target="iutest"/>
>       </target>
>   
>   
>       <target name="maven:deploy-site">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="deploy-site"/>
>       </target>
>   
>   
>       <target name="maven:deploy-dist">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="deploy-dist"/>
>       </target>
>   
>   
>       <target name="maven:war">
>         <ant antfile="${maven.home}/plugins/j2ee/build.xml" target="war"/>
>       </target>
>   
>   
>       <target name="maven:verify-project">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="verify-project"/>
>       </target>
>   
>   
>       <target name="maven:cvs-change-log">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="cvs-change-log"/>
>       </target>
>   
>   
>       <target name="maven:ear">
>         <ant antfile="${maven.home}/plugins/j2ee/build.xml" target="ear"/>
>       </target>
>   
>   
>       <target name="maven:cross-ref">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="cross-ref"/>
>       </target>
>   
>   
>       <target name="maven:update-jars">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="update-jars"/>
>       </target>
>   
>   
>       <target name="maven:validate-pom">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="validate-pom"/>
>       </target>
>   
>   
>       <target name="maven:install-jar">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="install-jar"/>
>       </target>
>   
>   
>       <target name="maven:fo">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="fo"/>
>       </target>
>   
>   
>       <target name="maven:javadocs">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="javadocs"/>
>       </target>
>   
>   
>       <target name="maven:validate-struts-war">
>         <ant antfile="${maven.home}/plugins/struts/build.xml" target="validate-struts-war"/>
>       </target>
>   
>   
>       <target name="maven:task-list">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="task-list"/>
>       </target>
>   
>   
>       <target name="maven:ejb">
>         <ant antfile="${maven.home}/plugins/j2ee/build.xml" target="ejb"/>
>       </target>
>   
>   
>       <target name="maven:docs">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="docs"/>
>       </target>
>   
>   
>       <target name="maven:clean">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="clean"/>
>       </target>
>   
>   
>       <target name="maven:dist-build">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="dist-build"/>
>       </target>
>   
>   
>       <target name="maven:metrics">
>         <ant antfile="${maven.home}/plugins/metrics/build.xml" target="metrics"/>
>       </target>
>   
>   
>       <target name="maven:docs-quick">
>         <ant antfile="${maven.home}/plugins/docs/build.xml" target="docs-quick"/>
>       </target>
>   
>   
>       <target name="maven:run-singletest">
>         <ant antfile="${maven.home}/plugins/test/build.xml" target="run-singletest"/>
>       </target>
>   
>   
>       <target name="maven:check-source">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="check-source"/>
>       </target>
>   
>   
>       <target name="maven:generate-reactor">
>         <ant antfile="${maven.home}/plugins/reactor/build.xml" target="generate-reactor"/>
>       </target>
>   
>   
>       <target name="maven:jar">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="jar"/>
>       </target>
>   
>   
>       <target name="maven:maven-update">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="maven-update"/>
>       </target>
>   
>   
>       <target name="maven:gump-descriptor">
>         <ant antfile="${maven.home}/plugins/core/build.xml" target="gump-descriptor"/>
>       </target>
>   
>   
>     <!-- maven:end -->
>   
>   </project>
>   
>   
>   
>   1.1                  jakarta-commons-sandbox/daemon/project.xml
>   
>   Index: project.xml
>   ===================================================================
>   <?xml version="1.0" encoding="UTF-8"?>
>   
>   <project>
>     <pomVersion>3</pomVersion>
>     <name>commons-daemon</name>
>     <id>commons-daemon</id>
>     <currentVersion>0.1-dev-0</currentVersion>
>     <organization>
>       <name>Apache Software Foundation</name>
>       <url>http://www.apache.org</url>
>     </organization>
>     <inceptionYear>2002</inceptionYear>
>     <package>org.apache.commons.daemon</package>
>     <shortDescription>Commons Daemon</shortDescription>
>   
>     <!-- Gump integration -->
>     <gumpRepositoryId>jakarta</gumpRepositoryId>
>     
>     <description>
>           Daemon are a set of Java interfaces and native code to control a
>           Java daemon. That is native code to start a Java application on
>           Unix based systems and Service in Win32 systems. 
>     </description>
>     
>     <url>http://jakarta.apache.org/commons/sandbox/daemon/</url>
>     <issueTrackingUrl>http://nagoya.apache.org/scarab/servlet/scarab/</issueTrackingUrl>
>     <siteAddress>jakarta.apache.org</siteAddress>
>     <siteDirectory>/www/jakarta.apache.org/commons/sandbox/daemon/</siteDirectory>
>     <distributionDirectory>/www/jakarta.apache.org/builds/jakarta-commons-sandbox/daemon/</distributionDirectory>
>     <repository>
>       <connection>scm:cvs:pserver:anoncvs@cvs.apache.org:/home/cvspublic:jakarta-commons-sandbox/daemon</connection>
>       <url>http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/daemon/</url>
>     </repository>
>     
>     <versions>
>       <version>
>         <id>b0</id>
>         <name>0.0-b0</name>
>         <tag>HEAD</tag>
>       </version>
>     </versions>
>     <branches></branches>
>     
>     <mailingLists>
>       <mailingList>
>         <name>Commons Dev List</name>
>         <subscribe>commons-dev-subscribe@jakarta.apache.org</subscribe>
>         <unsubscribe>commons-dev-unsubscribe@jakarta.apache.org</unsubscribe>
>         <archive>http://nagoya.apache.org/eyebrowse/SummarizeList?listName=commons-dev@jakarta.apache.org</archive>
>       </mailingList>
>     </mailingLists>
>     
>     <developers>
>       <!-- I have just put myself for the moment -->
>       <developer>
>         <name>Jean-Frederic Clere</name>
>         <id>jfclere</id>
>         <email>jfrederic.clere@fujitsu-siemens.com</email>
>         <organization>FSC</organization>
>       </developer>
>   
>     </developers>
>   
>     <dependencies>
>       
>       <!-- for doclets -->
>       <dependency>
>         <id>javadoc</id>
>         <version>1.3</version>
>       </dependency>
>       
>       <dependency>
>         <name>xmlParseAPIs</name>
>         <type>required</type>
>         <version>2.0.2</version>
>         <jar>xmlParserAPIs-2.0.2.jar</jar>
>       </dependency>
>       
>       <dependency>
>         <name>xercesImpl</name>
>         <type>required</type>
>         <version>2.0.2</version>
>         <jar>xercesImpl-2.0.2.jar</jar>
>       </dependency>
>       
>       <dependency>
>         <name>ant</name>
>         <version>1.4.1</version>
>         <jar>ant-1.4.1.jar</jar>
>       </dependency>
>       
>       <dependency>
>         <name>ant-optional</name>
>         <version>1.4.1</version>
>         <jar>ant-optional-1.4.1.jar</jar>
>       </dependency>
>   
>       <dependency>
>         <name>commons-logging</name>
>         <type>required</type>
>         <version>1.0</version>
>         <jar>commons-logging-1.0.jar</jar>
>       </dependency>
>   
>       <dependency>
>         <name>commons-collections</name>
>         <type>required</type>
>         <version>2.0</version>
>         <jar>commons-collections-2.0.jar</jar>
>       </dependency>
>     </dependencies>
>     <build>
>       <nagEmailAddress>commons-dev@jakarta.apache.org</nagEmailAddress>
>       <sourceDirectory>src/java</sourceDirectory>
>       <unitTestSourceDirectory>src/test</unitTestSourceDirectory>
>       <integrationUnitTestSourceDirectory/>
>       <aspectSourceDirectory/>
>       <!-- Unit test classes -->
>   
>       <unitTestPatterns>
>         <unitTestPattern>**/Test*.java</unitTestPattern>
>       </unitTestPatterns>
>       
>       <unitTest>
>         <includes>
>           <include>**/Test*.java</include>
>         </includes>
>       </unitTest>
>   
>       
>       <!-- Integration unit test classes -->
>   
>       <integrationUnitTestPatterns></integrationUnitTestPatterns>
>   
>       <!-- J A R  R E S O U R C E S -->
>       <!-- Resources that are packaged up inside the JAR file -->
>       <resources>
>         <includes>
>           <include>**/*.properties</include>
>         </includes>
>       </resources>
>   
>       <jarResources>
>         <jarResource>**/*.properties</jarResource>
>       </jarResources>
>       <jars></jars>
>     </build>
>   </project>
>   
>   
>   
>   1.1                  jakarta-commons-sandbox/daemon/xdocs/index.xml
>   
>   Index: index.xml
>   ===================================================================
>   <?xml version="1.0"?>
>    
>   <document>
>    
>    <properties>
>     <title>Daemon : Java based daemons or services</title>
>     <author email="jfrederic.clere@fujitsu-siemens.con">Jean-Frederic Clere</author>
>    </properties>
>   
>   <body>
>   <section name="Introduction">
>   <p>
>         Since 1994, the Java programming language evolved and became a
>         valid tool to develop, other than applets and client applications,
>         reliable and performant server applications. The major disadvantage of
>         the Java platform is that still today the only portable way to
>         start a Java application relies on a single point of entry: the
>         <CODE><EM CLASS="key">public static void</EM>
>         main(<EM CLASS="ref">String</EM>[])</CODE> method.
>   </p>
>   <p>
>         Having a single-point of entry is a valid solution for client
>         applications, where interactively a user can command to the application
>         to quit (which can terminate the Virtual Machine process at calling the
>         <CODE><EM CLASS="ref">System</EM>.exit(<EM CLASS="key">int</EM>)</CODE>
>         method), but in those cases where the application is not interactive
>         (server applications) there is currently no portable way to notify
>         the Virtual Machine of its imminent shutdown.
>   </p>
>   <p>
>         A server application written in Java might have to perform several tasks
>         before being able to shutdown the Virtual Machine process. For example
>         in the case of a Servlet container, before the VM process is shut down,
>         sessions might need to be serialized to disk, and web applications need
>         to be destroyed.
>   </p>
>   <p>
>         One common solution to this problem is to create (for example) a
>         <CODE><EM CLASS="ref">ServerSocket</EM></CODE> and wait
for a particular
>         message to be issued. When the message is received, all operations
>         required to shut down the server applications are performed and at the
>         end the <CODE><EM CLASS="ref">System</EM>.exit</CODE>
method is called
>         to terminate the Virtual Machine process. This method, however, implies
>         several disadvantages and risks: for example in case of a system-wide
>         shutdown, it might happen that the Virtual Machine process will be shut
>         down directly by the operating system, without notifying the running
>         server application. Or, for example, if an attacker finds out what is
>         the required message to send to the server, and discovers a way to send
>         this message to the running server application, he can easily interrupt
>         the operation of a server, bypassing all the security restrictions
>         implemented in the operating system.
>   </p>
>   <p>
>         Most multi-user operating systems already have a way in which server
>         applications are started and stopped, under Unix based operating systems
>         non interactive server applications are called <em>daemons</em> and
are
>         controlled by the operating system with a set of specified
>         <em>signals</em>. Under Windows such programs are called <em>services</em>
>         and are controlled by appropriate calls to specific functions defined in
>         the application binary, but although the ways of dealing with the problem
>         are different, in both cases the operating system can notify a server
>         application of its imminent shutdown, and the application has the
>         ability to perform certain tasks before its process of execution is
>         destroyed.
>   </p>
>   </section>
>   
>   <section name="Structure">
>   <p>
>         Daemon is made of 2 part. One written in C that makes the interface to
>         the operating system and the other in Java that provides the 
>         Daemon API.
>   </p>
>   </section>
>   
>   <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
>   </p>
>   </section>
>   <section name="Initial Source of the Package">
>   
>   <p>The original Java classes come from the Jakarta Tomcat 4.0 project.</p>
>   
>   <p>The proposed package name for the Daemon component is
>   <code>org.apache.commons.daemon</code>.
>   </p>
>   </section>
>   
>   </body>
>   </document>
>   
>   
>   
> 
> --
> To unsubscribe, e-mail:   <mailto:commons-dev-unsubscribe@jakarta.apache.org>
> For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.org>
> 
> 




--
To unsubscribe, e-mail:   <mailto:commons-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.org>


Mime
View raw message