'\" t
.\" Copyright (c) 2012, 2015, 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
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\" Title: jcmd
.\" Language: Persian
.\" Date: 03 March 2015
.\" SectDesc: Troubleshooting Tools
.\" Software: JDK 8
.\" Arch: generic
.\" Part Number: E38207-04
.\" Doc ID: JSSON
.\"
.if n .pl 99999
.TH "jcmd" "1" "03 March 2015" "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)"
jcmd \- ابزار ارسال درخواست‌های عیب‌یابی و کنترل به ماشین مجازی جاوا (JVM) (نسخه ۱۱)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjcmd\fR [\fB\-l\fR|\fB\-h\fR|\fB\-help\fR]
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fBPerfCounter\&.print\fR
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fB\-f\fR \fIfilename\fR
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\fBjcmd\fR \fIpid\fR|\fImain\-class\fR \fIcommand\fR[ \fIarguments\fR]
.fi
.if n \{\
.RE
.\}
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBjcmd\fR
برای ارسال درخواست‌های دستورات عیب‌یابی به ماشین مجازی جاوا (JVM) استفاده می‌شود\&. این ابزار باید روی همان ماشینی اجرا شود که JVM در حال اجرا است، و باید دارای همان شناسه‌های کاربری و گروهی مؤثر (UID/GID) باشد که برای راه‌اندازی JVM استفاده شده‌اند\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.TS
allbox tab(:);
l.
T{
.PP
برای فراخوانی دستورات عیب‌یابی از راه دور یا با شناسه‌های کاربری متفاوت، می‌توانید از رابط
\fBcom\&.sun\&.management\&.DiagnosticCommandMBean\fR
استفاده کنید\&. برای اطلاعات بیشتر درباره رابط
\fBDiagnosticCommandMBean\fR ،
مستندات API را در نشانی زیر ببینید:
http://docs\&.oracle\&.com/javase/8/docs/jre/api/management/extension/com/sun/management/DiagnosticCommandMBean\&.html
T}
.TE
.sp 1
.sp .5v
.RE
.PP
اگر
\fBjcmd\fR
را بدون آرگومان یا با گزینه
\fB\-l\fR
اجرا کنید، فهرستی از شناسه‌های فرآیند (PID) جاوای در حال اجرا را همراه با کلاس اصلی (main class) و آرگومان‌های خط فرمانی که برای راه‌اندازی فرآیند استفاده شده‌اند، چاپ می‌کند\&. اجرای
\fBjcmd\fR
با گزینه
\fB\-h\fR
یا
\fB\-help\fR
پیام راهنمای این ابزار را چاپ می‌کند\&.
.PP
اگر شناسه فرآیند (\fIpid\fR) یا کلاس اصلی (\fImain\-class\fR) را به عنوان نخستین آرگومان مشخص کنید،
\fBjcmd\fR
درخواست دستور عیب‌یابی را به فرآیند جاوای دارای شناسه مشخص‌شده یا به تمام فرآیندهای جاوا با نام کلاس اصلی مشخص‌شده ارسال می‌کند\&. همچنین می‌توانید با مشخص کردن
\fB0\fR
به عنوان شناسه فرآیند، درخواست دستور عیب‌یابی را به تمام فرآیندهای جاوای در دسترس ارسال کنید\&. از یکی از موارد زیر به عنوان درخواست دستور عیب‌یابی استفاده کنید:
.PP
Perfcounter\&.print
.RS 4
شمارنده‌های کارایی (performance counters) موجود برای فرآیند جاوای مشخص‌شده را چاپ می‌کند\&. فهرست شمارنده‌های کارایی ممکن است در فرآیندهای مختلف جاوا متفاوت باشد\&.
.RE
.PP
\-f \fIfilename\fR
.RS 4
نام فایلی که دستورات عیب‌یابی از آن خوانده شده و به فرآیند جاوای مشخص‌شده ارسال می‌شوند\&. فقط با گزینه
\fB\-f\fR
استفاده می‌شود\&. هر دستور در فایل باید در یک خط مجزا نوشته شود\&. خطوطی که با علامت پوند (\fB#\fR) آغاز می‌شوند نادیده گرفته خواهند شد\&. پردازش فایل زمانی پایان می‌یابد که تمام خطوط خوانده شوند یا خطی حاوی کلمه کلیدی
\fBstop\fR
خوانده شود\&.
.RE
.PP
\fIcommand\fR [\fIarguments\fR]
.RS 4
دستوری که باید به فرآیند جاوای مشخص‌شده ارسال شود\&. فهرست دستورات عیب‌یابی موجود برای یک فرآیند معین را می‌توان با ارسال دستور
\fBhelp\fR
به آن فرآیند به دست آورد\&. هر دستور عیب‌یابی مجموعه‌ای از آرگومان‌های ویژه خود را دارد\&. برای مشاهده توضیحات، ساختار نحوی و فهرست آرگومان‌های موجود برای یک دستور، از نام آن دستور به عنوان آرگومان دستور
\fBhelp\fR
استفاده کنید\&.
.sp
\fBنکته:\fR
اگر هر یک از آرگومان‌ها حاوی فاصله (space) باشند، باید آن‌ها را درون علامت‌های نقل‌قول تکی یا دوتایی (\fB\*(Aq\fR
یا
\fB"\fR)
قرار دهید\&. افزون بر این، برای جلوگیری از پردازش نقل‌قول‌ها توسط پوسته سیستم‌عامل (shell)، باید نقل‌قول‌های تکی یا دوتایی را با یک بک‌اسلش (\fB\e\fR) اسکیپ کنید\&. در غیر این صورت می‌توانید این آرگومان‌ها را ابتدا درون نقل‌قول تکی و سپس درون نقل‌قول دوتایی (یا برعکس) محصور کنید\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌ها مانعة‌الجمع هستند (نمی‌توان هم‌زمان بیش از یکی را به کار برد)\&.
.PP
\-f \fIfilename\fR
.RS 4
دستورات را از فایل مشخص‌شده می‌خواند\&. این گزینه تنها در صورتی قابل استفاده است که شناسه فرآیند یا کلاس اصلی را به عنوان نخستین آرگومان مشخص کرده باشید\&. هر دستور در فایل باید در یک خط مجزا نوشته شود\&. خطوطی که با علامت پوند (\fB#\fR) آغاز می‌شوند نادیده گرفته خواهند شد\&. پردازش فایل زمانی پایان می‌یابد که تمام خطوط خوانده شوند یا خطی حاوی کلمه کلیدی
\fBstop\fR
خوانده شود\&.
.RE
.PP
\-h
.br
\-help
.RS 4
پیام راهنما را چاپ می‌کند\&.
.RE
.PP
\-l
.RS 4
فهرست شناسه‌های فرآیندهای جاوای در حال اجرا را به همراه کلاس اصلی و آرگومان‌های خط فرمان چاپ می‌کند\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
jps(1)
.RE
.br
'pl 8.5i
'bp