# getmail/cfg - "Build" settings for package #--------------------------------------------------------------------- [technotes] 1. This distro's version of "getmail" disables a security measure used by the upstream version. Specifically, the local version allows "get- mail" to run as user (and group) "root". This allows delivery of mail to files owned by "root" (or stored in directories that are owned by "root"). #--------------------------------------------------------------------- 2. Some tips: 2.1. If a user wishes to use "getmail", they should create the follow- ing directory: $HOME/.getmail Subsequently, they should place one or more configuration files in the directory. Each file should define the rules to be used for fetching email from one remote account. Note: The file format is documented by the files in: $PRODTREE/python2/doc/getmail/ If FILENAME is the name of a configuration file (without a path com- ponent), the following command will fetch mail based on the rules in the specified file: getmail --rcfile=FILENAME The configuration-file name "getmailrc" is a special case. If one of the configuration files is named "getmailrc", the command "getmail" (without any parameters) will fetch mail based on the rules in that file. The following command will work as well: getmail --rcfile=getmailrc #--------------------------------------------------------------------- 2.2. To retrieve email from a single non-default folder, try using IMAP and an appropriate "mailboxes" entry. The "mailboxes" entry sho- uld be formatted as shown below. Note that a comma should be placed after the closing double quote: # mailbox = ( "Folder name goes here", ) The associated [retriever] block (in the "getmail" configuration file used) might look something like this: # [retriever] # type = SimpleIMAPRetriever # server = SOMEHOST.com # username = ACCOUNT_NAME # password = ACCOUNT_PASSWORD # mailboxes = ("Folder name",) To retrieve email from multiple folders (default or not), list the associated folder names in the "mailboxes" line as shown below. If there are two or more names, the trailing comma shown above isn't needed: # mailboxes = ("Inbox", "Sent items") #--------------------------------------------------------------------- 2.3. A configuration file similar to the following should work for transferring email from a default POP3 folder to a standard mailbox file stored in the system mailbox directory. Note: This assumes that "getmail" is running as "root" and that the security change discussed previously has been made. Set "server", "username", and "password" to the appropriate POP3 host- name, account name, and password strings. # [retriever] # type = SimplePOP3Retriever # server = SOMEHOST.com # username = ACCOUNT_NAME # password = ACCOUNT_PASSWORD Replace "path" setting with an absolute path for the mailbox file to use. Note that the file must exist initially. If necessary, use "tou- ch" to create it. # [destination] # type = Mboxrd # path = /var/mail/FILENAME If you'd like to delete messages (on the remote side) as they are transferred, set "delete" to true. # [options] # verbose = 1 # delete = false # message_log = ~/.getmail/log # message_log_verbose = false #--------------------------------------------------------------------- 2.4. A configuration file similar to the following should work for transferring email from an arbitrary IMAP folder to a standard mailbox file stored in the system mailbox directory. Note: This assumes that "getmail" is running as "root" and that the security change discussed previously has been made. Set "server", "username", and "password" to the appropriate POP3 host- name, account name, and password strings. # [retriever] # type = SimpleIMAPRetriever # server = SOMEHOST.com # username = ACCOUNT_NAME # password = ACCOUNT_PASSWORD # mailboxes = ("Folder name",) Replace "path" setting with an absolute path for the mailbox file to use. Note that the file must exist initially. If necessary, use "tou- ch" to create it. # [destination] # type = Mboxrd # path = /var/mail/FILENAME If you'd like to delete messages (on the remote side) as they are transferred, set "delete" to true. # [options] # verbose = 1 # delete = false # message_log = ~/.getmail/log # message_log_verbose = false #--------------------------------------------------------------------- [buildtimes] 00.00 hours (or 000.02 minutes) - Compaq 1.7 GHz Intel Pentium 4 512MB RAM 00.00 hours (or 000.02 minutes) - Dell Inspiron 6400 2.0 GHz Intel Duo 7200 2GB RAM 00.00 hours (or 000.02 minutes) - ThinkPad E540 i7 4x2 16GB RAM #--------------------------------------------------------------------- [settings] configure = none license = GNU General Public License, version 2 (June 1991) proddir = none purge = no shareddir = yes tmpsize = 2M #--------------------------------------------------------------------- [depends] python:strict python2-core:strict python2-tcltk:strict #--------------------------------------------------------------------- [build] DOCDIR=$PRODTREE/python2/doc/getmail python setup.py build python setup.py install mkdir -p $DOCDIR cd docs chown 0.0 * cp -p COPYING *.txt *examples $DOCDIR/ #--------------------------------------------------------------------- # Original URLs. These URLs were valid at one point, but may have died # since then. If you download newer versions of tarballs [etc.], don't # delete the original versions, as you may not be able to replace # them. [urls] url_debian = Not checked yet url_home = http://pyropus.ca/software/getmail/ url_lfs = Not checked yet url_tarball = http://pyropus.ca/software/getmail/old-versions/\ getmail-5.16.tar.gz #--------------------------------------------------------------------- [history] 170704 Updated from 4.49.0 to 4.54.0 210509 Updated to 5.15 211101 Updated to 5.16