do need isc/util.h
mutex and recv_lock no longer needed in connection; wait_lock used instead.
messages_expected no longer needed in connection.
no more omapi_ipv6
connection_send return value changed from void to isc_result_t
connection_wait no longer takes a timeout parameter
new private function, handle_destroy
include isc/region.h and new omapi/types.h
typedefs moved to omapi/types.h
define protocol port to 7912 so as not to conflict with dhcp server;
this clearly needs more thought. the default omapi port will need to be
server specific rather than library specific.
new public functions, omapi_listener_shutdown, omapi_data_getint.
changed API, omapi_string_totext, omapi_value_getint
ensure only one socket task is outstanding at a time.
allow remote port to be 0, will use OMAPI_PROTOCOL_PORT.
cleaned up error handling so that everything is freed when
something fails.
(an omapi manager).
overhaul of way connection locking is done.
clarified/fixed where connections can get disconnected.
omapi_value_asint renamed to omapi_value_getint (because
omapi_value_assstr was amusing but in questionable taste)
don't require an object in an OMAPI_OP_UPDATE message; thus the
message can be used just for notification. (though arguably
OMAPI_OP_STATUS can be used, with a bit more effort.)
free the notify_object if it exists.
signal the notify_object with "status" in preference to the value object.
directly.
note whether memory context is internal to the library so it can be
destroyed by omapi_lib_destroy.
destroy the handle table.
set destroyed pointers to null.
require omapi_lib_init only be called once (without omapi_lib_destroy).
Allow only one socket event to be outstanding at a time.
Signal the listener when a connection it accepted has disconnected.
Set some destroyed/freed pointers to NULL after destruction/freeing.
Use isc_net_probeipv6 directly instead of omapi_ipv6 variable.
clarify the REQUIRE for omapi_message_unregister.
allow omapi_message_send to be called with a protocol manager object
in addition to a protocol object.
always remove the reference added to the object referred to in an UPDATE
operation, not just on error. it is a temporary variable and the extra
reference kept the object from being freed.
insist the message being destroyed in message_destroy is unregistered,
which follows logically from how message_destroy would be called anyway.
* no spaces around " -> " in indirect postfix expression.
* no space between function name and open parenthesis.
* no space between array name and open bracket.
* use NULL not 0 for pointers.
* explicitly compare pointers to NULL.
* explicitly compare integers to 0.
* Do not cast NULL.
* return type of function declaration on line by itself.
* open brace of function definition follows close parenthesis if parameters
all fit on one line.
* comment-only lines start with /* on line by itself, and end with */
on line by itself.
* variable names in structures separated from their types in a column.
* name the parameters in function prototypes.
* ifndef multiple header file inclusion.
and other BIND9 conventions not in coding.html:
* private structures defined in relevant source module, not private header.
* RCS /* $Id: $ */ comments.
* Principal Author (Ted Lemon) comments.
* Updated ISC copyrights.
* Parenthesize value of return().
* Parenthesize argument of sizeof().
* "unsigned int foo" not "unsigned foo".
* ISC_LANG_(BEGIN|END)DECLS in header files.
* header files included directly by source/header file that needs them.
* ... and others I am probably forgetting.
and conversion to some libisc.a modules:
* use isc/int.h for isc_uintXX_t types, not u_intXX_t.
* use isc/assertions.h for REQUIRE() and INSIST().
* use isc/error.h for UNEXPECTED_ERROR.
* use isc/boolean.h for isc_boolean_t flags instead of int flags.
* use isc/net.h for networking types.
* use isc/netdb.h for gethostby*.
STILL TO COME ...
* more isc_boolean_t.
* isc/time.h to replace struct timeval.
* isc/socket.h to replace socket/listen/select/etc.
* isc/mem.h to replace malloc/free.
* namespace overhaul & omapi/compatibility.h.
Please collect all your belongings but stand clear of the doors until this
train has come to a complete stop.
