/[libspopc]/libspopc.h

Diff of /libspopc.h

Parent Directory | Revision Log | View Patch Patch

-revision 2 by ben,
Thu Oct  8 15:37:49 2009 UTC
+revision 6 by ben,
Sun Apr 18 11:05:58 2010 UTC
 Line 32 
 extern "C" {
  #ifdef WIN32
  #include <winsock.h>
+ #if BUILDING_DLL
+ # define DLLIMPORT __declspec (dllexport)
+ #else /* Not BUILDING_DLL */
+ # define DLLIMPORT __declspec (dllimport)
+ #endif /* Not BUILDING_DLL */
  #else
  #include <sys/socket.h>
  #include <netinet/in.h>
  #include <netdb.h>
+ #define DLLIMPORT
  #endif
  /* thread-safe version of libspopc (>0.8) */
  /* call this function before to use any routine from libspopc */
- int libspopc_init(void);
+ DLLIMPORT int libspopc_init(void);
  /* call this function when you do not use anymore libspopc routines */
- int libspopc_clean(void);
+ DLLIMPORT int libspopc_clean(void);
  #ifdef USE_SSL
-Line 78 
 typedef pop3sock* pop3sock_t;
+Line 84 
 typedef pop3sock* pop3sock_t;
   * Hint: If you have a recent version of curl/libcurl installed, you can try
   * setting this to the output of:  "curl-config --ca"
   ******************************************************************************/
- void pop3_cert_setup(const char *certfile);
+ DLLIMPORT void pop3_cert_setup(const char *certfile);
  /******************************************************************************
   * pop3_ssl_never() disable the use of SSL on any port, even 995.
-Line 90 
 void pop3_cert_setup(const char *certfil
+Line 96 
 void pop3_cert_setup(const char *certfil
   * By default, not calling any of these, the behaviour of libspopc follows
   * the same as pop3_ssl_auto() for backward compatibility reason.
   ******************************************************************************/
- void pop3_ssl_never(void);
+ DLLIMPORT void pop3_ssl_never(void);
- void pop3_ssl_auto(void);
+ DLLIMPORT void pop3_ssl_auto(void);
- void pop3_ssl_always(void);
+ DLLIMPORT void pop3_ssl_always(void);
  #else /* Non-SSL */
-Line 127 
 typedef int pop3sock_t;
+Line 133 
 typedef int pop3sock_t;
   * connecting *
   **************/
- pop3sock_t pop3_prepare(const char* servername, const int port, struct sockaddr_in* connection, struct hostent* server);
+ DLLIMPORT pop3sock_t pop3_prepare(const char* servername, const int port, struct sockaddr_in* connection, struct hostent* server);
  /* prepares the pop session and returns a socket descriptor, or BAD_SOCK on error */
- char* pop3_connect(pop3sock_t sock, struct sockaddr_in* connection);
+ DLLIMPORT char* pop3_connect(pop3sock_t sock, struct sockaddr_in* connection);
  /* connects to the server through the sock and returns server's welcome */
- void pop3_disconnect(pop3sock_t sock, struct hostent* server);
+ DLLIMPORT void pop3_disconnect(pop3sock_t sock, struct hostent* server);
  /* close socket and free server info */
-Line 141 
 void pop3_disconnect(pop3sock_t sock, st
+Line 147 
 void pop3_disconnect(pop3sock_t sock, st
   * pop3 queries *
   ****************/
- char* pop3_user(pop3sock_t sock, const char* name);
+ DLLIMPORT char* pop3_user(pop3sock_t sock, const char* name);
  /* performs "USER" pop query and returns server's <=512 bytes resp */
- char* pop3_pass(pop3sock_t sock, const char* pw);
+ DLLIMPORT char* pop3_pass(pop3sock_t sock, const char* pw);
  /* performs "PASS" pop query and return server's <=512 bytes resp */
- char* pop3_quit(pop3sock_t sock);
+ DLLIMPORT char* pop3_quit(pop3sock_t sock);
  /* performs "QUIT" pop query and returns server's <=512 bytes resp */
- char* pop3_stat(pop3sock_t sock);
+ DLLIMPORT char* pop3_stat(pop3sock_t sock);
  /* performs "STAT" pop query and returns server's <=512 bytes resp */
- char* pop3_list(pop3sock_t sock, int id);
+ DLLIMPORT char* pop3_list(pop3sock_t sock, int id);
  /* performs a "LIST" pop query and returns server's (long) resp */
- char* pop3_retr(pop3sock_t sock, int id);
+ DLLIMPORT char* pop3_retr(pop3sock_t sock, int id);
  /* performs a "RETR" pop query and returns server's (long) resp */
- char* pop3_dele(pop3sock_t sock, int id);
+ DLLIMPORT char* pop3_dele(pop3sock_t sock, int id);
  /* performs a "DELE" pop query and returns server's <=512 bytes resp */
- char* pop3_noop(pop3sock_t sock);
+ DLLIMPORT char* pop3_noop(pop3sock_t sock);
  /* performs a "NOOP" pop query and returns server's <=512 bytes resp */
- char* pop3_rset(pop3sock_t sock);
+ DLLIMPORT char* pop3_rset(pop3sock_t sock);
  /* performs a "RSET" pop query and returns server's <=512 bytes resp */
- char* pop3_top(pop3sock_t sock, int id, int lines);
+ DLLIMPORT char* pop3_top(pop3sock_t sock, int id, int lines);
  /* performs a "TOP" pop query and returns server's (long) resp */
- char* pop3_uidl(pop3sock_t sock, int id);
+ DLLIMPORT char* pop3_uidl(pop3sock_t sock, int id);
  /* performs a "UIDL" pop query and returns server's (long) resp */
- char* pop3_apop(pop3sock_t sock, const char* name, const char* digest);
+ DLLIMPORT char* pop3_apop(pop3sock_t sock, const char* name, const char* digest);
  /* performs a "APOP" secure pop query and returns server's <=512 bytes resp */
-Line 188 
 int dotline(char* buf);
+Line 194 
 int dotline(char* buf);
  /* returns 1 if 'buf' contains a "\n.\n" or "\n.\0" or \r.(etc) substring
   * buf must be terminated by '\0' */
- int pop3_error(char* string);
+ DLLIMPORT int pop3_error(char* string);
  /* returns 1 on pop server error (i.e : -ERR ...) or NULL reply */
  /************************************
   * reply re-formatting, after query *
   ************************************/
- char* nextline(char* string);
+ DLLIMPORT char* nextline(char* string);
  /* returns a pointer to the next line of given string */
- char* retr2msg(char* data);
+ DLLIMPORT char* retr2msg(char* data);
  /* returns formatted mail from a pop RETR X query
   * must only be called on data returned by pop3_retr() */
- void freemsg(char* msg);
+ DLLIMPORT void freemsg(char* msg);
  /* free the message received by reetr2msg */
- int* list2array(char* poplist);
+ DLLIMPORT int* list2array(char* poplist);
  /* WARNING: must not be called after a mail deletion
   * returns an int array of sizes of messages from a LIST pop query
   * array[0] holds id of the array's last element
   * must only be called on data received by a pop3_list(sock,0) request */
- void freelistarray(int* array);
+ DLLIMPORT void freelistarray(int* array);
  /* free the message sizes array created by list2array */
- int listi2size(char* resp);
+ DLLIMPORT int listi2size(char* resp);
  /* grep the given size (in bytes) in resp after a pop3_list(sock,ID) request
   * do not use after a pop3_list(sock,0) ! */
- int stat2num(char* resp);
+ DLLIMPORT int stat2num(char* resp);
  /* returns the number of downloadable messages on pop server */
- int stat2bytes(char* resp);
+ DLLIMPORT int stat2bytes(char* resp);
  /* returns the sumsize in bytes of all stored messages on server
   * must only be called just after a pop3_stat() request */
- char** uidl2array(char* resp);
+ DLLIMPORT char** uidl2array(char* resp);
  /* WARNING: mus not be called after a mail deletion
   * returns an array of unique strings for each message id
   * array[0] gives array's last id
   * must only be called just after a pop3_uidl(sock,0) request */
- void freeuidlarray(char** arrray);
+ DLLIMPORT void freeuidlarray(char** arrray);
  /* free the uidl array created by uidl2array */
- char* uidli2sig(char* resp);
+ DLLIMPORT char* uidli2sig(char* resp);
  /* grep the pop signature of *one* message signature reply
   * should only be called on data received by a pop3_uidl(sock,ID) request
   * do not use it after a pop3_uidl(sock,0) ! */
-Line 284 
 typedef struct{
+Line 290 
 typedef struct{
  #define popmsguid(s,i) ((s)->uidl[(i)])
  /* points to the 'char*' uid (unique signature) of 'int'(i) message id */
- int poplast(popsession* session);
+ DLLIMPORT int poplast(popsession* session);
  /* gives the id of the last message of the current session */
- int popnum(popsession* session);
+ DLLIMPORT int popnum(popsession* session);
  /* gives the current number of stored message. it is != to poplast() */
- char* popbegin(const char* servername,const char* user, const char* pass, popsession** sp);
+ DLLIMPORT char* popbegin(const char* servername,const char* user, const char* pass, popsession** sp);
  /* prepares, connect and get lists of messages stored on pop server
   * you must give a valid servername, user and pass
   * returns an error message if a problem occurs, else NULL */
- char* popgethead(popsession* session, int id);
+ DLLIMPORT char* popgethead(popsession* session, int id);
  /* returns the header of a message (id between 1 and poplast()) or NULL on bad id */
- char* popgetmsg(popsession* session, int id);
+ DLLIMPORT char* popgetmsg(popsession* session, int id);
  /* returns a message (id between 1 and poplast()) or NULL on bad id */
- int popdelmsg(popsession* session, int id);
+ DLLIMPORT int popdelmsg(popsession* session, int id);
  /* deletes message 'id' on pop server
   * returns -1 on server error, 0 else */
- int popchkmsg(popsession* session, int id);
+ DLLIMPORT int popchkmsg(popsession* session, int id);
  /* tells if a message is still accessible on the server (not deleted)
   * returns 1 of so, or 0 if message has been marked for deletion */
- int popcancel(popsession* session);
+ DLLIMPORT int popcancel(popsession* session);
  /* cancels all previous deletion on pop server
   * returns -1 on server error, 0 else */
- int popsync(popsession* session);
+ DLLIMPORT int popsync(popsession* session);
  /* re-synchronize the session object from the server
   * need to be called if session->sync is 0
   * returns -1 on error, 0 else */
- void popend(popsession* session);
+ DLLIMPORT void popend(popsession* session);
  /* quit and destroys pop session */
  #ifdef __cplusplus

 Legend:



Removed from v.2
 


changed lines


 
Added in v.6
 Legend:



Removed from v.2
 


changed lines


 
Added in v.6
-Removed from v.2
+Added in v.6

	ViewVC Help
Powered by ViewVC 1.1.26