* Unfinished code is now disabled.
[citadel.git] / webcit / webcit.h
index 6c306050cb059b57d5b5c7731e79599861b7bce3..a324f6c98b3fae240c23cb47dd2227e38a7d0165 100644 (file)
@@ -1,9 +1,10 @@
 /* $Id$ */
 
-/** we need _GNU_SOURCE for various functions arround the NLS-Stuff */
-#define _GNU_SOURCE
+#include "sysdep.h"
 
 
+#include <sys/select.h>
+
 #include <ctype.h>
 #include <stdlib.h>
 #ifdef HAVE_UNISTD_H
@@ -37,6 +38,8 @@
 #include <signal.h>
 #include <sys/utsname.h>
 
+#include <libcitadel.h>
+
 #ifndef INADDR_NONE
 #define INADDR_NONE 0xffffffff
 #endif
@@ -54,6 +57,7 @@ extern locale_t wc_locales[];
 #define _(string)      (string)
 #endif
 
+#define IsEmptyStr(a) ((a)[0] == '\0')
 /*
  * Uncomment to dump an HTTP trace to stderr
 #define HTTP_TRACING 1
@@ -68,42 +72,35 @@ extern locale_t wc_locales[];
 #include <zlib.h>
 #endif
 
-#ifdef HAVE_ICAL_H
-#ifdef HAVE_LIBICAL
-#define WEBCIT_WITH_CALENDAR_SERVICE 1
-#endif
-#endif
-
-
 
-#ifdef WEBCIT_WITH_CALENDAR_SERVICE
 /* Work around PACKAGE/VERSION defs that are (not supposed to be?) in ical.h */
 #ifdef PACKAGE
 # define CTDL_PACKAGE PACKAGE
 # undef PACKAGE
 #endif
+
+#ifdef PACKAGE_STRING
+# define CTDL_PACKAGE_STRING PACKAGE_STRING
+//# undef PACKAGE_STRING
+#endif
+
 #ifdef VERSION
 # define CTDL_VERSION VERSION
 # undef VERSION
 #endif
+
 #include <ical.h>
-#ifdef CTDL_PACKAGE
-# ifdef PACKAGE
-#  undef PACKAGE
-# endif
-# define PACKAGE CTDL_PACKAGE
-# undef CTDL_PACKAGE
-#endif
-#ifdef CTDL_VERSION
-# ifdef VERSION
-#  undef VERSION
-# endif
-# define VERSION CTDL_VERSION
-# undef CTDL_VERSION
-#endif
-#endif
 
+#undef PACKAGE
+#undef VERSION
+#undef PACKAGE_NAME
+#undef PACKAGE_STRING
+#undef PACKAGE_TARNAME
+#undef PACKAGE_VERSION
+#undef PACKAGE_BUGREPORT
+#include "sysdep.h"
 
+////////#include "hash.h"
 
 #ifdef HAVE_OPENSSL
 /* Work around RedHat's b0rken OpenSSL includes */
@@ -123,11 +120,11 @@ extern locale_t wc_locales[];
 #define SLEEPING               180             /* TCP connection timeout */
 #define WEBCIT_TIMEOUT         900             /* WebCit session timeout */
 #define PORT_NUM               2000            /* port number to listen on */
-#define SERVER                 "WebCit v6.71"  /* who's in da house */
 #define DEVELOPER_ID           0
 #define CLIENT_ID              4
-#define CLIENT_VERSION         671             /* This version of WebCit */
-#define MINIMUM_CIT_VERSION    671             /* min required Citadel ver. */
+#define CLIENT_VERSION         723             /* This version of WebCit */
+#define MINIMUM_CIT_VERSION    723             /* min required Citadel ver */
+#define        LIBCITADEL_MIN          103             /* min required libcitadel ver */
 #define DEFAULT_HOST           "localhost"     /* Default Citadel server */
 #define DEFAULT_PORT           "504"
 #define LB                     (1)             /* Internal escape chars */
@@ -148,27 +145,31 @@ extern locale_t wc_locales[];
  *
  * bucket one...
  */
