table of contents
ippfind(1) | OpenPrinting | ippfind(1) |
NOME¶
ippfind - encontra impressoras de protocolo de impressão da internet
RESUMO¶
ippfind [ options ]
regtype[,subtype][.domain.] ... [
expression ... ]
ippfind [ options ]
name[.regtype[.domain.]] ... [
expression ... ]
ippfind --help
ippfind --version
DESCRIÇÃO¶
ippfind 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.
TIPOS DE REGISTRO¶
ippfind suporta os seguintes tipos de inscrição:
- _http._tcp
- HyperText Transport Protocol (HTTP, RFC 2616)
- _https._tcp
- Secure HyperText Transport Protocol (HTTPS, RFC 2818)
- _ipp._tcp
- Internet Printing Protocol (IPP, RFC 2911)
- _ipps._tcp
- Secure Internet Printing Protocol (IPPS, draft)
- _printer._tcp
- Line Printer Daemon (LPD, RFC 1179)
EXPRESSÕES¶
ippfind suporta expressões muito como o utilitário find(1) faz. No entanto, ao contrário do find(1), o ippfind usa expressões regulares POSIX em vez de padrões de correspondência de nome de ficheiro em shell. Se --exec, -l, --ls, -p, --print, --print-name, -q, --quiet, -s, ou -x não forem especificados, o ippfind adiciona --print par escrever o URI do serviço de qualquer coisa que encontre. As seguintes expressões são suportadas:
- -d regex
- --domain regex
- Verdadeiro se o domínio corresponder à expressão regular fornecida.
- --false
- Sempre falso.
- -h regex
- --host regex
- Verdadeiro se o nome de máquina corresponder à expressão regular fornecida.
- -l
- --ls
- Lista os atributos retornados por Get-Printer-Attributes para impressoras IPP e saída tradicional de find "-ls" para URLs de HTTP. O resultado é verdadeiro se o URI for acessível, e falso caso contrário.
- --local
- Verdadeiro se o serviço for local para este computador.
- -N name
- --literal-name name
- Verdadeiro se o nome de instância de serviço corresponder ao nome fornecido.
- -n regex
- --name regex
- Verdadeiro se o nome de instância de serviço corresponder à expressão regular fornecida.
- --path regex
- Verdadeiro se o caminho de recurso de URI corresponder à expressão regular fornecida.
- -P number[-number]
- --port number[-number]
- Verdadeiro se o porto corresponder ao número ou alcance fornecido.
- -p
- Escreve o URI se o resultado das expressões anteriores for verdadeiro. O resultado é sempre verdadeiro.
- -q
- --quiet
- Modo silêncio - apenas retorna os códigos de saída em baixo.
- -r
- --remote
- Verdadeiro se o serviço não for local para este computador.
- -s
- --print-name
- Escreve o nome de instância de serviço se o resultado das expressões anteriores for verdadeiro. O resultado é sempre verdadeiro.
- --true
- Sempre verdadeiro.
- -t key
- --txt key
- Verdadeiro se o registro TXT conter a chave nomeada.
- --txt-key regex
- Verdadeiro se o registro TXT conter a chave nomeada e corresponder à expressão regular fornecida.
- -u regex
- --uri regex
- Verdadeiro se o URI corresponder à expressão regular fornecida.
- -x utility [ argument ... ] ;
- --exec utility [ argument ... ] ;
- 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.
As expressões também podem conter modificadores:
- ( expression )
- Agrupa o resultado das expressões.
- ! expression
- --not expression
- Unário NÃO (NOT) da expressão.
- expression expression
- expression --and expression
- E (AND) lógico das expressões.
- expression --or expression
- OU (OR) lógico das expressões.
SUBSTITUIÇÕES¶
As substituições para "{foo}" em -e e --exec são:
- {service_domain}
- Nome de domínio, ex., "example.com.", "local.", etc.
- {service_hostname}
- Nome de domínio totalmente qualificado, ex., "printer.example.com.", "printer.local.", etc.
- {service_name}
- Nome de instância de serviço, ex., "My Fine Printer".
- {service_port}
- Número de porto para o servidor, tipicamente 631 para IPP e 80 para HTTP.
- {service_regtype}
- Tipo de registro DNS-SD, ex., "_ipp._tcp", "_http._tcp", etc.
- {service_scheme}
- Esquema de URI para tipo de registro DNS-SD, ex., "ipp", "http", etc.
- {}
- {service_uri}
- URI para serviço, ex., "ipp://printer.local./ipp/print", "http://printer.local./", etc.
- {txt_key}
- Valor da key de registo TXT (minúsculas).
OPÇÕES¶
ippfind suporta as seguintes opções:
- --help
- Mostra a ajuda do programa.
- --version
- Mostra a versão do programa.
- -4
- Usa IPv4 ao listar.
- -6
- Usa IPv6 ao listar.
- -T seconds
- Especifica o tempo limite de procura em segundos. Se 1 ou menos, o ippfind pára assim que pensa já ter encontrado tudo. O tempo limite predefinido é 1 segundo.
- -V version
- Especifica a versão de IPP ao listar. Os valores suportados são "1.1", "2.0", "2.1", e "2.2".
ESTADO DE SAÍDA¶
ippfind 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.
AMBIENTE¶
Quando executa um programa, o ippfind define as seguintes variáveis de ambiente para o registrar do serviço correspondente.
- IPPFIND_SERVICE_DOMAIN
- Nome de domínio, ex., "example.com.", "local.", etc.
- IPPFIND_SERVICE_HOSTNAME
- Nome de domínio totalmente qualificado, ex., "printer.example.com.", "printer.local.", etc.
- IPPFIND_SERVICE_NAME
- Nome de instância de serviço, ex., "My Fine Printer".
- IPPFIND_SERVICE_PORT
- Número de porto para o servidor, tipicamente 631 para IPP e 80 para HTTP.
- IPPFIND_SERVICE_REGTYPE
- Tipo de registro DNS-SD, ex., "_ipp._tcp", "_http._tcp", etc.
- IPPFIND_SERVICE_SCHEME
- Esquema de URI para tipo de registro DNS-SD, ex., "ipp", "http", etc.
- IPPFIND_SERVICE_URI
- URI para serviço, ex., "ipp://printer.local./ipp/print", "http://printer.local./", etc.
- IPPFIND_TXT_KEY
- Valores da KEY de registo TXT (maiúsculas).
EXEMPLOS¶
Para mostrar o estado de todas as impressoras IPP registadas na sua rede, corra:
ippfind --ls
De modo semelhante, para enviar uma página de teste PostScript para todas as impressoras PostScript, corra:
ippfind --txt-pdl application/postscript --exec ipptool
-f onepage-letter.ps '{}' print-job.test \;
VEJA TAMBÉM¶
COPYRIGHT¶
Copyright © 2020-2024 by OpenPrinting.
ippsample | 2021-02-28 |