version 1 .

Interface = <interface
             @name string
             @index int
             @type InterfaceType
             @administrativeState AdministrativeState
             @operationalState OperationalState
             @carrier CarrierState
             @linkAddr string> .

# This is synthetic information, based on somewhat ad-hoc heuristics. It'd be nice if there was
# a better way to do this! Maybe someone can point me in the right direction!
#
InterfaceType =
/ # `lo` and friends
  =loopback
/ # `eth0`, bridges, anything that isn't loopback and isn't wireless
  =normal
/ # 'wlan0' and friends
  =wireless
.

AdministrativeState =
/ =unknown
/ =down
/ =up
.

OperationalState =
/ =unknown
/ =down
/ @lowerLayerDown =lower-layer-down
/ =testing
/ =dormant
/ =up
.

CarrierState =
/ @noCarrier =no-carrier
/ =carrier
.

Route = <route
         @addressFamily AddressFamily
         @destination RouteDestination
         @priority int
         @typeOfService int
         @interfaceName RouteInterface
         @gateway Gateway> .

AddressFamily =
/ =ipv4
/ =ipv6
/ @other int
.

RouteDestination =
/ =default
/ @prefix <prefix @net string @bits int>
.

RouteInterface =
/ @name string
/ @none #f
.

Gateway =
/ @addr string
/ @none #f
.

DefaultRoute = <default-route @addressFamily AddressFamily> .

AvailableAccessPoint = <available-ap @interfaceName string @ssid string> .
WifiAssociation = <wifi-association @interfaceName string @ssid string @state WifiAssociationState> .
WifiAssociationState = @inProgress =in-progress / =ready .

HotspotState = <hotspot-state @interfaceName string @ssid string @stationCount int> .

# ---------------------------------------------------------------------------
# User settings

MobileDataApn = <mobile-data-apn @apn string> .

MobileDataEnabled = <mobile-data-enabled> .

SavedWifiNetwork = <saved-wifi-network
                    @ssid string
                    @authentication WifiAuthentication
                    @priority double> .
WifiAuthentication =
/ # No authentication necessary: open network
  =open
/ # Pre-shared key (WPA2-PSK etc)
  <psk @password string>
/ # Other, not-yet-implemented
  @other any
.

SelectedWifiNetwork = <selected-wifi-network
                       @interfaceName string
                       @ssid string
                       @authentication WifiAuthentication> .

Hotspot = <hotspot
           @interfaceName string
           @ssid string
           @authentication WifiAuthentication> .