/usr/include/nih/child.h is in libnih-dev 1.0.3-4ubuntu9.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | /* libnih
*
* Copyright © 2009 Scott James Remnant <scott@netsplit.com>.
* Copyright © 2009 Canonical Ltd.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2, as
* published by the Free Software Foundation.
*
* 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.
*/
#ifndef NIH_CHILD_H
#define NIH_CHILD_H
#include <sys/types.h>
#include <sys/wait.h>
#include <nih/macros.h>
#include <nih/list.h>
/**
* NihChildEvents:
*
* Events that can occur for child processes, and used to determine the
* content of the translated status field. For NIH_CHILD_EXITED this will
* contain the exit status of the program; for NIH_CHILD_PTRACE this will
* contain one of the PTRACE_EVENT_* constants; otherwise this will
* contain the signal that killed, dumped, stopped or continued the process
* or was trapped through ptrace.
**/
typedef enum {
NIH_CHILD_NONE = 0000,
NIH_CHILD_EXITED = 0001,
NIH_CHILD_KILLED = 0002,
NIH_CHILD_DUMPED = 0004,
NIH_CHILD_STOPPED = 0010,
NIH_CHILD_CONTINUED = 0020,
NIH_CHILD_TRAPPED = 0040,
NIH_CHILD_PTRACE = 0100,
NIH_CHILD_ALL = 0177
} NihChildEvents;
/**
* NihChildHandler:
* @data: data pointer given with callback,
* @pid: process that changed,
* @event: event that occurred on the child,
* @status: exit status of process, signal that killed it or ptrace event.
*
* A child handler is a function called for events on the child process
* obtained through waitid().
**/
typedef void (*NihChildHandler) (void *data, pid_t pid,
NihChildEvents event, int status);
/**
* NihChildWatch:
* @entry: list header,
* @pid: process id to watch or -1,
* @events: events to watch for,
* @handler: function called when events occur to child,
* @data: pointer passed to @reaper.
*
* This structure represents a watch on a particular child, the @reaper
* function is called when an event in @events occurs to a child with
* process id @pid. If @pid is -1 then this function is called when @events
* occur for all processes.
*
* The watch can be cancelled by calling nih_list_remove() on the structure
* as they are held in a list internally.
**/
typedef struct nih_child_watch {
NihList entry;
pid_t pid;
NihChildEvents events;
NihChildHandler handler;
void *data;
} NihChildWatch;
NIH_BEGIN_EXTERN
extern NihList *nih_child_watches;
void nih_child_init (void);
NihChildWatch *nih_child_add_watch (const void *parent, pid_t pid,
NihChildEvents events,
NihChildHandler handler, void *data)
__attribute__ ((warn_unused_result, malloc));
void nih_child_poll (void);
NIH_END_EXTERN
#endif /* NIH_CHILD_H */
|