.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "JPS" "1" "2026" "JDK 26.0.2.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های تعبیه‌شده
\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 پایش‌شده (instrumented) را روی سیستم مقصد نمایش می‌دهد.
این دستور تنها اطلاعات 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]
معمولاً (اما نه لزوماً) همان شناسه پردازه (PID) سیستم‌عامل برای پردازه 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]
رشته‌ای است که سیستم مقصد را مشخص می‌کند.
قالب نحوی رشته
\f[CR]hostid\f[R]
مطابق با ساختار یک URI است:
.RS
.PP
.nf
[\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]]
.fi
.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
.nf
\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]* ] ]
.fi
.RE
.PP
تمام نشانه‌های خروجی با فاصله (white space) از هم جدا می‌شوند.
یک مقدار
\f[CR]arg\f[R]
که شامل فاصله‌های داخلی باشد، هنگام نگاشت آرگومان‌ها به پارامترهای مکانی واقعی آن‌ها ابهام ایجاد می‌کند.
.PP
\f[B]نکته:\f[R]
.PP
توصیه می‌شود اسکریپت‌هایی برای تجزیه (parse) خروجی
\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