.\"@(#)nfsref.8"
.\"
.\" Copyright 2011, 2018 Oracle.  All rights reserved.
.\"
.\" This file is part of nfs-utils.
.\"
.\" nfs-utils is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License version 2.0 as
.\" published by the Free Software Foundation.
.\"
.\" nfs-utils 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.0 for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" version 2.0 along with nfs-utils.  If not, see:
.\"
.\"	http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt
.\"
.TH "NFSREF" "8" "مه ۲۰۲۵" "nfs-utils" "دستورات مدیریت سیستم"
.SH "نام (NAME)"
nfsref \- مدیریت ارجاعات و اتصال مجدد شاخه‌ها در NFS
.SH "خلاصه دستور (SYNOPSIS)"
.B nfsref
.RB [ \-?d ]
.RB [ \-t
.IB type ]
.B add
.I pathname server export
.RI [ " server"
.IR export " ... ]"
.P
.B nfsref
.RB [ \-?d ]
.RB [ \-t
.IB type ]
.B remove
.I pathname
.P
.B nfsref
.RB [ \-?d ]
.RB [ \-t
.IB type ]
.B lookup
.I pathname
.SH "مقدمه (INTRODUCTION)"
نسخه ۴ پروتکل NFS مفهوم
.I ارجاعات سیستم فایل (file system referrals)
را به NFS معرفی می‌کند.
.P
یک ارجاع سیستم فایل شبیه یک پیوند نمادین
(یا
.IR symlink )
به اشتراک سیستم فایل دیگر است که معمولاً روی سرور فایل دیگری قرار دارد. کلاینت NFS تحت هدایت سرور، اشتراک NFS ارجاع‌شده را هنگامی که یک برنامه برای نخستین بار به آن دسترسی پیدا می‌کند، به‌طور خودکار سوار (mount) می‌کند.
.P
ارجاعات NFSv4 می‌توانند برای هدایت شفاف کلاینت‌ها به سیستم فایل‌هایی که به مکان دیگری منتقل شده‌اند، یا برای ایجاد یک فضای نام یکپارچه در میان چندین سرور فایل استفاده شوند. از آنجا که سرورهای فایل ساختار کل فضای نام فایل را کنترل می‌کنند، به هیچ‌گونه پیکربندی سمت کلاینت نیازی نیست.
.SH "توضیحات (DESCRIPTION)"
دستور \fBnfsref\fR برای ایجاد، اصلاح، حذف و بازبینی ارجاعات اتصالی (referrals) در فایل‌سیستم‌های اشتراکی NFS استفاده می‌شود.
.P
یک
.I نقطه اتصال (junction)
شیئی در سیستم فایل روی سرور NFS است که هرگاه کلاینت NFS با آن مواجه شود، یک ارجاع را فعال می‌کند. همانند یک symlink، یک junction شامل یک یا چند مکان مقصد است که سرور آن‌ها را در قالب ارجاع NFSv4 به کلاینت‌ها ارسال می‌کند.
.P
در لینوکس، یک دایرکتوری موجود می‌تواند به‌صورت اتمیک (تجزیه‌ناپذیر) و بدون از دست رفتن محتویات دایرکتوری به یک junction و برعکس تبدیل شود. هنگامی که یک دایرکتوری در نقش junction عمل می‌کند، محتویات محلی آن از دید کلاینت‌های NFSv4 پنهان می‌شود.
.P
دستور
.BR nfsref (8)
روشی ساده برای شروع مدیریت نقاط اتصال (junctions) و محتوای آن‌ها است.
.SS "زیردستورها (Subcommands)"
زیردستورهای معتبر
.BR nfsref (8)
عبارتند از:
.IP "\fBadd\fP"
اطلاعات نقطه اتصال را به دایرکتوری مشخص‌شده توسط
.IR pathname
اضافه می‌کند. دایرکتوری نام‌برده باید از قبل وجود داشته باشد و نباید از قبل حاوی اطلاعات نقطه اتصال باشد. با این عملیات، محتویات عادی دایرکتوری از دید کلاینت‌های NFS پنهان می‌شود.
.IP
فهرستی از یک یا چند جفت سرور فایل و مسیر صادرات نیز در خط فرمان مشخص می‌شود. هنگام ایجاد یک نقطه اتصال پایه NFS، این فهرست در یک صفت توسعه‌یافته (extended attribute) از دایرکتوری ذخیره می‌شود.
.IP
اگر ایجاد نقطه اتصال موفقیت‌آمیز باشد، دستور
.BR nfsref (8)
حافظه نهان صادرات هسته (export cache) را تخلیه (flush) می‌کند تا اطلاعات نقطه اتصال کش‌شده قبلی حذف شود.
.IP "\fBremove\fP"
اطلاعات نقطه اتصال را از دایرکتوری مشخص‌شده توسط
.IR pathname
حذف می‌کند. دایرکتوری مشخص‌شده باید وجود داشته باشد و حاوی اطلاعات نقطه اتصال باشد. با این عملیات، محتویات عادی دایرکتوری دوباره برای کلاینت‌های NFS قابل مشاهده می‌شود.
.IP
اگر حذف نقطه اتصال موفقیت‌آمیز باشد، دستور
.BR nfsref (8)
حافظه نهان صادرات هسته را تخلیه می‌کند تا اطلاعات نقطه اتصال کش‌شده قبلی حذف شود.
.IP "\fBlookup\fP"
اطلاعات نقطه اتصال ذخیره‌شده در دایرکتوری مشخص‌شده توسط
.IR pathname
را نمایش می‌دهد. دایرکتوری مشخص‌شده باید وجود داشته باشد و حاوی اطلاعات نقطه اتصال باشد.
.IP
هنگام جستجوی یک نقطه اتصال پایه NFS، اطلاعات نقطه اتصال موجود در دایرکتوری در
.IR stdout
فهرست می‌شود.
.SS "گزینه‌های خط فرمان (Command line options)"
.IP "\fB\-d, \-\-debug\fP"
پیام‌های اشکال‌زدایی را هنگام عملیات فعال می‌کند.
.IP "\fB\-t, \-\-type=\fIjunction-type\fP"
نوع نقطه اتصال را برای این عملیات تعیین می‌کند. مقادیر معتبر برای
.I junction-type
شامل
.B nfs-basic
یا
.BR nfs-fedfs
است.
.IP
برای زیردستور
.BR add ،
اگر این گزینه مشخص نشود، مقدار پیش‌فرض
.BR nfs-basic
است. نوع
.B nfs-fedfs
در این پیاده‌سازی استفاده نمی‌شود.
.IP
برای زیردستورهای
.B remove
و
.BR lookup ،
گزینه
.B \-\-type
الزامی نیست. دستور
.BR nfsref (8)
بر روی هر محتوای نقطه اتصالی که موجود باشد عمل می‌کند.
.SH "مثال‌ها (EXAMPLES)"
فرض کنید دو سرور فایل دارید:
.I top.example.net
و
.IR home.example.net .
می‌خواهید همه کلاینت‌های شما
.I top.example.net:/
را سوار (mount) کنند و سپس فایل‌های زیر
.I home.example.net:/
را به‌طور خودکار در
.I top:/home
ببینند.
.P
روی
.IR top.example.net ،
می‌توانید این دستور را به عنوان کاربر root اجرا کنید:
.RS
.sp
.nf
# mkdir /home
# nfsref add /home home.example.net /
Created junction /home.
.fi
.sp
.RE
.SH "همچنین ببینید (SEE ALSO)"
RFC 8881 برای توصیف سازوکار ارجاع در NFS نسخه ۴
.SH "نویسنده (AUTHOR)"
Chuck Lever <chuck.lever@oracle.com>