2012-08-12 21:39:31 +00:00
|
|
|
MACOSX-UPS(8)
|
|
|
|
|
=============
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
2022-06-29 10:37:36 +00:00
|
|
|
|
2012-08-12 21:39:31 +00:00
|
|
|
macosx-ups - monitor for Mac OS X built-in UPS and battery driver
|
|
|
|
|
|
|
|
|
|
NOTE
|
|
|
|
|
----
|
2022-06-29 10:37:36 +00:00
|
|
|
|
2012-08-12 21:39:31 +00:00
|
|
|
This man page only documents the hardware-specific features of the
|
|
|
|
|
*macosx-ups* driver. For information about the core driver, see
|
|
|
|
|
linkman:nutupsdrv[8].
|
|
|
|
|
|
|
|
|
|
SUPPORTED HARDWARE
|
|
|
|
|
------------------
|
2022-06-29 10:37:36 +00:00
|
|
|
|
2012-08-12 21:39:31 +00:00
|
|
|
*macosx-ups* supports any USB HID Power Device Class (PDC) UPS which is
|
|
|
|
|
matched by the Mac OS X built-in drivers. It also can monitor a laptop
|
|
|
|
|
internal battery as though it were an UPS.
|
|
|
|
|
|
|
|
|
|
If the UPS is visible in the Energy Saver preferences pane of System
|
|
|
|
|
Preferences, this driver should be able to monitor it.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EXTRA ARGUMENTS
|
|
|
|
|
----------------
|
2022-06-29 10:37:36 +00:00
|
|
|
|
2016-07-18 00:11:41 +00:00
|
|
|
*port*=auto::
|
|
|
|
|
Due to changes in the way that Mac OS X lists power sources, the *port*
|
2022-06-29 10:37:36 +00:00
|
|
|
parameter no longer has any effect. The rest of NUT still requires a value here,
|
2016-07-18 00:11:41 +00:00
|
|
|
and our traditional "don't care" value is `auto`.
|
2012-08-12 21:39:31 +00:00
|
|
|
|
|
|
|
|
*model*='regex'::
|
|
|
|
|
Likewise, if you have more than one UPS, it may be necessary to specify a
|
|
|
|
|
*model* name to match against. This parameter is also a case-insensitive
|
|
|
|
|
extended regular expression.
|
|
|
|
|
|
|
|
|
|
DIAGNOSTICS
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
If the driver cannot find an UPS, first open System Preferences and see if
|
|
|
|
|
there is an "UPS" tab on the Energy Saver panel. If so, re-run the driver with
|
|
|
|
|
the *-D* flag to list the names of the power sources found.
|
|
|
|
|
|
|
|
|
|
KNOWN ISSUES AND BUGS
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
This driver is a monitoring-only driver, and cannot shut down an UPS on its
|
|
|
|
|
own. However, this should not be a problem in practice: it is monitoring the
|
|
|
|
|
built-in Mac OS X UPS driver, which has configuration options for several
|
|
|
|
|
shutdown scenarios. Consult the Energy Saver control panel or *pmset*(8) for
|
|
|
|
|
more information.
|
|
|
|
|
|
|
|
|
|
The default distribution of *apcupsd* installs a kernel extension which
|
|
|
|
|
prevents Mac OS X from attaching to the UPS. In order to use this driver after
|
|
|
|
|
installing apcupsd, you must first run the `apcupsd-uninstall` script and
|
|
|
|
|
reboot.
|
|
|
|
|
|
|
|
|
|
Note that other UPS monitoring solutions may show more detail than what is
|
|
|
|
|
provided by the built-in Mac OS X driver. In particular, voltages other than
|
|
|
|
|
the battery voltage, as well as current and frequency, are typically not
|
|
|
|
|
shown. It may be possible to monitor these values with *apcupsd* (for APC
|
|
|
|
|
hardware only) or linkman:usbhid-ups[8].
|
|
|
|
|
|
2022-06-29 10:37:36 +00:00
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
|
2012-08-12 21:39:31 +00:00
|
|
|
Charles Lepple <clepple+nut at gmail.com>
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
linkman:usbhid-ups[8], *pmset*(8), *regex*(3)
|
|
|
|
|
|
|
|
|
|
The core driver:
|
|
|
|
|
~~~~~~~~~~~~~~~~
|
2022-06-29 10:37:36 +00:00
|
|
|
|
2012-08-12 21:39:31 +00:00
|
|
|
linkman:nutupsdrv[8]
|
|
|
|
|
|
|
|
|
|
Internet resources:
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
2022-06-29 10:37:36 +00:00
|
|
|
* The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
|
|
|
|
|
* The apcupsd home page: http://www.apcupsd.org/
|
