1NNTPTEST(1)                       Cyrus IMAP                       NNTPTEST(1)
2
3
4

NAME

6       nntptest - Cyrus IMAP documentation
7
8       Interactive NNTP test program
9

SYNOPSIS

11       nntptest [ -t keyfile ] [ -p port ] [ -m mechanism ] [ -a userid ]
12           [ -u userid ] [ -k num ] [ -l num ] [ -r realm ] [ -f file ]
13           [ -n num ] [ -s ] [ -c ] [ -i ] [ -v ] [ -w passwd ] [ -q ]
14           [ -o option=value ] hostname
15

DESCRIPTION

17       nntptest  is a utility that allows you to authenticate to a NNTP server
18       and interactively issue commands to  it.  Once  authenticated  you  may
19       issue any NNTP command by simply typing it in.  It is capable of multi‐
20       ple SASL authentication mechanisms and handles encryption layers trans‐
21       parently.  This  utility  is often used for testing the operation of an
22       nntp server. Also those developing NNTP clients find it useful.
23

OPTIONS

25       -t keyfile
26              Enable TLS.  keyfile contains the TLS public and  private  keys.
27              Specify  ""  to negotiate a TLS encryption layer but not use TLS
28              authentication.
29
30       -p port
31              Port to connect to. If left off this defaults to nntp as defined
32              in /etc/services.
33
34       -m mechanism
35              Force nntptest to use mechanism for authentication. If not spec‐
36              ified, the strongest authentication mechanism supported  by  the
37              server  is  chosen.   Specify user to use the AUTHINFO USER/PASS
38              commands instead of AUTHINFO SASL.
39
40       -a userid
41              Userid to use for authentication; defaults to the current  user.
42              This  is  the  userid whose password or credentials will be pre‐
43              sented to the server for verification.
44
45       -u userid
46              Userid to use for authorization; defaults to the  current  user.
47              This  is the userid whose identity will be assumed after authen‐
48              tication.
49
50              NOTE:
51                 This is only used with SASL mechanisms  that  allow  proxying
52                 (e.g. PLAIN, DIGEST-MD5).
53
54       -k num Minimum protection layer required.
55
56       -l num Maximum protection layer to use (0=none; 1=integrity; etc).  For
57              example if you are using the KERBEROS_V4  authentication  mecha‐
58              nism  specifying  0  will  force imtest to not use any layer and
59              specifying 1 will force it  to  use  the  integrity  layer.   By
60              default the maximum supported protection layer will be used.
61
62       -r realm
63              Specify  the  realm  to  use.  Certain authentication mechanisms
64              (e.g. DIGEST-MD5) may require one to specify the realm.
65
66       -f file
67              Pipe file into connection after authentication.
68
69       -n num Number of authentication attempts; default = 1.  The client will
70              attempt  to  do  SSL/TLS  session reuse and/or fast reauth (e.g.
71              DIGEST-MD5), if possible.
72
73       -s     Enable NNTP over SSL (nntps).
74
75       -q     Enable NNTP COMPRESSion (after authentication)
76
77       -c     Enable challenge prompt callbacks.   This  will  cause  the  OTP
78              mechanism  to  ask  for the the one-time password instead of the
79              secret pass-phrase (library generates the correct response).
80
81       -i     Don't send an initial client response for SASL mechanisms,  even
82              if the protocol supports it.
83
84       -v     Verbose. Print out more information than usual.
85
86       -w passwd
87              Password to use (if not supplied, we will prompt).
88
89       -o option=value
90              Set the SASL option to value.
91

EXAMPLES

SEE ALSO

94       nntpd(8)
95

AUTHOR

97       The Cyrus Team, Nic Bernstein (Onlight)
98
100       1993-2017, The Cyrus Team
101
102
103
104
1053.0.10                           May 27, 2019                      NNTPTEST(1)
Impressum