|Display the current message, using $PAGER if defined in your enviornment.|
|[T]op of message|
|Display a specified number of lines from top of the message. Note: all of the message header will be displayed even if less than the number of lines in the header are requested. If a value is not present with the command then it will be prompted for.|
|Delete the current message from server. You may optionally specify a range of messages to delete by adding the range to the option (example: "D 1-4").|
|Save/Append current message to a specified file in standard unix mailbox format. If a filename is not specified after the command then it will be prompted for.|
|Skip to the next message on the server.|
|Go to the previous message on the server.|
|[G]o to a message|
|Allows you to jump to a different message. If message number is not specified along with this option (example: "G 2") then it will be prompted for.|
|Send a reply back to the author of the current message.|
|Quit and do not delete any previous messages from the POP3/IMAP server. Note that on IMAP servers other mail programs could have marked messages to be deleted but didnt actually use the Purge command to delete them. Using the [A]bort function in poppy will cause these messages to be unmarked for deletion.|
|[Q]uit||Quit program and possibly delete all specified messages from POP3/IMAP server.|
|Go to next message on the server.|
|[-]||Go to the previous message on the server.|
|[|]||Pipe the current message to an external program specifed after the pipe option (example: "| more").|
|[!]||Shell to an external program. If no parameters are given with the option then it runs a shell program. If parameters are given then it attempts to execute the parameters.|
|The following Command Line options are supports.|
|-a||Work with all messages. Overrides the -g option.|
|Use specified configuration filename instead of the default.|
|-f||Enter "From" Mode. Display all messages From and Subject fields. Similar to the unix command "from". This command can be used along with the "-g" option to display a short listing of all your new email or with the "-a" option to display all of your email headers.|
|-g||Goto first new message at startup. Not all POP3 servers support tracking the last read message.|
|-h||Print short help message|
|-l||Display Long Mail Headers.|
|-s||Display Short Mail Headers.|
|-v||Verbose Mode. Print out debuging messages|
|-q||Quiet Mode. Print out less messages then usual.|
|The full name or a substring to search for in your .poppyrc file. If found, it will log in to this server to read mail. If no server_name is specified then poppy will log in to the first server listed in your the .poppyrc file.|
|A combination of the user name and server name to search for in your .poppyrc file. This is useful if you have multiple user accounts on a single mail server. Substrings can still be used for the server name.|
You may have multiple lines containing the pop or imap keyword if you need to access multiple mail servers.
~/.poppyrc Per user configuration file. This file contains multiple lines of data, each starting with a keyword and followed by parameters. There must be at least one line that contains the POP3 or IMAP keyword. The format of the pop and imap keyword lines are as follows: pop server_name server_port login_name password
imap server_name server_port login_name password
server_name is the name of the host from which mail is to be retrieved. This machine must be running a pop3 or imap daemon.
server_port is the port number of the server port of the POP3/IMAP service on this host, and is typically port 110 for POP3 or 143 for IMAP.
login login name used on server.
password password on the server. If password is left of the line then poppy will prompt the user each time it is ran. The password may contain spaces.
smtp smtp_host smtp_port email_address server_name user
smtp_host is the hostname of the SMTP host.
smtp_port is the port address of the SMTP host. It is almost always port 25.
email_address is the address to use for all outgoing emails on this SMTP host.
server_name user is the server name and user name of the POP3 or IMAP server associated with this STMP host. It is valid to have one stmp line that does not include the server_name and user it associated with. This will be used as a default SMTP server for accounts that do not specifically associate an SMTP server with it. If the server_name and user field is left off then it must be the last smtp line in the configuration file.
editor program program is the name of the editor to run with creating email messages to send. pager program program is the name of the pager program to use when view emails. shell program program is the external program to run when the command is used. gonew Add this keyword with no parameters when you would like to start up poppy by default to start at new messages.
You may have multiple lines containing the smtp keyword to associate a different SMTP server and From address for each POP3 or IMAP account. A line containing just a default SMTP server and From address is also valid. If you have multiple connections to the internet it is suggested to create multiple .poppyrc files to get around firewall problems associated with SMTP servers.
Since it contains sensitive data, ~/.poppyrc must have permissions 600 (chmod 600 ~/.poppyrc). poppy will complain and exit if ~/.poppyrc has the wrong permissions.
If the file ~/.poppyrc does not exist poppy will prompt for the host, port and login information interactively and then save this data to ~./poppyrc.
Note that under Win95/NT, you may wish to use a different name than ~/.poppyrc as your configuration file. This is changable inside the poppy script.
PAGER If set it will use this program to view mail messages. It can also be defined inside the script. EDITOR If set it will use this program when creating email messages. SHELL If set it will use this program as the default to run when a user uses the shell command ("!").
Chris Bagwell (firstname.lastname@example.org)
The POP3 protocol is documented in RFC 1939 and the IMAP protocol is documented in RFC 1730. SMTP protocol is documented in RFC821.