/* vim: set expandtab ts=4 sw=4: */ /* * You may redistribute this program and/or modify it under the terms of * the GNU General Public License as published by the Free Software Foundation, * either version 3 of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef Admin_H #define Admin_H #include "interface/addressable/AddrIface.h" #include "memory/Allocator.h" #include "util/log/Log.h" #include "util/events/EventBase.h" #include "util/Linker.h" Linker_require("admin/Admin.c") #include typedef void (* Admin_Function) (Dict* args, void* vcontext, String* txid, struct Allocator* requestAlloc); struct Admin { int unused; }; struct Admin_FunctionArg { char* name; char* type; bool required; }; #define Admin_MAX_REQUEST_SIZE 512 // This must not exceed PipeInterface_MAX_MESSAGE_SIZE #define Admin_MAX_RESPONSE_SIZE 65536 /** * @param arguments an array of struct Admin_FunctionArg specifying what functions are available * and of those, which are required. * Example C code: * Admin_registerFunction("AuthorizedPasswords_add", addPass, ctx, true, * ((struct Admin_FunctionArg[]) { * { .name = "password", .required = 1, .type = "String" }, * { .name = "authType", .required = 0, .type = "Int" } * }), admin); */ void Admin_registerFunctionWithArgCount(char* name, Admin_Function callback, void* callbackContext, bool needsAuth, struct Admin_FunctionArg* arguments, int argCount, struct Admin* admin); #define Admin_registerFunction(name, cb, ctx, needsAuth, args, admin) \ Admin_registerFunctionWithArgCount( \ name, cb, ctx, needsAuth, args, (sizeof(args) / sizeof(struct Admin_FunctionArg)), admin) #define Admin_registerFunctionNoArgs(name, cb, ctx, needsAuth, admin) \ Admin_registerFunctionWithArgCount(name, cb, ctx, needsAuth, NULL, 0, admin) #define Admin_sendMessage_CHANNEL_CLOSED -1 int Admin_sendMessage(Dict* message, String* txid, struct Admin* admin); struct Admin* Admin_new(AddrIface_t* ai, struct Log* logger, EventBase_t* eventBase, String* password); #endif