Top | ![]() |
![]() |
![]() |
![]() |
gboolean | auto-negotiate | Read / Write / Construct |
gchar * | cloned-mac-address | Read / Write |
gchar * | duplex | Read / Write |
gchar * | mac-address | Read / Write |
GStrv | mac-address-blacklist | Read / Write |
guint | mtu | Read / Write / Construct |
gchar * | port | Read / Write |
gchar * | s390-nettype | Read / Write |
GHashTable * | s390-options | Read / Write |
GStrv | s390-subchannels | Read / Write |
guint | speed | Read / Write / Construct |
guint | wake-on-lan | Read / Write / Construct |
gchar * | wake-on-lan-password | Read / Write |
#define | NM_SETTING_WIRED_SETTING_NAME |
enum | NMSettingWiredWakeOnLan |
#define | NM_SETTING_WIRED_PORT |
#define | NM_SETTING_WIRED_SPEED |
#define | NM_SETTING_WIRED_DUPLEX |
#define | NM_SETTING_WIRED_AUTO_NEGOTIATE |
#define | NM_SETTING_WIRED_MAC_ADDRESS |
#define | NM_SETTING_WIRED_CLONED_MAC_ADDRESS |
#define | NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST |
#define | NM_SETTING_WIRED_MTU |
#define | NM_SETTING_WIRED_S390_SUBCHANNELS |
#define | NM_SETTING_WIRED_S390_NETTYPE |
#define | NM_SETTING_WIRED_S390_OPTIONS |
#define | NM_SETTING_WIRED_WAKE_ON_LAN |
#define | NM_SETTING_WIRED_WAKE_ON_LAN_PASSWORD |
The NMSettingWired object is a NMSetting subclass that describes properties necessary for connection to Ethernet networks.
NMSetting *
nm_setting_wired_new (void
);
Creates a new NMSettingWired object with default values.
gboolean
nm_setting_wired_get_auto_negotiate (NMSettingWired *setting
);
const char *
nm_setting_wired_get_mac_address (NMSettingWired *setting
);
const char *
nm_setting_wired_get_cloned_mac_address
(NMSettingWired *setting
);
const char * const *
nm_setting_wired_get_mac_address_blacklist
(NMSettingWired *setting
);
guint32
nm_setting_wired_get_num_mac_blacklist_items
(NMSettingWired *setting
);
const char * nm_setting_wired_get_mac_blacklist_item (NMSettingWired *setting
,guint32 idx
);
gboolean nm_setting_wired_add_mac_blacklist_item (NMSettingWired *setting
,const char *mac
);
Adds a new MAC address to the “mac-address-blacklist” property.
setting |
the NMSettingWired |
|
mac |
the MAC address string (hex-digits-and-colons notation) to blacklist |
void nm_setting_wired_remove_mac_blacklist_item (NMSettingWired *setting
,guint32 idx
);
Removes the MAC address at index idx
from the blacklist.
gboolean nm_setting_wired_remove_mac_blacklist_item_by_value (NMSettingWired *setting
,const char *mac
);
Removes the MAC address mac
from the blacklist.
setting |
the NMSettingWired |
|
mac |
the MAC address string (hex-digits-and-colons notation) to remove from the blacklist |
void
nm_setting_wired_clear_mac_blacklist_items
(NMSettingWired *setting
);
Removes all blacklisted MAC addresses.
const char * const *
nm_setting_wired_get_s390_subchannels (NMSettingWired *setting
);
Return the list of s390 subchannels that identify the device that this connection is applicable to. The connection should only be used in conjunction with that device.
const char *
nm_setting_wired_get_s390_nettype (NMSettingWired *setting
);
Returns the s390 device type this connection should apply to. Will be one of 'qeth', 'lcs', or 'ctc'.
guint32
nm_setting_wired_get_num_s390_options (NMSettingWired *setting
);
Returns the number of s390-specific options that should be set for this
device when it is activated. This can be used to retrieve each s390
option individually using nm_setting_wired_get_s390_option()
.
gboolean nm_setting_wired_get_s390_option (NMSettingWired *setting
,guint32 idx
,const char **out_key
,const char **out_value
);
Given an index, return the value of the s390 option at that index. indexes
are *not* guaranteed to be static across modifications to options done by
nm_setting_wired_add_s390_option()
and nm_setting_wired_remove_s390_option()
,
and should not be used to refer to options except for short periods of time
such as during option iteration.
setting |
the NMSettingWired |
|
idx |
index of the desired option, from 0 to
|
|
out_key |
on return, the key name of the s390 specific option; this value is owned by the setting and should not be modified. |
[out][transfer none] |
out_value |
on return, the value of the key of the s390 specific option; this value is owned by the setting and should not be modified. |
[out][transfer none] |
const char * nm_setting_wired_get_s390_option_by_key (NMSettingWired *setting
,const char *key
);
Returns the value associated with the s390-specific option specified by
key
, if it exists.
the value, or NULL
if the key/value pair was never added to the
setting; the value is owned by the setting and must not be modified
gboolean nm_setting_wired_add_s390_option (NMSettingWired *setting
,const char *key
,const char *value
);
Add an option to the table. The option is compared to an internal list of allowed options. Key names may contain only alphanumeric characters (ie [a-zA-Z0-9]). Adding a new key replaces any existing key/value pair that may already exist.
gboolean nm_setting_wired_remove_s390_option (NMSettingWired *setting
,const char *key
);
Remove the s390-specific option referenced by key
from the internal option
list.
const char **
nm_setting_wired_get_valid_s390_options
(NMSettingWired *setting
);
Returns a list of valid s390 options.
NMSettingWiredWakeOnLan
nm_setting_wired_get_wake_on_lan (NMSettingWired *setting
);
Returns the Wake-on-LAN options enabled for the connection
Since 1.0.6
const char *
nm_setting_wired_get_wake_on_lan_password
(NMSettingWired *setting
);
Returns the Wake-on-LAN password. This only applies to
NM_SETTING_WIRED_WAKE_ON_LAN_MAGIC
.
Since 1.0.6
Options for “wake-on-lan”. Note that not all options are supported by all devices.
Wake-on-LAN disabled |
||
Wake on PHY activity |
||
Wake on unicast messages |
||
Wake on multicast messages |
||
Wake on broadcast messages |
||
Wake on ARP |
||
Wake on magic packet |
||
Wake on all events. This does not
include the exclusive flags |
||
Use the default value |
||
Don't change configured settings |
||
Mask of flags that are incompatible with other flags |
Since 1.0.6
#define NM_SETTING_WIRED_CLONED_MAC_ADDRESS "cloned-mac-address"
#define NM_SETTING_WIRED_MAC_ADDRESS_BLACKLIST "mac-address-blacklist"
“auto-negotiate”
property“auto-negotiate” gboolean
Flags: Read / Write / Construct
Default value: TRUE
“cloned-mac-address”
property“cloned-mac-address” gchar *
Flags: Read / Write
Default value: NULL
“wake-on-lan”
property“wake-on-lan” guint
Flags: Read / Write / Construct
Default value: 1
Since 1.0.6
“wake-on-lan-password”
property“wake-on-lan-password” gchar *
Flags: Read / Write
Default value: NULL
Since 1.0.6