#include "collect.h"
pid_t Col_set_proxy(unsigned char id, unsigned char msg);
Col_set_proxy() provides a mechanism for synchronizing a process with data collection, which is often useful for low-level control functions such as scanning. This function creates a one-byte-long proxy message and passes it to collection to be trigger at an agreed-upon rate. The actual triggering of the proxy must be explicitly coded into the collection process, but there is an established TMC syntax to facilitate the registration process.
id is a magic number agreed-upon between the process and collection for identifying which proxy is designated. msg is the one-byte contents of the proxy which will be created.
On termination, Col_reset_proxy() may be called to provide an orderly shutdown.
Col_set_proxy() returns the proxy's pid if successful. Otherwise it returns -1 unless nl_response indicates a fatal response.
Data Collection functions, Col_reset_proxy().