annotate src/bsd/doc/man/rmiregistry.1 @ 1245:4fef42eb432c

Merge jdk7-b58 from main OpenJDK repository.
author kurt
date Wed, 20 May 2009 12:01:48 -0400
parents 5df63dc24cfe
children 8356c7fa1a33
rev   line source
kurt@1245 1 ." Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
mr@489 3 ."
mr@489 4 ." This code is free software; you can redistribute it and/or modify it
mr@489 5 ." under the terms of the GNU General Public License version 2 only, as
mr@489 6 ." published by the Free Software Foundation.
mr@489 7 ."
mr@489 8 ." This code is distributed in the hope that it will be useful, but WITHOUT
mr@489 9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
mr@489 10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
mr@489 11 ." version 2 for more details (a copy is included in the LICENSE file that
mr@489 12 ." accompanied this code).
mr@489 13 ."
mr@489 14 ." You should have received a copy of the GNU General Public License version
mr@489 15 ." 2 along with this work; if not, write to the Free Software Foundation,
mr@489 16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
mr@489 17 ."
mr@489 18 ." Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
mr@489 19 ." CA 95054 USA or visit if you need additional information or
mr@489 20 ." have any questions.
mr@489 21 ."
kurt@1245 22 .TH rmiregistry 1 "04 May 2009"
kurt@1245 23 ." Generated from HTML by html2man (author: Eric Armstrong)
mr@489 24
mr@489 25 .LP
kurt@1245 26 .SH "Name"
mr@489 27 rmiregistry \- The Java Remote Object Registry
mr@489 28 .LP
kurt@1245 29 .RS 3
mr@489 30
mr@489 31 .LP
mr@489 32 .LP
mr@489 33 The \f3rmiregistry\fP command starts a remote object registry on the specified port on the current host.
mr@489 34 .LP
kurt@1245 35 .RE
mr@489 36 .SH "SYNOPSIS"
mr@489 37 .LP
mr@489 38
mr@489 39 .LP
mr@489 40 .nf
mr@489 41 \f3
mr@489 42 .fl
mr@489 43 rmiregistry [\fP\f4port\fP\f3]
mr@489 44 .fl
mr@489 45 \fP
mr@489 46 .fi
mr@489 47
mr@489 48 .LP
mr@489 49 .SH "DESCRIPTION"
mr@489 50 .LP
mr@489 51
mr@489 52 .LP
mr@489 53 .LP
mr@489 54 The \f3rmiregistry\fP command creates and starts a remote object registry on the specified \f2port\fP on the current host. If \f2port\fP is omitted, the registry is started on port 1099. The \f3rmiregistry\fP command produces no output and is typically run in the background. For example:
mr@489 55 .LP
mr@489 56 .LP
mr@489 57 \f2rmiregistry &\fP
mr@489 58 .LP
mr@489 59 .LP
mr@489 60 A remote object registry is a bootstrap naming service that is 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.
mr@489 61 .LP
mr@489 62 .LP
mr@489 63 The registry is typically used to locate the first remote object on which an application needs to invoke methods. That object in turn will provide application\-specific support for finding other objects.
mr@489 64 .LP
mr@489 65 .LP
mr@489 66 The methods of the \f2java.rmi.registry.LocateRegistry\fP class are used to get a registry operating on the local host or local host and port.
mr@489 67 .LP
mr@489 68 .LP
mr@489 69 The URL\-based methods of the \f2java.rmi.Naming\fP class operate on a registry and can be used to look up a remote object on any host, and on the local host: 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 URLs bound in the registry.
mr@489 70 .LP
mr@489 71 .SH "OPTIONS"
mr@489 72 .LP
mr@489 73
mr@489 74 .LP
kurt@1245 75 .RS 3
mr@489 76 .TP 3
mr@489 77 \-J
mr@489 78 Used in conjunction with any \f2java\fP option, it passes the option following the \f2\-J\fP (no spaces between the \-J and the option) on to the \f2java\fP interpreter.
kurt@1245 79 .RE
kurt@1245 80
mr@489 81 .LP
mr@489 82 .SH "SEE ALSO"
mr@489 83 .LP
mr@489 84
mr@489 85 .LP
mr@489 86 .LP
kurt@1245 87 java(1),
mr@489 88 .na
mr@489 89 \f2java.rmi.registry.LocateRegistry\fP @
mr@489 90 .fi
kurt@1245 91 and
mr@489 92 .na
mr@489 93 \f2java.rmi.Naming\fP @
mr@489 94 .fi
kurt@1245 95
mr@489 96 .LP
mr@489 97
mr@489 98 .LP
mr@489 99