.\" 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.3.1
.\"
.TH "RMIREGISTRY" "1" "2021" "JDK 17" "JDK Commands"
.hy
.SH "نام (NAME)"
.PP
rmiregistry \- ایجاد و راه‌اندازی یک رجیستری شیء راه دور روی درگاه مشخص‌شده در میزبان جاری
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[CB]rmiregistry\f[R] [\f[I]options\f[R]] [\f[I]port\f[R]]
.TP
.B \f[I]options\f[R]
نشان‌دهنده گزینه‌های دستور \f[CB]rmiregistry\f[R] است.
بخش \f[B]گزینه‌ها\f[R] را ببینید.
.RS
.RE
.TP
.B \f[I]port\f[R]
شماره درگاهی روی میزبان جاری که رجیستری شیء راه دور باید روی آن راه‌اندازی شود.
.RS
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[CB]rmiregistry\f[R] یک رجیستری شیء راه دور را روی درگاه مشخص‌شده در میزبان جاری ایجاد و راه‌اندازی می‌کند.
اگر درگاه مشخص نشود، رجیستری روی درگاه 1099 راه‌اندازی می‌شود.
دستور \f[CB]rmiregistry\f[R] هیچ خروجی‌ای تولید نمی‌کند و معمولاً در پس‌زمینه اجرا می‌شود؛ برای نمونه:
.RS
.PP
\f[CB]rmiregistry\ &\f[R]
.RE
.PP
یک رجیستری شیء راه دور، یک سرویس نام‌گذاری راه‌انداز (bootstrap) است که توسط کارگزارهای RMI روی همان میزبان برای پیوند دادن اشیاء راه دور به نام‌ها استفاده می‌شود.
سپس کلاینت‌ها در میزبان‌های محلی و راه دور می‌توانند اشیاء راه دور را جستجو کرده و فراخوانی متدهای راه دور را انجام دهند.
.PP
رجیستری معمولاً برای یافتن نخستین شیء راه دوری استفاده می‌شود که برنامه باید متدهای آن را فراخوانی کند.
سپس آن شیء، پشتیبانی ویژه‌ی برنامه را برای یافتن سایر اشیاء فراهم می‌کند.
.PP
متدهای کلاس \f[CB]java.rmi.registry.LocateRegistry\f[R] برای دسترسی به رجیستریِ در حال اجرا روی میزبان محلی یا میزبان و درگاه محلی استفاده می‌شوند.
.PP
متدهای مبتنی بر URL در کلاس \f[CB]java.rmi.Naming\f[R] بر روی رجیستری عمل می‌کنند و می‌توان از آن‌ها برای موارد زیر استفاده کرد:
.IP \[bu] 2
پیوند دادن نام مشخص‌شده به یک شیء راه دور
.IP \[bu] 2
بازگرداندن آرایه‌ای از نام‌های پیوندیافته در رجیستری
.IP \[bu] 2
بازگرداندن یک مرجع (stub) برای شیء راه دورِ مرتبط با نام مشخص‌شده
.IP \[bu] 2
پیوند مجدد نام مشخص‌شده به یک شیء راه دور جدید
.IP \[bu] 2
از بین بردن پیوند نام مشخص‌شده که با یک شیء راه دور مرتبط است
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \f[CB]\-J\f[R]\f[I]option\f[R]
به همراه هر گزینهٔ Java استفاده می‌شود تا \f[I]option\f[R] پس از \f[CB]\-J\f[R] (بدون فاصله میان \f[CB]\-J\f[R] و گزینه) به مفسر Java ارسال شود.
.RS
.RE