imtest

IMTEST(1)                                                            IMTEST(1)

NAME

       imtest - interactive IMAP test program

SYNOPSIS

       imtest [ -t keyfile ] [ -p port ] [ -m mechanism ]
              [ -u user ] [ -a user ] [ -k num ] [ -l num ]
              [ -r realm ] [ -f file ] [ -n num ] [ -s ] [ -c ]
              [ -i ] [ -z ] [ -v ] [ -I file ] [ -x file ]
              [ -X file ] [ -o option=value ] hostname

DESCRIPTION

       imtest  is  a utility that allows you to authenticate to a IMAP or IMSP
       server and interactively issue commands to it. Once  authenticated  you
       may  issue any IMAP or IMSP command by simply typing it in. It is capa-
       ble of multiple SASL authentication mechanisms and  handles  encryption
       layers transparently. This utility is often used for testing the opera-
       tion of a imsp or imap server. Also those developing IMAP clients  find
       it useful.

OPTIONS

       -t keyfile
              Enable  TLS.   keyfile contains the TLS public and private keys.
              Specify "" to negotiate a TLS encryption layer but not  use  TLS
              authentication.

       -p port
              Port to connect to. If left off this defaults to imap as defined
              in /etc/services.

       -m mechanism
              Force imtest to use mechanism for authentication. If not  speci-
              fied  the  strongest  authentication  mechanism supported by the
              server is chosen.   Specify  login  to  use  the  LOGIN  command
              instead of AUTHENTICATE.

       -u user
              Username  to  use  for  authentication;  defaults to the current
              user.

       -a user
              Authname to use for  authentication;  defaults  to  the  current
              user.

       -k num Minimum protection layer required.

       -l num Maximum protection layer to use (0=none; 1=integrity; etc).  For
              example if you are using the KERBEROS_V4  authentication  mecha-
              nism  specifying  0  will  force imtest to not use any layer and
              specifying 1 will force it  to  use  the  integrity  layer.   By
              default the maximum supported protection layer will be used.

       -r realm
              Specify  the  realm  to  use.  Certain authentication mechanisms
              (e.g. DIGEST-MD5) may require one to specify the realm.

       -f file
              Pipe file into connection after authentication.

       -n num Number of authentication attempts; default = 1.  The client will
              attempt  to  do  SSL/TLS  session reuse and/or fast reauth (e.g.
              DIGEST-MD5), if possible.

       -s     Enable IMAP over SSL (imaps).

       -c     Enable challenge prompt callbacks.   This  will  cause  the  OTP
              mechanism  to  ask  for the the one-time password instead of the
              secret pass-phrase (library generates the correct response).

       -c     Don’t send an initial client response for SASL mechanisms,  even
              if the protocol supports it.

       -I file
              Echo  the PID of the running process into file (This can be use-
              ful with -X).

       -x file
              Open the named socket for the interactive portion

       -X file
              Like -x, only close all file descriptors &  daemonize  the  pro-
              cess.

       -o option=value
              Set the SASL option to value.

       -v     Verbose. Print out more information than usual.

       -z     Timing test.

SEE ALSO

       imapd(8)



CMU                              Project Cyrus                       IMTEST(1)