# phpman > man > netplan-dbus(8)

[netplan-dbus(8)](https://www.chedong.com/phpMan.php/man/netplan-dbus/8/markdown)                                                                      [netplan-dbus(8)](https://www.chedong.com/phpMan.php/man/netplan-dbus/8/markdown)



## 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/net‐
       plan/Netplan object provides an io.netplan.Netplan interface, offering the following methods:

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

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

       • Info() -> a(sv): returns a dict "Features -> as", containing an array of all available fea‐
         ture flags.

       • Config()  -> o: prepares a new config object as /io/netplan/Netplan/config/<ID>, by copying
         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:

       • 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

       • Set(s:CONFIG_DELTA, s:ORIGIN_HINT) -> b: calls **netplan** **set**  **--root-dir=/run/netplan/config-**
         **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 being invali‐
         dated 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 config  objects  will  be
         valid, while the older states will stay invalid.

       • Try(u:TIMEOUT_SEC)  -> b: replaces the main netplan configuration with this config object's
         state and calls **netplan** **try** **--timeout=TIMEOUT**___**SEC**

       • Cancel() -> b: rejects a currently running Try() attempt on this config object and/or  dis‐
         cards the config object

       • 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-apply**(8)](https://www.chedong.com/phpMan.php/man/netplan-apply/8/markdown)/**net**‐‐
       [**plan-try**(8)](https://www.chedong.com/phpMan.php/man/plan-try/8/markdown)/[**netplan-get**(8)](https://www.chedong.com/phpMan.php/man/netplan-get/8/markdown)/[**netplan-set**(8)](https://www.chedong.com/phpMan.php/man/netplan-set/8/markdown) accordingly.  For details of the configuration file
       format, see [**netplan**(5)](https://www.chedong.com/phpMan.php/man/netplan/5/markdown).

## SEE ALSO
       [**netplan**(5)](https://www.chedong.com/phpMan.php/man/netplan/5/markdown), [**netplan-apply**(8)](https://www.chedong.com/phpMan.php/man/netplan-apply/8/markdown), [**netplan-try**(8)](https://www.chedong.com/phpMan.php/man/netplan-try/8/markdown), [**netplan-get**(8)](https://www.chedong.com/phpMan.php/man/netplan-get/8/markdown), [**netplan-set**(8)](https://www.chedong.com/phpMan.php/man/netplan-set/8/markdown)

## AUTHORS
       Lukas Märdian (<<lukas.maerdian@canonical.com>>).



                                                                                     [netplan-dbus(8)](https://www.chedong.com/phpMan.php/man/netplan-dbus/8/markdown)