d8010c1c587f62975f20a931aae544783b262705
[src/app-framework-binder.git] / include / local-def.h
1 /*
2    alsajson-gw -- provide a REST/HTTP interface to ALSA-Mixer
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
22 #ifndef _GNU_SOURCE
23   #define _GNU_SOURCE
24 #endif
25
26 #include <stdio.h>
27 #include <stdlib.h>
28 #include <string.h>
29 #include <unistd.h>
30 #include <fcntl.h>
31 #include <errno.h>
32 #include <termios.h>
33 #include <sys/ioctl.h>
34 #include <sys/signal.h>
35 #include <sys/types.h>
36 #include <time.h>
37 #include <json.h>
38 #include <microhttpd.h>
39 #include <magic.h>
40 #include <setjmp.h>
41 #include <signal.h>
42
43
44
45 #define AJQ_VERSION "0.1"
46
47 /* other definitions --------------------------------------------------- */
48
49 // Note: because of a bug in libmagic MAGIC_DB NULL should not be used for default
50 #define MAGIC_DB "/usr/share/misc/magic.mgc"
51 #define OPA_INDEX "index.html"
52 #define MAX_ALIAS 10  // max number of aliases
53
54 typedef int BOOL;
55 #ifndef FALSE
56   #define FALSE 0
57 #endif
58 #ifndef TRUE
59   #define TRUE 1
60 #endif
61
62 #define PUBLIC
63 #define STATIC    static
64 #define FAILED    -1
65
66 // prebuild json error are constructed in config.c
67 typedef enum  { AFB_FALSE, AFB_TRUE, AFB_FATAL, AFB_FAIL, AFB_WARNING, AFB_EMPTY, AFB_SUCCESS, AFB_DONE} AFB_error;
68
69 extern char *ERROR_LABEL[];
70 #define ERROR_LABEL_DEF {"false", "true","fatal", "fail", "warning", "empty", "success"}
71
72 #define BANNER "<html><head><title>Application Framework Binder</title></head><body>Application Framework </body></html>"
73 #define JSON_CONTENT  "application/json"
74 #define MAX_POST_SIZE  4096   // maximum size for POST data
75
76 // use to check anonymous data when using dynamic loadable lib
77 typedef enum  {AFB_PLUGIN=1234, AFB_REQUEST=5678} AFB_type;
78
79 // Error code are requested through function to manage json usage count
80 typedef struct {
81   int   level;
82   char* label;
83   json_object *json;
84 } AFB_errorT;
85
86 // Post handler
87 typedef struct {
88   char* data;
89   int   len;
90   int   uid;
91 } AFB_HttpPost;
92
93 typedef struct {
94   char  path[512];
95   int   fd;
96 } AFB_staticfile;
97
98 typedef struct {
99   char  *url;
100   char  *path;
101   size_t len;
102 } AFB_aliasdir;
103
104
105 // some usefull static object initialized when entering listen loop.
106 extern int verbose;
107 // MHD_lookup_connection_value(connection, MHD_GET_ARGUMENT_KIND, "value");
108 typedef struct {
109   const char *url;
110   char *plugin;
111   char *api;
112   char *post;
113   json_object *jresp;
114   struct MHD_Connection *connection;
115   sigjmp_buf checkPluginCall; // context save for timeout set/longjmp
116 } AFB_request;
117
118 typedef struct {
119      char    *msg;
120      size_t  len;
121 } AFB_redirect_msg;
122
123 // main config structure
124 typedef struct {
125   char *logname;           // logfile path for info & error log
126   char *console;           // console device name (can be a file or a tty)
127   int  localhostOnly;
128   int   httpdPort;
129   char *smack;             // smack label
130   char *plugins;           // list of requested plugins
131   char *rootdir;           // base dir for httpd file download
132   char *rootbase;          // Angular HTML5 base URL
133   char *rootapi;           // Base URL for REST APIs
134   char *pidfile;           // where to store pid when running background
135   char *sessiondir;        // where to store mixer session files
136   char *configfile;        // where to store configuration on gateway exit
137   uid_t setuid;
138   int  cacheTimeout;
139   int  apiTimeout;
140   AFB_aliasdir *aliasdir;  // alias mapping for icons,apps,...
141 } AFB_config;
142
143 // Command line structure hold cli --command + help text
144 typedef struct {
145   int  val;        // command number within application
146   int  has_arg;    // command number within application
147   char *name;      // command as used in --xxxx cli
148   char *help;      // help text
149 } AFB_options;
150
151 typedef struct {
152   int  len;        // command number within application
153   json_object *jtype;
154 } AFB_privateApi;
155
156 typedef json_object* (*AFB_apiCB)();
157
158 // API definition
159 typedef struct {
160   char *name;
161   AFB_apiCB callback;
162   char *info;
163   void * handle;
164   AFB_privateApi *private;
165 } AFB_restapi;
166
167 // Plugin definition
168 typedef struct {
169   AFB_type type;  
170   char *info;
171   char *prefix;
172   size_t prefixlen;
173   json_object *jtype;
174   AFB_restapi *apis;
175 } AFB_plugin;
176
177 typedef struct {
178   AFB_config  *config;   // pointer to current config
179   // List of commands to execute
180   int  killPrevious;
181   int  background;        // run in backround mode
182   int  foreground;        // run in forground mode
183   int  checkAlsa;         // Display active Alsa Board
184   int  configsave;        // Save config on disk on start
185   char *cacheTimeout;     // http require timeout to be a string
186   void *httpd;            // anonymous structure for httpd handler
187   int  fakemod;           // respond to GET/POST request without interacting with sndboard
188   int  forceexit;         // when autoconfig from script force exit before starting server
189   AFB_plugin **plugins;   // pointer to REST/API plugins 
190   magic_t  magic;         // Mime type file magic lib
191   sigjmp_buf restartCkpt; // context save for restart set/longjmp
192 } AFB_session;
193
194
195 #include "proto-def.h"