<refmiscinfo class="copyright"> Copyright 2001 Sun Microsystems, Inc. All rights reserved. Copyright 2001 Sun Microsystems, Inc. Tous droits réservés.</refmiscinfo>
<indexterm id="rmiregistry-1-indx-1"><primary sortas="Java remote object registry">Java remote object registry — rmiregistry</primary></indexterm><indexterm id="rmiregistry-1-indx-2"><primary sortas="rmiregistry">rmiregistry — Java remote object registry</primary></indexterm><para>The Java™ <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 &</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 <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink> for a description of the following attributes:</para>