-#define QR_PERMANENT   1               /**< Room does not purge              */
-#define QR_INUSE           2           /**< Set if in use, clear if avail    */
-#define QR_PRIVATE         4           /**< Set for any type of private room */
-#define QR_PASSWORDED  8               /**< Set if there's a password too    */
-#define QR_GUESSNAME   16              /**< Set if it's a guessname room     */
-#define QR_DIRECTORY   32              /**< Directory room                */
-#define QR_UPLOAD      64              /**< Allowed to upload          */
-#define QR_DOWNLOAD    128                 /**< Allowed to download          */
-#define QR_VISDIR      256                 /**< Visible directory              */
-#define QR_ANONONLY    512                 /**< Anonymous-Only room          */
-#define QR_ANONOPT     1024            /**< Anonymous-Option room          */
-#define QR_NETWORK     2048            /**< Shared network room              */
-#define QR_PREFONLY    4096            /**< Preferred status needed to enter */
-#define QR_READONLY    8192            /**< Aide status required to post     */
-#define QR_MAILBOX     16384           /**< Set if this is a private mailbox */
+#define QR_PERMANENT   1               /**< Room does not purge                */
+#define QR_INUSE       2               /**< Set if in use, clear if avail      */
+#define QR_PRIVATE     4               /**< Set for any type of private room   */
+#define QR_PASSWORDED  8               /**< Set if there's a password too      */
+#define QR_GUESSNAME   16              /**< Set if it's a guessname room       */
+#define QR_DIRECTORY   32              /**< Directory room                     */
+#define QR_UPLOAD      64              /**< Allowed to upload                  */
+#define QR_DOWNLOAD    128             /**< Allowed to download                */
+#define QR_VISDIR      256             /**< Visible directory                  */
+#define QR_ANONONLY    512             /**< Anonymous-Only room                */
+#define QR_ANONOPT     1024            /**< Anonymous-Option room              */
+#define QR_NETWORK     2048            /**< Shared network room                */
+#define QR_PREFONLY    4096            /**< Preferred status needed to enter   */
+#define QR_READONLY    8192            /**< Aide status required to post       */
+#define QR_MAILBOX     16384           /**< Set if this is a private mailbox   */
 
 /**
  * bucket two...
  */
-#define QR2_SYSTEM     1               /**< System room; hide by default     */
-#define QR2_SELFLIST   2               /**< Self-service mailing list mgmt   */
+#define QR2_SYSTEM     1               /**< System room; hide by default       */
+#define QR2_SELFLIST   2               /**< Self-service mailing list mgmt     */
+#define QR2_COLLABDEL  4               /**< Anyone who can post can also delete*/
+#define QR2_SUBJECTREQ  8               /**< Subject strongly recommended */
+#define QR2_SMTP_PUBLIC 16              /* smtp public postable room */
+#define QR2_MODERATED  32              /* Listservice aide has to permit posts  */
 
 /**
  * user/room access
@@ -182,55 +183,63 @@ extern locale_t wc_locales[];
 /**
  * User flags (from Citadel)
  */
-#define US_NEEDVALID   1               /**< User needs to be validated       */
-#define US_PERM                4                   /**< Permanent user                   */
-#define US_LASTOLD     16                  /**< Print last old message with new  */
-#define US_EXPERT      32                  /**< Experienced user                   */
-#define US_UNLISTED    64                  /**< Unlisted userlog entry           */
-#define US_NOPROMPT    128                 /**< Don't prompt after each message  */
-#define US_PROMPTCTL   256             /**< <N>ext & <S>top work at prompt   */
-#define US_DISAPPEAR   512             /**< Use "disappearing msg prompts"   */
-#define US_REGIS       1024            /**< Registered user                  */
-#define US_PAGINATOR   2048    /**< Pause after each screen of text  */
-#define US_INTERNET    4096            /**< Internet mail privileges         */
-#define US_FLOORS      8192            /**< User wants to see floors         */
-#define US_COLOR       16384           /**< User wants ANSI color support    */
+#define US_NEEDVALID   1               /**< User needs to be validated         */
+#define US_PERM                4               /**< Permanent user                     */
+#define US_LASTOLD     16              /**< Print last old message with new    */
+#define US_EXPERT      32              /**< Experienced user                   */
+#define US_UNLISTED    64              /**< Unlisted userlog entry             */
+#define US_NOPROMPT    128             /**< Don't prompt after each message    */
+#define US_PROMPTCTL   256             /**< <N>ext & <S>top work at prompt     */
+#define US_DISAPPEAR   512             /**< Use "disappearing msg prompts"     */
+#define US_REGIS       1024            /**< Registered user                    */
+#define US_PAGINATOR   2048            /**< Pause after each screen of text    */
+#define US_INTERNET    4096            /**< Internet mail privileges           */
+#define US_FLOORS      8192            /**< User wants to see floors           */
+#define US_COLOR       16384           /**< User wants ANSI color support      */
 #define US_USER_SET    (US_LASTOLD | US_EXPERT | US_UNLISTED | \
                        US_NOPROMPT | US_DISAPPEAR | US_PAGINATOR | \
                        US_FLOORS | US_COLOR | US_PROMPTCTL )
 
