.\" This -*- nroff -*- source file is part of foomatic.
.\"
.TH FOOMATIC-CONFIGURE 1 "2002-01-06" "Foomatic Project"
.SH "نام (NAME)"
foomatic-configure \- برنامه اصلی پیکربندی سیستم چاپ foomatic
.SH "خلاصه دستور (SYNOPSIS)"
.B foomatic-configure
[\fIOPTION\fR]...

.BI foomatic-configure\ \-n \ queuename \ [\ \-N \ description \ ] \ [\ \-L \ location \ ] \ [\ \-c \ connect \ ] \ [\ \-d \ driver \ ] \ [\ \-p \ printer \ ] \ [\ \--ppd \ ppdfile \ ] \ [\ \-s \ spooler \ ] \ \fB[\ \fB\-C \ \fB[\ \fIsourcespooler\fB\ \fB]\ \fIsourcequeue\fB \ \fB] \ \fB[\ \fB\-o \ \fIoption1\fB=\fIvalue1\fB \ \fB\-o \ \fIoption2\fB \ \fB...\ \fB]\ \fB[\ \fB\-q\ \fB]\

.BI foomatic-configure\ \-D\ \-n \ queuename \ [\ \-s \ spooler \ ]\ [\ \-q\ ]

.BI foomatic-configure\ \-R\ \-n \ queuename \ [\ \-s \ spooler \ ]\ [\ \-q\ ]

.BI foomatic-configure\ \-Q\ \ [\ \-s \ spooler \ ]\ [\ \-n \ queuename \ ]\ [\ \-r\ ]

.BI foomatic-configure\ \-P\ \ [\ \-s \ spooler \ ]\ [\ \-n \ queuename \ ] \ \fB[\ \fB\-d \ \fIdriver \ \fB] \ \fB[\ \fB\-p \ \fIprinter \ \fB] \ \fB[\ \fB\--ppd \ \fIppdfile \ \fB] \ \fB[\ \fIindex \ \fB]

.BI foomatic-configure\ \-X\ \-p \ printer \ |\ \-d \ driver \ |
.BI \-p \ printer \ \-d \ driver

.BI foomatic-configure\ \-O

.BI foomatic-configure\ \-h

.BI foomatic-configure\ \--help

.SH "توضیحات (DESCRIPTION)"
.B foomatic-configure 
برنامه‌ای برای برپاسازی و پیکربندی صف‌های چاپ برای تمامی اسپولرهای شناخته‌شده (CUPS, LPRng, LPD, GNUlpr, PPR, PDQ, CPS، بدون اسپولر) و تمامی ترکیب‌های معتبر چاپگر/درایور در پایگاه‌داده Foomatic یا هر فایل PPD ارائه‌شده همراه با چاپگرهای PostScript است. به عنوان فیلتر RIP (پردازشگر تصویر شطرنجی یا Raster Image Processor جهت ترجمه از PostScript به زبان بومی چاپگر)، همواره
\fBfoomatic-rip(1)\fR
استفاده خواهد شد، مگر برای فایل‌های PPD چاپگرهای PostScript تحت سامانه‌های CUPS یا PPR، که در این حالت بدون فیلتر RIP استفاده خواهند شد.
.PP
این دستور همچنین نیمی از یک API برنامه‌نویسی برای ابزارهای کاربری را تشکیل می‌دهد: شما می‌توانید تمام اطلاعات مربوط به ویژگی‌های ایستا و پیکربندی صف‌های چاپ را در اینجا بررسی کرده و کنترل کنید. با کمک برنامه همکار
\fBfoomatic-printjob(1)\fR،
می‌توانید تمام کارهای مرتبط با وضعیت پویای صف چاپ را انجام دهید: ارسال وظایف چاپ، بررسی وضعیت، لغو، تغییر ترتیب و هدایت مجدد آنها.

