| Paul Stewart | a4e618b | 2012-04-25 16:21:22 -0700 | [diff] [blame^] | 1 | IP Configuration Handling |
| 2 | ************************* |
| 3 | |
| 4 | |
| 5 | IP basics |
| 6 | ========= |
| 7 | |
| 8 | Layer 3 configuration state is managed on a per-device basis. When |
| 9 | a device is connected, it will have an IPConifg record associated with |
| 10 | it. In addition, connected services will have an "IPConfig" property |
| 11 | which will contain the path to this record. These properties of the |
| 12 | IPConfig record represent the current state of connectivity of the |
| 13 | device. |
| 14 | |
| 15 | IPConfig hierarchy |
| 16 | ================== |
| 17 | |
| 18 | Service org.chromium.flimflam |
| 19 | Interface org.chromium.flimflam.IPConfig |
| 20 | Object path [variable prefix]/{ipconfig0,ipconfig1,...} |
| 21 | |
| 22 | Methods dict GetProperties() |
| 23 | |
| 24 | Return properties for the IPConfig object. See |
| 25 | the properties section for available properties. |
| 26 | |
| 27 | Signals PropertyChanged(string name, variant value) |
| 28 | |
| 29 | This signal indicates a changed value of the given |
| 30 | property. |
| 31 | |
| 32 | Properties string Address [readonly] |
| 33 | |
| 34 | The Layer 3 address expressed in the dotted-quad format |
| 35 | for IPv4 and any allowed format for IPv6 (as specified |
| 36 | for inet_pton(3)). |
| 37 | |
| 38 | string Broadcast [readonly] |
| 39 | |
| 40 | The Layer 3 broadcast address specified as per Address. |
| 41 | |
| 42 | string DomainName [readonly] |
| 43 | |
| 44 | The DNS domain name to use in building FQDN queries. |
| 45 | |
| 46 | string Gateway [readonly] |
| 47 | |
| 48 | The Layer 3 address gateway address specified as |
| 49 | per Address. |
| 50 | |
| 51 | string Method [readonly] |
| 52 | |
| 53 | The method by which Layer 3 state is managed. |
| 54 | |
| 55 | Possible methods are: |
| 56 | "ipv4" (fixed IPv4 network state) |
| 57 | "ipv6" (fixed IPv6 network state) |
| 58 | "dhcp" (IPv4 state setup using DHCP) |
| 59 | "bootp" (IPv4 state setup using BOOTP) |
| 60 | "zeroconf" (IPV4 state setup using ZeroConf) |
| 61 | "dhcp6" (IPv6 state setup using DHCP6) |
| 62 | "ppp" (IPv4 state setup using PPP) |
| 63 | "vpn" (IPv4 state setup using VPN) |
| 64 | |
| 65 | int32 Mtu [readonly] |
| 66 | |
| 67 | The maximum transmit unit (MTU) in bytes. |
| 68 | |
| 69 | array{string} NameServers [readonly] |
| 70 | |
| 71 | The Layer 3 addresses of DNS domain name servers to |
| 72 | use for DNS requests. |
| 73 | |
| 74 | string PeerAddress [readonly] |
| 75 | |
| 76 | The Layer 3 address associated with the destination |
| 77 | endpoint of a point-to-point link. This value is |
| 78 | specified as per Address. |
| 79 | |
| 80 | int32 Prefixlen [readonly] |
| 81 | |
| 82 | The number of bits in a Layer 3 address that are |
| 83 | part of the network address. For IPv4 networks this |
| 84 | corresponds to the length of the network mask; e.g. |
| 85 | a netmask of 255.255.255.0 has a prefixlen of 24 |
| 86 | (note arbitrary CIDR masks are not supported.) |