Mercurial Mercurial > jdk-sandbox / diff
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
jdk/src/linux/doc/man/jstat.1
changeset 9573 c02ff5a7c67b
parent 5865 47da38a8c0f0
child 21743 3d979da7bdf0 
--- a/jdk/src/linux/doc/man/jstat.1	Tue May 10 19:57:30 2011 -0700
+++ b/jdk/src/linux/doc/man/jstat.1	Wed May 11 08:30:46 2011 -0700
@@ -1,4 +1,4 @@
-." Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
+." 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
@@ -19,7 +19,7 @@
 ." or visit www.oracle.com if you need additional information or have any
 ." questions.
 ."
-.TH jstat 1 "02 Jun 2010"
+.TH jstat 1 "10 May 2011"
 
 .LP
 .SH "Name"
@@ -27,8 +27,6 @@
 .LP
 .SH "SYNOPSIS"
 .LP
-
-.LP
 .nf
 \f3
 .fl
@@ -39,8 +37,6 @@
 .LP
 .SH "PARAMETERS"
 .LP
-
-.LP
 .RS 3
 .TP 3
 generalOption 
@@ -60,17 +56,15 @@
 The syntax of the vmid string largely corresponds to the syntax of a URI. The \f2vmid\fP can vary from a simple integer representing a local JVM to a more complex construction specifying a communications protocol, port number, and other implementation\-specific values. See Virtual Machine Identifier for details. 
 .TP 3
 interval[s|ms] 
-Sampling interval in the specified units, seconds (s) or milliseconds (ms). Default units are milliseconds.\  Must be a positive integer.\  If specified, \f3jstat\fP will produce its output at each interval. 
+Sampling interval in the specified units, seconds (s) or milliseconds (ms). Default units are milliseconds. Must be a positive integer. If specified, \f3jstat\fP will produce its output at each interval. 
 .TP 3
 count 
-Number of samples to display. Default value is infinity; that is, \f3jstat\fP displays statistics until the target JVM terminates or the \f3jstat\fP command is terminated.\  Must be a positive integer. 
+Number of samples to display. Default value is infinity; that is, \f3jstat\fP displays statistics until the target JVM terminates or the \f3jstat\fP command is terminated. Must be a positive integer. 
 .RE
 
 .LP
 .SH "DESCRIPTION"
 .LP
-
-.LP
 .LP
 The \f3jstat\fP tool displays performance statistics for an instrumented HotSpot Java virtual machine (JVM). The target JVM is identified by its virtual machine identifier, or \f2vmid\fP option described below.
 .LP
@@ -82,9 +76,6 @@
 .SS 
 VIRTUAL MACHINE IDENTIFIER
 .LP
-.RS 3
-
-.LP
 .LP
 The syntax of the \f2vmid\fP string largely corresponds to the syntax of a URI:
 .LP
@@ -115,11 +106,8 @@
 .RE
 
 .LP
-.RE
 .SH "OPTIONS"
 .LP
-
-.LP
 .LP
 The \f3jstat\fP command supports two types of options, general options and output options. General options cause \f3jstat\fP to display simple usage and version information. Output options determine the content and format of the statistical output.
 .br
@@ -150,14 +138,11 @@
 .SS 
 OUTPUT OPTIONS
 .LP
-.RS 3
-
+.LP
+If you do not specify a general option, then you can specify output options. Output options determine the content and format of \f3jstat\fP's output, and consist of a single \f2statOption\fP, plus any of the other output options (\-h, \-t, and \-J). The \f2statOption\fP must come first.
 .LP
 .LP
-If you do not specify a general option, then you can specify output options. Output options determine the content and format of \f3jstat\fP's output, and consist of a single \f2statOption\fP, plus any of the other output options (\-h, \-t, and \-J).\  The \f2statOption\fP must come first.
-.LP
-.LP
-Output is formatted as a table, with columns are separated by spaces. A header row with titles describes the columns.\  Use the \f3\-h\fP option to set the frequency at which the header is displayed.\  Column header names are generally consistent between the different options. In general, if two options provide a column with the same name, then the data source for the two columns are the same.
+Output is formatted as a table, with columns are separated by spaces. A header row with titles describes the columns. Use the \f3\-h\fP option to set the frequency at which the header is displayed. Column header names are generally consistent between the different options. In general, if two options provide a column with the same name, then the data source for the two columns are the same.
 .LP
 .LP
 Use the \f3\-t\fP option to display a time stamp column, labeled \f2Timestamp\fP as the first column of output. The \f2Timestamp\fP column contains the elapsed time, in seconds, since startup of the target JVM. The resolution of the time stamp is dependent on various factors and is subject to variation due to delayed thread scheduling on heavily loaded systems.
