| Ratan Gupta | 4c8247b | 2017-03-16 16:23:06 +0530 | [diff] [blame] | 1 | description: > |
| 2 | This defines an ethernet interface. |
| 3 | An object implementing this interface must implement |
| 4 | xyz.openbmc_project.State.OperationalStatus. |
| 5 | |
| Ratan Gupta | 4c8247b | 2017-03-16 16:23:06 +0530 | [diff] [blame] | 6 | properties: |
| 7 | - name: InterfaceName |
| 8 | type: string |
| 9 | description: > |
| 10 | Name of the ethernet interface. |
| Ratan Gupta | 4c8247b | 2017-03-16 16:23:06 +0530 | [diff] [blame] | 11 | - name: Speed |
| 12 | type: uint32 |
| 13 | description: > |
| 14 | Current speed of the ethernet interface, in Mbps. |
| 15 | - name: AutoNeg |
| 16 | type: boolean |
| 17 | description: > |
| 18 | This indicates if the speed and duplex are automatically negotiated |
| 19 | and configured on this ethernet interface. |
| Tejas Patil | 0ef46c1 | 2021-07-19 17:34:57 +0530 | [diff] [blame] | 20 | - name: MTU |
| 21 | type: size |
| 22 | default: 0 |
| 23 | description: > |
| 24 | This indicates the size in bytes of largest protocol data unit, |
| 25 | which can be passed in an Ethernet frame on the interface. |
| Ratan Gupta | 4c8247b | 2017-03-16 16:23:06 +0530 | [diff] [blame] | 26 | - name: DomainName |
| 27 | type: array[string] |
| 28 | description: > |
| 29 | Domain names of the ethernet interface. |
| 30 | - name: DHCPEnabled |
| Johnathan Mantey | 1977059 | 2020-06-16 09:25:19 -0700 | [diff] [blame] | 31 | type: enum[self.DHCPConf] |
| Ratan Gupta | 4c8247b | 2017-03-16 16:23:06 +0530 | [diff] [blame] | 32 | description: > |
| 33 | Address mode of the ethernet interface. |
| 34 | - name: Nameservers |
| 35 | type: array[string] |
| 36 | description: > |
| Manojkiran Eda | 496741a | 2019-10-13 18:46:11 +0530 | [diff] [blame] | 37 | DNS servers that are currently in use on this interface. |
| Manojkiran Eda | 83968c3 | 2019-08-22 11:59:13 +0530 | [diff] [blame] | 38 | errors: |
| Manojkiran Eda | 262ac24 | 2019-08-08 14:35:06 +0530 | [diff] [blame] | 39 | - xyz::openbmc_project.Common.Error.NotAllowed |
| Manojkiran Eda | 496741a | 2019-10-13 18:46:11 +0530 | [diff] [blame] | 40 | - name: StaticNameServers |
| 41 | type: array[string] |
| 42 | description: > |
| 43 | A statically defined set of DNS server IP addresses to be used when |
| 44 | DHCP provisioning is not enabled for name server configuration. As |
| 45 | an implementation option this may also be used in addition to DHCP |
| 46 | provided addresses, or in cases where the DHCP server provides no DNS |
| 47 | assigments. |
| 48 | errors: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 49 | - xyz.openbmc_project.Common.Error.InvalidArgument |
| Ratan Gupta | a51dea7 | 2017-08-23 18:13:33 +0530 | [diff] [blame] | 50 | - name: NTPServers |
| 51 | type: array[string] |
| 52 | description: > |
| 53 | This property describes the NTP Servers on the interface. |
| 54 | Implementation of this Dbus-interface is required to implement this property. |
| 55 | This property supports read/write operation. |
| 56 | Configure the NTP servers on the system during write operation. |
| Ravi Teja | 0edc82d | 2019-04-24 00:57:20 -0500 | [diff] [blame] | 57 | - name: LinkLocalAutoConf |
| 58 | type: enum[self.LinkLocalConf] |
| 59 | description: > |
| 60 | This indicates link local auto configuration on this ethernet |
| 61 | interface and configured on this ethernet interface. |
| Johnathan Mantey | 8d6cb9b | 2019-06-25 09:20:50 -0700 | [diff] [blame] | 62 | - name: IPv6AcceptRA |
| 63 | type: boolean |
| 64 | description: > |
| 65 | Boolean for accepting router advertisements in IPv6 |
| Johnathan Mantey | b43056f | 2019-10-29 16:15:18 -0700 | [diff] [blame] | 66 | - name: NICEnabled |
| 67 | type: boolean |
| 68 | description: > |
| 69 | Boolean for to enabling or disabling the ethernet port |
| Johnathan Mantey | 97b5129 | 2020-01-08 10:56:19 -0800 | [diff] [blame] | 70 | - name: LinkUp |
| 71 | type: boolean |
| 72 | flags: |
| 73 | - const |
| 74 | description: > |
| 75 | This property reports the link status for the NIC. The read-only |
| 76 | boolean value is TRUE when the network cable is inserted, or there |
| 77 | is a carrier signal. It is FALSE when the cable is unplugged, or the |
| 78 | carrier signal is missing. |
| Ravi Teja | 0f57291 | 2020-07-06 09:37:59 -0500 | [diff] [blame] | 79 | - name: DefaultGateway |
| 80 | type: string |
| 81 | description: > |
| 82 | Default IPv4 gateway of the ethernet interface. |
| 83 | errors: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 84 | - xyz.openbmc_project.Common.Error.InvalidArgument |
| Ravi Teja | 0f57291 | 2020-07-06 09:37:59 -0500 | [diff] [blame] | 85 | - name: DefaultGateway6 |
| 86 | type: string |
| 87 | description: > |
| 88 | Default IPv6 gateway of the ethernet interface. |
| 89 | For supported address formats refer RFC 2373. |
| 90 | Refer below man page for both v4 and v6 address format details |
| 91 | https://man7.org/linux/man-pages/man3/inet_pton.3.html |
| 92 | errors: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 93 | - xyz.openbmc_project.Common.Error.InvalidArgument |
| Ravi Teja | 0edc82d | 2019-04-24 00:57:20 -0500 | [diff] [blame] | 94 | |
| 95 | enumerations: |
| 96 | - name: LinkLocalConf |
| 97 | description: > |
| 98 | Possible link local auto configuration values. |
| 99 | values: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 100 | - name: fallback |
| 101 | - name: both |
| 102 | - name: v4 |
| 103 | - name: v6 |
| 104 | - name: none |
| Andrew Geissler | fcc419b | 2020-06-04 10:26:16 -0500 | [diff] [blame] | 105 | |
| Johnathan Mantey | 1977059 | 2020-06-16 09:25:19 -0700 | [diff] [blame] | 106 | - name: DHCPConf |
| 107 | description: > |
| 108 | A list of the permitted DHCP settings used by systemd. |
| 109 | values: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 110 | - name: both |
| 111 | - name: v4 |
| 112 | - name: v6 |
| 113 | - name: none |