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 dri-
     vers.

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 de-
     vice whose object path contains the string "ups_".

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

     lowbatt
	 The  battery percentage threshold below which the LB (Low Battery) sta-
	 tus 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.5.	   08/04/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