daemon.h

/*
* libslack - https://libslack.org
*
* Copyright (C) 1999-2004, 2010, 2020-2023 raf <raf@raf.org>
*
* 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 2 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/>.
*
* 20230824 raf <raf@raf.org>
*/

#ifndef LIBSLACK_DAEMON_H
#define LIBSLACK_DAEMON_H

#include <slack/hdr.h>

/* Define the standard pidfile directory for the root user */
#ifndef ROOT_PID_DIR
#define ROOT_PID_DIR "/var/run"
#endif

/* Define the standard pidfile directory for normal users */
#ifndef USER_PID_DIR
#define USER_PID_DIR "/tmp"
#endif

/* Define the root directory */
#ifndef ROOT_DIR
#define ROOT_DIR "/"
#endif

/* Define the /etc directory */
#ifndef ETC_DIR
#define ETC_DIR "/etc"
#endif

/* Define the path directory separator as a character */
#ifndef PATH_SEP
#define PATH_SEP '/'
#endif

/* Define the path directory separator as a string */
#ifndef PATH_SEP_STR
#define PATH_SEP_STR "/"
#endif

/* Define the $PATH environment variable directory separator */
#ifndef PATH_LIST_SEP
#define PATH_LIST_SEP ':'
#endif

typedef void daemon_config_parser_t(void *obj, const char *path, char *line, size_t lineno);

_begin_decls
int daemon_started_by_init(void);
int daemon_started_by_inetd(void);
int daemon_prevent_core(void);
int daemon_revoke_privileges(void);
int daemon_become_user(uid_t uid, gid_t gid, char *user);
char *daemon_absolute_path(const char *path);
int daemon_path_is_safe(const char *path, char *explanation, size_t explanation_size);
void *daemon_parse_config(const char *path, void *obj, daemon_config_parser_t *parser);
int daemon_pidfile(const char *name);
int daemon_init(const char *name);
int daemon_close(void);
pid_t daemon_getpid(const char *name);
int daemon_is_running(const char *name);
int daemon_stop(const char *name);
_end_decls

#endif

/* vi:set ts=4 sw=4: */