.\" @(#)rpcinfo.1m 1.23 93/03/29 SMI; from SVr4
.\" Copyright 1989 AT&T
.\" Copyright 1991 Sun Microsystems, Inc.
.\" $NetBSD: rpcinfo.8,v 1.11 2001/12/08 19:12:46 wiz Exp $
.Dd August 18, 1992
.Dt RPCINFO 8
.Os
.Sh "نام (NAME)"
.Nm rpcinfo
.Nd گزارش اطلاعات RPC
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm "rpcinfo"
.Op Fl m Li \&| Fl s
.Op Ar host
.Nm "rpcinfo"
.Fl p Op Ar host
.Nm "rpcinfo"
.Fl T Ar transport
.Ar host Ar prognum
.Op Ar versnum
.Nm "rpcinfo"
.Fl l
.Op Fl T Ar transport
.Ar host Ar prognum Ar versnum
.Nm "rpcinfo"
.Op Fl n Ar portnum
.Fl u
.Ar host Ar prognum
.Op Ar versnum
.Nm "rpcinfo"
.Op Fl n Ar portnum
.Op Fl t
.Ar host Ar prognum
.Op Ar versnum
.Nm "rpcinfo"
.Fl a Ar serv_address
.Fl T Ar transport
.Ar prognum
.Op Ar versnum
.Nm "rpcinfo"
.Fl b
.Op Fl T Ar transport
.Ar prognum Ar versnum
.Nm "rpcinfo"
.Fl d
.Op Fl T Ar transport
.Ar prognum Ar versnum
.Sh "توضیحات (DESCRIPTION)"
.Nm
یک فراخوانی RPC به یک سرور RPC برقرار کرده و آنچه را که می‌یابد گزارش می‌کند.
.Pp
در خلاصه دستور نخست،
.Nm
تمامی سرویس‌های RPC ثبت‌شده در
.Nm rpcbind
روی
.Ar host
را فهرست می‌کند.
اگر
.Ar host
مشخص نشده باشد، میزبان محلی پیش‌فرض است.
اگر از گزینهٔ
.Fl s
استفاده شود، اطلاعات در قالبی فشرده و خلاصه نمایش داده می‌شوند.
.Pp
در خلاصه دستور دوم،
.Nm
تمامی سرویس‌های RPC ثبت‌شده در نسخهٔ ۲
.Nm rpcbind
را فهرست می‌کند.
همچنین توجه داشته باشید که قالب نمایش اطلاعات در خلاصه دستور اول و دوم متفاوت است.
دلیل آن این است که خلاصه دستور دوم از پروتکل قدیمی‌تری (نسخهٔ ۲ پروتکل
.Nm rpcbind
) برای جمع‌آوری اطلاعات نمایش داده‌شده استفاده می‌کند.
.Pp
خلاصه دستور سوم یک فراخوانی RPC به رویهٔ ۰ از
.Ar prognum
و
.Ar versnum
روی
.Ar host
مشخص‌شده برقرار می‌کند و گزارش می‌دهد که آیا پاسخی دریافت شده است یا خیر.
.Ar transport
پروتکل انتقالی است که باید برای برقراری ارتباط با سرویس داده‌شده استفاده شود.
نشانی راه دور سرویس از طریق برقراری فراخوانی به
.Nm rpcbind
راه دور به دست می‌آید.
.Pp
آرگومان
.Ar prognum
عددی است که نمایانگر یک شماره برنامهٔ RPC است.
اگر
.Ar versnum
مشخص شده باشد،
.Nm
تلاش می‌کند همان نسخه از
.Ar prognum
مشخص‌شده را فراخوانی کند.
در غیر این صورت،
.Nm
تلاش می‌کند با فراخوانی نسخهٔ ۰ که فرض می‌شود وجود ندارد، تمامی شماره نسخه‌های ثبت‌شده برای
.Ar prognum
مشخص‌شده را بیابد؛
اگر نسخهٔ ۰ وجود داشته باشد،
.Nm
در عوض تلاش می‌کند با فراخوانی یک شماره نسخهٔ بسیار بزرگ، این اطلاعات را به دست آورد و برای فراخوانی هر نسخهٔ ثبت‌شده تلاش می‌کند.
نکته: شماره نسخه برای گزینه‌های
.Fl b
و
.Fl d
الزامی است.
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width indent
.It Fl T Ar transport
پروتکل انتقالی را که سرویس روی آن موردنیاز است مشخص می‌کند.
اگر این گزینه مشخص نشود،
.Nm
از پروتکل انتقال مشخص‌شده در متغیر محیطی
.Ev NETPATH
استفاده می‌کند؛ و اگر آن متغیر مقداردهی نشده یا خالی باشد، از انتقال موجود در پایگاه‌دادهٔ
.Xr netconfig 5
استفاده می‌شود.
این یک گزینهٔ عمومی است و می‌تواند در ترکیب با سایر گزینه‌ها مطابق آنچه در خلاصه دستور آمده به کار رود.
.It Fl a Ar serv_address
از
.Ar serv_address
به‌عنوان نشانی (سراسری) برای سرویس روی
.Ar transport
جهت ارسال پینگ (ping) به رویهٔ ۰ از
.Ar prognum
مشخص‌شده استفاده کرده و گزارش می‌دهد که آیا پاسخی دریافت شد یا خیر.
گزینهٔ
.Fl T
همراه با گزینهٔ
.Fl a
الزامی است.
.Pp
اگر
.Ar versnum
مشخص نشده باشد،
.Nm
تلاش می‌کند به تمامی شماره نسخه‌های موجود برای آن شماره برنامه پینگ بفرستد.
این گزینه از برقراری فراخوانی‌ها به
.Nm rpcbind
راه دور برای یافتن نشانی سرویس اجتناب می‌کند.
.Ar serv_address
در قالب نشانی سراسری پروتکل انتقال داده‌شده مشخص می‌شود.
.It Fl b
یک انتشار همگانی (broadcast) از طریق RPC به رویهٔ ۰ از
.Ar prognum
و
.Ar versnum
مشخص‌شده ارسال کرده و تمامی میزبان‌هایی را که پاسخ می‌دهند گزارش می‌کند.
اگر
.Ar transport
مشخص شده باشد، درخواست همگانی خود را تنها روی همان انتقال مشخص‌شده ارسال می‌کند.
اگر انتشار همگانی توسط هیچ پروتکل انتقالی پشتیبانی نشود، یک پیام خطا چاپ می‌شود.
استفاده از ارسال همگانی به دلیل احتمال تأثیر منفی بر سایر سیستم‌ها باید محدود شود.
.It Fl d
ثبت سرویس RPC مربوط به
.Ar prognum
و
.Ar versnum
مشخص‌شده را لغو می‌کند.
اگر
.Ar transport
مشخص شده باشد، ثبت سرویس را تنها روی همان انتقال لغو می‌کند؛ در غیر این صورت، ثبت سرویس را روی تمامی انتقال‌هایی که روی آن‌ها ثبت شده بود لغو می‌نماید.
تنها مالک یک سرویس می‌تواند ثبت آن را لغو کند، به جز کاربر ارشد (superuser) که می‌تواند هر سرویسی را حذف نماید.
.It Fl l
فهرستی از ورودی‌ها با
.Ar prognum
و
.Ar versnum
داده‌شده را روی
.Ar host
مشخص‌شده نمایش می‌دهد.
ورودی‌ها برای تمام پروتکل‌های انتقال موجود در همان خانوادهٔ پروتکلی که برای ارتباط با
.Nm rpcbind
راه دور استفاده شده است، بازگردانده می‌شوند.
.It Fl m
جدولی از آمارهای عملیات
.Nm rpcbind
را روی
.Ar host
داده‌شده نمایش می‌دهد.
این جدول آمارهای هر نسخه از
.Nm rpcbind
(نسخه‌های ۲، ۳ و ۴) را نشان می‌دهد و تعداد دفعاتی را که هر رویه درخواست شده و با موفقیت پاسخ داده شده است، تعداد و نوع درخواست‌های فراخوانی راه دور ارسال‌شده، و اطلاعات مربوط به جستجوهای نشانی RPC انجام‌شده را ارائه می‌دهد.
این قابلیت برای نظارت بر فعالیت‌های RPC روی
.Ar host
کاربرد دارد.
.It Fl n Ar portnum
از
.Ar portnum
به‌عنوان شماره پورت برای گزینه‌های
.Fl t
و
.Fl u
به‌جای شماره پورت ارائه‌شده توسط
.Nm rpcbind
استفاده می‌کند.
استفاده از این گزینه مانع از فراخوانی به
.Nm rpcbind
راه دور برای یافتن نشانی سرویس می‌شود.
این گزینه با وجود گزینهٔ
.Fl a
منسوخ شده است.
.It Fl p
سرویس
.Nm rpcbind
را روی
.Ar host
با استفاده از نسخهٔ ۲ پروتکل
.Nm rpcbind
کاوش کرده و فهرستی از تمامی برنامه‌های RPC ثبت‌شده را نمایش می‌دهد.
اگر
.Ar host
مشخص نشده باشد، پیش‌فرض میزبان محلی است.
نکته: نسخهٔ ۲ پروتکل
.Nm rpcbind
پیش‌تر با نام پروتکل portmapper شناخته می‌شد.
.It Fl s
فهرست خلاصه‌ای از تمام برنامه‌های RPC ثبت‌شده روی
.Ar host
را نمایش می‌دهد.
اگر
.Ar host
مشخص نشده باشد، پیش‌فرض میزبان محلی است.
.It Fl t
یک فراخوانی RPC به رویهٔ ۰ از
.Ar prognum
روی
.Ar host
مشخص‌شده با استفاده از TCP برقرار کرده و گزارش می‌دهد که آیا پاسخی دریافت شده است یا خیر.
این گزینه مطابق آنچه در خلاصه دستور سوم آمده، با گزینهٔ
.Fl T
منسوخ و جایگزین شده است.
.It Fl u
یک فراخوانی RPC به رویهٔ ۰ از
.Ar prognum
روی
.Ar host
مشخص‌شده با استفاده از UDP برقرار کرده و گزارش می‌دهد که آیا پاسخی دریافت شده است یا خیر.
این گزینه مطابق آنچه در خلاصه دستور سوم آمده، با گزینهٔ
.Fl T
منسوخ و جایگزین شده است.
.El
.Sh "مثال‌ها (EXAMPLES)"
برای نمایش تمام سرویس‌های RPC ثبت‌شده روی ماشین محلی:
.Bd -literal
	example% rpcinfo
