.\"
.\" cupsfilter man page for CUPS.
.\"
.\" Copyright © 2020-2024 by OpenPrinting.
.\" Copyright © 2007-2019 by Apple Inc.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH cupsfilter 8 "CUPS" "2021-02-28" "OpenPrinting"
.SH "نام (NAME)"
cupsfilter \- تبدیل یک فایل به قالبی دیگر با استفاده از فیلترهای cups (منسوخ‌شده)
.SH "خلاصه دستور (SYNOPSIS)"
.B cupsfilter
[
.B \-\-list\-filters
] [
.B \-D
] [
.B \-U
.I user
] [
.B \-c
.I config-file
] [
.B \-d
.I printer
] [
.B \-e
] [
.B \-i
.I mime/type
] [
.B \-j
.I job-id[,N]
] [
.B \-m
.I mime/type
] [
.B \-n
.I copies
] [
.B \-o
.I name=value
] [
.B \-p
.I filename.ppd
] [
.B \-t
.I title
] [
.B \-u
]
.I filename
.SH "توضیحات (DESCRIPTION)"
.B cupsfilter
یک رابط پیشانه (front-end) برای زیرسیستم فیلتر CUPS است که به شما امکان می‌دهد فایلی را به یک قالب خاص تبدیل کنید، درست مانند آنکه فایل را از طریق CUPS چاپ کرده باشید. به‌طور پیش‌فرض،
.B cupsfilter
یک فایل PDF تولید می‌کند. فایل تبدیل‌شده به خروجی استاندارد فرستاده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP 5
.B \-\-list\-filters
فیلترها را واقعاً اجرا نمی‌کند، فقط فیلترهای استفاده‌شده را در خروجی استاندارد (stdout) چاپ می‌کند.
.TP 5
.B \-D
فایل ورودی را پس از تبدیل حذف می‌کند.
.TP 5
\fB\-U \fIuser\fR
نام کاربری ارسال‌شده به فیلترها را تعیین می‌کند. پیش‌فرض، نام کاربر فعلی است.
.TP 5
\fB\-c \fIconfig-file\fR
از فایل پیکربندی cups-files.conf مشخص‌شده استفاده می‌کند.
.TP 5
\fB\-d \fIprinter\fR
از اطلاعات چاپگر مشخص‌شده استفاده می‌کند.
.TP 5
.B \-e
از تمامی فیلترهای موجود در فایل PPD استفاده می‌کند.
.TP 5
\fB\-i \fImime/type\fR
نوع فایل مبدا را مشخص می‌کند. نوع فایل پیش‌فرض با استفاده از نام فایل و محتویات آن حدس زده می‌شود.
.TP 5
\fB\-j \fIjob-id[,N]\fR
سند N را از کار چاپ مشخص‌شده تبدیل می‌کند. اگر N حذف شود، سند ۱ تبدیل می‌شود.
.TP 5
\fB\-m \fImime/type\fR
نوع فایل مقصد را مشخص می‌کند. نوع پیش‌فرض فایل application/pdf است. از printer/foo برای تبدیل به قالب چاپگری که توسط فیلترها در فایل PPD تعریف شده است استفاده کنید.
.TP 5
\fB\-n \fIcopies\fR
تعداد نسخه‌های تولیدی را مشخص می‌کند.
.TP 5
\fB\-o \fIname=value\fR
گزینه‌هایی را برای ارسال به فیلترهای CUPS تعیین می‌کند.
.TP 5
\fB\-p \fIfilename.ppd\fR
فایل PPD مورد استفاده را مشخص می‌کند.
.TP 5
\fB\-t \fItitle\fR
عنوان سند را مشخص می‌کند.
.TP 5
.B \-u
فایل PPD را پس از تبدیل حذف می‌کند.
.SH "وضعیت خروج (EXIT STATUS)"
.B cupsfilter
در صورت بروز هرگونه خطا یک وضعیت خروج غیرصفر برمی‌گرداند.
.SH "محیط (ENVIRONMENT)"
تمام متغیرهای محیطی استاندارد
.BR cups (1)
بر عملکرد
.BR cupsfilter
تأثیر می‌گذارند.
.SH "فایل‌ها (FILES)"
.nf
/etc/cups/cups-files.conf
/etc/cups/*.convs
/etc/cups/*.types
/usr/share/cups/mime/*.convs
/usr/share/cups/mime/*.types
.SH "نکات (NOTES)"
راه‌اندازها (درایورها)، فیلترها و بک‌اند‌های چاپگر CUPS منسوخ شده‌اند و در نسخه‌های آینده CUPS دیگر پشتیبانی نخواهند شد.
چاپگرهایی که از IPP پشتیبانی نمی‌کنند را می‌توان با استفاده از برنامه‌هایی مانند
.BR ippeveprinter (1)
پشتیبانی کرد.
.LP
برخلاف زمان چاپ، فیلترهایی که با استفاده از دستور
.B cupsfilter
اجرا می‌شوند از کاربر و نشست امنیتی فعلی استفاده می‌کنند. این امر ممکن است منجر به خروجی متفاوت یا رفتاری غیرمنتظره شود.
.SH "مثال (EXAMPLE)"
دستور زیر یک پیش‌نمایش PDF از کار شماره ۴۲ برای چاپگری به نام "myprinter" تولید می‌کند و آن را در فایلی به نام "preview.pdf" ذخیره می‌کند:
.nf

    cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR cups (1),
.BR cupsd.conf (5),
.BR filter(7),
.BR mime.convs (7),
.BR mime.types (7),
راهنمای آنلاین CUPS (http://localhost:631/help)
.SH "حق نشر (COPYRIGHT)"
Copyright \[co] 2020-2024 by OpenPrinting.