javald

 

---

 
 
 
 User Commands                                           javald(1)
 
 
 


NAME
      javald - wrapper creator for java application
 


SYNOPSIS
      /usr/java/bin/javald [ -C path ] [ -H dir ]
           [ -j option-list ] [ -o outfile ] [ -R path ] classname
 


DESCRIPTION
      The javald command creates a convenient  wrapper  that  cap-
      tures  the necessary environment needed to run a Java appli-
      cation specified by classname. If the -o option is provided,
      the  resulting  executable  wrapper  is  outfile.  If the -o
      option is not specified, then the default used is  the  name
      of the class.
 
      This wrapper sets the necessary environment variables needed
      by  java(1)  before  it  executes  the  class  specified  by
      classname.
 
      If the -H flag is specified, the wrapper sets  JAVA_HOME  to
      the path specified by the option. If -H option is not speci-
      fied, the wrapper attempts to  use  the  user's  environment
      JAVA_HOME  if  set; otherwise it assumes a default JAVA_HOME
      of /usr/java.
 
      Paths specified as arguments to the -C and -R flags  of  the
      javald command are treated differently.
 
      The path arguments, which may include shell  variables,  are
      subject  to  deferred evaluation that is, they are evaluated
      when the wrapper is executed.
 
      Relative pathnames are treated as pathnames relative to  the
      directory  where  the  wrapper is installed, not the current
      working directory.
 
      This behavior is designed to support applications that  con-
      sist of several classes in a directory hierarchy rather than
      a single executable.  Using relative pathnames  allows  this
      directory hierarchy (thus the application) to be more easily
      moved to different filesystems.
 
      The default CLASSPATH  created  by  the  wrapper  if  no  -C
      options are used is equivalent to specifying -C.
 
      The  default  interpreter  executed  by   the   wrapper   is
      $JAVA_HOME/bin/java.
 


OPTIONS
      The following options are supported:
 
      -C path        Adds path, to the  run-time  CLASSPATH.  This
 
 
 
 SunOS 5.8           Last change: 12 June 1997                   1
 
 
 
 
 
 
 User Commands                                           javald(1)
 
 
 
                     specifies  where java(1) will search for Java
                     classes.  See DESCRIPTION for a discussion of
                     the run-time evaluation of these pathnames.
 
                     The -C option can be repeated, such as
 
                          example%   javald   -C   /usr/class   -C
                          /optjava...
 
 
      -H dir         Sets JAVA_HOME to dir.
 
      -j option-list Allows the set of options to be passed to the
                     invocation  of  java(1)  to be set.  If there
                     are multiple options, they should  be  quoted
                     to  ensure  that  they  are  passed  into the
                     resulting wrapper.
 
      -o outfile     Places the wrapper in outfile.
 
      -R path        Adds path to  the  run-time  LD_LIBRARY_PATH.
                     This  specifies where java(1) will search for
                     native methods.  See DESCRIPTION for  a  dis-
                     cussion  of  the run-time evaluation of these
                     pathnames.
 
 EXAMPLES
   Example 1:
      A wrapper appl is created in /opt/acme/bin
 
           example%    javald     -o     /opt/acme/bin/appl     -C
           /opt/acme/classes acmeApp
 
      that contains the following environment variables:
 
           JAVA_HOME=${JAVA_HOME:-/usr/java}
           CLASSPATH=/opt/acme/classes
 
      When appl is run, java(1) will attempt to invoke the  main()
      method  of  the acmeApp class.  The java(1) interpreter will
      search for acmeApp in /opt/acme/classes, then in the default
      system class directory, ${JAVA_HOME}/lib/classes.zip.
 
   Example 2:
      The following command creates a script called myapp:
 
           example% javald -o myapp -j '-noverify -ms8m' myapp
 
      which contains an invocation of the java(1) interpreter that
      looks like:
 
           example%  exec  {JAVA_HOME}/bin/java  -noverify   -ms8m
 
 
 
 SunOS 5.8           Last change: 12 June 1997                   2
 
 
 
 
 
 
 User Commands                                           javald(1)
 
 
 
           myapp
 
 
 ENVIRONMENT VARIABLES
      JAVA_HOME      Use the  JAVA_HOME  environment  variable  to
                     specify the java (1) runtime.
 


FILES
      /usr/java/lib/classes.zip
                          Archive of Java runtime classes.  Please
                          note   that  it  does  not  need  to  be
                          unzipped.
 


ATTRIBUTES
      See attributes(5) for a description of the following  attri-
      butes:
 
      __________________________________
     | ATTRIBUTE TYPE|  ATTRIBUTE VALUE|
     |_______________|_________________|
     | Availability  |  SUNWjvrt       |
     |_______________|_________________|
 


SEE ALSO
      java(1)
 
      The Java Tutorial @
                http://java.sun.com:80/docs/books/tutorial/index.html
 
      For information on related topics, use the search link @
                http://java.sun.com/
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 12 June 1997                   3
 
 
 

---