Sözdizimi
rpcinfo [version] [-m | -s] [host]
rpcinfo [version] -T netid host program [version]
rpcinfo [version] -a server address -T netid program [version]
rpcinfo [version] -b [-T netid] program version
rpcinfo [version] -d [-T netid] program version
rpcinfo -l [-T netid] [host] program version
rpcinfo [version]
[-T netid] [host] program version
rpcinfo
[-T netid] [host] program version
rpcinfo
[-T netid] [host] program version
rpcinfo [version]
[-T netid] [host]
rpcinfo {| -h}
rpcinfo -p [host]
rpcinfo [-n portnum] -u host program [version]
rpcinfo [-n portnum] -t host program [version]
Açıklama
rpcinfo, bir RPC sunucusuna RPC çağrısı yapar ve bulduklarını raporlar. Aksi belirtilmedikçe veya aşağıda not edilmedikçe, varsayılan rpcbind protokol sürümü 3'tür. Seçenek belirtilmediğinde veya yalnızca genel seçenekler sağlandığında, belirtilen ana bilgisayarda (host belirtilmemişse “localhost” üzerinde) rpcbind dump yordamını (procedure) çağırır ve sonuçları görüntüler. Sürüm 3 ve 4 için program numarasını, sürümü, “netid” bilgisini, hizmetlerin dinlediği evrensel adresi (universal address), biliniyorsa programın sembolik adını ve ardından ⟨program, sürüm, netid, adres⟩ demetini (tuple) kaydeden sahibi görüntüler. Protokolün 2. sürümü için programı, sürümü, protokolü, bağlantı noktasını (port) ve sembolik program adını listeler. Genellikle daha yararlı bir çıktı için aşağıdaki seçeneklere bakın. rpcbind, dump yordamı için varsayılan olarak netid değerini “tcp” olarak belirler.
program argümanı bir ad veya numara olabilir.
Sürüm belirtilirse, rpcinfo belirtilen programın o sürümünü çağırmaya çalışır. Aksi takdirde, sürüm isteğe bağlıysa rpcinfo, sürüm 0'ı çağırarak (bu sürümün var olmadığı varsayılır; eğer varsa, rpcinfo bunun yerine son derece yüksek bir sürüm numarasını çağırarak bu bilgiyi elde etmeye çalışır) belirtilen program için kayıtlı tüm sürüm numaralarını bulmaya ve kayıtlı her bir sürümü çağırmaya çalışır.
Sözdiziminin (synopsis) ikinci ve üçüncü satırları için ping atmak, yani belirtilen program ve sürümün null yordamını (null procedure) çağırmak amacıyla gerekli bir taşıma (transport) seçeneği gereklidir. Sonuçlar standart çıktıda (stdout) görüntülenecektir. Sürüm belirtilmemişse, yukarıda açıklandığı şekilde bulunan her geçerli sürüm çağrılacaktır. Üçüncü sözdizimi, yukarıdakine benzer şekilde belirtilen programın null yordamını çağırmak için netid tarafından belirtilen taşıma üzerinden sağlanan evrensel adresi kullanacaktır. Ayrıca sözdiziminin son iki satırı, aşağıdaki Eski Seçenekler bölümünde açıklandığı gibi sunucuya “ping” atabilir.
Genel Seçenekler
version Sağlanan rpcbind sürümünü kullanmaya çalışır. Aşağıdaki bazı seçeneklerin sürüme özel olduğunu ve bu seçeneğin yoksayılabileceğini unutmayın. Sürüm 2 (portmapper) belirtiliyorsa, aşağıdaki netid “udp” veya “tcp” değerlerinden biri olmalıdır.
-T netid Kullanılacak netid değerini belirtir. Desteklenen netid'ler “udp”, “tcp”, “udp6” ve “tcp6” şeklindedir. netid belirtilmezse, sistem netid'leri şu sırayla deneyecektir: “tcp”, “udp”, “tcp6” ve son olarak “udp6”.
seconds İstemci tanıtıcıları (client handles) oluşturulurken ve rpcbind'e yapılan istemci çağrılarında kullanılan zaman aşımı süresi. Mevcut varsayılan değer 12 saniyedir.
Genel seçenekler, aşağıdaki rpcinfo seçeneklerinden herhangi biriyle birlikte sağlanabilir, ancak bazı seçenekler bunların değerlerini geçersiz kılacaktır.
Eski Seçenekler
Aşağıdaki seçenekler sürüm 2 (portmapper) rpcbind çağrılarını ifade eder. rpcinfo'nun eski sürümleriyle uyumludurlar.
{-p |} [-T netid] [host] Belirtilen ana bilgisayardaki (host) portmapper'ı sorgular ve kayıtlı tüm RPC programlarının bir listesini yazdırır. host belirtilmemişse varsayılan olarak “localhost” değerini alır.
{-u |} host program [version] UDP kullanarak belirtilen ana bilgisayardaki programın NULL yordamına bir RPC çağrısı yapar ve bir yanıt alınıp alınmadığını bildirir.
{-t |} host program [version] TCP kullanarak belirtilen ana bilgisayardaki programın NULL yordamına bir RPC çağrısı yapar ve bir yanıt alınıp alınmadığını bildirir.
{-n |} portnum portmapper tarafından verilen port numarası yerine, -t ve -u seçenekleri için port numarası olarak portnum değerini kullanır.
Seçenekler
{-b |} program version RPCB_MULTICAST_ADDR adresi olan “FF02::202” adresine INET6 üzerinden bir RPC çoklu gönderimi (multicast) yapar ve belirtilen program ile sürümün 0 numaralı yordamına UDP kullanarak INET üzerinden yayın (broadcast) yapar ve yanıt veren tüm ana bilgisayarları bildirir. rpcinfo, eski ana bilgisayarları toplamak için önce RPCBIND sürüm 3'ü kullanacak ve ardından portmapper protokolünün yayın (broadcast) yordamını çağıracaktır. Yanıtların önbelleği tutulduğundan, önbellek dolmadığı sürece yinelenen yanıtlar döndürülmeyecektir.
-b seçeneğinin tek başına eski portmapper ile uyumlu olduğunu unutmayın. Ancak 2 değerinin belirtilmesi rpcbind sürüm 3 çağrılarını kısa devre yapacak ve yalnızca portmapper'ı çağıracaktır.
{-d |} [-T netid] program version Belirtilen program ve sürümün RPC hizmeti için kaydını siler. netid belirtilirse, program ve sürümün kaydını yalnızca o taşıma (transport) protokolü üzerinden siler. Bu seçenek yalnızca süper kullanıcı veya RPC hizmetini kaydeden kullanıcı tarafından uygulanabilir.
[-T netid] [host] program version İstemcinin, netid üzerinden belirtilen host üzerindeki program ve sürümle iletişim kurmak için kullanabileceği evrensel adresi alır. host belirtilmemişse localhost varsayılır. netid belirtilmemişse “udp” varsayılır. Belirtilen sürüm mevcut değil ancak başka bir sürüm mevcutsa, programın o sürümlerinden birine ait evrensel adresi döndürür.
[-T netid] [host] program version İstemcinin, netid üzerinden belirtilen host üzerindeki program ve sürümle iletişim kurmak için kullanabileceği evrensel adresi alır. host belirtilmemişse localhost varsayılır. netid belirtilmemişse “udp” varsayılır. Sürüm mevcut değilse bu durum belirtilir. Bu işlem, uzak sunucunun rpcbind sürüm 4'ü desteklemesini gerektirir.
-h: Bu programın sözdizimini yazdırır.
Sözdizimini ve seçeneklerin açıklamasını yazdırır.
[-T netid] [host] program version Belirtilen ana bilgisayardaki veya localhost'taki programın ve sürümün null yordamına dolaylı bir çağrı (indirect call) gönderir. Bu işlem, uzak rpcbind'in sürüm 4'ü desteklemesini gerektirir.
{-l |} [-T netid] [host] program version Belirtilen isteğe bağlı ana bilgisayarda (belirtilmemişse localhost) verilen program ve sürüm için netid ile belirtilen taşıma ailesi üzerinden kullanılabilir taşımaları listeler. Uzak rpcbind'in sürüm 4'ü desteklemesini gerektirir. Varsayılan taşıma ailesi INET'tir.
{-m |} Belirtilen ana bilgisayar (belirtilmemişse localhost) için rpcbind arka plan işleminin metriklerini yazdırır. Uzak uçta rpcbind sürüm 4 desteği gerektirir.
{-s |} Belirtilen ana bilgisayarda (belirtilmemişse “localhost”) kayıtlı programların bir özetini yazdırır. Kayıtlı her bir program için sürümleri ve ardından o program tarafından desteklenen taşımaları listeler. Taşımanın sembolik adını ve programı kaydeden sahibini listelemeye çalışır.
[host] Belirtilen ana bilgisayardaki rpcbind'in zaman bilgisini döndürür.
Örnekler
Yerel makinede kayıtlı tüm RPC hizmetlerini göstermek için şunu kullanın:
example% rpcinfo
klaxon adlı makinede kayıtlı tüm RPC hizmetlerini göstermek için şunu kullanın:
example% rpcinfo klaxon
Daha kullanışlı bir şekilde, klaxon üzerinde kayıtlı hizmetleri göstermek için şunu kullanın:
example% rpcinfo -s klaxon
horn adlı bir ana bilgisayarda yalnızca rpcbind'in 2. sürümünü çalıştıran daha eski bir ana bilgisayardaki tüm RPC hizmetlerini göstermek için şunu kullanın:
example% rpcinfo -p horn
Yerel ağda NFS Dosya hizmetini (NFS File service) çalıştıran tüm makineleri göstermek için şunu kullanın:
example% rpcinfo -b nfs 'version'
burada 'version' ilgilendiğiniz mevcut nfs sürümlerinden biridir.
rquotad hizmetinin 1. sürümüne ait kaydı silmek için şunu kullanın:
example% rpcinfo -d rquotad 1
Ayrıca Bakınız
rpc(5), rpcbind(8)
RPC Programming Guide.
RFC 1833 Binding Protocols for ONC RPC Version 2.
RFC 5665 IANA Considerations for Remote Procedure Call (RPC) Network Identifiers and Universal Address Formats.
Hatalar
Özet modunda maksimum sürüm ve taşıma sayısı 16'dır. Sunucudan alınan ilk 16 sürüm ve ilk 16 taşıma görüntülenir ve geri kalanı sessizce yoksayılır.
İkinci sözdizimi satırında, bağlantı-yerel (link-local) bir INET6 adresi olarak belirtilen bir ana bilgisayar için her zaman “no route to host” (ana bilgisayara rota yok) hatası dönecektir.
SunOS 3.0 öncesindeki sürümlerde, Network File System (NFS) kendisini portmapper'a kaydetmiyordu; bu tür sürümleri çalıştıran ana bilgisayarlardaki NFS sunucusuna RPC çağrıları yapmak için rpcinfo kullanılamaz.
macOS 26.4 14 Kasım 2012 macOS 26.4