| --- |
| # Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. |
| # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| # |
| # This code is free software; you can redistribute it and/or modify it |
| # under the terms of the GNU General Public License version 2 only, as |
| # published by the Free Software Foundation. |
| # |
| # This code is distributed in the hope that it will be useful, but WITHOUT |
| # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| # version 2 for more details (a copy is included in the LICENSE file that |
| # accompanied this code). |
| # |
| # You should have received a copy of the GNU General Public License version |
| # 2 along with this work; if not, write to the Free Software Foundation, |
| # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| # |
| # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| # or visit www.oracle.com if you need additional information or have any |
| # questions. |
| # |
| |
| title: 'RMIREGISTRY(1) JDK @@VERSION_SHORT@@ | JDK Commands' |
| date: @@COPYRIGHT_YEAR@@ |
| lang: en |
| --- |
| |
| ## Name |
| |
| rmiregistry - create and start a remote object registry on the specified port |
| on the current host |
| |
| ## Synopsis |
| |
| `rmiregistry` \[*options*\] \[*port*\] |
| |
| *options* |
| : This represents the option for the `rmiregistry` command. See |
| [Options] |
| |
| *port* |
| : The number of a port on the current host at which to start the remote |
| object registry. |
| |
| ## Description |
| |
| The `rmiregistry` command creates and starts a remote object registry on the |
| specified port on the current host. If the port is omitted, then the registry |
| is started on port 1099. The `rmiregistry` command produces no output and is |
| typically run in the background, for example: |
| |
| > `rmiregistry &` |
| |
| A remote object registry is a bootstrap naming service that's used by RMI |
| servers on the same host to bind remote objects to names. Clients on local and |
| remote hosts can then look up remote objects and make remote method |
| invocations. |
| |
| The registry is typically used to locate the first remote object on which an |
| application needs to call methods. That object then provides |
| application-specific support for finding other objects. |
| |
| The methods of the `java.rmi.registry.LocateRegistry` class are used to get a |
| registry operating on the local host or local host and port. |
| |
| The URL-based methods of the `java.rmi.Naming` class operate on a registry and |
| can be used to: |
| |
| - Bind the specified name to a remote object |
| |
| - Return an array of the names bound in the registry |
| |
| - Return a reference, a stub, for the remote object associated with the |
| specified name |
| |
| - Rebind the specified name to a new remote object |
| |
| - Destroy the binding for the specified name that's associated with a remote |
| object |
| |
| ## Options |
| |
| `-J`*option* |
| : Used with any Java option to pass the *option* following the `-J` (no |
| spaces between the `-J` and the option) to the Java interpreter. |
