نام (NAME)

vfs_crossrename - تغییر نام فایل‌ها در سمت سرور فراتر از مرزهای سیستم‌فایل

خلاصه دستور (SYNOPSIS)

vfs objects = crossrename

توضیحات (DESCRIPTION)

این ماژول VFS بخشی از مجموعه samba(7) است.

ماژول VFS با نام vfs_crossrename امکان عملیات تغییر نام در سمت سرور را حتی در صورتی که مبدا و مقصد روی دستگاه‌های فیزیکی متفاوتی باشند، فراهم می‌کند. یک عملیات «انتقال» (move) در Explorer معمولاً اگر درون یک اشتراک یا دستگاه منفرد باشد، یک عملیات تغییر نام است. معمولاً چنین عملیات تغییر نامی وضعیت NT_STATUS_NOT_SAME_DEVICE را برمی‌گرداند و کلاینت باید فایل را با عملیات دستی کپی و حذف جابه‌جا کند. اگر تغییر نام از طریق کپی توسط سرور انجام شود، می‌تواند بسیار کارآمدتر باشد. ماژول vfs_crossrename تلاش می‌کند این عملیات تغییر نام بین‌دستگاهی در سمت سرور را انجام دهد.

با این حال محدودیت‌هایی وجود دارد که این ماژول در حال حاضر آن‌ها را برطرف نمی‌کند:

لیست‌های کنترل دسترسی (ACL) فایل‌ها حفظ نمی‌شوند،

متاداده‌ها در ویژگی‌های گسترش‌یافته (EA) حفظ نمی‌شوند،

تغییر نام کل زیرپوشه‌ها را نمی‌توان به‌صورت بازگشتی انجام داد؛ در این حالت ما همچنان STATUS_NOT_SAME_DEVICE را برمی‌گردانیم و اجازه می‌دهیم کلاینت تصمیم بگیرد چه کاری انجام دهد،

عملیات تغییر نام فایل‌های بسیار حجیم می‌تواند باعث معلق ماندن یا قفل شدن کلاینت شود، زیرا کلاینت‌ها انتظار دارند عملیات تغییر نام سریع بازگردد.

این ماژول به‌طور کامل پشته‌پذیر (stackable) نیست. می‌تواند با ماژول‌های دیگر ترکیب شود، اما باید آخرین ماژول در فهرست vfs objects باشد. این ماژول مستقیماً به فایل‌ها در سیستم‌فایل سیستم‌عامل دسترسی پیدا می‌کند.

گزینه‌ها (OPTIONS)

crossrename:sizelimit = BYTES

تغییر نام بین‌دستگاهی در سمت سرور فقط برای فایل‌هایی انجام می‌شود که اندازه فایل بزرگ‌تر از مقدار تعریف‌شده بر حسب مبی‌بایت (MiB) نباشد تا از بروز وقفه زمانی (timeout) جلوگیری شود. محدودیت اندازه پیش‌فرض 20 (MiB) است.

مثال‌ها (EXAMPLES)

برای افزودن امکان تغییر نام بین‌دستگاهی در سمت سرور درون یک اشتراک برای تمام فایل‌های با حجم حداکثر ۵۰ مگابایت:

        [testshare]
	path = /data/mounts
	vfs objects = crossrename
	crossrename:sizelimit = 50

نسخه (VERSION)

این صفحه راهنما بخشی از نسخه 4.24.6 مجموعه Samba است.

نویسنده (AUTHOR)

نرم‌افزار اصلی Samba و ابزارهای مرتبط توسط Andrew Tridgell ساخته شده‌اند. Samba اکنون توسط تیم Samba به‌صورت یک پروژه متن‌باز مشابه نحوه توسعه هسته لینوکس توسعه می‌یابد.