DNS
The behaviors that dns calls, and each call that its examples make.
osapi behavior chain get --name dns shows the same.
Chain
| Behavior | dns |
| Chain | dns → netplan → managedfile |
| Calls | netplan |
| Used by | none |
Set the servers of an interface (update)
| CALL | SENDS | GETS |
|---|---|---|
| dns update | interface_name=eth0 servers=[9.9.9.9] | changed=true interface_name=eth0 |
| └─ netplan get | name=eth0 | id=eth0 matches=[eth0] name=eth0 section=ethernets type=ethernet |
| └─ netplan update | content=<9 lines> metadata={"domain":"dns","interface":"eth0"} path=/… | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
| · └─ managedfile update | content=<9 lines> metadata={"domain":"dns","interface":"eth0"} mode=0… | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
Set the search domains, and keep the servers (update)
| CALL | SENDS | GETS |
|---|---|---|
| dns update | interface_name=eth0 override_dhcp=true search_domains=[corp.example] | changed=true interface_name=eth0 |
| └─ netplan get | name=eth0 | id=eth0 matches=[eth0] name=eth0 section=ethernets type=ethernet |
| └─ netplan update | content=<14 lines> metadata={"domain":"dns","interface":"eth0"} path=… | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
| · └─ managedfile update | content=<14 lines> metadata={"domain":"dns","interface":"eth0"} mode=… | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
An interface with no resolvers yet (update)
| CALL | SENDS | GETS |
|---|---|---|
| dns update | interface_name=eth0 servers=[9.9.9.9] | changed=true interface_name=eth0 |
| └─ netplan get | name=eth0 | id=eth0 matches=[eth0] name=eth0 section=ethernets type=ethernet |
| └─ netplan update | content=<7 lines> metadata={"domain":"dns","interface":"eth0"} path=/… | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
| · └─ managedfile update | content=<7 lines> metadata={"domain":"dns","interface":"eth0"} mode=0… | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
An interface osapi set (delete)
| CALL | SENDS | GETS |
|---|---|---|
| dns delete | interface_name=eth0 | changed=true interface_name=eth0 |
| └─ netplan delete | path=/etc/netplan/osapi-dns-eth0.yaml | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
| · └─ managedfile delete | path=/etc/netplan/osapi-dns-eth0.yaml | changed=true path=/etc/netplan/osapi-dns-eth0.yaml |
An interface osapi set nothing on (delete)
| CALL | SENDS | GETS |
|---|---|---|
| dns delete | interface_name=eth0 | changed=false interface_name=eth0 |
| └─ netplan delete | path=/etc/netplan/osapi-dns-eth0.yaml | changed=false path=/etc/netplan/osapi-dns-eth0.yaml |
| · └─ managedfile delete | path=/etc/netplan/osapi-dns-eth0.yaml | changed=false path=/etc/netplan/osapi-dns-eth0.yaml |