@@ -171,11 +156,10 @@
 .RS 3
 .TP 3
 \-statOption 
-Determines the statistics information that \f3jstat\fP displays. The following table lists the available options.\  Use the \f3\-options\fP general option to display the list of options for a particular platform installation.
+Determines the statistics information that \f3jstat\fP displays. The following table lists the available options. Use the \f3\-options\fP general option to display the list of options for a particular platform installation.
 .br
 .br
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -457,7 +441,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 230 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 215 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -683,7 +667,6 @@
 .rm j+
 .rm k+
 .rm l+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-52
 .TP 3
 \-h n 
@@ -697,13 +680,9 @@
 .RE
 
 .LP
-.RE
 .SS 
 STATOPTIONS AND OUTPUT
 .LP
-.RS 3
-
-.LP
 .LP
 The following tables summarize the columns that \f3jstat\fP outputs for each \f2statOption\fP.
 .br
@@ -713,7 +692,6 @@
 \-class Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -825,7 +803,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 280 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 261 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -910,7 +888,6 @@
 .rm a+
 .rm b+
 .rm c+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-21
 
 .LP
@@ -918,7 +895,6 @@
 \-compiler Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -1082,7 +1058,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 316 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 297 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -1210,7 +1186,6 @@
 .rm d+
 .rm e+
 .rm f+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-29
 
 .LP
@@ -1218,7 +1193,6 @@
 \-gc Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -1546,7 +1520,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 386 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 367 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -1814,7 +1788,6 @@
 .rm l+
 .rm m+
 .rm n+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-63
 
 .LP
@@ -1822,7 +1795,6 @@
 \-gccapacity Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -2170,7 +2142,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 460 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 441 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -2455,7 +2427,6 @@
 .rm m+
 .rm n+
 .rm o+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-67
 
 .LP
@@ -2466,7 +2437,6 @@
 This option displays the same summary of garbage collection statistics as the \f3\-gcutil\fP option, but includes the causes of the last garbage collection event and (if applicable) the current garbage collection event. In addition to the columns listed for \f3\-gcutil\fP, this option adds the following columns:
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -2550,7 +2520,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 483 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 464 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -2610,7 +2580,6 @@
 .35
 .rm a+
 .rm b+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-13
 
 .LP
@@ -2618,7 +2587,6 @@
 \-gcnew Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -2866,7 +2834,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 537 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 518 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -3066,7 +3034,6 @@
 .rm h+
 .rm i+
 .rm j+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-47
 
 .LP
