Subscription management functions

• sm_subscribe

  long sm_subscribe(char *mailbox);
  

  
  mailbox

  Mailbox name to subscribe.

  This function adds the given mailbox name to the local subscription list, and returns T if successful, NIL if failure.

• sm_unsubscribe

  long sm_unsubscribe(char *mailbox);
  

  
  mailbox

  Mailbox name to unsubscribe.

  This function removes the given mailbox name from the local subscription list, and returns T if successful, NIL if failure.

• sm_read

  char *sm_read(void **sdb);
  

  
  sdb

  Data to use in subsequent calls, or NIL if first call.

  This function returns the local subscription list as null terminated strings. Each call returns the next element in the list. The first call should be with sdb pointing to a NIL pointer; this will be filled in for subsequent calls. At the last call, NIL will be returned.