annotate src/bsd/doc/man/jinfo.1 @ 5034:ffdd6fa55445

Merge
author mullan
date Wed, 07 Mar 2012 09:18:46 -0500
parents
children ce47ee2975b3
rev   line source
michaelm@4834 1 ." Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
michaelm@4834 2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
michaelm@4834 3 ."
michaelm@4834 4 ." This code is free software; you can redistribute it and/or modify it
michaelm@4834 5 ." under the terms of the GNU General Public License version 2 only, as
michaelm@4834 6 ." published by the Free Software Foundation.
michaelm@4834 7 ."
michaelm@4834 8 ." This code is distributed in the hope that it will be useful, but WITHOUT
michaelm@4834 9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
michaelm@4834 10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
michaelm@4834 11 ." version 2 for more details (a copy is included in the LICENSE file that
michaelm@4834 12 ." accompanied this code).
michaelm@4834 13 ."
michaelm@4834 14 ." You should have received a copy of the GNU General Public License version
michaelm@4834 15 ." 2 along with this work; if not, write to the Free Software Foundation,
michaelm@4834 16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
michaelm@4834 17 ."
michaelm@4834 18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
michaelm@4834 19 ." or visit www.oracle.com if you need additional information or have any
michaelm@4834 20 ." questions.
michaelm@4834 21 ."
michaelm@4834 22 .TH jinfo 1 "10 May 2011"
michaelm@4834 23
michaelm@4834 24 .LP
michaelm@4834 25 .SH "Name"
michaelm@4834 26 jinfo \- Configuration Info
michaelm@4834 27 .LP
michaelm@4834 28 .SH "SYNOPSIS"
michaelm@4834 29 .LP
michaelm@4834 30 .nf
michaelm@4834 31 \f3
michaelm@4834 32 .fl
michaelm@4834 33 \fP\f3jinfo\fP [ option ] pid
michaelm@4834 34 .fl
michaelm@4834 35 \f3jinfo\fP [ option ] executable core
michaelm@4834 36 .fl
michaelm@4834 37 \f3jinfo\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
michaelm@4834 38 .fl
michaelm@4834 39 .fi
michaelm@4834 40
michaelm@4834 41 .LP
michaelm@4834 42 .SH "PARAMETERS"
michaelm@4834 43 .LP
michaelm@4834 44 .RS 3
michaelm@4834 45 .TP 3
michaelm@4834 46 option
michaelm@4834 47 Options are mutually exclusive. Option, if used, should follow immediately after the command name.
michaelm@4834 48 .RE
michaelm@4834 49
michaelm@4834 50 .LP
michaelm@4834 51 .RS 3
michaelm@4834 52 .TP 3
michaelm@4834 53 pid
michaelm@4834 54 process id for which the configuration info is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps(1) may be used.
michaelm@4834 55 .RE
michaelm@4834 56
michaelm@4834 57 .LP
michaelm@4834 58 .RS 3
michaelm@4834 59 .TP 3
michaelm@4834 60 executable
michaelm@4834 61 Java executable from which the core dump was produced.
michaelm@4834 62 .RE
michaelm@4834 63
michaelm@4834 64 .LP
michaelm@4834 65 .RS 3
michaelm@4834 66 .TP 3
michaelm@4834 67 core
michaelm@4834 68 core file for which the configuration info is to be printed.
michaelm@4834 69 .RE
michaelm@4834 70
michaelm@4834 71 .LP
michaelm@4834 72 .RS 3
michaelm@4834 73 .TP 3
michaelm@4834 74 remote\-hostname\-or\-IP
michaelm@4834 75 remote debug server's (see jsadebugd(1)) hostname or IP address.
michaelm@4834 76 .RE
michaelm@4834 77
michaelm@4834 78 .LP
michaelm@4834 79 .RS 3
michaelm@4834 80 .TP 3
michaelm@4834 81 server\-id
michaelm@4834 82 optional unique id, if multiple debug servers are running on the same remote host.
michaelm@4834 83 .RE
michaelm@4834 84
michaelm@4834 85 .LP
michaelm@4834 86 .SH "DESCRIPTION"
michaelm@4834 87 .LP
michaelm@4834 88 .LP
michaelm@4834 89 \f3jinfo\fP prints Java configuration information for a given Java process or core file or a remote debug server. Configuration information includes Java System properties and Java virtual machine command line flags. If the given process is running on a 64\-bit VM, you may need to specify the \f2\-J\-d64\fP option, e.g.:
michaelm@4834 90 .br
michaelm@4834 91 jinfo \-J\-d64 \-sysprops pid
michaelm@4834 92 .LP
michaelm@4834 93 .LP
michaelm@4834 94 \f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. In Windows Systems where dbgeng.dll is not present, 'Debugging Tools For Windows' need to be installed to have these tools working. Also, \fP\f4PATH\fP\f3 environment variable should contain the location of \fP\f4jvm.dll\fP\f3 used by the target process or the location from which the Crash Dump file was produced.\fP
michaelm@4834 95 .LP
michaelm@4834 96 .LP
michaelm@4834 97 \f3For example, \fP\f4set PATH=<jdk>\\jre\\bin\\client;%PATH%\fP
michaelm@4834 98 .LP
michaelm@4834 99 .SH "OPTIONS"
michaelm@4834 100 .LP
michaelm@4834 101 .RS 3
michaelm@4834 102 .TP 3
michaelm@4834 103 <no option>
michaelm@4834 104 prints both command line flags as well as System properties name, value pairs.
michaelm@4834 105 .br
michaelm@4834 106 .TP 3
michaelm@4834 107 \-flag name
michaelm@4834 108 prints the name and value of the given command line flag.
michaelm@4834 109 .br
michaelm@4834 110 .TP 3
michaelm@4834 111 \-flag [+|\-]name
michaelm@4834 112 enables or disables the given boolean command line flag.
michaelm@4834 113 .br
michaelm@4834 114 .TP 3
michaelm@4834 115 \-flag name=value
michaelm@4834 116 sets the given command line flag to the specified value.
michaelm@4834 117 .br
michaelm@4834 118 .TP 3
michaelm@4834 119 \-flags
michaelm@4834 120 prints command line flags passed to the JVM. pairs.
michaelm@4834 121 .br
michaelm@4834 122 .TP 3
michaelm@4834 123 \-sysprops
michaelm@4834 124 prints Java System properties as name, value pairs.
michaelm@4834 125 .br
michaelm@4834 126 .TP 3
michaelm@4834 127 \-h
michaelm@4834 128 prints a help message
michaelm@4834 129 .TP 3
michaelm@4834 130 \-help
michaelm@4834 131 prints a help message
michaelm@4834 132 .RE
michaelm@4834 133
michaelm@4834 134 .LP
michaelm@4834 135 .SH "SEE ALSO"
michaelm@4834 136 .LP
michaelm@4834 137 .RS 3
michaelm@4834 138 .TP 2
michaelm@4834 139 o
michaelm@4834 140 jps(1)
michaelm@4834 141 .TP 2
michaelm@4834 142 o
michaelm@4834 143 jsadebugd(1)
michaelm@4834 144 .RE
michaelm@4834 145
michaelm@4834 146 .LP
michaelm@4834 147