From afb65c6cf33cbd954586ae5225b7aa11858af312 Mon Sep 17 00:00:00 2001 From: Steve Holme Date: Sun, 5 Jan 2014 12:20:26 +0000 Subject: examples: Added POP3 RETR example --- docs/examples/Makefile.inc | 6 ++--- docs/examples/pop3-retr.c | 58 ++++++++++++++++++++++++++++++++++++++++++++++ docs/examples/pop3-ssl.c | 3 ++- 3 files changed, 63 insertions(+), 4 deletions(-) create mode 100644 docs/examples/pop3-retr.c (limited to 'docs') diff --git a/docs/examples/Makefile.inc b/docs/examples/Makefile.inc index d3ae10a39..1abd1778b 100644 --- a/docs/examples/Makefile.inc +++ b/docs/examples/Makefile.inc @@ -5,9 +5,9 @@ check_PROGRAMS = 10-at-a-time anyauthput cookie_interface debug fileupload \ persistant post-callback postit2 sepheaders simple simplepost simplessl \ sendrecv httpcustomheader certinfo chkspeed ftpgetinfo ftp-wildcard \ smtp-multi smtp-send smtp-ssl smtp-tls smtp-vrfy smtp-expn rtsp \ - externalsocket resolve progressfunc pop3-list pop3-ssl imap-list imap-fetch \ - imap-store imap-append imap-examine imap-search imap-create imap-delete \ - imap-copy imap-ssl imap-tls url2file sftpget ftpsget postinmemory + externalsocket resolve progressfunc pop3-retr pop3-list pop3-ssl imap-list \ + imap-fetch imap-store imap-append imap-examine imap-search imap-create \ + imap-delete imap-copy imap-ssl imap-tls url2file sftpget ftpsget postinmemory # These examples require external dependencies that may not be commonly # available on POSIX systems, so don't bother attempting to compile them here. diff --git a/docs/examples/pop3-retr.c b/docs/examples/pop3-retr.c new file mode 100644 index 000000000..e5a50f22d --- /dev/null +++ b/docs/examples/pop3-retr.c @@ -0,0 +1,58 @@ +/*************************************************************************** + * _ _ ____ _ + * Project ___| | | | _ \| | + * / __| | | | |_) | | + * | (__| |_| | _ <| |___ + * \___|\___/|_| \_\_____| + * + * Copyright (C) 1998 - 2014, Daniel Stenberg, , et al. + * + * This software is licensed as described in the file COPYING, which + * you should have received as part of this distribution. The terms + * are also available at http://curl.haxx.se/docs/copyright.html. + * + * You may opt to use, copy, modify, merge, publish, distribute and/or sell + * copies of the Software, and permit persons to whom the Software is + * furnished to do so, under the terms of the COPYING file. + * + * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY + * KIND, either express or implied. + * + ***************************************************************************/ +#include +#include + +/* This is a simple example showing how to retrieve mail using libcurl's POP3 + * capabilities. + * + * Note that this example requires libcurl 7.20.0 or above. + */ + +int main(void) +{ + CURL *curl; + CURLcode res = CURLE_OK; + + curl = curl_easy_init(); + if(curl) { + /* Set username and password */ + curl_easy_setopt(curl, CURLOPT_USERNAME, "user"); + curl_easy_setopt(curl, CURLOPT_PASSWORD, "secret"); + + /* This will retreive message 1 from the user's mailbox */ + curl_easy_setopt(curl, CURLOPT_URL, "pop3://pop.example.com/1"); + + /* Perform the retr */ + res = curl_easy_perform(curl); + + /* Check for errors */ + if(res != CURLE_OK) + fprintf(stderr, "curl_easy_perform() failed: %s\n", + curl_easy_strerror(res)); + + /* Always cleanup */ + curl_easy_cleanup(curl); + } + + return (int)res; +} diff --git a/docs/examples/pop3-ssl.c b/docs/examples/pop3-ssl.c index 5a20e3c07..81d4c2af1 100644 --- a/docs/examples/pop3-ssl.c +++ b/docs/examples/pop3-ssl.c @@ -23,7 +23,8 @@ #include /* This is a simple example showing how to retrieve mail using libcurl's POP3 - * capabilities. + * capabilities. It builds on the pop3-retr.c example adding transport + * security to protect the authentication details from being snooped. * * Note that this example requires libcurl 7.20.0 or above. */ -- cgit v1.2.3