lib/README.pingpong

   1 Date: December 5, 2009
   2
   3 Pingpong
   4 ========
   5
   6  Pingpong is just my (Daniel's) jestful collective name on the protocols that
   7  share a very similar kind of back-and-forth procedure with command and
   8  responses to and from the server. FTP was previously the only protocol in
   9  that family that libcurl supported, but when POP3, IMAP and SMTP joined the
  10  team I moved some of the internals into a separate pingpong module to be
  11  easier to get used by all these protocols to reduce code duplication and ease
  12  code re-use between these protocols.
  13
  14 FTP
  15
  16  In 7.20.0 we converted code to use the new pingpong code from previously
  17  having been all "native" FTP code.
  18
  19 POP3
  20
  21  There's no support in the documented URL format to specify the exact mail to
  22  get, but we support that as the path specified in the URL.
  23
  24 IMAP
  25
  26 SMTP
  27
  28  There's no official URL syntax defined for SMTP, but we use only the generic
  29  one and we provide two additional libcurl options to specify receivers and
  30  sender of the actual mail.