Unix/Linux Go Back    


NetBSD 6.1.5 - man page for sysmon_pswitch_register (netbsd section 9)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


SYSMON_PSWITCH(9)		  BSD Kernel Developer's Manual 		SYSMON_PSWITCH(9)

NAME
     sysmon_pswitch -- framework for power switches

SYNOPSIS
     #include <dev/sysmon/sysmonvar.h>

     int
     sysmon_pswitch_register(struct sysmon_pswitch *smpsw);

     void
     sysmon_pswitch_unregister(struct sysmon_pswitch *smpsw);

     void
     sysmon_pswitch_event(struct sysmon_pswitch *smpsw, int event);

DESCRIPTION
     The machine-independent sysmon_pswitch provides a framework for power management.	The
     interface has been largely superceded by the pmf(9) framework, but sysmon_pswitch is still
     used to manage power switches as well as related mechanical adapters and buttons.	These are
     encapsulated in the following structure:

     struct sysmon_pswitch {
	     const char *smpsw_name;	     /* power switch name */
	     int smpsw_type;		     /* power switch type */

	     LIST_ENTRY(sysmon_pswitch) smpsw_list;
     };

     Unsurprisingly, smpsw_name specifies the name of the power switch and smpsw_type defines the
     type of it.  The following types are defined:

	   PSWITCH_TYPE_POWER
	   PSWITCH_TYPE_SLEEP
	   PSWITCH_TYPE_LID
	   PSWITCH_TYPE_RESET
	   PSWITCH_TYPE_ACADAPTER
	   PSWITCH_TYPE_HOTKEY

     If the type is PSWITCH_TYPE_HOTKEY, there are few predefined names that can be used for
     smpsw_name:

	   PSWITCH_HK_DISPLAY_CYCLE  display-cycle
	   PSWITCH_HK_LOCK_SCREEN    lock-screen
	   PSWITCH_HK_BATTERY_INFO   battery-info
	   PSWITCH_HK_EJECT_BUTTON   eject-button
	   PSWITCH_HK_ZOOM_BUTTON    zoom-button
	   PSWITCH_HK_VENDOR_BUTTON  vendor-button

     Once a power switch event has been proceeded, sysmon_pswitch will inform the user space
     powerd(8), which will possibly execute a script matching the type of the power switch.

FUNCTIONS
     After the sysmon_pswitch structure has been initialized, a new power switch device can be
     registered by using sysmon_pswitch_register().  The device can be detached from the frame-
     work by sysmon_pswitch_unregister().

     The sysmon_pswitch_event() is used to signal a new power switch event.  There are two possi-
     bilities for the value of event:

	   PSWITCH_EVENT_PRESSED     A button has been pressed, the lid has been closed, the AC
				     adapter is off, etc.

	   PSWITCH_EVENT_RELEASED    A button has been released, the lid is open, the AC adapter
				     is on, etc.

     The corresponding events in powerd(8) are pressed and released.

SEE ALSO
     powerd(8), pmf(9), sysmon_envsys(9), sysmon_taskq(9)

AUTHORS
     Jason R. Thorpe <thorpej@NetBSD.org>

BSD					 January 26, 2010				      BSD
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 11:24 PM.