blob: 14d87bb83c5963d2ec0811670702a9f920583aa4 [file] [log] [blame]
bpatel4bf512b2011-05-11 08:30:46 -07001." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
duke6e45e102007-12-01 00:00:00 +00002." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
3."
4." This code is free software; you can redistribute it and/or modify it
5." under the terms of the GNU General Public License version 2 only, as
6." published by the Free Software Foundation.
7."
8." This code is distributed in the hope that it will be useful, but WITHOUT
9." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
11." version 2 for more details (a copy is included in the LICENSE file that
12." accompanied this code).
13."
14." You should have received a copy of the GNU General Public License version
15." 2 along with this work; if not, write to the Free Software Foundation,
16." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
17."
ohair2283b9d2010-05-25 15:58:33 -070018." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
19." or visit www.oracle.com if you need additional information or have any
20." questions.
tbell16c34dd2009-05-04 18:28:26 -070021."
bpatel4bf512b2011-05-11 08:30:46 -070022.TH jconsole 1 "10 May 2011"
duke6e45e102007-12-01 00:00:00 +000023
24.LP
tbell16c34dd2009-05-04 18:28:26 -070025.SH "Name"
duke6e45e102007-12-01 00:00:00 +000026jconsole \- Java Monitoring and Management Console
27.LP
28.SH "SYNOPSIS"
29.LP
duke6e45e102007-12-01 00:00:00 +000030.nf
31\f3
32.fl
33\fP\f3jconsole\fP [ \f2options\fP ] [ connection ... ]
34.fl
35
36.fl
37.fi
38
39.LP
40.SH "PARAMETERS"
41.LP
duke6e45e102007-12-01 00:00:00 +000042.RS 3
43.TP 3
44options
45Options, if used, should follow immediately after the command name.
duke6e45e102007-12-01 00:00:00 +000046.TP 3
47connection = pid | host:port | jmxUrl
48.RS 3
bpatel4bf512b2011-05-11 08:30:46 -070049.TP 2
50o
51\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
tbell16c34dd2009-05-04 18:28:26 -070052.na
53\f2JMX Monitoring and Management\fP @
54.fi
bpatel4bf512b2011-05-11 08:30:46 -070055http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details.
56.TP 2
57o
58\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
tbell16c34dd2009-05-04 18:28:26 -070059.na
60\f2JMX Monitoring and Management\fP @
61.fi
bpatel4bf512b2011-05-11 08:30:46 -070062http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html for details.
63.TP 2
64o
65\f2jmxUrl\fP Address of the JMX agent to be connected to as described in
tbell16c34dd2009-05-04 18:28:26 -070066.na
67\f2JMXServiceURL\fP @
68.fi
bpatel4bf512b2011-05-11 08:30:46 -070069http://download.oracle.com/javase/7/docs/api/javax/management/remote/JMXServiceURL.html.
duke6e45e102007-12-01 00:00:00 +000070.RE
71.RE
72
73.LP
74.SH "DESCRIPTION"
75.LP
duke6e45e102007-12-01 00:00:00 +000076.LP
77The \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.
78.LP
79.LP
80On 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.
81.LP
82.SH "OPTIONS"
83.LP
duke6e45e102007-12-01 00:00:00 +000084.RS 3
85.TP 3
86\-interval=n
87Set the update interval to \f2n\fP seconds (default is 4 seconds).
88.TP 3
bpatel4bf512b2011-05-11 08:30:46 -070089\-notile
duke6e45e102007-12-01 00:00:00 +000090Do not tile windows initially (for two or more connections).
91.TP 3
bpatel4bf512b2011-05-11 08:30:46 -070092\-pluginpath plugins
duke6e45e102007-12-01 00:00:00 +000093Specify a list of directories or JAR files which are searched for JConsole plugins. The \f2plugins\fP path should contain a provider\-configuration file named:
94.br
95.nf
96\f3
97.fl
98 META\-INF/services/com.sun.tools.jconsole.JConsolePlugin
99.fl
100\fP
101.fi
tbell16c34dd2009-05-04 18:28:26 -0700102containing one line for each plugin specifying the fully qualified class name of the class implementing the
103.na
104\f2com.sun.tools.jconsole.JConsolePlugin\fP @
105.fi
bpatel4bf512b2011-05-11 08:30:46 -0700106http://download.oracle.com/javase/7/docs/jdk/api/jconsole/spec/com/sun/tools/jconsole/JConsolePlugin.html class.
duke6e45e102007-12-01 00:00:00 +0000107.TP 3
bpatel4bf512b2011-05-11 08:30:46 -0700108\-version
duke6e45e102007-12-01 00:00:00 +0000109Output version information and exit.
110.TP 3
bpatel4bf512b2011-05-11 08:30:46 -0700111\-help
duke6e45e102007-12-01 00:00:00 +0000112Output help message and exit.
113.TP 3
bpatel4bf512b2011-05-11 08:30:46 -0700114\-J<flag>
duke6e45e102007-12-01 00:00:00 +0000115Pass <flag> to the Java virtual machine on which jconsole is run.
116.RE
117
118.LP
119.SH "SEE ALSO"
120.LP
121.RS 3
122.TP 2
123o
tbell16c34dd2009-05-04 18:28:26 -0700124.na
125\f2Using JConsole\fP @
126.fi
bpatel4bf512b2011-05-11 08:30:46 -0700127http://download.oracle.com/javase/7/docs/technotes/guides/management/jconsole.html
duke6e45e102007-12-01 00:00:00 +0000128.TP 2
129o
tbell16c34dd2009-05-04 18:28:26 -0700130.na
131\f2Monitoring and Management for Java Platform\fP @
132.fi
bpatel4bf512b2011-05-11 08:30:46 -0700133http://download.oracle.com/javase/7/docs/technotes/guides/management/index.html
duke6e45e102007-12-01 00:00:00 +0000134.RE
135
136.LP
duke6e45e102007-12-01 00:00:00 +0000137