.\" Copyright (c) 2004, 2018, 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.
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JPS" "1" "2021" "JDK 17" "JDK Commands"
.hy
.SH "نام (NAME)"
.PP
jps \- فهرست کردن JVMهای ابزاردقیق‌شده روی سیستم مقصد
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]نکته:\f[R] این دستور آزمایشی است و پشتیبانی نمی‌شود.
.PP
\f[CB]jps\f[R] [\f[CB]\-q\f[R]] [\f[CB]\-mlvV\f[R]] [\f[I]hostid\f[R]]
.PP
\f[CB]jps\f[R] [\f[CB]\-help\f[R]]
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \f[CB]\-q\f[R]
از نمایش خروجی نام کلاس، نام فایل JAR و آرگومان‌های ارسالی به متد \f[CB]main\f[R] جلوگیری می‌کند و تنها فهرستی از شناسه‌های محلی JVM تولید می‌نماید.
.RS
.RE
.TP
.B \f[CB]\-mlvV\f[R]
می‌توانید هر ترکیبی از این گزینه‌ها را مشخص کنید.
.RS
.IP \[bu] 2
\f[CB]\-m\f[R] آرگومان‌های ارسالی به متد \f[CB]main\f[R] را نمایش می‌دهد. این خروجی برای JVMهای تعبیه‌شده (embedded) ممکن است \f[CB]null\f[R] باشد.
.IP \[bu] 2
\f[CB]\-l\f[R] نام کامل بسته (package) را برای کلاس \f[CB]main\f[R] برنامه یا مسیر کامل فایل JAR برنامه نمایش می‌دهد.
.IP \[bu] 2
\f[CB]\-v\f[R] آرگومان‌های ارسالی به JVM را نمایش می‌دهد.
.IP \[bu] 2
\f[CB]\-V\f[R] از نمایش خروجی نام کلاس، نام فایل JAR و آرگومان‌های ارسالی به متد \f[CB]main\f[R] جلوگیری می‌کند و تنها فهرستی از شناسه‌های محلی JVM تولید می‌نماید.
.RE
.TP
.B \f[I]hostid\f[R]
شناسهٔ میزبانی که گزارش فرایند باید برای آن تولید شود.
مقدار \f[CB]hostid\f[R] می‌تواند شامل بخش‌های اختیاری باشد که پروتکل ارتباطی، شماره پورت و سایر داده‌های مختص پیاده‌سازی را مشخص می‌کنند.
بخش \f[B]شناسه میزبان (HOST IDENTIFIER)\f[R] را ببینید.
.RS
.RE
.TP
.B \f[CB]\-help\f[R]
پیام راهنمای دستور \f[CB]jps\f[R] را نمایش می‌دهد.
.RS
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[CB]jps\f[R] ماشین‌های مجازی Java HotSpot ابزاردقیق‌شده روی سیستم مقصد را فهرست می‌کند.
این دستور تنها به گزارش اطلاعات JVMهایی محدود می‌شود که مجوزهای دسترسی به آن‌ها را داشته باشد.
.PP
اگر دستور \f[CB]jps\f[R] بدون تعیین یک \f[CB]hostid\f[R] اجرا شود، به جستجوی JVMهای ابزاردقیق‌شده روی میزبان محلی می‌پردازد.
اگر با یک \f[CB]hostid\f[R] آغاز شود، با استفاده از پروتکل و پورت مشخص‌شده، در میزبان مورد نظر به جستجوی JVMها می‌پردازد.
فرض بر این است که فرایند \f[CB]jstatd\f[R] روی میزبان مقصد در حال اجرا باشد.
.PP
دستور \f[CB]jps\f[R] شناسهٔ محلی JVM یا \f[CB]lvmid\f[R] را برای هر JVM ابزاردقیق‌شدهٔ یافت‌شده روی سیستم مقصد گزارش می‌دهد.
مقدار \f[CB]lvmid\f[R] معمولاً (اما نه لزوماً) شناسهٔ فرایند سیستم‌عامل برای فرایند JVM است.
بدون هیچ گزینه‌ای، دستور \f[CB]jps\f[R] شناسهٔ \f[CB]lvmid\f[R] هر برنامهٔ جاوا را به همراه شکل کوتاه نام کلاس یا نام فایل jar برنامه فهرست می‌کند.
شکل کوتاه نام کلاس یا نام فایل JAR، اطلاعات بستهٔ کلاس یا اطلاعات مسیر فایل JAR را نادیده می‌گیرد.
.PP
دستور \f[CB]jps\f[R] از راه‌انداز جاوا برای یافتن نام کلاس و آرگومان‌های ارسالی به متد main استفاده می‌کند.
اگر JVM مقصد با یک راه‌انداز سفارشی راه‌اندازی شده باشد، نام کلاس یا فایل JAR و همچنین آرگومان‌های ارسال‌شده به متد \f[CB]main\f[R] در دسترس نخواهند بود.
در این وضعیت، دستور \f[CB]jps\f[R] برای نام کلاس یا نام فایل JAR و همچنین برای آرگومان‌های ارسال‌شده به متد \f[CB]main\f[R] رشتهٔ \f[CB]Unknown\f[R] را چاپ می‌کند.
.PP
فهرست JVMهای ارائه‌شده توسط دستور \f[CB]jps\f[R] می‌تواند توسط مجوزهای اعطاشده به کاربر یا هویتی که دستور را اجرا می‌کند محدود شود.
این دستور تنها JVMهایی را فهرست می‌کند که کاربر اجراکننده بر اساس سازوکارهای کنترل دسترسی سیستم‌عامل، حق دسترسی به آن‌ها را داشته باشد.
.SH "شناسه میزبان (HOST IDENTIFIER)"
.PP
شناسهٔ میزبان یا \f[CB]hostid\f[R] رشته‌ای است که سیستم مقصد را مشخص می‌کند.
نحو رشتهٔ \f[CB]hostid\f[R] متناظر با نحو یک URI است:
.RS
.PP
[\f[I]protocol\f[R]\f[CB]:\f[R]][[\f[CB]//\f[R]]\f[I]hostname\f[R]][\f[CB]:\f[R]\f[I]port\f[R]][\f[CB]/\f[R]\f[I]servername\f[R]]
.RE
.TP
.B \f[I]protocol\f[R]
پروتکل ارتباطی.
اگر \f[I]protocol\f[R] حذف شود و هیچ \f[I]hostname\f[R] مشخص نشده باشد، پروتکل پیش‌فرض یک پروتکل محلی بهینه‌شده و مختص به پلتفرم است.
اگر پروتکل حذف شود و یک نام میزبان مشخص شده باشد، پروتکل پیش‌فرض \f[CB]rmi\f[R] خواهد بود.
.RS
.RE
.TP
.B \f[I]hostname\f[R]
یک نام میزبان یا آدرس IP که میزبان مقصد را مشخص می‌کند.
اگر پارامتر \f[I]hostname\f[R] را حذف کنید، میزبان مقصد همان میزبان محلی خواهد بود.
.RS
.RE
.TP
.B \f[I]port\f[R]
پورت پیش‌فرض برای برقراری ارتباط با سرور دوردست.
اگر پارامتر \f[I]hostname\f[R] حذف شود یا پارامتر \f[I]protocol\f[R] یک پروتکل محلی بهینه‌شده را مشخص کند، پارامتر \f[I]port\f[R] نادیده گرفته می‌شود.
در غیر این صورت، نحوهٔ برخورد با پارامتر \f[I]port\f[R] وابسته به پیاده‌سازی خواهد بود.
برای پروتکل پیش‌فرض \f[CB]rmi\f[R]، پارامتر \f[I]port\f[R] شماره پورت برای \f[CB]rmiregistry\f[R] روی میزبان دوردست را نشان می‌دهد.
اگر پارامتر \f[I]port\f[R] حذف شود و پارامتر \f[I]protocol\f[R] نشان‌دهندهٔ \f[CB]rmi\f[R] باشد، پورت پیش‌فرض \f[CB]rmiregistry\f[R] (\f[CB]1099\f[R]) استفاده می‌شود.
.RS
.RE
.TP
.B \f[I]servername\f[R]
نحوهٔ برخورد با این پارامتر بستگی به پیاده‌سازی دارد.
برای پروتکل محلی بهینه‌شده، این فیلد نادیده گرفته می‌شود.
برای پروتکل \f[CB]rmi\f[R]، این پارامتر رشته‌ای است که نام شیء دوردست RMI را در میزبان دوردست مشخص می‌کند.
گزینهٔ \f[CB]\-n\f[R] دستور \f[B]jstatd\f[R] را ببینید.
.RS
.RE
.SH "قالب خروجی دستور JPS (OUTPUT FORMAT OF THE JPS COMMAND)"
.PP
خروجی دستور \f[CB]jps\f[R] دارای الگوی زیر است:
.RS
.PP
\f[I]lvmid\f[R] [ [ \f[I]classname\f[R] | \f[I]JARfilename\f[R] |
\f[CB]"Unknown"\f[R]] [ \f[I]arg\f[R]* ] [ \f[I]jvmarg\f[R]* ] ]
.RE
.PP
همهٔ نشانه‌های خروجی با فاصله از یکدیگر جدا می‌شوند.
مقدار \f[CB]arg\f[R] که شامل فاصله درونی باشد، هنگام تلاش برای نگاشت آرگومان‌ها به پارامترهای مکانی واقعی‌شان باعث ابهام می‌شود.
.PP
\f[B]نکته:\f[R]
.PP
توصیه می‌شود اسکریپت‌هایی برای تجزیهٔ خروجی \f[CB]jps\f[R] ننویسید زیرا ممکن است این قالب در نسخه‌های آینده تغییر کند.
اگر اسکریپت‌هایی بنویسید که خروجی \f[CB]jps\f[R] را تجزیه کنند، باید انتظار داشته باشید که برای نسخه‌های بعدی این ابزار آن‌ها را تغییر دهید.
.SH "مثال‌ها (EXAMPLES)"
.PP
این بخش مثال‌هایی از دستور \f[CB]jps\f[R] ارائه می‌دهد.
.PP
فهرست کردن JVMهای ابزاردقیق‌شده روی میزبان محلی:
.IP
.nf
\f[CB]
jps
18027\ Java2Demo.JAR
18032\ jps
18005\ jstat
\f[R]
.fi
.PP
مثال زیر JVMهای ابزاردقیق‌شده روی یک میزبان دوردست را فهرست می‌کند.
این مثال فرض می‌کند که کارگزار \f[CB]jstat\f[R] و همچنین رجیستری RMI داخلی آن یا یک فرایند \f[CB]rmiregistry\f[R] خارجی و مجزا روی میزبان دوردست و روی پورت پیش‌فرض (پورت \f[CB]1099\f[R]) در حال اجرا هستند.
همچنین فرض می‌کند که میزبان محلی دارای مجوزهای لازم برای دسترسی به میزبان دوردست است.
این مثال شامل گزینهٔ \f[CB]\-l\f[R] برای نمایش شکل بلند نام کلاس‌ها یا نام فایل‌های JAR است.
.IP
.nf
\f[CB]
jps\ \-l\ remote.domain
3002\ /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
2857\ sun.tools.jstatd.jstatd
\f[R]
.fi
.PP
مثال زیر JVMهای ابزاردقیق‌شده روی یک میزبان دوردست با پورتی غیرپیش‌فرض برای رجیستری RMI را فهرست می‌کند.
این مثال فرض می‌کند که کارگزار \f[CB]jstatd\f[R] همراه با یک رجیستری داخلی RMI متصل به پورت \f[CB]2002\f[R] روی میزبان دوردست در حال اجرا است.
این مثال همچنین از گزینهٔ \f[CB]\-m\f[R] برای گنجاندن آرگومان‌های ارسال‌شده به متد \f[CB]main\f[R] هر یک از برنامه‌های جاوای فهرست‌شده استفاده می‌کند.
.IP
.nf
\f[CB]
jps\ \-m\ remote.domain:2002
3002\ /opt/jdk1.7.0/demo/jfc/Java2D/Java2Demo.JAR
3102\ sun.tools.jstatd.jstatd\ \-p\ 2002
\f[R]
.fi