Technical Reference: Base Operating System and Extensions, Volume 1

pm_control_parameter Subroutine

Purpose

Controls and queries Power Management parameters.

Library

Standard C Library (libc.a)

Syntax

#include <sys/pm.h>

int pm_control_parameter (control, argument) int control; caddr_t argument;

Description

The pm_control_parameter subroutine controls and queries Power Management parameters.

Parameters

control	Specifies one of the following Power Management (PM) control commands: PM_CTRL_QUERY_SYSTEM_IDLE_TIMER Queries system idle timer. PM_CTRL_SET_SYSTEM_IDLE_TIMER Sets system idle timer. PM_CTRL_QUERY_DEVICE_IDLE_TIMER Queries device idle timer. PM_CTRL_SET_DEVICE_IDLE_TIMER Sets device idle timer. PM_CTRL_QUERY_LID_CLOSE_ACTION Queries the LID close action. PM_CTRL_SET_LID_CLOSE_ACTION Sets the LID close action. PM_CTRL_QUERY_SYSTEM_IDLE_ACTION Queries the system idle action. PM_CTRL_SET_SYSTEM_IDLE_ACTION Sets the system idle action. PM_CTRL_QUERY_MAIN_SWITCH_ACTION Queries the main power switch action. PM_CTRL_SET_MAIN_SWITCH_ACTION Sets the main power switch action. PM_CTRL_QUERY_LOW_BATTERY_ACTION Queries the low battery action. PM_CTRL_SET_LOW_BATTERY_ACTION Sets the low battery action. PM_CTRL_QUERY_BEEP Queries whether beep is enabled or not. PM_CTRL_SET_BEEP Enables/disables beep. PM_CTRL_QUERY_PM_DD_NUMBER Queries the number of PM aware DDs. PM_CTRL_QUERY_PM_DD_LIST Returns an array of devno of PM aware DDs. PM_CTRL_QUERY_LID_STATE Queries the LID state.
argument	The value of the argument parameter depends on the Power Management control command.
	For the following Power Management commands, the argument parameter is a pointer to an integer in which result value is stored: PM_CTRL_QUERY_SYSTEM_IDLE_TIMER PM_CTRL_QUERY_LID_CLOSE_ACTION PM_CTRL_QUERY_SYSTEM_IDLE_ACTION PM_CTRL_QUERY_MAIN_SWITCH_ACTION PM_CTRL_QUERY_LOW_BATTERY_ACTION PM_CTRL_QUERY_BEEP PM_CTRL_QUERY_PM_DD_NUMBER PM_CTRL_QUERY_LID_STATE
	For the following Power Management commands, the argument parameter is an integer to be set. PM_CTRL_SET_SYSTEM_IDLE_TIMER PM_CTRL_SET_LID_CLOSE_ACTION PM_CTRL_SET_SYSTEM_IDLE_ACTION PM_CTRL_SET_MAIN_SWITCH_ACTION PM_CTRL_SET_LOW_BATTERY_ACTION PM_CTRL_SET_BEEP
	For the PM_CTRL_PM_QUERY_DEVICE_TIMER and PM_CTRL_SET_DEVICE_TIMER commands, the argument parameter is a pointer to the following structure: struct pm_device_timer_struct { dev_t devno; /* device major/minor number / int mode; / device mode / int device_idle_time;/ if -1, don't care / int device_standby_time;/if -1, don't care */ }
	For the PM_CTRL_QUERY_PM_DD_LIST command, the argument parameter specifies a pointer to an array of integers.

Return Values

PM_SUCCESS	Indicates successful completion.
PM_ERROR	Indicates an error condition. The variable errno is set to identify the error.

Error Codes

EINVAL

The argument or control is not valid.

Implementation Specifics

The pm_control_parameter subroutine is part of the Base Operating System (BOS) Runtime.

Related Information

The pm_control_state (pm_control_state Subroutine) subroutine, pm_event_query (pm_event_query Subroutine) subroutine, pm_battery_control (pm_battery_control Subroutine) subroutine.