JCMD(1)

๐Ÿ“ฆ version 21.0.12.1.1, in centos-stream 10, opensuse-leap 16.0

๐Ÿ’– NAME ๐Ÿ’–

jcmd โ€” from the JDK Commands crew, aka the JCMD(1) manual โ€” sends diagnostic command requests to a running Java Virtual Machine (JVM). ๐Ÿ’…โœจ

โœจ SYNOPSIS โœจ

jcmd [pid | main-class] command...  | PerfCounter.print | -f filename

jcmd [-l]

jcmd -h
  • pid โ€” When used, the jcmd utility sends the diagnostic command request to the process ID for the Java process.
  • main-class โ€” When used, the jcmd utility sends the diagnostic command request to all Java processes with the specified name of the main class.
  • command โ€” The command must be a valid jcmd command for the selected JVM. The list of available commands for jcmd is obtained by running the help command (jcmd pid help) where pid is the process ID for the running Java process. If the pid is 0, commands will be sent to all Java processes. The main-class argument will be used to match, either partially or fully, the class used to start Java. If no options are given, it lists the running Java process identifiers with the main class and command-line arguments that were used to launch the process (the same as using -l).
  • Perfcounter.print โ€” Prints the performance counters exposed by the specified Java process.
  • -f filename โ€” Reads and executes commands from a specified file, filename.
  • -l โ€” Displays the list of Java Virtual Machine process identifiers that are not running in a separate docker process along with the main class and command-line arguments that were used to launch the process. If the JVM is in a docker process, you must use tools such as ps to look up the PID.
Note: Using jcmd without arguments is the same as using jcmd -l.
  • -h โ€” Displays the jcmd utility's command-line help.

๐ŸŒธ DESCRIPTION ๐ŸŒธ

Okay so the jcmd utility is used to send diagnostic command requests to the JVM. Important vibe check: it must be used on the same machine on which the JVM is running, and it has to have the same effective user and group identifiers that were used to launch the JVM. ๐Ÿ”’

Each diagnostic command has its own set of arguments. To display the description, syntax, and a list of available arguments for a diagnostic command, use the name of the command as the argument. For example:

jcmd pid help command

