VFS_PREOPEN(8) System Administration tools VFS_PREOPEN(8)

vfs_preopen - پنهان‌سازی تاخیرهای خواندن برای برنامه‌هایی که فایل‌های شماره‌گذاری‌شده را می‌خوانند

vfs objects = preopen

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

این ماژول به برنامه‌هایی کمک می‌کند که قصد دارند فایل‌های شماره‌گذاری‌شده را به ترتیب و با الزامات تاخیر بسیار سخت‌گیرانه بخوانند. یک حوزه که در آن این اتفاق می‌افتد، برنامه‌های پخش زنده ویدیویی هستند که می‌خواهند برای هر فریم یک فایل بخوانند.

هنگامی که از این ماژول استفاده می‌کنید، تعدادی فرآیند کمکی راه‌اندازی می‌شوند که فایل‌ها را به صورت پیش‌بینانه باز کرده و تعدادی بایت را می‌خوانند تا حافظه موقت (cache) فایل‌سیستم آماده شود؛ بنابراین بعداً هنگامی که درخواست واقعی برنامه فرا می‌رسد، به هیچ‌گونه دسترسی به دیسک نیازی نخواهد بود.

این ماژول قابل انباشت (stackable) است.

preopen:posix-basic-regex = BOOL (پیش‌فرض: no)

گزینه preopen:posix-basic-regex = yes معنای گزینه preopen:names را تغییر می‌دهد. جزئیات بیشتر در آنجا شرح داده شده است.

preopen:names = /pattern1/pattern2/

گزینه preopen:names الگوی (یا الگوهای) نام فایلی را مشخص می‌کند که باید فرآیندهای کمکی preopen را به انجام کارشان تحریک کند. ما فرض می‌کنیم که فایل‌ها به صورت افزایشی شماره‌گذاری شده‌اند. بنابراین اگر نام‌های فایل‌های شما به شکل FRAME00000.frm و FRAME00001.frm و به همین ترتیب شماره‌گذاری شده‌اند، شما آن‌ها را به عنوان preopen:names=/FRAME*.frm/ فهرست می‌کنید. الگوریتم پیش‌فرض از اولین ارقام (حداقل ۳ رقم) که می‌یابد برای محاسبه نام فریم‌های بعدی استفاده می‌کند.

گزینه preopen:posix-basic-regex = yes معنای گزینه preopen:names را تغییر می‌دهد. این بدان معناست که رشته‌های «عبارت باقاعده پایه پازیکس (POSIX Basic Regular Expression)» به عنوان الگو استفاده می‌شوند. نکته کلیدی این است که هر الگو دقیقاً به یک «زیرعبارت» که با '\(' شروع شده و با '\)' پایان می‌یابد نیاز دارد تا موقعیت ارقامی را که بیانگر شماره‌های افزایشی فریم‌ها هستند مشخص کند. با فرض نام‌های فایلی مانند Movie7599Frame0v1234.txt و Movie7599Frame1v1234.txt و Movie7599Frame2v1234.txt تا Movie7599Frame9v1234.txt، می‌توانید از preopen:names = /.*Frame\([0-9]\).*\.txt/ برای تطبیق فقط یک رقم استفاده کنید؛ این ممکن است یک مثال در دنیای واقعی نباشد، اما انعطاف‌پذیری ممکن در اینجا را نشان می‌دهد.

preopen:num_bytes = BYTES

تعداد بایت‌هایی را که فرآیندهای کمکی باید به صورت پیش‌بینانه بخوانند مشخص می‌کند، مقدار پیش‌فرض 1 است.

preopen:helpers = NUM-PROCS

تعداد فرآیندهای کمکی منشعب‌شده (forked)، مقدار پیش‌فرض 1 است.

preopen:queuelen = NUM-FILES

تعداد فایل‌هایی که باید به صورت پیش‌بینانه باز شوند. پیش‌فرض 10 فایل بعدی است.

preopen:nomatch_log_level = LOGLEVEL

به منظور عیب‌یابی یا بازرسی استفاده از منطق preopen، می‌توانید از این گزینه برای مشخص کردن سطح لاگی که جزئیات مربوط به نام فایل‌های غیرمنطبق با هر الگویی از 'preopen:names' ثبت می‌شوند، استفاده کنید.

پیش‌فرض سطح لاگ 5 است. همچنین بخش 'log level' در smb.conf(5) را برای نحوه برخورد ویژه با کلاس اشکال‌زدایی 'preopen' ببینید.

preopen:match_log_level = LOGLEVEL

