.\"
.\" ippfind man page.
.\"
.\" Copyright © 2021-2022 by OpenPrinting.
.\" Copyright © 2013-2019 by Apple Inc.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ippfind 1 ippsample 2021\-02\-28 OpenPrinting
.SH NOME
ippfind \- encontra impressoras de protocolo de impressão da internet
.SH RESUMO
\fBippfind\fP [ \fIoptions\fP ] \fIregtype\fP[\fB,\fP\fIsubtype\fP][\fB.\fP\fIdomain\fP\fB.\fP]
\&... [ \fIexpression\fP ... ]
.br
\fBippfind\fP [ \fIoptions\fP ] \fIname\fP[\fB.\fP\fIregtype\fP[\fB.\fP\fIdomain\fP\fB.\fP]] ... [
\fIexpression\fP ... ]
.br
\fBippfind\fP \fB\-\-help\fP
.br
\fBippfind\fP \fB\-\-version\fP
.SH DESCRIÇÃO
\fBippfind\fP encontra serviços registrados com um servidor DNS ou disponíveis
através de dispositivos locais. O seu principal objectivo é encontrar
impressoras IPP e mostrar os seus URIs, mostrar os seus estados actuais, ou
correr comandos.
.SS "TIPOS DE REGISTRO"
\fBippfind\fP suporta os seguintes tipos de inscrição:
.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 EXPRESSÕES
\fBippfind\fP suporta expressões muito como o utilitário \fBfind\fP(1) faz. No
entanto, ao contrário do \fBfind\fP(1), o \fBippfind\fP usa expressões regulares
POSIX em vez de padrões de correspondência de nome de ficheiro em shell. Se
\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, ou \fI\-x\fP não forem especificados, o \fBippfind\fP adiciona
\fI\-\-print\fP par escrever o URI do serviço de qualquer coisa que encontre. As
seguintes expressões são suportadas:
.TP  5
\fB\-d \fP\fIregex\fP
.TP  5
\fB\-\-domain \fP\fIregex\fP
Verdadeiro se o domínio corresponder à expressão regular fornecida.
.TP  5
\fB\-\-false\fP
Sempre falso.
.TP  5
\fB\-h \fP\fIregex\fP
.TP  5
\fB\-\-host \fP\fIregex\fP
Verdadeiro se o nome de máquina corresponder à expressão regular fornecida.
.TP  5
\fB\-l\fP
.TP  5
\fB\-\-ls\fP
Lista os atributos retornados por Get\-Printer\-Attributes para impressoras
IPP e saída tradicional de \fIfind\fP "\-ls" para URLs de HTTP. O resultado é
verdadeiro se o URI for acessível, e falso caso contrário.
.TP  5
\fB\-\-local\fP
Verdadeiro se o serviço for local para este computador.
.TP  5
\fB\-N \fP\fIname\fP
.TP  5
\fB\-\-literal\-name \fP\fIname\fP
Verdadeiro se o nome de instância de serviço corresponder ao nome fornecido.
.TP  5
\fB\-n \fP\fIregex\fP
.TP  5
\fB\-\-name \fP\fIregex\fP
Verdadeiro se o nome de instância de serviço corresponder à expressão
regular fornecida.
.TP  5
\fB\-\-path \fP\fIregex\fP
Verdadeiro se o caminho de recurso de URI corresponder à expressão regular
fornecida.
.TP  5
\fB\-P \fP\fInumber\fP[\fB\-\fP\fInumber\fP]
.TP  5
\fB\-\-port \fP\fInumber\fP[\fB\-\fP\fInumber\fP]
Verdadeiro se o porto corresponder ao número ou alcance fornecido.
.TP  5
\fB\-p\fP
.TP  5
\fB\-\-print\fP
Escreve o URI se o resultado das expressões anteriores for verdadeiro. O
resultado é sempre verdadeiro.
.TP  5
\fB\-q\fP
.TP  5
\fB\-\-quiet\fP
Modo silêncio \- apenas retorna os códigos de saída em baixo.
.TP  5
\fB\-r\fP
.TP  5
\fB\-\-remote\fP
Verdadeiro se o serviço não for local para este computador.
.TP  5
\fB\-s\fP
.TP  5
\fB\-\-print\-name\fP
Escreve o nome de instância de serviço se o resultado das expressões
anteriores for verdadeiro. O resultado é sempre verdadeiro.
.TP  5
\fB\-\-true\fP
Sempre verdadeiro.
.TP  5
\fB\-t \fP\fIkey\fP
.TP  5
\fB\-\-txt \fP\fIkey\fP
Verdadeiro se o registro TXT conter a chave nomeada.
.TP  5
\fB\-\-txt\-\fP\fIkey regex\fP
Verdadeiro se o registro TXT conter a chave nomeada e corresponder à
expressão regular fornecida.
.TP  5
\fB\-u \fP\fIregex\fP
.TP  5
\fB\-\-uri \fP\fIregex\fP
Verdadeiro se o URI corresponder à expressão regular fornecida.
.TP  5
\fB\-x \fP\fIutility \fP[ \fIargument \fP... ] \fB;\fP
.TP  5
\fB\-\-exec \fP\fIutility \fP[ \fIargument \fP... ] \fB;\fP
Executa o programa especificado se o resultado actual for verdadeiro. Os
argumentos de "{foo}" são substituídos pelos valores correspondentes \- veja
SUBSTITUIÇÕES em baixo.
.PP
As expressões também podem conter modificadores:
.TP  5
\fB( \fP\fIexpression \fP\fB)\fP
Agrupa o resultado das expressões.
.TP  5
\fB! \fP\fIexpression\fP
.TP  5
\fB\-\-not \fP\fIexpression\fP
Unário NÃO (NOT) da expressão.
.TP  5
\fIexpression expression\fP
.TP  5
\fIexpression \fP\fB\-\-and \fP\fIexpression\fP
E (AND) lógico das expressões.
.TP  5
\fIexpression \fP\fB\-\-or \fP\fIexpression\fP
OU (OR) lógico das expressões.
.SS SUBSTITUIÇÕES
As substituições para "{foo}" em \fI\-e\fP e \fI\-\-exec\fP são:
.TP  5
\fB{service_domain}\fP
Nome de domínio, ex., "example.com.", "local.", etc.
.TP  5
\fB{service_hostname}\fP
Nome de domínio totalmente qualificado, ex., "printer.example.com.",
"printer.local.", etc.
.TP  5
\fB{service_name}\fP
Nome de instância de serviço, ex., "My Fine Printer".
.TP  5
\fB{service_port}\fP
Número de porto para o servidor, tipicamente 631 para IPP e 80 para HTTP.
.TP  5
\fB{service_regtype}\fP
Tipo de registro DNS\-SD, ex., "_ipp._tcp", "_http._tcp", etc.
.TP  5
\fB{service_scheme}\fP
Esquema de URI para tipo de registro DNS\-SD, ex., "ipp", "http", etc.
.TP  5
\fB{}\fP
.TP  5
\fB{service_uri}\fP
URI para serviço, ex., "ipp://printer.local./ipp/print",
"http://printer.local./", etc.
.TP  5
\fB{txt_\fP\fIkey\fP\fB}\fP
Valor da \fIkey\fP de registo TXT (minúsculas).
.SH OPÇÕES
\fBippfind\fP suporta as seguintes opções:
.TP  5
\fB\-\-help\fP
Mostra a ajuda do programa.
.TP  5
\fB\-\-version\fP
Mostra a versão do programa.
.TP  5
\fB\-4\fP
Usa IPv4 ao listar.
.TP  5
\fB\-6\fP
Usa IPv6 ao listar.
.TP  5
\fB\-T \fP\fIseconds\fP
Especifica o tempo limite de procura em segundos. Se 1 ou menos, o
\fBippfind\fP pára assim que pensa já ter encontrado tudo. O tempo limite
predefinido é 1 segundo.
.TP  5
\fB\-V \fP\fIversion\fP
Especifica a versão de IPP ao listar. Os valores suportados são "1.1",
"2.0", "2.1", e "2.2".
.SH "ESTADO DE SAÍDA"
\fBippfind\fP retorna 0 se o resultado de todas as expressões processadas for
verdadeiro, 1 se o resultado de qualquer uma das expressões processadas for
falso, 2 se falhar ao navegar, em qualquer consulta ou resolução, 3 se for
especificada uma opção não definida ou expressão inválida, e 4 se esgotar a
memória.
.SH AMBIENTE
Quando executa um programa, o \fBippfind\fP define as seguintes variáveis de
ambiente para o registrar do serviço correspondente.
.TP  5
\fBIPPFIND_SERVICE_DOMAIN\fP
Nome de domínio, ex., "example.com.", "local.", etc.
.TP  5
\fBIPPFIND_SERVICE_HOSTNAME\fP
Nome de domínio totalmente qualificado, ex., "printer.example.com.",
"printer.local.", etc.
.TP  5
\fBIPPFIND_SERVICE_NAME\fP
Nome de instância de serviço, ex., "My Fine Printer".
.TP  5
\fBIPPFIND_SERVICE_PORT\fP
Número de porto para o servidor, tipicamente 631 para IPP e 80 para HTTP.
.TP  5
\fBIPPFIND_SERVICE_REGTYPE\fP
Tipo de registro DNS\-SD, ex., "_ipp._tcp", "_http._tcp", etc.
.TP  5
\fBIPPFIND_SERVICE_SCHEME\fP
Esquema de URI para tipo de registro DNS\-SD, ex., "ipp", "http", etc.
.TP  5
\fBIPPFIND_SERVICE_URI\fP
URI para serviço, ex., "ipp://printer.local./ipp/print",
"http://printer.local./", etc.
.TP  5
\fBIPPFIND_TXT_\fP\fIKEY\fP
Valores da \fIKEY\fP de registo TXT (maiúsculas).
.SH EXEMPLOS
Para mostrar o estado de todas as impressoras IPP registadas na sua rede,
corra:
.nf

    ippfind \-\-ls

.fi
De modo semelhante, para enviar uma página de teste PostScript para todas as
impressoras PostScript, corra:
.nf

    ippfind \-\-txt\-pdl application/postscript \-\-exec ipptool
      \-f onepage\-letter.ps '{}' print\-job.test \e;
.fi
.SH "VEJA TAMBÉM"
\fBipptool\fP(1)
.SH COPYRIGHT
Copyright \[co] 2021\-2022 de OpenPrinting.