GNUnet debian-0.24.3
os_priority.c File Reference

Methods to set process priority. More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "disk.h"
#include <unistr.h>
Include dependency graph for os_priority.c:

Go to the source code of this file.

Data Structures

struct  GNUNET_OS_Process
 
struct  GNUNET_OS_CommandHandle
 Handle to a command. More...
 

Macros

#define LOG(kind, ...)   GNUNET_log_from (kind, "util-os-priority", __VA_ARGS__)
 
#define LOG_STRERROR(kind, syscall)    GNUNET_log_from_strerror (kind, "util-os-priority", syscall)
 
#define LOG_STRERROR_FILE(kind, syscall, filename)
 
#define GNUNET_OS_CONTROL_PIPE   "GNUNET_OS_CONTROL_PIPE"
 

Functions

static void shutdown_pch (void *cls)
 This handler is called on shutdown to remove the pch. More...
 
static void parent_control_handler (void *cls)
 This handler is called when there are control data to be read on the pipe. More...
 
void GNUNET_OS_install_parent_control_handler (void *cls)
 Connects this process to its parent via pipe; essentially, the parent control handler will read signal numbers from the GNUNET_OS_CONTROL_PIPE (as given in an environment variable) and raise those signals. More...
 
struct GNUNET_OS_ProcessGNUNET_OS_process_current ()
 Get process structure for current process. More...
 
int GNUNET_OS_process_kill (struct GNUNET_OS_Process *proc, int sig)
 Sends a signal to the process. More...
 
pid_t GNUNET_OS_process_get_pid (struct GNUNET_OS_Process *proc)
 Get the pid of the process in question. More...
 
void GNUNET_OS_process_destroy (struct GNUNET_OS_Process *proc)
 Cleans up process structure contents (OS-dependent) and deallocates it. More...
 
static void open_dev_null (int target_fd, int flags)
 Open '/dev/null' and make the result the given file descriptor. More...
 
static struct GNUNET_OS_Processstart_process (enum GNUNET_OS_InheritStdioFlags std_inheritance, struct GNUNET_DISK_PipeHandle *pipe_stdin, struct GNUNET_DISK_PipeHandle *pipe_stdout, struct GNUNET_DISK_PipeHandle *pipe_stderr, const int *lsocks, const char *filename, char *const argv[])
 Start a process. More...
 
struct GNUNET_OS_ProcessGNUNET_OS_start_process_vap (enum GNUNET_OS_InheritStdioFlags std_inheritance, struct GNUNET_DISK_PipeHandle *pipe_stdin, struct GNUNET_DISK_PipeHandle *pipe_stdout, struct GNUNET_DISK_PipeHandle *pipe_stderr, const char *filename, char *const argv[])
 Start a process. More...
 
struct GNUNET_OS_ProcessGNUNET_OS_start_process_va (enum GNUNET_OS_InheritStdioFlags std_inheritance, struct GNUNET_DISK_PipeHandle *pipe_stdin, struct GNUNET_DISK_PipeHandle *pipe_stdout, struct GNUNET_DISK_PipeHandle *pipe_stderr, const char *filename, va_list va)
 Start a process. More...
 
struct GNUNET_OS_ProcessGNUNET_OS_start_process (enum GNUNET_OS_InheritStdioFlags std_inheritance, struct GNUNET_DISK_PipeHandle *pipe_stdin, struct GNUNET_DISK_PipeHandle *pipe_stdout, struct GNUNET_DISK_PipeHandle *pipe_stderr, const char *filename,...)
 Start a process. More...
 
struct GNUNET_OS_ProcessGNUNET_OS_start_process_v (enum GNUNET_OS_InheritStdioFlags std_inheritance, const int *lsocks, const char *filename, char *const argv[])
 Start a process. More...
 
struct GNUNET_OS_ProcessGNUNET_OS_start_process_s (enum GNUNET_OS_InheritStdioFlags std_inheritance, const int *lsocks, const char *filename,...)
 Start a process. More...
 
static enum GNUNET_GenericReturnValue process_status (struct GNUNET_OS_Process *proc, enum GNUNET_OS_ProcessStatusType *type, unsigned long *code, int options)
 Retrieve the status of a process, waiting on it if dead. More...
 
enum GNUNET_GenericReturnValue GNUNET_OS_process_status (struct GNUNET_OS_Process *proc, enum GNUNET_OS_ProcessStatusType *type, unsigned long *code)
 Retrieve the status of a process. More...
 
