{
    "mode": "man",
    "parameter": "NETPLAN-DBUS",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/NETPLAN-DBUS/8/json",
    "generated": "2026-10-04T12:12:31Z",
    "synopsis": "",
    "sections": {
        "NAME": {
            "content": "netplan-dbus - daemon to access Netplan functionality via a D-Bus API\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "",
            "subsections": [
                {
                    "name": "netplan-dbus",
                    "content": ""
                }
            ]
        },
        "DESCRIPTION": {
            "content": "netplan-dbus is a D-Bus daemon, providing io.netplan.Netplan on the system bus.  The /io/net‐\nplan/Netplan object provides an io.netplan.Netplan interface, offering the following methods:\n\n• Apply() -> b: calls netplan apply and returns a success or failure status.\n\n• Generate() -> b: calls netplan generate and returns a success or failure status.\n\n• Info()  ->  a(sv): returns a dictionary \"Features -> as\", containing an array of all avail‐\nable feature flags.\n\n• Config() -> o: prepares a new configuration object as  /io/netplan/Netplan/config/<ID>,  by\ncopying the current state from /{etc,run,lib}/netplan/*.yaml.\n\nThe  /io/netplan/Netplan/config/<ID>  objects  provide a io.netplan.Netplan.Config interface,\noffering the following methods:\n\n• Get() -> s: calls netplan get --root-dir=/run/netplan/config-ID all and returns the  merged\nYAML configuration of the the given configuration object's state\n\n• Set(s:CONFIGDELTA,  s:ORIGINHINT) -> b: calls netplan set --root-dir=/run/netplan/config-\nID --origin-hint=ORIGINHINT CONFIGDELTA\n\nCONFIGDELTA can be something like: network.ethernets.eth0.dhcp4=true and  ORIGINHINT  can\nbe  something like: 70-snapd (it will then write the configuration to 70-snapd.yaml).  Once\nSet() is called on a configuration object, all other current and future  configuration  ob‐\njects  are being invalidated and cannot Set() or Try()/Apply() anymore, due to this pending\ndirty state.  After the dirty configuration object is rejected via Cancel(), the other con‐\nfiguration objects are valid again.  If the dirty configuration object is accepted via  Ap‐\nply(),  newly created configuration objects will be valid, while the older states will stay\ninvalid.\n\n• Try(u:TIMEOUTSEC) -> b: replaces the main Netplan configuration  with  this  configuration\nobject's state and calls netplan try --timeout=TIMEOUTSEC.\n\n• Cancel()  ->  b:  rejects  a  currently  running Try() attempt on this configuration object\nand/or discards the configuration object.\n\n• Apply() -> b: replaces the main Netplan  configuration  with  this  configuration  object's\nstate and calls netplan apply.\n\nFor  information about the Apply()/Try()/Get()/Set() functionality, see netplan-apply(8)/net‐\nplan-try(8)/netplan-get(8)/netplan-set(8) accordingly.  For details of the configuration file\nformat, see netplan(5).\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "netplan(5), netplan-apply(8), netplan-try(8), netplan-get(8), netplan-set(8)\n",
            "subsections": []
        },
        "AUTHORS": {
            "content": "Lukas Märdian (<lukas.maerdian@canonical.com>).\n\nNETPLAN-DBUS(8)",
            "subsections": []
        }
    },
    "summary": "netplan-dbus - daemon to access Netplan functionality via a D-Bus API",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "netplan",
            "section": "5",
            "url": "https://www.chedong.com/phpMan.php/man/netplan/5/json"
        },
        {
            "name": "netplan-apply",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/netplan-apply/8/json"
        },
        {
            "name": "netplan-try",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/netplan-try/8/json"
        },
        {
            "name": "netplan-get",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/netplan-get/8/json"
        },
        {
            "name": "netplan-set",
            "section": "8",
            "url": "https://www.chedong.com/phpMan.php/man/netplan-set/8/json"
        }
    ]
}