@@ -3074,7 +3041,6 @@
 \-gcnewcapacity Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -3094,15 +3060,14 @@
 .rm 80 81
 .nr 34 \n(.lu
 .eo
-.am 80
+.am 81
 .br
 .di a+
 .35
 .ft \n(.f
 .ll \n(34u*1u/3u
-.if \n(.l<\n(80 .ll \n(80u
+.if \n(.l<\n(81 .ll \n(81u
 .in 0
-NGCMN\ \ \ \ \ \ \ \ \ T}~T{
 Minimum new generation capacity (KB).
 .br
 .di
@@ -3262,9 +3227,11 @@
 .if \n(80<\n(38 .nr 80 \n(38
 .nr 38 \w\f3Column\fP
 .if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \wNGCMX \ \ \
+.nr 38 \wNGCMN
 .if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \wNGC \ \ \
+.nr 38 \wNGCMX
+.if \n(80<\n(38 .nr 80 \n(38
+.nr 38 \wNGC
 .if \n(80<\n(38 .nr 80 \n(38
 .nr 38 \wS0CMX
 .if \n(80<\n(38 .nr 80 \n(38
@@ -3284,8 +3251,6 @@
 .if \n(80<\n(38 .nr 80 \n(38
 .80
 .rm 80
-.nr 38 \n(a-
-.if \n(80<\n(38 .nr 80 \n(38
 .nr 81 0
 .nr 38 \w\f3Description\fP
 .if \n(81<\n(38 .nr 81 \n(38
@@ -3293,6 +3258,8 @@
 .if \n(81<\n(38 .nr 81 \n(38
 .81
 .rm 81
+.nr 38 \n(a-
+.if \n(81<\n(38 .nr 81 \n(38
 .nr 38 \n(b-
 .if \n(81<\n(38 .nr 81 \n(38
 .nr 38 \n(c-
@@ -3321,7 +3288,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 593 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 572 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -3348,11 +3315,11 @@
 .ta \n(80u \n(81u 
 .nr 31 \n(.f
 .nr 35 1m
-\&\h'|\n(40u'\h'|\n(41u'
+\&\h'|\n(40u'NGCMN\h'|\n(41u'
 .mk ##
 .nr 31 \n(##
 .sp |\n(##u-1v
-.nr 37 \n(40u
+.nr 37 \n(41u
 .in +\n(37u
 .a+
 .in -\n(37u
@@ -3364,7 +3331,7 @@
 .ta \n(80u \n(81u 
 .nr 31 \n(.f
 .nr 35 1m
-\&\h'|\n(40u'NGCMX \ \ \\h'|\n(41u'
+\&\h'|\n(40u'NGCMX\h'|\n(41u'
 .mk ##
 .nr 31 \n(##
 .sp |\n(##u-1v
@@ -3380,7 +3347,7 @@
 .ta \n(80u \n(81u 
 .nr 31 \n(.f
 .nr 35 1m
-\&\h'|\n(40u'NGC \ \ \\h'|\n(41u'
+\&\h'|\n(40u'NGC\h'|\n(41u'
 .mk ##
 .nr 31 \n(##
 .sp |\n(##u-1v
@@ -3521,15 +3488,13 @@
 .rm h+
 .rm i+
 .rm j+
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-49
+.if \n-(b.=0 .nr c. \n(.c-\n(d.-47
 
 .LP
 .SS 
 \-gcold Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -3717,7 +3682,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 635 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 614 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -3866,7 +3831,6 @@
 .rm e+
 .rm f+
 .rm g+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
 
 .LP
@@ -3874,7 +3838,6 @@
 \-gcoldcapacity Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -4062,7 +4025,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 677 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 656 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -4211,7 +4174,6 @@
 .rm e+
 .rm f+
 .rm g+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
 
 .LP
@@ -4219,7 +4181,6 @@
 \-gcpermcapacity Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -4407,7 +4368,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 719 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 698 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -4556,7 +4517,6 @@
 .rm e+
 .rm f+
 .rm g+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-35
 
 .LP
@@ -4564,7 +4524,6 @@
 \-gcutil Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -4792,7 +4751,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 769 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 748 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -4975,7 +4934,6 @@
 .rm g+
 .rm h+
 .rm i+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-43
 
 .LP
@@ -4983,7 +4941,6 @@
 \-printcompilation Option
 .LP
 .LP
-.TS
 .if \n+(b.=1 .nr d. \n(.c-\n(c.-1
 .de 35
 .ps \n(.s
@@ -5091,7 +5048,7 @@
 .nr 41 \n(80+(3*\n(38)
 .nr 81 +\n(41
 .nr TW \n(81
-.if t .if \n(TW>\n(.li .tm Table at line 795 file Input is too wide - \n(TW units
+.if t .if \n(TW>\n(.li .tm Table at line 774 file Input is too wide - \n(TW units
 .fc  
 .nr #T 0-1
 .nr #a 0-1
@@ -5172,14 +5129,10 @@
 .rm a+
 .rm b+
 .rm c+
-.TE
 .if \n-(b.=0 .nr c. \n(.c-\n(d.-19
 
 .LP
-.SS 
-
-.LP
-.SH ""
+.SH "EXAMPLES"
 .LP
 .LP
 This section presents some examples of monitoring a local JVM with a \f2lvmid\fP of 21891.
@@ -5355,7 +5308,6 @@
 .LP
 The \f2lvmid\fP is combined with the name of the remote host to construct a \f2vmid\fP of \f240496@remote.domain\fP. This \f2vmid\fP results in the use of the \f3rmi\fP protocol to communicate to the default \f3jstatd\fP server on the remote host. The \f3jstatd\fP server is located using the \f3rmiregistry\fP on \f2remote.domain\fP that is bound to the default \f3rmiregistry\fP port (port 1099).
 .LP
-.RE
 .SH "SEE ALSO"
 .LP
 .RS 3
jdk-sandbox