NMSettingMatch

NMSettingMatch — Properties to match a connection with a device.

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.

[transfer full]

Since: 1.14


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"