.\"
.\" cupstestppd 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 cupstestppd 1 "CUPS" "2021-02-28" "OpenPrinting"
.SH "نام (NAME)"
cupstestppd \- آزمایش و اعتبارسنجی فایل‌های PPD در سیستم چاپ کاپس
.SH "خلاصه دستور (SYNOPSIS)"
.B cupstestppd
[
.B \-I
.I category
] [
.B \-R
.I rootdir
] [
.B \-W
.I category
] [
.B \-q
] [
.B \-r
] [
\fB\-v\fR[\fBv\fR]
]
.I filename.ppd[.gz]
[ ...
.I filename.ppd[.gz]
]
.br
.B cupstestppd
[
.B \-R
.I rootdir
] [
.B \-W
.I category
] [
.B \-q
] [
.B \-r
] [
\fB\-v\fR[\fBv\fR]
]
.B \-
.SH "توضیحات (DESCRIPTION)"
دستور
.B cupstestppd
میزان انطباق فایل‌های PPD را با مشخصات قالب فایل Adobe PostScript Printer Description نسخه ۴.۳ بررسی و آزمایش می‌کند.
همچنین می‌تواند برای فهرست کردن گزینه‌های پشتیبانی‌شده و قلم‌های موجود در یک فایل PPD استفاده شود.
نتایج آزمایش و هرگونه خروجی دیگر به خروجی استاندارد ارسال می‌شود.
.LP
حالت اول
.B cupstestppd
یک یا چند فایل PPD مشخص‌شده در خط فرمان را آزمایش می‌کند.
حالت دوم، فایل PPD ارائه‌شده در ورودی استاندارد را آزمایش می‌کند.
.SH "گزینه‌ها (OPTIONS)"
دستور
.B cupstestppd
از گزینه‌های زیر پشتیبانی می‌کند:
.TP 5
\fB\-I filename\fR
تمام هشدارهای PCFileName را نادیده می‌گیرد.
.TP 5
\fB\-I filters\fR
تمام خطاهای فیلتر را نادیده می‌گیرد.
.TP 5
\fB\-I profiles\fR
تمام خطاهای پروفایل را نادیده می‌گیرد.
.TP 5
\fB\-R \fIrootdir\fR
یک دایرکتوری ریشه جایگزین را برای بررسی‌های فیلتر، پیش‌فیلتر و سایر فایل‌های پشتیبانی مشخص می‌کند.
.TP 5
\fB\-W constraints\fR
تمام خطاهای UIConstraint را به عنوان هشدار گزارش می‌دهد.
.TP 5
\fB\-W defaults\fR
به جز گزینه‌های مربوط به اندازه، تمام خطاهای گزینه‌های پیش‌فرض را به عنوان هشدار گزارش می‌دهد.
.TP 5
\fB\-W filters\fR
تمام خطاهای فیلتر را به عنوان هشدار گزارش می‌دهد.
.TP 5
\fB\-W profiles\fR
تمام خطاهای پروفایل را به عنوان هشدار گزارش می‌دهد.
.TP 5
\fB\-W sizes\fR
تمام خطاهای اندازه رسانه را به عنوان هشدار گزارش می‌دهد.
.TP 5
\fB\-W translations\fR
تمام خطاهای ترجمه را به عنوان هشدار گزارش می‌دهد.
.TP 5
\fB\-W all\fR
تمام خطاهای قبلی را به عنوان هشدار گزارش می‌دهد.
.TP 5
\fB\-W none\fR
تمام خطاهای قبلی را به عنوان خطا گزارش می‌دهد.
.TP 5
.B \-q
مشخص می‌کند که هیچ اطلاعاتی نباید نمایش داده شود.
.TP 5
.B \-r
الزامات انطباق PPD را سهل‌تر می‌کند تا فاصله‌های خالی رایج، نویسه‌های کنترلی و مشکلات قالب‌بندی به عنوان خطای قطعی در نظر گرفته نشوند.
.TP 5
.B \-v
مشخص می‌کند که نتایج دقیق آزمایش انطباق به جای وضعیت خلاصه PASS/FAIL/ERROR نمایش داده شود.
.TP 5
.B \-vv
مشخص می‌کند که علاوه بر نتایج دقیق آزمایش انطباق، تمام اطلاعات موجود در فایل PPD نیز نمایش داده شود.
.LP
گزینه‌های
.BR \-q ،
.B \-v
و
.B \-vv
مانعةالجمع هستند و نمی‌توانند هم‌زمان استفاده شوند.
.SH "وضعیت خروج (EXIT STATUS)"
دستور
.B cupstestppd
در صورت موفقیت مقدار صفر و در صورت بروز خطا مقداری غیرصفر برمی‌گرداند.
کدهای خطا به شرح زیر هستند:
.TP 5
1
آرگومان‌های خط فرمان نادرست است یا نام فایل PPD مشخص نشده است.
.TP 5
2
امکان باز کردن یا خواندن فایل PPD وجود ندارد.
.TP 5
3
فایل PPD حاوی خطاهای قالبی است که قابل چشم‌پوشی نیستند.
.TP 5
4
فایل PPD با مشخصات Adobe PPD مطابقت ندارد.
.SH "مثال‌ها (EXAMPLES)"
دستور زیر تمام فایل‌های PPD موجود در دایرکتوری فعلی را آزمایش کرده و نام هر فایلی را که مطابقت ندارد چاپ می‌کند:
.nf

    find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \-print

.fi
دستور بعدی تمام فایل‌های PPD موجود در دایرکتوری فعلی را آزمایش کرده و نتایج تفصیلی آزمایش انطباق را برای فایل‌هایی که مطابقت ندارند چاپ می‌کند:
.nf

    find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \\
        \-exec cupstestppd \-v '{}' \\;
.fi
.SH "نکات (NOTES)"
فایل‌های PPD منسوخ شده‌اند و در نگارش‌های آینده CUPS دیگر پشتیبانی نخواهند شد.
چاپگرهایی که از IPP پشتیبانی نمی‌کنند را می‌توان با استفاده از برنامه‌هایی مانند
.BR ippeveprinter (1)
پشتیبانی کرد.
.SH "همچنین ببینید (SEE ALSO)"
.BR lpadmin (8),
راهنمای آنلاین CUPS (http://localhost:631/help)،
Adobe PostScript Printer Description File Format Specification, Version 4.3.
.SH "حق نشر (COPYRIGHT)"
Copyright \[co] 2020-2024 by OpenPrinting.