--- old/src/jdk.jcmd/share/man/jinfo.1 2019-05-31 13:32:01.885376405 -0700 +++ new/src/jdk.jcmd/share/man/jinfo.1 2019-05-31 13:32:01.617376414 -0700 @@ -1,5 +1,4 @@ -'\" t -.\" Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. +.\" Copyright (c) 1994, 2019, 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 @@ -20,113 +19,95 @@ .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" -.\" Arch: generic -.\" Software: JDK 8 -.\" Date: 21 November 2013 -.\" SectDesc: Troubleshooting Tools -.\" Title: jinfo.1 -.\" -.if n .pl 99999 -.TH jinfo 1 "21 November 2013" "JDK 8" "Troubleshooting 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 * -.\" ----------------------------------------------------------------- - -.SH NAME -jinfo \- Generates configuration information\&. This command is experimental and unsupported\&. -.SH SYNOPSIS -.sp -.nf - -\fBjinfo\fR [ \fIoption\fR ] \fIpid\fR -.fi -.nf - -\fBjinfo\fR [ \fIoption \fR] \fIexecutable core\fR -.fi -.nf - -\fBjinfo\fR [ \fIoption \fR] \fI[ servier\-id ] remote\-hostname\-or\-IP\fR -.fi -.sp -.TP -\fIoption\fR -The command-line options\&. See Options\&. -.TP -\fIpid\fR -The process ID for which the configuration information is to be printed\&. The process must be a Java process\&. To get a list of Java processes running on a machine, use the jps(1) command\&. -.TP -\fIexecutable\fR -The Java executable from which the core dump was produced\&. -.TP -\fIcore\fR -The core file for which the configuration information is to be printed\&. -.TP -\fIremote-hostname-or-IP\fR -The remote debug server \f3hostname\fR or \f3IP\fR address\&. See jsadebugd(1)\&. -.TP -\fIserver-id\fR -An optional unique ID to use when multiple debug servers are running on the same remote host\&. -.SH DESCRIPTION -The \f3jinfo\fR command prints Java configuration information for a specified Java process or core file or a remote debug server\&. The configuration information includes Java system properties and Java Virtual Machine (JVM) command-line flags\&. If the specified process is running on a 64-bit JVM, then you might need to specify the \f3-J-d64\fR option, for example: \f3jinfo\fR\f3-J-d64 -sysprops pid\fR\&. -.PP -This utility is unsupported and might not be available in future releases of the JDK\&. In Windows Systems where \f3dbgeng\&.dll\fR is not present, Debugging Tools For Windows must be installed to have these tools working\&. The \f3PATH\fR environment variable should contain the location of the jvm\&.dll that is used by the target process or the location from which the crash dump file was produced\&. For example, \f3set PATH=%JDK_HOME%\ejre\ebin\eclient;%PATH%\fR \&. -.SH OPTIONS -.TP -no-option -Prints both command-line flags and system property name-value pairs\&. -.TP --flag \fIname\fR -.br -Prints the name and value of the specified command-line flag\&. -.TP --flag \fI[+|-]name\fR -.br -enables or disables the specified Boolean command-line flag\&. -.TP --flag \fIname=value\fR -.br -Sets the specified command-line flag to the specified value\&. -.TP --flags -.br -Prints command-line flags passed to the JVM\&. -.TP --sysprops -.br -Prints Java system properties as name-value pairs\&. -.TP --h -.br -Prints a help message\&. -.TP --help -.br -Prints a help message\&. -.SH SEE\ ALSO -.TP 0.2i -\(bu -jps(1) -.TP 0.2i -\(bu -jsadebugd(1) -.RE -.br -'pl 8.5i -'bp +.\" Automatically generated by Pandoc 2.3.1 +.\" +.TH "JINFO" "1" "2018" "JDK 13" "JDK Commands" +.hy +.SH NAME +.PP +jinfo \- generate Java configuration information for a specified Java +process +.SH SYNOPSIS +.PP +\f[B]Note:\f[R] This command is experimental\ and unsupported. +.PP +\f[CB]jinfo\f[R] [\f[I]option\f[R]] \f[I]pid\f[R] +.TP +.B \f[I]option\f[R] +This represents the \f[CB]jinfo\f[R] command\-line options. +See \f[B]Options for the jinfo Command\f[R]. +.RS +.RE +.TP +.B \f[I]pid\f[R] +The process ID for which the configuration information is to be printed. +The process must be a Java process. +To get a list of Java processes running on a machine, use either the +\f[CB]ps\f[R] command or, if the JVM processes are not running in a +separate docker instance, the \f[B]jps\f[R] command. +.RS +.PP +\f[B]Note:\f[R] JDK 10 has added support for using the Attach API when +attaching to Java processes running in a separate docker process. +However, the \f[CB]jps\f[R] command will not list the JVM processes that +are running in a separate docker instance. +If you are trying to connect a Linux host with a Virtual Machine that is +in a docker container, you must use tools such as \f[CB]ps\f[R] to look up +the PID of the JVM. +.RE +.SH DESCRIPTION +.PP +The \f[CB]jinfo\f[R] command prints Java configuration information for a +specified Java process. +The configuration information includes Java system properties and JVM +command\-line flags. +If the specified process is running on a 64\-bit JVM, then you might +need to specify the \f[CB]\-J\-d64\f[R] option, for example: +.RS +.PP +\f[CB]jinfo\ \-J\-d64\ \-sysprops\f[R] \f[I]pid\f[R] +.RE +.PP +This command is unsupported and might not be available in future +releases of the JDK. +In Windows Systems where \f[CB]dbgeng.dll\f[R] is not present, the +Debugging Tools for Windows must be installed to have these tools work. +The \f[CB]PATH\f[R] environment variable should contain the location of +the \f[CB]jvm.dll\f[R] that\[aq]s used by the target process or the +location from which the core dump file was produced. +.SH OPTIONS FOR THE JINFO COMMAND +.PP +\f[B]Note:\f[R] +.PP +If none of the following options are used, both the command\-line flags +and the system property name\-value pairs are printed. +.TP +.B \f[CB]\-flag\f[R] \f[I]name\f[R] +Prints the name and value of the specified command\-line flag. +.RS +.RE +.TP +.B \f[CB]\-flag\f[R] [\f[CB]+\f[R]|\f[CB]\-\f[R]]\f[I]name\f[R] +Enables or disables the specified Boolean command\-line flag. +.RS +.RE +.TP +.B \f[CB]\-flag\f[R] \f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R] +Sets the specified command\-line flag to the specified value. +.RS +.RE +.TP +.B \f[CB]\-flags\f[R] +Prints command\-line flags passed to the JVM. +.RS +.RE +.TP +.B \f[CB]\-sysprops\f[R] +Prints Java system properties as name\-value pairs. +.RS +.RE +.TP +.B \f[CB]\-h\f[R] or \f[CB]\-help\f[R] +Prints a help message. +.RS +.RE