NMSimpleConnection: libnm Reference Manual

## NMSimpleConnection NMSimpleConnection — An unmanaged connection |

## Functions

NMConnection * | nm_simple_connection_new ()
NMConnection * | nm_simple_connection_new_from_dbus ()
NMConnection * | nm_simple_connection_new_clone ()

## Types and Values

| NMSimpleConnection

## Object Hierarchy

        GObject
        ╰── NMSimpleConnection

## Implemented Interfaces

NMSimpleConnection implements NMConnection.

## Description

An NMSimpleConnection does not directly represent a D-Bus-exported connection, but might be used in the process of creating a new one.

## Functions

### nm_simple_connection_new ()

    NMConnection *
    nm_simple_connection_new (void);

Creates a new NMSimpleConnection object with no NMSetting objects.

#### Returns

the new empty NMConnection object.

[transfer full]

### nm_simple_connection_new_from_dbus ()

    NMConnection *
    nm_simple_connection_new_from_dbus (GVariant *dict,
                                        GError **error);

Creates a new NMSimpleConnection from a hash table describing the connection and normalize the connection. See `nm_connection_to_dbus()` for a description of the expected hash table.

#### Parameters

dict | a GVariant of type `NM_VARIANT_TYPE_CONNECTION` describing the connection |
error | on unsuccessful return, an error |

#### Returns

the new NMSimpleConnection object, populated with settings created from the values in the hash table, or `NULL` if the connection failed to normalize.

[transfer full]

### nm_simple_connection_new_clone ()

    NMConnection *
    nm_simple_connection_new_clone (NMConnection *connection);

Clones an NMConnection as an NMSimpleConnection.

#### Parameters

connection | the NMConnection to clone |

#### Returns

a new NMConnection containing the same settings and properties as the source NMConnection.

[transfer full]

## Types and Values

### NMSimpleConnection

    typedef struct _NMSimpleConnection NMSimpleConnection;