.\"
.\" mime.types man page for CUPS.
.\"
.\" Copyright © 2020-2024 by OpenPrinting.
.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH mime.types 5 "CUPS" "2021-02-28" "OpenPrinting"
.SH "نام (NAME)"
mime.types \- فایل توصیف نوع MIME برای CUPS
.SH "توضیحات (DESCRIPTION)"
پرونده
.B mime.types
انواع فایل‌های شناخته‌شده را تعریف می‌کند.
.LP
انواع فایل‌های اضافی در فایل‌هایی با پسوند
.I .types
در دایرکتوری پیکربندی CUPS مشخص می‌شوند.
.LP
هر خط در پرونده
.B mime.types
یک خط توضیحات (کامنت)، خالی یا خط قانون است.
خطوط توضیحات با نویسه # آغاز می‌شوند.
خطوط قانون با نوع رسانه MIME آغاز شده و می‌توانند به صورت اختیاری با مجموعه‌ای از قوانین شناسایی فایل دنبال شوند:
.nf

    \fImime/type \fR[ \fIrule \fR... \fIrule \fR]

.fi
قوانین را می‌توان با استفاده از نویسه اسلش وارونه (\\) در چندین خط ادامه داد:
.nf

    \fImime/type \fR[ \fIreally-really-really-long-rule \fR... \fB\\
      \fIrule \fR]

