.TH PSL "1" "July 2016" "psl 0.13.0" "User Commands"

.SH NAME

psl \- Explore the Public Suffix List

.SH SYNOPSIS

.B psl

[\fI\,options\/\fR] \fI\,<domains\/\fR...\fI\,>\/\fR

.SH DESCRIPTION

`psl' explores the Public Suffix List.  It takes a list of domains on

the command line, or if no domains are present on the command line, it

reads one domain per line from standard input.  It prints its results

to standard output, with each line containing one domain followed by a

colon, followed by the relevant information for that domain.

.SH MODES

The information printed per domain changes based on the selected mode.

.br

Available modes are:

.TP

\fB\-\-is\-public\-suffix\fR

check if domains are public suffixes. [default]

.br

Returned data: 1 if the \fIdomain\fR is a public suffix, 0 otherwise.

.br

This option can be combined with \fB\-\-no\-star\-rule\fR.  It's use will

switch off the PSL 'prevailing star rule' so that all TLDs not

explicitly listed in the PSL will return 0 (not a public suffix).

.TP

\fB\-\-is\-cookie\-domain\-acceptable\fR <cookie\-domain>

check if cookie\-domain is acceptable for domains.

.br

Returned data: 1 if \fIcookie-domain\fR is acceptable for the

\fIdomain\fR, 0 otherwise.

.TP

\fB\-\-print\-unreg\-domain\fR

Returned data: the longest public suffix part for each \fIdomain\fR.

.TP

\fB\-\-print\-reg\-domain\fR

Returned data: the shortest private suffix part for each \fIdomain\fR.

.SH VERSION INFORMATION

`psl' can instead be used to report information about the version of

the library and its built-in Public Suffix data:

.TP

\fB\-\-version\fR

show library version information

.TP

\fB\-\-print\-info\fR

print info about library builtin data

.SH PUBLIC SUFFIX DATA

By default, `psl' will use the latest available Public Suffix data.

.br

You can also direct it to use a different file:

.TP

\fB\-\-use\-latest\-data\fR

use the latest available PSL data [default]

.TP

\fB\-\-use\-builtin\-data\fR

use the builtin PSL data

.TP

\fB\-\-load\-psl\-file\fR <filename>

load PSL data from file

.SH SEE ALSO

https://publicsuffix.org/

https://github.com/rockdaboot/libpsl

.SH COPYRIGHT

libpsl and `psl' are copyright \(co 2014\-2016 Tim Ruehsen under an

MIT-style License.

.br

This documentation was written by Daniel Kahn Gillmor for the Debian

project, but may be used by others under the same license as libpsl

itself.