Trigger()

trigger a proxy to signal a process

Synopsis:

#include <sys/types.h>
#include <sys/kernel.h>
pid_t Trigger( pid_t proxy );

Description:

The kernel function Trigger() triggers proxy to send a message to the process that owns it. The calling process doesn't block. If more than one trigger occurs before the proxy message is received, that number of messages (up to 65535) will be received.

Returns:

The pid that owns the proxy. On error, -1 is returned and errno is set.

Errors:

ESRCH

The proxy doesn't exist.

Examples:

See qnx_proxy_attach().

Classification:

QNX

Caveats:

Trigger() is a macro.

See also:

Creceive(), Creceivemx(), errno, qnx_proxy_attach(), qnx_proxy_detach(), Receive(), Receivemx(), Reply(), Replymx(), Readmsg(), Readmsgmx(), Send(), Sendfd(), Sendfdmx(), Sendmx(), Writemsg(), Writemsgmx()