finit/svc.h

/* Finit service monitor and generic API for managing svc_t structures
 *
 * Copyright (c) 2008-2010  Claudio Matsuoka <cmatsuoka@gmail.com>
 * Copyright (c) 2008-2015  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/ipc.h>		/* IPC_CREAT */
#include <sys/shm.h>		/* shmat() */
#include <sys/types.h>		/* pid_t */

#include "inetd.h"
#include "queue.h"		/* BSD sys/queue.h API */
#include "libuev/uev.h"

typedef enum {
	SVC_STOP = 0,		/* Disabled */
	SVC_START,		/* Enabled */
	SVC_RELOAD		/* Enabled, needs restart */
} svc_cmd_t;

typedef enum {
	SVC_CMD_SERVICE = 0,	/* Monitored, will be respawned */
	SVC_CMD_TASK,		/* One-shot, runs in parallell */
	SVC_CMD_RUN,		/* Like task, but wait for completion */
	SVC_CMD_INETD		/* Classic inetd service */
} svc_type_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 {
	pid_t	       pid;
	svc_type_t     type;
	int	       reload;
	int	       runlevels;

	/* Incremented for each restart by service monitor. */
	unsigned int   restart_counter;

	/* For inetd services */
	inetd_t        inetd;

	/* Identity */
	char	       username[MAX_USER_LEN];
	char	       group[MAX_USER_LEN];

	/* Command, arguments and service description */
	char	       cmd[MAX_ARG_LEN];
	char	       args[MAX_NUM_SVC_ARGS][MAX_ARG_LEN];
	char	       desc[MAX_STR_LEN];

	/* For external plugins. If @cb is set a plugin is loaded.
	 * @dynamic:	  Set by plugins that want dynamic events.
	 * @dynamic_stop: Set by plugins that allow dyn. events to stop it as well.
	 * @private:	  Can be used freely by plugin, e.g., to store "states".
	 */
	int	       dynamic;
	int	       dynamic_stop;
	int	       private;
	svc_cmd_t    (*cb)(struct svc *svc, int event, void *event_arg);
} svc_t;

typedef struct svc_map svc_map_t;

/* Put services array in shm */
static inline svc_t *finit_svc_connect(void)
{
	static void *ptr = (void *)-1;

	if ((void *)-1 == ptr) {
		ptr = shmat(shmget(FINIT_SHM_ID, sizeof(svc_t) * MAX_NUM_SVC,
				   0600 | IPC_CREAT), NULL, 0);
		if ((void *)-1 == ptr)
			return NULL;
	}

	return (svc_t *)ptr;
}

svc_t	 *svc_new	    (void);
svc_t	 *svc_find	    (char *path);
svc_t    *svc_find_by_pid   (pid_t pid);
svc_t    *svc_find_inetd    (char *path, char *service, char *proto, char *port);
svc_t	 *svc_iterator	    (int first);
void	  svc_runlevel	    (int newlevel);

int	  svc_register	    (int type, 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:
 */