ippfind(1)                       OpenPrinting                       ippfind(1)

نام (NAME)
       ippfind - یافتن چاپگرهای پروتکل چاپ اینترنتی

خلاصه دستور (SYNOPSIS)
       ippfind [ options ] regtype[,subtype][.domain.] ... [ expression
        ... ]
       ippfind [ options ] name[.regtype[.domain.]] ... [ expression
        ... ]
       ippfind --help
       ippfind --version

توضیحات (DESCRIPTION)
       دستور ippfind سرویس‌های ثبت‌شده در یک کارساز DNS یا موجود از طریق
       دستگاه‌های محلی را پیدا می‌کند.  هدف اصلی آن یافتن چاپگرهای IPP و نمایش
       URIهای آن‌ها، نمایش وضعیت فعلی آن‌ها، یا اجرای دستورات است.

   انواع ثبت (REGISTRATION TYPES)
       دستور ippfind از انواع ثبت زیر پشتیبانی می‌کند:

       _http._tcp
            پروتکل انتقال ابرمتن (HTTP, RFC 2616)

       _https._tcp
            پروتکل امن انتقال ابرمتن (HTTPS, RFC 2818)

       _ipp._tcp
            پروتکل چاپ اینترنتی (IPP, RFC 2911)

       _ipps._tcp
            پروتکل امن چاپ اینترنتی (IPPS, پیش‌نویس)

       _printer._tcp
            دیمن چاپگر خطی (LPD, RFC 1179)

   عبارت‌ها (EXPRESSIONS)
       دستور ippfind از عبارت‌هایی بسیار شبیه به ابزار find(1) پشتیبانی می‌کند.
       با این حال، برخلاف find(1)، دستور ippfind به جای الگوهای تطبیق نام فایل
       پوسته از عبارت‌های منظم POSIX استفاده می‌کند.  اگر هیچ‌یک از موارد --exec،
       -l، --ls، -p، --print، --print-name، -q، --quiet، -s یا -x مشخص نشده
       باشد، ippfind گزینه --print را برای چاپ URI سرویس هر آنچه پیدا می‌کند
       اضافه می‌کند.  عبارت‌های زیر پشتیبانی می‌شوند:

       -d regex

       --domain regex
            درست است اگر دامنه با عبارت منظم مشخص‌شده مطابقت داشته باشد.

       --false
            همیشه نادرست است.

       -h regex

       --host regex
            درست است اگر نام میزبان با عبارت منظم مشخص‌شده مطابقت داشته باشد.

       -l

       --ls صفات برگردانده‌شده توسط Get-Printer-Attributes را برای چاپگرهای IPP
            و خروجی سنتی "-ls" ابزار find را برای نشانی‌های اینترنتی HTTP فهرست
            می‌کند.  در صورت در دسترس بودن URI، نتیجه درست است و در غیر این
            صورت نادرست خواهد بود.

       --local
            درست است اگر سرویس برای این رایانه محلی باشد.

       -N name

       --literal-name name
            درست است اگر نام نمونه سرویس با نام مشخص‌شده مطابقت داشته باشد.

       -n regex

       --name regex
            درست است اگر نام نمونه سرویس با عبارت منظم مشخص‌شده مطابقت داشته
            باشد.

       --path regex
            درست است اگر مسیر منبع URI با عبارت منظم مشخص‌شده مطابقت داشته
            باشد.

       -P number[-number]

       --port number[-number]
            درست است اگر درگاه با شماره یا محدوده داده‌شده مطابقت داشته باشد.

       -p

       --print
            اگر نتیجه عبارت‌های قبلی درست باشد، URI را چاپ می‌کند.  نتیجه همیشه
            درست است.

       -q

       --quiet
            حالت بی‌صدا - فقط کدهای خروج زیر را بازمی‌گرداند.

       -r

       --remote
            درست است اگر سرویس برای این رایانه محلی نباشد.

       -s

       --print-name
            اگر نتیجه عبارت‌های قبلی درست باشد، نام نمونه سرویس را چاپ می‌کند.
            نتیجه همیشه درست است.

       --true
            همیشه درست است.

       -t key

       --txt key
            درست است اگر رکورد TXT شامل کلید نام‌برده باشد.

       --txt-key regex
            درست است اگر رکورد TXT شامل کلید نام‌برده باشد و با عبارت منظم
            مشخص‌شده مطابقت داشته باشد.

       -u regex

       --uri regex
            درست است اگر URI با عبارت منظم مشخص‌شده مطابقت داشته باشد.

       -x utility [ argument ... ] ;

       --exec utility [ argument ... ] ;
            اگر نتیجه فعلی درست باشد، برنامه مشخص‌شده را اجرا می‌کند.
            آرگومان‌های "{foo}" با مقدار متناظر جایگزین می‌شوند - بخش
            «جایگزینی‌ها» را در زیر ببینید.

       عبارت‌ها همچنین می‌توانند شامل اصلاح‌کننده‌ها باشند:

       ( expression )
            گروه‌بندی نتیجه عبارت‌ها.

       ! expression

       --not expression
            نقیض (NOT) یکانی عبارت.

       expression expression

       expression --and expression
            عطف منطقی (AND) عبارت‌ها.

       expression --or expression
            فصل منطقی (OR) عبارت‌ها.

   جایگزینی‌ها (SUBSTITUTIONS)
       موارد جایگزین برای "{foo}" در -e و --exec عبارتند از:

       {service_domain}
            نام دامنه، برای مثال "example.com."، "local." و غیره.

       {service_hostname}
            نام دامنه کاملاً واجد شرایط، برای مثال "printer.example.com."،
            "printer.local." و غیره.

       {service_name}
            نام نمونه سرویس، برای مثال "My Fine Printer".

       {service_port}
            شماره درگاه برای کارساز، معمولاً ۶۳۱ برای IPP و ۸۰ برای HTTP.

       {service_regtype}
            نوع ثبت DNS-SD، برای مثال "_ipp._tcp"، "_http._tcp" و غیره.

       {service_scheme}
            طرحواره (scheme) URI برای نوع ثبت DNS-SD، برای مثال "ipp"، "http"
            و غیره.

       {}

       {service_uri}
            نشانی URI برای سرویس، برای مثال "ipp://printer.local./ipp/print"،
            "http://printer.local./" و غیره.

       {txt_key}
            مقدار کلید key در رکورد TXT (با حروف کوچک).

