NMSettingMatch: libnm Reference Manual

NMSettingMatch

NMSettingMatch — Properties to match a connection with a device.

Functions

NMSetting *	nm_setting_match_new ()
guint	nm_setting_match_get_num_interface_names ()
const char *	nm_setting_match_get_interface_name ()
void	nm_setting_match_remove_interface_name ()
gboolean	nm_setting_match_remove_interface_name_by_value ()
void	nm_setting_match_add_interface_name ()
void	nm_setting_match_clear_interface_names ()
const char const	nm_setting_match_get_interface_names ()
guint	nm_setting_match_get_num_kernel_command_lines ()
const char *	nm_setting_match_get_kernel_command_line ()
void	nm_setting_match_remove_kernel_command_line ()
gboolean	nm_setting_match_remove_kernel_command_line_by_value ()
void	nm_setting_match_add_kernel_command_line ()
void	nm_setting_match_clear_kernel_command_lines ()
const char const	nm_setting_match_get_kernel_command_lines ()
guint	nm_setting_match_get_num_drivers ()
const char *	nm_setting_match_get_driver ()
void	nm_setting_match_remove_driver ()
gboolean	nm_setting_match_remove_driver_by_value ()
void	nm_setting_match_add_driver ()
void	nm_setting_match_clear_drivers ()
const char const	nm_setting_match_get_drivers ()
guint	nm_setting_match_get_num_paths ()
const char *	nm_setting_match_get_path ()
void	nm_setting_match_remove_path ()
gboolean	nm_setting_match_remove_path_by_value ()
void	nm_setting_match_add_path ()
void	nm_setting_match_clear_paths ()
const char const	nm_setting_match_get_paths ()

Types and Values

#define	NM_SETTING_MATCH_SETTING_NAME
#define	NM_SETTING_MATCH_INTERFACE_NAME
#define	NM_SETTING_MATCH_KERNEL_COMMAND_LINE
#define	NM_SETTING_MATCH_DRIVER
#define	NM_SETTING_MATCH_PATH

Includes

#include <nm-setting-match.h>

Description

Functions

nm_setting_match_new ()

NMSetting *
nm_setting_match_new (void);

Creates a new NMSettingMatch object with default values.

Returns

the new empty NMSettingMatch object

Note that this function was present in header files since version 1.14. But due to a bug the symbol is only exposed and usable since version 1.32. As workaround, use g_object_new(NM_TYPE_SETTING_MATCH) which works with all versions since 1.14.

[transfer full]

Since: 1.32

nm_setting_match_get_num_interface_names ()

guint
nm_setting_match_get_num_interface_names
                               (NMSettingMatch *setting);

Parameters

setting

the NMSettingMatch

Returns

the number of configured interface names

Since: 1.14

nm_setting_match_get_interface_name ()

const char *
nm_setting_match_get_interface_name (NMSettingMatch *setting,
                                     int idx);

Parameters

setting	the NMSettingMatch
idx	index number of the DNS search domain to return

Returns

the interface name at index idx

Since: 1.14

nm_setting_match_remove_interface_name ()

void
nm_setting_match_remove_interface_name
                               (NMSettingMatch *setting,
                                int idx);

Removes the interface name at index idx .

Parameters

setting	the NMSettingMatch
idx	index number of the interface name

Since: 1.14

nm_setting_match_remove_interface_name_by_value ()

gboolean
nm_setting_match_remove_interface_name_by_value
                               (NMSettingMatch *setting,
                                const char *interface_name);

Removes interface_name .

Parameters

setting	the NMSettingMatch
interface_name	the interface name to remove

Returns

TRUE if the interface name was found and removed; FALSE if it was not.

Since: 1.14

nm_setting_match_add_interface_name ()

void
nm_setting_match_add_interface_name (NMSettingMatch *setting,
                                     const char *interface_name);

Adds a new interface name to the setting.

Parameters

setting	the NMSettingMatch
interface_name	the interface name to add

Since: 1.14

nm_setting_match_clear_interface_names ()

void
nm_setting_match_clear_interface_names
                               (NMSettingMatch *setting);

Removes all configured interface names.

Parameters

setting

the NMSettingMatch

Since: 1.14

nm_setting_match_get_interface_names ()

const char *const *
nm_setting_match_get_interface_names (NMSettingMatch *setting,
                                      guint *length);

Returns all the interface names.

Parameters

setting	the NMSettingMatch
length	the length of the returned interface names array.	[out][allow-none]

Returns

the NULL terminated list of configured interface names.

Before 1.26, the returned array was not NULL terminated and you MUST provide a length.

[transfer none][array length=length]

Since: 1.14

nm_setting_match_get_num_kernel_command_lines ()

guint
nm_setting_match_get_num_kernel_command_lines
                               (NMSettingMatch *setting);

Parameters

setting

the NMSettingMatch

Returns

the number of configured kernel command line arguments

Since: 1.26

nm_setting_match_get_kernel_command_line ()

const char *
nm_setting_match_get_kernel_command_line
                               (NMSettingMatch *setting,
                                guint idx);

Parameters

setting	the NMSettingMatch
idx	index number of the kernel command line argument to return

Returns

the kernel command line argument at index idx

Since: 1.26

nm_setting_match_remove_kernel_command_line ()

void
nm_setting_match_remove_kernel_command_line
                               (NMSettingMatch *setting,
                                guint idx);

Removes the kernel command line argument at index idx .

Parameters

setting	the NMSettingMatch
idx	index number of the kernel command line argument

Since: 1.26

nm_setting_match_remove_kernel_command_line_by_value ()

gboolean
nm_setting_match_remove_kernel_command_line_by_value
                               (NMSettingMatch *setting,
                                const char *kernel_command_line);

