NMIPConfig: libnm Reference Manual

## NMIPConfig NMIPConfig |

## Functions

int | nm_ip_config_get_family ()
const char * | nm_ip_config_get_gateway ()
const char * | nm_ip_config_get_clat_address ()
const char * | nm_ip_config_get_clat_pref64 ()
GPtrArray * | nm_ip_config_get_addresses ()
GPtrArray * | nm_ip_config_get_routes ()
const char *const * | nm_ip_config_get_nameservers ()
const char *const * | nm_ip_config_get_domains ()
const char *const * | nm_ip_config_get_searches ()
const char *const * | nm_ip_config_get_wins_servers ()

## Properties

GPtrArray * | addresses | Read
char * | clat-address | Read
char * | clat-pref64 | Read
GStrv | domains | Read
int | family | Read
char * | gateway | Read
GStrv | nameservers | Read
GPtrArray * | routes | Read
GStrv | searches | Read
GStrv | wins-servers | Read

## Types and Values

#define | NM_IP_CONFIG_FAMILY
#define | NM_IP_CONFIG_GATEWAY
#define | NM_IP_CONFIG_ADDRESSES
#define | NM_IP_CONFIG_ROUTES
#define | NM_IP_CONFIG_NAMESERVERS
#define | NM_IP_CONFIG_DOMAINS
#define | NM_IP_CONFIG_SEARCHES
#define | NM_IP_CONFIG_WINS_SERVERS
#define | NM_IP_CONFIG_CLAT_ADDRESS
#define | NM_IP_CONFIG_CLAT_PREF64
| NMIPConfig

## Object Hierarchy

        GObject
        ╰── NMObject
            ╰── NMIPConfig

## Description

## Functions

### nm_ip_config_get_family ()

    int
    nm_ip_config_get_family (NMIPConfig *config);

Gets the IP address family

#### Parameters

config | a NMIPConfig |

#### Returns

the IP address family; either `AF_INET` or `AF_INET6`

### nm_ip_config_get_gateway ()

    const char *
    nm_ip_config_get_gateway (NMIPConfig *config);

Gets the IP gateway address.

#### Parameters

config | a NMIPConfig |

#### Returns

the IP address of the gateway.

[transfer none]

### nm_ip_config_get_clat_address ()

    const char *
    nm_ip_config_get_clat_address (NMIPConfig *config);

Gets the CLAT IP address.

#### Parameters

config | a NMIPConfig |

#### Returns

the CLAT IP address.

[transfer none]

Since: 1.58

### nm_ip_config_get_clat_pref64 ()

    const char *
    nm_ip_config_get_clat_pref64 (NMIPConfig *config);

Gets the NAT64 prefix used by CLAT.

#### Parameters

config | a NMIPConfig |

#### Returns

the NAT64 prefix.

[transfer none]

Since: 1.58

### nm_ip_config_get_addresses ()

    GPtrArray *
    nm_ip_config_get_addresses (NMIPConfig *config);

Gets the IP addresses (containing the address, prefix, and gateway).

#### Parameters

config | a NMIPConfig |

#### Returns

the GPtrArray containing NMIPAddresses. This is the internal copy used by the configuration and must not be modified. The library never modifies the returned array and thus it is safe for callers to reference and keep using it.

[element-type NMIPAddress][transfer none]

### nm_ip_config_get_routes ()

    GPtrArray *
    nm_ip_config_get_routes (NMIPConfig *config);

Gets the routes.

#### Parameters

config | a NMIPConfig |

#### Returns

the GPtrArray containing NMIPRoutes. This is the internal copy used by the configuration, and must not be modified. The library never modifies the returned array and thus it is safe for callers to reference and keep using it.

[element-type NMIPRoute][transfer none]

### nm_ip_config_get_nameservers ()

    const char *const *
    nm_ip_config_get_nameservers (NMIPConfig *config);

Gets the domain name servers (DNS).

#### Parameters

config | a NMIPConfig |

#### Returns

the array of nameserver IP addresses.

[transfer none]

### nm_ip_config_get_domains ()

    const char *const *
    nm_ip_config_get_domains (NMIPConfig *config);

