summaryrefslogtreecommitdiff
path: root/libnm-core/nm-setting-connection.h
blob: 6ade3c1a6bc130dc5539800325003d8e860596b4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
/* SPDX-License-Identifier: LGPL-2.1+ */
/*
 * Copyright (C) 2007 - 2014 Red Hat, Inc.
 * Copyright (C) 2007 - 2008 Novell, Inc.
 */

#ifndef __NM_SETTING_CONNECTION_H__
#define __NM_SETTING_CONNECTION_H__

#if !defined(__NETWORKMANAGER_H_INSIDE__) && !defined(NETWORKMANAGER_COMPILATION)
    #error "Only <NetworkManager.h> can be included directly."
#endif

#include "nm-setting.h"

G_BEGIN_DECLS

#define NM_TYPE_SETTING_CONNECTION (nm_setting_connection_get_type())
#define NM_SETTING_CONNECTION(obj) \
    (G_TYPE_CHECK_INSTANCE_CAST((obj), NM_TYPE_SETTING_CONNECTION, NMSettingConnection))
#define NM_SETTING_CONNECTION_CLASS(klass) \
    (G_TYPE_CHECK_CLASS_CAST((klass), NM_TYPE_SETTING_CONNECTION, NMSettingConnectionClass))
#define NM_IS_SETTING_CONNECTION(obj) \
    (G_TYPE_CHECK_INSTANCE_TYPE((obj), NM_TYPE_SETTING_CONNECTION))
#define NM_IS_SETTING_CONNECTION_CLASS(klass) \
    (G_TYPE_CHECK_CLASS_TYPE((klass), NM_TYPE_SETTING_CONNECTION))
#define NM_SETTING_CONNECTION_GET_CLASS(obj) \
    (G_TYPE_INSTANCE_GET_CLASS((obj), NM_TYPE_SETTING_CONNECTION, NMSettingConnectionClass))

#define NM_SETTING_CONNECTION_SETTING_NAME "connection"

#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MIN     -999
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_MAX     999
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY_DEFAULT 0

#define NM_SETTING_CONNECTION_ID                   "id"
#define NM_SETTING_CONNECTION_UUID                 "uuid"
#define NM_SETTING_CONNECTION_STABLE_ID            "stable-id"
#define NM_SETTING_CONNECTION_INTERFACE_NAME       "interface-name"
#define NM_SETTING_CONNECTION_TYPE                 "type"
#define NM_SETTING_CONNECTION_AUTOCONNECT          "autoconnect"
#define NM_SETTING_CONNECTION_AUTOCONNECT_PRIORITY "autoconnect-priority"
#define NM_SETTING_CONNECTION_AUTOCONNECT_RETRIES  "autoconnect-retries"
#define NM_SETTING_CONNECTION_MULTI_CONNECT        "multi-connect"
#define NM_SETTING_CONNECTION_TIMESTAMP            "timestamp"
#define NM_SETTING_CONNECTION_READ_ONLY            "read-only"
#define NM_SETTING_CONNECTION_PERMISSIONS          "permissions"
#define NM_SETTING_CONNECTION_ZONE                 "zone"
#define NM_SETTING_CONNECTION_MASTER               "master"
#define NM_SETTING_CONNECTION_SLAVE_TYPE           "slave-type"
#define NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES   "autoconnect-slaves"
#define NM_SETTING_CONNECTION_SECONDARIES          "secondaries"
#define NM_SETTING_CONNECTION_GATEWAY_PING_TIMEOUT "gateway-ping-timeout"
#define NM_SETTING_CONNECTION_METERED              "metered"
#define NM_SETTING_CONNECTION_LLDP                 "lldp"
#define NM_SETTING_CONNECTION_AUTH_RETRIES         "auth-retries"
#define NM_SETTING_CONNECTION_MDNS                 "mdns"
#define NM_SETTING_CONNECTION_LLMNR                "llmnr"
#define NM_SETTING_CONNECTION_WAIT_DEVICE_TIMEOUT  "wait-device-timeout"
#define NM_SETTING_CONNECTION_MUD_URL              "mud-url"

