mike-jumper opened a new pull request #297: URL: https://github.com/apache/guacamole-server/pull/297
This change adds a new header to libguac, `argv.h`, which provides a series of convenience functions for automatically handling "argv" streams: * `guac_argv_register()` - Registers a callback which should be invoked when the full, updated value of an argument has been received via an "argv" stream. Option flags can be specified to declare that a particular callback should be invoked only once, or that received values should be echoed back to all users of the connection. * `guac_argv_received()` - Hands over control of a received "argv" stream such that registered callbacks will automatically be invoked. * `guac_argv_handler` - Convenient implementation of the "argv" instruction handler which automatically handles sending of "ack" instructions and invokes `guac_argv_received()` appropriately. In general, `guac_argv_register()` and `guac_argv_handler` should be sufficient to replace all current usage of the "argv" stream. For handling of "argv" streams that must block the connection, two additional functions are provided: * `guac_argv_await()` - Blocks until each of the provided NULL-terminated list of arguments has been received. * `guac_argv_stop()` - Safely unblocks any `guac_argv_await()` that are currently blocked, and prevents any future calls from blocking. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected]
