1jcmd(1)                     General Commands Manual                    jcmd(1)
2
3
4

Name

6       jcmd  -  Sends  diagnostic  command  requests to a running Java Virtual
7       Machine
8

SYNOPSIS

10       jcmd [ options ]
11       jcmd [ pid | main-class ] PerfCounter.print
12       jcmd [ pid | main-class ] command [arguments]
13       jcmd [ pid | main-class ] -f file
14
15
16          options
17             The command-line options. See Options.
18
19          pid
20             Identifies the  process  that  receives  the  diagnostic  command
21             requests.  The  process  must be a Java process. To get a list of
22             Java processes running on a machine, use jps(1) or jcmd(1).
23
24          main-class
25             The main class of the process that receives the  diagnostic  com‐
26             mand  requests.  When  matching processes, any process whose main
27             class name contains  the  specified  string  as  a  substring  is
28             matched.  If  several  running Java processes share the same main
29             class, then the diagnostic command request is sent to  all  these
30             processes.  To get a list of Java processes running on a machine,
31             use jps(1) or jcmd(1).
32
33          command [arguments]
34             The main class of the process that receives the  diagnostic  com‐
35             mand  requests.  When  matching processes, any process whose main
36             class name contains  the  specified  string  as  a  substring  is
37             matched.  If  several  running Java processes share the same main
38             class, then the diagnostic command request is sent to  all  these
39             processes.  To get a list of Java processes running on a machine,
40             use jps(1) or jcmd(1).
41
42          Perfcounter.print
43             Print the performance counters available  on  the  targeted  Java
44             processes.  The  list of performance counters might vary with the
45             Java process.
46
47          -f file
48             Read commands from file and call them on the targeted  Java  pro‐
49             cesses.  In  file, each command must be written on a single line.
50             Lines starting with # are ignored. Processing of file  ends  when
51             all  lines  have  been  called or when a line containing the stop
52             keyword is read.
53
54

DESCRIPTION

56       jcmd is a utility to send diagnostic command requests to a Java Virtual
57       Machine supporting this feature.
58
59       Used  without  arguments or with the -l option, jcmd prints the list of
60       running Java processes with their process  ID,  their  main  class  and
61       their command-line arguments.
62
63       When  a  process  ID  is  specified on the command line, jcmd sends the
64       diagnostic command request to the process with this ID.
65
66       When a main class is specified on the  command  line,  jcmd  sends  the
67       diagnostic  command  request  to  all Java processes for which the com‐
68       mand-line argument is a substring of the Java process' main class.
69
70       With the PerfCounter.print argument, jcmd prints the performance  coun‐
71       ters available on the targeted Java processes.
72
73       With the -f option, jcmd sends to the targeted Java processes the diag‐
74       nostic commands stored in the specified file.
75

OPTIONS

77       Options are mutually exclusive. Options, when  used,  must  immediately
78       follow the command name.
79
80          -l Prints the list of running Java processes with their process IDs,
81             their main classes, and their command-line arguments.
82
83          -h Prints a help message.
84
85          -help
86             Prints a help message.
87
88

SEE ALSO

90          o jps
91
92
93                                  18 Jul 2013                          jcmd(1)