Go to the documentation of this file.
46 #define MODULE_NAME "LuaLog"
74 static TmEcode LuaLogThreadInit(
ThreadVars *t,
const void *initdata,
void **data);
85 static int LuaTxLogger(
ThreadVars *
tv,
void *thread_data,
const Packet *p,
Flow *f,
void *alstate,
void *txptr, uint64_t tx_id)
118 static int LuaStreamingLogger(
ThreadVars *
tv,
void *thread_data,
const Flow *f,
119 const uint8_t *data, uint32_t data_len, uint64_t tx_id, uint8_t
flags)
178 if (!(PacketIsIPv4(p)) && !(PacketIsIPv6(p))) {
240 if ((!(PacketIsIPv4(p))) && (!(PacketIsIPv6(p)))) {
279 void *tx,
const uint64_t tx_id, uint8_t dir)
284 if ((!(PacketIsIPv4(p))) && (!(PacketIsIPv6(p))))
359 lua_newtable(luastate);
361 for (; u < st->
nstats; u++) {
362 lua_pushinteger(luastate, u + 1);
364 lua_newtable(luastate);
366 lua_pushstring(luastate,
"name");
367 lua_pushstring(luastate, st->
stats[u].
name);
368 lua_settable(luastate, -3);
370 lua_pushstring(luastate,
"tmname");
372 lua_settable(luastate, -3);
374 lua_pushstring(luastate,
"value");
375 lua_pushinteger(luastate, st->
stats[u].
value);
376 lua_settable(luastate, -3);
378 lua_pushstring(luastate,
"pvalue");
380 lua_settable(luastate, -3);
382 lua_settable(luastate, -3);
413 lua_getglobal(L,
"package");
415 if (strlen(
ctx->path) > 0) {
416 lua_pushstring(L,
ctx->path);
418 lua_pushstring(L,
"");
420 lua_setfield(L, -2,
"path");
422 if (strlen(
ctx->cpath) > 0) {
423 lua_pushstring(L,
ctx->cpath);
425 lua_pushstring(L,
"");
427 lua_setfield(L, -2,
"cpath");
446 if (luastate == NULL)
448 luaL_openlibs(luastate);
450 LuaSetPaths(luastate,
ctx);
452 int status = luaL_loadfile(luastate, filename);
454 SCLogError(
"couldn't load file: %s", lua_tostring(luastate, -1));
459 if (lua_pcall(luastate, 0, 0, 0) != 0) {
460 SCLogError(
"couldn't prime file: %s", lua_tostring(luastate, -1));
464 lua_getglobal(luastate,
"init");
465 if (lua_type(luastate, -1) != LUA_TFUNCTION) {
470 lua_newtable(luastate);
471 if (lua_gettop(luastate) == 0 || lua_type(luastate, 2) != LUA_TTABLE) {
476 lua_pushliteral(luastate,
"script_api_ver");
477 lua_pushnumber (luastate, 1);
478 lua_settable(luastate, -3);
480 if (lua_pcall(luastate, 1, 1, 0) != 0) {
481 SCLogError(
"couldn't run script 'init' function: %s", lua_tostring(luastate, -1));
486 if (lua_gettop(luastate) == 0) {
487 SCLogError(
"init function in script should return table, nothing returned");
490 if (lua_type(luastate, 1) != LUA_TTABLE) {
491 SCLogError(
"init function in script should return table, returned is not table");
495 lua_pushnil(luastate);
497 while (lua_next(luastate, -2)) {
498 k = lua_tostring(luastate, -2);
502 v = lua_tostring(luastate, -1);
503 lua_pop(luastate, 1);
509 if (strcmp(k,
"protocol") == 0 && strcmp(v,
"http") == 0)
511 else if (strcmp(k,
"protocol") == 0 && strcmp(v,
"dns") == 0)
513 else if (strcmp(k,
"protocol") == 0 && strcmp(v,
"tls") == 0)
515 else if (strcmp(k,
"protocol") == 0 && strcmp(v,
"ssh") == 0)
517 else if (strcmp(k,
"protocol") == 0 && strcmp(v,
"smtp") == 0)
519 else if (strcmp(k,
"type") == 0 && strcmp(v,
"packet") == 0)
521 else if (strcmp(k,
"filter") == 0 && strcmp(v,
"alerts") == 0)
523 else if (strcmp(k,
"type") == 0 && strcmp(v,
"file") == 0)
525 else if (strcmp(k,
"type") == 0 && strcmp(v,
"streaming") == 0)
527 else if (strcmp(k,
"type") == 0 && strcmp(v,
"flow") == 0)
529 else if (strcmp(k,
"filter") == 0 && strcmp(v,
"tcp") == 0)
531 else if (strcmp(k,
"type") == 0 && strcmp(v,
"stats") == 0)
534 SCLogError(
"unknown key and/or value: k='%s', v='%s'", k, v);
540 SCLogError(
"invalid combination of 'needs' in the script");
544 lua_getglobal(luastate,
"setup");
545 if (lua_type(luastate, -1) != LUA_TFUNCTION) {
550 lua_getglobal(luastate,
"log");
551 if (lua_type(luastate, -1) != LUA_TFUNCTION) {
556 lua_getglobal(luastate,
"deinit");
557 if (lua_type(luastate, -1) != LUA_TFUNCTION) {
579 if (luastate == NULL) {
584 luaL_openlibs(luastate);
586 LuaSetPaths(luastate,
ctx);
588 int status = luaL_loadfile(luastate, filename);
590 SCLogError(
"couldn't load file: %s", lua_tostring(luastate, -1));
595 if (lua_pcall(luastate, 0, 0, 0) != 0) {
596 SCLogError(
"couldn't prime file: %s", lua_tostring(luastate, -1));
600 lua_getglobal(luastate,
"setup");
614 if (lua_pcall(luastate, 0, 0, 0) != 0) {
615 SCLogError(
"couldn't run script 'setup' function: %s", lua_tostring(luastate, -1));
619 SCLogDebug(
"lua_State %p is set up", luastate);
627 static void LogLuaSubFree(
OutputCtx *oc) {
655 BUG_ON(parent_ctx == NULL);
660 char path[PATH_MAX] =
"";
661 int ret = snprintf(path,
sizeof(path),
"%s%s%s", dir, strlen(dir) ?
"/" :
"", conf->
val);
662 if (ret < 0 || ret ==
sizeof(path)) {
663 SCLogError(
"failed to construct lua script path");
669 lua_ctx->
luastate = LuaScriptSetup(path, mc);
676 output_ctx->
data = lua_ctx;
677 output_ctx->
DeInit = LogLuaSubFree;
679 result.
ctx = output_ctx;
689 static void LogLuaMasterFree(
OutputCtx *oc)
716 if (scripts == NULL) {
727 output_ctx->
DeInit = LogLuaMasterFree;
737 if (lua_path && strlen(lua_path) > 0) {
742 if (lua_cpath && strlen(lua_cpath) > 0) {
753 memset(&opts, 0x00,
sizeof(opts));
755 char path[PATH_MAX] =
"";
756 snprintf(path,
sizeof(path),
"%s%s%s", dir, strlen(dir) ?
"/" :
"", script->
val);
759 int r = LuaScriptInit(path, &opts, master_config);
821 }
else if (opts.
file) {
827 }
else if (opts.
flow) {
829 }
else if (opts.
stats) {
840 result.
ctx = output_ctx;
846 output_ctx->
DeInit(output_ctx);
848 int failure_fatal = 0;
849 if (
ConfGetBool(
"engine.init-failure-fatal", &failure_fatal) != 1) {
850 SCLogDebug(
"ConfGetBool could not load the value.");
853 FatalError(
"Error during setup of lua output. Details should be "
854 "described in previous error messages. Shutting down...");
863 static void OutputLuaLogDoDeinit(
LogLuaCtx *lua_ctx)
867 lua_getglobal(luastate,
"deinit");
868 if (lua_type(luastate, -1) != LUA_TFUNCTION) {
874 if (lua_pcall(luastate, 0, 0, 0) != 0) {
875 SCLogError(
"couldn't run script 'deinit' function: %s", lua_tostring(luastate, -1));
886 static TmEcode LuaLogThreadInit(
ThreadVars *t,
const void *initdata,
void **data)
892 if (initdata == NULL) {
893 SCLogDebug(
"Error getting context for LuaLog. \"initdata\" argument NULL");
919 OutputLuaLogDoDeinit(td->
lua_ctx);
925 memset(td, 0,
sizeof(*td));
void LuaStateSetTX(lua_State *luastate, void *txptr, const uint64_t tx_id)
struct LogLuaThreadCtx_ LogLuaThreadCtx
void LuaStateSetPacket(lua_State *luastate, Packet *p)
structure containing global config The OutputLuaLogInitSub which is run per script can access this to...
void AppLayerHtpNeedFileInspection(void)
Sets a flag that informs the HTP app layer that some module in the engine needs the http request file...
void LuaStateSetThreadVars(lua_State *luastate, ThreadVars *tv)
const struct Signature_ * s
#define PACKET_ALERT_FLAG_TX
void LuaPushTableKeyValueInt(lua_State *luastate, const char *key, int value)
int ConfGetBool(const char *name, int *val)
Retrieve a configuration value as a boolean.
struct HtpBodyChunk_ * next
lua_State * LuaGetState(void)
int LuaRegisterDnsFunctions(lua_State *luastate)
register http lua extensions in a luastate
#define TAILQ_FOREACH(var, head, field)
bool SSHTxLogCondition(ThreadVars *tv, const Packet *p, void *state, void *tx, uint64_t tx_id)
int LuaRegisterSshFunctions(lua_State *luastate)
register ssh lua extensions in a luastate
void LuaStateSetFlow(lua_State *luastate, Flow *f)
set a flow pointer in the lua state
#define TAILQ_INSERT_TAIL(head, elm, field)
struct LogLuaScriptOptions_ LogLuaScriptOptions
OutputInitSubFunc InitSubFunc
PacketLogger PacketLogFunc
#define OUTPUT_STREAMING_FLAG_TRANSACTION
char path[PATH_MAX]
Lua search path for Lua modules.
size_t strlcpy(char *dst, const char *src, size_t siz)
struct lua_State lua_State
struct LogLuaMasterCtx_ LogLuaMasterCtx
structure containing global config The OutputLuaLogInitSub which is run per script can access this to...
enum SCOutputStreamingType stream_type
ThreadInitFunc ThreadInit
int LuaRegisterHttpFunctions(lua_State *luastate)
register http lua extensions in a luastate
int LuaRegisterHasshFunctions(lua_State *luastate)
Register Hassh Lua extensions.
ThreadDeinitFunc ThreadDeinit
#define SCMutexUnlock(mut)
void LuaStateSetFile(lua_State *luastate, File *file)
void AppLayerHtpEnableRequestBodyCallback(void)
Sets a flag that informs the HTP app layer that some module in the engine needs the http request body...
void AppLayerParserRegisterLogger(uint8_t ipproto, AppProto alproto)
void OutputRegisterModule(const char *, const char *, OutputInitFunc)
Per thread variable structure.
SCStreamingLogger StreamingLogFunc
void AppLayerHtpEnableResponseBodyCallback(void)
Sets a flag that informs the HTP app layer that some module in the engine needs the http request body...
int LuaRegisterTlsFunctions(lua_State *luastate)
register tls lua extensions in a luastate
void SCLuaRequirefBuiltIns(lua_State *L)
Register Suricata built-in modules for loading in a non-sandboxed environment.
#define SCLogInfo(...)
Macro used to log INFORMATIONAL messages.
#define TAILQ_FOREACH_SAFE(var, head, field, tvar)
void * AppLayerParserGetTx(uint8_t ipproto, AppProto alproto, void *alstate, uint64_t tx_id)
#define SCMutexInit(mut, mutattrs)
int LuaRegisterJa3Functions(lua_State *luastate)
Register JA3 Lua extensions.
ConfNode * ConfNodeLookupChild(const ConfNode *node, const char *name)
Lookup a child configuration node by name.
char cpath[PATH_MAX]
Lua search path for C modules.
TxLoggerCondition TxLogCondition
void(* DeInit)(struct OutputCtx_ *)
void LuaStateSetPacketAlert(lua_State *luastate, PacketAlert *pa)
void LuaLogRegister(void)
PacketLogCondition PacketConditionFunc
#define SCLogError(...)
Macro used to log ERROR messages.
void LuaStateSetStreamingBuffer(lua_State *luastate, LuaStreamingBuffer *b)
struct LogLuaCtx_ LogLuaCtx
int LuaRegisterSmtpFunctions(lua_State *luastate)
AppProto alproto
application level protocol
char script_dir[PATH_MAX]
Path to script directory.
int LuaRegisterFunctions(lua_State *luastate)
void CreateTimeString(const SCTime_t ts, char *str, size_t size)
void LuaReturnState(lua_State *s)
const char * ConfNodeLookupChildValue(const ConfNode *node, const char *name)
Lookup the value of a child configuration node by name.