enum GNUNET_GenericReturnValue GNUNET_OS_process_wait_status (struct GNUNET_OS_Process *proc, enum GNUNET_OS_ProcessStatusType *type, unsigned long *code)
 Retrieve the status of a process, waiting on it if dead. More...
 
enum GNUNET_GenericReturnValue GNUNET_OS_process_wait (struct GNUNET_OS_Process *proc)
 Wait for a process to terminate. More...
 
void GNUNET_OS_command_stop (struct GNUNET_OS_CommandHandle *cmd)
 Stop/kill a command. More...
 
static void cmd_read (void *cls)
 Read from the process and call the line processor. More...
 
struct GNUNET_OS_CommandHandleGNUNET_OS_command_run (GNUNET_OS_LineProcessor proc, void *proc_cls, struct GNUNET_TIME_Relative timeout, const char *binary,...)
 Run the given command line and call the given function for each line of the output. More...
 

Variables

static struct GNUNET_OS_Process current_process
 Handle for 'this' process. More...
 
static struct GNUNET_SCHEDULER_Taskpch
 Handle for the parent_control_handler() Task. More...
 
static struct GNUNET_SCHEDULER_Taskspch
 Handle for the shutdown_pch() Task. More...
 

Detailed Description

Methods to set process priority.

Author
Nils Durner

Definition in file os_priority.c.

Macro Definition Documentation

◆ LOG

#define LOG (   kind,
  ... 
)    GNUNET_log_from (kind, "util-os-priority", __VA_ARGS__)

Definition at line 33 of file os_priority.c.

◆ LOG_STRERROR

#define LOG_STRERROR (   kind,
  syscall 
)     GNUNET_log_from_strerror (kind, "util-os-priority", syscall)

Definition at line 35 of file os_priority.c.

◆ LOG_STRERROR_FILE

