mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager
synced 2024-07-22 02:35:25 +00:00
e1c7a2b5d0
We commonly don't use the glib typedefs for char/short/int/long,
but their C types directly.
$ git grep '\<g\(char\|short\|int\|long\|float\|double\)\>' | wc -l
587
$ git grep '\<\(char\|short\|int\|long\|float\|double\)\>' | wc -l
21114
One could argue that using the glib typedefs is preferable in
public API (of our glib based libnm library) or where it clearly
is related to glib, like during
g_object_set (obj, PROPERTY, (gint) value, NULL);
However, that argument does not seem strong, because in practice we don't
follow that argument today, and seldomly use the glib typedefs.
Also, the style guide for this would be hard to formalize, because
"using them where clearly related to a glib" is a very loose suggestion.
Also note that glib typedefs will always just be typedefs of the
underlying C types. There is no danger of glib changing the meaning
of these typedefs (because that would be a major API break of glib).
A simple style guide is instead: don't use these typedefs.
No manual actions, I only ran the bash script:
FILES=($(git ls-files '*.[hc]'))
sed -i \
-e 's/\<g\(char\|short\|int\|long\|float\|double\)\>\( [^ ]\)/\1\2/g' \
-e 's/\<g\(char\|short\|int\|long\|float\|double\)\> /\1 /g' \
-e 's/\<g\(char\|short\|int\|long\|float\|double\)\>/\1/g' \
"${FILES[@]}"
126 lines
5.9 KiB
C
126 lines
5.9 KiB
C
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
|
|
/*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301 USA.
|
|
*
|
|
* Copyright 2011 Red Hat, Inc.
|
|
*/
|
|
|
|
#ifndef NM_SETTING_PRIVATE_H
|
|
#define NM_SETTING_PRIVATE_H
|
|
|
|
#include "nm-connection.h"
|
|
|
|
#define NM_SETTING_SECRET_FLAGS_ALL \
|
|
(NM_SETTING_SECRET_FLAG_NONE | \
|
|
NM_SETTING_SECRET_FLAG_AGENT_OWNED | \
|
|
NM_SETTING_SECRET_FLAG_NOT_SAVED | \
|
|
NM_SETTING_SECRET_FLAG_NOT_REQUIRED)
|
|
|
|
/**
|
|
* NMSettingVerifyResult:
|
|
* @NM_SETTING_VERIFY_SUCCESS: the setting verifies successfully
|
|
* @NM_SETTING_VERIFY_ERROR: the setting has a serious misconfiguration
|
|
* @NM_SETTING_VERIFY_NORMALIZABLE: the setting is valid but has properties
|
|
* that should be normalized
|
|
* @NM_SETTING_VERIFY_NORMALIZABLE_ERROR: the setting is invalid but the
|
|
* errors can be fixed by nm_connection_normalize().
|
|
*/
|
|
typedef enum {
|
|
NM_SETTING_VERIFY_SUCCESS = TRUE,
|
|
NM_SETTING_VERIFY_ERROR = FALSE,
|
|
NM_SETTING_VERIFY_NORMALIZABLE = 2,
|
|
NM_SETTING_VERIFY_NORMALIZABLE_ERROR = 3,
|
|
} NMSettingVerifyResult;
|
|
|
|
void _nm_register_setting (const char *name,
|
|
const GType type,
|
|
const guint32 priority,
|
|
const GQuark error_quark);
|
|
|
|
/* Ensure, that name is a compile time constant string. Put the function name in parenthesis to suppress expansion. */
|
|
#define _nm_register_setting(name, type, priority, error_quark) _nm_register_setting ((name ""), type, priority, error_quark)
|
|
|
|
gboolean _nm_setting_is_base_type (NMSetting *setting);
|
|
gboolean _nm_setting_type_is_base_type (GType type);
|
|
guint32 _nm_setting_get_setting_priority (NMSetting *setting);
|
|
GType _nm_setting_lookup_setting_type (const char *name);
|
|
GType _nm_setting_lookup_setting_type_by_quark (GQuark error_quark);
|
|
int _nm_setting_compare_priority (gconstpointer a, gconstpointer b);
|
|
|
|
gboolean _nm_setting_get_property (NMSetting *setting, const char *name, GValue *value);
|
|
|
|
NMConnection *_nm_connection_new_from_hash (GHashTable *hash);
|
|
void _nm_connection_replace_settings (NMConnection *connection,
|
|
GHashTable *new_settings);
|
|
|
|
typedef enum NMSettingUpdateSecretResult {
|
|
NM_SETTING_UPDATE_SECRET_ERROR = FALSE,
|
|
NM_SETTING_UPDATE_SECRET_SUCCESS_MODIFIED = TRUE,
|
|
NM_SETTING_UPDATE_SECRET_SUCCESS_UNCHANGED = 2,
|
|
} NMSettingUpdateSecretResult;
|
|
|
|
NMSettingUpdateSecretResult _nm_setting_update_secrets (NMSetting *setting,
|
|
GHashTable *secrets,
|
|
GError **error);
|
|
gboolean _nm_setting_clear_secrets (NMSetting *setting);
|
|
gboolean _nm_setting_clear_secrets_with_flags (NMSetting *setting,
|
|
NMSettingClearSecretsWithFlagsFn func,
|
|
gpointer user_data);
|
|
|
|
/* NM_SETTING_COMPARE_FLAG_INFERRABLE: check whether a device-generated
|
|
* connection can be replaced by a already-defined connection. This flag only
|
|
* takes into account properties marked with the %NM_SETTING_PARAM_INFERRABLE
|
|
* flag.
|
|
*/
|
|
#define NM_SETTING_COMPARE_FLAG_INFERRABLE 0x80000000
|
|
|
|
/* The property of the #NMSetting should be considered during comparisons that
|
|
* use the %NM_SETTING_COMPARE_FLAG_INFERRABLE flag. Properties that don't have
|
|
* this flag, are ignored when doing an infrerrable comparison. This flag should
|
|
* be set on all properties that are read from the kernel or the system when a
|
|
* connection is generated. eg, IP addresses/routes can be read from the
|
|
* kernel, but the 'autoconnect' property cannot, so
|
|
* %NM_SETTING_IP4_CONFIG_ADDRESSES gets the INFERRABLE flag, but
|
|
* %NM_SETTING_CONNECTION_AUTOCONNECT would not.
|
|
*
|
|
* This flag should not be used with properties where the default cannot be
|
|
* read separately from the current value, like MTU or wired duplex mode.
|
|
*/
|
|
#define NM_SETTING_PARAM_INFERRABLE (1 << (4 + G_PARAM_USER_SHIFT))
|
|
|
|
/* Ensure the setting's GType is registered at library load time */
|
|
#define NM_SETTING_REGISTER_TYPE(x) \
|
|
static void __attribute__((constructor)) register_setting (void) \
|
|
{ g_type_ensure (x); }
|
|
|
|
NMSetting *nm_setting_find_in_list (GSList *settings_list, const char *setting_name);
|
|
|
|
NMSettingVerifyResult _nm_setting_verify_deprecated_virtual_iface_name (const char *interface_name,
|
|
gboolean allow_missing,
|
|
const char *setting_name,
|
|
const char *setting_property,
|
|
GQuark error_quark,
|
|
int e_invalid_property,
|
|
int e_missing_property,
|
|
GSList *all_settings,
|
|
GError **error);
|
|
|
|
NMSettingVerifyResult _nm_setting_verify (NMSetting *setting,
|
|
GSList *all_settings,
|
|
GError **error);
|
|
|
|
#endif /* NM_SETTING_PRIVATE_H */
|