The "chx" Package

These routines are meant to provide a generic and simple to use channel management facility (ie. event processing on pipes, connections and terminals). These routines rely on the Xt toolkit event handler. A similar set of routines: chm provide identical functionality (with the addition of the polling routine), except that they rely directly on Unix.

Library: karmaXt
Link With: -lkarmaXt

Functions

chx_register_app_context	Register Xt application context for event management.
chx_manage	Manage a channel for activity by registering callback routines.
chx_unmanage	Terminate the management of a channel for activity.

Functions

void chx_register_app_context (XtAppContext context)

This routine will register the application context to use for channel management with the Xt toolkit. This must be called before ANY reference is made to any other chx routines (i.e. before passing to conn_register_managers).

Parameters:

context : The application context.

Returns: Nothing.
Multithreading Level: Unsafe

flag chx_manage ( Channel channel, void *info, flag (*input_func) (), void (*close_func) (), flag (*output_func) (), flag (*exception_func) () )

This routine will manage a channel for activity by registering callback routines. The Xt Intrinsics event management scheme is used for the underlying management. See chm_manage for the interface definition.

Parameters:

Returns:
Multithreading Level: Unsafe

void chx_unmanage (Channel channel)

Terminate the management of a channel for activity.

Parameters:

channel : The channel object to unmanage.

Returns: Nothing.
Multithreading Level: Unsafe
Note:

This routine will NOT close the channel (nor does it assume the channel is open).

Contact: Richard Gooch
Web Development: Ariel Internet Services