.SH "گزینه‌ها (OPTIONS)"
.TP 10
.BI \-n \ queuename
پیکربندی این صف چاپ
.TP 10
.BI \-N \ Name/Description
استفاده از این نام/توضیحات خوانا برای انسان
.TP 10
.BI \-L \ Location
عبارت کوتاه توصیف‌کننده مکان چاپگر
.TP 10
.BI \-c \ connection
چاپگر به این صورت متصل شده است (مانند file:/dev/lp0)
.TP 10
.BI \-d \ driver
نام پایگاه‌داده Foomatic برای درایور چاپگر مورد نظر
.TP 10
.BI \-p \ printer
شناسه Foomatic برای چاپگر
.TP 10
.BI \--ppd \ ppdfile
فایل PPD، به عنوان مثال فایلی که توسط سازنده چاپگر PostScript ارائه شده است
.TP 10
.BI \-s \ spooler
نوع صریح اسپولر (cups, lpd, lprng, pdq, ppr, direct)
.TP 10
.BI \-o \ option=value
تنظیم مقدار پیش‌فرض گزینه روی value
.TP 10
.BI \-o \ option
فعال‌سازی پیش‌فرض گزینه
.TP 10
.BI \-D
تنظیم این صف به عنوان صف پیش‌فرض (تنها کافی است \fB\-n\fP \fIqueuename\fP مشخص شود)
.TP 10
.BI \-R
حذف کامل این صف (تنها کافی است \fB\-n\fP \fIqueuename\fP مشخص شود)
.TP 10
.BI \-C \ [ \ sourcespooler \ ] \ sourcequeue
کپی کردن sourcequeue از sourcespooler (یا اسپولر فعلی در صورت عدم تعیین sourcespooler) به صف مشخص‌شده توسط \fB\-n\fP \fIqueuename\fP (در اسپولر فعلی).
.TP 10
.BI \-Q
استعلام پیکربندی موجود (یک خلاصه XML برمی‌گرداند)
.TP 10
.BI \-r
فهرست کردن صف‌های تعریف‌شده از راه دور (فقط در CUPS)
.TP 10
.BI \-P \ [ \ index \ ]
دریافت خروجی دامپ پرل از پیکربندی جاری (به صورت یک آرایه پرل با نام QUEUES؛ نخستین اندیس index است، یا در صورت عدم تعیین صفر خواهد بود)
.TP 10
.BI \-O
چاپ نمای کلی XML از تمام چاپگرها/درایورهای شناخته‌شده (شناسه‌های Foomatic چاپگرها را نیز نمایش می‌دهد)
.TP 10
.BI \-X
چاپ داده‌های XML برای شیء \fB\-p\fP \fIprinter\fP یا \fB\-d\fP \fIdriver\fP
.TP 10
.BI \-q
اجرا در حالت بی‌صدا (ساکت)

.SS "دستورات (Commands)"
دستوری وجود ندارد، فقط گزینه‌ها در دسترس هستند

.\".SH FILES
.\".TP 25
.\"/etc/foomatic/lpd/<queue>
.\".TP 25
.\"/etc/foomatic/<queue>.xml
.\".TP 25
.\"/etc/printcap
.\"The systems list of configured printers.
.\".PD 0

.SH "همچنین ببینید (SEE ALSO)"
.IR foomatic-printjob (1), \ foomatic-rip (1)

.SH "وضعیت خروج (EXIT STATUS)"
.B foomatic-configure
در صورت عدم بروز خطا مقدار 0 را برمی‌گرداند.

.SH "نویسنده (AUTHOR)"
Manfred Wassmann <\fImanolo@NCC-1701.B.Shuttle.de\fR> برای پروژه foomatic با استفاده از یادداشت‌های موجود در سورس کد.

.SH "اشکالات (BUGS)"
در حال حاضر \fBfoomatic-configure\fR نمی‌تواند پرونده‌های printcap در سبک \fBlprng\fR را پردازش کند. از آنجا که \fBlprng\fR می‌تواند از printcapهای سبک BSD استفاده کند، تا زمانی که از مدیر چاپ گرافیکی \fBlprngtool\fR استفاده نشود، این موضوع مشکل بزرگی ایجاد نمی‌کند.
تفاوت این دو قالب در این است که سبک BSD ایجاب می‌کند خطوط ادامه در تعاریف چاپگر با یک دونقطه پایان یابند و کاراکتر خط جدید با یک بک‌اسلش اسکیپ شود. در \fBLprng\fR چنین محدودیتی وجود ندارد.
.PP
برای استفاده از یک فایل printcap تولید یا ویرایش‌شده با \fBlprngtool\fR همراه با \fBfoomatic-configure\fR، لازم است \fB:\\\fR به انتهای تمام خطوط هر تعریف چاپگر (به جز خط پایانی) اضافه شود، همان‌طور که در زیر نشان داده شده است:
.nf
.sp
.ft CW
#comment
# primary printer name
lp
#alternate names
 |lp2|lp3
 |Example of a printer
 :sd=/usr/spool/LPD/lp
 :rw:lp=/dev/lp:mx#100
 :
.sp
.fi
.LP
باید تبدیل شود به:
.nf
.sp
.ft CW
#comment
# primary printer name
lp\\
 |lp2|lp3\\
 |Example of a printer\\
 :sd=/usr/spool/LPD/lp:\\
 :rw:lp=/dev/lp:mx#100:
.sp
.fi
.LP
این صفحه راهنما ممکن است قدیمی باشد.