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