ipptool(1) · macOS Kılavuz Sayfası

İsim

ipptool - internet yazdırma protokolü (IPP) isteklerini gerçekleştirir

Sinopsis

       ipptool [ --help ] [ --ippserver dosya_adı ] [ --stop-after-include-error ] [ --version ] [ -4
       ] [ -6 ] [ -C ] [ -E ] [ -I ] [ -L ] [ -P dosya_adı.plist ] [ -S ] [ -T saniye ] [ -V sürüm
       ] [ -X ] [ -c ] [ -d ad=değer ] [ -f dosya_adı ] [ -h ] [ -i saniye ] [ -n tekrar_sayısı ] [
       -q ] [ -t ] [ -v ] yazıcı_adresi test_dosyası [ ...  test_dosyası ]

Açıklama

ipptool, belirtilen yazıcı_adresi (printer-uri) değerine IPP istekleri gönderir ve sonuçları test eder ve/veya görüntüler. Belirtilen her bir test_dosyası (testfile); beklenen yanıt durumu, öznitelikler ve değerler dahil olmak üzere bir veya daha fazla isteği tanımlar. Çıktı, standart çıktı üzerinde düz metin, biçimlendirilmiş metin, CSV veya XML raporu biçimindedir ve sıfır olmayan bir çıkış durumu, bir veya daha fazla testin başarısız olduğunu gösterir. test_dosyası biçimi ipptoolfile(5) kılavuz sayfasında açıklanmıştır.

Seçenekler

ipptool by aşağıdaki seçenekler tanınır:

--help Program yardımını gösterir.

--ippserver dosya_adı Test sonuçlarının belirtilen ippserver öznitelik dosyasına yazılması gerektiğini belirtir.

--stop-after-include-error Dahil edilen bir dosyada hata oluşursa ipptool'a durmasını söyler. Normalde ipptool, INCLUDE direktifinden sonraki testlerle devam eder.

--version Kullanılmakta olan ipptool sürümünü gösterir.

-4: ipptool'un yazıcıya veya sunucuya IPv4 kullanarak bağlanması gerektiğini belirtir.
-6: ipptool'un yazıcıya veya sunucuya IPv6 kullanarak bağlanması gerektiğini belirtir.
-C: İsteklerin, tüm IPP sürümleri tarafından uyumluluk için gerekli olan HTTP/1.1 "Transfer-Encoding: chunked" başlığı kullanılarak gönderilmesi gerektiğini belirtir. Varsayılan davranış, ekli dosyaları olan istekler için "Transfer-Encoding: chunked" ve ekli dosyaları olmayan istekler için "Content-Length:" kullanmaktır.
-E: HTTP "Upgrade" başlığını kullanarak sunucuya bağlanırken TLS şifrelemesini zorunlu kılar.
-I: ipptool'un hataları geçerek devam edeceğini belirtir.
-L: İsteklerin, tüm IPP sürümleri tarafından uyumluluk için gerekli olan HTTP/1.0 "Content-Length:" başlığı kullanılarak gönderilmesi gerektiğini belirtir. Varsayılan davranış, ekli dosyaları olan istekler için "Transfer-Encoding: chunked" ve ekli dosyaları olmayan istekler için "Content-Length:" kullanmaktır.

-P dosya_adı.plist Test sonuçlarının, normal test raporuna (-t) ek olarak belirtilen XML (Apple plist) dosyasına yazılması gerektiğini belirtir. Bu seçenek -i (aralık) ve -n (tekrar_sayısı) seçenekleriyle uyumsuzdur.

-S: Sunucuya bağlanırken (özel) TLS şifrelemesini zorunlu kılar.

-T saniye Saniye cinsinden IPP istekleri için bir zaman aşımı belirtir.

-V sürüm Kullanılacak varsayılan IPP sürümünü belirtir: 1.0, 1.1, 2.0, 2.1 veya 2.2. Belirtilmezse sürüm 1.1 kullanılır.

-X: Düz metin raporu yerine XML (Apple plist) çıktısının istendiğini belirtir. Bu seçenek -i (aralık) ve -n (tekrar_sayısı) seçenekleriyle uyumsuzdur.
-c: Düz metin çıktısı yerine CSV (virgülle ayrılmış değerler) çıktısının istendiğini belirtir.

-d ad=değer Belirtilen değişkeni tanımlar.

-f dosya_adı Testler için varsayılan istek dosya adını tanımlar.

-h: HTTP yanıt başlıklarını doğrular.

-i saniye (Son) test_dosyasının belirtilen aralıklarla tekrarlanması gerektiğini belirtir. Bu seçenek -X (XML plist çıktısı) seçeneğiyle uyumsuzdur.

-l: Düz metin çıktısının istendiğini belirtir.

-n tekrar_sayısı (Son) test_dosyasının belirtilen sayıda tekrarlanması gerektiğini belirtir. Bu seçenek -X (XML plist çıktısı) seçeneğiyle uyumsuzdur.

-q: Sessiz modda çalışır ve çıktı üretmez.
-t: Düz metin çıktısı yerine CUPS test raporu çıktısının istendiğini belirtir.
-v: Tüm istek ve yanıt özniteliklerinin CUPS test modunda (-t) çıktıya yazılması gerektiğini belirtir. XML çıktısı için varsayılan davranış budur.

Çıkış Durumu

ipptool programı, tüm testler başarılı olduysa 0, aksi takdirde 1 değerini döndürür.

Dosyalar

Aşağıdaki standart dosyalar mevcuttur: color.jpg create-printer-subscription.test document-a4.pdf document-a4.ps document-letter.pdf document-letter.ps get-completed-jobs.test get-jobs.test get-notifications.test get-printer-attributes.test get-subscriptions.test gray.jpg ipp-1.1.test ipp-2.0.test ipp-2.1.test ipp-2.2.test ipp-everywhere.test onepage-a4.pdf onepage-a4.ps onepage-letter.pdf onepage-letter.ps print-job.test print-job-deflate.test print-job-gzip.test testfile.jpg testfile.pcl testfile.pdf testfile.ps testfile.txt validate-job.test

Uyumluluk Gösterdiği Standartlar

ipptool programı CUPS'a özgüdür ve sürüm 2.2'ye kadar Internet Printing Protocol standardına uygundur.

Örnekler

       "myprinter" için tamamlanan işlerin listesini alın:

	   ipptool ipp://localhost/printers/myprinter get-completed-jobs.test

       "myprinter" değiştiğinde "user@example.com" adresine e-posta bildirimleri gönderin:

	   ipptool -d recipient=mailto:user@example.com \
	       ipp://localhost/printers/myprinter create-printer-subscription.test

Ayrıca Bakınız

ipptoolfile(5), IANA IPP Registry (http://www.iana.org/assignments/ipp-registrations), PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp) RFC 8011 (http://tools.ietf.org/html/rfc8011),

Telif Hakkı

26 April 2019 CUPS ipptool(1)