HTTPTEST(1)

📦
version 3.12.3 · 6 versions
, in ubuntu stonking

💅 httptest — Cyrus IMAP 💅

okay bestie, welcome to the manual page, it's giving documentation, it's giving Cyrus IMAP, and we are going to READ it together 🫶

✨ NAME ✨

httptest — Cyrus IMAP documentation 🎀

It's an interactive HTTP test program. and here's the tea: it's actually installed as a hard linked copy of imtest(1) 🫣 so it's the same binary wearing a different fit. slay.

It lets you authenticate and send HTTP commands to the server ✨

🌸 SYNOPSIS 🌸

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

like. yes. the synopsis says imtest. because hard link. iykyk 💀

🦋 DESCRIPTION 🦋

okay so imtest is a utility that lets you authenticate to an IMAP server and then interactively issue commands to it 👑

Once you're authenticated you can issue literally any IMAP command by just… typing it in. that's it. that's the whole vibe 💅

It's capable of multiple SASL authentication mechanisms and handles encryption layers transparently — no cap, you don't have to think about it 🌈

This utility is often used for testing the operation of an IMAP server. Also, those developing IMAP clients find it useful ✨ (hi to all the client devs out there, you're doing amazing sweetie 🫶)

💖 OPTIONS 💖

so many flags bestie. buckle up. we're going through ALL of them, no skipping, periodt 📋

  • -t keyfile, --keyfile=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=port — Port to connect to 🔌 If left off this defaults to imap as defined in /etc/services.
  • -m mechanism, --mechanism=mechanism — Force imtest to use mechanism for authentication 🎯 If not specified, the strongest authentication mechanism supported by the server is chosen. Specify login to use the LOGIN command instead of AUTHENTICATE.
  • -a userid, --authname=userid — Userid to use for authentication; defaults to the current user 🧚 This is the userid whose password or credentials will be presented to the server for verification.
  • -u userid, --username=userid — Userid to use for authorization; defaults to the current user 👑 This is the userid whose identity will be assumed after authentication.
NOTE: This is only used with SASL mechanisms that allow proxying (e.g. PLAIN). so don't come for it when it doesn't do anything 😭
  • -k num, --minssf=num — Minimum protection layer required 🛡️
  • -l num, --maxssf=num — Maximum protection layer to use (0=none; 1=integrity; etc) 📊 For example, if you are using the GSSAPI authentication mechanism, 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, --realm=realm — Specify the realm to use 🌍 Certain authentication mechanisms may require one to specify the realm.
  • -f file, --input-filename=file — Pipe file into connection after authentication 🚰
  • -n num, --reauth-attempts=num — Number of authentication attempts; default = 1 🔁 The client will attempt to do SSL/TLS session reuse and/or fast reauth if possible.
  • -s, --require-tls — Enable SSL over chosen protocol 🔒
  • -q, --require-compression — Enable IMAP COMPRESSion (after authentication) 🗜️
  • -c, --do-challenge — Enable challenge prompt callbacks 🎤 This will cause the OTP mechanism to ask for the one-time password instead of the secret pass-phrase (library generates the correct response).
  • -i, --no-initial-response — Don't send an initial client response for SASL mechanisms, even if the protocol supports it 🙅♀️
  • -I file, --pidfile=file — Echo the PID of the running process into file 📝 (This can be useful with -X.)
  • -v, --verbose — Verbose. Print out more information than usual 🗣️ (main character energy tbh)
  • -z, --run-stress-test — Timing test ⏱️
  • -x file, --output-socket=file — Open the named socket for the interactive portion 🔌
  • -X file — Like -x, only close all file descriptors & daemonize the process 👻 (no long option bestie, that's just how it is)
  • -w password, --password=password — Password to use (if not supplied, we will prompt) 🔐
  • -o option=value, --sasl-option=option=value — Set the SASL option to value ⚙️
  • -H client-ip — Enable the HAProxy protocol and send the specified client IP address in a v1 header 📡 If the address is "unknown", a v1 header with UNKNOWN protocol will be sent. If the address is "local", a v2 header with LOCAL command will be sent.

🎀 EXAMPLES 🎀

nothing here bestie. the examples section is empty. it's giving minimalism, it's giving mystery 💀🦋 we move.

⭐ SEE ALSO ⭐

go read those next, bestie, they're also iconic 📚✨

👑 AUTHOR 👑

The Cyrus Team 💜

1993–2026, The Cyrus Team 🎀

and that's the whole page, bestie!! this was 3.12.3 of the Cyrus IMAP docs, dated Jul 15, 2026 💖 slay, you read the whole thing, i'm so proud of you fr fr 🫶✨

📦 where this page comes from