diff -r 8cd632761233 -r 3d979da7bdf0 jdk/src/linux/doc/man/jconsole.1 --- a/jdk/src/linux/doc/man/jconsole.1 Thu Nov 21 09:23:03 2013 -0800 +++ b/jdk/src/linux/doc/man/jconsole.1 Mon Nov 25 20:19:02 2013 -0800 @@ -1,137 +1,113 @@ -." Copyright (c) 2004, 2011, 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. -." -.TH jconsole 1 "10 May 2011" +'\" t +.\" Copyright (c) 2004, 2013, 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. +.\" +.\" Arch: generic +.\" Software: JDK 8 +.\" Date: 21 November 2013 +.\" SectDesc: Java Troubleshooting, Profiling, Monitoring and Management Tools +.\" Title: jconsole.1 +.\" +.if n .pl 99999 +.TH jconsole 1 "21 November 2013" "JDK 8" "Java Troubleshooting, Profiling, Monitoring and Management Tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- -.LP -.SH "Name" -jconsole \- Java Monitoring and Management Console -.LP -.SH "SYNOPSIS" -.LP -.nf -\f3 -.fl -\fP\f3jconsole\fP [ \f2options\fP ] [ connection ... ] -.fl - -.fl -.fi +.SH NAME +jconsole \- Starts a graphical console that lets you monitor and manage Java applications\&. +.SH SYNOPSIS +.sp +.nf -.LP -.SH "PARAMETERS" -.LP -.RS 3 -.TP 3 -options -Options, if used, should follow immediately after the command name. -.TP 3 -connection = pid | host:port | jmxUrl -.RS 3 -.TP 2 -o -\f2pid\fP Process ID of a local Java VM. The Java VM must be running with the same user ID as the user ID running jconsole. See -.na -\f2JMX Monitoring and Management\fP @ -.fi -http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details. -.TP 2 -o -\f2host\fP:\f2port\fP Name of the host system on which the Java VM is running and the port number specified by the system property \f2com.sun.management.jmxremote.port\fP when the Java VM was started. See -.na -\f2JMX Monitoring and Management\fP @ -.fi -http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details. -.TP 2 -o -\f2jmxUrl\fP Address of the JMX agent to be connected to as described in -.na -\f2JMXServiceURL\fP @ -.fi -http://download.oracle.com/javase/7/docs/api/javax/management/remote/JMXServiceURL.html. -.RE -.RE +\fBjconsole\fR [ \fIoptions\fR ] [ connection \&.\&.\&. ] +.fi +.sp +.TP +\fIoptions\fR +The command-line options\&. See Options\&. +.TP +connection = \fIpid\fR | \fIhost\fR:\fIport\fR | \fIjmxURL\fR +The \f3pid\fR value is the process ID of a local Java Virtual Machine (JVM)\&. The JVM must be running with the same user ID as the user ID running the \f3jconsole\fR command\&.The \f3host:port\fR values are the name of the host system on which the JVM is running, and the port number specified by the system property \f3com\&.sun\&.management\&.jmxremote\&.port\fR when the JVM was started\&.The \f3jmxUrl\fR value is the address of the JMX agent to be connected to as described in JMXServiceURL\&. + +For more information about the \f3connection\fR parameter, see Monitoring and Management Using JMX Technology at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html -.LP -.SH "DESCRIPTION" -.LP -.LP -The \f3jconsole\fP command launches a graphical console tool that enables you to monitor and manage Java applications and virtual machines on a local or remote machine. -.LP -.LP -On Windows, \f3jconsole\fP does not associate with a console window. It will, however, display a dialog box with error information if the \f3jconsole\fP command fails for some reason. -.LP -.SH "OPTIONS" -.LP -.RS 3 -.TP 3 -\-interval=n -Set the update interval to \f2n\fP seconds (default is 4 seconds). -.TP 3 -\-notile -Do not tile windows initially (for two or more connections). -.TP 3 -\-pluginpath plugins -Specify a list of directories or JAR files which are searched for JConsole plugins. The \f2plugins\fP path should contain a provider\-configuration file named: +See also the \f3JMXServiceURL\fR class description at http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html +.SH DESCRIPTION +The \f3jconsole\fR command starts a graphical console tool that lets you monitor and manage Java applications and virtual machines on a local or remote machine\&. +.PP +On Windows, the \f3jconsole\fR command does not associate with a console window\&. It does, however, display a dialog box with error information when the \f3jconsole\fR command fails\&. +.SH OPTIONS +.TP +-interval\fI=n\fR +.br +Sets the update interval to \fIn\fR seconds (default is 4 seconds)\&. +.TP +-notile +.br +Does not tile windows initially (for two or more connections)\&. +.TP +-pluginpath \fIplugins\fR +.br +Specifies a list of directories or JAR files to be searched for \f3JConsole\fR plug-ins\&. The \fIplugins\fR path should contain a provider-configuration file named \f3META-INF/services/com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fR that contains one line for each plug-in\&. The line specifies the fully qualified class name of the class implementing the \f3com\&.sun\&.tools\&.jconsole\&.JConsolePlugin\fR class\&. +.TP +-version .br -.nf -\f3 -.fl - META\-INF/services/com.sun.tools.jconsole.JConsolePlugin -.fl -\fP -.fi -containing one line for each plugin specifying the fully qualified class name of the class implementing the -.na -\f2com.sun.tools.jconsole.JConsolePlugin\fP @ -.fi -http://download.oracle.com/javase/7/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html class. -.TP 3 -\-version -Output version information and exit. -.TP 3 -\-help -Output help message and exit. -.TP 3 -\-J -Pass to the Java virtual machine on which jconsole is run. -.RE - -.LP -.SH "SEE ALSO" -.LP -.RS 3 -.TP 2 -o -.na -\f2Using JConsole\fP @ -.fi -http://download.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html -.TP 2 -o -.na -\f2Monitoring and Management for Java Platform\fP @ -.fi -http://download.oracle.com/javase/7/docs/technotes/guides/management/index.html -.RE - -.LP - +Displays release information and exits\&. +.TP +-help +.br +Displays a help message\&. +.TP +-J\fIflag\fR +.br +Passes \f3flag\fR to the JVM on which the \f3jconsole\fR command is run\&. +.SH SEE\ ALSO +.TP 0.2i +\(bu +Using JConsole at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/jconsole\&.html +.TP 0.2i +\(bu +Monitoring and Management Using JMX Technology at http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/management/agent\&.html +.TP 0.2i +\(bu +The \f3JMXServiceURL\fR class description at http://docs\&.oracle\&.com/javase/8/docs/api/javax/management/remote/JMXServiceURL\&.html +.RE +.br +'pl 8.5i +'bp