Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NUT-UPOWER(8)			  NUT Manual			 NUT-UPOWER(8)

NAME
       nut-upower - Driver for UPower devices via D-Bus

SYNOPSIS
       nut-upower -h

       nut-upower -a UPS_NAME [OPTIONS]

	   Note

	   This	man page only documents	the specific features of the
	   nut-upower driver. For information about the	core driver, see
	   nutupsdrv(8).

DESCRIPTION
       This driver allows the monitoring of power devices (UPS,	batteries)
       that are	managed	by the UPower daemon via the D-Bus system bus.

       It maps UPower properties (state, percentage, voltage, etc.) to
       standard	NUT variables, allowing	NUT clients to monitor devices that
       are natively supported by the OS	desktop	environment but	not directly
       by other	NUT drivers.

EXTRA ARGUMENTS
       This driver supports the	following optional settings in ups.conf(5):

       port
	   The UPower Object Path of the device	to monitor.

       If set to auto (the default), the driver	will scan for the first	UPower
       device whose object path	contains the string "ups_".

       If set to a specific path (e.g.,
       /org/freedesktop/UPower/devices/ups_hiddev0), the driver	will attempt
       to monitor that specific	device.

       lowbatt
	   The battery percentage threshold below which	the LB (Low Battery)
	   status flag is set. The default value is 20.0.

INSTALLATION
       To use this driver, add a section to your ups.conf:

	   [myups]
	       driver =	nut-upower
	       port = auto
	       lowbatt = 20
	       desc = "Laptop Battery or generic UPS via UPower"

REQUIREMENTS
       This driver requires the	upower daemon to be running and	accessible via
       the D-Bus system	bus. It	also requires GLib 2.0 and GIO libraries.

AUTHOR
       Tim Niemueller <tim@niemueller.de>

SEE ALSO
       ups.conf(5), nutupsdrv(8), upsc(8)

   Internet Resources:
       The NUT (Network	UPS Tools) home	page: https://www.networkupstools.org/

Network	UPS Tools 2.8.4.	  06/12/2026			 NUT-UPOWER(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nut-upower&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help