Skip to content

Commit

Permalink
UPGRADING.adoc: revise envvars that tweak specific message verbosity
Browse files Browse the repository at this point in the history
Signed-off-by: Jim Klimov <[email protected]>
  • Loading branch information
jimklimov committed Oct 29, 2023
1 parent c8a4150 commit 4a70dbc
Showing 1 changed file with 20 additions and 4 deletions.
24 changes: 20 additions & 4 deletions UPGRADING.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -128,10 +128,26 @@ Changes from 2.8.0 to 2.8.1
and exposed in `libnutscan.so` builds in particular - API version for the
public library was bumped [#317]
- A `NUT_DEBUG_PID` envvar (presence) support was added to add current
process ID to tags with debug-level identifiers. This may be useful
when many NUT daemons write to the same console or log file, such as
in containers/plugins for Home Assistant, storage appliances, etc. [#2118]
- Some 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:
* A `NUT_DEBUG_LEVEL=NUM` envvar allows to temporarily boost debugging
of many daemons (`upsd`, `upsmon`, drivers, `upsdrvctl`, `upssched`)
without changes to configuration files or scripted command lines. [#1915]
* A `NUT_DEBUG_PID` envvar (presence) support was added to add current
process ID to tags with debug-level identifiers. This may be useful
when many NUT daemons write to the same console or log file, such as
in containers/plugins for Home Assistant, storage appliances, etc. [#2118]
* A `NUT_QUIET_INIT_SSL` envvar (presence or "true" value) prevents
`libupsclient` consumers (notoriously `upsc`) from reporting whether
they have initialized SSL support. [#1662]
* A `NUT_QUIET_INIT_UPSNOTIFY` envvar (presence or "true" value)
prevents daemons which can notify service management frameworks (such
as systemd) about passing their lifecycle milestones, to not report
loudly if they could not do so (e.g. running on a system without a
framework, or misconfigured so they could not report and the OS would
restart the false-positively "unresponsive" service). [#2136]
- `configure` script, reference init-script and packaging templates updated
to eradicate `@PIDPATH@/nut` ambiguity in favor of `@ALTPIDPATH@` for the
Expand Down

0 comments on commit 4a70dbc

Please sign in to comment.