* gcj.texi (Extensions): Document gcjlib URLs.

From-SVN: r70891
This commit is contained in:
Tom Tromey 2003-08-28 22:11:51 +00:00 committed by Tom Tromey
parent a2a919aa50
commit ff2865f2dd
2 changed files with 19 additions and 0 deletions

View File

@ -1,3 +1,7 @@
2003-08-28 Tom Tromey <tromey@redhat.com>
* gcj.texi (Extensions): Document gcjlib URLs.
2003-08-20 Tom Tromey <tromey@redhat.com>
* gcj.texi (Extensions): Added xref.

View File

@ -546,6 +546,21 @@ the @code{libgcj} bytecode interpreter to load the class from the standard
classpath. This process can be controlled to some degree via the
@code{gnu.gcj.runtime.VMClassLoader.library_control} property;
@xref{libgcj Runtime Properties}.
@item
@code{libgcj} includes a special @samp{gcjlib} URL type. A URL of
this form is like a @code{jar} URL, and looks like
@samp{gcjlib:/path/to/shared/library.so!/path/to/resource}. An access
to one of these URLs causes the shared library to be @code{dlopen()}d,
and then the resource is looked for in that library. These URLs are
most useful when used in conjunction with @code{java.net.URLClassLoader}.
Note that, due to implementation limitations, currently any such URL
can be accessed by only one class loader, and libraries are never
unloaded. This means some care must be exercised to make sure that
a @code{gcjlib} URL is not accessed by more than one class loader at once.
In a future release this limitation will be lifted, and such
libraries will be mapped privately.
@end itemize
@node Invoking gcjh