Skip to main content

bb-eco template diff

Compare a device's current config against a template

Usage

bb-eco template diff <device> <file> [options]

Arguments

NameDescription
<device>IP address, MAC address, or device name
<file>Template file path (.json)

Options

OptionDescription
--csvOutput in CSV format
--jsonOutput in JSON format
--timeout <timeout>Override default timeout in milliseconds
--verboseEnable verbose/debug output
-?, -h, --helpShow help and usage information

Examples

Compare a device's live configuration against its saved template. A compliant device:

bb-eco template diff 192.168.2.97 es-522-baseline.json
Device is compliant — 32 field(s) match template.

When someone has changed a setting on the device (or the template has been updated), each differing field is listed:

Section  Key          Template     Actual                                Status
------- ----------- ----------- ------------------------------------ ------
device device.name Line3-ES522 Brainboxes ES-522 Ethernet to Serial DRIFT

DRIFTED: 1 field(s) differ, 31 match.

Fields set to null (or omitted) in the template mean "don't manage this setting" and are never reported as drift. To bring the device back in line, run template apply.

This page is auto-generated from the live CLI help text. Do not edit by hand - re-run node scripts/gen-cli-reference.mjs after changes. Example sections are maintained in docs/cli-examples/ in the bb-eco repo.