From 0fb6a466f8fd7a292bb840245da1c13ea1cbe836 Mon Sep 17 00:00:00 2001 From: "A. Wilcox" Date: Fri, 20 Nov 2020 10:54:27 -0600 Subject: NMSA: Add ability to read 'live' values This allows us to have a true picture of the system for the operational datastore, separate from the config datastore. --- doc/network.rst | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/network.rst b/doc/network.rst index 37c67b7..7291249 100644 --- a/doc/network.rst +++ b/doc/network.rst @@ -179,7 +179,7 @@ Parameters ---------- For manipulating parameters in the section `Data model definition`_, -three methods exist. +four methods exist. ``get_param(iface, parameter)`` @@ -189,6 +189,16 @@ Retrieve the parameter for the specified interface. If the parameter is not set for the specified interface, ``None`` will be returned. +``curr_param(iface, parameter)`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Retrieve the current, live value for the parameter for the specified +interface. If the parameter is not set for the specified interface, +``None`` will be returned. The value returned from ``curr_param`` may +differ from ``get_param`` if a network administrator has changed the +value externally, or if the system configuration store is malfunctioning. + + ``set_param(iface, parameter, value)`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- cgit v1.2.3-70-g09d2