Added ConnectToNetwork

chromeos_network.h

 // Copyright (c) 2009 The Chromium OS Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROMEOS_NETWORK_H_
 #define CHROMEOS_NETWORK_H_
 
 #include <base/basictypes.h>
 
 namespace chromeos { // NOLINT
 
-// connection types (see connman/include/service.h)
+// Connection enums (see flimflam/files/include/service.h)
 enum ConnectionType {
-  TYPE_UNKNOWN    = 0x00000,
-  TYPE_ETHERNET   = 0x00001,
-  TYPE_WIFI       = 0x00010,
-  TYPE_WIMAX      = 0x00100,
-  TYPE_BLUETOOTH  = 0x01000,
-  TYPE_CELLULAR   = 0x10000,
+  TYPE_UNKNOWN   = 0,
+  TYPE_ETHERNET  = 1,
+  TYPE_WIFI      = 2,
+  TYPE_WIMAX     = 3,
+  TYPE_BLUETOOTH = 4,
+  TYPE_CELLULAR  = 5,
 };
 
-// connection states (see connman/include/service.h)
-enum ConnectionState {
-  STATE_UNKNOWN,
-  STATE_IDLE,
-  STATE_CARRIER,
-  STATE_ASSOCIATION,
-  STATE_CONFIGURATION,
-  STATE_READY,
-  STATE_DISCONNECT,
-  STATE_FAILURE,
+enum ConnectionMode {
+  MODE_UNKNOWN = 0,
+  MODE_MANAGED = 1,
+  MODE_ADHOC   = 2,
 };
 
-enum EncryptionType {
-  NONE,
-  WEP,
-  WPA,
-  RSN
+enum ConnectionSecurity {
+  SECURITY_UNKNOWN = 0,
+  SECURITY_NONE    = 1,
+  SECURITY_WEP     = 2,
+  SECURITY_WPA     = 3,
+  SECURITY_RSN     = 4,
+};
+
+enum ConnectionState {
+  STATE_UNKNOWN       = 0,
+  STATE_IDLE          = 1,
+  STATE_CARRIER       = 2,
+  STATE_ASSOCIATION   = 3,
+  STATE_CONFIGURATION = 4,
+  STATE_READY         = 5,
+  STATE_DISCONNECT    = 6,
+  STATE_FAILURE       = 7,
+};
+
+enum ConnectionError {
+  ERROR_UNKNOWN        = 0,
+  ERROR_OUT_OF_RANGE   = 1,
+  ERROR_PIN_MISSING    = 2,
+  ERROR_DHCP_FAILED    = 3,
+  ERROR_CONNECT_FAILED = 4,
 };
 
 // ipconfig types (see flimflam/files/doc/ipconfig-api.txt
 enum IPConfigType {
   IPCONFIG_TYPE_UNKNOWN,
   IPCONFIG_TYPE_IPV4,
   IPCONFIG_TYPE_IPV6,
   IPCONFIG_TYPE_DHCP,
   IPCONFIG_TYPE_BOOTP, //Not Used
   IPCONFIG_TYPE_ZEROCONF,
   IPCONFIG_TYPE_DHCP6,
   IPCONFIG_TYPE_PPP,
 };
 
 struct ServiceInfo {
-  const char* ssid;
+  const char* service_path;
+  const char* name;
+  ConnectionType type;
+  ConnectionMode mode;
+  ConnectionSecurity security;
+  ConnectionState state;
+  ConnectionError error;
+  bool passphrase_required;
+  const char* passphrase;
+  int64 strength;
+  bool favorite;
+  bool auto_connect;
   const char* device_path;
-  ConnectionType type;
-  ConnectionState state;
-  int64 signal_strength;
-  bool needs_passphrase;
-  EncryptionType encryption;
 };
 
 struct ServiceStatus {
   ServiceInfo *services;
   int size;
 };
 
 struct IPConfig {
   const char* path;
   IPConfigType type;
   const char* address;
   int32 mtu;
   const char* netmask;
   const char* broadcast;
   const char* peer_address;
   const char* gateway;
   const char* domainname;
   const char* name_servers;
 };
 
 struct IPConfigStatus {
   IPConfig* ips;
   int size;
 };
 
-// Connects to a given ssid.
+// Connects to the network with the |service_path|.
 //
-// Set passphrase to NULL if the network doesn't require authentication.
-//
-// Set encryption to NULL if the network doesn't require authentication
-// otherwise we will use 'rsn' as the default.
+// Set |passphrase| to NULL if the network doesn't require authentication.
 //
 // returns false on failure and true on success.
 //
 // Note, a successful call to this function only indicates that the
 // connection process has started. You will have to query the connection state
 // to determine if the connection was established successfully.
-extern bool (*ConnectToWifiNetwork)(const char* ssid,
-                                    const char* passphrase,
-                                    const char* encryption);
+extern bool (*ConnectToNetwork)(const char* service_path,
+                                const char* passphrase);
 
 // Returns a list of all of the available services that a user can connect to.
 // The ServiceStatus instance that is returned by this function MUST be
 // deleted with by calling FreeServiceStatus.
 //
 // Returns NULL on error.
 extern ServiceStatus* (*GetAvailableNetworks)();
 
 // Deletes a ServiceStatus type that was allocated in the ChromeOS dll. We need
 // to do this to safely pass data over the dll boundary between our .so and
@@ skipping 13 matching lines @@
 typedef void(*NetworkMonitor)(void* object, const ServiceStatus& status);
 
 // Processes a callback from a d-bus signal by finding the path of the
 // Connman service that changed and sending the details along to the next
 // handler in the chain as an instance of ServiceInfo.
 extern NetworkStatusConnection (*MonitorNetworkStatus)(NetworkMonitor, void*);
 
 // Disconnects a NetworkStatusConnection.
 extern void (*DisconnectNetworkStatus)(NetworkStatusConnection connection);
 
-// Returns the enabled network devices as a bitwise or value of ConnectionTypes.
+// Returns the enabled network devices as a bitwise OR value of ConnectionTypes.
+// Each bit represents whether or not that ConnectionType is enabled.
+// For example, the bit representing TYPE_WIFI is (1 << TYPE_WIFI)
 //
 // Returns 0 if no devices are enabled.
 // Returns -1 if offline mode, by definition, means all devices are disabled.
 extern int (*GetEnabledNetworkDevices)();
 
 // Enable or disable the specific network device for connection.
 //
 // Returns false on failure and true on success.
 extern bool (*EnableNetworkDevice)(ConnectionType type, bool enable);
 
 // Set offline mode. This will turn off all radios.
 //
 // Returns false on failure and true on success.
 extern bool (*SetOfflineMode)(bool offline);
 
 // Gets a list of all the IPConfigs using a given device path
 extern IPConfigStatus* (*ListIPConfigs)(const char* device_path);
 
 // Add a IPConfig of the given type to the device
 extern bool (*AddIPConfig)(const char* device_path, IPConfigType type);
 
-// Sets a property of the IPConfig
-// Address Mtu PrefixLen Broadcast PeerAddress Gateway DomainName
-extern bool (*SetIPConfigProperty)(IPConfig* config,
-                                   const char* key,
-                                   const char* value);
-
-// Gets a property of this Ip address.  Valid keys are:
-// Address Mtu PrefixLen Broadcast PeerAddress Gateway DomainName
-extern bool (*GetIPConfigProperty)(IPConfig* config,
-                                   const char* key,
-                                   char* val,
-                                   size_t valsz);
-
 // Save the IP config data
 extern bool (*SaveIPConfig)(IPConfig* config);
 
 // Remove an existing IP Config
 extern bool (*RemoveIPConfig)(IPConfig* config);
 
 // Free a found IPConfig
 extern void (*FreeIPConfig)(IPConfig* config);
 
 // Free out a full status
 extern void (*FreeIPConfigStatus)(IPConfigStatus* status);
 
 }  // namespace chromeos
 
 #endif  // CHROMEOS_NETWORK_H_