ev_suspend(3event)

ev_suspend -- suspends an event queue.

Synopsis

cc . . . -levent

#include  <sys/types.h>
#include  <sys/param.h>
#include  <sys/sysmacros.h>
#include  <sys/page.h>
#include  <sys/event.h>
#include  <mouse.h>

int ev_suspend ()

Description

ev_suspend suspends an event queue from receiving input. For example, if an application wants to fork a subshell, a call to ev_suspend suspends events until the subshell returns and the queue is resumed with an ev_resume call. That way a process in the subshell can also have an event queue. This is required because the event manager only allows one active event queue per terminal or multiscreen.

Return values

This function returns -1 if no event queue is opened. It returns -2 if the queue is already suspended. Normally it returns zero.

References

ev_block(3event), ev_close(3event), ev_count(3event), ev_flush(3event), ev_getdev(3event), ev_getemask(3event), ev_gindev(3event), ev_init(3event), ev_open(3event), ev_pop(3event), ev_read(3event), ev_resume(3event), ev_setemask(3event)

Standards conformance

ev_susp is not part of any currently supported standard; it is an extension of AT&T System V provided by the Santa Cruz Operation.