summaryrefslogtreecommitdiffhomepage
path: root/libs/lucittpd/src/include/lib/luaplugin.h
blob: fca6cb7f2cfdcc9dcfed711fac16ac8da4e33b10 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
/*
 * luaplugin - fast lua plugin indexing
 * Copyright (C) 2008 Felix Fietkau <nbd@openwrt.org>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2
 * as published by the Free Software Foundation
 *
 * 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.
 */
#ifndef __LUAPLUGIN_H
#define __LUAPLUGIN_H

#include <sys/time.h>
#include <lualib.h>
#include <lauxlib.h>
#include <stdbool.h>
#include "list.h"

struct luaplugin_entry {
	struct luaplugin_ctx *ctx;
	struct list_head list;
	time_t timestamp;
	int checked;
	bool loaded;
	bool reload;
	char *name;
	char *module;

	/* privdata for the caller */
	void *priv;
};

struct luaplugin_ctx {
	const char *path;
	const struct luaplugin_ops *ops;
	lua_State *L;
	int checked;
	struct list_head *last;
	struct list_head entries;
};

/** luaplugin_init:
 * initialize the luaplugin context (allocates a new lua context)
 */
extern int luaplugin_init(struct luaplugin_ctx *ctx, const char *path);

/** luaplugin_scan:
 * rescan the plugin cache
 */
extern void luaplugin_scan(struct luaplugin_ctx *ctx);

/** luaplugin_call:
 * call out to a lua function.
 * to be able to use this, you need to push the function name on the lua stack (ctx->L)
 * and then narg function arguments afterwards.
 * this call pops (narg + 1) arguments from the stack
 * returns -ENOENT if the function was not found
 */
extern int luaplugin_call(struct luaplugin_entry *e, int narg);

/** luaplugin_done:
 * drop the luaplugin context (and associated lua context)
 * frees all memory allocated by the library
 */
extern void luaplugin_done(struct luaplugin_ctx *ctx);

#endif