93 lines
3.2 KiB
Groff
93 lines
3.2 KiB
Groff
.\" Copyright (c) 1994, 2019, 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.
|
|
.\"
|
|
.\" Automatically generated by Pandoc 2.3.1
|
|
.\"
|
|
.TH "RMIREGISTRY" "1" "2020" "JDK 14" "JDK Commands"
|
|
.hy
|
|
.SH NAME
|
|
.PP
|
|
rmiregistry \- create and start a remote object registry on the
|
|
specified port on the current host
|
|
.SH SYNOPSIS
|
|
.PP
|
|
\f[CB]rmiregistry\f[R] [\f[I]options\f[R]] [\f[I]port\f[R]]
|
|
.TP
|
|
.B \f[I]options\f[R]
|
|
This represents the option for the \f[CB]rmiregistry\f[R] command.
|
|
See \f[B]Options\f[R]
|
|
.RS
|
|
.RE
|
|
.TP
|
|
.B \f[I]port\f[R]
|
|
The number of a port on the current host at which to start the remote
|
|
object registry.
|
|
.RS
|
|
.RE
|
|
.SH DESCRIPTION
|
|
.PP
|
|
The \f[CB]rmiregistry\f[R] 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 \f[CB]rmiregistry\f[R] command produces no output and is typically run
|
|
in the background, for example:
|
|
.RS
|
|
.PP
|
|
\f[CB]rmiregistry\ &\f[R]
|
|
.RE
|
|
.PP
|
|
A remote object registry is a bootstrap naming service that\[aq]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.
|
|
.PP
|
|
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.
|
|
.PP
|
|
The methods of the \f[CB]java.rmi.registry.LocateRegistry\f[R] class are
|
|
used to get a registry operating on the local host or local host and
|
|
port.
|
|
.PP
|
|
The URL\-based methods of the \f[CB]java.rmi.Naming\f[R] class operate on
|
|
a registry and can be used to:
|
|
.IP \[bu] 2
|
|
Bind the specified name to a remote object
|
|
.IP \[bu] 2
|
|
Return an array of the names bound in the registry
|
|
.IP \[bu] 2
|
|
Return a reference, a stub, for the remote object associated with the
|
|
specified name
|
|
.IP \[bu] 2
|
|
Rebind the specified name to a new remote object
|
|
.IP \[bu] 2
|
|
Destroy the binding for the specified name that\[aq]s associated with a
|
|
remote object
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \f[CB]\-J\f[R]\f[I]option\f[R]
|
|
Used with any Java option to pass the \f[I]option\f[R] following the
|
|
\f[CB]\-J\f[R] (no spaces between the \f[CB]\-J\f[R] and the option) to the
|
|
Java interpreter.
|
|
.RS
|
|
.RE
|