+/*
+ * NLI is the string that shows up in a who's online listing for sessions
+ * that are active, but for which no user has yet authenticated.
+ */
+#define NLI    "(not logged in)"
 
 
-/** \brief http request struct ??? */
+/** \brief     Linked list of lines appearing in an HTTP client request */
 struct httprequest {
-       struct httprequest *next;  /**< the next request in the list ??? */
-       char line[SIZ];            /**< the request line ??? */
+       struct httprequest *next;  /**< the next request in the list */
+       char line[SIZ];            /**< the request line */
 };
 
 /**
- * \brief contents of an url???
+ * \brief      Linked list of session variables encoded in an x-www-urlencoded content type
  */
 struct urlcontent {
-       struct urlcontent *next;   /**< the next url in the list */ 
-       char url_key[32];          /**< the url directory part */
-       char *url_data;            /**< the url data part ??? */
+       struct urlcontent *next;   /**< the next variable in the list */ 
+       char url_key[32];          /**< the variable name */
+       char *url_data;            /**< its value */
 };
 
 /**
  * \brief information about us ???
  */ 
 struct serv_info {
-       int serv_pid;              /**< Our process id */
-       char serv_nodename[32];    /**< How is the name of this citadel */
-       char serv_humannode[64];   /**< How is the human readable name of this citadel */
-       char serv_fqdn[64];                /**< How is our Full quallified Domain Name (uncensored.citadel.org ie.e  */
-       char serv_software[64];    /**< What version does our connected citadel server use */
-       int serv_rev_level;                /**< Whats the citadel server revision */
-       char serv_bbs_city[64];    /**< Where is the dialin node */
-       char serv_sysadm[64];      /**< Who's to blame on trouble */
-       char serv_moreprompt[SIZ]; /**< Whats the commandline textprompt */
-       int serv_ok_floors;                /**< what??? */
-       int serv_supports_ldap;    /**< is the server linked against an ldap tree for adresses? */
+       int serv_pid;                   /* Process ID of the Citadel server */
+       char serv_nodename[32];         /* Node name of the Citadel server */
+       char serv_humannode[64];        /* human readable node name of the Citadel server */
+       char serv_fqdn[64];             /* fully quallified Domain Name (such as uncensored.citadel.org) */
+       char serv_software[64];         /* What version does our connected citadel server use */
+       int serv_rev_level;             /* Whats the citadel server revision */
+       char serv_bbs_city[64];         /* Geographic location of the Citadel server */
+       char serv_sysadm[64];           /* Name of system administrator */
+       char serv_moreprompt[256];      /* Whats the commandline textprompt */
+       int serv_ok_floors;             /* nonzero == server supports floors */
+       int serv_supports_ldap;         /* is the server linked against an ldap tree for adresses? */
+       int serv_newuser_disabled;      /* Has the server disabled self-service new user creation? */
+       char serv_default_cal_zone[128];/* Default timezone for unspecified calendar items */
+       int serv_supports_sieve;        /* Does the server support Sieve mail filtering? */
 };
 
 
