X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=src%2Finclude%2Fgnunet_os_lib.h;h=285dfb68ded7af2577d27ac6ea8515ab4a6ee259;hb=200d05b44a96d6fec00e28736038c838c679f650;hp=8cd4a4578f31edfde513988df716bf9daf808850;hpb=669d5032383c22014233fe0732a5485494b1b469;p=oweals%2Fgnunet.git diff --git a/src/include/gnunet_os_lib.h b/src/include/gnunet_os_lib.h index 8cd4a4578..285dfb68d 100644 --- a/src/include/gnunet_os_lib.h +++ b/src/include/gnunet_os_lib.h @@ -2,20 +2,20 @@ This file is part of GNUnet. Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2011 GNUnet e.V. - GNUnet 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, or (at your - option) any later version. + GNUnet is free software: you can redistribute it and/or modify it + under the terms of the GNU Affero General Public License as published + by the Free Software Foundation, either version 3 of the License, + or (at your option) any later version. GNUnet 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. + Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . - You should have received a copy of the GNU General Public License - along with GNUnet; see the file COPYING. If not, write to the - Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. + SPDX-License-Identifier: AGPL3.0-or-later */ /** @@ -240,6 +240,33 @@ struct GNUNET_OS_ProjectData */ const char *env_varname_alt; + /** + * Name of an environment variable that can be used to override + * the location from which default configuration files are loaded + * from, for example "GNUNET_BASE_CONFIG". + */ + const char *base_config_varname; + + /** + * E-mail address for reporting bugs. + */ + const char *bug_email; + + /** + * Project homepage. + */ + const char *homepage; + + /** + * Configuration file name (in $XDG_CONFIG_HOME) to use. + */ + const char *config_file; + + /** + * Configuration file name to use (if $XDG_CONFIG_HOME is not set). + */ + const char *user_config_file; + }; @@ -250,6 +277,13 @@ const struct GNUNET_OS_ProjectData * GNUNET_OS_project_data_default (void); +/** + * @return current (actual) project data. + */ +const struct GNUNET_OS_ProjectData * +GNUNET_OS_project_data_get (void); + + /** * Setup OS subsystem with project data. * @@ -347,7 +381,8 @@ GNUNET_OS_process_current (void); * @return 0 on success, -1 on error */ int -GNUNET_OS_process_kill (struct GNUNET_OS_Process *proc, int sig); +GNUNET_OS_process_kill (struct GNUNET_OS_Process *proc, + int sig); /** @@ -490,7 +525,8 @@ struct GNUNET_OS_CommandHandle; * @param cls closure * @param line line of output from a command, NULL for the end */ -typedef void (*GNUNET_OS_LineProcessor) (void *cls, const char *line); +typedef void +(*GNUNET_OS_LineProcessor) (void *cls, const char *line); /** @@ -514,13 +550,15 @@ GNUNET_OS_command_stop (struct GNUNET_OS_CommandHandle *cmd); * @return NULL on error */ struct GNUNET_OS_CommandHandle * -GNUNET_OS_command_run (GNUNET_OS_LineProcessor proc, void *proc_cls, - struct GNUNET_TIME_Relative timeout, const char *binary, +GNUNET_OS_command_run (GNUNET_OS_LineProcessor proc, + void *proc_cls, + struct GNUNET_TIME_Relative timeout, + const char *binary, ...); /** - * Retrieve the status of a process, waiting on him if dead. + * Retrieve the status of a process, waiting on it if dead. * Nonblocking version. * * @param proc pointer to process structure @@ -548,6 +586,22 @@ int GNUNET_OS_process_wait (struct GNUNET_OS_Process *proc); + +/** + * Retrieve the status of a process, waiting on it if dead. + * Blocking version. + * + * @param proc pointer to process structure + * @param type status type + * @param code return code/signal number + * @return #GNUNET_OK on success, #GNUNET_NO if the process is still running, #GNUNET_SYSERR otherwise + */ +int +GNUNET_OS_process_wait_status (struct GNUNET_OS_Process *proc, + enum GNUNET_OS_ProcessStatusType *type, + unsigned long *code); + + /** * Connects this process to its parent via pipe; * essentially, the parent control handler will read signal numbers @@ -555,12 +609,9 @@ GNUNET_OS_process_wait (struct GNUNET_OS_Process *proc); * variable) and raise those signals. * * @param cls closure (unused) - * @param tc scheduler context (unused) */ void -GNUNET_OS_install_parent_control_handler (void *cls, - const struct - GNUNET_SCHEDULER_TaskContext *tc); +GNUNET_OS_install_parent_control_handler (void *cls); /**