PiP Signaling Functions

Functions
int	pip_kill (int pipid, int signal)
	deliver a signal to PiP task More...
int	pip_sigmask (int how, const sigset_t *sigmask, sigset_t *oldmask)
	set signal mask of the current PiP task More...
int	pip_signal_wait (int signal)
	wait for a signal More...

Detailed Description

PiP signaling functions

Description

Signal manupilating functions. All functions listed here are agnostic to the PiP execution mode.

Function Documentation

int pip_kill	(	int	pipid,
		int	signal
	)

Name

pip_kill

Description

This function is agnostic to the PiP execution mode.

Synopsis

#include <pip/pip.h>
int pip_kill( int pipid, int signal );

Parameters

[out]	pipid	PiP ID of a target PiP task to deliver the signal
[out]	signal	signal number to be delivered

Returns

Return 0 on success. Return an error code on error.

Return values

EPERM	PiP library is not yet initialized
EINVAL	An invalid signal number or invalid PiP ID is specified

See Also

tkill(Linux 2)

int pip_sigmask	(	int	how,
		const sigset_t *	sigmask,
		sigset_t *	oldmask
	)

Name

pip_sigmask

Synopsis

#include <pip/pip.h>
int pip_sigmask( int how, const sigset_t *sigmask, sigset_t *oldmask );

Description

This function is agnostic to the PiP execution mode.

Parameters

[in]	how	see sigprogmask or pthread_sigmask
[in]	sigmask	signal mask
[out]	oldmask	old signal mask

Returns

Return 0 on success. Return an error code on error.

Return values

EPERM	PiP library is not yet initialized
EINVAL	An invalid signal number or invalid PiP ID is specified

See Also

sigprocmask(Linux 2)

pthread_sigmask(Linux 2)

int pip_signal_wait

(

int

signal

)

Name

pip_signal_wait

Synopsis

#include <pip/pip.h>
int pip_signal_wait( int signal );

Description

This function is agnostic to the PiP execution mode.

Parameters

[in]

signal

signal to wait

Returns

Return 0 on success. Return an error code on error.

Note

This function does NOT return the EINTR error. This case is treated as normal return;

See Also

sigwait(Linux 2)

sigsuspend(Linux 2)