usr.sbin/powerd/powerd.8

   1 .\" (c) Copyright 2010 by Matthew Dillon and Dima Ruban.  Permission to
   2 .\"    use and distribute based on the DragonFly copyright.
   3 .\"
   4 .Dd July 4, 2015
   5 .Dt POWERD 8
   6 .Os
   7 .Sh NAME
   8 .Nm powerd
   9 .Nd simple ACPI based CPU/power control
  10 .Sh SYNOPSIS
  11 .Nm
  12 .Op Fl detQ
  13 .Op Fl p Ar hysteresis
  14 .Op Fl u Ar trigger_up
  15 .Op Fl r Ar poll_time
  16 .Op Fl T Ar sample_time
  17 .Op Fl B Ar minimum_battery_life
  18 .Op Fl L Ar battery_life_linger
  19 .Op Fl P Ar battery_poll_interval
  20 .Sh DESCRIPTION
  21 The
  22 .Nm
  23 daemon monitors the CPU load and automatically adjusts the CPU
  24 frequency up or down.
  25 .Pp
  26 All CPUs will be set to their maximum frequency when the 1 second
  27 machine load exceeds 25% of one CPU.
  28 All CPUs will be set to their
  29 minimum frequency when the 10 second machine load drops below 12% of
  30 one CPU.
  31 .Pp
  32 The options are as follows:
  33 .Bl -tag -width ".Fl p Ar hysteresis"
  34 .It Fl d
  35 Debug option.
  36 Causes
  37 .Nm
  38 to not go to the background and prints some debug output to
  39 .Va stdout .
  40 .It Fl e
  41 Disable Intel Performance and Energy Bias Hint,
  42 even if it is available
  43 .It Fl p Ar hysteresis
  44 Percent of the upper limit to subtract as an hysteresis value to scale
  45 down to the min frequency.
  46 The default is 10 (meaning 10%).
  47 .It Fl t
  48 Turbo mode.
  49 Disables switching to turbo mode as maximum frequency completely.
  50 Switching to turbo mode as maximum frequency is enabled by default,
  51 if the CPU supports it.
  52 .It Fl u Ar trigger_up
  53 Per CPU load limit in percent to force maximum frequency.
  54 The default is 25 (meaning an instantanious load of 0.25 on a
  55 single cpu).  The load is calculated over 3 polls.
  56 It is suggested that this value not be made lower than
  57 around 7.
  58 .It Fl r Ar poll_time
  59 Polling time in seconds.  Default is 1.0.
  60 Setting this value lower will poll for load changes faster.
  61 For example, a workstation might want to use 0.2 or 0.4.
  62 .Nm can become unstable if you make this value too small.
  63 .It Fl T Ar sample_time
  64 Total sample interval in seconds.  Default is 8.0.
  65 This effects how quickly powerd ratchets down the frequency
  66 and cpus on an idle machine.  Longer times will ratchet down
  67 more slowly.
  68 For example, a workstation might want to use a value of 30.0.
  69 .It Fl B Ar minimum_battery_life
  70 If battery life is less than or equal to the specified value,
  71 the machine will start shutting down process.
  72 Default is 2 (2% battery life left).
  73 .It Fl L Ar battery_life_linger
  74 If battery life is less than or equal to the configured value,
  75 shutting down the machine will be delayed by the specified value.
  76 During the delay,
  77 alert message will be logged to the console,
  78 and audio alert will be alarmed.
  79 If AC line is plugged in during this delay,
  80 shutting down process will be cancelled.
  81 Default is 60 seconds.
  82 .It Fl P Ar battery_poll_interval
  83 Poll the battery life at the specified interval.
  84 If 0 is specified,
  85 battery life monitoring will be disabled.
  86 Default is 5 seconds.
  87 .It Fl Q
  88 Don't alarm audio alert,
  89 if the battery life is low.
  90 .El
  91 .Sh EXAMPLES
  92 The defaults work well for servers but a workstation user might want
  93 to use something like the following in their
  94 .Pa /etc/rc.conf
  95 to ratchet up the machine more quickly in response to spike loads
  96 (such as when you are browsing).
  97 .Pp
  98 .Li powerd_enable="YES"
  99 .Pp
 100 .Li powerd_flags="-u 7 -r 0.2 -T 60"
 101 .Sh DIAGNOSTICS
 102 The
 103 .Nm
 104 utility will exit with a non-zero code if the required sysctls are not
 105 present.
 106 .Sh SEE ALSO
 107 .Xr acpi 4 ,
 108 .Xr perfbias 4
 109 .Sh HISTORY
 110 The
 111 .Nm
 112 command first appeared in
 113 .Dx 2.7 .
 114 .Sh BUGS
 115 I'm shocked I tell you, shocked that there might be bugs in this program!