Manpages - ippfind.1

ippfind supports the following registration types:

_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)

ippfind supports expressions much like the find*(1) utility. However, unlike *find*(1), *ippfind uses POSIX regular expressions instead of shell filename matching patterns. If –exec, -l, –ls, -p, –print, –print-name, -q, –quiet, -s, or -x is not specified, ippfind adds –print to print the service URI of anything it finds. The following expressions are supported:

*-d */regex/

*–domain */regex/

True if the domain matches the given regular expression.

–false

Always false.

*-h */regex/

*–host */regex/

True is the hostname matches the given regular expression.

-l

–ls

Lists attributes returned by Get-Printer-Attributes for IPP printers and traditional find "-ls" output for HTTP URLs. The result is true if the URI is accessible, false otherwise.

–local

True if the service is local to this computer.

*-N */name/

*–literal-name */name/

True if the service instance name matches the given name.

*-n */regex/

*–name */regex/

True if the service instance name matches the given regular expression.

*–path */regex/

True if the URI resource path matches the given regular expression.

-P */number/[-*/number/]

• –port */number/[-*/number/] :: True if the port matches the given number or range.

  -p

  –print

  Prints the URI if the result of previous expressions is true. The result is always true.

  -q

  –quiet

  Quiet mode - just returns the exit codes below.

  -r

  –remote

  True if the service is not local to this computer.

  -s

  –print-name

  Prints the service instance name if the result of previous expressions is true. The result is always true.

  –true

  Always true.

  *-t */key/

  *–txt */key/

  True if the TXT record contains the named key.

  *–txt-*/key regex/

  True if the TXT record contains the named key and matches the given regular expression.

  *-u */regex/

  *–uri */regex/

  True if the URI matches the given regular expression.

  -x */utility /[ /argument /… ] *;

  • *–exec /utility /[ /argument /… ] *; :: Executes the specified program if the current result is true. "{foo}" arguments are replaced with the corresponding value - see SUBSTITUTIONS below.

Expressions may also contain modifiers:

( */expression /)*

Group the result of expressions.

*! */expression/

*–not */expression/

Unary NOT of the expression.

expression expression

• expression /*–and */expression :: Logical AND of expressions.

  expression /*–or */expression

  Logical OR of expressions.

The substitutions for "{foo}" in -e and –exec are:

{service_domain}

Domain name, e.g., "example.com.", "local.", etc.

{service_hostname}

Fully-qualified domain name, e.g., "printer.example.com.", "printer.local.", etc.

{service_name}

Service instance name, e.g., "My Fine Printer".

{service_port}

Port number for server, typically 631 for IPP and 80 for HTTP.

{service_regtype}

DNS-SD registration type, e.g., "_ipp._tcp", "_http._tcp", etc.

{service_scheme}

URI scheme for DNS-SD registration type, e.g., "ipp", "http", etc.

{}

{service_uri}

URI for service, e.g., "ipp://printer.local./ipp/print", "http://printer.local./", etc.

{txt_*/key/}*

Value of TXT record key (lowercase).