Commit e82b0659 authored by Jonathon Duerig's avatar Jonathon Duerig

Deprecated the 'group' field in the event tuple.

The 'group' field is not used to implement event groups as described in the previous version. Added a blurb describing the fact that event groups are implemented using multiple names in the objname field.
parent 520e0f02
...@@ -64,7 +64,7 @@ notifications. The system defined fields include: ...@@ -64,7 +64,7 @@ notifications. The system defined fields include:
typedef struct { typedef struct {
char *site; /* Which Emulab site. */ char *site; /* Which Emulab site. */
char *expt; /* Project and experiment IDs */ char *expt; /* Project and experiment IDs */
char *group; /* User defined group of nodes */ char *group; /* Deprecated */
char *host; /* A specific host (ipaddr) */ char *host; /* A specific host (ipaddr) */
char *objtype; /* LINK, TRAFGEN, etc ... */ char *objtype; /* LINK, TRAFGEN, etc ... */
char *objname; /* link0, cbr0, cbr1, etc ... */ char *objname; /* link0, cbr0, cbr1, etc ... */
...@@ -72,6 +72,12 @@ notifications. The system defined fields include: ...@@ -72,6 +72,12 @@ notifications. The system defined fields include:
int scheduler; /* A dynamic event to schedule */ int scheduler; /* A dynamic event to schedule */
} address_tuple; } address_tuple;
Important Note: Event groups are *not* implemented by the group field
in the tuple. Rather, they are implemented by adding names to the
objname field treating it as a comma-delimited field. Since names are
not unique, the event is sent to every agent registered under the
group name.
The last field, scheduler, is used internally to route notifications to the The last field, scheduler, is used internally to route notifications to the
scheduler for an experiment. This is described in more detail below. scheduler for an experiment. This is described in more detail below.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment