1IMTEST(1) General Commands Manual IMTEST(1)
2 *
6
8 imtest - interactive IMAP test program
9
11 imtest [ -t keyfile ] [ -p port ] [ -m mechanism ]
12 [ -a userid ] [ -u userid ] [ -k num ] [ -l num ]
13 [ -r realm ] [ -f file ] [ -n num ] [ -s ] [ -q ]
14 [ -c ] [ -i ] [ -z ] [ -v ] [ -I file ] [ -x file ]
15 [ -X file ] [ -o option=value ] hostname
16
18 imtest is a utility that allows you to authenticate to a IMAP or IMSP
19 server and interactively issue commands to it. Once authenticated you
20 may issue any IMAP or IMSP command by simply typing it in. It is capa‐
21 ble of multiple SASL authentication mechanisms and handles encryption
22 layers transparently. This utility is often used for testing the opera‐
23 tion of a imsp or imap server. Also those developing IMAP clients find
24 it useful.
25
27 -t keyfile
28 Enable TLS. keyfile contains the TLS public and private keys.
29 Specify "" to negotiate a TLS encryption layer but not use TLS
30 authentication.
31 -p port
33 Port to connect to. If left off this defaults to imap as defined
34 in /etc/services.
35 -m mechanism
37 Force imtest to use mechanism for authentication. If not speci‐
38 fied the strongest authentication mechanism supported by the
39 server is chosen. Specify login to use the LOGIN command
40 instead of AUTHENTICATE.
41 -a userid
43 Userid to use for authentication; defaults to the current user.
44 This is the userid whose password or credentials will be pre‐
45 sented to the server for verification.
46 -u userid
48 Userid to use for authorization; defaults to the current user.
49 This is the userid whose identity will be assumed after authen‐
50 tication. NOTE: This is only used with SASL mechanisms that
51 allow proxying (e.g. PLAIN, DIGEST-MD5).
52 -k num Minimum protection layer required.
54 -l num Maximum protection layer to use (0=none; 1=integrity; etc). For
56 example if you are using the KERBEROS_V4 authentication mecha‐
57 nism specifying 0 will force imtest to not use any layer and
58 specifying 1 will force it to use the integrity layer. By
59 default the maximum supported protection layer will be used.
60 -r realm
62 Specify the realm to use. Certain authentication mechanisms
63 (e.g. DIGEST-MD5) may require one to specify the realm.
64 -f file
66 Pipe file into connection after authentication.
67 -n num Number of authentication attempts; default = 1. The client will
69 attempt to do SSL/TLS session reuse and/or fast reauth (e.g.
70 DIGEST-MD5), if possible.
71 -s Enable IMAP over SSL (imaps).
73 -q Enable IMAP COMPRESSion (before the last authentication
75 attempt).
76 -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 -i Don't send an initial client response for SASL mechanisms, even
82 if the protocol supports it.
83 -I file
85 Echo the PID of the running process into file (This can be use‐
86 ful with -X).
87 -x file
89 Open the named socket for the interactive portion
90 -X file
92 Like -x, only close all file descriptors & daemonize the
93 process.
94 -o option=value
96 Set the SASL option to value.
97 -v Verbose. Print out more information than usual.
99 -z Timing test.
101
103 imapd(8)
104CMU Project Cyrus IMTEST(1)