<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY % javaents SYSTEM "javaman.ent">
%javaents;
]>
<?Pub UDT _bookmark _target>
<refentry id="rmiregistry-1">
<!--@(#)rmiregistry.1 1.13 01/03/14 SMI;-->
<refmeta><refentrytitle>rmiregistry</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">23 Apr 2001</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&java-release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright"> Copyright 2001 Sun Microsystems, Inc. All
rights reserved.  Copyright 2001 Sun Microsystems, Inc. Tous droits r&eacute;serv&eacute;s.
</refmiscinfo>
</refmeta>
<refnamediv><refname>rmiregistry</refname><refpurpose>Java remote object registry
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>rmiregistry</command><arg choice="opt"><replaceable>
port</replaceable></arg><arg choice="opt"><option>J</option><replaceable>
option</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<indexterm id="rmiregistry-1-indx-1"><primary sortas="Java remote object registry">
Java remote object registry &mdash; rmiregistry</primary></indexterm><indexterm
id="rmiregistry-1-indx-2"><primary sortas="rmiregistry">rmiregistry &mdash;
Java remote object registry</primary></indexterm><para>The Java&trade; <command>
rmiregistry</command> command creates and starts a remote object registry
on the specified port on the current host. If port number is omitted, the
registry is started on port 1099. The <command>rmiregistry</command> command
produces no output and is typically run in the background. For example:<informalexample>
<para><screen>example% <userinput>rmiregistry &amp;</userinput></screen></para>
</informalexample></para>
<para>A remote object registry is a bootstrap naming service that is used
by <acronym>RMI</acronym> servers on a host to bind remote objects to names.
Clients can then look up remote objects and make remote method invocations.
</para>
<para>The registry is typically used to locate the first remote object on
which an application needs to invoke methods. That object in turn provides
application-specific support for finding other objects.</para>
<para>The methods of the <literal>java.rmi.registry.LocateRegistry</literal>
class are used to get a registry operating on a particular host or host and
port.</para>
<para>The <acronym>URL</acronym>-based methods of the  <literal>java.rmi.Naming
</literal> class operate on a registry and can be used to look up a remote
object, bind a simple (string) name to a remote object, rebind a new name
to a remote object (overriding the old binding), unbind a remote object, and
list the <acronym>URL</acronym>s bound in the registry.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<para>The following option is supported:</para>
<variablelist termlength="narrow">
<varlistentry><term remap="15"><option>J</option><replaceable>option</replaceable> 
</term><listitem><para>Used in conjunction with any java option, this option
passes <replaceable>option</replaceable> (no spaces between <option>J</option>
and <replaceable>option</replaceable>) on to the java interpreter.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&attr-tt;</title>
<para>See <citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>
5</manvolnum></citerefentry> <?Pub Caret1>for a description of the following
attributes:</para>
<informaltable frame="all" orient="port">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colnum="1" colname="col1"
colwidth="1*" colsep="1" align="left"><colspec colnum="2" colname="col2" colwidth="1*"
align="left">
<thead>
<row><entry colname="col1" align="center" valign="top">ATTRIBUTE TYPE</entry>
<entry colname="col2" align="center" valign="top">ATTRIBUTE VALUE</entry>
</row>
</thead>
<tbody>
<row><entry>Availability</entry><entry>SUNWj3rt, SUNWj3dev</entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1><title>&also-tt;</title>
<para><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5
</manvolnum></citerefentry> </para>
<para>See (or search <literal>java.sun.com</literal>) for the following:</para>
<variablelist termlength="wholeline">
<varlistentry><term remap="5"><literal>java.rmi.Naming</literal> <literal>
@</literal> </term><listitem><para><ulink url="http://java.sun.com/j2se/1.4/docs/api/java/rmi/Naming.html"></ulink>http://java.sun.com/j2se/1.4/docs/api/java/rmi/Naming.html
</para>
</listitem></varlistentry>
<varlistentry><term remap="5"><literal>java.rmi.registry.LocateRegistry</literal> <literal>
@</literal> </term><listitem><para><ulink url="http://java.sun.com/j2se/1.4/docs/api/java/rmi/registry/LocateRegistry.html"></ulink>http://java.sun.com/j2se/1.4/docs/api/java/rmi/registry/LocateRegistry.html
</para>
</listitem></varlistentry>
</variablelist></refsect1>
<!--+ 07/27/00 08:36:00
    | tagMorph:  $Id: tagMorph-engine 1.54 1998/01/19 05:44:48 $
    | tagMorph library:  $Id: libtagMorph.a 1.50 1998/01/19 22:02:51 $
    | sunman-to-solbook 1.17
    +-->
</refentry>
<?Pub *0000005259>
