mirror of
https://github.com/troglobit/finit.git
synced 2026-10-17 10:49:34 +00:00
Joachim Nilsson
f55f68d032
Improve upon API names, both internal and external, to make it clearer where methods are located and clarify responsibility. Add new Makefile target "dev" to create untagged development snapshots. Bump version for upcoming release. Signed-off-by: Joachim Nilsson <troglobit@gmail.com>
113 lines
3.5 KiB
C
113 lines
3.5 KiB
C
/* Finit service monitor and heneric API for managing svc_t structures
|
|
*
|
|
* Copyright (c) 2008-2010 Claudio Matsuoka <cmatsuoka@gmail.com>
|
|
* Copyright (c) 2008-2012 Joachim Nilsson <troglobit@gmail.com>
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef FINIT_SVC_H_
|
|
#define FINIT_SVC_H_
|
|
|
|
#include <errno.h>
|
|
#include <string.h> /* strerror() */
|
|
#include <sys/shm.h> /* shmat() */
|
|
#include <sys/types.h> /* pid_t */
|
|
|
|
typedef enum {
|
|
SVC_STOP = 0, /* Disabled */
|
|
SVC_START, /* Enabled */
|
|
SVC_RELOAD /* Enabled, needs restart */
|
|
} svc_cmd_t;
|
|
|
|
#define FINIT_SHM_ID 0x494E4954 /* "INIT", see ascii(7) */
|
|
#define MAX_ARG_LEN 64
|
|
#define MAX_STR_LEN 64
|
|
#define MAX_USER_LEN 16
|
|
#define MAX_NUM_FDS 64 /* Max number of I/O plugins */
|
|
#define MAX_NUM_SVC 64 /* Enough? */
|
|
#define MAX_NUM_SVC_ARGS 16
|
|
|
|
/* Default enable for all services, can be stopped by means
|
|
* of issuing an initctl call. E.g.
|
|
* initctl <stop|start|restart> service */
|
|
typedef struct svc {
|
|
/* Private */
|
|
int id; /* Service ID#, set by svc_new() */
|
|
pid_t pid;
|
|
char cmd[MAX_ARG_LEN];
|
|
char args[MAX_NUM_SVC_ARGS][MAX_ARG_LEN];
|
|
char desc[MAX_STR_LEN];
|
|
char username[MAX_USER_LEN];
|
|
|
|
/* Public */
|
|
int reload; /* For external plugins. */
|
|
int private; /* For callbacks to use freely, possibly to store "states", set by plugin. */
|
|
} svc_t;
|
|
|
|
typedef struct svc_map svc_map_t;
|
|
|
|
/* Put services array in shm */
|
|
static inline svc_t *finit_svc_connect(void)
|
|
{
|
|
const long ID = FINIT_SHM_ID;
|
|
static void *ptr = (void *)-1;
|
|
|
|
if ((void *)-1 == ptr) {
|
|
ptr = shmat (shmget (ID, sizeof(svc_t) * MAX_NUM_SVC, 0600 | IPC_CREAT), NULL, 0);
|
|
if ((void *)-1 == ptr)
|
|
return NULL;
|
|
}
|
|
|
|
return (svc_t *)ptr;
|
|
}
|
|
|
|
static inline int svc_id(svc_t *svc)
|
|
{
|
|
if (!svc) {
|
|
errno = EINVAL;
|
|
return -1;
|
|
}
|
|
|
|
return svc->id;
|
|
}
|
|
|
|
svc_t *svc_new (void);
|
|
svc_t *svc_find_by_id (int id);
|
|
svc_t *svc_find_by_name (char *name);
|
|
svc_t *svc_iterator (int restart);
|
|
|
|
int svc_register (char *line, char *username);
|
|
int svc_id_by_name (char *name);
|
|
svc_cmd_t svc_enabled (svc_t *svc, int event, void *arg);
|
|
int svc_start (svc_t *svc);
|
|
int svc_start_by_name (char *name);
|
|
int svc_stop (svc_t *svc);
|
|
int svc_reload (svc_t *svc);
|
|
|
|
#endif /* FINIT_SVC_H_ */
|
|
|
|
/**
|
|
* Local Variables:
|
|
* version-control: t
|
|
* indent-tabs-mode: t
|
|
* c-file-style: "linux"
|
|
* End:
|
|
*/
|