--- /export/sac/PSARC/2006/248/materials/nemo-mactype-plugins.txt Thu Jun 22 13:00:42 2006 +++ /export/sac/PSARC/2007/298/materials/nemo-mactype-plugins.txt Fri Jun 1 19:45:23 2007 @@ -145,6 +145,7 @@ mtops_pdata_verify_t mtops_pdata_verify; mtops_header_modify_t mtops_header_cook; mtops_header_modify_t mtops_header_uncook; + mtops_link_details_t mtops_link_details; } mactype_ops_t; The mtops_ops field is a set of flags defining which optional operations @@ -157,6 +158,7 @@ #define MTOPS_PDATA_VERIFY 0x001 #define MTOPS_HEADER_COOK 0x002 #define MTOPS_HEADER_UNCOOK 0x004 + #define MTOPS_LINK_DETAILS 0x008 Each plugin operation function has as one of its arguments a pointer to optional (may be NULL) MAC plugin data that the plugin may use. Plugins @@ -345,7 +347,22 @@ operation can make the same DB_REF() assumption as mtops_header_cook(), and also has the same success and error semantics. +3.9 mtops_link_details + This operation is used to collect a human-parseable string providing more + information about the link state. Its type is + + typedef void (*mtops_link_details_t)(char *buffer, size_t bufsize, + mac_handle_t handle, void *pdata); + + The operation will store a text description of the link state in the + supplied buffer (not more than bufsize, perhaps by using snprintf), for + consumption in a syslog message or a message that might be delivered by + the framework to FMA or via sysevent to a management application when th + link comes up. For example, the ethernet layer might write the string + "100 Mbps, full duplex" into the buffer. + + 4 MAC Client Functions to Access Plugin Functionality ===================================================== @@ -518,6 +535,7 @@ | | | | | MTOPS_HEADER_COOK | Consolidation Private | | | MTOPS_HEADER_UNCOOK | Consolidation Private | | +| MTOPS_LINK_DETAILS | Consolidation Private | | | MAC_ADDRTYPE_UNICAST | Consolidation Private | | | MAC_ADDRTYPE_MULTICAST | Consolidation Private | | | MAC_ADDRTYPE_BROADCAST | Consolidation Private | |