src/share/classes/java/lang/System.java

*** 1035,1047 ****
      public static void runFinalizersOnExit(boolean value) {
          Runtime.runFinalizersOnExit(value);
      }
  
      /**
!      * Loads a code file with the specified filename from the local file
!      * system as a dynamic library. The filename
!      * argument must be a complete path name.
       * <p>
       * The call <code>System.load(name)</code> is effectively equivalent
       * to the call:
       * <blockquote><pre>
       * Runtime.getRuntime().load(name)
--- 1035,1061 ----
      public static void runFinalizersOnExit(boolean value) {
          Runtime.runFinalizersOnExit(value);
      }
  
      /**
!      * Loads the native library specified by the filename argument.  The filename 
!      * argument must be an absolute path name.
!      *  
!      * If the filename argument, when stripped of any platform-specific library 
!      * prefix, path, and file extension, indicates a library whose name is,
!      * for example, L, and a native library called L is statically linked
!      * with the native application or the VM (which itself may be statically
!      * linked into the native application), then the JNI_OnLoad_L
!      * function exported by the library is invoked rather than attempting
!      * to load a dynamic library.
!      * A filename matching the argument does not have to exist in the
!      * file system.
!      * See the JNI Specification for more details.
!      * 
!      * Otherwise, the filename argument is mapped to a native library image in 
!      * an implementation-dependent manner.
!      * 
       * <p>
       * The call <code>System.load(name)</code> is effectively equivalent
       * to the call:
       * <blockquote><pre>
       * Runtime.getRuntime().load(name)
*** 1049,1072 ****
       *
       * @param      filename   the file to load.
       * @exception  SecurityException  if a security manager exists and its
       *             <code>checkLink</code> method doesn't allow
       *             loading of the specified dynamic library
!      * @exception  UnsatisfiedLinkError  if the file does not exist.
       * @exception  NullPointerException if <code>filename</code> is
       *             <code>null</code>
       * @see        java.lang.Runtime#load(java.lang.String)
       * @see        java.lang.SecurityManager#checkLink(java.lang.String)
       */
      public static void load(String filename) {
          Runtime.getRuntime().load0(getCallerClass(), filename);
      }
  
      /**
!      * Loads the system library specified by the <code>libname</code>
!      * argument. The manner in which a library name is mapped to the
!      * actual system library is system dependent.
       * <p>
       * The call <code>System.loadLibrary(name)</code> is effectively
       * equivalent to the call
       * <blockquote><pre>
       * Runtime.getRuntime().loadLibrary(name)
--- 1063,1096 ----
       *
       * @param      filename   the file to load.
       * @exception  SecurityException  if a security manager exists and its
       *             <code>checkLink</code> method doesn't allow
       *             loading of the specified dynamic library
!      * @exception  UnsatisfiedLinkError  if either the filename is not an 
!      *             absolute path name, the native library is not statically 
!      *             linked with the VM, or the library cannot be mapped to 
!      *             a native library image by the host system.
       * @exception  NullPointerException if <code>filename</code> is
       *             <code>null</code>
       * @see        java.lang.Runtime#load(java.lang.String)
       * @see        java.lang.SecurityManager#checkLink(java.lang.String)
       */
      public static void load(String filename) {
          Runtime.getRuntime().load0(getCallerClass(), filename);
      }
  
      /**
!      * Loads the native library specified by the <code>libname</code> 
!      * argument.  The <code>libname</code> argument must not contain any platform 
!      * specific prefix, file extension or path. If a native library 
!      * called <code>libname</code> is statically linked with the VM, then the 
!      * JNI_OnLoad_<code>libname</code> function exported by the library is invoked. 
!      * See the JNI Specification for more details.
!      *  
!      * Otherwise, the libname argument is loaded from a system library 
!      * location and mapped to a native library image in an implementation-
!      * dependent manner.
       * <p>
       * The call <code>System.loadLibrary(name)</code> is effectively
       * equivalent to the call
       * <blockquote><pre>
       * Runtime.getRuntime().loadLibrary(name)
*** 1074,1084 ****
       *
       * @param      libname   the name of the library.
       * @exception  SecurityException  if a security manager exists and its
       *             <code>checkLink</code> method doesn't allow
       *             loading of the specified dynamic library
!      * @exception  UnsatisfiedLinkError  if the library does not exist.
       * @exception  NullPointerException if <code>libname</code> is
       *             <code>null</code>
       * @see        java.lang.Runtime#loadLibrary(java.lang.String)
       * @see        java.lang.SecurityManager#checkLink(java.lang.String)
       */
--- 1098,1111 ----
       *
       * @param      libname   the name of the library.
       * @exception  SecurityException  if a security manager exists and its
       *             <code>checkLink</code> method doesn't allow
       *             loading of the specified dynamic library
!      * @exception  UnsatisfiedLinkError if either the libname argument 
!      *             contains a file path, the native library is not statically 
!      *             linked with the VM,  or the library cannot be mapped to a 
!      *             native library image by the host system.
       * @exception  NullPointerException if <code>libname</code> is
       *             <code>null</code>
       * @see        java.lang.Runtime#loadLibrary(java.lang.String)
       * @see        java.lang.SecurityManager#checkLink(java.lang.String)
       */