archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-28 15:24:43 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8335479: JFR: Missing documentation for -XX:StartFlightRecording

Browse source 
Reviewed-by: mgronlun
This commit is contained in:
Erik Gahlin 2024-07-03 20:43:08 +00:00
parent 9a91865ff3
commit 68ffec9800
1 changed files with 8 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

9
src/java.base/share/man/java.1
View file

@ -1710,10 +1710,12 @@ This prevents the JVM from exiting and keeps the process active so that
you can attach a debugger to it to investigate the cause of the error. you can attach a debugger to it to investigate the cause of the error.
By default, this option is disabled. By default, this option is disabled.
.TP .TP
\f[V]-XX:StartFlightRecording=\f[R]\f[I]parameter\f[R]\f[V]=\f[R]\f[I]value\f[R] \f[V]-XX:StartFlightRecording:\f[R]\f[I]parameter\f[R]\f[V]=\f[R]\f[I]value\f[R]
Starts a JFR recording for the Java application. Starts a JFR recording for the Java application.
This option is equivalent to the \f[V]JFR.start\f[R] diagnostic command This option is equivalent to the \f[V]JFR.start\f[R] diagnostic command
that starts a recording during runtime. that starts a recording during runtime.
\f[V]-XX:StartFlightRecording:help\f[R] prints available options and
example command lines.
You can set the following \f[I]parameter\f[R]\f[V]=\f[R]\f[I]value\f[R] You can set the following \f[I]parameter\f[R]\f[V]=\f[R]\f[I]value\f[R]
entries when starting a JFR recording: entries when starting a JFR recording:
.RS .RS
@ -1760,6 +1762,8 @@ written when the recording is stopped, for example:
.PP .PP
If %p and/or %t is specified in the filename, it expands to the If %p and/or %t is specified in the filename, it expands to the
JVM\[aq]s PID and the current timestamp, respectively. JVM\[aq]s PID and the current timestamp, respectively.
The filename may also be a directory in which case, the filename is
generated from the PID and the current date in the specified directory.
.RE .RE
.TP .TP
\f[V]name=\f[R]\f[I]identifier\f[R] \f[V]name=\f[R]\f[I]identifier\f[R]
@ -1840,6 +1844,9 @@ The whitespace delimiter can be omitted for timespan values, i.e.
20ms. 20ms.
For more information about the settings syntax, see Javadoc of the For more information about the settings syntax, see Javadoc of the
jdk.jfr package. jdk.jfr package.
.PP
To only see warnings and errors from JFR during startup set
-Xlog:jfr+startup=warning.
.RE .RE
.TP .TP
\f[V]-XX:ThreadStackSize=\f[R]\f[I]size\f[R] \f[V]-XX:ThreadStackSize=\f[R]\f[I]size\f[R]