1️⃣ 概念

jinfo 是 Java Development Kit (JDK) 自带的一款命令行工具。它旨在为用户提供进程的运行时信息，特别是与 Java 虚拟机 (JVM) 相关的配置和系统属性。jinfo 使得用户可以轻松地查看和修改正在运行的 Java 进程的参数，以便进行故障排除、诊断和优化。

jinfo 允许用户动态查询和修改 JVM 的运行时信息，包括系统属性、堆参数、环境变量、启动参数等。通过与 JVM 内部通信，该工具提供了修改虚拟机参数的能力，而无需重启 JVM。这对于调试和优化应用程序的性能非常有用。

jinfo 实际上是通过 Java Debug Interface (JDI) 来与正在运行的 Java 进程进行通信。它利用 JVM 提供的调试接口，向目标进程发送请求并获取所需的信息。这些信息包括启动参数、系统属性和堆参数等。修改操作是通过向 JVM 发送相应的命令来完成的。

2️⃣ 优势和缺点

优点：

• 提供了便捷方式来获取并更改正在运行的 Java 进程的运行时信息；
• 可以直接与 JVM 通信并进行实时修改，而无需重启进程；
• 具有简单易懂的命令行接口，方便使用和操作。

缺点：

• 需要访问该进程所属用户的权限；
• 使用不当可能导致进程崩溃或数据丢失；
• 涉及到 JVM 内部信息，因此需要具备一定的 Java 和 JVM 知识。
  
  

3️⃣ 使用

3.1 语法格式

jinfo 命令的使用语法如下：

jinfo [option] <pid>
        (to connect to running process)(连接到正在运行的进程)
jinfo [option] <executable <core>
    	(to connect to a core file)(连接到核心文件)
jinfo [option] [server_id@]<remote server IP or hostname>
    	(to connect to remote debug server)(连接到远程调试服务器)

其中，当用作连接到正在运行的进程时，<pid> 可以指定要操作的 Java 进程ID。

当用作连接到核心文件时，<executable <core> 表示可执行核心转储文件，指定正在运行的 Java 进程的可执行核心转储文件路径。

当用作连接到远程调试服务器时，[server_id@] 表示可选的服务器标识符，用于指定目标远程服务器的 ID。 <remote server IP or hostname>用于指定远程服务器的 IP 地址或主机名，指定要连接和操作的远程 Java 进程。jinfo 通过远程调试协议与目标服务器进行通信，并获取所需的运行时信息。

而option 是可选的命令行选项，允许指定要执行的操作类型。一些常见的选项包括：

可选参数	说明
-flag <name>	显示指定虚拟机参数（flag）的值
-flag [+|-] <name>	启用或禁用指定虚拟机参数
-flag <name>=<value>	设置指定虚拟机参数（flag）的值
-flags	显示所有虚拟机参数（flags）及其值
-sysprops	显示 Java 系统属性及其值
-h或-help	显示帮助信息，列出 jinfo 命令的使用示例和选项说明

总的来说，jinfo 命令有以下常见的用法：

• jinfo -flags <pid>：查看进程的启动参数；
• jinfo -sysprops <pid>：查看进程的系统属性；
• jinfo -flag <name> <pid>：查看特定虚拟机参数的值；
• jinfo -flag [+/-]<name> <pid>：启用或禁用特定虚拟机参数的值。

下面我们逐一详细介绍。

同时需要注意，jinfo 命令需要相应 Java 进程所属用户的权限才能访问和修改信息。而修改虚拟机参数可能会对应用程序产生意想不到的影响，请谨慎使用，确保已经了解虚拟机参数的含义和影响，以避免意外结果发生。

3.2 -flags：查看进程的启动参数

jinfo -flags <pid> 用于查看指定进程的启动参数。通过运行该命令，可以获取正在运行的 Java 进程的虚拟机参数（flags）及其对应的值。

当执行 jinfo -flags <pid> 命令时，它将与指定的 Java 进程进行通信，并返回该进程所使用的所有虚拟机参数及其当前设置的值。虚拟机参数包括启动类路径、堆大小、垃圾收集器类型等。

以下片段是输出的一部分：

Command line:  -Xmx1024m -Xms512m
…
Environmental variable: 
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_251
…
VM Flags:
-XX:CICompilerCount=4
-XX:InitialHeapSize=536870912
-XX:MaxHeapSize=1073741824
…

在上述示例中，我们可以看到进程的启动参数 -Xmx1024m -Xms512m，以及其他一些虚拟机参数的值。

使用 jinfo -flags <pid> 命令可以帮助了解正在运行的 Java 进程所使用的启动参数，这对于故障排除和性能优化非常有用。

3.3 -sysprops：查看进程的系统属性

