--- a/jdk/src/linux/doc/man/servertool.1 Thu Apr 30 15:04:39 2009 -0700
+++ b/jdk/src/linux/doc/man/servertool.1 Mon May 04 18:28:26 2009 -0700
@@ -1,5 +1,3 @@
-.'" t
-."
." Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved.
." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
."
@@ -21,17 +19,18 @@
." CA 95054 USA or visit www.sun.com if you need additional information or
." have any questions.
."
-." `
-.TH servertool 1 "05 Aug 2006"
-." Generated by html2roff
+.TH servertool 1 "04 May 2009"
+." Generated from HTML by html2man (author: Eric Armstrong)
.LP
-.SH NAME
+.SH "Name"
servertool \- The Java(TM) IDL Server Tool
.LP
+.RS 3
.LP
-\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
+\f3servertool\fP provides a command\-line interface for application programmers to register, unregister, startup, and shutdown a persistent server.
+.RE
.SH "SYNOPSIS"
.LP
@@ -65,37 +64,29 @@
.LP
.LP
+.RS 3
.TP 3
\-ORBInitialHost nameserverhost
Specifies the host machine on which the name server is running and listening for incoming requests. The \f2nameserverhost\fP defaults to \f2localhost\fP if this option is not specified. If \f2orbd\fP and \f2servertool\fP are running on different machines, you must specify the name or IP address of the host on which \f2orbd\fP is running.
.TP 3
\-Joption
-Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for the
-.na
-\f2java a pplication launcher\fP @
-.fi
-http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html. For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
+Pass \f2option\fP to the Java virtual machine, where \f2option\fP is one of the options described on the reference page for java(1). For example, \f3\-J\-Xms48m\fP sets the startup memory to 48 megabytes. It is a common convention for \f3\-J\fP to pass options to the underlying virtual machine.
+.RE
+
.LP
.SH "COMMANDS"
.LP
.LP
+.RS 3
.TP 3
-register \-server\ <server\ class\ name>
-\ \-classpath\ <classpath\ to\ server>
-[\ \-applicationName\ <application\ name>
-\-args\ <args\ to\ server>
-\-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM>
-\ ]
+register \-server\ <server\ class\ name> \ \-classpath\ <classpath\ to\ server> [\ \-applicationName\ <application\ name> \-args\ <args\ to\ server> \-vmargs\ <flags\ to\ be\ passed\ to\ Java\ VM> \ ]
Register a new persistent server with the Object Request Broker Daemon (ORBD). If the server is not already registered, it is registered and activated. This command causes an install method to be invoked in the main class of the server identified by the \f2\-server\fP option. The install method must be \f2public static void install(org.omg.CORBA.ORB)\fP. The install method is optional and enables the developer to provide their own server installation behavior (for example, creating database schema).
.TP 3
-unregister
-\-serverid\ <server\ id\ >\ |
-\-applicationName\ <application\ name>
+unregister \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
Unregister a server from the ORBD by using either its server id or its application name. This command causes an uninstall method to be invoked in the main class of the server identified by the \f2\-server\fP option. The uninstall method must be \f2public static void uninstall(org.omg.CORBA.ORB)\fP. The uninstall method is optional and enables the developer to provide their own server uninstall behavior (for example, undoing the behavior of the install method).
.TP 3
-getserverid
-\-applicationName\ <application\ name>
+getserverid \-applicationName\ <application\ name>
Return the server id that corresponds with an application.
.TP 3
list
@@ -107,27 +98,19 @@
listactive
List information about all persistent servers that have been launched by the ORBD and are currently running.
.TP 3
-locate \-serverid\ <server\ id\ >\ |
-\-applicationName\ <application\ name>
-[\-endpointType\ <endpointType>\ ]
+locate \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-endpointType\ <endpointType>\ ]
Locate the endpoints (ports) of a specific type for all ORBs created by a registered server. If a server is not already running, it is activated. If an endpoint type is not specified, then the plain/non\-protected endpoint associated with each ORB in a server is returned.
.TP 3
-locateperorb
-\-serverid\ <server\ id\ >\ |
-\-applicationName\ <application\ name>
-[\-orbid\ <ORB\ name>\ ]
+locateperorb \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name> [\-orbid\ <ORB\ name>\ ]
Locate all the endpoints (ports) registered by a specific ORB of registered server. If a server is not already running, then it is activated. If an \f2orbid\fP is not specified, the default value of "" is assigned to the \f2orbid\fP. If any ORBs are created with an \f2orbid\fP of empty string, all ports registered by it are returned.
.TP 3
-orblist \-serverid\ <server\ id\ >\ |
-\-applicationName\ <application\ name>
+orblist \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
Lists the ORBId of the ORBs defined on a server. An ORBId is the string name for the ORB created by the server. If the server is not already running, it is activated.
.TP 3
-shutdown \-serverid\ <server\ id\ >\ |
-\-applicationName\ <application\ name>
+shutdown \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
Shutdown an active server that is registered with ORBD. During execution of this command, the \f2shutdown()\fP method defined in the class specified by either the \f2\-serverid\fP or \f2\-applicationName\fP parameter is also invoked to shutdown the server process appropriately.
.TP 3
-startup \-serverid\ <server\ id\ >\ |
-\-applicationName\ <application\ name>
+startup \-serverid\ <server\ id\ >\ | \-applicationName\ <application\ name>
Startup or activate a server that is registered with ORBD. If the server is not running, this command launches the server. If the server is already running, an error message is returned to the user.
.TP 3
help
@@ -135,11 +118,13 @@
.TP 3
quit
Exit the server tool.
+.RE
+
.LP
.SH "SEE ALSO"
.LP
.LP
-orbd
+orbd(1)
.LP