'\" 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 \- فهرست کردن ماشین‌های مجازی جاوای (JVM) ابزاربندی‌شده روی سیستم مقصد\&. این دستور آزمایشی است و پشتیبانی نمی‌شود\&.
.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 از راه‌انداز جاوا برای یافتن نام کلاس و آرگومان‌های فرستاده‌شده به متد \f3main\fR استفاده می‌کند\&. اگر 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های تعبیه‌شده (embedded) برابر با \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 رشته‌ای است که سیستم مقصد را مشخص می‌کند\&. نحو (syntax) رشتهٔ \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 (۱۰۹۹) استفاده می‌شود\&.
.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 توصیه می‌شود که برای پردازش و تفکیک (parse) خروجی \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، روی میزبان دوردست و روی درگاه پیش‌فرض (درگاه ۱۰۹۹) در حال اجرا هستند\&. همچنین فرض شده است که میزبان محلی مجوزهای لازم برای دسترسی به میزبان دوردست را دارد\&. این مثال همچنین گزینهٔ \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 متصل‌شده به درگاه ۲۰۰۲، روی میزبان دوردست در حال اجرا است\&. این مثال همچنین از گزینهٔ \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