'\" t
.\" Copyright (c) 2004, 2013, 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.
.\"
.\"     Arch: generic
.\"     Software: JDK 8
.\"     Date: 21 November 2013
.\"     SectDesc: Monitoring Tools
.\"     Title: jps.1
.\"
.if n .pl 99999
.TH jps 1 "21 November 2013" "JDK 8" "Monitoring 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)"
jps \- ماشین‌های مجازی جاوای (JVMs) ابزاربندی‌شده روی سیستم هدف را فهرست می‌کند\&. این دستور آزمایشی است و پشتیبانی نمی‌شود\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp     
.nf     

\fBjps\fR [ \fIoptions\fR ] [ \fIhostid\fR ]
.fi     
.sp     
.TP     
\fIoptions\fR
گزینه‌های خط فرمان\&. بخش گزینه‌ها را ببینید\&.
.TP     
\fIhostid\fR
شناسهٔ میزبانی که گزارش فرایند باید برای آن تولید شود\&. مقدار \f3hostid\fR می‌تواند شامل مؤلفه‌های اختیاری باشد که پروتکل ارتباطی، شماره پورت و سایر داده‌های مختص پیاده‌سازی را مشخص می‌کنند\&. بخش شناسه میزبان را ببینید\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3jps\fR ماشین‌های مجازی جاوای HotSpot ابزاربندی‌شده روی سیستم هدف را فهرست می‌کند\&. این دستور تنها قادر به گزارش اطلاعات دربارهٔ JVMهایی است که مجوز دسترسی به آن‌ها را داشته باشد\&.
.PP
اگر دستور \f3jps\fR بدون تعیین یک \f3hostid\fR اجرا شود، به دنبال JVMهای ابزاربندی‌شده روی میزبان محلی می‌گردد\&. اگر با یک \f3hostid\fR آغاز شود، با استفاده از پروتکل و پورت مشخص‌شده، به جستجوی JVMها روی میزبان اشاره‌شده می‌پردازد\&. فرض می‌شود که یک فرایند \f3jstatd\fR روی میزبان هدف در حال اجرا باشد\&.
.PP
دستور \f3jps\fR شناسهٔ محلی JVM یا \f3lvmid\fR را برای هر JVM ابزاربندی‌شدهٔ یافت‌شده روی سیستم هدف گزارش می‌دهد\&. مقدار \f3lvmid\fR معمولاً، ولی نه لزوماً، شناسهٔ فرایند سیستم‌عامل برای فرایند JVM است\&. بدون هیچ گزینه‌ای، \f3jps\fR مقدار \f3lvmid\fR هر برنامهٔ جاوا را به همراه شکل کوتاه نام کلاس برنامه یا نام فایل JAR فهرست می‌کند\&. شکل کوتاه نام کلاس یا نام فایل JAR از اطلاعات بستهٔ (package) کلاس یا مسیر فایل‌های JAR صرف‌نظر می‌کند\&.
.PP
دستور \f3jps\fR از راه‌انداز جاوا برای پیدا کردن نام کلاس و آرگومان‌های ارسالی به متد main استفاده می‌کند\&. اگر JVM هدف با یک راه‌انداز سفارشی راه‌اندازی شده باشد، نام کلاس یا فایل JAR و آرگومان‌های متد \f3main\fR در دسترس نخواهند بود\&. در این حالت، دستور \f3jps\fR رشتهٔ \f3Unknown\fR را برای نام کلاس یا فایل JAR و همچنین برای آرگومان‌های ارسالی به متد \f3main\fR در خروجی چاپ می‌کند\&.
.PP
فهرست JVMهای ارائه‌شده توسط دستور \f3jps\fR می‌تواند توسط مجوزهای اعطاشده به کاربر یا هویت اجراکنندهٔ دستور محدود شود\&. این دستور تنها JVMهایی را فهرست می‌کند که هویت مذکور بر اساس سازوکارهای کنترل دسترسی سیستم‌عامل، حق دسترسی به آن‌ها را داشته باشد\&.
.SH "گزینه‌ها (OPTIONS)"
دستور \f3jps\fR از شماری گزینه پشتیبانی می‌کند که خروجی دستور را تغییر می‌دهند\&. این گزینه‌ها در آینده ممکن است تغییر کنند یا حذف شوند\&.
.TP
-q
.br
خروجی نام کلاس، نام فایل JAR و آرگومان‌های ارسالی به متد \f3main\fR را لغو کرده و تنها فهرستی از شناسه‌های محلی JVM تولید می‌کند\&.
.TP
-m
.br
آرگومان‌های ارسالی به متد \f3main\fR را نمایش می‌دهد\&. خروجی برای JVMهای تعبیه‌شده ممکن است \f3null\fR باشد\&.
.TP
-l
.br
نام کامل بسته (package) را برای کلاس \f3main\fR برنامه یا مسیر کامل فایل JAR برنامه نمایش می‌دهد\&.
.TP
-v
.br
آرگومان‌های ارسالی به JVM را نمایش می‌دهد\&.
.TP
-V
.br
خروجی نام کلاس، نام فایل JAR و آرگومان‌های ارسالی به متد main را لغو کرده و تنها فهرستی از شناسه‌های محلی JVM تولید می‌کند\&.
.TP
-J\f3option\fR
.br
گزینهٔ \f3option\fR را به JVM ارسال می‌کند، که در آن option یکی از گزینه‌های شرح‌داده‌شده در صفحهٔ مرجع راه‌انداز برنامهٔ جاوا است\&. برای نمونه، \f3-J-Xms48m\fR حافظهٔ راه‌اندازی را روی ۴۸ مگابایت تنظیم می‌کند\&. java(1) را ببینید\&.
.SH "شناسه میزبان (HOST IDENTIFIER)"
شناسهٔ میزبان یا \f3hostid\fR رشته‌ای است که سیستم هدف را مشخص می‌کند\&. ساختار نحوی رشتهٔ \f3hostid\fR با ساختار نحوی یک URI مطابقت دارد:
.sp     
.nf     
\f3[protocol:][[//]hostname][:port][/servername]\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.TP     
\fIprotocol\fR
پروتکل ارتباطی\&. اگر \f3protocol\fR حذف شود و \f3hostname\fR تعیین نشده باشد، پروتکل پیش‌فرض یک پروتکل محلی بهینه‌شده و مختص سکو خواهد بود\&. اگر پروتکل حذف شود و یک نام میزبان تعیین شده باشد، پروتکل پیش‌فرض \f3rmi\fR است\&.
.TP     
hostname
یک نام میزبان یا نشانی IP که میزبان هدف را مشخص می‌کند\&. اگر پارامتر \f3hostname\fR را حذف کنید، میزبان هدف همان میزبان محلی خواهد بود\&.
.TP     
port
پورت پیش‌فرض برای برقراری ارتباط با کارساز دوردست\&. اگر پارامتر \f3hostname\fR حذف شود یا پارامتر \f3protocol\fR یک پروتکل محلی بهینه‌شده را تعیین کند، پارامتر \f3port\fR نادیده گرفته می‌شود\&. در غیر این صورت، نحوهٔ رفتار با پارامتر \f3port\fR به پیاده‌سازی بستگی دارد\&. برای پروتکل پیش‌فرض \f3rmi\fR، پارامتر \f3port\fR شماره پورت rmiregistry را روی میزبان دوردست مشخص می‌کند\&. اگر پارامتر \f3port\fR حذف شود و پارامتر \f3protocol\fR بیانگر \f3rmi\fR باشد، پورت پیش‌فرض rmiregistry یعنی 1099 استفاده می‌شود\&.
.TP     
servername
رفتار با این پارامتر به پیاده‌سازی بستگی دارد\&. برای پروتکل محلی بهینه‌شده، این فیلد نادیده گرفته می‌شود\&. برای پروتکل \f3rmi\fR، این پارامتر رشته‌ای است که نام شیء دوردست RMI را روی میزبان دوردست مشخص می‌کند\&. برای اطلاعات بیشتر گزینهٔ \f3-n\fR در دستور \f3jstatd\fR را ببینید\&.
.SH "قالب خروجی (OUTPUT FORMAT)"
خروجی دستور \f3jps\fR از الگوی زیر پیروی می‌کند:
.sp     
.nf     
\f3lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ]\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
تمام توکن‌های خروجی با فاصله از هم جدا می‌شوند\&. مقدار \f3arg\fR که شامل فاصله‌های درونی باشد، هنگام تلاش برای نگاشت آرگومان‌ها به پارامترهای مکانی واقعی‌شان ابهام ایجاد می‌کند\&.
.PP
\fIنکته:\fR توصیه می‌شود برای تجزیهٔ خروجی \f3jps\fR اسکریپت ننویسید زیرا ممکن است این قالب در نسخه‌های آینده تغییر کند\&. اگر اسکریپت‌هایی می‌نویسید که خروجی \f3jps\fR را تجزیه می‌کنند، انتظار داشته باشید که برای نسخه‌های بعدی این ابزار آن‌ها را ویرایش کنید\&.
.SH "مثال‌ها (EXAMPLES)"
این بخش مثال‌هایی از دستور \f3jps\fR را ارائه می‌دهد\&.
.PP
فهرست کردن JVMهای ابزاربندی‌شده روی میزبان محلی:
.sp     
.nf     
\f3jps\fP
.fi     
.nf     
\f318027 Java2Demo\&.JAR\fP
.fi     
.nf     
\f318032 jps\fP
.fi     
.nf     
\f318005 jstat\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
مثال زیر JVMهای ابزاربندی‌شده روی یک میزبان دوردست را فهرست می‌کند\&. این مثال فرض می‌کند که کارساز \f3jstat\fR و یا ثبات داخلی RMI آن یا یک فرایند خارجی مجزای rmiregistry روی میزبان دوردست روی پورت پیش‌فرض (پورت 1099) در حال اجرا هستند\&. همچنین فرض می‌کند که میزبان محلی مجوزهای مناسب برای دسترسی به میزبان دوردست را داراست\&. این مثال همچنین شامل گزینهٔ \f3-l\fR برای ارائهٔ شکل کامل نام‌های کلاس یا فایل‌های JAR در خروجی است\&.
.sp     
.nf     
\f3jps \-l remote\&.domain\fP
.fi     
.nf     
\f33002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR\fP
.fi     
.nf     
\f32857 sun\&.tools\&.jstatd\&.jstatd\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
مثال زیر JVMهای ابزاربندی‌شده را روی یک میزبان دوردست با پورتی غیر از پیش‌فرض برای ثبات RMI فهرست می‌کند\&. این مثال فرض می‌کند که کارساز \f3jstatd\fR با یک ثبات داخلی RMI متصل به پورت 2002 روی میزبان دوردست در حال اجرا است\&. این مثال همچنین از گزینهٔ \f3-m\fR برای گنجاندن آرگومان‌های ارسالی به متد \f3main\fR هر یک از برنامه‌های جاوای فهرست‌شده استفاده می‌کند\&.
.sp     
.nf     
\f3jps \-m remote\&.domain:2002\fP
.fi     
.nf     
\f33002 /opt/jdk1\&.7\&.0/demo/jfc/Java2D/Java2Demo\&.JAR\fP
.fi     
.nf     
\f33102 sun\&.tools\&.jstatd\&.jstatd \-p 2002\fP
.fi     
.nf     
\f3\fP
.fi     
.sp     
.SH "همچنین ببینید (SEE ALSO)"
.TP 0.2i    
\(bu
java(1)
.TP 0.2i    
\(bu
jstat(1)
.TP 0.2i    
\(bu
jstatd(1)
.TP 0.2i    
\(bu
rmiregistry(1)
.RE
.br
'pl 8.5i
'bp