/* Types for property values */
/**
 * NMSettingConnectionAutoconnectSlaves:
 * @NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT: default value
 * @NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_NO: slaves are not brought up when
 *   master is activated
 * @NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_YES: slaves are brought up when
 *   master is activated
 *
 * #NMSettingConnectionAutoconnectSlaves values indicate whether slave connections
 * should be activated when master is activated.
 */
typedef enum {
    NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_DEFAULT = -1,
    NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_NO      = 0,
    NM_SETTING_CONNECTION_AUTOCONNECT_SLAVES_YES     = 1,
} NMSettingConnectionAutoconnectSlaves;

/**
 * NMSettingConnectionLldp:
 * @NM_SETTING_CONNECTION_LLDP_DEFAULT: default value
 * @NM_SETTING_CONNECTION_LLDP_DISABLE: disable LLDP
 * @NM_SETTING_CONNECTION_LLDP_ENABLE_RX: enable reception of LLDP frames
 *
 * #NMSettingConnectionLldp values indicate whether LLDP should be enabled.
 */
typedef enum {
    NM_SETTING_CONNECTION_LLDP_DEFAULT   = -1,
    NM_SETTING_CONNECTION_LLDP_DISABLE   = 0,
    NM_SETTING_CONNECTION_LLDP_ENABLE_RX = 1,
} NMSettingConnectionLldp;

/**
 * NMSettingConnectionMdns:
 * @NM_SETTING_CONNECTION_MDNS_DEFAULT: default value
 * @NM_SETTING_CONNECTION_MDNS_NO: disable mDNS
 * @NM_SETTING_CONNECTION_MDNS_RESOLVE: support only resolving, do not register hostname
 * @NM_SETTING_CONNECTION_MDNS_YES: enable mDNS
 *
 * #NMSettingConnectionMdns values indicate whether mDNS should be enabled.
 *
 * Since: 1.12
 */
typedef enum {
    NM_SETTING_CONNECTION_MDNS_DEFAULT = -1,
    NM_SETTING_CONNECTION_MDNS_NO      = 0,
    NM_SETTING_CONNECTION_MDNS_RESOLVE = 1,
    NM_SETTING_CONNECTION_MDNS_YES     = 2,
} NMSettingConnectionMdns;

/**
 * NMSettingConnectionLlmnr:
 * @NM_SETTING_CONNECTION_LLMNR_DEFAULT: default value
 * @NM_SETTING_CONNECTION_LLMNR_NO: disable LLMNR
 * @NM_SETTING_CONNECTION_LLMNR_RESOLVE: support only resolving, do not register hostname
 * @NM_SETTING_CONNECTION_LLMNR_YES: enable LLMNR
 *
 * #NMSettingConnectionLlmnr values indicate whether LLMNR should be enabled.
 *
 * Since: 1.14
 */
typedef enum {
    NM_SETTING_CONNECTION_LLMNR_DEFAULT = -1,
    NM_SETTING_CONNECTION_LLMNR_NO      = 0,
    NM_SETTING_CONNECTION_LLMNR_RESOLVE = 1,
    NM_SETTING_CONNECTION_LLMNR_YES     = 2,
} NMSettingConnectionLlmnr;

/**
 * NMSettingConnection:
 *
 * General Connection Profile Settings
 */
struct _NMSettingConnection {
    NMSetting parent;
};

typedef struct {
    NMSettingClass parent;

    /*< private >*/
    gpointer padding[4];
} NMSettingConnectionClass;

GType nm_setting_connection_get_type(void);

