.\" Copyright (c) 2000 Stephan Leemburg .\" .\" This program is free software; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" .TH PMUD 8 "January 23, 2015" .\" $Log: pmud.8,v $ .\" Revision 1.1.1.1 2001/12/07 11:31:44 sleemburg .\" Initial CVS import of the unreleased pmud-0.8 to apmud (new project name .\" because of a name clash at sourceforge.net). .\" .\" Revision 1.5 2000/10/09 14:17:02 stephan .\" mention defaults for -l and -m flags, explain /etc/power/levels .\" .\" Revision 1.4 2000/03/09 12:57:36 stephan .\" modified for pmud-0.4 .\" .\" Revision 1.3 2000/01/06 23:04:53 stephan .\" corrected some errors .\" .\" Revision 1.2 2000/01/06 22:52:31 stephan .\" changed -l and -m argument from minutes to seconds .\" .\" Revision 1.1 2000/01/06 13:48:19 stephan .\" Initial revision .\" .\" .Dd Februari 10, 2000 .Dt PMUD 8 .Os "LinuxPPC pmud" .Sh NAME .Nm pmud .Nd constantly checks the Powermanagement unit to see if there is enough power left to continue. .Sh SYNOPSIS .Nm pmud .Op Fl BdhsvkK .Op Fl f Ar facility .Op Fl l Ar seconds .Op Fl m Ar seconds .Op Fl p Ar port .Sh DESCRIPTION .Nm 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 .Nm init(8). It also detects if the lid is closed, after which the machine is put to sleep. The options are as follows: .Bl -tag -width Ds .It Fl B Do not beep when going to sleep or waking up. .It Fl d Enable debugging; this disables pmud of backgrounding. .It Fl f Ar facility Use .Ar facility for .Nm syslogd(8) messages. .It Fl h Print a help message. .It Fl k Do not put machine to sleep when the lid closes, but do power off the screen. .It Fl K As with -k but put the machine to sleep if running on batteries. .It Fl l Ar seconds the numbers .Ar 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 .Nm init(8). The default is 420 seconds. .It Fl m Ar seconds The number of .Ar seconds a . Dq critical low power level has to endure in order to start sleeping or initiating a powerfail signal. The default is 15 seconds. .It Fl n Do not detach. Whit this option the daemon will not become a background process. .It Fl o Do not save/restore backlight settings when sleeping (use for offb displays). .It Fl p Ar port Specifies the .Ar port on which .Nm pmud will listen to .Tn TCP/IP requests. This is used by .Nm Batmon. .Nm Pmud will only listen to requestes on the .Tn localhost address. .It Fl v Print the current RCS version Id of .Nm Pmud .It Fl V Ar voltage Use .Nm 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. .El .Sh POWERSIGNALS When .Nm pmud is instructed to issue a powerfail signal to .Nm init(8) it will assume that .Nm init(8) has been correctly set up for powerfail and powerokwait signals. When the powerlevel drops beneath the treshold, .Nm pmud will write the file \fB/etc/powerstatus\fP and send .Tn SIGPWR to .Nm init(8). If power is restored (The AC Adapter is connected to mains) the file \fB/etc/powerstatus\fP is written again and onother .Tn SIGPWR is send to .Nm 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. .Sh CHANGE OF INPUT SOURCE .Nm 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 - .Nm pmud will run the script \fB/etc/power/pwrctl\fP. 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 .Nm hdparm(8). You can put local commands - like restoring trackpad settings after a sleep - in \fB/etc/power/pwrctl-local\fP. The arguments to .Nm pwrctl are passed through to .Nm pwrctl-local. This script is not distributed with the pmud-package and will therefore never be overwritten on upgrades. .Sh POWER POLICY On startup .Nm pmud will read the file \fB/etc/power/levels\fP. 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. .Sh BUGS AND CHANGE REQUESTS Please email your bug reports or change requests to \fB\fP. .Sh FILES .nf /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 .fi .Sh AUTHORS initial pmud package by Paul Mackerras and initial manual and changes to pmud-0.[34] by Stephan Leemburg . .Sh SEE ALSO .Xr init(8), .Xr hdparm(8), .Xr snooze(8) .Xr /usr/share/doc/pmud*/*