.Ed
.Pp
برای نمایش تمام سرویس‌های RPC ثبت‌شده در
.Nm rpcbind
روی ماشینی به نام
.Nm klaxon :
.Bd -literal
	example% rpcinfo klaxon
.Ed
.Pp
اطلاعات نمایش‌داده‌شده توسط دستورهای فوق ممکن است بسیار طولانی باشد.
از گزینهٔ
.Fl s
برای نمایش یک فهرست خلاصه‌تر استفاده کنید:
.Bd -literal
	example$ rpcinfo -s klaxon
.Ed
.Bl -column "program" "w,x,y,z" "local,tcp,udp,tcp6,udp6" "nlockmgr" "super-user"
.It program Ta version(s) Ta netid(s) Ta service Ta owner
.It 100000 Ta 2,3,4 Ta local,tcp,udp,tcp6,udp6 Ta rpcbind Ta super-user
.It 100008 Ta 1 Ta udp,tcp,udp6,tcp6 Ta walld Ta super-user
.It 100002 Ta 2,1 Ta udp,udp6 Ta rusersd Ta super-user
.It 100001 Ta 2,3,4 Ta udp,udp6 Ta rstatd Ta super-user
.It 100012 Ta 1 Ta udp,tcp Ta sprayd Ta super-user
.It 100007 Ta 3 Ta udp,tcp Ta ypbind Ta super-user
.El
.Pp
برای نمایش اینکه آیا سرویس RPC با شماره برنامهٔ
.Ar prognum
و نسخهٔ
.Ar versnum
روی ماشینی به نام
.Nm klaxon
برای پروتکل انتقال TCP ثبت شده است یا خیر:
.Bd -literal
	example% rpcinfo -T tcp klaxon prognum versnum
.Ed
.Pp
برای نمایش تمامی سرویس‌های RPC ثبت‌شده با نسخهٔ ۲ پروتکل
.Nm rpcbind
روی ماشین محلی:
.Bd -literal
	example% rpcinfo -p
.Ed
.Pp
جهت لغو ثبت نسخهٔ ۱ از سرویس
.Nm walld
(شماره برنامهٔ 100008)
برای تمامی پروتکل‌های انتقال:
.Bd -literal
	example# rpcinfo -d 100008 1
.Ed
.Pp
یا
.Bd -literal
	example# rpcinfo -d walld 1
.Ed
.Sh "همچنین ببینید (SEE ALSO)"
.Xr rpc 3 ,
.Xr netconfig 5 ,
.Xr rpc 5 ,
.Xr rpcbind 8