POPI(1)

NAME
popi - POP initiator

SYNOPSIS
popi [+folder] [-host host] [-user user] [-apop] [-noapop] [-rpop] [-norpop] [-auto] [-noauto] [-mshproc program] [-form formatfile] [-format string] [-width columns] [-help]

DESCRIPTION
popi is an interactive program that implements the client side of the Post Office Protocol (version 3). When invoked, popi establishes a POP connection, and enters a command loop. The user may type most of the normal POP commands, with a couple of additions: The commands that pop currently supports are:

dele msg
last
list [msg]
noop
quit
retr msg
rset
scan
stat
top
msh

The retr command retrieves a message into the folder specified on the command line. The scan command downloads an MH format-string to the server (as determined from the `-form formatfile' and `-format switches), so that future invocations of the list command will include a scan listing. The quit command terminates popi, as does typing CTRL-D. The msh command invokes the mshproc. To override the default mshproc and the profile entry, use the `-mshproc program' switch. The `-auto' switch causes popi to invoke the mshproc directly, and thence terminate when the mshproc terminates. The `-host host' switch specifies the POP server to use. If the `-user user' switch is not given, then the current username is used. Normally, popi will prompt for a password to use. However, if the `-apop' switch is given, popi will generate authentication credentials to provide for origin authentication and replay protection, but which do not involve sending a password in the clear over the network. Otherwise, if the `-rpop' switch is given, then popi will try to use a “trusted” connection (ala the BSD r-commands). ^$HOME/.mh_profile~^The user profile ^/usr/lib/mh/mtstailor~^tailor file ^Path:~^To determine the user's MH directory ^Msg-Protect:~^To set mode when creating a new `file' ^mshproc:~^Program to read a given BBoard msh(1) `+folder' defaults to “inbox” `-noapop' `-norpop' `-auto' `-format' defaulted as described above `-width' defaulted to the width of the terminal The folder into which messages are being incorporated will become the current folder. The current message is unchanged. The argument to the `-format' switch must be interpreted as a single token by the shell that invokes inc. Therefore, one must usually place the argument to this switch inside double-quotes.