.\"
.\" ippfind man page for CUPS.
.\"
.\" Copyright © 2013-2018 by Apple Inc.
.\"
.\" These coded instructions, statements, and computer programs are the
.\" property of Apple Inc. and are protected by Federal copyright
.\" law.  Distribution and use rights are outlined in the file "LICENSE.txt"
.\" which should have been included with this file.  If this file is
.\" file is missing or damaged, see the license at "http://www.cups.org/".
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ippfind 1 CUPS "14. Februar 2018" "Apple Inc."
.SH NAME
ippfind \- Internet\-Printing\-Protocol\-Drucker finden
.SH SYNOPSIS
\fBippfind\fP [ \fIOptionen\fP ] \fIRegtyp\fP[\fB,\fP\fIUntertyp\fP][\fB.\fP\fIDomain\fP\fB.\fP] … [
\fIAusdruck\fP … ]
.br
\fBippfind\fP [ \fIOptionen\fP ] \fIName\fP[\fB.\fP\fIRegtyp\fP[\fB.\fP\fIDomain\fP\fB.\fP]] … [
\fIAusdruck\fP … ]
.br
\fBippfind\fP \fB\-\-help\fP
.br
\fBippfind\fP \fB\-\-version\fP
.SH BESCHREIBUNG
\fBippfind\fP findet Dienste, die bei einem DNS\-Server registriert oder über
lokale Geräte verfügbar sind. Sein Hauptzweck ist das Auffinden von
IPP\-Druckern und Anzeigen ihrer URIs, der Anzeige ihres aktuellen Status
oder dem Ausführen von Befehlen.
.SS REGISTRIERUNGSTYPEN
\fBippfind\fP unterstützt die folgenden Registrierungstypen:
.TP  5
_http._tcp
HyperText Transport Protocol (HTTP, RFC 2616)
.TP  5
_https._tcp
Secure HyperText Transport Protocol (HTTPS, RFC 2818)
.TP  5
_ipp._tcp
Internet Printing Protocol (IPP, RFC 2911)
.TP  5
_ipps._tcp
Secure Internet Printing Protocol (IPPS, draft)
.TP  5
_printer._tcp
Line Printer Daemon (LPD, RFC 1179)
.SS AUSDRÜCKE
\fBippfind\fP unterstützt ähnlich wie das Hilfswerkzeug \fBfind\fP(1) reguläre
Ausdrücke. Anders als \fBfind\fP(1) verwendet \fBippfind\fP allerdings
POSIX\-reguläre\-Ausdrücke statt die Dateinamen\-Platzhalter\-Muster der
Shell. Falls \fI\-\-exec\fP, \fI\-l\fP, \fI\-\-ls\fP, \fI\-p\fP, \fI\-\-print\fP, \fI\-\-print\-name\fP,
\fI\-q\fP, \fI\-\-quiet\fP, \fI\-s\fP oder \fI\-x\fP nicht angegeben ist wird \fBippfind\fP
\fI\-\-print\fP hinzufügen, um die Dienste\-URIs aller Treffer auszugeben. Die
folgenden Ausdrücke werden unterstützt:
.TP  5
\fB\-d \fP\fIRegAus\fP
.TP  5
\fB\-\-domain \fP\fIRegAus\fP
Wahr, falls die Domain auf den übergebenen regulären Ausdruck passt.
.TP  5
\fB\-\-false\fP
Immer unwahr.
.TP  5
\fB\-h \fP\fIRegAus\fP
.TP  5
\fB\-\-host \fP\fIRegAus\fP
Wahr, falls der Rechnername auf den übergebenen regulären Ausdruck passt.
.TP  5
\fB\-l\fP
.TP  5
\fB\-\-ls\fP
Listet Attribute auf, die von Get\-Printer\-Attributes für IPP\-Drucker und von
traditionellen »\fIfind\fP "\-ls"«\-Ausgaben für HTTP\-URLs zurückgeliefert
werden. Das Ergebnis ist wahr, falls auf die URI zugegriffen werden kann,
andernfalls unwahr.
.TP  5
\fB\-\-local\fP
Wahr, falls der Dienst an diesem Computer lokal ist.
.TP  5
\fB\-N \fP\fIName\fP
.TP  5
\fB\-\-literal\-name \fP\fIName\fP
Wahr, falls der Name der Instanz des Dienstes auf den angegebenen
Namenpasst.
.TP  5
\fB\-n \fP\fIRegAus\fP
.TP  5
\fB\-\-name \fP\fIRegAus\fP
Wahr, falls die Instanz des Dienstes auf den angegebenen regulären Ausdruck
passt.
.TP  5
\fB\-\-path \fP\fIRegAus\fP
Wahr, falls der URI\-Ressourcenpfad auf den angegebenen regulären Ausdruck
passt.
.TP  5
\fB\-P \fP\fINummer\fP[\fB\-\fP\fINummer\fP]
.TP  5
\fB\-\-port \fP\fINummer\fP[\fB\-\fP\fINummer\fP]
Wahr, falls der Port auf die angegebene Nummer oder den Bereich passt.
.TP  5
\fB\-p\fP
.TP  5
\fB\-\-print\fP
Gibt die URI aus, falls das Ergebnis der vorherigen Ausdrücke wahr ist. Das
Ergebnis ist immer wahr.
.TP  5
\fB\-q\fP
.TP  5
\fB\-\-quiet\fP
Stiller Modus \- liefert nur die unten aufgeführten Exit\-Codes zurück.
.TP  5
\fB\-r\fP
.TP  5
\fB\-\-remote\fP
Wahr, falls der Dienst nicht lokal am Computer ist.
.TP  5
\fB\-s\fP
.TP  5
\fB\-\-print\-name\fP
Gibt den Namen der Diensteinstanz aus, falls das Ergebnis des vorherigen
Ausdrucks wahr ist. Das Ergebnis ist immer wahr.
.TP  5
\fB\-\-true\fP
Immer wahr.
.TP  5
\fB\-t \fP\fISchlüssel\fP
.TP  5
\fB\-\-txt \fP\fISchlüssel\fP
Wahr, falls der TXT\-Datensatz den benannten Schlüssel enthält.
.TP  5
\fB\-\-txt\-\fP\fIkey RegAus\fP
Wahr, falls der TXT\-Datensatz den benannten Schlüssel enthält und auf den
angegebenen regulären Ausdruck passt.
.TP  5
\fB\-u \fP\fIRegAus\fP
.TP  5
\fB\-\-uri \fP\fIRegAus\fP
Wahr, falls die URI auf den angegebenen regulären Ausdruck passt.
.TP  5
\fB\-x \fP\fIHilfsprogramm \fP[ \fIArgument \fP… ] \fB;\fP
.TP  5
\fB\-\-exec \fP\fIHilfsprogramm \fP[ \fIArgument \fP… ] \fB;\fP
Führt das angegebene Programm aus, falls das aktuelle Ergebnis wahr
ist. »{foo}«\-Argumente werden durch den entsprechenden Wert ersetzt \-\- siehe
ERSETZUNGEN weiter unten.
.PP
Ausdrücke können auch Modifikatoren enthalten:
.TP  5
\fB( \fP\fIAusdruck \fP\fB)\fP
Gruppiert die Ergebnisse von Ausdrücken.
.TP  5
\fB! \fP\fIAusdruck\fP
.TP  5
\fB\-\-not \fP\fIAusdruck\fP
Unäres NICHT des Ausdrucks.
.TP  5
\fIAusdruck Ausdruck\fP
.TP  5
\fIAusdruck \fP\fB\-\-and \fP\fIAusdruck\fP
Logisches UND von Ausdrücken.
.TP  5
\fIAusdruck \fP\fB\-\-or \fP\fIAusdruck\fP
Logisches ODER von Ausdrücken.
.SS ERSETZUNGEN
Die Ersetzungen für »{foo}« in \fI\-e\fP und \fI\-\-exec\fP sind:
.TP  5
\fB{service_domain}\fP
Domain\-Name, z.B. »example.com.«, »local.«, usw.
.TP  5
\fB{service_hostname}\fP
Vollqualifizierter Domain\-Name, z.B. »printer.example.com.«,
»printer.local.«, usw.
.TP  5
\fB{service_name}\fP
Dienste\-Instanzenname, z.B. »Mein Guter Drucker«.
.TP  5
\fB{service_port}\fP
Port\-Nummer für Server, typischerweise 631 für IPP und 80 für HTTP.
.TP  5
\fB{service_regtype}\fP
DNS\-SD\-Registrierungstyp, z.B. »_ipp._tcp«, »_http._tcp« usw.
.TP  5
\fB{service_scheme}\fP
URI\-Schema für DNS\-SD\-Registrationstypen, z.B: »ipp«, »http« usw.
.TP  5
\fB{}\fP
.TP  5
\fB{service_uri}\fP
URI für Dienste, z.B. »ipp://printer.local./ipp/print«,
»http://printer.local./« usw.
.TP  5
\fB{txt_\fP\fISchlüssel\fP\fB}\fP
Wert des TXT\-Datensatz\-\fISchlüssel\fPs (klein geschrieben)
.SH OPTIONEN
\fIippfind\fP unterstützt die folgenden Optionen:
.TP  5
\fB\-\-help\fP
Zeigt die Programmhilfe.
.TP  5
\fB\-\-version\fP
Zeigt die Programmversion.
.TP  5
\fB\-4\fP
IPv4 beim Warten auf Anfragen verwenden.
.TP  5
\fB\-6\fP
IPv6 beim Warten auf Anfragen verwenden.
.TP  5
\fB\-T \fP\fISekunden\fP
Legt die Zeitüberschreitung beim Suchen fest (in Sekunden). Falls 1 oder
weniger wird \fBippfind\fP aufhören, sobald es glaubt, alles gefunden zu
haben. Die Vorgabezeitüberschreitung ist eine Sekunde.
.TP  5
\fB\-V \fP\fIVersion\fP
Legt die IPP\-Version beim Warten auf Anfragen fest. Unterstützte Werte sind
»1.1«, »2.0«, »2.1« und »2.2«.
.SH EXIT\-STATUS
\fBippfind\fP liefert 0 zurück, falls das Ergebnis für alle verarbeiteten
Ausdrücke wahr ist, 1, falls das Ergebnis irgendeines Ausdruckes falsch ist,
2, falls das Browsen oder irgendeine Abfrage oder Auflösung fehlschlug, 3,
falls eine nicht definierte Option oder ein ungültiger Ausdruck angegeben
wurde oder 4, falls nicht genug Speicher vorhanden war.
.SH UMGEBUNG
Beim Ausführen eines Programms setzt \fBippfind\fP die folgenden
Umgebungsvariablen für die passende Diensteregistrierung:
.TP  5
\fBIPPFIND_SERVICE_DOMAIN\fP
Domain\-Name, z.B. »example.com.«, »local.«, usw.
.TP  5
\fBIPPFIND_SERVICE_HOSTNAME\fP
Vollqualifizierter Domain\-Name, z.B. »printer.example.com.«,
»printer.local.«, usw.
.TP  5
\fBIPPFIND_SERVICE_NAME\fP
Dienste\-Instanzenname, z.B. »Mein Guter Drucker«.
.TP  5
\fBIPPFIND_SERVICE_PORT\fP
Port\-Nummer für Server, typischerweise 631 für IPP und 80 für HTTP.
.TP  5
\fBIPPFIND_SERVICE_REGTYPE\fP
DNS\-SD\-Registrierungstyp, z.B. »_ipp._tcp«, »_http._tcp« usw.
.TP  5
\fBIPPFIND_SERVICE_SCHEME\fP
URI\-Schema für DNS\-SD\-Registrationstypen, z.B: »ipp«, »http« usw.
.TP  5
\fBIPPFIND_SERVICE_URI\fP
URI für Dienste, z.B. »ipp://printer.local./ipp/print«,
»http://printer.local./« usw.
.TP  5
\fBIPPFIND_TXT_\fP\fISCHLÜSSEL\fP
Wert des TXT\-Datensatz\-\fISCHLÜSSEL\fPs (groß geschrieben)
.SH BEISPIELE
Um den Status aller registrierten IPP\-Drucker in Ihrem Netz anzuzeigen,
führen Sie folgendes aus:
.nf

    ippfind \-\-ls

.fi
Um eine PostScript\-Testseite an jeden PostScript\-Drucker zu senden, führen
Sie aus:
.nf

    ippfind \-\-txt\-pdl application/postscript \-\-exec ipptool
      \-f onepage\-letter.ps '{}' print\-job.test \e;
.fi
.SH "SIEHE AUCH"
\fBipptool\fP(1)
.SH COPYRIGHT
Copyright \[co] 2013\-2018 by Apple Inc.