NMSetting * nm_setting_connection_new(void);
const char *nm_setting_connection_get_id(NMSettingConnection *setting);
const char *nm_setting_connection_get_uuid(NMSettingConnection *setting);
NM_AVAILABLE_IN_1_4
const char *nm_setting_connection_get_stable_id(NMSettingConnection *setting);
const char *nm_setting_connection_get_interface_name(NMSettingConnection *setting);
const char *nm_setting_connection_get_connection_type(NMSettingConnection *setting);
gboolean    nm_setting_connection_get_autoconnect(NMSettingConnection *setting);
int         nm_setting_connection_get_autoconnect_priority(NMSettingConnection *setting);
NM_AVAILABLE_IN_1_6
int nm_setting_connection_get_autoconnect_retries(NMSettingConnection *setting);
NM_AVAILABLE_IN_1_14
NMConnectionMultiConnect nm_setting_connection_get_multi_connect(NMSettingConnection *setting);
guint64                  nm_setting_connection_get_timestamp(NMSettingConnection *setting);
gboolean                 nm_setting_connection_get_read_only(NMSettingConnection *setting);

guint32     nm_setting_connection_get_num_permissions(NMSettingConnection *setting);
gboolean    nm_setting_connection_get_permission(NMSettingConnection *setting,
                                                 guint32              idx,
                                                 const char **        out_ptype,
                                                 const char **        out_pitem,
                                                 const char **        out_detail);
const char *nm_setting_connection_get_zone(NMSettingConnection *setting);
gboolean    nm_setting_connection_permissions_user_allowed(NMSettingConnection *setting,
                                                           const char *         uname);
gboolean    nm_setting_connection_add_permission(NMSettingConnection *setting,
                                                 const char *         ptype,
                                                 const char *         pitem,
                                                 const char *         detail);
void        nm_setting_connection_remove_permission(NMSettingConnection *setting, guint32 idx);
gboolean    nm_setting_connection_remove_permission_by_value(NMSettingConnection *setting,
                                                             const char *         ptype,
                                                             const char *         pitem,
                                                             const char *         detail);

const char *nm_setting_connection_get_master(NMSettingConnection *setting);
gboolean    nm_setting_connection_is_slave_type(NMSettingConnection *setting, const char *type);
const char *nm_setting_connection_get_slave_type(NMSettingConnection *setting);
NM_AVAILABLE_IN_1_2
NMSettingConnectionAutoconnectSlaves
nm_setting_connection_get_autoconnect_slaves(NMSettingConnection *setting);

guint32     nm_setting_connection_get_num_secondaries(NMSettingConnection *setting);
const char *nm_setting_connection_get_secondary(NMSettingConnection *setting, guint32 idx);
gboolean    nm_setting_connection_add_secondary(NMSettingConnection *setting, const char *sec_uuid);
void        nm_setting_connection_remove_secondary(NMSettingConnection *setting, guint32 idx);
gboolean    nm_setting_connection_remove_secondary_by_value(NMSettingConnection *setting,
                                                            const char *         sec_uuid);

guint32 nm_setting_connection_get_gateway_ping_timeout(NMSettingConnection *setting);
NM_AVAILABLE_IN_1_2
NMMetered nm_setting_connection_get_metered(NMSettingConnection *setting);
NM_AVAILABLE_IN_1_2
NMSettingConnectionLldp nm_setting_connection_get_lldp(NMSettingConnection *setting);

NM_AVAILABLE_IN_1_10
int nm_setting_connection_get_auth_retries(NMSettingConnection *setting);

NM_AVAILABLE_IN_1_12
NMSettingConnectionMdns nm_setting_connection_get_mdns(NMSettingConnection *setting);
NM_AVAILABLE_IN_1_14
NMSettingConnectionLlmnr nm_setting_connection_get_llmnr(NMSettingConnection *setting);

NM_AVAILABLE_IN_1_20
gint32 nm_setting_connection_get_wait_device_timeout(NMSettingConnection *setting);

NM_AVAILABLE_IN_1_26
const char *nm_setting_connection_get_mud_url(NMSettingConnection *setting);

G_END_DECLS

#endif /* __NM_SETTING_CONNECTION_H__ */