Gets the domain names.

#### Parameters

config | a NMIPConfig |

#### Returns

the array of domains. (This is never `NULL`, though it may be 0-length).

[transfer none]

### nm_ip_config_get_searches ()

    const char *const *
    nm_ip_config_get_searches (NMIPConfig *config);

Gets the DNS searches.

#### Parameters

config | a NMIPConfig |

#### Returns

the array of DNS search strings. (This is never `NULL`, though it may be 0-length).

[transfer none]

### nm_ip_config_get_wins_servers ()

    const char *const *
    nm_ip_config_get_wins_servers (NMIPConfig *config);

Gets the Windows Internet Name Service servers (WINS).

#### Parameters

config | a NMIPConfig |

#### Returns

the arry of WINS server IP address strings. (This is never `NULL`, though it may be 0-length.).

[transfer none]

## Types and Values

### NM_IP_CONFIG_FAMILY

    #define NM_IP_CONFIG_FAMILY       "family"

### NM_IP_CONFIG_GATEWAY

    #define NM_IP_CONFIG_GATEWAY      "gateway"

### NM_IP_CONFIG_ADDRESSES

    #define NM_IP_CONFIG_ADDRESSES    "addresses"

### NM_IP_CONFIG_ROUTES

    #define NM_IP_CONFIG_ROUTES       "routes"

### NM_IP_CONFIG_NAMESERVERS

    #define NM_IP_CONFIG_NAMESERVERS  "nameservers"

### NM_IP_CONFIG_DOMAINS

    #define NM_IP_CONFIG_DOMAINS      "domains"

### NM_IP_CONFIG_SEARCHES

    #define NM_IP_CONFIG_SEARCHES     "searches"

### NM_IP_CONFIG_WINS_SERVERS

    #define NM_IP_CONFIG_WINS_SERVERS "wins-servers"

### NM_IP_CONFIG_CLAT_ADDRESS

    #define NM_IP_CONFIG_CLAT_ADDRESS "clat-address"

### NM_IP_CONFIG_CLAT_PREF64

    #define NM_IP_CONFIG_CLAT_PREF64  "clat-pref64"

### NMIPConfig

    typedef struct _NMIPConfig NMIPConfig;

## Property Details

### The `“addresses”` property

      “addresses”                GPtrArray *

A GPtrArray containing the addresses (NMIPAddress) of the configuration.

Owner: NMIPConfig

Flags: Read

### The `“clat-address”` property

      “clat-address”             char *

The IP address used by CLAT.

Owner: NMIPConfig

Flags: Read

Default value: NULL

Since: 1.58

### The `“clat-pref64”` property

      “clat-pref64”              char *

The NAT64 prefix used by CLAT.

Owner: NMIPConfig

Flags: Read

Default value: NULL

Since: 1.58

### The `“domains”` property

      “domains”                  GStrv

The array containing domain strings of the configuration.

Owner: NMIPConfig

Flags: Read

### The `“family”` property

      “family”                   int

The IP address family of the configuration; either `AF_INET` or `AF_INET6`.

Owner: NMIPConfig

Flags: Read

Allowed values: [0,255]

Default value: 0

### The `“gateway”` property

      “gateway”                  char *

The IP gateway address of the configuration as string.

Owner: NMIPConfig

Flags: Read

Default value: NULL

### The `“nameservers”` property

      “nameservers”              GStrv

The array containing name server IP addresses of the configuration.

Owner: NMIPConfig

Flags: Read

### The `“routes”` property

      “routes”                   GPtrArray *

A GPtrArray containing the routes (NMIPRoute) of the configuration.

[type GPtrArray(NMIPRoute)]

Owner: NMIPConfig

Flags: Read

### The `“searches”` property

      “searches”                 GStrv

The array containing DNS search strings of the configuration.

Owner: NMIPConfig

Flags: Read

### The `“wins-servers”` property

      “wins-servers”             GStrv

The array containing WINS server IP addresses of the configuration. (This will always be empty for IPv6 configurations.)

Owner: NMIPConfig

Flags: Read