'"t
."     Title: vfs_catia
."    Author: [see the "AUTHOR" section]
." Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
."      Date: 08/16/2026
."    Manual: ابزارهای مدیریت سیستم
."    Source: Samba 4\&.24\&.6
."  Language: Persian
."
.TH "VFS_CATIA" "8" "08/16/2026" "Samba 4\&.24\&.6" "ابزارهای مدیریت سیستم"
." -----------------------------------------------------------------
." * Define some portability stuff
." -----------------------------------------------------------------
." ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
." http://bugs.debian.org/507673
." http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
." ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
." -----------------------------------------------------------------
." * set default formatting
." -----------------------------------------------------------------
." disable hyphenation
.nh
." disable justification (adjust text to left margin only)
.ad l
." -----------------------------------------------------------------
." * MAIN CONTENT STARTS HERE *
." -----------------------------------------------------------------
.SH "نام (NAME)"
vfs_catia \- تبدیل نویسه‌های غیرمجاز در نام فایل‌های Catia
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w' 'u
vfs objects = catia
.SH "توضیحات (DESCRIPTION)"
.PP
این ماژول VFS بخشی از مجموعه
\fBsamba\fR(7)
است.
.PP
بسته نرم‌افزاری مهندسی Catia معمولاً نام فایل‌هایی ایجاد می‌کند که شامل نویسه‌های غیرمجاز در نام‌گذاری فایل‌های پروتکل CIFS است. ماژول VFS با نام
.B vfs_catia
یک نگاشت نویسه‌ای را پیاده‌سازی می‌کند تا این فایل‌ها بتوانند با کلاینت‌های CIFS به اشتراک گذاشته شوند.
.PP
این ماژول پشته‌پذیر (stackable) است.
.PP
پارامتر "catia:mappings" نحوه نگاشت را به ازای هر نویسه مشخص می‌کند؛ بخش‌های بعدی را ببینید.
.SH "گزینه‌ها (OPTIONS)"
.PP
catia:mappings = SERVER_HEX_CHAR:CLIENT_HEX_CHAR
.RS 4
مقدار SERVER_HEX_CHAR یک کد نویسه در مبنای شانزده با پیشوند 0x را مشخص می‌کند که در صورت وجود در نام فایل سمت سرور سامبا، به CLIENT_HEX_CHAR برای کلاینت CIFS نگاشت خواهد شد.
.sp
همین نگاشت در جهت معکوس نیز انجام می‌شود. چند نگاشت نویسه‌ای مختلف را می‌توان با کاما از یکدیگر جدا کرد.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
نگاشت علامت نقل‌قول سمت سرور (") به دونقطه بالای حرف (\(ad) در سمت کلاینت برای نام فایل‌ها در اشتراک [CAD]:
.sp
.if n \{.RS 4
.\}
.nf
        \fI[CAD]\fR
	\m[blue]\fBpath = /data/cad\fR\m[]
	\m[blue]\fBvfs objects = catia\fR\m[]
	\m[blue]\fBcatia:mappings = 0x22:0xa8\fR\m[]
.fi
.if n \{.RE
.\}
.PP
انجام نگاشت جامع نویسه‌های متداول نام فایل‌های Catia:
.sp
.if n \{.RS 4
.\}
.nf
        \fI[CAD]\fR
	\m[blue]\fBpath = /data/cad\fR\m[]
	\m[blue]\fBvfs objects = catia\fR\m[]
	\m[blue]\fBcatia:mappings = 0x22:0xa8,0x2a:0xa4,0x2f:0xf8,0x3a:0xf7,0x3c:0xab,0x3e:0xbb,0x3f:0xbf,0x5c:0xff,0x7c:0xa6\fR\m[]
.fi
.if n \{.RE
.\}
.PP
نام فایل سمت سرور که باید تبدیل شود (توجه داشته باشید که جداکننده مسیر "/" در اینجا استفاده نمی‌شود):
.PP
a\ea:a*a?a"a<a>a|a
.PP
نام فایل حاصل، همان‌طور که توسط کلاینت دیده می‌شود:
.PP
aÿa\(dia\(Csa\(r?a\(ada\(Foa\(Fca\(bba
.SH "هشدارها (CAVEATS)"
.PP
نگاشت نویسه‌ها باید در هر دو جهت (سرور به کلاینت و کلاینت به سرور) به درستی کار کند تا نام فایل‌های یکتا و معتبر حاصل شوند!
.PP
یک مثال از حالتی که به درستی کار نمی‌کند:
.sp
.if n \{.RS 4
.\}
.nf
        \fI[CAD]\fR
	\m[blue]\fBpath = /data/cad\fR\m[]
	\m[blue]\fBvfs objects = catia\fR\m[]
	\m[blue]\fBcatia:mappings = 0x3a:0x5f\fR\m[]
.fi
.if n \{.RE
.\}
.PP
در اینجا دونقطه ":" به زیرخط "_" نگاشت شده است.
.PP
با فرض نام فایل سمت سرور به صورت "a:should_work"، این نام برای کلاینت به "a_should_work" تبدیل می‌شود.
.PP
اما نگاشت معکوس از نام کلاینت "a_should_work" به سمت سرور منجر به "a:should:work" خواهد شد؛ در نتیجه پیامی مشابه "فایل پیدا نشد" برگردانده می‌شود.
.SH "نسخه (VERSION)"
.PP
این صفحه راهنما بخشی از نسخه‌های سامبا از 3\&.5\&.0 تا 4\&.0\&.6 است.
.SH "نویسندگان (AUTHORS)"
.PP
نرم‌افزار اصلی سامبا و ابزارهای مرتبط توسط Andrew Tridgell ساخته شده‌اند. سامبا اکنون توسط تیم سامبا (Samba Team) به عنوان یک پروژه متن‌باز مشابه روش توسعه هسته لینوکس توسعه داده می‌شود.
.PP
نسخه جدید توسط Guenter Kukkukk به نشانی kukks@samba\&.org نوشته شده است.