گزینه‌ها (OPTIONS)
       دستور ippfind از گزینه‌های زیر پشتیبانی می‌کند:

       --help
            نمایش راهنمای برنامه.

       --version
            نمایش نسخه برنامه.

       -4   استفاده از IPv4 هنگام فهرست‌کردن.

       -6   استفاده از IPv6 هنگام فهرست‌کردن.

       -T seconds
            مشخص کردن زمان انتظار جستجو بر حسب ثانیه.  اگر ۱ یا کمتر باشد،
            ippfind به محض اینکه فرض کند همه چیز را پیدا کرده است متوقف می‌شود.
            زمان انتظار پیش‌فرض ۱ ثانیه است.

       -V version
            نسخه IPP را هنگام فهرست کردن مشخص می‌کند.  مقادیر پشتیبانی‌شده
            عبارتند از "1.1"، "2.0"، "2.1" و "2.2".

وضعیت خروج (EXIT STATUS)
       دستور ippfind اگر نتیجه برای تمام عبارت‌های پردازش‌شده درست باشد مقدار 0،
       اگر نتیجه هر یک از عبارت‌های پردازش‌شده نادرست باشد مقدار 1، اگر مرور یا
       هر پرس‌وجو یا حل آدرس شکست بخورد مقدار 2، اگر یک گزینه تعریف‌نشده یا
       عبارت نامعتبر مشخص شده باشد مقدار 3، و اگر حافظه تمام شود مقدار 4 را
       برمی‌گرداند.

محیط (ENVIRONMENT)
       هنگام اجرای یک برنامه، ippfind متغیرهای محیطی زیر را برای ثبت سرویس
       منطبق تنظیم می‌کند:

       IPPFIND_SERVICE_DOMAIN
            نام دامنه، برای مثال "example.com."، "local." و غیره.

       IPPFIND_SERVICE_HOSTNAME
            نام دامنه کاملاً واجد شرایط، برای مثال "printer.example.com."،
            "printer.local." و غیره.

       IPPFIND_SERVICE_NAME
            نام نمونه سرویس، برای مثال "My Fine Printer".

       IPPFIND_SERVICE_PORT
            شماره درگاه برای کارساز، معمولاً ۶۳۱ برای IPP و ۸۰ برای HTTP.

       IPPFIND_SERVICE_REGTYPE
            نوع ثبت DNS-SD، برای مثال "_ipp._tcp"، "_http._tcp" و غیره.

       IPPFIND_SERVICE_SCHEME
            طرحواره URI برای نوع ثبت DNS-SD، برای مثال "ipp"، "http" و غیره.

       IPPFIND_SERVICE_URI
            نشانی URI برای سرویس، برای مثال "ipp://printer.local./ipp/print"،
            "http://printer.local./" و غیره.

       IPPFIND_TXT_KEY
            مقادیر کلید KEY در رکورد TXT (با حروف بزرگ).

مثال‌ها (EXAMPLES)
       برای نمایش وضعیت تمام چاپگرهای IPP ثبت‌شده در شبکه خود، اجرا کنید:

           ippfind --ls

       مشابهاً، برای ارسال یک صفحه آزمایشی PostScript به تمام چاپگرهای
       PostScript، اجرا کنید:

           ippfind --txt-pdl application/postscript --exec ipptool
             -f onepage-letter.ps '{}' print-job.test \;

همچنین ببینید (SEE ALSO)
       ipptool(1)

حق نشر (COPYRIGHT)
       Copyright © 2020-2024 by OpenPrinting.

2021-02-28                         ippsample                        ippfind(1)