NetworkManager/src/core/main-utils.h

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

#ifndef __MAIN_UTILS_H__
#define __MAIN_UTILS_H__

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);

void nm_main_config_reload(int signal);

#endif /* __MAIN_UTILS_H__ */
all: update deprecated SPDX license identifiers These SPDX license identifiers are deprecated ([1]). Update them. [1] https://spdx.org/licenses/ sed \ -e '1 s%^/\* SPDX-License-Identifier: \(GPL-2.0\\|LGPL-2.1\)+ \/$%/ SPDX-License-Identifier: \1-or-later /%' \ -e '1,2 s%^\(--\\|#\\|//\) SPDX-License-Identifier: \(GPL-2.0\\|LGPL-2.1\)+$%\1 SPDX-License-Identifier: \2-or-later%' \ -i \ $(git grep -l SPDX-License-Identifier -- \ ':(exclude)shared/c-/' \ ':(exclude)shared/n-*/' \ ':(exclude)shared/systemd/src' \ ':(exclude)src/systemd/src') 2020-12-23 22:21:36 +01:00			`/* SPDX-License-Identifier: GPL-2.0-or-later */`
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__`

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
format: reformat source tree with clang-format 13.0 We use clang-format for automatic formatting of our source files. Since clang-format is actively maintained software, the actual formatting depends on the used version of clang-format. That is unfortunate and painful, but really unavoidable unless clang-format would be strictly bug-compatible. So the version that we must use is from the current Fedora release, which is also tested by our gitlab-ci. Previously, we were using Fedora 34 with clang-tools-extra-12.0.1-1.fc34.x86_64. As Fedora 35 comes along, we need to update our formatting as Fedora 35 comes with version "13.0.0~rc1-1.fc35". An alternative would be to freeze on version 12, but that has different problems (like, it's cumbersome to rebuild clang 12 on Fedora 35 and it would be cumbersome for our developers which are on Fedora 35 to use a clang that they cannot easily install). The (differently painful) solution is to reformat from time to time, as we switch to a new Fedora (and thus clang) version. Usually we would expect that such a reformatting brings minor changes. But this time, the changes are huge. That is mentioned in the release notes [1] as Makes PointerAligment: Right working with AlignConsecutiveDeclarations. (Fixes https://llvm.org/PR27353) [1] https://releases.llvm.org/13.0.0/tools/clang/docs/ReleaseNotes.html#clang-format 2021-11-09 13:28:54 +01:00			`gboolean nm_main_utils_early_setup(const char *progname,`
			`int *argc,`
			`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: 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__ */`