@@ -240,22 +249,22 @@ struct serv_info {
  */
 struct march {
        struct march *next;       /**< pointer to next in linked list */
-       char march_name[128];     /**< function name ??? */
-       int march_floor;          /**< floor number */
-       int march_order;          /**< order number???*/
+       char march_name[128];     /**< name of room */
+       int march_floor;          /**< floor number of room */
+       int march_order;          /**< sequence in which we are to visit this room */
 };
 
 /* *
- * \brief This struct holds a list of rooms for client display.
- * (oooh, a tree!) (double linked list? )
+ * \brief      This struct holds a list of rooms for client display.
+ *             It is a binary tree.
  */
 struct roomlisting {
-       struct roomlisting *lnext;/**< pointer to the next roomlisting */
-       struct roomlisting *rnext;/**< pointer to the previous roomlisting */
-       char rlname[128];                 /**< the userprintable roomname */
-       unsigned rlflags;                 /**< the room flags */
-       int rlfloor;                      /**< the floor it reside on (citadel server room number???)*/
-       int rlorder;              /**< the order to print it???*/
+       struct roomlisting *lnext;      /**< pointer to 'left' tree node */
+       struct roomlisting *rnext;      /**< pointer to 'right' tree node */
+       char rlname[128];               /**< name of room */
+       unsigned rlflags;               /**< room flags */
+       int rlfloor;                    /**< the floor it resides on */
+       int rlorder;                    /**< room listing order */
 };
 
 
@@ -315,6 +324,7 @@ struct folder {
        int is_mailbox; /**< is it a mailbox?  */
        int selectable; /**< can we select it ??? */
        int view;       /**< whats its default view? inbox/calendar.... */
+       int num_rooms;  /**< If this is a floor, how many rooms does it have */
 };
 
 /**
@@ -337,6 +347,7 @@ struct wcsession {
        int serv_sock;                          /**< Client socket to Citadel server */
        int chat_sock;                          /**< Client socket to Citadel server - for chat */
        unsigned room_flags;                    /**< flags associated with the current room */
+       unsigned room_flags2;                   /**< flags associated with the current room */
        int wc_view;                            /**< view for the current room */
        int wc_default_view;                    /**< default view for the current room */
        int wc_is_trash;                        /**< nonzero == current room is a Trash folder */
@@ -365,7 +376,7 @@ struct wcsession {
        struct wcsubst *vars;                   /**< HTTP variable substitutions for this page */
        char this_page[512];                    /**< URL of current page */
        char http_host[512];                    /**< HTTP Host: header */
-       char *preferences;                      /**< WebCit preferences for this user */
+       HashList *hash_prefs;                   /**< WebCit preferences for this user */
 #ifdef WEBCIT_WITH_CALENDAR_SERVICE            
        /** \brief ical???? */                          
        struct disp_cal {                                       
@@ -393,6 +404,8 @@ struct wcsession {
        char floordiv_expanded[32];             /**< which floordiv currently expanded */
        int selected_language;                  /**< Language selected by user */
        time_t last_pager_check;                /**< last time we polled for instant msgs */
+       int nonce;                              /**< session nonce (to prevent session riding) */
+       int time_format_cache;                  /**< which timeformat does our user like? */
 };
 
 /** values for WC->current_iconbar */
@@ -400,9 +413,15 @@ enum {
        current_iconbar_menu,     /**< view the icon menue */
        current_iconbar_roomlist  /**< view the roomtree */
 };
+enum {
+       S_SELECT,
+       S_SHUTDOWN,
+       MAX_SEMAPHORES
+};
 
-
+#ifndef num_parms
 #define num_parms(source)              num_tokens(source, '|') 
+#endif
 
 /* Per-session data */
 #define WC ((struct wcsession *)pthread_getspecific(MyConKey))
@@ -412,6 +431,10 @@ extern pthread_key_t MyConKey;
 #ifdef HAVE_OPENSSL
 #define THREADSSL ((SSL *)pthread_getspecific(ThreadSSL))
 extern pthread_key_t ThreadSSL;
+extern char ctdl_key_dir[PATH_MAX];
+extern char file_crpt_file_key[PATH_MAX];
+extern char file_crpt_file_csr[PATH_MAX];
+extern char file_crpt_file_cer[PATH_MAX];
 #endif
 
 struct serv_info serv_info;
@@ -427,7 +450,13 @@ extern time_t if_modified_since;
 extern int follow_xff;
 void do_setup_wizard(void);
 
-void stuff_to_cookie(char *cookie, int session,
+
+void InitialiseSemaphores(void);
+void begin_critical_section(int which_one);
+void end_critical_section(int which_one);
+
+
+void stuff_to_cookie(char *cookie, size_t clen, int session,
                        char *user, char *pass, char *room);
 void cookie_to_stuff(char *cookie, int *session,
                 char *user, size_t user_len,
@@ -441,6 +470,7 @@ void do_welcome(void);
 void do_logout(void);
 void display_main_menu(void);
 void display_aide_menu(void);
+void display_shutdown(void);
 void display_advanced_menu(void);
 void slrp_highest(void);
 void gotonext(void);
@@ -452,14 +482,18 @@ void serv_getln(char *strbuf, int bufsize);
 void serv_puts(char *string);
 void who(void);
 void who_inner_div(void);
+void wholist_section(void);
+void tasks_section(void);
+void calendar_section(void);
+void ajax_mini_calendar(void);
+void new_messages_section(void);
 void fmout(char *align);
 void pullquote_fmout(void);
 void wDumpContent(int);
 void serv_printf(const char *format,...);
 char *bstr(char *key);
-void urlesc(char *, char *);
 void urlescputs(char *);
-void jsesc(char *, char *);
+void jsesc(char *, size_t, char *);
 void jsescputs(char *);
 void output_headers(    int do_httpheaders,
                        int do_htmlhead,
@@ -469,19 +503,18 @@ void output_headers(    int do_httpheaders,
                        int cache);
 void wprintf(const char *format,...);
 void output_static(char *what);
-void stresc(char *target, char *strbuf, int nbsp, int nolinebreaks);
+void print_menu_box(char* Title, char *Class, int nLines, ...);
+long stresc(char *target, long tSize, char *strbuf, int nbsp, int nolinebreaks);
 void escputs(char *strbuf);
 void url(char *buf);
 void escputs1(char *strbuf, int nbsp, int nolinebreaks);
-void msgesc(char *target, char *strbuf);
+void msgesc(char *target, size_t tlen, char *strbuf);
 void msgescputs(char *strbuf);
-int extract_int(const char *source, int parmnum);
-long extract_long(const char *source, int parmnum);
+void msgescputs1(char *strbuf);
 void stripout(char *str, char leftboundary, char rightboundary);
 void dump_vars(void);
 void embed_main_menu(void);
 void serv_read(char *buf, int bytes);
-int haschar(char *, char);
 void readloop(char *oper);
 void read_message(long msgnum, int printable_view, char *section);
 void embed_message(char *msgnum_as_string);
@@ -539,8 +572,9 @@ void display_netconf(void);
 void display_confirm_delete_node(void);
 void delete_node(void);
 void display_add_node(void);
-void add_node(void);
 void terminate_session(void);
+void shutdown_sessions(void);
+void do_housekeeping(void);
 void edit_me(void);
 void display_siteconfig(void);
 void siteconfig(void);
@@ -552,7 +586,6 @@ void smart_goto(char *);
 void worker_entry(void);
 void session_loop(struct httprequest *);
 size_t wc_strftime(char *s, size_t max, const char *format, const struct tm *tm);
-void fmt_date(char *buf, time_t thetime, int brief);
 void fmt_time(char *buf, time_t thetime);
 void httpdate(char *buf, time_t thetime);
 time_t httpdate_to_timestamp(char *buf);
@@ -561,21 +594,23 @@ void page_popup(void);
 void chat_recv(void);
 void chat_send(void);
 void http_redirect(char *);
+void clear_substs(struct wcsession *wc);
 void clear_local_substs(void);
 void svprintf(char *keyname, int keytype, const char *format,...);
 void svcallback(char *keyname, void (*fcn_ptr)() );
 void do_template(void *templatename);
 int lingering_close(int fd);
 char *memreadline(char *start, char *buf, int maxlen);
-int num_tokens (char *source, char tok);
-void extract_token(char *dest, const char *source, int parmnum, char separator, int maxlen);
+char *memreadlinelen(char *start, char *buf, int maxlen, int *retlen);
+long extract_token(char *dest, const char *source, int parmnum, char separator, int maxlen);
 void remove_token(char *source, int parmnum, char separator);
 char *load_mimepart(long msgnum, char *partnum);
 int pattern2(char *search, char *patn);
-void do_edit_vcard(long, char *, char *);
+void do_edit_vcard(long, char *, char *, char *);
 void edit_vcard(void);
 void submit_vcard(void);
 void striplt(char *);
+void stripltlen(char *, int *);
 void select_user_to_edit(char *message, char *preselect);
 void delete_user(char *);
 void display_edituser(char *who, int is_new);
@@ -615,23 +650,38 @@ void do_tasks_view(void);
 void free_calendar_buffer(void);
 void calendar_summary_view(void);
 int load_msg_ptrs(char *servcmd, int with_headers);
-void CtdlEncodeBase64(char *dest, const char *source, size_t sourcelen);
-int CtdlDecodeBase64(char *dest, const char *source, size_t length);
 void free_attachments(struct wcsession *sess);
 void free_march_list(struct wcsession *wcf);
 void set_room_policy(void);
 void display_inetconf(void);
 void save_inetconf(void);
+void display_smtpqueue(void);
+void display_smtpqueue_inner_div(void);
+void display_sieve(void);
+void display_rules_editor_inner_div(void);
+void save_sieve(void);
+void display_pushemail(void);
+void save_pushemail(void);
+void display_add_remove_scripts(char *);
+void create_script(void);
+void delete_script(void);
 void generate_uuid(char *);
 void CtdlMakeTempFileName(char *, int);
 void display_preferences(void);
 void set_preferences(void);
 void recp_autocomplete(char *);
+void address_book_popup(void);
+void display_address_book_middle_div(void);
+void display_address_book_inner_div(void);
 void begin_ajax_response(void);
 void end_ajax_response(void);
 void initialize_viewdefs(void);
 void initialize_axdefs(void);
+void burn_folder_cache(time_t age);
 void list_all_rooms_by_floor(char *viewpref);
+void display_room_directory(void);
+void download_file(char *);
+void upload_file(void);
 
 #ifdef WEBCIT_WITH_CALENDAR_SERVICE
 void display_edit_task(void);
@@ -650,6 +700,12 @@ void partstat_as_string(char *buf, icalproperty *attendee);
 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp);
 void check_attendee_availability(icalcomponent *supplied_vevent);
 void do_freebusy(char *req);
+int ical_ctdl_is_overlap(
+                        struct icaltimetype t1start,
+                        struct icaltimetype t1end,
+                        struct icaltimetype t2start,
+                        struct icaltimetype t2end
+);
 #endif
 
 #ifdef ENABLE_NLS
@@ -685,6 +741,9 @@ void begin_tab(int tabnum, int num_tabs);
 void end_tab(int tabnum, int num_tabs);
 void str_wiki_index(char *s);
 void display_wiki_page(void);
+int get_time_format_cached (void);
+int xtoi(char *in, size_t len);
+void webcit_fmt_date(char *buf, time_t thetime, int brief);
 
 #ifdef HAVE_ICONV
 iconv_t ctdl_iconv_open(const char *tocode, const char *fromcode);
@@ -711,7 +770,7 @@ void client_write_ssl(char *buf, int nbytes);
 
 #ifdef HAVE_ZLIB
 #include <zlib.h>
-int ZEXPORT compress_gzip(Bytef * dest, uLongf * destLen,
+int ZEXPORT compress_gzip(Bytef * dest, size_t * destLen,
                           const Bytef * source, uLong sourceLen, int level);
 #endif
 
@@ -727,18 +786,20 @@ extern char *hourname[];  /**< Names of hours (12am, 1am, etc.) */
 void http_datestring(char *buf, size_t n, time_t xtime);
 
 
-/** Views (from citadel.h) */
-#define        VIEW_BBS                0       /**< Traditional Citadel BBS view */
-#define VIEW_MAILBOX           1       /**< Mailbox summary */
-#define VIEW_ADDRESSBOOK       2       /**< Address book view */
-#define VIEW_CALENDAR          3       /**< Calendar view */
-#define VIEW_TASKS             4       /**< Tasks view */
-#define VIEW_NOTES             5       /**<  Notes view */
-#define VIEW_WIKI              6       /**<  Wiki view */
-#define VIEW_CALBRIEF          7       /**< Brief Calendar view */
-
-
 /* These should be empty, but we have them for testing */
 #define DEFAULT_HTTPAUTH_USER  ""
 #define DEFAULT_HTTPAUTH_PASS  ""
 
+
+/* Exit codes 101 through 109 are initialization failures so we don't want to
+ * just keep respawning indefinitely.
+ */
+#define WC_EXIT_BIND           101     /* Can't bind to the port */
+#define WC_EXIT_SSL            102     /* Can't initialize SSL */
+
+
+#define WC_TIMEFORMAT_NONE 0
+#define WC_TIMEFORMAT_AMPM 1
+#define WC_TIMEFORMAT_24 2
+
+