netplan-dbus(8) - phpMan

netplan-dbus(8)                                                                   netplan-dbus(8)

NAME
       netplan-dbus - daemon to access netplan's functionality via a DBus API

SYNOPSIS
       netplan-dbus

DESCRIPTION
       netplan-dbus  is  a  DBus  daemon,  providing  io.netplan.Netplan  on the system bus.  The
       /io/netplan/Netplan object provides an io.netplan.Netplan interface, offering the  follow-
       ing methods:

       o Apply() -> b: calls netplan apply and returns a success or failure status.

       o Generate() -> b: calls netplan generate and returns a success or failure status.

       o Info()  ->  a(sv): returns a dict "Features -> as", containing an array of all available
         feature flags.

       o Config() -> o: prepares a new config object as /io/netplan/Netplan/config/<ID>, by copy-
         ing the current state from /{etc,run,lib}/netplan/*.yaml

       The /io/netplan/Netplan/config/<ID> objects provide a io.netplan.Netplan.Config interface,
       offering the following methods:

       o Get() -> s: calls netplan get  --root-dir=/run/netplan/config-ID  all  and  returns  the
         merged YAML config of the the given config object's state

       o Set(s:CONFIG_DELTA,  s:ORIGIN_HINT) -> b: calls netplan set --root-dir=/run/netplan/con-
         fig-ID --origin-hint=ORIGIN_HINT CONFIG_DELTA

         CONFIG_DELTA can be something like:  network.ethernets.eth0.dhcp4=true  and  ORIGIN_HINT
         can  be something like: 70-snapd (it will then write the config to 70-snapd.yaml).  Once
         Set() is called on a config object, all other current and future config objects are  be-
         ing  invalidated  and  cannot  Set() or Try()/Apply() anymore, due to this pending dirty
         state.  After the dirty config object is rejected via Cancel(), the other config objects
         are valid again.  If the dirty config object is accepted via Apply(), newly created con-
         fig objects will be valid, while the older states will stay invalid.

       o Try(u:TIMEOUT_SEC) -> b: replaces the main netplan configuration with  this  config  ob-
         ject's state and calls netplan try --timeout=TIMEOUT_SEC

       o Cancel()  ->  b:  rejects a currently running Try() attempt on this config object and/or
         discards the config object

       o Apply() -> b: replaces the main netplan configuration with this  config  object's  state
         and calls netplan apply

       For   information  about  the  Apply()/Try()/Get()/Set()  functionality,  see  netplan-ap-
       ply(8)/netplan-try(8)/netplan-get(8)/netplan-set(8) accordingly.  For details of the  con-
       figuration file format, see netplan(5).

SEE ALSO
       netplan(5), netplan-apply(8), netplan-try(8), netplan-get(8), netplan-set(8)

AUTHORS
       Lukas Mardian (<lukas.maerdian AT canonical.com>).

                                                                                  netplan-dbus(8)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2026-01-10 16:15 @216.73.216.127 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)