mirror of https://gerrit.osmocom.org/libosmocore
155 lines
4.8 KiB
C
155 lines
4.8 KiB
C
/* Utility functions to setup applications */
|
|
/*
|
|
* (C) 2010 by Harald Welte <laforge@gnumonks.org>
|
|
* (C) 2011 by Holger Hans Peter Freyther
|
|
*
|
|
* All Rights Reserved
|
|
*
|
|
* 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, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
*/
|
|
|
|
/*! \file application.c
|
|
* \brief Routines for helping with the osmocom application setup.
|
|
*/
|
|
|
|
/*! \mainpage libosmocore Documentation
|
|
* \section sec_intro Introduction
|
|
* This library is a collection of common code used in various
|
|
* sub-projects inside the Osmocom family of projects. It includes a
|
|
* logging framework, select() loop abstraction, timers with callbacks,
|
|
* bit vectors, bit packing/unpacking, convolutional decoding, GSMTAP, a
|
|
* generic plugin interface, statistics counters, memory allocator,
|
|
* socket abstraction, message buffers, etc.
|
|
* \n\n
|
|
* Please note that C language projects inside Osmocom are typically
|
|
* single-threaded event-loop state machine designs. As such,
|
|
* routines in libosmocore are not thread-safe. If you must use them in
|
|
* a multi-threaded context, you have to add your own locking.
|
|
*
|
|
* \section sec_copyright Copyright and License
|
|
* Copyright © 2008-2011 - Harald Welte, Holger Freyther and contributors\n
|
|
* All rights reserved. \n\n
|
|
* The source code of libosmocore is licensed 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.\n
|
|
* See <http://www.gnu.org/licenses/> or COPYING included in the source
|
|
* code package istelf.\n
|
|
* The information detailed here is provided AS IS with NO WARRANTY OF
|
|
* ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY AND
|
|
* FITNESS FOR A PARTICULAR PURPOSE.
|
|
* \n\n
|
|
*
|
|
* \section sec_contact Contact and Support
|
|
* Community-based support is available at the OpenBSC mailing list
|
|
* <http://lists.osmocom.org/mailman/listinfo/openbsc>\n
|
|
* Commercial support options available upon request from
|
|
* <http://sysmocom.de/>
|
|
*/
|
|
|
|
#include <osmocom/core/application.h>
|
|
#include <osmocom/core/logging.h>
|
|
|
|
#include <signal.h>
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <unistd.h>
|
|
#include <errno.h>
|
|
#include <sys/stat.h>
|
|
|
|
struct log_target *osmo_stderr_target;
|
|
|
|
/*! \brief Ignore \ref SIGPIPE, \ref SIGALRM, \ref SIGHUP and \ref SIGIO */
|
|
void osmo_init_ignore_signals(void)
|
|
{
|
|
/* Signals that by default would terminate */
|
|
signal(SIGPIPE, SIG_IGN);
|
|
signal(SIGALRM, SIG_IGN);
|
|
signal(SIGHUP, SIG_IGN);
|
|
signal(SIGIO, SIG_IGN);
|
|
}
|
|
|
|
/*! \brief Initialize the osmocom logging framework
|
|
* \param[in] log_info Array of available logging sub-systems
|
|
* \returns 0 on success, -1 in case of error
|
|
*
|
|
* This function initializes the osmocom logging systems. It also
|
|
* creates the default (stderr) logging target.
|
|
*/
|
|
int osmo_init_logging(const struct log_info *log_info)
|
|
{
|
|
log_init(log_info, NULL);
|
|
osmo_stderr_target = log_target_create_stderr();
|
|
if (!osmo_stderr_target)
|
|
return -1;
|
|
|
|
log_add_target(osmo_stderr_target);
|
|
log_set_all_filter(osmo_stderr_target, 1);
|
|
return 0;
|
|
}
|
|
|
|
/*! \brief Turn the current process into a background daemon
|
|
*
|
|
* This function will fork the process, exit the parent and set umask,
|
|
* create a new session, close stdin/stdout/stderr and chdir to /tmp
|
|
*/
|
|
int osmo_daemonize(void)
|
|
{
|
|
int rc;
|
|
pid_t pid, sid;
|
|
|
|
/* Check if parent PID == init, in which case we are already a daemon */
|
|
if (getppid() == 1)
|
|
return -EEXIST;
|
|
|
|
/* Fork from the parent process */
|
|
pid = fork();
|
|
if (pid < 0) {
|
|
/* some error happened */
|
|
return pid;
|
|
}
|
|
|
|
if (pid > 0) {
|
|
/* if we have received a positive PID, then we are the parent
|
|
* and can exit */
|
|
exit(0);
|
|
}
|
|
|
|
/* FIXME: do we really want this? */
|
|
umask(0);
|
|
|
|
/* Create a new session and set process group ID */
|
|
sid = setsid();
|
|
if (sid < 0)
|
|
return sid;
|
|
|
|
/* Change to the /tmp directory, which prevents the CWD from being locked
|
|
* and unable to remove it */
|
|
rc = chdir("/tmp");
|
|
if (rc < 0)
|
|
return rc;
|
|
|
|
/* Redirect stdio to /dev/null */
|
|
/* since C89/C99 says stderr is a macro, we can safely do this! */
|
|
#ifdef stderr
|
|
freopen("/dev/null", "r", stdin);
|
|
freopen("/dev/null", "w", stdout);
|
|
freopen("/dev/null", "w", stderr);
|
|
#endif
|
|
|
|
return 0;
|
|
}
|