#ifndef _A1CLIENT_H_
#define _A1CLIENT_H_ 1

/* The Anyone client (A1C) library.  Allows application programs to access 
 * "Anyone Server" agents on the system.  The agents are written using
 * the A1S library.
 */

#include "bool.h"
#include "ruleset.h"
#include "sysdep.h"

extern Bool 		AlA1C_init(NOARGS);
extern AlRuleSet	AlA1C_read_rules PROTOTYPE((const char *));
extern Bool		AlA1C_write_rules PROTOTYPE((AlRuleSet, const char *));
extern Bool		AlA1C_delete_rules PROTOTYPE((const char *));
#endif

/* ----- Very brief comments ----
 * AlA1C_init()
 * Needs to be called before any other A1C command.
 *
 * AlA1C_read_rules(agent_name)
 * Locates and reads the rules associated with the agent named agent_name 
 * and belonging to the current user.
 * Returns NULL if the agent does not exist.  Returns
 * an empty ruleset if the agent exists, but the user has not stored any
 * rules.
 *
 * AlA1C_write_rules(ruleset, agent_name)
 * Locates the agent named agent_name and sends it the ruleset to replace
 * any existing rules stored by the current user.
 *
 * AlA1C_delete_rules(agent_name)
 * Sends a control message to the agent named agent_name requesting that
 * any rules submitted by the the current user by deleted.
 */