.fi
انواع رسانه‌ای MIME مشخص‌شده با فیلد
.I mime/type
به بزرگی و کوچکی حروف حساس نیستند و برای تطبیق، به ترتیب صعودی الفبایی\-عددی مرتب می‌شوند.
برای اطلاعات بیشتر بخش «تطبیق نوع و اولویت» را ببینید.
.LP
قوانین را می‌توان با استفاده از پرانتز گروه‌بندی کرد، با استفاده از «+» برای AND منطقی، با استفاده از «,» یا فاصله سفید برای OR منطقی، و با استفاده از «!» نقیض کرد.
.SS "قوانین (RULES)"
قوانین به دو شکل هستند \- پسوند نام فایل به تنهایی، و توابعی با مقادیر آزمون درون پرانتز.
توابع زیر در دسترس هستند:
.TP 5
\fBmatch("\fIpattern\fB")\fR
اگر نام فایل با الگوی عام پوسته (\fIpattern\fR) مطابقت داشته باشد، درست است.
.TP 5
\fBascii(\fIoffset\fB,\fIlength\fB)\fR
اگر \fIlength\fR بایت که از \fIoffset\fR شروع می‌شوند کاراکترهای اسکی (ASCII) چاپی معتبر (CR، NL، TAB، BS، 32-126) باشند، درست است.
مقدار \fIlength\fR نمی‌تواند از ۸۱۹۲ بایت تجاوز کند.
.TP 5
\fBprintable(\fIoffset\fB,\fIlength\fB)\fR
اگر \fIlength\fR بایت که از \fIoffset\fR شروع می‌شوند کاراکترهای ۸ بیتی چاپی (CR، NL، TAB، BS، 32-126، 128-254) باشند، درست است.
مقدار \fIlength\fR نمی‌تواند از ۸۱۹۲ بایت تجاوز کند.
.TP 5
\fBpriority(\fInumber\fB)\fR
اولویت نسبی این نوع رسانه MIME را مشخص می‌کند.
اولویت پیش‌فرض ۱۰۰ است.
مقادیر بزرگتر اولویت بالاتر و مقادیر کوچکتر اولویت پایین‌تری دارند.
.TP 5
\fBstring(\fIoffset\fB,"\fIstring\fB")\fR
اگر بایت‌های شروع‌شده از \fIoffset\fR دقیقاً یکسان با \fIstring\fR باشند، درست است.
.TP 5
\fBistring(\fIoffset\fB,"\fIstring\fB")\fR
اگر بایت‌های شروع‌شده از \fIoffset\fR بدون توجه به بزرگی و کوچکی حروف با \fIstring\fR مطابقت داشته باشند، درست است.
.TP 5
\fBchar(\fIoffset\fB,\fIvalue\fB)\fR
اگر بایت موجود در \fIoffset\fR دقیقاً برابر با \fIvalue\fR باشد، درست است.
.TP 5
\fBshort(\fIoffset\fB,\fIvalue\fB)\fR
اگر عدد صحیح ۱۶ بیتی با ترتیب بایت بزرگ‌انتهایی (big-endian) در \fIoffset\fR دقیقاً برابر با \fIvalue\fR باشد، درست است.
.TP 5
\fBint(\fIoffset\fB,\fIvalue\fB)\fR
اگر عدد صحیح ۳۲ بیتی با ترتیب بایت بزرگ‌انتهایی (big-endian) در \fIoffset\fR دقیقاً برابر با \fIvalue\fR باشد، درست است.
.TP 5
\fBlocale("\fIstring\fB")\fR
اگر لوکال (locale) جاری با \fIstring\fR مطابقت داشته باشد، درست است.
.TP 5
\fBcontains(\fIoffset\fB,\fIlength\fB,"\fIstring\fB")\fR
اگر بایت‌های شروع‌شده از \fIoffset\fR به طول \fIlength\fR بایت، حاوی \fIstring\fR باشند، درست است.
مقدار \fIlength\fR نمی‌تواند از ۸۱۹۲ بایت تجاوز کند.
.SS "ثابت‌های رشته‌ای (STRING CONSTANTS)"
ثابت‌های رشته‌ای را می‌توان داخل علامت نقل‌قول ("") برای رشته‌های حاوی فاصله سفید، و درون قلاب‌های زاویه‌دار (<>) برای رشته‌های هگزادسیمال مشخص کرد.
.SS "تطبیق نوع و اولویت (TYPE MATCHING AND PRIORITY)"
هنگامی که CUPS نیاز به تعیین نوع رسانه MIME یک فایل مشخص دارد، تمام انواع رسانه‌ای MIME تعریف‌شده در فایل‌های
.I .types
را بررسی می‌کند.
هنگامی که دو یا چند نوع با یک فایل مشخص مطابقت داشته باشند، نوع انتخاب‌شده به نام نوع و اولویت آن بستگی خواهد داشت، به‌طوری که انواع با اولویت بالاتر نسبت به انواع با اولویت پایین‌تر ترجیح داده می‌شوند.
اگر انواع دارای اولویت یکسانی باشند، نام انواع به ترتیب صعودی الفبایی\-عددی مرتب شده و نخستین نوع انتخاب می‌شود.
.LP
برای مثال، اگر دو نوع «text/bar» و «text/foo» برای تطبیق با پسوند «doc» تعریف شده باشند، در حالت عادی نوع «text/bar» انتخاب خواهد شد زیرا نام آن از نظر الفبایی\-عددی کوچکتر از «text/foo» است.
با این حال، اگر «text/foo» نیز اولویت بالاتری نسبت به «text/bar» تعریف کرده باشد، به جای آن «text/foo» انتخاب خواهد شد.
.SH "فایل‌ها (FILES)"
\fI/etc/cups\fR \- دایرکتوری معمول پیکربندی CUPS.
.SH "مثال‌ها (EXAMPLES)"
تعریف دو نوع رسانه MIME برای داده‌های شطرنجی (raster)، که یکی از آن‌ها زیرمجموعه‌ای با اولویت بالاتر است:
.nf

    application/vnd.cups\-raster  string(0,"RaSt") string(0,"tSaR") \\
                                  string(0,"RaS2") string(0,"2SaR") \\
                                  string(0,"RaS3") string(0,"3SaR")

    image/pwg-raster              string(0,"RaS2") + \\
                                  string(4,PwgRaster<00>) priority(150)
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR cups-files.conf (5),
.BR cupsd.conf (5),
.BR cupsd (8),
.BR cupsfilter (8),
.BR mime.convs (5),
راهنمای آنلاین CUPS (http://localhost:631/help)
.SH "حق نشر (COPYRIGHT)"
Copyright \[co] 2020-2024 by OpenPrinting.