VERSION_DEFAULT
file, so it can be used without git. Certain distros
can benefit from a VERSION_FORCED
file or a NUT_VERSION_FORCED
environment variable exported from their build system, e.g. via
echo NUT_VERSION_FORCED=1.1.1 > VERSION_FORCED
. Unfortunately, some
appliances tag all software the same with their firmware version;
if this is required, a (NUT_)VERSION_FORCED_SEMVER envvar or file can
help identify the actual NUT release version triplet used on the box.
Please use it, it immensely helps with community troubleshooting!
[issue #1949]
upsmon
should now integrate natively with systemd-driven OS sleep events
(built with systemd version 221 or newer "inhibitor interface"), so various
hacks previously packaged into /usr/lib/systemd/system-sleep/
scripts or
units requiring/conflicting with the sleep.target
may be obsolete.
For fallback with older systemd, a nut-sleep.service
is provided now.
[#1070, #2596, #2597]
ALARM
state was introduced to upsmon
, allowing it
to optionally treat it as a factor in deciding that the device is in a
"critical" state (polled more often, assumed dead if communications are
lost). Since it is up to devices and their NUT drivers what they would
raise as an alarm (might be something as mundane as ECO mode being active),
some alarms can contribute to unwanted/early shutdowns. For this reason
a 0|1
setting ALARMCRITICAL
was introduced into upsmon.conf
(default
is 1
), for such users to be able to prevent their upsmon
from treating
the ALARM
status as overly severe when it is not in fact. [#2658]
usbhid-ups
subdriver PowerCOM HID
subdriver sent UPS shutdown
and
stayoff
commands in wrong byte order, at least for devices currently
in the field. Driver now sends the commands in a way that satisfies new
devices; just in case a flag toggle powercom_sdcmd_byte_order_fallback
was added to set the old behavior (if some devices do need it). [PR #2480]
lbrb_log_delay_sec=N
setting to delay propagation of
LB
or LB+RB
state (buggy with APC BXnnnnMI devices/firmwares issued
circa 2023-2024 which flood the logs with spurious LOWBATT and REPLACEBATT
events). This may work better for some devices when combined with flags
like onlinedischarge_calibration
and lbrb_log_delay_without_calibrating
.
[#2347]
docdir
. It seems previously they were only
built (if requested) but not installed via make
, unlike the common man
pages which are delivered automatically. Packaging recipes can likely
be simplified now. [#2445]
NUT_DEBUG_SYSLOG
environment variable was introduced to tweak activation
of syslog message emission (and related detachment of stderr
when daemons
are backgrounding), which can be useful for systemd service units. It can be
set via nut.conf
file for all standard consumers, or patched/dropped-in to
systemd unit definitions specifically (less recommended, but may be easier
to package). The positive effect would be avoiding duplicate logging as both
syslog
and stderr
ending up in the same journal. [#2394]
CHANGELOG_REQUIRE_GROUP_BY_DATE_AUTHOR
setting was added (for make
calls and used by tools/gitlog2changelog.py.in
script), and it defaults
to true
allowing for better ordered documents at the cost of some memory
during document generation. Resource-constrained builders (working from
a Git workspace, not tarball archives) may have to set it to false
when
calling make
for NUT. [#2510]
nut-scanner
, which dynamically load shared libraries
at run-time without persistent pre-linking, should now know the library
file names that were present during build (likely encumbered with version
suffixes), and prefer them over plain libname.so
patterns used previously
(which on some platforms are only delivered by development packages as
symlinks). Packaging recipes can likely be simplified now: some distros
certainly did patch NUT source to similar effect). [#2431]
nut-scanner
and symbols that its libnutscan.so
delivers have caused a library version bump. New methods have been added
and one structure (nutscan_ipmi_t
) updated in a (hopefully) backwards
compatible manner. [PR #2523, issue #2244 and numerous PRs for it]
sendsignalpid()
and sendsignalfn()
methods,
which can impact NUT forks which build using libcommon.la
and similar
libraries. Added new last argument with const char *progname
(may be
NULL
) to check that we are signalling an expected program name when we
work with a PID. With the same effort, NUT programs which deal with PID
files to send signals (upsd
, upsmon
, drivers and upsdrvctl
) would
now default to a safety precaution — checking that the running process
with that PID has the expected program name (on platforms where we can
determine one). This might introduce regressions for heavily customized
NUT builds (e.g. embedded in NAS or similar devices) whose binary file
names differ significantly from a progname
defined in the respective
NUT source file, so a boolean NUT_IGNORE_CHECKPROCNAME
environment
variable support was added to optionally disable this verification.
Also the NUT daemons should request to double-check against their
run-time process name (if it can be detected). [issue #2463]
More environment variable support was added to NUT programs, primarily
aimed at wrappers such as init scripts and service unit definitions,
allowing to tweak what (and whether) they write into debug traces, and
so "make noise" or "bring invaluable insights" to logs or terminal;
they can generally be used for services and init scripts via nut.conf
:
configure
script option to build --with-modbus+usb
was added to
let the caller insist on the use of USB-capable libmodbus (or fail the
NUT build attempt). Certain build arguments can default this option to
become enabled (implicitly): configure --with-modbus --with-usb
and
either --with-drivers=*apc_modbus*
(actually implies --with-modbus
)
or --with-modbus-includes=... --with-modbus-libs=...
as a way to avoid surprises with custom NUT builds aiming to have an
USB-capable apc_modbus
driver (currently this requires a custom-built
libmodbus, can be a static build to avoid conflicts with OS). [#2666]
configure
script option to --enable-NUT_STRARG-always
was added
to enable the NUT_STRARG
macro (to handle NULL
string printing)
even if system libraries seem to safely support this behavior natively.
This should primarily help against overly zealous static analysis tools
in recent compiler generations. [#2585]