Series 300 and 500 Only

NAME

wsetsigmask − set window SIGWINDOW interrupt mask

SYNOPSIS

#include <window.h>
#include <sys/signal.h>
int wsetsigmask(fd,mask);
int fd;
int mask;

DESCRIPTION

fd is an integer file descriptor for an opened window type device interface. 

mask is used to specify conditions to interrupt the user process with the SIGWINDOW signal. mask is a set of bits defined by the following bit names, where the default mask setting is 0. The header file containing these defines is /usr/include/window.h.  SIGWINDOW is defined in /usr/include/sys/signal.h. 

EVENT_B1_DOWN button 1 pressed

EVENT_B1_UP button 1 released

EVENT_B2_DOWN button 2 pressed

EVENT_B2_UP button 2 released

EVENT_B3_DOWN button 3 pressed

EVENT_B3_UP button 3 released

EVENT_B4_DOWN button 4 pressed

EVENT_B4_UP button 4 released

EVENT_B5_DOWN button 5 pressed

EVENT_B5_UP button 5 released

EVENT_B6_DOWN button 6 pressed

EVENT_B6_UP button 6 released

EVENT_B7_DOWN button 7 pressed

EVENT_B7_UP button 7 released

EVENT_B8_DOWN button 8 pressed (in proximity)−i.e., the puck switch or stylus was placed on the graphics tablet

EVENT_B8_UP button 8 released (not in proximity)−i.e, the puck switch or stylus was picked up from the graphics tablet

EVENT_ECHO echo moved while selected

EVENT_MOVE window moved

EVENT_SIZE window sized

EVENT_SELECT KBD Attach state changed

EVENT_REPAINT window needs to be repainted

EVENT_MENU selection made from user-defined menu

EVENT_HOTSPOT a hotspot has been activated

EVENT_DESTROY window destroyed

EVENT_BREAK BREAK key pressed

EVENT_ICON iconic state changed

EVENT_ELEVATOR window border elevator moved

EVENT_SB_ARROW scroll bar arrow selected

EVENT_ABORT interactive operation was aborted

DISCUSSION

This command is used set up signal generation events.  Each process that desires to receive SIGWINDOW for a set of mask bits must call wsetsigmask separately.  One window can send SIGWINDOW to up to three processes.  The receiving program still has to catch SIGWINDOW with the signal function call.  The default signal behavior is SIG_IGN (ignore signal). 

EVENT_HOTSPOT, EVENT_DESTROY, EVENT_BREAK, EVENT_ICON, EVENT_ELEVATOR, EVENT_SB_ARROW, and EVENT_ABORT are supported only by graphics windows. 

If the limit of three processes per window is exceeded then ENOSPC error will be returned. 

HARDWARE DEPENDENCIES

Series 500:
The Series 500 does not support the following events:

EVENT_HOTSPOT
EVENT_DESTROY
EVENT_BREAK
EVENT_ICON
EVENT_ELEVATOR
EVENT_SB_ARROW
EVENT_ABORT

SEE ALSO

weventclear(3W), weventpoll(3W), wgetsigmask(3W), signal(2). 

DIAGNOSTICS

A return of -1 indicates failure; otherwise 0 is returned.  See errno(2) for more information.

Hewlett-Packard Company  —  May 11, 2021