SettingWired

---

Object Hierarchy:

Description:

Content:

Constants:

• public const string ACCEPT_ALL_MAC_ADDRESSES
• public const string AUTO_NEGOTIATE
• public const string CLONED_MAC_ADDRESS
• public const string DUPLEX
• public const string GENERATE_MAC_ADDRESS_MASK
• public const string MAC_ADDRESS
• public const string MAC_ADDRESS_BLACKLIST
• public const string MAC_ADDRESS_DENYLIST
• public const string MTU
• public const string PORT
• public const string S390_NETTYPE
• public const string S390_OPTIONS
• public const string S390_SUBCHANNELS
• public const string SETTING_NAME
• public const string SPEED
• public const string WAKE_ON_LAN
• public const string WAKE_ON_LAN_PASSWORD

Properties:

• public Ternary accept_all_mac_addresses { get; set; }
  When true, setup the interface to accept packets for all MAC addresses.
• public bool auto_negotiate { get; set; }
  When true, enforce auto-negotiation of speed and duplex mode.
• public string cloned_mac_address { owned get; set; }
  If specified, request that the device use this MAC address instead.
• public string duplex { owned get; set; }
  When a value is set, either "half" or "full", configures the device to use the specified duplex mode.
• public string generate_mac_address_mask { owned get; set; }
  With cloned_mac_address setting "random" or "stable", by default all bits of the MAC address are scrambled and a locally-administered, unicast MAC address is created.
• public string mac_address { owned get; set; }
  If specified, this connection will only apply to the Ethernet device whose permanent MAC address matches.
• public string[] mac_address_blacklist { owned get; set; }
  If specified, this connection will never apply to the Ethernet device whose permanent MAC address matches an address in the list.
• public string[] mac_address_denylist { owned get; set; }
  If specified, this connection will never apply to the Ethernet device whose permanent MAC address matches an address in the list.
• public uint mtu { get; set; }
  If non-zero, only transmit packets of the specified size or smaller, breaking larger packets up into multiple Ethernet frames.
• public string port { owned get; set; }
  Specific port type to use if the device supports multiple attachment methods.
• public string s390_nettype { owned get; set; }
  s390 network device type; one of "qeth", "lcs", or "ctc", representing the different types of virtual network devices available on s390 systems.
• public HashTable<string,string> s390_options { owned get; set; }
  Dictionary of key/value pairs of s390-specific device options.
• public string[] s390_subchannels { owned get; set; }
  Identifies specific subchannels that this network device uses for communication with z/VM or s390 host.
• public uint speed { get; set; }
  When a value greater than 0 is set, configures the device to use the specified speed.
• public uint wake_on_lan { get; set; }
  The SettingWiredWakeOnLan options to enable.
• public string wake_on_lan_password { owned get; set; }
  If specified, the password used with magic-packet-based Wake-on-LAN, represented as an Ethernet MAC address.

Creation methods:

• public SettingWired ()
  Creates a new SettingWired object with default values.

Methods:

• public bool add_mac_blacklist_item (string mac)
  Adds a new MAC address to the mac_address_blacklist property.
• public bool add_mac_denylist_item (string mac)
  Adds a new MAC address to the mac_address_denylist property.
• public bool add_s390_option (string key, string value)
  Add an option to the table.
• public void clear_mac_blacklist_items ()
  Removes all blacklisted MAC addresses.
• public void clear_mac_denylist_items ()
  Removes all denylisted MAC addresses.
• public Ternary get_accept_all_mac_addresses ()
• public bool get_auto_negotiate ()
• public unowned string get_cloned_mac_address ()
• public unowned string get_duplex ()
• public unowned string get_generate_mac_address_mask ()
• public unowned string get_mac_address ()
• public unowned string[] get_mac_address_blacklist ()
• public unowned string[] get_mac_address_denylist ()
• public unowned string get_mac_blacklist_item (uint32 idx)
  Since 1.48, access at index "len" is allowed and returns NULL.
• public unowned string get_mac_denylist_item (uint32 idx)
• public uint32 get_mtu ()
• public uint32 get_num_mac_blacklist_items ()
• public uint32 get_num_mac_denylist_items ()
• public uint32 get_num_s390_options ()
  Returns the number of s390-specific options that should be set for this device when it is activated.
• public unowned string get_port ()
• public unowned string get_s390_nettype ()
  Returns the s390 device type this connection should apply to.
• public bool get_s390_option (uint32 idx, out unowned string? out_key, out unowned string? out_value)
  Given an index, return the value of the s390 option at that index.
• public unowned string get_s390_option_by_key (string key)
  Returns the value associated with the s390-specific option specified by key, if it exists.
• public unowned string[] get_s390_subchannels ()
  Return the list of s390 subchannels that identify the device that this connection is applicable to.
• public uint32 get_speed ()
• public unowned string[] get_valid_s390_options ()
  Returns a list of valid s390 options.
• public SettingWiredWakeOnLan get_wake_on_lan ()
  Returns the Wake-on-LAN options enabled for the connection
• public unowned string get_wake_on_lan_password ()
  Returns the Wake-on-LAN password.
• public void remove_mac_blacklist_item (uint32 idx)
  Removes the MAC address at index idx from the blacklist.
• public bool remove_mac_blacklist_item_by_value (string mac)
  Removes the MAC address mac from the blacklist.
• public void remove_mac_denylist_item (uint32 idx)
  Removes the MAC address at index idx from the denylist.
• public bool remove_mac_denylist_item_by_value (string mac)
  Removes the MAC address mac from the denylist.
• public bool remove_s390_option (string key)
  Remove the s390-specific option referenced by key from the internal option list.

Inherited Members: