src/local-def.h

   1 /*
   2    local-def.h -- provide a REST/HTTP interface
   3
   4    Copyright (C) 2015, Fulup Ar Foll
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 2 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program; if not, write to the Free Software
  18    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19
  20 */
  21 #ifndef LOCAL_DEF_H
  22 #define LOCAL_DEF_H
  23
  24 #include <json.h>
  25 #include <microhttpd.h>
  26
  27 /* other definitions --------------------------------------------------- */
  28
  29 // Note: because of a bug in libmagic MAGIC_DB NULL should not be used for default
  30 #define OPA_INDEX "index.html"
  31 #define MAX_ALIAS 10           // max number of aliases
  32 #define COOKIE_NAME   "afb-session"
  33
  34 #define DEFLT_CNTX_TIMEOUT  3600   // default Client Connection Timeout
  35 #define DEFLT_API_TIMEOUT   0      // default Plugin API Timeout [0=NoLimit for Debug Only]
  36 #define DEFLT_API_TIMEOUT   0      // default Plugin API Timeout
  37 #define DEFLT_CACHE_TIMEOUT 100000 // default Static File Chache [Client Side Cache 100000~=1day]
  38 #define DEFLT_AUTH_TOKEN    NULL   // expect for debug should == NULL
  39 #define DEFLT_HTTP_TIMEOUT  15     // Max MibMicroHttp timeout
  40 #define AFB_MAX_PLUGINS     20     // Max number of plugins for a given binder
  41
  42 #define MAX_POST_SIZE  4096   // maximum size for POST data
  43 #define CTX_NBCLIENTS   10   // allow a default of 10 authenticated clients
  44
  45
  46
  47
  48
  49 enum AFB_Mode;
  50
  51
  52 typedef struct {
  53   char  *url;
  54   char  *path;
  55   size_t len;
  56 } AFB_aliasdir;
  57
  58 // main config structure
  59 struct AFB_config
  60 {
  61   char *console;           // console device name (can be a file or a tty)
  62   int   httpdPort;
  63   char *ldpaths;           // list of plugins directories
  64   char *rootdir;           // base dir for httpd file download
  65   char *rootbase;          // Angular HTML5 base URL
  66   char *rootapi;           // Base URL for REST APIs
  67   char *sessiondir;        // where to store mixer session files
  68   char *token;             // initial authentication token [default NULL no session]
  69   int  cacheTimeout;
  70   int  apiTimeout;
  71   int  cntxTimeout;        // Client Session Context timeout
  72   int mode;           // mode of listening
  73   AFB_aliasdir *aliasdir;  // alias mapping for icons,apps,...
  74 };
  75
  76 // MHD_lookup_connection_value(connection, MHD_GET_ARGUMENT_KIND, "value");
  77 typedef struct {
  78   const char *uuid;
  79   const char *url;
  80   const char *prefix;              // plugin convivial name
  81   const char *method;
  82 /*
  83   AFB_PostRequest *post;
  84 */
  85   struct json_object *jresp;
  86   void *context;             // Hold Client Context when using session
  87   int  restfull;             // request is resfull [uuid token provided]
  88   int  errcode;              // http error code
  89   struct AFB_config *config;         // plugin may need access to config
  90   struct afb_req *areq;
  91 } AFB_request;
  92
  93 struct afb_hsrv_handler;
  94 struct MHD_Daemon;
  95
  96 struct AFB_session
  97 {
  98   struct AFB_config  *config;   // pointer to current config
  99   // List of commands to execute
 100   int  background;        // run in backround mode
 101   int  foreground;        // run in forground mode
 102   char *cacheTimeout;     // http require timeout to be a string
 103   struct MHD_Daemon *httpd;            // structure for httpd handler
 104   int  fakemod;           // respond to GET/POST request without interacting with sndboard
 105   int  readyfd;           // a #fd to signal when ready to serve
 106   struct afb_hsrv_handler *handlers;
 107 };
 108
 109
 110 typedef struct AFB_config AFB_config;
 111 typedef struct AFB_session AFB_session;
 112
 113 #endif /* LOCAL_DEF_H */