1TESTHOST(1) General Commands Manual TESTHOST(1)
2
6 testhost - test the status of an NNTP news server
7
9 testhost hostname [ -a|-n date time |-o ] [ -M ] [ -s|-S filename ] [
10 -e|-E filename ] [ -N port_number ] [ -U userid ] [ -P password ] [ -Q
11 ] [ -l phrase_file ] [ -T timeout ] [ -d ] [ -q ] [ -z ]
12
15 -a Get the active list from hostname
16 -d
18 This option tells testhost get the descriptions of the newsgroups on
20 the remote server by sending the 'list newsgroups' command. The remote
21 server may or may not support this command.
22 -e | -E filename
24 These options will send all error messages (normally displayed on
26 stderr), to an alternate file. The lower case version, -e, will send
27 the error messages to the compiled-in default defined in suck_config.h.
28 The default is suck.errlog. The upper case version, -E, requires the
29 filename parameter. All error messages will then be sent to this file.
30 -l phrase_file
32 This option tells testhost to load in an alternate phrase file, instead
34 of using the built-in messages. This allows you to have testhost print
35 phrases in another language, or to allow you to customize the messages
36 without re-building. See the "FOREIGN LANGUAGE PHRASES" in suck.1 for
37 more details.
38 -n date time
40 Get the newgroups created on the host since the date and time speci‐
42 fied. The date must be in YYMMDD format and the time must be in HHMMSS
43 format.
44 -N port_number
46 This option will tell testhost to use an alternate NNRP port number
48 when connecting to the host, instead of the default, 119.
49 -q
51 This option tells testhost to not display the connection and announce‐
53 ment messages, rather only display the results of the actual command
54 run.
55 -s | -S filename
57 These options will send all status messages (normally displayed on std‐
59 out), to an alternate file. The lower case version, -s, will send the
60 status messages to the compiled-in default defined in suck_config.h.
61 The default is /dev/null, so no status messages will be displayed. The
62 upper case version, -S, requires the filename parameter. All status
63 messages will then be sent to this file.
64 -T
66 This option overrides the compiled-in TIMEOUT value. This is how long
68 testhost waits for data from the remote host before timing out and
69 aborting.
70 -U userid
72 -P password
74 These two options let you specify a userid and password, if your NNTP
76 server requires them.
77 -Q
79 This option tells testhost to use the environment variable NNTP_USER &
81 NNTP_PASS to specify a userid and password, if your NNTP server
82 requires them. This option is provided so that the userid & password
83 can't be seen with the ps command, a potential security problem.
84 -z
86 This options tells testhost to use SSL to talk to the remote server, if
88 testhost was compiled with SSL.
89
92 Testhost will query a NNTP news server, specified by hostname.
93 The hostname may optionally include the port number in the form
95 Host:Port.Iftheportnumberisincluded,theportnumberspecified by the -N
96 option will be ignored.
97 The default action is to issue the help command to the server, to see
99 what software it is running and what commands it accepts.
100 If the -a option is used, testhost will display the server's active
102 history list. If the -n date time option is used, testhost will dis‐
103 play all new groups created on the server since the date and time spec‐
104 ified. If the -o option is used, then testhost will display the over‐
105 view format, which is what the XOVER command returns.
106 If the -M option is used, the command will be preceded with the "mode
108 reader" command, which might be needed by some servers.
109
112 0 on success, -1 on failure.
113
115 suck(1), rpost(1), lpost(1).
116 TESTHOST(1)