include/linux/dpll.h

File Facts

System

Linux kernel

Corpus path

include/linux/dpll.h

Extension

.h

Size

10682 bytes

Lines

324

Domain

Core OS

Bucket

Core Kernel Interface

Inferred role

Core OS: implementation source

Status

source implementation candidate

Why This File Exists

Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.

• Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• uapi/linux/dpll.h
• linux/device.h
• linux/netlink.h
• linux/netdevice.h
• linux/notifier.h
• linux/rtnetlink.h
• net/netlink.h

Detected Declarations

• struct dpll_device
• struct dpll_pin
• struct dpll_pin_esync
• struct fwnode_handle
• struct ref_tracker
• struct dpll_device_ops
• struct dpll_ffo_param
• struct dpll_pin_ops
• struct dpll_pin_frequency
• struct dpll_pin_phase_adjust_range
• struct dpll_pin_esync
• struct dpll_pin_properties
• struct dpll_device_notifier_info
• struct dpll_pin_notifier_info
• enum dpll_ffo_type
• function dpll_netdev_pin_handle_size
• function dpll_netdev_pin_set
• function dpll_netdev_add_pin_handle
• function fwnode_dpll_pin_find

Annotated Snippet

struct dpll_device_ops {
	int (*mode_get)(const struct dpll_device *dpll, void *dpll_priv,
			enum dpll_mode *mode, struct netlink_ext_ack *extack);
	int (*mode_set)(const struct dpll_device *dpll, void *dpll_priv,
			enum dpll_mode mode, struct netlink_ext_ack *extack);
	int (*supported_modes_get)(const struct dpll_device *dpll,
				   void *dpll_priv, unsigned long *modes,
				   struct netlink_ext_ack *extack);
	int (*lock_status_get)(const struct dpll_device *dpll, void *dpll_priv,
			       enum dpll_lock_status *status,
			       enum dpll_lock_status_error *status_error,
			       struct netlink_ext_ack *extack);
	int (*temp_get)(const struct dpll_device *dpll, void *dpll_priv,
			s32 *temp, struct netlink_ext_ack *extack);
	int (*clock_quality_level_get)(const struct dpll_device *dpll,
				       void *dpll_priv,
				       unsigned long *qls,
				       struct netlink_ext_ack *extack);
	int (*phase_offset_monitor_set)(const struct dpll_device *dpll,
					void *dpll_priv,
					enum dpll_feature_state state,
					struct netlink_ext_ack *extack);
	int (*phase_offset_monitor_get)(const struct dpll_device *dpll,
					void *dpll_priv,
					enum dpll_feature_state *state,
					struct netlink_ext_ack *extack);
	int (*phase_offset_avg_factor_set)(const struct dpll_device *dpll,
					   void *dpll_priv, u32 factor,
					   struct netlink_ext_ack *extack);
	int (*phase_offset_avg_factor_get)(const struct dpll_device *dpll,
					   void *dpll_priv, u32 *factor,
					   struct netlink_ext_ack *extack);
	int (*freq_monitor_set)(const struct dpll_device *dpll, void *dpll_priv,
				enum dpll_feature_state state,
				struct netlink_ext_ack *extack);
	int (*freq_monitor_get)(const struct dpll_device *dpll, void *dpll_priv,
				enum dpll_feature_state *state,
				struct netlink_ext_ack *extack);
};

enum dpll_ffo_type {
	DPLL_FFO_PORT_RXTX_RATE,
	DPLL_FFO_PIN_DEVICE,

	__DPLL_FFO_TYPE_MAX,
};

struct dpll_ffo_param {
	enum dpll_ffo_type type;
	s64 ffo;
};

struct dpll_pin_ops {
	unsigned long supported_ffo;
	int (*frequency_set)(const struct dpll_pin *pin, void *pin_priv,
			     const struct dpll_device *dpll, void *dpll_priv,
			     const u64 frequency,
			     struct netlink_ext_ack *extack);
	int (*frequency_get)(const struct dpll_pin *pin, void *pin_priv,
			     const struct dpll_device *dpll, void *dpll_priv,
			     u64 *frequency, struct netlink_ext_ack *extack);
	int (*direction_set)(const struct dpll_pin *pin, void *pin_priv,
			     const struct dpll_device *dpll, void *dpll_priv,
			     const enum dpll_pin_direction direction,
			     struct netlink_ext_ack *extack);
	int (*direction_get)(const struct dpll_pin *pin, void *pin_priv,
			     const struct dpll_device *dpll, void *dpll_priv,
			     enum dpll_pin_direction *direction,
			     struct netlink_ext_ack *extack);
	int (*state_on_pin_get)(const struct dpll_pin *pin, void *pin_priv,
				const struct dpll_pin *parent_pin,
				void *parent_pin_priv,
				enum dpll_pin_state *state,
				struct netlink_ext_ack *extack);
	int (*state_on_dpll_get)(const struct dpll_pin *pin, void *pin_priv,
				 const struct dpll_device *dpll,
				 void *dpll_priv, enum dpll_pin_state *state,
				 struct netlink_ext_ack *extack);
	int (*operstate_on_dpll_get)(const struct dpll_pin *pin,
				     void *pin_priv,
				     const struct dpll_device *dpll,
				     void *dpll_priv,
				     enum dpll_pin_operstate *operstate,
				     struct netlink_ext_ack *extack);
	int (*state_on_pin_set)(const struct dpll_pin *pin, void *pin_priv,
				const struct dpll_pin *parent_pin,
				void *parent_pin_priv,
				const enum dpll_pin_state state,
				struct netlink_ext_ack *extack);
	int (*state_on_dpll_set)(const struct dpll_pin *pin, void *pin_priv,

Annotation

• Immediate include surface: `uapi/linux/dpll.h`, `linux/device.h`, `linux/netlink.h`, `linux/netdevice.h`, `linux/notifier.h`, `linux/rtnetlink.h`, `net/netlink.h`.
• Detected declarations: `struct dpll_device`, `struct dpll_pin`, `struct dpll_pin_esync`, `struct fwnode_handle`, `struct ref_tracker`, `struct dpll_device_ops`, `struct dpll_ffo_param`, `struct dpll_pin_ops`, `struct dpll_pin_frequency`, `struct dpll_pin_phase_adjust_range`.
• Atlas domain: Core OS / Core Kernel Interface.
• Implementation status: source implementation candidate.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.