If arguments contain spaces, then you must surround them with single or double quotation marks (' or "). In addition, you must escape single or double quotation marks with a backslash (\) to prevent the operating system shell from processing quotation marks. Alternatively, you can surround these arguments with single quotation marks and then with double quotation marks (or with double quotation marks and then with single quotation marks). ๐Ÿšโœจ

If you specify the process identifier (pid) or the main class (main-class) as the first argument, then the jcmd utility sends the diagnostic command request to the Java process with the specified identifier or to all Java processes with the specified name of the main class. You can also send the diagnostic command request to all available Java processes by specifying 0 as the process identifier. ๐Ÿซถ

๐Ÿ‘‘ COMMANDS FOR JCMD ๐Ÿ‘‘

The command must be a valid jcmd diagnostic command for the selected JVM. The list of available commands for jcmd is obtained by running the help command (jcmd pid help) where pid is the process ID for a running Java process. If the pid is 0, commands will be sent to all Java processes. The main-class argument will be used to match, either partially or fully, the class used to start Java. If no options are given, it lists the running Java process identifiers that are not in separate docker processes along with the main class and command-line arguments that were used to launch the process (the same as using -l). ๐Ÿ‘€

The following commands are available:

๐Ÿ’ฌ help [options] [arguments]

For more information about a specific command.

arguments:

  • command name: The name of the command for which we want help (STRING, no default value)
Note: The following options must be specified using either key or key=value syntax.

options:

  • -all: (Optional) Show help for all commands (BOOLEAN, false) .

๐Ÿง  Compiler.codecache

Prints code cache layout and bounds.

Impact: Low

๐Ÿ“š Compiler.codelist

Prints all compiled methods in code cache that are alive.

Impact: Medium

๐Ÿง Compiler.perfmap (Linux only)

Write map file for Linux perf tool.

Impact: Low

๐Ÿงต Compiler.queue

Prints methods queued for compilation.

Impact: Low

๐Ÿ› ๏ธ Compiler.directives_add filename arguments

Adds compiler directives from a file.

Impact: Low

arguments:

  • filename: The name of the directives file (STRING, no default value)

๐Ÿงน Compiler.directives_clear

Remove all compiler directives.

Impact: Low

๐Ÿ–จ๏ธ Compiler.directives_print

Prints all active compiler directives.

Impact: Low

โœ‚๏ธ Compiler.directives_remove

Remove latest added compiler directive.

Impact: Low

๐Ÿ“Š GC.class_histogram [options]

Provides statistics about the Java heap usage.

Impact: High --- depends on Java heap size and content.

Note: The options must be specified using either key or key=value syntax.

options:

  • -all: (Optional) Inspects all objects, including unreachable objects (BOOLEAN, false)
  • -parallel: (Optional) Number of parallel threads to use for heap inspection. 0 (the default) means let the VM determine the number of threads to use. 1 means use one thread (disable parallelism). For any other value the VM will try to use the specified number of threads, but might use fewer. (INT, 0)

๐Ÿชฆ GC.finalizer_info

Provides information about the Java finalization queue.

Impact: Medium

๐Ÿ—‚๏ธ GC.heap_dump [options] [arguments]

Generates a HPROF format dump of the Java heap.

Impact: High --- depends on the Java heap size and content. Request a full GC unless the -all option is specified.

Note: The following options must be specified using either key or key=value syntax.

options:

  • -all: (Optional) Dump all objects, including unreachable objects (BOOLEAN, false)
  • -gz: (Optional) If specified, the heap dump is written in gzipped format using the given compression level. 1 (recommended) is the fastest, 9 the strongest compression. (INT, 1)
  • -overwrite: (Optional) If specified, the dump file will be overwritten if it exists (BOOLEAN, false)

arguments:

  • filename: The name of the dump file (STRING, no default value)

๐Ÿงบ GC.heap_info

Provides generic Java heap information.

Impact: Medium

๐Ÿƒ GC.run

Calls java.lang.System.gc().

Impact: Medium --- depends on the Java heap size and content.

๐Ÿ GC.run_finalization

Calls java.lang.System.runFinalization().

Impact: Medium --- depends on the Java content.

๐ŸŽฅ JFR.check [options]

Show information about a running flight recording

Impact: Low

Note: The options must be specified using either key or key=value syntax. If no parameters are entered, information for all active recordings is shown.

options:

  • name: (Optional) Name of the flight recording. (STRING, no default value)
  • verbose: (Optional) Flag for printing the event settings for the recording (BOOLEAN, false)

โš™๏ธ JFR.configure [options]

Set the parameters for a flight recording

Impact: Low

Note: The options must be specified using either key or key=value syntax. If no parameters are entered, the current settings are displayed.

options:

  • globalbuffercount: (Optional) Number of global buffers. This option is a legacy option: change the memorysize parameter to alter the number of global buffers. This value cannot be changed once JFR has been initialized. (STRING, default determined by the value for memorysize)
  • globalbuffersize: (Optional) Size of the global buffers, in bytes. This option is a legacy option: change the memorysize parameter to alter the size of the global buffers. This value cannot be changed once JFR has been initialized. (STRING, default determined by the value for memorysize)
  • maxchunksize: (Optional) Maximum size of an individual data chunk in bytes if one of the following suffixes is not used: 'm' or 'M' for megabytes OR 'g' or 'G' for gigabytes. This value cannot be changed once JFR has been initialized. (STRING, 12M)
  • memorysize: (Optional) Overall memory size, in bytes if one of the following suffixes is not used: 'm' or 'M' for megabytes OR 'g' or 'G' for gigabytes. This value cannot be changed once JFR has been initialized. (STRING, 10M)
  • repositorypath: (Optional) Path to the location where recordings are stored until they are written to a permanent file. (STRING, The default location is the temporary directory for the operating system. On Linux operating systems, the temporary directory is /tmp. On Windwows, the temporary directory is specified by the TMP environment variable.)
  • preserve-repository={true|false} : Specifies whether files stored in the disk repository should be kept after the JVM has exited. If false, files are deleted. By default, this parameter is disabled.
  • stackdepth: (Optional) Stack depth for stack traces. Setting this value greater than the default of 64 may cause a performance degradation. This value cannot be changed once JFR has been initialized. (LONG, 64)
  • thread_buffer_size: (Optional) Local buffer size for each thread in bytes if one of the following suffixes is not used: 'k' or 'K' for kilobytes or 'm' or 'M' for megabytes. Overriding this parameter could reduce performance and is not recommended. This value cannot be changed once JFR has been initialized. (STRING, 8k)
  • samplethreads โ€” (optional) the flag that turns thread sampling ON. (BOOLEAN, true)

๐Ÿ’พ JFR.dump [options]

Writes data out to a file while a flight recording is actively running. Impact: Low.

Heads up bestie: you gotta pass the options using either key or key=value syntax. No options are required though. And the recording keeps running after the data gets written โ€” it does not stop, okay? ๐Ÿ’…

options:

  • begin โ€” (optional) tells it the time from which recording data gets included in the dump file. The format is specified as local time. (STRING, no default value)
  • end โ€” (optional) tells it the time to which recording data gets included in the dump file. The format is specified as local time. (STRING, no default value)
โญ Note: for both begin and end, the time has to be in a format that java.time.LocalTime::parse(STRING), java.time.LocalDateTime::parse(STRING) or java.time.Instant::parse(STRING) can read. Like for example "13:20:15", "2020-03-17T09:00:00" or "2020-03-17T09:00:00Z".
๐ŸŒธ Note: the begin and end times correspond to the timestamps found within the recorded information in the flight recording data.

Another option (yes there's more, we love options) is a time relative to the current time โ€” you specify it with a negative integer followed by "s", "m" or "h". For example "-12h", "-15m" or "-30s".

  • filename โ€” (optional) the name of the file the flight recording data gets dumped to. If you don't give a filename, one gets generated from the PID and the current date. The filename can also be a directory, in which case the filename is generated from the PID and the current date inside that specified directory. If %p and/or %t shows up in the filename, it expands to the JVM's PID and the current timestamp, respectively. (STRING, no default value) ๐ŸŽ€
  • maxage โ€” (optional) how long we're dumping the flight recording data to a file for. (INTEGER followed by 's' for seconds, 'm' for minutes or 'h' for hours, no default value)
  • maxsize โ€” (optional) the maximum size for the amount of data to dump from a flight recording, in bytes โ€” unless you use one of these suffixes: 'm' or 'M' for megabytes OR 'g' or 'G' for gigabytes. (STRING, no default value)
  • name โ€” (optional) the name of the recording. If no name is given, data from all recordings gets dumped. (STRING, no default value)
  • path-to-gc-root โ€” (optional) flag for saving the path to garbage collection (GC) roots at the moment the recording data is dumped. That path info is genuinely useful for finding memory leaks, BUT collecting it can make the application pause for a short period of time ๐Ÿ˜ญ. So only turn this flag on when you've got an application you suspect has a memory leak. (BOOLEAN, false)

โ–ถ๏ธ JFR.start [options]

Starts a flight recording. Impact: Low.

Note: options must be specified using either key or key=value syntax. If you enter no parameters at all, a recording is started with the default values. Periodt.

options:

  • delay โ€” (optional) how long to wait before starting to record. (INTEGER followed by 's' for seconds, 'm' for minutes or 'h' for hours, 0s)
  • disk โ€” (optional) flag for also writing the data to disk while recording. (BOOLEAN, true)
  • dumponexit โ€” (optional) flag for writing the recording to disk when the Java Virtual Machine (JVM) shuts down. If it's set to 'true' and no value is given for filename, the recording is written to a file in the directory where the process was started. The file name is a system-generated name containing the process ID, the recording ID and the current time stamp. (For example: id-1-2019_12_12_10_41.jfr) (BOOLEAN, false)
  • duration โ€” (optional) how long to record for. Note that 0s means forever. (INTEGER followed by 's' for seconds, 'm' for minutes or 'h' for hours, 0s)
  • filename โ€” (optional) the name of the file the flight recording data gets written to when the recording is stopped. If no filename is given, one is generated from the PID and the current date and placed in the directory where the process was started. The filename can also be a directory, in which case the filename is generated from the PID and the current date in that specified directory. If %p and/or %t shows up in the filename, it expands to the JVM's PID and the current timestamp, respectively. (STRING, no default value) โœจ
  • maxage โ€” (optional) the maximum time to keep the recorded data on disk. This parameter is only valid when the disk parameter is set to true. Note 0s means forever. (INTEGER followed by 's' for seconds, 'm' for minutes or 'h' for hours, 0s)
  • maxsize โ€” (optional) the maximum size of the data to keep on disk, in bytes โ€” unless one of these suffixes is used: 'm' or 'M' for megabytes OR 'g' or 'G' for gigabytes. This parameter is only valid when the disk parameter is set to 'true'. The value must not be less than the value for the maxchunksize parameter set with the JFR.configure command. (STRING, 0 (no maximum size))
  • name โ€” (optional) the name of the recording. If no name is provided, a name gets generated. Make note of the generated name shown in the response to the command so you can use it with other commands โ€” write it down bestie, seriously. (STRING, system-generated default name)
  • path-to-gc-root โ€” (optional) flag for saving the path to garbage collection (GC) roots at the end of a recording. The path info is useful for finding memory leaks but collecting it is time consuming ๐Ÿ’€. Only turn this flag on when you've got an application you suspect has a memory leak. If the settings parameter is set to 'profile', then the information collected includes the stack trace from where the potential leaking object was allocated. (BOOLEAN, false)
  • settings โ€” (optional) the name of the settings file that identifies which events to record. To specify more than one file, separate the names with a comma (,). Include the path if the file isn't in JAVA-HOME/lib/jfr. The following profiles ship with the JDK in the JAVA-HOME/lib/jfr directory: 'default.jfc' โ€” collects a predefined set of information with low overhead, so it has minimal impact on performance and can be used with recordings that run continuously; 'profile.jfc' โ€” provides more data than the 'default.jfc' profile, but with more overhead and impact on performance. Use this configuration for short periods of time when you need more information. Use none to start a recording without a predefined configuration file. (STRING, JAVA-HOME/lib/jfr/default.jfc) ๐Ÿ‘‘

Event settings and .jfc options can be specified using the following syntax:

  • option โ€” (optional) specifies the option value to modify. To list available options, use the JAVA_HOME/bin/jfr tool.
  • event-setting โ€” (optional) specifies the event setting value to modify. Use the form: <event-name>#<setting-name>=<value> To add a new event setting, prefix the event name with '+'.

You can specify values for multiple event settings and .jfc options by separating them with a whitespace. In case of a conflict between a parameter and a .jfc option, the parameter takes precedence. The whitespace delimiter can be omitted for timespan values, i.e. 20ms. For more info about the settings syntax, see the Javadoc of the jdk.jfr package. ๐Ÿฆ‹


โน๏ธ JFR.stop [options]

Stops a flight recording. Impact: Low.

Note: options must be specified using either key or key=value syntax. If you enter no parameters, then no recording is stopped. (Yes, that means nothing happens. The vibe check failed. ๐Ÿ™ˆ)

options:

  • filename โ€” (optional) the name of the file the recording is written to when the recording is stopped. If %p and/or %t shows up in the filename, it expands to the JVM's PID and the current timestamp, respectively. If no path is provided, the data from the recording is discarded. (STRING, no default value)
  • name โ€” (optional) the name of the recording. (STRING, no default value)

๐Ÿงฉ JVMTI.agent_load [arguments]

Loads a JVMTI native agent. Impact: Low.

arguments:

  • library path โ€” absolute path of the JVMTI agent to load. (STRING, no default value)
  • agent option โ€” (optional) option string to pass to the agent. (STRING, no default value)

๐Ÿ—‚๏ธ JVMTI.data_dump

Signals the JVM to do a data-dump request for JVMTI. Impact: High. ๐Ÿ”ฅ


๐Ÿ“ก ManagementAgent.start [options]

Starts the remote management agent. Impact: Low --- no impact.

Note: the following options must be specified using either key or key=value syntax.

options:

  • config.file โ€” (optional) sets com.sun.management.config.file (STRING, no default value)
  • jmxremote.host โ€” (optional) sets com.sun.management.jmxremote.host (STRING, no default value)
  • jmxremote.port โ€” (optional) sets com.sun.management.jmxremote.port (STRING, no default value)
  • jmxremote.rmi.port โ€” (optional) sets com.sun.management.jmxremote.rmi.port (STRING, no default value)
  • jmxremote.ssl โ€” (optional) sets com.sun.management.jmxremote.ssl (STRING, no default value)
  • jmxremote.registry.ssl โ€” (optional) sets com.sun.management.jmxremote.registry.ssl (STRING, no default value)
  • jmxremote.authenticate โ€” (optional) sets com.sun.management.jmxremote.authenticate (STRING, no default value)
  • jmxremote.password.file โ€” (optional) sets com.sun.management.jmxremote.password.file (STRING, no default value)
  • jmxremote.access.file โ€” (optional) sets com.sun.management.jmxremote.access.file (STRING, no default value)
  • jmxremote.login.config โ€” (optional) sets com.sun.management.jmxremote.login.config (STRING, no default value)
  • jmxremote.ssl.enabled.cipher.suites โ€” (optional) sets com.sun.management. ๐Ÿ’€ (yes bestie, that's literally where the page cuts it off, don't come for me)
  • jmxremote.ssl.enabled.cipher.suite โ€” (STRING, no default value)
  • jmxremote.ssl.enabled.protocols โ€” (optional) sets com.sun.management.jmxremote.ssl.enabled.protocols (STRING, no default value)
  • jmxremote.ssl.need.client.auth โ€” (optional) sets com.sun.management.jmxremote.need.client.auth (STRING, no default value)
  • jmxremote.ssl.config.file โ€” (optional) sets com.sun.management.jmxremote.ssl_config_file (STRING, no default value)
  • jmxremote.autodiscovery โ€” (optional) sets com.sun.management.jmxremote.autodiscovery (STRING, no default value)
  • jdp.port โ€” (optional) sets com.sun.management.jdp.port (INT, no default value)
  • jdp.address โ€” (optional) sets com.sun.management.jdp.address (STRING, no default value)
  • jdp.source_addr โ€” (optional) sets com.sun.management.jdp.source_addr (STRING, no default value)
  • jdp.ttl โ€” (optional) sets com.sun.management.jdp.ttl (INT, no default value)
  • jdp.pause โ€” (optional) sets com.sun.management.jdp.pause (INT, no default value)
  • jdp.name โ€” (optional) sets com.sun.management.jdp.name (STRING, no default value)

๐ŸŒฑ ManagementAgent.start_local

Starts the local management agent. Little guy stays in his lane, on his own machine. ๐Ÿ 

Impact: Low --- no impact

๐Ÿ“Š ManagementAgent.status

Prints the management agent status. Like a vibe check but for your agent, y'know? ๐Ÿ”

Impact: Low --- no impact

๐Ÿ›‘ ManagementAgent.stop

Stops the remote management agent. Bye bestie, go home. ๐Ÿ‘‹

Impact: Low --- no impact

๐Ÿง  System.native_heap_info (Linux only)

Prints info about native heap usage, and it does it through malloc_info(3). Linux girlies only, sorry. ๐Ÿง

Impact: Low

โœ‚๏ธ System.trim_native_heap (Linux only)

Attempts to free up memory by trimming the C-heap. It's giving "cleaning out your closet" energy. ๐Ÿงน

Impact: Low

๐Ÿงต Thread.print [options]

Prints all the threads, stacktraces and all. Every single one. No thread left behind. ๐Ÿ’…

Impact: Medium --- depends on the number of threads.

Note: the following options must be specified using either key or key=value syntax.

options:

  • -e โ€” (optional) print extended thread information (BOOLEAN, false)
  • -l โ€” (optional) prints java.util.concurrent locks (BOOLEAN, false)

๐Ÿ“ฆ VM.cds [arguments]

Dumps a static or dynamic shared archive that includes all currently loaded classes.

Impact: Medium --- pause time depends on number of loaded classes

arguments:

  • subcmd โ€” must be either static_dump or dynamic_dump (STRING, no default value)
  • filename โ€” (optional) name of the shared archive to be dumped (STRING, no default value)

If filename isn't specified, a default file name gets chosen using the pid of the target JVM process. Like, for example: java_pid1234_static.jsa, java_pid5678_dynamic.jsa, etc. ๐Ÿท๏ธ

If filename isn't specified as an absolute path, the archive file gets created in a directory relative to the current directory of the target JVM process. (So yes, watch your cwd, bestie ๐Ÿ™ˆ)

If dynamic_dump is specified, the target JVM must be started with the JVM option -XX:+RecordDynamicDumpInfo. Non-negotiable, no cap.

๐Ÿช† VM.classloaders [options]

Prints the classloader hierarchy. It's loaders all the way down. ๐Ÿข

Impact: Medium --- depends on number of class loaders and classes loaded.

The following options must be specified using either key or key=value syntax.

options:

  • show-classes โ€” (optional) print loaded classes. (BOOLEAN, false)
  • verbose โ€” (optional) print detailed information. (BOOLEAN, false)
  • fold โ€” (optional) show loaders of the same name and class as one. (BOOLEAN, true)

๐Ÿ“ˆ VM.classloader_stats

Prints statistics about all the ClassLoaders. Numbers everywhere, we love to see it. โœจ

Impact: Low

๐ŸŒณ VM.class_hierarchy [options] [arguments]

Prints a list of all loaded classes, indented to show the class hierarchy. Each class name is followed by the ClassLoaderData* of its ClassLoader, or "null" if it's loaded by the bootstrap class loader. Very demure, very tree-shaped. ๐ŸŒฒ

Impact: Medium --- depends on the number of loaded classes.

Note: the following options must be specified using either key or key=value syntax.

options:

  • -i โ€” (optional) inherited interfaces should be printed. (BOOLEAN, false)
  • -s โ€” (optional) if a classname is specified, print its subclasses in addition to its superclasses. Without this option only the superclasses will be printed. (BOOLEAN, false)

arguments:

  • classname โ€” (optional) the name of the class whose hierarchy should be printed. If not specified, all class hierarchies are printed. (STRING, no default value)

๐Ÿ’ป VM.command_line

Prints the command line used to start this VM instance. Receipts! ๐Ÿงพ

Impact: Low

๐Ÿ“š VM.dynlibs

Prints the loaded dynamic libraries. All of 'em. ๐Ÿ—‚๏ธ

Impact: Low

๐Ÿ“ VM.events [options]

Prints VM event logs. The lore. ๐Ÿ“–

Impact: Low --- depends on event log size.

options:

Note: the following options must be specified using either key or key=value syntax.
  • log โ€” (optional) name of log to be printed. If omitted, all logs are printed. (STRING, no default value)
  • max โ€” (optional) maximum number of events to be printed (newest first). If omitted, all events are printed. (STRING, no default value)

โ„น๏ธ VM.info

Prints information about the JVM environment and status. Just a little info dump, as a treat. ๐Ÿซถ

Impact: Low

๐Ÿชต VM.log [options]

Lists current log configuration, enables/disables/configures a log output, or rotates all logs. Multi-talented fr.

Impact: Low

options:

Note: the following options must be specified using either key or key=value syntax.
  • output โ€” (optional) the name or index (#) of output to configure. (STRING, no default value)
  • output_options โ€” (optional) options for the output. (STRING, no default value)
  • what โ€” (optional) configures what tags to log. (STRING, no default value )
  • decorators โ€” (optional) configures which decorators to use. Use 'none' or an empty value to remove all. (STRING, no default value)
  • disable โ€” (optional) turns off all logging and clears the log configuration. (BOOLEAN, no default value)
  • list โ€” (optional) lists current log configuration. (BOOLEAN, no default value)
  • rotate โ€” (optional) rotates all logs. (BOOLEAN, no default value)

๐Ÿšฉ VM.flags [options]

Prints the VM flag options and their current values. Flag reveal. ๐Ÿ”Ž

Impact: Low

Note: the following options must be specified using either key or key=value syntax.

options:

  • -all โ€” (optional) prints all flags supported by the VM (BOOLEAN, false).

๐Ÿงฌ VM.metaspace [options]

Prints the statistics for the metaspace. Big numbers, tiny space. ๐Ÿช

Impact: Medium --- depends on number of classes loaded.

Note: the following options must be specified using either key or key=value syntax.

options:

  • basic โ€” (optional) prints a basic summary (does not need a safepoint). (BOOLEAN, false)
  • show-loaders โ€” (optional) shows usage by class loader. (BOOLEAN, false)
  • show-classes โ€” (optional) if show-loaders is set, shows loaded classes for each loader. (BOOLEAN, false)
  • by-chunktype โ€” (optional) break down numbers by chunk type. (BOOLEAN, false)
  • by-spacetype โ€” (optional) break down numbers by loader type. (BOOLEAN, false)
  • vslist โ€” (optional) shows details about the underlying virtual space. (BOOLEAN, false)
  • scale โ€” (optional) memory usage in which to scale. Valid values are: 1, KB, MB or GB (fixed scale) or "dynamic" for a dynamically chosen scale. (STRING, dynamic)

๐Ÿงฎ VM.native_memory [options]

Prints native memory usage. It's giving budgeting-app-for-your-VM. ๐Ÿ’ธ

Impact: Medium

Note: the following options must be specified using either key or key=value syntax.

options:

  • summary โ€” (optional) requests runtime to report current memory summary, which includes total reserved and committed memory, along with memory usage summary by each subsystem. (BOOLEAN, false)
  • detail โ€” (optional) requests runtime to report memory allocation >= 1K by each callsite. (BOOLEAN, false)
  • baseline โ€” (optional) requests runtime to baseline current memory usage, so it can be compared against in later time. (BOOLEAN, false)
  • summary.diff โ€” (optional) requests runtime to report memory summary comparison against previous baseline. (BOOLEAN, false)
  • detail.diff โ€” (optional) requests runtime to report memory detail comparison against previous baseline, which shows the memory allocation activities at different callsites. (BOOLEAN, false)
  • statistics โ€” (optional) prints tracker statistics for tuning purpose. (BOOLEAN, false)
  • scale โ€” (optional) memory usage in which scale, KB, MB or GB (STRING, KB)

๐Ÿ‘† VM.print_touched_methods

Prints all methods that have ever been touched during the lifetime of this JVM. Every single one it's ever laid hands on, no cap. ๐Ÿซต

Impact: Medium --- depends on Java content.

๐ŸŽš๏ธ VM.set_flag [arguments]

Sets the VM flag option by using the provided value. You're the one with the aux now. ๐Ÿ”ง

Impact: Low

arguments:

  • flag name โ€” the name of the flag that you want to set (STRING, no default value)
  • string value โ€” (optional) the value that you want to set (STRING, no default value)

๐Ÿงถ VM.stringtable [options]

Dumps the string table. All your little strings, in one place. ๐ŸŽ€

Impact: Medium --- depends on the Java content.

Note:
  • -verbose โ€” (Optional) dumps the content of each string in the table (BOOLEAN, false) ๐Ÿงต

VM.symboltable [options] ๐Ÿ’ซ

Dumps the symbol table, bestie. That's the whole vibe.

Impact: Medium โ€” literally depends on the Java content, so likeโ€ฆ it varies ๐Ÿ˜Œ

Note: the following options must be specified using either key or key=value syntax (yes, the original has a stray ) there โ€” she's quirky like that ๐ŸŽ€).

options:

  • -verbose โ€” (Optional) dumps the content of each symbol in the table (BOOLEAN, false) ๐Ÿ”

VM.systemdictionary ๐Ÿ“š

Prints the statistics for dictionary hashtable sizes and bucket length. Number-crunching era โœจ

Impact: Medium

Note: the following options must be specified using either key or key=value syntax.

options:

  • verbose โ€” (Optional) dump the content of each dictionary entry for all class loaders (BOOLEAN, false). Notice there's no dash on this one โ€” she's built different, don't @ me ๐Ÿ’…

VM.system_properties ๐Ÿท๏ธ

Prints the system properties. That's it. That's the whole command. Low effort, high payoff ๐Ÿซถ

Impact: Low

VM.uptime [options] โฐ

Prints the VM uptime โ€” how long your JVM has been awake and thriving ๐ŸŒธ

Impact: Low

Note: the following options must be specified using either key or key=value syntax.

options:

  • -date โ€” (Optional) adds a prefix with the current date (BOOLEAN, false) ๐Ÿ“…

VM.version ๐Ÿ‘‘

Prints JVM version information. Short, iconic, no options, no notes, no drama โ€” main character energy fr fr ๐ŸŒˆ

Impact: Low


aaaand that's a wrap on the whole page, bestie!! ๐Ÿ’– You made it to the end, I'm so proud ๐Ÿฅน This lil beauty is from JDK 21, dated 2023, and the footer tag on the page reads JDK 21, 2023, JCMD(1) โ€” that's the source, the version and the date all snuggled together at the bottom ๐ŸŽ€ Now go forth and jcmd responsibly, iykyk ๐Ÿ’…โœจ

๐Ÿ“ฆ where this page comes from