home *** CD-ROM | disk | FTP | other *** search
/ c't freeware shareware 2001 January / CT_SW0101.ISO / pc / software / kommunik / p2p / limewin.exe / Windows / resource / jre / README < prev   
Text File  |  2001-05-09  |  16KB  |  407 lines
  1.  
  2.                               README
  3.  
  4.                   The Java(tm) Runtime Environment
  5.                             JRE 1.1.8
  6.  
  7.  
  8.     Updates to these release notes will be posted on the Java 
  9.     Software website:
  10.  
  11.         http://java.sun.com/products/jdk/1.1/README-update.html
  12.  
  13. -----------------------------------------------------------------------
  14. CONTENTS
  15.  
  16.   Overview of the Java Runtime Environment
  17.     - Introduction
  18.     - The Java Runtime Interpreter
  19.     - Required vs. Optional Files
  20.     - Win 32 Files 
  21.        - Optional Files
  22.     - Solaris Files 
  23.        - Optional Files
  24.  
  25.   Bundling and Running the Java Runtime
  26.     - Bundling the Java Runtime
  27.     - Runtime Documentation
  28.  
  29.  
  30. =======================================================================
  31.                  Overview of the Java Runtime Environment
  32. =======================================================================
  33.  
  34. -----------------------------------------------------------------------
  35. Introduction
  36. -----------------------------------------------------------------------
  37.  
  38. The Java Runtime Environment is the minimum standard Java Platform for 
  39. running Java programs.  It contains the Java virtual machine, Java core 
  40. classes and supporting files. 
  41.  
  42. The JRE includes all of the non-debuggable .dll or .so files plus
  43. the necessary classes from the JDK software to support a runtime-only 
  44. program.  The JRE does not include any of the development tools
  45. (such as appletviewer or javac) or classes that would pertain only 
  46. to a development system.
  47.  
  48. The JRE can be invoked from the command line by using the jre tool 
  49. (see the following section). On Windows platforms, the jre tool will 
  50. ignore the CLASSPATH environment variable. For both Windows and 
  51. Solaris platforms, the -cp option is recommended to specify an 
  52. application's class path.
  53.  
  54. This version of the Java Runtime Environment contains a JIT compiler.  
  55. The JIT compiler is enabled by default on the Win32 JRE.  To disable 
  56. the compiler, you can use the -nojit option of the Java runtime 
  57. interpreter (see following section).
  58.  
  59. The Symantec JIT compiler is copyrighted (c), 1996-1999, by Symantec 
  60. Corporation. All rights reserved.
  61.  
  62. The Win32 version of the JRE has an installer suitable for use 
  63. by end-users. This gives software developers the option of not 
  64. bundling the JRE with their applications. Instead, they can direct 
  65. end-users to download and install the JRE themselves.
  66.  
  67. An installer is not available for Solaris versions of the JRE. 
  68. Developers should bundle the JRE and an installer with their Solaris 
  69. applications. 
  70.  
  71. Licensees, developers, and independent software vendors who distribute 
  72. the JRE with their Java programs must follow the terms of the JRE 
  73. Binary Code License agreement, which includes these terms:
  74.  
  75.  - Don't arbitrarily subset the JRE. You may omit only the
  76.    files listed below as optional.  See the section entitled 
  77.    Required vs. Optional Files. 
  78.  
  79.  - Include in your product's license the provisions called out
  80.    in the JRE Binary Code License.
  81.  
  82. Comments regarding the JRE are welcome. Please send them to 
  83. jre-comments@java.sun.com. Due to the large volume of email received 
  84. each day, Java Software usually cannot respond to your email 
  85. personally.
  86.     
  87. The JRE is a product of Sun Microsystems, Inc.  
  88.  
  89.  
  90. -----------------------------------------------------------------------
  91. The Java Runtime Interpreter
  92. -----------------------------------------------------------------------
  93.  
  94. The jre tool invokes the Java Runtime interpreter for executing Java 
  95. applications. The tool is available in the Win32, Solaris-Sparc, and 
  96. Solaris x86 downloads of the JRE. The syntax for the jre command is:
  97.  
  98.     jre [ options ] classname <args>
  99.  
  100. The classname argument is the name of the class file to be 
  101. executed. Any arguments to be passed to the class must be placed 
  102. after the classname on the command line.
  103.  
  104. An alternative version of the tool, jrew, is available for Win32. The 
  105. jrew command is identical to jre, except that a console window is not 
  106. invoked. The syntax of the jrew command is 
  107.  
  108.     jrew [ options ] classname <args>
  109.  
  110. On Windows platforms, the jre tool will ignore the CLASSPATH 
  111. environment variable. For both Windows and Solaris platforms, the 
  112. -cp option is recommended to specify an application's class path.
  113.  
  114. Options for the jre and the jrew commands are as follows:
  115.  
  116.    -classpath path    Specifies the path that jre uses to 
  117.                look up classes. Overrides the default 
  118.                classpath.  
  119.  
  120.    -cp path        Prepends the specified path to the default 
  121.                classpath that jre uses to look up classes. 
  122.  
  123.    -help        Print a usage message.
  124.  
  125.    -mx x        Sets the maximum size of the memory allocation 
  126.                pool (the garbage collected heap) to x. The 
  127.                default is 16 megabytes of memory. x must be
  128.             greater than or equal to 1000 bytes.
  129.  
  130.    -ms x        Sets the startup size of the memory allocation 
  131.                pool (the garbage collected heap) to x. The 
  132.                default is 1 megabyte of memory. x must be
  133.             greater than 1000 bytes.
  134.  
  135.    -maxe<size>          Sets the maximum size of each expansion of the 
  136.                         heap when more memory is required.  Example: 
  137.  
  138.                            jre -maxe2097152 MyClass
  139.  
  140.    -mine<size>          Sets the minimum size of each expansion of the 
  141.                         heap. Also sets the minimum size of free object 
  142.                         space in the heap. Example: 
  143.  
  144.                            jre -mine1048576 MyClass 
  145.  
  146.    -maxf<float>         Sets the approximate percentage of maximum free 
  147.                         heap. Example: 
  148.  
  149.                            jre -maxf0.60 MyClass
  150.  
  151.    -minf<float>         Sets the approximate percentage of minimum free 
  152.                         space in the heap to give control over the rate 
  153.                         of preallocation performed when heap space is 
  154.                         expanded. Example: 
  155.  
  156.                            jre -minf0.35 MyClass
  157.  
  158.    -noasyncgc        Turns off asynchronous garbage collection. When 
  159.                activated, no garbage collection takes place 
  160.                unless it is explicitly called or the program 
  161.             runs out of memory.
  162.  
  163.    -noclassgc        Turns off garbage collection of Java classes. 
  164.                By default, the Java interpreter reclaims space 
  165.                for unused Java classes during garbage collection.
  166.  
  167.    -nojit        Don't invoke the Just In Time bytecode
  168.                 compiler. The virtual machine directly
  169.             interprets bytecodes, without converting them
  170.             to native code.
  171.  
  172.    -ss x        The -ss option sets the maximum stack size that 
  173.                can be used by C code in a thread to x. The 
  174.             default units for x are bytes. The value of x 
  175.             must be greater than or equal to 1000 bytes.
  176.  
  177.    -oss x        The -oss option sets the maximum stack size 
  178.             that can be used by Java code in a thread to x. 
  179.             The default units for x are bytes. The value of 
  180.             x must be greater than or equal to 1000 bytes.
  181.  
  182.    -v, -verbose        Causes jre to print a message to stdout each 
  183.             time a class file is loaded.
  184.  
  185.    -verify        Performs byte-code verification on the class 
  186.             file. Beware, however, that java -verify does 
  187.             not perform a full verification in all 
  188.             situations. Any code path that is not actually 
  189.             executed by the interpreter is not verified. 
  190.             Therefore, java -verify cannot be relied upon to 
  191.             certify class files unless all code paths in 
  192.             the class file are actually run.
  193.  
  194.    -verifyremote    Runs the verifier on all code that is loaded 
  195.             into the system via a classloader. verifyremote 
  196.             is the default for the interpreter.
  197.  
  198.    -noverify        Turns verification off.
  199.  
  200.    -verbosegc        Causes the garbage collector to print out 
  201.             messages whenever it frees memory.
  202.    
  203.    -DpropName=value    Defines a property value. propName is the name 
  204.             of the property whose value you want to change 
  205.             and value is the value to change it to. For 
  206.             example, the command 
  207.             java -Dawt.button.color=green ...
  208.             sets the value of the property awt.button.color 
  209.             to "green".
  210.  
  211.  
  212. -----------------------------------------------------------------------
  213. Required vs. Optional Files
  214. -----------------------------------------------------------------------
  215.  
  216. Licensees must follow the terms of the accompanying LICENSE when 
  217. redistributing the JRE.  The following sections contain lists of the 
  218. JRE files for both Win32 and Solaris platforms that may optionally be 
  219. excluded from redistributions of the JRE.  All files not in these lists 
  220. of optional files must be included in redistributions of the JRE.
  221.  
  222. In the case of the Win32 JRE, the native code C runtime library, 
  223. msvcrt.dll, is located in the Windows system directory. The location of 
  224. this directory varies on different operating systems, but is usually
  225.  
  226.    - winnt\system32 on Windows NT
  227.    - windows98\system on Windows 98
  228.    - windows\system on Windows 95
  229.  
  230. The msvcrt.dll file should be included in redistributions of the 
  231. Win32 JRE.
  232.  
  233. -----------------------------------------------------------------------
  234. Win32 Optional Files and Directories
  235. -----------------------------------------------------------------------
  236. All font properties files in the lib directory other than the default 
  237. lib\font.properties file are optional, and vendors may choose not to 
  238. include them in redistributions of the JRE. In addition, the following 
  239. may be optionally excluded from redistributions:
  240.  
  241. bin\javakey.exe         
  242.    Executable for Javakey, the Java Security Tool
  243. bin\rmiregistry.exe         
  244.    Executable for rmiregistry, the Remote Object Registry Tool
  245. bin\symcjit.dll               
  246.    JIT compiler
  247. lib\i18n.jar                  
  248.    Character conversion classes and all other locale support
  249.  
  250.  
  251. -----------------------------------------------------------------------
  252. Solaris Optional Files and Directories
  253. -----------------------------------------------------------------------
  254. The symbol '<sys>' used in the pathnames of this section stands for 
  255. the 'sparc' directories in the Solaris-SPARC JRE and the 'i386' 
  256. directories in the Solaris-x86 JRE.
  257.  
  258. The Solaris version of the JRE uses a threads implementation called 
  259. "green threads".  Files providing support for green threads are in the 
  260. directories lib/<sys>/green_threads and bin/<sys>green_threads.  
  261. Another implementation of threads called "native threads" is available 
  262. in the Solaris Native Threads Pack.  If the Solaris Native Threads Pack 
  263. is installed, its files will be in the directories 
  264. lib/<sys>native_threads and bin/<sys>/native_threads.  With the 
  265. exception of the optional files listed below, you must include either 
  266. the entire set of green threads files, or the entire set of native 
  267. threads files, or both entire sets, when redistributing the JRE.  
  268.  
  269. All font properties files in the lib directory other than the default 
  270. lib\font.properties file are optional, and vendors may choose not to 
  271. include them in redistributions of the JRE. In addition, the following 
  272. may be optionally excluded from redistributions:
  273.  
  274. bin/javakey             
  275.    Shell script for launching Javakey, the Java Security Tool
  276. bin/rmiregistry             
  277.    Shell script for launching rmiregistry
  278. bin/<sys>/green_threads/javakey         
  279.    Executable for Javakey (green threads)
  280. bin/<sys>/native_threads/javakey         
  281.    Executable for Javakey (native threads)
  282. bin/<sys>/green_threads/rmiregistry         
  283.    Executable for rmiregistry (green threads)
  284. bin/<sys>/native_threads/rmiregistry         
  285.    Executable for rmiregistry (native threads)
  286. lib/i18n.jar
  287.    Character conversion classes and all other locale support
  288. lib/<sys>/green_threads/libXm.so            
  289.    Symbolic link to Motif runtime library (green threads)
  290. lib/<sys>/native_threads/libXm.so            
  291.    Symbolic link to Motif runtime library (native threads)
  292. lib/<sys>/green_threads/libXm.so.3          
  293.    Motif runtime library (green threads)
  294. lib/<sys>/native_threads/libXm.so.3
  295.    Motif runtime library (native threads)
  296.  
  297.  
  298. =======================================================================
  299.                 Bundling and Running the Java Runtime
  300. =======================================================================
  301.  
  302. -----------------------------------------------------------------------
  303. Bundling the Java Runtime
  304. -----------------------------------------------------------------------
  305.  
  306. Information relating to redistributing the Java Runtime Environment with 
  307. your applications can be found in the JRE Notes of Developers web site.
  308.  
  309.    http://java.sun.com/products/jdk/1.1/runtime.html
  310.  
  311. This release of the JRE for Win32 comes with its own installer that 
  312. makes is suitable for downloading by end users. Java application 
  313. developers have the option of not bundling the JRE with their software. 
  314. Instead, they can direct end-users to download and install the JRE 
  315. themselves.
  316.  
  317. Solaris versions of the JRE do not have an installer. Software 
  318. developers should bundle the JRE and installer with their Solaris 
  319. software. 
  320.  
  321. When bundling the JRE with application software on Solaris, the 
  322. following points should be considered:
  323.  
  324. 1) It is suggested that the JRE be installed in its own subdirectory
  325.    (referred to below as <runtime-dir>).  Include all the the required
  326.    files listed above in the bin and lib subdirectories of 
  327.    <runtime-dir>, following the same directory hierarchy and 
  328.    relative placement of files.  The internationalization files 
  329.    marked optional can be included for language localization support.
  330.  
  331. 2) It is suggested that all application-specific classes be placed 
  332.    in a directory other than <runtime-dir>. Application-specific 
  333.    classes may be individual .class files, .jar files, or .zip 
  334.    files.
  335.  
  336.    An example directory structure might look like the following:
  337.  
  338.                <app-dir>
  339.        ________________|___________
  340.       |         |               |
  341.          bin       lib           <runtime-dir>
  342.           |         |          ________|________
  343.                  app.jar      |                 | 
  344.                              bin               lib         
  345.                               |                 |
  346.                        
  347.  
  348. 3) If native code support is required, then the native library must be 
  349.    located in LD_LIBRARY_PATH on Solaris or the executable search PATH 
  350.    on Win32. The best way to do this is to install the native libraries
  351.    in either <app-dir>/lib/<sys> on Solaris or <app-dir>\bin 
  352.    on Win32. LD_LIBRARY_PATH (on Solaris) or PATH (on Win32) should 
  353.    then be set to include these directories.
  354.  
  355. 4) The application can be invoked by using the jre command-line tool, 
  356.    using the -cp option to specify the application's class path. In 
  357.    the example directory tree above, for example, the command might 
  358.    look like this:
  359.  
  360.    <app-dir>/<runtime-dir>/bin/jre -cp <app-dir>/lib/app.jar <classname>
  361.  
  362.    Information on the jre command-line tool can be found in the section 
  363.    "The Java Runtime Interpreter" above and on the Java Software web 
  364.    site.
  365.    
  366.      For Solaris:
  367.      http://java.sun.com/products/jdk1.1/docs/tooldocs/solaris/jre.html
  368.    
  369.      For Win32:
  370.      http://java.sun.com/products/jdk1.1/docs/tooldocs/win32/jre.html
  371.  
  372.    Source code for the jre tool can be found in the Win32 JDK 1.1.8 
  373.    directory tree in the jdk1.1.8\demo\jre\win32 folder. For the 
  374.    Solaris JDK 1.1.8, jre source code files can be found in the 
  375.    jdk1.1.8/demo/jre/solaris directory.
  376.  
  377.  
  378. -----------------------------------------------------------------------
  379. Runtime Documentation
  380. -----------------------------------------------------------------------
  381.  
  382. Runtime documentation is any documentation that an end-user might
  383. need after they have installed a Java program that runs on the JRE.
  384.  
  385. We supply the following runtime documentation:
  386.  
  387.   - Each property file contains comments that describe what the
  388.     file is useful for and how to modify it.
  389.  
  390.   - awt.properties file - KeyEvent uses it to print out properties of
  391.     key events, usually for debugging purposes.  This might be used
  392.     by a GUI debugger that needs to print out events.
  393.  
  394.   - fontprop.html file has a web page describing how to add 
  395.     fonts to the runtime.  This document is part of the 
  396.     JDK documentation, and is located both in the JDK documentation
  397.     download bundle and at the JavaSoft website:
  398.  
  399.     http://java.sun.com/products/jdk/1.1/docs/guide/intl/fontprop.html
  400.  
  401.  
  402. -----------------------------------------------------------------------
  403. Copyright (c) 1997-2000 Sun Microsystems, Inc.
  404. 901 San Antonio Rd., Palo Alto, CA 94303 USA.
  405. All rights reserved.
  406.  
  407.