syseventd(1m) [opensolaris man page]

syseventd(1M)						  System Administration Commands					     syseventd(1M)

NAME

       syseventd - kernel system event notification daemon

SYNOPSIS

       /usr/lib/sysevent/syseventd [-d debug_level] [-r rootdir]

DESCRIPTION

       syseventd  is a user-level daemon that accepts delivery of system event buffers from the kernel. Once an event buffer has been delivered to
       syseventd, it, in turn, attempts to propagate the event to all interested end event subscribers.

       Event subscribers take the form of a syseventd loadable module (SLM). syseventd passes the event buffer to each of its subscribers  and	in
       return expects a notification as to the successful or unsuccessful delivery attempt.

       Upon  successful  delivery  of the event buffer to all interested event subscribers, syseventd frees the event buffer from the kernel event
       queue.

OPTIONS

       The following options are supported:

       -d debug_level	 Enable debug mode. Messages are printed to the invoking user's terminal.

       -r rootdir	 Cause syseventd to use an alternate root path when creating its door and lock files. Modules continue to be  loaded  from
			 the standard module directories.

EXIT STATUS

       The following exit values are returned:

       0	   Successful completion.

       non-zero    An error occurred.

FILES

       /etc/sysevent/syseventd_daemon.lock

	   daemon lock file

       /etc/sysevent/sysevent_door

	   kernel to syseventd door file

       /usr/lib/sysevent/modules

	   SLM directory repository

       /usr/platform/`uname --i`/lib/sysevent/modules

	   SLM directory repository

       /usr/platform/`uname --m`/lib/sysevent/modules

	   SLM directory repository

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       svcs(1), svcadm(1M), syseventconfd(1M), attributes(5), smf(5)

NOTES

       The syseventd service is managed by the service management facility, smf(5), under the service identifier:

	 svc:/system/sysevent:default

       Administrative  actions	on  this  service, such as enabling, disabling, or requesting restart, can be performed using svcadm(1M). The ser-
       vice's status can be queried using the svcs(1) command.

SunOS 5.11							    6 Aug 2004							     syseventd(1M)

sysevent_bind_handle(3SYSEVENT) 			  System Event Library Functions			   sysevent_bind_handle(3SYSEVENT)

NAME

       sysevent_bind_handle, sysevent_unbind_handle - bind or unbind subscriber handle

SYNOPSIS

       cc [flag...]  file ... -lsysevent [library ...]
       #include <libsysevent.h>

       sysevent_handle_t *sysevent_bind_handle(void (*event_handler)
	    (sysevent_t *ev));

       void sysevent_unbind_handle(sysevent_handle_t *sysevent_hdl);

PARAMETERS

       ev		pointer to sysevent buffer handle

       event_handler	pointer to an event handling function

       sysevent_hdl	pointer to a sysevent subscriber handle

DESCRIPTION

       The sysevent_bind_handle() function allocates memory associated with a subscription handle and binds it to the caller's event_handler.  The
       event_handler  is  invoked  during  subsequent  system  event  notifications  once  a  subscription  has  been  made   with   sysevent_sub-
       scribe_event(3SYSEVENT).

       The system event is represented by the argument ev and is passed as an argument to the invoked event delivery function, event_handler.

       Additional threads are created to service communication between syseventd(1M) and the calling process and to run the event handler routine,
       event_handler.

       The sysevent_unbind_handle() function deallocates memory and other resources associated with a subscription handle and deactivates all sys-
       tem event notifications for the calling process.  All event notifications are guaranteed to stop upon return from sysevent_unbind_handle().

RETURN VALUES

       The sysevent_bind_handle() function returns a valid sysevent subscriber handle if the handle is successfully allocated.	Otherwise, NULL is
       returned and errno is set to indicate the error.

       The sysevent_unbind_handle() function returns no value.

ERRORS

       The sysevent_bind_handle() function will fail if:

       EACCES	 The calling process has an ID other than the privileged user.

       EBUSY	 There are no resources available.

       EINVAL	 The pointer to the function event_handler is NULL.

       EMFILE	 The process has too many open descriptors.

       ENOMEM	 There are insufficient resources to allocate the handle.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       syseventd(1M), sysevent_subscribe_event(3SYSEVENT), attributes(5)

NOTES

       Event notifications are revoked by syseventd when the bound process dies.  Event notification is suspended if a signal is caught  and  han-
       dled  by  the  event_handler  thread.   Event  notification is also suspended when the calling process attempts to use fork(2) or fork1(2).
       Event notifications might be lost during suspension periods.

SunOS 5.11							    12 Nov 2001 				   sysevent_bind_handle(3SYSEVENT)