diff --git a/scheme/lib/pop3.scm b/scheme/lib/pop3.scm index 53a5762..682ef7d 100644 --- a/scheme/lib/pop3.scm +++ b/scheme/lib/pop3.scm @@ -6,78 +6,6 @@ ;;; For copyright information, see the file COPYING which comes with ;;; the distribution. -;;; Overview ============================================================== -;; -;; The POP3 protocol allows access to email on a maildrop server. It -;; is often used in configurations where users connect from a client -;; machine which doesn't have a permanent network connection or isn't -;; always turned on, situations which make local SMTP delivery -;; impossible. It is the most common form of email access provided by -;; Internet Service Providers. -;; -;; Two types of authentication are commonly used. The first, most -;; basic type involves sending a user's password in clear over the -;; network, and should be avoided. Unfortunately many POP3 clients -;; only implement this basic authentication. The digest authentication -;; system involves the server sending the client a "challenge" token; -;; the client encodes this token with the pass phrase and sends the -;; coded information to the server. This method avoids sending -;; sensitive information over the network. -;; -;; Once connected, a client may request information about the number -;; and size of the messages waiting on the server, download selected -;; messages (either their headers or the entire content), and delete -;; selected messages. - - -;;; Entry points ======================================================= -;; -;; (pop3-connect [host logfile]) -> connection -;; Connect to the maildrop server named HOST. Optionally log the -;; conversation with the server to LOGFILE, which will be appended -;; to if it exists, and created otherwise. The environment variable -;; MAILHOST, if set, will override the value of HOST. -;; -;; (pop3-login connection [login password]) -> status -;; Log in to the mailhost. If a login and password are not -;; provided, they are first searched for in the user's ~/.netrc -;; file. USER/PASS authentication will be tried first, and if this -;; fails, APOP authentication will be tried. -;; -;; (pop3-login/APOP connection login password) -> status -;; Log in to the mailhost using APOP authentication. -;; -;; (pop3-stat connection) -> integer x integer -;; Return the number of messages and the number of bytes waiting in -;; the maildrop. -;; -;; (pop3-get connection msgid) -> status -;; Download message number MSGID from the mailhost. MSGID must be -;; positive and less than the number of messages returned by the -;; pop3-stat call. The message contents are sent to -;; (current-output-port). -;; -;; (pop3-headers connection msgid) -> status -;; Download the headers of message number MSGID. The data is sent -;; to (current-output-port). -;; -;; (pop3-last connection) -> integer -;; Return the highest accessed message-id number for the current -;; session. This isn't in the RFC, but seems to be supported by -;; several servers. -;; -;; (pop3-delete connection msgid) -> status -;; Mark message number MSGID for deletion. The message will not be -;; deleted until the client logs out. -;; -;; (pop3-reset connection) -> status -;; Any messages which have been marked for deletion are unmarked. -;; -;; (pop3-quit connection) -> status -;; Close the connection with the mailhost. - - - ;;; Related work ===================================================== ;; ;; * Emacs is distributed with a C program called movemail which can @@ -92,9 +20,7 @@ ;; includes support for the POP3 protocol. ;; ;; * rfc1939 describes the POP3 protocol. - - - +;; http://www.ietf.org/rfc/rfc1939.txt ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; Communication is initiated by the client. The server responds to