igopher-validator.1 - gopher-validator - Simple gopher menu validator.	Err	bitreich.org	70
hgit clone git://bitreich.org/gopher-validator git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/gopher-validator	URL:git://bitreich.org/gopher-validator git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/gopher-validator	bitreich.org	70
1Log	/scm/gopher-validator/log.gph	bitreich.org	70
1Files	/scm/gopher-validator/files.gph	bitreich.org	70
1Refs	/scm/gopher-validator/refs.gph	bitreich.org	70
1Tags	/scm/gopher-validator/tag	bitreich.org	70
1README	/scm/gopher-validator/file/README.gph	bitreich.org	70
1LICENSE	/scm/gopher-validator/file/LICENSE.gph	bitreich.org	70
i---	Err	bitreich.org	70
igopher-validator.1 (2020B)	Err	bitreich.org	70
i---	Err	bitreich.org	70
i     1 .Dd January 9, 2020	Err	bitreich.org	70
i     2 .Dt GOPHER-VALIDATOR 1	Err	bitreich.org	70
i     3 .Os	Err	bitreich.org	70
i     4 .Sh NAME	Err	bitreich.org	70
i     5 .Nm gopher-validator	Err	bitreich.org	70
i     6 .Nd a simple gopher validator	Err	bitreich.org	70
i     7 .Sh SYNOPSIS	Err	bitreich.org	70
i     8 .Nm	Err	bitreich.org	70
i     9 .Op Ar url	Err	bitreich.org	70
i    10 .Op Ar param	Err	bitreich.org	70
i    11 .Sh DESCRIPTION	Err	bitreich.org	70
i    12 .Nm	Err	bitreich.org	70
i    13 reads raw Gopher data from stdin.	Err	bitreich.org	70
i    14 .Pp	Err	bitreich.org	70
i    15 When an	Err	bitreich.org	70
i    16 .Ar url	Err	bitreich.org	70
i    17 is specified it retrieves the raw Gopher data from this url.	Err	bitreich.org	70
i    18 .Pp	Err	bitreich.org	70
i    19 When a	Err	bitreich.org	70
i    20 .Ar param	Err	bitreich.org	70
i    21 is specified it will be added after the selector as a (search) parameter.	Err	bitreich.org	70
i    22 .Pp	Err	bitreich.org	70
i    23 When the environment variable	Err	bitreich.org	70
i    24 .Ev QUERY_STRING	Err	bitreich.org	70
i    25 is set the program runs in Command Gateway Interface (CGI) mode.	Err	bitreich.org	70
i    26 It will use the content of this variable as if it was	Err	bitreich.org	70
i    27 .Ar url .	Err	bitreich.org	70
i    28 .Pp	Err	bitreich.org	70
i    29 CGI-mode has precedence over command-line arguments.	Err	bitreich.org	70
i    30 .Pp	Err	bitreich.org	70
i    31 .Nm	Err	bitreich.org	70
i    32 validates Gopher data of directory (1) and search types (7).	Err	bitreich.org	70
i    33 .Sh EXIT STATUS	Err	bitreich.org	70
i    34 When there is a fatal error the exitcode is 2.	Err	bitreich.org	70
i    35 When there is any Gopher error the exitcode is 1.	Err	bitreich.org	70
i    36 When there is no error (could still have a warning) the exitcode is 0.	Err	bitreich.org	70
i    37 .Sh EXAMPLES	Err	bitreich.org	70
i    38 .Bd -literal	Err	bitreich.org	70
i    39 printf '\\r\\n' | nc codemadness.org 70 | gopher-validator	Err	bitreich.org	70
i    40 .Ed	Err	bitreich.org	70
i    41 .Bd -literal	Err	bitreich.org	70
i    42 gopher-validator gopher://codemadness.org/1	Err	bitreich.org	70
i    43 .Ed	Err	bitreich.org	70
i    44 .Sh DIAGNOSTICS	Err	bitreich.org	70
i    45 The following output format is used for the fatal, error and warning messages.	Err	bitreich.org	70
i    46 These are prefixed with the following texts:	Err	bitreich.org	70
i    47 .Bl -tag -width Ds	Err	bitreich.org	70
i    48 .It Qq "fatal: "	Err	bitreich.org	70
i    49 .Pp	Err	bitreich.org	70
i    50 Fatal program errors such as connection errors.	Err	bitreich.org	70
i    51 These messages are written to stderr, unless	Err	bitreich.org	70
i    52 .Nm	Err	bitreich.org	70
i    53 runs in CGI mode.	Err	bitreich.org	70
i    54 .It Qq "error: "	Err	bitreich.org	70
i    55 .Pp	Err	bitreich.org	70
i    56 Gopher errors violating the RFC specification.	Err	bitreich.org	70
i    57 These messages are written to stdout.	Err	bitreich.org	70
i    58 .It Qq "warning: "	Err	bitreich.org	70
i    59 .Pp	Err	bitreich.org	70
i    60 Recommendations according to the RFC specification.	Err	bitreich.org	70
i    61 These messages are written to stdout.	Err	bitreich.org	70
i    62 .El	Err	bitreich.org	70
i    63 .Pp	Err	bitreich.org	70
i    64 If possible the messages are also prefixed with the output line number.	Err	bitreich.org	70
i    65 .Sh SEE ALSO	Err	bitreich.org	70
i    66 .Xr nc 1	Err	bitreich.org	70
i    67 .Sh STANDARDS	Err	bitreich.org	70
i    68 RFC1436 is followed as closely as possible.	Err	bitreich.org	70
i    69 The only deviation is checking for UTF-8 instead of LATIN-1 text encoding,	Err	bitreich.org	70
i    70 for now.	Err	bitreich.org	70
i    71 .Nm	Err	bitreich.org	70
i    72 uses the standard C library locale functions and respects the user locale	Err	bitreich.org	70
i    73 environment.	Err	bitreich.org	70
i    74 To check text encoding it is assumed	Err	bitreich.org	70
i    75 .Nm	Err	bitreich.org	70
i    76 runs in the same locale environment as the server.	Err	bitreich.org	70
i    77 .Sh AUTHORS	Err	bitreich.org	70
i    78 .An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org	Err	bitreich.org	70
.