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 <magic.h>
  26 #include <microhttpd.h>
  27
  28 /* other definitions --------------------------------------------------- */
  29
  30 // Note: because of a bug in libmagic MAGIC_DB NULL should not be used for default
  31 #define OPA_INDEX "index.html"
  32 #define MAX_ALIAS 10           // max number of aliases
  33 #define COOKIE_NAME   "afb-session"
  34
  35 #define DEFLT_CNTX_TIMEOUT  3600   // default Client Connection Timeout
  36 #define DEFLT_API_TIMEOUT   0      // default Plugin API Timeout [0=NoLimit for Debug Only]
  37 #define DEFLT_API_TIMEOUT   0      // default Plugin API Timeout
  38 #define DEFLT_CACHE_TIMEOUT 100000 // default Static File Chache [Client Side Cache 100000~=1day]
  39 #define DEFLT_AUTH_TOKEN    NULL   // expect for debug should == NULL
  40 #define DEFLT_HTTP_TIMEOUT  15     // Max MibMicroHttp timeout
  41 #define AFB_MAX_PLUGINS     20     // Max number of plugins for a given binder
  42
  43 #define MAX_POST_SIZE  4096   // maximum size for POST data
  44 #define CTX_NBCLIENTS   10   // allow a default of 10 authenticated clients
  45
  46
  47
  48
  49
  50 enum AFB_Mode;
  51
  52
  53 typedef struct {
  54   char  *url;
  55   char  *path;
  56   size_t len;
  57 } AFB_aliasdir;
  58
  59 // main config structure
  60 struct AFB_config
  61 {
  62   char *console;           // console device name (can be a file or a tty)
  63   int   httpdPort;
  64   char *ldpaths;           // list of plugins directories
  65   char *rootdir;           // base dir for httpd file download
  66   char *rootbase;          // Angular HTML5 base URL
  67   char *rootapi;           // Base URL for REST APIs
  68   char *sessiondir;        // where to store mixer session files
  69   char *token;             // initial authentication token [default NULL no session]
  70   int  cacheTimeout;
  71   int  apiTimeout;
  72   int  cntxTimeout;        // Client Session Context timeout
  73   int mode;           // mode of listening
  74   AFB_aliasdir *aliasdir;  // alias mapping for icons,apps,...
  75 };
  76
  77 // MHD_lookup_connection_value(connection, MHD_GET_ARGUMENT_KIND, "value");
  78 typedef struct {
  79   const char *uuid;
  80   const char *url;
  81   const char *prefix;              // plugin convivial name
  82   const char *method;
  83 /*
  84   AFB_PostRequest *post;
  85 */
  86   struct json_object *jresp;
  87   void *context;             // Hold Client Context when using session
  88   int  restfull;             // request is resfull [uuid token provided]
  89   int  errcode;              // http error code
  90   struct AFB_config *config;         // plugin may need access to config
  91   struct afb_req *areq;
  92 } AFB_request;
  93
  94 struct afb_hsrv_handler;
  95 struct MHD_Daemon;
  96
  97 struct AFB_session
  98 {
  99   struct AFB_config  *config;   // pointer to current config
 100   // List of commands to execute
 101   int  background;        // run in backround mode
 102   int  foreground;        // run in forground mode
 103   char *cacheTimeout;     // http require timeout to be a string
 104   struct MHD_Daemon *httpd;            // structure for httpd handler
 105   int  fakemod;           // respond to GET/POST request without interacting with sndboard
 106   int  readyfd;           // a #fd to signal when ready to serve
 107   magic_t  magic;         // Mime type file magic lib
 108   struct afb_hsrv_handler *handlers;
 109 };
 110
 111
 112 typedef struct AFB_config AFB_config;
 113 typedef struct AFB_session AFB_session;
 114
 115 #endif /* LOCAL_DEF_H */