jinfo -sysprops <pid> 用于查看指定进程的系统属性。通过运行该命令，可以获取正在运行的 Java 进程的系统属性及其对应的值。

当执行 jinfo -sysprops <pid> 命令时，它将与指定的 Java 进程进行通信，并返回该进程的所有系统属性及其当前设置的值。系统属性包括 Java 版本、操作系统名称、用户名称等。

以下是示例输出的一部分：

Command line: …
…
sun.java.command=com.example.MyApplication
java.home=/usr/lib/jvm/java-11-openjdk-amd64
…
os.name=Linux
os.version=5.4.0-42-generic
…
user.name=johndoe
…

在上述示例中，我们可以看到进程的一些系统属性，例如 sun.java.command、java.home、os.name 和 user.name 等。

使用 jinfo -sysprops <pid> 命令可以帮助了解正在运行的 Java 进程的系统属性，这对于了解环境配置和应用程序运行时信息非常有用。

3.4 -flag < name>：查看特定虚拟机参数的值

jinfo -flag <name> <pid> 命令用于查看特定虚拟机参数的值。通过运行该命令，可以获取正在运行的 Java 进程中特定虚拟机参数的当前设置值。

-flag <name>: 选项用于指定要查询虚拟机参数值的操作，并提供参数的名称。

运行命令后，将获得以下可能的输出情况：

• 如果指定的虚拟机参数存在并且可以映射到该进程，则输出 <name>=<value> 的形式。其中，<name> 是虚拟机参数的名称，<value> 是该虚拟机参数的当前值。
• 如果指定的虚拟机参数不存在或无法映射到该进程，则输出 Could not find the specified VM flag. 消息表示找不到指定的虚拟机参数。

假设我们要查看 Java 进程的 MaxHeapSize 虚拟机参数的值就可以照以下步骤操作：

• 打开终端或命令提示符窗口，运行命令：jps，以获取正在运行的 Java 进程的进程 ID (PID)；
• 从输出中找到目标进程的 PID（例如，12345），记下这个值；
• 使用命令 jinfo -flag MaxHeapSize 12345 来查看特定虚拟机参数的值。

在运行上述命令后，将得到以下可能的结果示例输出：

MaxHeapSize=512m

在上述示例中，我们可以看到目标 Java 进程的 MaxHeapSize 虚拟机参数的当前值为 512m。

分析结果时，请注意以下几点：

• 确保指定的虚拟机参数名称正确无误，并与实际应用程序使用的参数名称一致。
• 检查虚拟机参数的值，了解当前的配置设置。根据需要，可以比较、调整和优化参数的值，以满足应用程序的需求。

请注意，确保 <pid> 是要查询的目标 Java 进程的有效进程 ID，并且具有足够权限来访问该进程的信息。

3.5 -flag [+/-]< name>：启用或禁用特定虚拟机参数的值

jinfo -flag [+/-]<name> <pid> 是 jinfo 命令的一条选项，用于启用或禁用特定虚拟机参数的值。通过运行该命令，可以更改正在运行的 Java 进程中指定虚拟机参数的状态。

-flag [+/-]<name>: 选项用于指定要启用或禁用虚拟机参数的操作，并提供参数的名称。使用 “+” 号表示启用参数，使用 “-” 号表示禁用参数。<name> 是要启用或禁用的虚拟机参数的名称。

当执行 jinfo -flag [+/-]<name> <pid> 命令时，它将与指定的 Java 进程进行通信，并更改指定虚拟机参数的状态。

以下是示例输出：

Command line flags for process id: 12345:
-XX:+PrintGCDetails
-XX:MaxHeapSize=512m
…

在上述示例中，我们可以看到进程的特定虚拟机参数 -XX:+PrintGCDetails 已经被启用。要禁用该参数，可以运行 jinfo -flag -PrintGCDetails 12345。

这是命令的使用方式。但请注意，在动态修改虚拟机参数时，存在一些限制和约束。某些参数可能需要在进程启动之前进行配置或重启进程才能生效。因此，在更改虚拟机参数之前，请务必参考相应的文档和建议，以避免可能产生的意外结果。

4️⃣ 应用场景

• 调试：通过查看和修改虚拟机参数来分析和调试应用程序的性能问题；
• 优化：通过修改虚拟机参数来改进应用程序的性能和资源利用率；
• 监控：实时跟踪和记录 Java 进程的运行时信息，以便进行监控和分析。
  
  

🌾 总结

jinfo 是一款方便的工具，可用于在运行的 Java 进程中检索和修改运行时信息。它为用户提供了简单而直观的界面，使其可以轻松地查看和更改虚拟机参数。通过与 JVM 内部通信，它提供了实时性和灵活性，可以帮助开发人员进行调试、优化和监控应用程序。但是，需要小心使用，确保理解虚拟机参数的含义和影响，以避免潜在的风险。