.\" Copyright (c) 1997, 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.19.2
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[R]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "RMIREGISTRY" "1" "2023" "JDK 21" "JDK Commands"
.hy
.SH "نام (NAME)"
.PP
rmiregistry \- ایجاد و راه‌اندازی سرویس ثبت اشیاء دوردست RMI جاوا (نسخه ۲۱)
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[V]rmiregistry\f[R] [\f[I]گزینه‌ها\f[R]] [\f[I]پورت\f[R]]
.TP
\f[I]گزینه‌ها\f[R]
گزینه‌های دستور \f[V]rmiregistry\f[R] را مشخص می‌کند.
بخش \f[B]گزینه‌ها\f[R] را ببینید.
.TP
\f[I]پورت\f[R]
شماره پورتی روی میزبان جاری که سرویس ثبت اشیاء دوردست روی آن راه‌اندازی می‌شود.
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[V]rmiregistry\f[R] یک سرویس ثبت اشیاء دوردست (remote object registry) را روی پورت مشخص‌شده در میزبان جاری ایجاد و راه‌اندازی می‌کند.
اگر پورت مشخص نشود، سرویس ثبت روی پورت ۱۰۹۹ راه‌اندازی می‌شود.
دستور \f[V]rmiregistry\f[R] هیچ خروجی تولید نمی‌کند و معمولاً در پس‌زمینه اجرا می‌شود؛ برای مثال:
.RS
.PP
\f[V]rmiregistry &\f[R]
.RE
.PP
سرویس ثبت اشیاء دوردست یک سرویس نام‌گذاری راه‌انداز (bootstrap naming service) است که توسط سرورهای RMI روی همان میزبان برای مقید کردن (bind) اشیاء دوردست به نام‌ها استفاده می‌شود.
سپس کلاینت‌ها روی میزبان‌های محلی و دوردست می‌توانند اشیاء دوردست را جستجو کرده و متدهای دوردست را فراخوانی کنند.
.PP
این سرویس ثبت معمولاً برای یافتن نخستین شیء دوردستی به کار می‌رود که برنامه نیاز به فراخوانی متدهای آن دارد.
آن شیء سپس پشتیبانی ویژه‌ی برنامه را برای یافتن دیگر اشیاء فراهم می‌سازد.
.PP
متدهای کلاس \f[V]java.rmi.registry.LocateRegistry\f[R] برای دسترسی به یک سرویس ثبت فعال روی میزبان محلی یا میزبان محلی و پورت مشخص به کار می‌روند.
.PP
متدهای مبتنی بر URL در کلاس \f[V]java.rmi.Naming\f[R] روی سرویس ثبت عمل می‌کنند و می‌توانند برای موارد زیر استفاده شوند:
.IP \[bu] 2
مقید کردن (Bind) نام مشخص‌شده به یک شیء دوردست
.IP \[bu] 2
بازگرداندن آرایه‌ای از نام‌های مقیدشده در سرویس ثبت
.IP \[bu] 2
بازگرداندن یک مرجع یا خردک (stub) برای شیء دوردست مرتبط با نام مشخص‌شده
.IP \[bu] 2
مقید کردن دوباره (Rebind) نام مشخص‌شده به یک شیء دوردست جدید
.IP \[bu] 2
حذف و باطل کردن اتصال (Destroy the binding) برای نام مشخص‌شده که با یک شیء دوردست مرتبط است
.SH "گزینه‌ها (OPTIONS)"
.TP
\f[V]\-J\f[R]\f[I]option\f[R]
به همراه هر گزینه جاوا برای ارسال \f[I]option\f[R] پس از \f[V]\-J\f[R] (بدون فاصله میان \f[V]\-J\f[R] و گزینه) به مفسر جاوا به کار می‌رود.