NAME¶

pmud — constantly checks the Powermanagement unit to see if there is enough power left to continue.

SYNOPSIS¶

pmud	[-BdhsvkK] [-f facility] [-l seconds] [-m seconds] [-p port]

DESCRIPTION¶

Pmud is a system daemon, which is usefull only for Apple Macintosh Powerbooks. It constantly checks the Powermanagement unit to see if there is enough power left to continue. If power runs short, it will put the machine to sleep or issue a powerfail signal to init(8). It also detects if the lid is closed, after which the machine is put to sleep. The options are as follows:

-B

Do not beep when going to sleep or waking up.

-d

Enable debugging; this disables pmud of backgrounding.

-f facility

Use facility for syslogd(8) messages.

-h

Print a help message.

-k

Do not put machine to sleep when the lid closes, but do power off the screen.

-K

As with -k but put the machine to sleep if running on batteries.

-l seconds

the numbers seconds of power left which is considered to be a critical low level. When this level is reached and if this state remains for a determined period of time, the system is put to sleep or a powerfail signal is issued to init(8). The default is 420 seconds.

-m seconds

The number of seconds a “critical low” power level has to endure in order to start sleeping or initiating a powerfail signal. The default is 15 seconds.

-n

Do not detach. Whit this option the daemon will not become a background process.

-o

Do not save/restore backlight settings when sleeping (use for offb displays).

-p port

Specifies the port on which pmud will listen to TCP/IP requests. This is used by Batmon. Pmud will only listen to requestes on the localhost address.

-v

Print the current RCS version Id of Pmud

-V voltage

Use voltage as critical low condition to drain a battery beyond a false time left treshold sometimes observed with aging batteries. Needs -l 0 to prevent early sleep or shutdown due to low time left.

POWERSIGNALS¶

When pmud is instructed to issue a powerfail signal to init(8) it will assume that init(8) has been correctly set up for powerfail and powerokwait signals. When the powerlevel drops beneath the treshold, pmud will write the file /etc/powerstatus and send SIGPWR to init(8). If power is restored (The AC Adapter is connected to mains) the file /etc/powerstatus is written again and onother SIGPWR is send to init(8) to indicate power has been restored. Before using this option, you should test your init-setup manually to verify if power-signal handling is correctly supported.

CHANGE OF INPUT SOURCE¶

Pmud will detect if the machine is running on battery or on the AC Adapter. It will also notice when this changes. When machine is running on battery and is switched to the AC Adapter - or vice versa - pmud will run the script /etc/power/pwrctl. This script will handle additional actions to be performed in order to gain maximum performance or minimal power consumption. The default script will only set hd spindown times, using hdparm(8). You can put local commands - like restoring trackpad settings after a sleep - in /etc/power/pwrctl-local. The arguments to pwrctl are passed through to pwrctl-local. This script is not distributed with the pmud-package and will therefore never be overwritten on upgrades.

POWER POLICY¶

On startup pmud will read the file /etc/power/levels. It initialises it's power policy with the values in this file. There are two numeric values in this file. The first value is the battery policy, the second value is the AC policy. Valid values are 1 (minimum power consumption), 2 (medium power consumption) and 3 (maximum power consumption). Obviously, minimum power consumption degrades the systems performance and vice versa.

BUGS AND CHANGE REQUESTS¶

Please email your bug reports or change requests to <pmud-bugs@jvc.nl>.

FILES¶

/dev/adb /dev/pmu /sbin/pmud /etc/power/pwrctl /etc/power/pwrctl-local /etc/power/levels /etc/powerstatus /etc/rc.d/init.d/pmud /etc/sysconfig/power

AUTHORS¶

initial pmud package by Paul Mackerras and initial manual and changes to pmud-0.[34] by Stephan Leemburg <stephan@jvc.nl>.

SEE ALSO¶

init(8), hdparm(8), snooze(8) /usr/share/doc/pmud*/*