به منظور عیب‌یابی یا بازرسی استفاده از منطق preopen، می‌توانید از این گزینه برای مشخص کردن سطح لاگی که جزئیات مربوط به نام فایل‌های منطبق با یک الگو از 'preopen:names' ثبت می‌شوند، استفاده کنید.

همچنین 'preopen:founddigits_log_level' و 'preopen:push_log_level' را ببینید.

پیش‌فرض سطح لاگ 5 است. همچنین بخش 'log level' در smb.conf(5) را برای نحوه برخورد ویژه با کلاس اشکال‌زدایی 'preopen' ببینید.

preopen:nodigits_log_level = LOGLEVEL

به منظور عیب‌یابی یا بازرسی مشکلات مربوط به پیکربندی preopen، می‌توانید از این گزینه برای مشخص کردن سطح لاگی که جزئیات مربوط به نام فایل‌های منطبق با الگویی از 'preopen:names'، اما فاقد ارقام مورد انتظار ثبت می‌شوند، استفاده کنید. این معمولاً چیزی است که مدیر سیستم می‌خواهد به آن توجه کند و پیکربندی را تنظیم کند تا دقیق‌تر مشخص شود ارقام در کجای نام فایل پیدا شوند.

پیش‌فرض سطح لاگ 1 است. همچنین بخش 'log level' در smb.conf(5) را برای نحوه برخورد ویژه با کلاس اشکال‌زدایی 'preopen' ببینید.

preopen:founddigits_log_level = LOGLEVEL

به منظور عیب‌یابی یا بازرسی استفاده از منطق preopen، می‌توانید از این گزینه برای مشخص کردن سطح لاگی که جزئیات مربوط به نام فایل‌های منطبق با الگویی از 'preopen:names' و هم‌زمان دارای ارقام معتبر مورد انتظار ثبت می‌شوند، استفاده کنید. این بدان معناست که اطلاعات کافی به منظور قرار دادن در صف پیش‌بازگشایی (preopens) موجود است.

پیش‌فرض سطح لاگ 3 است. همچنین بخش 'log level' در smb.conf(5) را برای نحوه برخورد ویژه با کلاس اشکال‌زدایی 'preopen' ببینید.

preopen:reset_log_level = LOGLEVEL

اگر یک نام فایل منطبق متعلق به الگوی متفاوتی از 'preopen:names' باشد، متعلق به دایرکتوری والد متفاوتی باشد یا تفاوت قابل توجهی با آخرین نام فایلی که پیش‌تر پیدا شده بود داشته باشد، ماژول نیاز دارد وضعیت صف داخلی خود را بازنشانی کند. این یعنی دیگر پیش‌بازگشایی‌های بیشتری به فرآیندهای کمکی متعلق به وضعیت صف قبلی ارسال نخواهد شد. به منظور عیب‌یابی یا بازرسی چنین بازنشانی‌هایی در صف، می‌توانید از این گزینه برای مشخص کردن سطح لاگی که جزئیات در آن ثبت می‌شوند استفاده کنید.

پیش‌فرض سطح لاگ 5 است. همچنین بخش 'log level' در smb.conf(5) را برای نحوه برخورد ویژه با کلاس اشکال‌زدایی 'preopen' ببینید.

preopen:push_log_level = LOGLEVEL

به منظور عیب‌یابی یا بازرسی استفاده از منطق preopen، می‌توانید از این گزینه برای مشخص کردن سطح لاگی که جزئیات مربوط به نام فایل‌هایی که واقعاً به فرآیندهای کمکی preopen ارسال شده‌اند ثبت می‌شوند، استفاده کنید. این یعنی آن‌ها به زودی واقعاً پیش‌بازگشایی خواهند شد.

پیش‌فرض سطح لاگ 3 است. همچنین بخش 'log level' در smb.conf(5) را برای نحوه برخورد ویژه با کلاس اشکال‌زدایی 'preopen' ببینید.

preopen:queue_log_level = LOGLEVEL

به منظور عیب‌یابی جزئیات مربوط به پردازش صف داخلی، می‌توانید از این گزینه برای مشخص کردن سطح لاگی که جزئیات در آن ثبت می‌شوند استفاده کنید.

پیش‌فرض سطح لاگ 10 است. همچنین بخش 'log level' در smb.conf(5) را برای نحوه برخورد ویژه با کلاس اشکال‌زدایی 'preopen' ببینید.

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

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

ماژول PREOPEN VFS با مشارکت‌های Volker Lendecke و توسعه‌دهندگان IBM ایجاد شده است.

08/16/2026 Samba 4.24.6