workspace/solid/networkmanager-0.6/org.freedesktop.NetworkManager.xml.notes

   1 NM_DBUS_SERVICE "org.freedesktop.NetworkManager"
   2 NM_DBUS_PATH "/org/freedesktop/NetworkManager"
   3 NM_DBUS_INTERFACE "org.freedesktop.NetworkManager"
   4 NM_DBUS_PATH_DEVICES "/org/freedesktop/NetworkManager/Devices"
   5 NM_DBUS_INTERFACE_DEVICES "org.freedesktop.NetworkManager.Devices"
   6 NM_DBUS_PATH_DHCP "/org/freedesktop/NetworkManager/DhcpOptions"
   7 NM_DBUS_INTERFACE_DHCP "org.freedesktop.NetworkManager.DhcpOptions"
   8
   9 NMI_DBUS_SERVICE "org.freedesktop.NetworkManagerInfo"
  10 NMI_DBUS_PATH "/org/freedesktop/NetworkManagerInfo"
  11 NMI_DBUS_INTERFACE "org.freedesktop.NetworkManagerInfo"
  12
  13 ### DBus housekeeping stuff ###
  14 msg, DBUS_INTERFACE_LOCAL, "Disconnected"
  15 DBUS_INTERFACE_DBUS, "NameOwnerChanged" s service s oldowner s newowner // dbus restarted
  16 DBUS_INTERFACE_DBUS, "NameAcquired" // probably tells us that we got the NetworkManagerInfo name for ourselves, see NetworkManagerInfoDBus::requestName
  17
  18 ### General ###
  19 ## getters ##
  20 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "state" returns uint32 state
  21 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE_DEVICES, "getDevices" returns returns NM_DBUS_NO_DEVICES_ERROR or aop objpath i num_devices
  22 NM_DBUS_SERVICE, net_path, NM_DBUS_INTERFACE_DEVICES, "getProperties" return Network struct, see DeviceStoreDBus::updateNetworkCallback
  23 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "getWirelessEnabled" returns bool
  24 ## setters ##
  25 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "setActiveDevice op objpath // used for wired interfaces
  26 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "setActiveDevice op objpath s essid b fallback THEN [encoding]
  27 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "setWirelessEnabled" boolean returns ?
  28 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "sleep"
  29 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "wake"
  30 # Device
  31 NM_DBUS_SERVICE, obj_path, NM_DBUS_INTERFACE_DEVICES, "getProperties" returns Device struct, see DeviceStoreDBus::updateDeviceCallback
  32 getName returns s interfacename
  33 getType returns int32 type
  34 getHalUdi returns s udi
  35 getIP4Address returns uint32 ip_address
  36 getHWAddress returns s hwaddr
  37 getMode returns int32 mode
  38 getActiveNetwork returns o net_path, or Error DeviceNotWireless or Error NoActiveNetwork
  39 getNetworks returns ao or error NoNetworks or Error DeviceNotWireless
  40 getLinkActive returns bool
  41 setLinkActive bool // only usable on fake, test devices, returns NotTestDevice error otherwise
  42 getCapabilities returns uint capabilities
  43 getDriver returns s drivername
  44
  45 ## signals ##
  46 NM_DBUS_INTERFACE, NM_DBUS_SIGNAL_STATE_CHANGE uint32 state
  47
  48 # Device
  49 DeviceStrengthChanged (o obj_path, int32 strength)
  50
  51 DeviceCarrierOn dev_path
  52 DeviceCarrierOff dev_path
  53 DeviceAdded dev_path
  54 NM_DBUS_INTERFACE, "DeviceRemoved" op obj_path
  55 DeviceNoLongerActive o dev_path
  56 DeviceNowActive o dev_path
  57 DeviceActivating o dev_path
  58 DeviceActivationFailed o dev_path, + s essid if wireless FUCKERS
  59
  60 NM_DBUS_INTERFACE, "WirelessNetworkAppeared" op obj_path op net_path
  61 NM_DBUS_INTERFACE, "WirelessNetworkDisappeared"  op obj_path op net_path
  62 NM_DBUS_INTERFACE, "WirelessNetworkStrengthChanged" op obj_path op net_path int32 strength
  63 NM_DBUS_INTERFACE, "DeviceActivationStage" op obj_path uint32 stage
  64     NM_ACT_STAGE_UNKNOWN = 0,
  65         NM_ACT_STAGE_DEVICE_PREPARE,
  66         NM_ACT_STAGE_DEVICE_CONFIG,
  67         NM_ACT_STAGE_NEED_USER_KEY,
  68         NM_ACT_STAGE_IP_CONFIG_START,
  69         NM_ACT_STAGE_IP_CONFIG_GET,
  70         NM_ACT_STAGE_IP_CONFIG_COMMIT,
  71         NM_ACT_STAGE_ACTIVATED,
  72         NM_ACT_STAGE_FAILED,
  73         NM_ACT_STAGE_CANCELLED
  74
  75 // after DeviceActivationFailed, need to update device and possibly network to get the right activation stage.
  76
  77
  78 ### Dialup ###
  79 ## getters ##
  80 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE_DEVICES, "getDialup" returns NM_DBUS_NO_DIALUP_ERROR or as dialups i num_dialups
  81 ## setters ##
  82 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "activateDialup s dialupname
  83 NM_DBUS_SERVICE, NM_DBUS_PATH, NM_DBUS_INTERFACE, "deactivateDialup s dialupname
  84
  85 ### VPN ###
  86 ## getters ##
  87 NM_DBUS_SERVICE, NM_DBUS_PATH_VPN, NM_DBUS_INTERFACE_VPN, "getVPNConnectionProperties" s name returns vpn struct, [s name, s user, s service_name, uint32 stage]
  88 ## setters ##
  89 NM_DBUS_SERVICE, NM_DBUS_PATH_VPN, NM_DBUS_INTERFACE_VPN, "activateVPNConnection" s name, as passwords
  90 NM_DBUS_SERVICE, NM_DBUS_PATH_VPN, NM_DBUS_INTERFACE_VPN, "deactivateVPNConnection"
  91 ## signals ##
  92 NM_DBUS_INTERFACE_VPN, "VPNConnectionAdded" s name
  93 NM_DBUS_INTERFACE_VPN, "VPNConnectionUpdate" s name
  94 NM_DBUS_INTERFACE_VPN, "VPNConnectionStateChange" s name uint32 stage
  95 NM_DBUS_INTERFACE_VPN, NM_DBUS_VPN_SIGNAL_LOGIN_FAILED s name s errormsg
  96 NM_DBUS_INTERFACE_VPN, NM_DBUS_VPN_SIGNAL_LAUNCH_FAILED s name s errormsg
  97 NM_DBUS_INTERFACE_VPN, NM_DBUS_VPN_SIGNAL_CONNECT_FAILED s name s errormsg
  98 NM_DBUS_INTERFACE_VPN, NM_DBUS_VPN_SIGNAL_VPN_CONFIG_BAD s name s errormsg
  99 NM_DBUS_INTERFACE_VPN, NM_DBUS_VPN_SIGNAL_IP_CONFIG_BAD s name s errormsg
 100
 101 ### NetworkManagerInfo ###
 102 signals:
 103 NMI_DBUS_PATH, NMI_DBUS_INTERFACE, "VPNConnectionUpdate"
 104 NMI_DBUS_PATH, NMI_DBUS_INTERFACE, "UserInterfaceActivated" // we emit this signal and NM does what?
 105
 106 // probably this sets up the NMI object
 107 ·   if (dbus_connection_register_object_path (_dbus_connection, NMI_DBUS_PATH, &vtable, _ctx)) {
 108
 109 slots on NMInfo object
 110 getKeyForNetwork op dev_path op net_path s essid i attempt b new_key, returns[encoding] or .GetKeyError
 111 cancelGetKeyForNetwork
 112 getNetworks void, returns as essids
 113 getNetworkProperties s essid, returns s essid, int32 timestamp b trusted, as hwaddrs, [encryption]
 114 R .NoNetworks
 115 updateNetworkInfo s essid b automatic s bssid int32 we_cipher // what's this method do again? no reply.
 116 getVPNConnections void, returns as name or NM_DBUS_NO_VPN_CONNECTIONS
 117 getVPNConnectionProperties s name returns s name s service s user OR NM_DBUS_INVALID_VPN_CONNECTION
 118 getVPNConnectionVPNData s name, returns as data OR NM_DBUS_INVALID_VPN_CONNECTION
 119 getVPNConnectionRoutes s name, returns as routes OR NM_DBUS_INVALID_VPN_CONNECTION
 120
 121 ### Security ###
 122 FIRST
 123 int32 cipher {
 124 IW_AUTH_CIPHER_WEP40:
 125 IW_AUTH_CIPHER_WEP104:
 126 {
 127   //also cipher dependent?
 128   s key
 129   int32 authentication algorithm => {IW_AUTH_ALG_OPEN_SYSTEM,IW_AUTH_ALG_SHARED_KEY}
 130 }
 131 NM_AUTH_TYPE_WPA_PSK_AUTO:
 132 IW_AUTH_CIPHER_TKIP:
 133 IW_AUTH_CIPHER_CCMP:
 134 {
 135   s key
 136   int32 wpa version =>{IW_AUTH_WPA_VERSION_WPA,IW_AUTH_WPA_VERSION_WPA2}
 137   int32 key mgmt => {IW_AUTH_KEY_MGMT_802_1X,IW_AUTH_KEY_MGMT_PSK}
 138 }
 139 NM_AUTH_TYPE_WPA_EAP:
 140 {
 141   int32 eap method => {NM_EAP_METHOD_MD5,NM_EAP_METHOD_MSCHAP,NM_EAP_METHOD_OTP,NM_EAP_METHOD_GTC,NM_EAP_METHOD_PEAP,NM_EAP_METHOD_TLS,NM_EAP_METHOD_TTLS}
 142   int32 key type => {NM_AUTH_TYPE_WPA_PSK_AUTO,IW_AUTH_CIPHER_CCMP,IW_AUTH_CIPHER_TKIP,IW_AUTH_CIPHER_WEP104}
 143   s identity
 144   s password
 145   s anon identity
 146   s priv key password
 147   s priv key file
 148   s client cert file
 149   s ca cert file
 150   int32 wpa version => {IW_AUTH_WPA_VERSION_WPA,IW_AUTH_WPA_VERSION_WPA2}
 151 }
 152 NM_AUTH_TYPE_LEAP:
 153 {
 154   s username
 155   s password
 156   s key mgmt
 157 }