mirror of
https://github.com/morgan9e/systemd
synced 2026-04-15 08:56:15 +09:00
15930d5d9f
Besides internal comparisons, the inode number of pidfds might be interesting directly to users, too. In the future this field should also be exposed, so that it can serve as a unique identifier of a process (but only for display, as there's no method to map this back to a pid or pidfd).
72 lines
2.9 KiB
C
72 lines
2.9 KiB
C
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
|
#pragma once
|
|
|
|
#include "macro.h"
|
|
|
|
/* An embeddable structure carrying a reference to a process. Supposed to be used when tracking processes continuously. */
|
|
typedef struct PidRef {
|
|
pid_t pid; /* always valid */
|
|
int fd; /* only valid if pidfd are available in the kernel, and we manage to get an fd */
|
|
uint64_t fd_id; /* the inode number of pidfd. only useful in kernel 6.9+ where pidfds live in
|
|
their own pidfs and each process comes with a unique inode number */
|
|
} PidRef;
|
|
|
|
#define PIDREF_NULL (const PidRef) { .fd = -EBADF }
|
|
|
|
/* Turns a pid_t into a PidRef structure on-the-fly *without* acquiring a pidfd for it. (As opposed to
|
|
* pidref_set_pid() which does so *with* acquiring one, see below) */
|
|
#define PIDREF_MAKE_FROM_PID(x) (PidRef) { .pid = (x), .fd = -EBADF }
|
|
|
|
static inline bool pidref_is_set(const PidRef *pidref) {
|
|
return pidref && pidref->pid > 0;
|
|
}
|
|
|
|
int pidref_acquire_pidfd_id(PidRef *pidref);
|
|
bool pidref_equal(PidRef *a, PidRef *b);
|
|
|
|
/* This turns a pid_t into a PidRef structure, and acquires a pidfd for it, if possible. (As opposed to
|
|
* PIDREF_MAKE_FROM_PID() above, which does not acquire a pidfd.) */
|
|
int pidref_set_pid(PidRef *pidref, pid_t pid);
|
|
int pidref_set_pidstr(PidRef *pidref, const char *pid);
|
|
int pidref_set_pidfd(PidRef *pidref, int fd);
|
|
int pidref_set_pidfd_take(PidRef *pidref, int fd); /* takes ownership of the passed pidfd on success*/
|
|
int pidref_set_pidfd_consume(PidRef *pidref, int fd); /* takes ownership of the passed pidfd in both success and failure */
|
|
int pidref_set_parent(PidRef *ret);
|
|
static inline int pidref_set_self(PidRef *pidref) {
|
|
return pidref_set_pid(pidref, 0);
|
|
}
|
|
|
|
bool pidref_is_self(const PidRef *pidref);
|
|
|
|
void pidref_done(PidRef *pidref);
|
|
PidRef *pidref_free(PidRef *pidref);
|
|
DEFINE_TRIVIAL_CLEANUP_FUNC(PidRef*, pidref_free);
|
|
|
|
int pidref_copy(const PidRef *pidref, PidRef *dest);
|
|
int pidref_dup(const PidRef *pidref, PidRef **ret);
|
|
|
|
int pidref_new_from_pid(pid_t pid, PidRef **ret);
|
|
|
|
int pidref_kill(const PidRef *pidref, int sig);
|
|
int pidref_kill_and_sigcont(const PidRef *pidref, int sig);
|
|
int pidref_sigqueue(const PidRef *pidref, int sig, int value);
|
|
|
|
int pidref_wait(const PidRef *pidref, siginfo_t *siginfo, int options);
|
|
int pidref_wait_for_terminate(const PidRef *pidref, siginfo_t *ret);
|
|
|
|
static inline void pidref_done_sigkill_wait(PidRef *pidref) {
|
|
if (!pidref_is_set(pidref))
|
|
return;
|
|
|
|
(void) pidref_kill(pidref, SIGKILL);
|
|
(void) pidref_wait_for_terminate(pidref, NULL);
|
|
pidref_done(pidref);
|
|
}
|
|
|
|
int pidref_verify(const PidRef *pidref);
|
|
|
|
#define TAKE_PIDREF(p) TAKE_GENERIC((p), PidRef, PIDREF_NULL)
|
|
|
|
extern const struct hash_ops pidref_hash_ops;
|
|
extern const struct hash_ops pidref_hash_ops_free; /* Has destructor call for pidref_free(), i.e. expects heap allocated PidRef as keys */
|