#define LOG_STRERROR_FILE (   kind,
  syscall,
  filename 
)
Value:
GNUNET_log_from_strerror_file (kind, "util-os-priority", syscall, \
static char * filename
#define GNUNET_log_from_strerror_file(level, component, cmd, filename)
Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the mess...

Definition at line 38 of file os_priority.c.

◆ GNUNET_OS_CONTROL_PIPE

#define GNUNET_OS_CONTROL_PIPE   "GNUNET_OS_CONTROL_PIPE"

Definition at line 42 of file os_priority.c.

Function Documentation

◆ shutdown_pch()

static void shutdown_pch ( void *  cls)
static

This handler is called on shutdown to remove the pch.

Parameters
clsthe struct GNUNET_DISK_FileHandle of the control pipe

Definition at line 82 of file os_priority.c.

83{
84 struct GNUNET_DISK_FileHandle *control_pipe = cls;
85
87 pch = NULL;
88 GNUNET_DISK_file_close (control_pipe);
89 control_pipe = NULL;
90}
enum GNUNET_GenericReturnValue GNUNET_DISK_file_close(struct GNUNET_DISK_FileHandle *h)
Close an open file.
Definition: disk.c:1322
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:980
static struct GNUNET_SCHEDULER_Task * pch
Handle for the parent_control_handler() Task.
Definition: os_priority.c:68
Handle used to access files (and pipes).

References GNUNET_DISK_file_close(), GNUNET_SCHEDULER_cancel(), and pch.

Referenced by GNUNET_OS_install_parent_control_handler().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ parent_control_handler()

static void parent_control_handler ( void *  cls)
static

This handler is called when there are control data to be read on the pipe.

Parameters
clsthe struct GNUNET_DISK_FileHandle of the control pipe

Definition at line 99 of file os_priority.c.

100{
101 struct GNUNET_DISK_FileHandle *control_pipe = cls;
102 char sig;
103 char *pipe_fd;
104 ssize_t ret;
105
106 pch = NULL;
107 ret = GNUNET_DISK_file_read (control_pipe, &sig, sizeof(sig));
108 if (sizeof(sig) != ret)
109 {
110 if (-1 == ret)
111 LOG_STRERROR (GNUNET_ERROR_TYPE_ERROR, "GNUNET_DISK_file_read");
112 LOG (GNUNET_ERROR_TYPE_DEBUG, "Closing control pipe\n");
113 GNUNET_DISK_file_close (control_pipe);
114 control_pipe = NULL;
116 spch = NULL;
117 return;
118 }
119 pipe_fd = getenv (GNUNET_OS_CONTROL_PIPE);
120 GNUNET_assert ((NULL == pipe_fd) || (strlen (pipe_fd) <= 0));
122 "Got control code %d from parent via pipe %s\n",
123 sig,
124 pipe_fd);
126 control_pipe,
128 control_pipe);
129 GNUNET_SIGNAL_raise ((int) sig);
130}
char * getenv()
static int ret
Final status code.
Definition: gnunet-arm.c:93
ssize_t GNUNET_DISK_file_read(const struct GNUNET_DISK_FileHandle *h, void *result, size_t len)
Read the contents of a binary file into a buffer.
Definition: disk.c:663
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
@ GNUNET_ERROR_TYPE_ERROR
@ GNUNET_ERROR_TYPE_DEBUG
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_read_file(struct GNUNET_TIME_Relative delay, const struct GNUNET_DISK_FileHandle *rfd, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay or when the specified file descriptor is ready f...
Definition: scheduler.c:1661
void GNUNET_SIGNAL_raise(const int sig)
Raise the given signal by calling the installed signal handlers.
Definition: signal.c:98
#define GNUNET_TIME_UNIT_FOREVER_REL
Constant used to specify "forever".
#define GNUNET_OS_CONTROL_PIPE
Definition: os_priority.c:42
static void parent_control_handler(void *cls)
This handler is called when there are control data to be read on the pipe.
Definition: os_priority.c:99
static struct GNUNET_SCHEDULER_Task * spch
Handle for the shutdown_pch() Task.
Definition: os_priority.c:73
#define LOG(kind,...)
Definition: os_priority.c:33
#define LOG_STRERROR(kind, syscall)
Definition: os_priority.c:35

References getenv(), GNUNET_assert, GNUNET_DISK_file_close(), GNUNET_DISK_file_read(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_ERROR, GNUNET_OS_CONTROL_PIPE, GNUNET_SCHEDULER_add_read_file(), GNUNET_SCHEDULER_cancel(), GNUNET_SIGNAL_raise(), GNUNET_TIME_UNIT_FOREVER_REL, LOG, LOG_STRERROR, parent_control_handler(), pch, ret, and spch.

Referenced by GNUNET_OS_install_parent_control_handler(), and parent_control_handler().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ open_dev_null()

static void open_dev_null ( int  target_fd,
int  flags 
)
static

Open '/dev/null' and make the result the given file descriptor.

Parameters
target_fddesired FD to point to /dev/null
flagsopen flags (O_RDONLY, O_WRONLY)

Definition at line 278 of file os_priority.c.

280{
281 int fd;
282
283 fd = open ("/dev/null", flags);
284 if (-1 == fd)
285 {
287 return;
288 }
289 if (fd == target_fd)
290 return;
291 if (-1 == dup2 (fd, target_fd))
292 {
294 GNUNET_break (0 == close (fd));
295 return;
296 }
297 GNUNET_break (0 == close (fd));
298}
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur.
#define GNUNET_log_strerror(level, cmd)
Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the mess...
#define GNUNET_log_strerror_file(level, cmd, filename)
Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the mess...

References GNUNET_break, GNUNET_ERROR_TYPE_ERROR, GNUNET_log_strerror, and GNUNET_log_strerror_file.

Referenced by start_process().

Here is the caller graph for this function:

◆ start_process()

static struct GNUNET_OS_Process * start_process ( enum GNUNET_OS_InheritStdioFlags  std_inheritance,
struct GNUNET_DISK_PipeHandle pipe_stdin,
struct GNUNET_DISK_PipeHandle pipe_stdout,
struct GNUNET_DISK_PipeHandle pipe_stderr,
const int *  lsocks,
const char *  filename,
char *const  argv[] 
)
static

Start a process.

Parameters
std_inheritancea set of GNUNET_OS_INHERIT_STD_* flags controlling which std handles of the parent are inherited by the child. pipe_stdin and pipe_stdout take priority over std_inheritance (when they are non-NULL).
pipe_stdinpipe to use to send input to child process (or NULL)
pipe_stdoutpipe to use to get output from child process (or NULL)
pipe_stderrpipe to use for stderr for child process (or NULL)
lsocksarray of listen sockets to dup systemd-style (or NULL); must be NULL on platforms where dup is not supported
filenamename of the binary
argvNULL-terminated list of arguments to the process
Returns
process ID of the new process, -1 on error

Definition at line 318 of file os_priority.c.

325{
326 pid_t ret;
327 char fds[16];
328 struct GNUNET_OS_Process *gnunet_proc;
329 struct GNUNET_DISK_FileHandle *childpipe_read;
330 struct GNUNET_DISK_FileHandle *childpipe_write;
331 int childpipe_read_fd;
332 int i;
333 int j;
334 int k;
335 int tgt;
336 int flags;
337 int *lscp;
338 unsigned int ls;
339 int fd_stdout_write;
340 int fd_stdout_read;
341 int fd_stderr_write;
342 int fd_stderr_read;
343 int fd_stdin_read;
344 int fd_stdin_write;
345
346 if (GNUNET_SYSERR ==
348 return NULL; /* not executable */
349 if (0 != (std_inheritance & GNUNET_OS_USE_PIPE_CONTROL))
350 {
351 struct GNUNET_DISK_PipeHandle *childpipe;
352 int dup_childpipe_read_fd = -1;
353
355 if (NULL == childpipe)
356 return NULL;
357 childpipe_read =
359 childpipe_write =
361 GNUNET_DISK_pipe_close (childpipe);
362 if ((NULL == childpipe_read) || (NULL == childpipe_write) ||
364 &childpipe_read_fd)) ||
365 (-1 == (dup_childpipe_read_fd = dup (childpipe_read_fd))))
366 {
367 if (NULL != childpipe_read)
368 GNUNET_DISK_file_close (childpipe_read);
369 if (NULL != childpipe_write)
370 GNUNET_DISK_file_close (childpipe_write);
371 if (0 <= dup_childpipe_read_fd)
372 GNUNET_break (0 == close (dup_childpipe_read_fd));
373 return NULL;
374 }
375 childpipe_read_fd = dup_childpipe_read_fd;
376 GNUNET_DISK_file_close (childpipe_read);
377 }
378 else
379 {
380 childpipe_write = NULL;
381 childpipe_read_fd = -1;
382 }
383 if (NULL != pipe_stdin)
384 {
386 GNUNET_OK ==
389 &fd_stdin_read));
391 GNUNET_OK ==
394 &fd_stdin_write));
395 }
396 if (NULL != pipe_stdout)
397 {
399 GNUNET_OK ==
402 &fd_stdout_write));
404 GNUNET_OK ==
407 &fd_stdout_read));
408 }
409 if (NULL != pipe_stderr)
410 {
412 GNUNET_OK ==
415 &fd_stderr_read));
417 GNUNET_OK ==
420 &fd_stderr_write));
421 }
422 lscp = NULL;
423 ls = 0;
424 if (NULL != lsocks)
425 {
426 i = 0;
427 while (-1 != (k = lsocks[i++]))
428 GNUNET_array_append (lscp, ls, k);
429 GNUNET_array_append (lscp, ls, -1);
430 }
431#if DARWIN
432 /* see https://web.archive.org/web/20150924082249/gnunet.org/vfork */
433 #pragma GCC diagnostic push
434 #pragma GCC diagnostic ignored "-Wdeprecated"
435 #pragma GCC diagnostic ignored "-Wdeprecated-declarations"
436 #pragma clang diagnostic push
437 #pragma clang diagnostic ignored "-Wdeprecated"
438 ret = vfork ();
439 #pragma clang diagnostic pop
440 #pragma GCC diagnostic pop
441#else
442 ret = fork ();
443#endif
444 if (-1 == ret)
445 {
446 int eno = errno;
447
449 "fork");
450 GNUNET_array_grow (lscp,
451 ls,
452 0);
453 if (NULL != childpipe_write)
454 GNUNET_DISK_file_close (childpipe_write);
455 if (0 <= childpipe_read_fd)
456 GNUNET_break (0 == close (childpipe_read_fd));
457 errno = eno;
458 return NULL;
459 }
460 if (0 != ret)
461 {
462 unsetenv (GNUNET_OS_CONTROL_PIPE);
463 gnunet_proc = GNUNET_new (struct GNUNET_OS_Process);
464 gnunet_proc->pid = ret;
465 gnunet_proc->control_pipe = childpipe_write;
466 if (0 != (std_inheritance & GNUNET_OS_USE_PIPE_CONTROL))
467 {
468 GNUNET_break (0 == close (childpipe_read_fd));
469 }
470 GNUNET_array_grow (lscp, ls, 0);
471 return gnunet_proc;
472 }
473 if (0 <= childpipe_read_fd)
474 {
475 char fdbuf[100];
476#ifndef DARWIN
477 /* due to vfork, we must NOT free memory on DARWIN! */
478 GNUNET_DISK_file_close (childpipe_write);
479#endif
480 snprintf (fdbuf,
481 sizeof (fdbuf),
482 "%x",
483 childpipe_read_fd);
485 fdbuf,
486 1);
487 }
488 else
489 unsetenv (GNUNET_OS_CONTROL_PIPE);
490 if (NULL != pipe_stdin)
491 {
492 GNUNET_break (0 == close (fd_stdin_write));
493 if (-1 == dup2 (fd_stdin_read,
494 0))
496 "dup2");
497 GNUNET_break (0 == close (fd_stdin_read));
498 }
499 else if (0 == (std_inheritance & GNUNET_OS_INHERIT_STD_IN))
500 {
501 GNUNET_break (0 == close (0));
502 open_dev_null (0,
503 O_RDONLY);
504 }
505 if (NULL != pipe_stdout)
506 {
507 GNUNET_break (0 == close (fd_stdout_read));
508 if (-1 == dup2 (fd_stdout_write,
509 1))
511 "dup2");
512 GNUNET_break (0 ==
513 close (fd_stdout_write));
514 }
515 else if (0 == (std_inheritance & GNUNET_OS_INHERIT_STD_OUT))
516 {
517 GNUNET_break (0 == close (1));
518 open_dev_null (1,
519 O_WRONLY);
520 }
521 if (NULL != pipe_stderr)
522 {
523 GNUNET_break (0 == close (fd_stderr_read));
524 if (-1 == dup2 (fd_stderr_write,
525 2))
527 GNUNET_break (0 == close (fd_stderr_write));
528 }
529 else if (0 == (std_inheritance & GNUNET_OS_INHERIT_STD_ERR))
530 {
531 GNUNET_break (0 == close (2));
532 open_dev_null (2,
533 O_WRONLY);
534 }
535 if (NULL != lscp)
536 {
537 char *fdnames = GNUNET_strdup ("");
538
539 /* read systemd documentation... */
540 i = 0;
541 tgt = 3;
542 while (-1 != lscp[i])
543 {
544 j = i + 1;
545 while (-1 != lscp[j])
546 {
547 if (lscp[j] == tgt)
548 {
549 /* dup away */
550 k = dup (lscp[j]);
551 GNUNET_assert (-1 != k);
552 GNUNET_assert (0 == close (lscp[j]));
553 lscp[j] = k;
554 break;
555 }
556 j++;
557 }
558 if (lscp[i] != tgt)
559 {
560 /* Bury any existing FD, no matter what; they should all be closed
561 * on exec anyway and the important ones have been dup'ed away */
562 GNUNET_break (0 == close (tgt));
563 GNUNET_assert (-1 != dup2 (lscp[i],
564 tgt));
565 }
566 /* unset close-on-exec flag */
567 flags = fcntl (tgt,
568 F_GETFD);
569 GNUNET_assert (flags >= 0);
570 flags &= ~FD_CLOEXEC;
571 fflush (stderr);
572 (void) fcntl (tgt,
573 F_SETFD,
574 flags);
575 {
576 char *tmp;
577
578 GNUNET_asprintf (&tmp,
579 "%s:%d",
580 fdnames,
581 tgt);
582 GNUNET_free (fdnames);
583 fdnames = tmp;
584 }
585 tgt++;
586 i++;
587 }
588 GNUNET_snprintf (fds,
589 sizeof(fds),
590 "%u",
591 i);
592 setenv ("LISTEN_FDS",
593 fds,
594 1);
595 if (0 != strlen (fdnames))
596 setenv ("LISTEN_FDNAMES",
597 fdnames + 1, /* skip leading ':' */
598 1);
599 GNUNET_free (fdnames);
600 }
601#ifndef DARWIN
602 /* due to vfork, we must NOT free memory on DARWIN! */
603 GNUNET_array_grow (lscp,
604 ls,
605 0);
606#endif
607 execvp (filename,
608 argv);
610 "execvp",
611 filename);
612 _exit (1);
613}
enum GNUNET_GenericReturnValue GNUNET_DISK_internal_file_handle_(const struct GNUNET_DISK_FileHandle *fh, int *dst)
Retrieve OS file handle.
Definition: disk.c:1652
static struct GNUNET_NETWORK_Handle * ls
Listen socket for STUN processing.
Definition: gnunet-nat.c:85
const struct GNUNET_DISK_FileHandle * GNUNET_DISK_pipe_handle(const struct GNUNET_DISK_PipeHandle *p, enum GNUNET_DISK_PipeEnd n)
Get the handle to a particular pipe end.
Definition: disk.c:1635
struct GNUNET_DISK_FileHandle * GNUNET_DISK_pipe_detach_end(struct GNUNET_DISK_PipeHandle *p, enum GNUNET_DISK_PipeEnd end)
Detaches one of the ends from the pipe.
Definition: disk.c:1578
struct GNUNET_DISK_PipeHandle * GNUNET_DISK_pipe(enum GNUNET_DISK_PipeFlags pf)
Creates an interprocess channel.
Definition: disk.c:1458
enum GNUNET_GenericReturnValue GNUNET_DISK_pipe_close(struct GNUNET_DISK_PipeHandle *p)
Closes an interprocess channel.
Definition: disk.c:1605
@ GNUNET_DISK_PF_NONE
No special options, use non-blocking read/write operations.
@ GNUNET_DISK_PIPE_END_WRITE
The writing-end of a pipe.
@ GNUNET_DISK_PIPE_END_READ
The reading-end of a pipe.
@ GNUNET_OK
@ GNUNET_NO
@ GNUNET_SYSERR
int int GNUNET_asprintf(char **buf, const char *format,...) __attribute__((format(printf
Like asprintf, just portable.
#define GNUNET_strdup(a)
Wrapper around GNUNET_xstrdup_.
#define GNUNET_array_grow(arr, size, tsize)
Grow a well-typed (!) array.
int GNUNET_snprintf(char *buf, size_t size, const char *format,...) __attribute__((format(printf
Like snprintf, just aborts if the buffer is of insufficient size.
#define GNUNET_new(type)
Allocate a struct or union of the given type.
#define GNUNET_array_append(arr, len, element)
Append an element to an array (growing the array by one).
#define GNUNET_free(ptr)
Wrapper around free.
enum GNUNET_GenericReturnValue GNUNET_OS_check_helper_binary(const char *binary, bool check_suid, const char *params)
Check whether an executable exists and possibly if the suid bit is set on the file.
@ GNUNET_OS_INHERIT_STD_IN
When this flag is set, the child process will inherit stdin of the parent.
Definition: gnunet_os_lib.h:83
@ GNUNET_OS_INHERIT_STD_OUT
When this flag is set, the child process will inherit stdout of the parent.
Definition: gnunet_os_lib.h:89
@ GNUNET_OS_INHERIT_STD_ERR
When this flag is set, the child process will inherit stderr of the parent.
Definition: gnunet_os_lib.h:95
@ GNUNET_OS_USE_PIPE_CONTROL
Should a pipe be used to send signals to the child?
#define LOG_STRERROR_FILE(kind, syscall, filename)
Definition: os_priority.c:38
static void open_dev_null(int target_fd, int flags)
Open '/dev/null' and make the result the given file descriptor.
Definition: os_priority.c:278
Handle used to manage a pipe.
Definition: disk.c:69
pid_t pid
PID of the process.
Definition: os_priority.c:50
struct GNUNET_DISK_FileHandle * control_pipe
Pipe we use to signal the process.
Definition: os_priority.c:56

References GNUNET_OS_Process::control_pipe, filename, GNUNET_array_append, GNUNET_array_grow, GNUNET_asprintf(), GNUNET_assert, GNUNET_break, GNUNET_DISK_file_close(), GNUNET_DISK_internal_file_handle_(), GNUNET_DISK_PF_NONE, GNUNET_DISK_pipe(), GNUNET_DISK_pipe_close(), GNUNET_DISK_pipe_detach_end(), GNUNET_DISK_PIPE_END_READ, GNUNET_DISK_PIPE_END_WRITE, GNUNET_DISK_pipe_handle(), GNUNET_ERROR_TYPE_ERROR, GNUNET_free, GNUNET_new, GNUNET_NO, GNUNET_OK, GNUNET_OS_check_helper_binary(), GNUNET_OS_CONTROL_PIPE, GNUNET_OS_INHERIT_STD_ERR, GNUNET_OS_INHERIT_STD_IN, GNUNET_OS_INHERIT_STD_OUT, GNUNET_OS_USE_PIPE_CONTROL, GNUNET_snprintf(), GNUNET_strdup, GNUNET_SYSERR, LOG_STRERROR, LOG_STRERROR_FILE, ls, open_dev_null(), GNUNET_OS_Process::pid, and ret.

Referenced by GNUNET_OS_start_process_v(), and GNUNET_OS_start_process_vap().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ process_status()

static enum GNUNET_GenericReturnValue process_status ( struct GNUNET_OS_Process proc,
enum GNUNET_OS_ProcessStatusType type,
unsigned long *  code,
int  options 
)
static

Retrieve the status of a process, waiting on it if dead.

Nonblocking version.

Parameters
procprocess ID
typestatus type
codereturn code/signal number
optionsWNOHANG if non-blocking is desired
Returns
GNUNET_OK on success, GNUNET_NO if the process is still running, GNUNET_SYSERR otherwise

Definition at line 840 of file os_priority.c.

844{
845 int status;
846 int ret;
847
848 GNUNET_assert (0 != proc);
849 ret = waitpid (proc->pid,
850 &status,
851 options);
852 if (ret < 0)
853 {
855 "waitpid");
856 return GNUNET_SYSERR;
857 }
858 if (0 == ret)
859 {
861 *code = 0;
862 return GNUNET_NO;
863 }
864 if (proc->pid != ret)
865 {
867 "waitpid");
868 return GNUNET_SYSERR;
869 }
870 if (WIFEXITED (status))
871 {
873 *code = WEXITSTATUS (status);
874 }
875 else if (WIFSIGNALED (status))
876 {
878 *code = WTERMSIG (status);
879 }
880 else if (WIFSTOPPED (status))
881 {
883 *code = WSTOPSIG (status);
884 }
885#ifdef WIFCONTINUED
886 else if (WIFCONTINUED (status))
887 {
889 *code = 0;
890 }
891#endif
892 else
893 {
895 *code = 0;
896 }
897
898 return GNUNET_OK;
899}
struct GNUNET_GETOPT_CommandLineOption options[]
Definition: 002.c:5
static uint32_t type
Type string converted to DNS type value.
static int status
The program status; 0 for success.
Definition: gnunet-nse.c:39
@ GNUNET_ERROR_TYPE_WARNING
@ GNUNET_OS_PROCESS_SIGNALED
The process was killed by a signal.
@ GNUNET_OS_PROCESS_EXITED
The process exited with a return code.
@ GNUNET_OS_PROCESS_UNKNOWN
The process is not known to the OS (or at least not one of our children).
@ GNUNET_OS_PROCESS_RUNNING
The process is still running.

References GNUNET_assert, GNUNET_ERROR_TYPE_WARNING, GNUNET_NO, GNUNET_OK, GNUNET_OS_PROCESS_EXITED, GNUNET_OS_PROCESS_RUNNING, GNUNET_OS_PROCESS_SIGNALED, GNUNET_OS_PROCESS_UNKNOWN, GNUNET_SYSERR, LOG_STRERROR, options, GNUNET_OS_Process::pid, ret, status, and type.

Referenced by GNUNET_OS_process_status(), and GNUNET_OS_process_wait_status().

Here is the caller graph for this function:

◆ cmd_read()

static void cmd_read ( void *  cls)
static

Read from the process and call the line processor.

Parameters
clsthe struct GNUNET_OS_CommandHandle *

Definition at line 1012 of file os_priority.c.

1013{
1014 struct GNUNET_OS_CommandHandle *cmd = cls;
1015 const struct GNUNET_SCHEDULER_TaskContext *tc;
1017 char *end;
1018 ssize_t ret;
1019
1020 cmd->rtask = NULL;
1023 {
1024 /* timeout */
1025 proc = cmd->proc;
1026 cmd->proc = NULL;
1027 proc (cmd->proc_cls, NULL);
1028 return;
1029 }
1030 ret = GNUNET_DISK_file_read (cmd->r,
1031 &cmd->buf[cmd->off],
1032 sizeof(cmd->buf) - cmd->off);
1033 if (ret <= 0)
1034 {
1035 if ((cmd->off > 0) && (cmd->off < sizeof(cmd->buf)))
1036 {
1037 cmd->buf[cmd->off] = '\0';
1038 cmd->proc (cmd->proc_cls, cmd->buf);
1039 }
1040 proc = cmd->proc;
1041 cmd->proc = NULL;
1042 proc (cmd->proc_cls, NULL);
1043 return;
1044 }
1045 end = memchr (&cmd->buf[cmd->off], '\n', ret);
1046 cmd->off += ret;
1047 while (NULL != end)
1048 {
1049 *end = '\0';
1050 cmd->proc (cmd->proc_cls, cmd->buf);
1051 memmove (cmd->buf, end + 1, cmd->off - (end + 1 - cmd->buf));
1052 cmd->off -= (end + 1 - cmd->buf);
1053 end = memchr (cmd->buf, '\n', cmd->off);
1054 }
1055 cmd->rtask =
1057 cmd->timeout),
1058 cmd->r,
1059 &cmd_read,
1060 cmd);
1061}
static int end
Set if we are to shutdown all services (including ARM).
Definition: gnunet-arm.c:33
@ GNUNET_YES
int GNUNET_NETWORK_fdset_handle_isset(const struct GNUNET_NETWORK_FDSet *fds, const struct GNUNET_DISK_FileHandle *h)
Check if a file handle is part of an fd set.
Definition: network.c:1127
void(* GNUNET_OS_LineProcessor)(void *cls, const char *line)
Type of a function to process a line of output.
const struct GNUNET_SCHEDULER_TaskContext * GNUNET_SCHEDULER_get_task_context(void)
Obtain the reasoning why the current task was started.
Definition: scheduler.c:758
struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_remaining(struct GNUNET_TIME_Absolute future)
Given a timestamp in the future, how much time remains until then?
Definition: time.c:406
static void cmd_read(void *cls)
Read from the process and call the line processor.
Definition: os_priority.c:1012
static struct GNUNET_SCHEDULER_TaskContext tc
Task context of the current task.
Definition: scheduler.c:431
Handle to a command.
Definition: os_priority.c:942
size_t off
Current read offset in buf.
Definition: os_priority.c:986
char buf[1024]
Buffer for the output.
Definition: os_priority.c:971
struct GNUNET_SCHEDULER_Task * rtask
Task reading from pipe.
Definition: os_priority.c:976
struct GNUNET_TIME_Absolute timeout
When to time out.
Definition: os_priority.c:981
void * proc_cls
Closure for proc.
Definition: os_priority.c:966
GNUNET_OS_LineProcessor proc
Function to call on each line of output.
Definition: os_priority.c:961
const struct GNUNET_DISK_FileHandle * r
Read-end of output pipe.
Definition: os_priority.c:956
Context information passed to each scheduler task.
const struct GNUNET_NETWORK_FDSet * read_ready
Set of file descriptors ready for reading; note that additional bits may be set that were not in the ...

References GNUNET_OS_CommandHandle::buf, cmd_read(), end, GNUNET_DISK_file_read(), GNUNET_NETWORK_fdset_handle_isset(), GNUNET_SCHEDULER_add_read_file(), GNUNET_SCHEDULER_get_task_context(), GNUNET_TIME_absolute_get_remaining(), GNUNET_YES, GNUNET_OS_CommandHandle::off, GNUNET_OS_CommandHandle::proc, GNUNET_OS_CommandHandle::proc_cls, GNUNET_OS_CommandHandle::r, GNUNET_SCHEDULER_TaskContext::read_ready, ret, GNUNET_OS_CommandHandle::rtask, tc, and GNUNET_OS_CommandHandle::timeout.

Referenced by cmd_read(), and GNUNET_OS_command_run().

Here is the call graph for this function:
Here is the caller graph for this function:

Variable Documentation

◆ current_process

struct GNUNET_OS_Process current_process
static

Handle for 'this' process.

Definition at line 63 of file os_priority.c.

Referenced by GNUNET_OS_process_current().

◆ pch

◆ spch

struct GNUNET_SCHEDULER_Task* spch
static

Handle for the shutdown_pch() Task.

Definition at line 73 of file os_priority.c.

Referenced by GNUNET_OS_install_parent_control_handler(), and parent_control_handler().