Top | ![]() |
![]() |
![]() |
![]() |
gboolean | auto-negotiate | Read / Write / Construct |
GArray_guchar_ * | cloned-mac-address | Read / Write |
gchar * | duplex | Read / Write |
GArray_guchar_ * | mac-address | Read / Write |
GSList_gchararray_ * | mac-address-blacklist | Read / Write |
guint | mtu | Read / Write / Construct |
gchar * | port | Read / Write |
gchar * | s390-nettype | Read / Write |
GHashTable_gchararray+gchararray_* | s390-options | Read / Write |
GPtrArray_gchararray_ * | s390-subchannels | Read / Write |
guint | speed | Read / Write / Construct |
#define | NM_SETTING_WIRED_SETTING_NAME |
enum | NMSettingWiredError |
#define | NM_SETTING_WIRED_ERROR |
#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 |
The NMSettingWired object is a NMSetting subclass that describes properties necessary for connection to Ethernet networks.
GQuark
nm_setting_wired_error_quark (void
);
Registers an error quark for NMSettingWired if necessary.
NMSetting *
nm_setting_wired_new (void
);
Creates a new NMSettingWired object with default values.
gboolean
nm_setting_wired_get_auto_negotiate (NMSettingWired *setting
);
const GByteArray *
nm_setting_wired_get_mac_address (NMSettingWired *setting
);
const GByteArray *
nm_setting_wired_get_cloned_mac_address
(NMSettingWired *setting
);
const GSList *
nm_setting_wired_get_mac_address_blacklist
(NMSettingWired *setting
);
guint32
nm_setting_wired_get_num_mac_blacklist_items
(NMSettingWired *setting
);
Since 0.9.10
const char * nm_setting_wired_get_mac_blacklist_item (NMSettingWired *setting
,guint32 idx
);
Since 0.9.10
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 |
TRUE
if the MAC address was added; FALSE
if the MAC address
is invalid or was already present
Since 0.9.10
void nm_setting_wired_remove_mac_blacklist_item (NMSettingWired *setting
,guint32 idx
);
Removes the MAC address at index idx
from the blacklist.
Since 0.9.10
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 |
Since 0.9.10
void
nm_setting_wired_clear_mac_blacklist_items
(NMSettingWired *setting
);
Removes all blacklisted MAC addresses.
Since 0.9.10
const GPtrArray *
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.
GPtrArray of strings, each specifying one subchannel the s390 device uses to communicate to the host.
[element-type utf8]
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] |
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] |
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.
Since 0.9.10
#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
“mac-address-blacklist”
property “mac-address-blacklist” GSList_gchararray_ *
Flags: Read / Write