Removes kernel_command_line .

Parameters

setting	the NMSettingMatch
kernel_command_line	the kernel command line argument name to remove

Returns

TRUE if the kernel command line argument was found and removed; FALSE if it was not.

Since: 1.26

nm_setting_match_add_kernel_command_line ()

void
nm_setting_match_add_kernel_command_line
                               (NMSettingMatch *setting,
                                const char *kernel_command_line);

Adds a new kernel command line argument to the setting.

Parameters

setting	the NMSettingMatch
kernel_command_line	the kernel command line argument to add

Since: 1.26

nm_setting_match_clear_kernel_command_lines ()

void
nm_setting_match_clear_kernel_command_lines
                               (NMSettingMatch *setting);

Removes all configured kernel command line arguments.

Parameters

setting

the NMSettingMatch

Since: 1.26

nm_setting_match_get_kernel_command_lines ()

const char *const *
nm_setting_match_get_kernel_command_lines
                               (NMSettingMatch *setting,
                                guint *length);

Returns all the interface names.

Parameters

setting	the NMSettingMatch
length	the length of the returned interface names array.	[out][allow-none]

Returns

the configured interface names.

[transfer none][array length=length]

Since: 1.26

nm_setting_match_get_num_drivers ()

guint
nm_setting_match_get_num_drivers (NMSettingMatch *setting);

Parameters

setting

the NMSettingMatch

Returns

the number of configured drivers

Since: 1.26

nm_setting_match_get_driver ()

const char *
nm_setting_match_get_driver (NMSettingMatch *setting,
                             guint idx);

Parameters

setting	the NMSettingMatch
idx	index number of the DNS search domain to return

Returns

the driver at index idx

Since: 1.26

nm_setting_match_remove_driver ()

void
nm_setting_match_remove_driver (NMSettingMatch *setting,
                                guint idx);

Removes the driver at index idx .

Parameters

setting	the NMSettingMatch
idx	index number of the driver

Since: 1.26

nm_setting_match_remove_driver_by_value ()

gboolean
nm_setting_match_remove_driver_by_value
                               (NMSettingMatch *setting,
                                const char *driver);

Removes driver .

Parameters

setting	the NMSettingMatch
driver	the driver to remove

Returns

TRUE if the driver was found and removed; FALSE if it was not.

Since: 1.26

nm_setting_match_add_driver ()

void
nm_setting_match_add_driver (NMSettingMatch *setting,
                             const char *driver);

Adds a new driver to the setting.

Parameters

setting	the NMSettingMatch
driver	the driver to add

Since: 1.26

nm_setting_match_clear_drivers ()

void
nm_setting_match_clear_drivers (NMSettingMatch *setting);

Removes all configured drivers.

Parameters

setting

the NMSettingMatch

Since: 1.26

nm_setting_match_get_drivers ()

const char *const *
nm_setting_match_get_drivers (NMSettingMatch *setting,
                              guint *length);

Returns all the drivers.

Parameters

setting	the NMSettingMatch
length	the length of the returned interface names array.	[out][allow-none]

Returns

the configured drivers.

[transfer none][array length=length]

Since: 1.26

nm_setting_match_get_num_paths ()

guint
nm_setting_match_get_num_paths (NMSettingMatch *setting);

Parameters

setting

the NMSettingMatch

Returns

the number of configured paths

Since: 1.26

nm_setting_match_get_path ()

const char *
nm_setting_match_get_path (NMSettingMatch *setting,
                           guint idx);

Parameters

setting	the NMSettingMatch
idx	index number of the path to return

Returns

the path at index idx

Since: 1.26

nm_setting_match_remove_path ()

void
nm_setting_match_remove_path (NMSettingMatch *setting,
                              guint idx);

Removes the path at index idx .

Parameters

setting	the NMSettingMatch
idx	index number of the path

Since: 1.26

nm_setting_match_remove_path_by_value ()

gboolean
nm_setting_match_remove_path_by_value (NMSettingMatch *setting,
                                       const char *path);

Removes path .

Parameters

setting	the NMSettingMatch
path	the path to remove

Returns

TRUE if the path was found and removed; FALSE if it was not.

Since: 1.26

nm_setting_match_add_path ()

void
nm_setting_match_add_path (NMSettingMatch *setting,
                           const char *path);

Adds a new path to the setting.

Parameters

setting	the NMSettingMatch
path	the path to add

Since: 1.26

nm_setting_match_clear_paths ()

void
nm_setting_match_clear_paths (NMSettingMatch *setting);

Removes all configured paths.

Parameters

setting

the NMSettingMatch

Since: 1.26

nm_setting_match_get_paths ()

const char *const *
nm_setting_match_get_paths (NMSettingMatch *setting,
                            guint *length);

Returns all the paths.

Parameters

setting	the NMSettingMatch
length	the length of the returned paths array.	[out][allow-none]

Returns

the configured paths.

[transfer none][array length=length]

Since: 1.26

Types and Values

NM_SETTING_MATCH_SETTING_NAME

#define NM_SETTING_MATCH_SETTING_NAME "match"

NM_SETTING_MATCH_INTERFACE_NAME

#define NM_SETTING_MATCH_INTERFACE_NAME      "interface-name"

NM_SETTING_MATCH_KERNEL_COMMAND_LINE

#define NM_SETTING_MATCH_KERNEL_COMMAND_LINE "kernel-command-line"

NM_SETTING_MATCH_DRIVER

#define NM_SETTING_MATCH_DRIVER              "driver"

NM_SETTING_MATCH_PATH

#define NM_SETTING_MATCH_PATH                "path"