Manual Pages for UNIX Operating System command usage for man sysevent_post_event

System Event Library Functions     sysevent_post_event(3SYSEVENT)



NAME
     sysevent_post_event - post system event for applications

SYNOPSIS
     cc  [ flag... ]  file... -lsysevent  -lnvpair  [ library... ]
     #include 
     #include 

     int sysevent_post_event(char *class, char *subclass, char *vendor,
          char *publisher, nvlist_t *attr_list, sysevent_id_t *eid);


PARAMETERS
     attr_list    pointer to an nvlist_t, listing the  name-value
                  attributes  associated  with the event, or NULL
                  if there are no such attributes for this event


     class        pointer to a string defining the event class


     eid          pointer to a system unique identifier


     publisher    pointer to a string defining the  event's  pub-
                  lisher nam


     subclass     pointer to a string defining the event subclass


     vendor       pointer to a string defining the vendor


DESCRIPTION
     The sysevent_post_event() function causes a system event  of
     the  specified  class, subclass, vendor, and publisher to be
     generated on behalf of the caller and queued for delivery to
     the sysevent daemon syseventd(1M).


     The vendor should be the company stock symbol (or  similarly
     enduring  identifier)  of the event posting application. The
     publisher should be the name of the  application  generating
     the event.


     For example, all events posted  by  Sun  applications  begin
     with  the  company's  stock symbol, "SUNW". The publisher is
     usually the name of the application  generating  the  system
     event.  A  system event generated by devfsadm(1M) has a pub-
     lisher string of devfsadm.



SunOS 5.11          Last change: 24 Jul 2009                    1






System Event Library Functions     sysevent_post_event(3SYSEVENT)



     The publisher information is used by sysevent  consumers  to
     filter unwanted event publishers.


     Upon successful queuing of the system event, a unique  iden-
     tifier is assigned to eid.

RETURN VALUES
     The sysevent_post_event() function returns 0 if  the  system
     event  has  been queued successfully for delivery. Otherwise
     it returns -1 and sets errno to indicate the error.

ERRORS
     The sysevent_post_event() function will fail if:

     ENOMEM    Insufficient resources to queue the system event.


     EIO       The syseventd daemon is not responding and  events
               cannot be queued or delivered at this time.


     EINVAL    Invalid argument.


     EPERM     Permission denied.


     EFAULT    A copy error occurred.


EXAMPLES
     Example 1 Post a system event event with no attributes.


     The following example posts a system  event  event  with  no
     attributes.


       if (sysevent_post_event(EC_PRIV, "ESC_MYSUBCLASS", "SUNW", argv[0],
           NULL), &eid == -1) {
               fprintf(stderr, "error logging system event\n");
       }


     Example 2 Post a  system  event  with  two  name-value  pair
     attributes.


     The following example posts a system event  event  with  two
     name-value pair attributes, an integer value and a string.




SunOS 5.11          Last change: 24 Jul 2009                    2






System Event Library Functions     sysevent_post_event(3SYSEVENT)



       nvlist_t        *attr_list;
       uint32_t        uint32_val = 0XFFFFFFFF;
       char            *string_val = "string value data";

       if (nvlist_alloc(&attr_list, 0, 0) == 0) {
               err = nvlist_add_uint32(attr_list, "uint32 data", uint32_val);
               if (err == 0)
                       err = nvlist_add_string(attr_list, "str data",
                           string_val);
               if (err == 0)
                       err = sysevent_post_event(EC_PRIV, "ESC_MYSUBCLASS",
                           "SUNW", argv[0], attr_list, &eid);
               if (err != 0)
                       fprintf(stderr, "error logging system event\n");
               nvlist_free(attr_list);
       }


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     devfsadm(1M),  syseventd(1M),   nvlist_add_boolean(3NVPAIR),
     nvlist_alloc(3NVPAIR), attributes(5)

NOTES
     The libsysevent interfaces do not work at all in  non-global
     zones.















SunOS 5.11          Last change: 24 Jul 2009                    3