![](/api/v2/epubs/9780937175880/files/bg10f.png)
• 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
![](/api/v2/epubs/9780937175880/files/bg10f.png)
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
![](/api/v2/epubs/9780937175880/files/bg127.png)
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
Get Volume 7B: XView Reference Manual now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.