1
0
Fork 0
mirror of https://github.com/pygos/init.git synced 2024-11-05 12:17:10 +01:00
init/initd/init.h
David Oberhollenzer 59731dd69b Add helper program for running services
We no longer need to keep entire scripts in init program (i.e. saving space)
and reduce the code and complexity of the init program.

The runsvc tool can later be extended to do more complex child setup, such
as configuring namespaces or seccomp without adding complexity or memory
footprint to init.

Signed-off-by: David Oberhollenzer <david.oberhollenzer@tele2.at>
2018-04-22 13:41:18 +02:00

123 lines
3 KiB
C

/* SPDX-License-Identifier: GPL-3.0-or-later */
/*
* Copyright (C) 2018 - David Oberhollenzer
*
* This program is free software: you can redistribute it 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 <https://www.gnu.org/licenses/>.
*/
#ifndef INIT_H
#define INIT_H
#include <linux/reboot.h>
#include <sys/signalfd.h>
#include <sys/reboot.h>
#include <signal.h>
#include "service.h"
#include "telinit.h"
#include "util.h"
#define RUNSVCBIN SCRIPTDIR "/runsvc"
enum {
STATUS_OK = 0,
STATUS_FAIL,
STATUS_WAIT,
STATUS_STARTED,
};
/********** runsvc.c **********/
/*
Invoke the runsvc command to execute the comands of a service.
Returns the pid of the child process containing the runsvc instance.
*/
pid_t runsvc(service_t *svc);
/*
Start a service using runsvc, but wait until the child process
terminats and return its exit status.
*/
int runsvc_wait(service_t *svc);
/********** status.c **********/
/*
Print a status message. Type is either STATUS_OK, STATUS_FAIL,
STATUS_WAIT or STATUS_STARTED.
A new-line is appended to the mssage, UNLESS type is STATUS_WAIT.
If update is true, print a carriage return first to overwrite the
current line (e.g. after a STATUS_WAIT message).
*/
void print_status(const char *msg, int type, bool update);
/********** mksock.c **********/
/*
Create a UNIX socket that programs can use to pass messages to init.
Returns the socked fd or -1 on failure. The function takes care of
printing error messages on failure.
The socket has the CLOEXEC flag set.
*/
int mksock(void);
/********** svclist.c **********/
/*
Returns true if the list of running services contains
single shot processes.
*/
bool svclist_have_singleshot(void);
/* Add a service to the list of running services */
void svclist_add(service_t *svc);
/*
Remove a service, identifierd by PID, from the list of
running services.
Returns the service identified by the PID or NULL if there
is no such service.
*/
service_t *svclist_remove(pid_t pid);
/********** signal_<platform>.c **********/
/*
Setup signal handling. Returns -1 on error, a file descriptor on
success.
The returned file descriptor can be polled and becomes readable
when a signal arrives. Reading from it returns a signalfd_siginfo
structure.
The returned file descriptor has the close on exec flag set.
The kernel is also told to send us SIGINT signals if a user presses
the local equivalent of CTRL+ALT+DEL.
*/
int sigsetup(void);
/*
Undo everything that sigsetup() changed about signal handling and
restore the default.
*/
void sigreset(void);
#endif /* INIT_H */