mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git
synced 2026-01-08 14:10:23 +01:00
615221a99c
We use clang-format for automatic formatting of our source files. Since clang-format is actively maintained software, the actual formatting depends on the used version of clang-format. That is unfortunate and painful, but really unavoidable unless clang-format would be strictly bug-compatible. So the version that we must use is from the current Fedora release, which is also tested by our gitlab-ci. Previously, we were using Fedora 34 with clang-tools-extra-12.0.1-1.fc34.x86_64. As Fedora 35 comes along, we need to update our formatting as Fedora 35 comes with version "13.0.0~rc1-1.fc35". An alternative would be to freeze on version 12, but that has different problems (like, it's cumbersome to rebuild clang 12 on Fedora 35 and it would be cumbersome for our developers which are on Fedora 35 to use a clang that they cannot easily install). The (differently painful) solution is to reformat from time to time, as we switch to a new Fedora (and thus clang) version. Usually we would expect that such a reformatting brings minor changes. But this time, the changes are huge. That is mentioned in the release notes [1] as Makes PointerAligment: Right working with AlignConsecutiveDeclarations. (Fixes https://llvm.org/PR27353) [1] https://releases.llvm.org/13.0.0/tools/clang/docs/ReleaseNotes.html#clang-format
95 lines
3.8 KiB
C
95 lines
3.8 KiB
C
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#ifndef __DEVICES_NM_DEVICE_UTILS_H__
|
|
#define __DEVICES_NM_DEVICE_UTILS_H__
|
|
|
|
/*****************************************************************************/
|
|
|
|
const char *nm_device_state_to_string(NMDeviceState state);
|
|
const char *nm_device_state_reason_to_string(NMDeviceStateReason reason);
|
|
|
|
#define nm_device_state_reason_to_string_a(reason) \
|
|
NM_UTILS_LOOKUP_STR_A(nm_device_state_reason_to_string, reason)
|
|
|
|
static inline NMDeviceStateReason
|
|
nm_device_state_reason_check(NMDeviceStateReason reason)
|
|
{
|
|
/* the device-state-reason serves mostly informational purpose during a state
|
|
* change. In some cases however, decisions are made based on the reason.
|
|
* I tend to think that interpreting the state reason to derive some behaviors
|
|
* is confusing, because the cause and effect are so far apart.
|
|
*
|
|
* This function is here to mark source that inspects the reason to make
|
|
* a decision -- contrary to places that set the reason. Thus, by grepping
|
|
* for nm_device_state_reason_check() you can find the "effect" to a certain
|
|
* reason.
|
|
*/
|
|
return reason;
|
|
}
|
|
|
|
/*****************************************************************************/
|
|
|
|
#define NM_PENDING_ACTION_AUTOACTIVATE "autoactivate"
|
|
#define NM_PENDING_ACTION_IN_STATE_CHANGE "in-state-change"
|
|
#define NM_PENDING_ACTION_RECHECK_AVAILABLE "recheck-available"
|
|
#define NM_PENDING_ACTION_CARRIER_WAIT "carrier-wait"
|
|
#define NM_PENDING_ACTION_WAITING_FOR_SUPPLICANT "waiting-for-supplicant"
|
|
#define NM_PENDING_ACTION_WIFI_SCAN "wifi-scan"
|
|
#define NM_PENDING_ACTION_WAITING_FOR_COMPANION "waiting-for-companion"
|
|
#define NM_PENDING_ACTION_LINK_INIT "link-init"
|
|
|
|
#define NM_PENDING_ACTIONPREFIX_QUEUED_STATE_CHANGE "queued-state-change-"
|
|
#define NM_PENDING_ACTIONPREFIX_ACTIVATION "activation-"
|
|
|
|
const char *nm_device_state_queued_state_to_string(NMDeviceState state);
|
|
|
|
/*****************************************************************************/
|
|
|
|
typedef enum {
|
|
NM_DEVICE_MTU_SOURCE_NONE,
|
|
NM_DEVICE_MTU_SOURCE_PARENT,
|
|
NM_DEVICE_MTU_SOURCE_IP_CONFIG,
|
|
NM_DEVICE_MTU_SOURCE_CONNECTION,
|
|
} NMDeviceMtuSource;
|
|
|
|
const char *nm_device_mtu_source_to_string(NMDeviceMtuSource mtu_source);
|
|
|
|
/*****************************************************************************/
|
|
|
|
typedef enum _nm_packed {
|
|
NM_DEVICE_SYS_IFACE_STATE_EXTERNAL,
|
|
NM_DEVICE_SYS_IFACE_STATE_ASSUME,
|
|
NM_DEVICE_SYS_IFACE_STATE_MANAGED,
|
|
|
|
/* the REMOVED state applies when the device is manually set to unmanaged
|
|
* or the link was externally removed. In both cases, we move the device
|
|
* to UNMANAGED state, without touching the link -- be it, because the link
|
|
* is already gone or because we want to release it (give it up).
|
|
*/
|
|
NM_DEVICE_SYS_IFACE_STATE_REMOVED,
|
|
} NMDeviceSysIfaceState;
|
|
|
|
const char *nm_device_sys_iface_state_to_string(NMDeviceSysIfaceState sys_iface_state);
|
|
|
|
/*****************************************************************************/
|
|
|
|
typedef enum _nm_packed {
|
|
NM_DEVICE_IP_STATE_NONE,
|
|
NM_DEVICE_IP_STATE_PENDING,
|
|
NM_DEVICE_IP_STATE_READY,
|
|
NM_DEVICE_IP_STATE_FAILED,
|
|
} NMDeviceIPState;
|
|
|
|
const char *nm_device_ip_state_to_string(NMDeviceIPState ip_state);
|
|
|
|
/*****************************************************************************/
|
|
|
|
void nm_device_resolve_address(int addr_family,
|
|
gconstpointer address,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer cb_data);
|
|
|
|
char *nm_device_resolve_address_finish(GAsyncResult *result, GError **error);
|
|
|
|
#endif /* __DEVICES_NM_DEVICE_UTILS_H__ */
|