src/lib-test/test-subprocess.h - main - niceSOFT/dovecot

src/lib-test/test-subprocess.h
47 строк2 KB
Stephan Bosch
lib-test: test-common - Add test generic event
05 ноя 2025, 13:17
05 ноя 2025, 13:17dd4be41
#ifndef TEST_SUBPROCESS_H
#define TEST_SUBPROCESS_H

#define TEST_SIGNALS_DEFAULT_TIMEOUT_MS 10000

/* Fork a sub-process for this test. The func is the main function for the
   forked sub-process. The provided context is passed to the provided function.
   When continue_test=FALSE, the test is ended immediately in the sub-process,
   otherwise, the test continues and its result is used to set the exit code
   when the process ends gracefully. */
pid_t ATTR_NOWARN_UNUSED_RESULT
test_subprocess_fork(int (*func)(void *), void *context,
		     bool continue_test);
#define test_subprocess_fork(func, context, continue_test) \
	test_subprocess_fork( \
		(int(*)(void*))func, \
		(TRUE ? context : \
		 CALLBACK_TYPECHECK(func, int(*)(typeof(context)))), \
		continue_test)

/* Wait for all sub-processes to terminate voluntarily within the provided
   timeout. */
void test_subprocess_wait_all(unsigned int timeout_secs);
/* Kill all sub-processes initially with SIGTERM and subsequently with SIGKILL
   when any sub-processes are not terminated gracefully within the provided
   timeout. */
void test_subprocess_kill_all(unsigned int timeout_secs);

bool test_subprocess_is_child(void);

/* Send a notification signal (SIGHUP) to the given PID */
void test_subprocess_notify_signal_send(int signo, pid_t pid);
/* Send a notification signal to the parent process. */
void test_subprocess_notify_signal_send_parent(int signo);
/* Send a notification signal to all the subprocesses. */
void test_subprocess_notify_signal_all(int signo);
/* Reset any previously sent notification signals. */
void test_subprocess_notify_signal_reset(int signo);
/* Wait until a notification signal is sent, or return immediately if it was
   already sent. test_subprocess_notify_signal_reset() should be called before
   this to make sure it's not returning due to a previously sent signal.
   If the timeout is reached, i_fatal() is called. */
void test_subprocess_notify_signal_wait(int signo, unsigned int timeout_msecs);

void test_subprocesses_init(void);

#endif