Volume 7B: XView Reference Manual

• NOTICE_TRIGGERED if a trigger was used.

• NOTICE_FAILED if the notice failed to pop up.

int

notice_prompt(window, event, attributes)

XV_Window window;

Event *event;

attribute-list

attributes;

notify_default_wait3()

Predefined function you can register with the Notifier via the

notify_set_wait3_func() call. Causes the required housekeeping to be per-

formed on the process identified by pid when it dies. See the wait(2) man page for

details of the wait and rusage structures.

Notify_value

notify_default_wait3(client, pid, status, rusage)

Notify_client client;

int pid;

int *status;

struct rusage *rusage;

notify_dispatch()

Provided to allow programs which are not notification-based to run in an event-driven

environment. Called regularly from within the application’s main loop to allow the

Notifier to go once around its internal loop and dispatch any pending events.

Notify_error

notify_dispatch()

notify_do_dispatch()

Enables implicit dispatching, in which the Notifier dispatches events from within calls

to read(2) or select(2).

Notify_error

notify_do_dispatch()

notify_enable_rpc_svc()

If you use an RPC server that also needs to work with XView, use the XView function

notify_enable_rpc_svc(), and do not call svc_run(). This function takes

an int that tells the notifier whether it should handle RPC requests.

Using this aproach, xv_main_loop() handles incoming RPC requests; dispatching

them just as if svc_run() had been called.

If notify_enable_rpc_svc is enabled, the Notifier checks svc_fdset and

calls svc_getreqset() if a descriptor is readable (a request is coming in). Perfor-

mance is affected by the additional call to svc_getreqset().

void

notify_enable_rpc_svc(bool)

int bool;

Procedures and Macros

Procedures and Macros 185

notify_flush_pending()

Notifier removes client and flushes requests for it.

void

notify_flush_pending(nclient)

Notify_client nclient;

See Also: notify_no_dispatch().

notify_get_destroy_func()

Notify_func

notify_get_destroy_func(client)

Notify_client client;

notify_get_event_func()

Notify_func

notify_get_event_func(client, when)

Notify_client client;

int when;

notify_get_exception_func()

Notify_func

notify_get_exception_func(client, fd)

Notify_client client;

int fd;

notify_get_input_func()

Notify_func

notify_get_input_func(client, fd)

Notify_client client;

int fd;

notify_get_itimer_func()

Notify_func

notify_get_itimer_func(client, which)

Notify_client client;

int which;

notify_get_output_func()

Notify_func

notify_get_output_func(client, fd)

Notify_client client;

int fd;

186 XView Reference Manual

notify_get_signal_func()

Notify_func

notify_get_signal_func(client, signal, mode)

Notify_client client;

int signal;

Notify_signal_mode mode;

notify_get_wait3_func()

Notify_func

notify_get_wait3_func(client, pid)

Notify_client client;

int pid;

notify_interpose_destroy_func()

Interposes destroy_func() in front of client’s destroy event handler.

Notify_error

notify_interpose_destroy_func(client, destroy_func)

Notify_client client;

Notify_func destroy_func;

client is the handle of the Notifier client in front of which you are interposing.

destroy_func is a notify function to be called before the client’s destroy function.

The format for the destroy function is:

Notify_value

destroy_func(client, status)

Notify_client client;

Destroy_status status;

notify_interpose_event_func()

Interposes event_func() in front of client’s event handler.

Notify_error

notify_interpose_event_func(client, event_func, type)

Notify_client client;

Notify_func event_func;

Notify_event_type type;

client is the handle of the Notifier client in front of which you are interposing.

event_func is the notify function to be called before the client’s event function.

type is either NOTIFY_SAFE or NOTIFY_IMMEDIATE. The format for the event func-

tion is:

Notify_value

event_func(client, event, arg, type)

Notify_client client;

Notify_event event;

Notify_arg arg;

Notify_event_type type;

Procedures and Macros

Procedures and Macros 187

notify_interpose_exception_func()

Interposes exception_func in front of the client’s exception handler.

Notify_error

notify_interpose_exception_func(client, exception_func,fd)

Notify_client client;

Notify_func exception_func;

int fd;

client is the handle of the Notifier client in front of which you are interposing. ex-

ception_func is the notify function to be called before the client’s exception func-

tion. type is either

NOTIFY_SAFE or NOTIFY_IMMEDIATE. The format for the excep-

tion function is:

Notify_value

exception_func(client, fd)

Notify_client client;

int fd;

notify_interpose_input_func()

Interposes input_func in front of client’s Notifier.

Notify_error

notify_interpose_input_func(client, input_func, fd)

Notify_client client;

Notify_func input_func;

int fd;

client is the handle of the Notifier client in front of which you are interposing.

input_func is the notify function to be called before the client’s input function.

The format for the input function is:

Notify_value

input_func(client, fd)

Notify_client client;

int fd;

notify_interpose_itimer_func()

Interposes the itimer_func in front of the client’s timeout event handler.

Notify_error

notify_interpose_itimer_func(client, itimer_func, which)

Notify_client client;

Notify_func itimer_func;

int which;

client is the handle of the Notifier client in front of which you are interposing.

itimer_func is the notify function to be called before the client’s timeout handler.

which is either ITIMER_REAL or ITIMER_VIRTUAL. The format for the itimer func-

tion is:

Notify_value

itimer_func(client, which)

Notify_client client;

int which;

188 XView Reference Manual

notify_interpose_output_func()

Interposes output_func in front of client’s Notifier.

Notify_error

notify_interpose_output_func(client, output_func, fd)

Notify_client client;

Notify_func output_func;

int fd;

client is the handle of the Notifier client in front of which you are interposing.

output_func is the notify function to be called before the client’s output function.

The format for the output function is:

Notify_value

output_func(client, fd)

Notify_client client;

int fd;

notify_interpose_signal_func()

Interposes the signal_func() in front of the signal event handler.

Notify_error

notify_interpose_signal_func(client, signal_func, signal, mode)

Notify_client client;

Notify_func signal_func;

int signal;

int mode;

client is the handle of the Notifier client in front of which you are interposing.

signal_func is the notify function to be called before the client’s signal handler.

signal is the

UNIX software interrupt. mode is either NOTIFY_ASYNC or

NOTIFY_SYNC. The format for the signal function is:

Notify_value

signal_func(client, signal, mode)

Notify_client client;

int signal;

int mode;

notify_interpose_wait3_func()

Interposes the wait3_func in front of the Notifier.

Notify_error

notify_interpose_wait3_func(client, wait3_func, pid)

Notify_client client;

Notify_func wait3_func;

int pid;

client is the handle of the Notifier client in front of which you are interposing.

wait3_func is the notify function to be called before the client’s wait3 function.

The format for the wait3 function on BSD-based systems is:

Notify_value

wait3_func(client, pid, status, rusage)

Notify_client client;

int pid;

Procedures and Macros

Procedures and Macros 189