1. Introduction
   1.1. Project/Component Working Name:

	sysevent_evc_setpropnvl and sysevent_evc_getpropnvl

   1.2. Name of Document Author/Supplier:

	Gavin Maltby

   1.3. Date of This Document:

	06/18/2010

   1.5. Email Aliases:
    	1.5.1. Responsible Manager: gavin.gibson@oracle.com
    	1.5.2. Responsible Engineer: gavin.maltby@oracle.com

4. Technical Description:
   4.1. Details:

	Two additions are made to the Consolidation Private
	General Purpose Event Channels (GPEC) API:

	    int sysevent_evc_setpropnvl(evchan_t *, nvlist_t *);
	    int sysevent_evc_getpropnvl(evchan_t *, nvlist_t **);

	The sysevent_evc_setpropnvl interface allows anything that
	can bind to a channel (whether or not they were the original
	creator of the channel) to associate a "channel properties
	nvlist" with the channel.  The content and structure of the
	nvlist is unspecified - it is up to the users of the particular
	channel to decide that.

	The sysevent_evc_getpropnvl interface allows anything that
	can bind to a channel to retrieve any channel properties
	nvlist associated with that channel.

	One needs root privilege to be able to bind to a GPEC channel -
	GPEC is not least-privilege aware.  If/when it is made so aware,
	consideration should be given to a privilege that allows setting
	channel properties and perhaps one that allows reading such
	properties.

   4.5. Interfaces:

	New Exported Interface		Stability
	-------------------------------	------------
	sysevent_evc_setpropnvl		Consolidation Private
	sysevent_evc_getpropnvl		Consolidation Private

   4.6. Doc Impact:

	None

   6.5. ARC review type:

		Closed Approved Automatic

   6.6. ARC Exposure:

		open