NetworkManager/src/main-utils.h

// SPDX-License-Identifier: GPL-2.0+
/*
 * Copyright (C) 2014 Red Hat, Inc.
 */

#ifndef __MAIN_UTILS_H__
#define __MAIN_UTILS_H__

void     nm_main_utils_ensure_root (void);

void     nm_main_utils_setup_signals (GMainLoop *main_loop);

void     nm_main_utils_ensure_statedir (void);
void     nm_main_utils_ensure_rundir (void);

gboolean nm_main_utils_write_pidfile (const char *pidfile);

void     nm_main_utils_ensure_not_running_pidfile (const char *pidfile);

gboolean nm_main_utils_early_setup (const char *progname,
                                    int *argc,
                                    char **argv[],
                                    GOptionEntry *options,
                                    void (*option_context_hook) (gpointer user_data, GOptionContext *opt_ctx),
                                    gpointer option_context_hook_data,
                                    const char *summary);

/* The following functions are not implemented inside nm-main-utils.c, instead
 * main.c and nm-iface-helper.c */

void nm_main_config_reload (int signal);

#endif /* __MAIN_UTILS_H__ */
all: SPDX header conversion $ find * -type f \|xargs perl contrib/scripts/spdx.pl $ git rm contrib/scripts/spdx.pl 2019-09-10 11:19:01 +02:00			`// SPDX-License-Identifier: GPL-2.0+`
all: manually drop code comments with file description 2019-09-25 13:13:40 +02:00			`/*`
core: split signal/pidfile/option handling into separate source file We'll use this from more than one spot. 2014-10-29 09:36:47 -05:00			`* Copyright (C) 2014 Red Hat, Inc.`
			`*/`

			`#ifndef __MAIN_UTILS_H__`
			`#define __MAIN_UTILS_H__`

main: (order) move root user check after help/version option With this change, `NetworkManager --help` and `NetworkManager --version` work for non-root user. 2015-03-13 20:57:18 +01:00			`void nm_main_utils_ensure_root (void);`

core: use GUnixSignalWatchSource to simplify signal handling Replace the pthread_sigwait()-based signal handling with g_unix_signal_add()-based handling, and get rid of all the now-unnecessary calls to nm_unblock_posix_signals() when spawning subprocesses. As a bonus, this also fixes the "^C in gdb kills NM too" bug. 2015-01-12 11:31:10 -05:00			`void nm_main_utils_setup_signals (GMainLoop *main_loop);`
core: split signal/pidfile/option handling into separate source file We'll use this from more than one spot. 2014-10-29 09:36:47 -05:00
main: create parent directories of NMSTATEDIR with permissions 755 In case, "$PREFIX/var/lib" does not exist, we want to create those directories with permissions 755, not 700. 2016-03-21 12:01:26 +01:00			`void nm_main_utils_ensure_statedir (void);`
main: split out nm_main_utils_ensure_rundir () Also, don't use nm_log_err() as nm-logging is not yet setup. 2015-03-13 22:55:39 +01:00			`void nm_main_utils_ensure_rundir (void);`

core: split signal/pidfile/option handling into separate source file We'll use this from more than one spot. 2014-10-29 09:36:47 -05:00			`gboolean nm_main_utils_write_pidfile (const char *pidfile);`

main: refactor nm_main_utils_check_pidfile() to exit directly on failure And rename the function to nm_main_utils_ensure_not_running_pidfile() to match the other _ensure_ functions that exit(1). Also no longer pass @name to nm_main_utils_ensure_not_running_pidfile() and use g_get_prgname() instead. nm_main_utils_ensure_not_running_pidfile() checks that the running process has the same program name, so this changes behavior if the user renamed the binary. Before, we would check whether the running process is named 'NetworkManager' ('nm-iface-helper'). Now we check whether the process has the same name as the current process. This means, that if you rename the binary to 'NetworkManager2' we would now only detect a conflicting 'NetworkManager2'. Before we would only detect conflicting 'NetworkManager' binaries. 2015-03-13 23:06:29 +01:00			`void nm_main_utils_ensure_not_running_pidfile (const char *pidfile);`
core: split signal/pidfile/option handling into separate source file We'll use this from more than one spot. 2014-10-29 09:36:47 -05:00
			`gboolean nm_main_utils_early_setup (const char *progname,`
			`int *argc,`
main/trivial: change order of arguments for nm_main_utils_early_setup() Change the order of the argv and argc argument to match the main() function. 2015-03-13 20:47:03 +01:00			`char **argv[],`
core: split signal/pidfile/option handling into separate source file We'll use this from more than one spot. 2014-10-29 09:36:47 -05:00			`GOptionEntry *options,`
config: add nm_config_setup() to initialize config singleton Make nm_config_new() usable without accessing static/singleton data. nm_config_setup() is now used to initialize the singleton. Still, you must not call nm_config_get() before calling nm_config_setup() or after freeing the provided singleton instance. 2014-07-09 15:17:01 +02:00			`void (option_context_hook) (gpointer user_data, GOptionContext opt_ctx),`
			`gpointer option_context_hook_data,`
core: split signal/pidfile/option handling into separate source file We'll use this from more than one spot. 2014-10-29 09:36:47 -05:00			`const char *summary);`

config: add handler for SIGHUP and a reload-configuration stub 2014-07-09 18:36:20 +02:00			`/* The following functions are not implemented inside nm-main-utils.c, instead`
			`* main.c and nm-iface-helper.c */`

config: pass signals to nm_config_reload() Also react on SIGUSR1 and SIGUSR2, beside SIGHUP. Only for SIGHUP actually reload the configuration from disc. For the other signals only emit a config-changed signal. 2015-06-25 21:10:32 +02:00			`void nm_main_config_reload (int signal);`
config: add handler for SIGHUP and a reload-configuration stub 2014-07-09 18:36:20 +02:00
core: split signal/pidfile/option handling into separate source file We'll use this from more than one spot. 2014-10-29 09:36:47 -05:00			`#endif /* __MAIN_UTILS_H__ */`