Pilot-imail(1) Pilot-imail(1) NAME pilot-imail - transfer mail, news from various formats to the palm pilot, and/or upload mail to send SYNOPSIS pilot-imail [ -n , -v ] [ -p port ] [ -h host ] [ -u user ] [ -P pass ] [ -m mbox ] [ -S service ] [ -t type ] [ -f addr ] [ -s cmd ] [ -T int ] [ -M int ] [ -k action ] [ -d action ] [ -r regex ] [ -R regex ] DESCRIPTION pilot-imail is similar in function to pilot-mail but uses the c-client library from the imap distribution to gain access to several mailbox formats, including but not lim- ited to imap, pop3, mbox, and nntp. After starting the program, press the hotsync button on the cradle, this will start the download. Mail filtering via the Pilot Mail preferences is also implemented. If have that preference selected, your mail will be filtered as you describe with "extended" (read modern) regex(3) based regular expressions. Otherwise you may provide your own filters on the command line. OPTIONS -n 'What If:' pull mail from mailbox, or news from newsgroup, but don't update mailbox and don't write palm pilot; ala make. Use with -v Verbose messages describing servers contacted, and action taken. -p port Serial port for connections to the Palm Pilot. -h host Host name for remote mailbox and news server con- nections. -u user User name for remote mailbox connections (news server connectivity is anonymous). -P password User password for remote mailbox connections (news server connectivity is anonymous). -m mailbox Mailbox name for remote mailbox connections, or newsgroup for news server connections (default: none (which translates into inbox)). -S service Mailbox service for connection; one of imap, pop3, Aug 12, 1999 1 Pilot-imail(1) Pilot-imail(1) mbox, or nntp. (default: imap). -t type type of messages to pull: one of new, unread, old, flagged, answered, all, or deleted. The default is dependend on the Mail Preferences on your pilot. The unread type will include messages marked as new. -f addr The from address to use when sending mail. -s cmd The command (pipe) to use when sending mail. -T int The number of characters at which to truncate mes- sages, must be greater 0 but no larger than 8192. Default comes from the Palm Pilot Mail preferences. -M int The maximum number of messages to download to the pilot. Default is unlimited. -k action The action to take on the "server" after having read the mailbox. One of: rdonly, keep, delete, or expunge. Rdonly leaves the mailbox unchanged Keep keeps the messages on the server, but marks them as having been read. Delete deletes the messages on the server (may be recoverable). expunge deletes and expunges the messages on the server (may be permanent). Under imap, messages are recoverable if only deleted, however expunge deletes then also sends them to the bit bucket. -d action The action to take on the Palm Pilot after having send mail out of the out box. One of: keep, delete, or file. Keep keeps the sent messages on the Palm Pilot. Delete deletes the sent messages on the Palm Pilot. File files the sent messages in the "filed" category on the Palm Pilot. -[rR] {from|subject}= Choose regular expressions to apply to the message envelope. Using -r selects messages containing the relevant pattern. Using -R ignores messages con- taining the relevant pattern. You may need to enclose the entire argument in quotes to protect it from interpretation by the shell. Multiple pat- terns are "or"'ed together. For example: Select mail from my friend, or mail with a subject con- tainting the word vacation. Aug 12, 1999 2 Pilot-imail(1) Pilot-imail(1) -r 'from=myfriend@domain,subject=[vV]acation' Select mail which is from a jerk in the spam domain, or does not contain the word "specials" in the subject. -R 'from=jerk@spamdom,subject=[wW]eb [sS]pecials' EXAMPLES Reading imap inbox, only new mail from work, keeping mail on server: pilot-imap -h here.domain -u srp -P -t new -r from='.*@work.domain' Reading another imap mailbox, only new mail, deleting mail on server: pilot-imap -h there.domain -u srp -P -t unread -m Mail/junk -k delete Reading mbox style mailbox, all mail, except (un)subscribe messages: pilot-imap -t all -m /home/bart/srp/Mail/junk -R subject='subscribe' Reading nntp newsgroups: pilot-imap -t new -h news.domain -S nntp -m bionet.biology.computational PILOT PREFERENCES Palm Pilot Mail preferences can always be overridden on the command line, but given no other action, here is how the preferences are interpreted: If you choose the "all" preference setting, all mail will be scanned (same as using the option "-t all," but no mail will be deleted from the source mailbox unless you specify it on the command line. If you choose the "send" preference setting, mail will only be uploaded; you'll have to adjust your preference if you want to download mail too. If you choose the "filter" preference setting, all mail will be filtered via the regular expression filters, and the containing or ignoring option you describe. Different filters are logically "or"'ed together. If you specify no filters, it will act like like the "all" preference option. If you choose the "unread" preference setting, only unread mail will be scanned (same as using the option "-t unread," but no mail will be deleted from the server unless you specify it on the command line. AUTHOR Scott Presnell ZymoGenetics, Inc 1201 Eastlake Ave. E. Seattle WA, 98102 srp@zgi.com Aug 12, 1999 3 Pilot-imail(1) Pilot-imail(1) pilot-imail was written by Scott Presnell, but it is heav- ily derived from pilot-mail. pilot-mail was written by Kenneth Albanowski. FILES .newsrc - newsrc file when reading newsgrous via nntp driver. SEE ALSO pilot-mail(1), pilot-link(7), imapd (8). BUGS There is only sporatic file locking: be aware of running pilot-imail at the same time as, say, netscape, when down- loading news and/or mail. You may find that the mailbox you want to access is available on a read only basis. NOTES Pattern matching against the "to" address is not yet sup- ported because of the implementation of the mailbox overview functions in c-client (though it could be hacked in.) Even syntaxtically incorrect patterns (e.g. [fooo[bar]) ) compile successfully under some OS variants, and are run through regexec without error... be careful in writing your patterns. Aug 12, 1999 4
Scott Presnell
Last modified: Thursday, September 2, 1999 22:34 PDT