SMTPCTL(8)              OpenBSD System Manager's Manual             SMTPCTL(8)

NAME
     smtpctl - control the Simple Mail Transfer Protocol daemon

SYNOPSIS
     smtpctl command [argument ...]

DESCRIPTION
     The smtpctl program controls smtpd(8).

     The following commands are available:

     log brief
             Disable verbose debug logging.

     log verbose
             Enable verbose debug logging.

     pause incoming
             Temporarily stop accepting incoming sessions.

     pause local
             Temporarily stop deliveries to local users.

     pause outgoing
             Temporarily stop relaying and deliveries to remote users.

     remove message-uid | message-id
             Removes a single message, or all messages with the same message
             ID.

     resume incoming
             Resume accepting incoming sessions.

     resume local
             Resume deliveries to local users.

     resume outgoing
             Resume relaying and deliveries to remote users.

     schedule message-uid | message-id
             Marks a single message, or all messages with the same message ID,
             as ready for immediate delivery.

     show queue
             Displays information concerning envelopes that are currently in a
             queue.

     show runqueue
             Displays information concerning envelopes that are scheduled for
             delivery.

     show stats
             Displays runtime statistics concerning smtpd(8).

     When smtpd receives a message, it generates a message-id for the message,
     and one message-uid per recipient.  The message-id consists of a times-
     tamp followed by a random identifier that is guaranteed to be unique on
     the host system.  The message-uid consists of the message-id followed by
     a random identifier that is also guaranteed to be unique between recipi-
     ents of the same message.

     A command which specifies a message-id applies to all recipients of a
     message; a command which specifies a message-uid applies to a specific
     recipient of a message.

FILES
     /var/run/smtpd.sock    UNIX-domain socket used for communication with
                            smtpd(8).

SEE ALSO
     smtpd(8)

HISTORY
     The smtpctl program first appeared in OpenBSD 4.6.

OpenBSD 4.7                    February 23, 2010                             2
