#include <Library/ArmGicArchLib.h>

Macros
#define	ARM_GIC_ICDDCR 0x000

#define	ARM_GIC_ICDICTR 0x004

#define	ARM_GIC_ICDIIDR 0x008

#define	ARM_GIC_ICDISR 0x080

#define	ARM_GIC_ICDISER 0x100

#define	ARM_GIC_ICDICER 0x180

#define	ARM_GIC_ICDSPR 0x200

#define	ARM_GIC_ICDICPR 0x280

#define	ARM_GIC_ICDABR 0x300

#define	ARM_GIC_ICDIPR 0x400

#define	ARM_GIC_ICDIPTR 0x800

#define	ARM_GIC_ICDICFR 0xC00

#define	ARM_GIC_ICDPPISR 0xD00

#define	ARM_GIC_ICDSGIR 0xF00

#define	ARM_GICD_IROUTER 0x6100

#define	ARM_GIC_ICDDCR_ARE (1 << 4)

#define	ARM_GIC_ICDDCR_DS (1 << 6)

#define	ARM_GIC_ICDICFR_WIDTH 32

#define	ARM_GIC_ICDICFR_BYTES (ARM_GIC_ICDICFR_WIDTH / 8)

#define	ARM_GIC_ICDICFR_F_WIDTH 2

#define	ARM_GIC_ICDICFR_F_STRIDE 16

#define	ARM_GIC_ICDICFR_F_CONFIG1_BIT 1

#define	ARM_GIC_ICDICFR_LEVEL_TRIGGERED 0x0

#define	ARM_GIC_ICDICFR_EDGE_TRIGGERED 0x1

#define	ARM_GICR_CTLR_FRAME_SIZE SIZE_64KB

#define	ARM_GICR_SGI_PPI_FRAME_SIZE SIZE_64KB

#define	ARM_GICR_SGI_VLPI_FRAME_SIZE SIZE_64KB

#define	ARM_GICR_SGI_RESERVED_FRAME_SIZE SIZE_64KB

#define	ARM_GICR_TYPER 0x0008

#define	ARM_GICR_TYPER_PLPIS (1 << 0)

#define	ARM_GICR_TYPER_VLPIS (1 << 1)

#define	ARM_GICR_TYPER_DIRECTLPI (1 << 3)

#define	ARM_GICR_TYPER_LAST (1 << 4)

#define	ARM_GICR_TYPER_DPGS (1 << 5)

#define	ARM_GICR_TYPER_PROCNO (0xFFFF << 8)

#define	ARM_GICR_TYPER_COMMONLPIAFF (0x3 << 24)

#define	ARM_GICR_TYPER_AFFINITY (0xFFFFFFFFULL << 32)

#define	ARM_GICR_TYPER_GET_AFFINITY(TypeReg)

#define	ARM_GICR_ISENABLER 0x0100

#define	ARM_GICR_ICENABLER 0x0180

#define	ARM_GIC_ICCICR 0x00

#define	ARM_GIC_ICCPMR 0x04

#define	ARM_GIC_ICCBPR 0x08

#define	ARM_GIC_ICCIAR 0x0C

#define	ARM_GIC_ICCEIOR 0x10

#define	ARM_GIC_ICCRPR 0x14

#define	ARM_GIC_ICCPIR 0x18

#define	ARM_GIC_ICCABPR 0x1C

#define	ARM_GIC_ICCIIDR 0xFC

#define	ARM_GIC_ICDSGIR_FILTER_TARGETLIST 0x0

#define	ARM_GIC_ICDSGIR_FILTER_EVERYONEELSE 0x1

#define	ARM_GIC_ICDSGIR_FILTER_ITSELF 0x2

#define	ARM_GIC_ICCICR_ENABLE_SECURE 0x01

#define	ARM_GIC_ICCICR_ENABLE_NS 0x02

#define	ARM_GIC_ICCICR_ACK_CTL 0x04

#define	ARM_GIC_ICCICR_SIGNAL_SECURE_TO_FIQ 0x08

#define	ARM_GIC_ICCICR_USE_SBPR 0x10

#define	ARM_GIC_ICCIIDR_GET_PRODUCT_ID(IccIidr) (((IccIidr) >> 20) & 0xFFF)

#define	ARM_GIC_ICCIIDR_GET_ARCH_VERSION(IccIidr) (((IccIidr) >> 16) & 0xF)

#define	ARM_GIC_ICCIIDR_GET_REVISION(IccIidr) (((IccIidr) >> 12) & 0xF)

#define	ARM_GIC_ICCIIDR_GET_IMPLEMENTER(IccIidr) ((IccIidr) & 0xFFF)

#define	ARM_GIC_ICCIAR_ACKINTID 0x3FF

#define	ARM_GIC_IS_SPECIAL_INTERRUPTS(Interrupt) (((Interrupt) >= 1020) && ((Interrupt) <= 1023))

#define	ICC_SRE_EL2_SRE (1 << 0)

#define	ARM_GICD_IROUTER_IRM BIT31

Functions
UINT32 EFIAPI	ArmGicGetInterfaceIdentification (IN UINTN GicInterruptInterfaceBase)

VOID EFIAPI	ArmGicSetupNonSecure (IN UINTN MpId, IN UINTN GicDistributorBase, IN UINTN GicInterruptInterfaceBase)

VOID EFIAPI	ArmGicSetSecureInterrupts (IN UINTN GicDistributorBase, IN UINTN *GicSecureInterruptMask, IN UINTN GicSecureInterruptMaskSize)

VOID EFIAPI	ArmGicEnableInterruptInterface (IN UINTN GicInterruptInterfaceBase)

VOID EFIAPI	ArmGicDisableInterruptInterface (IN UINTN GicInterruptInterfaceBase)

VOID EFIAPI	ArmGicEnableDistributor (IN UINTN GicDistributorBase)

VOID EFIAPI	ArmGicDisableDistributor (IN UINTN GicDistributorBase)

UINTN EFIAPI	ArmGicGetMaxNumInterrupts (IN UINTN GicDistributorBase)

VOID EFIAPI	ArmGicSendSgiTo (IN UINTN GicDistributorBase, IN UINT8 TargetListFilter, IN UINT8 CPUTargetList, IN UINT8 SgiId)

UINTN EFIAPI	ArmGicAcknowledgeInterrupt (IN UINTN GicInterruptInterfaceBase, OUT UINTN *InterruptId)

VOID EFIAPI	ArmGicEndOfInterrupt (IN UINTN GicInterruptInterfaceBase, IN UINTN Source)

UINTN EFIAPI	ArmGicSetPriorityMask (IN UINTN GicInterruptInterfaceBase, IN INTN PriorityMask)

VOID EFIAPI	ArmGicSetInterruptPriority (IN UINTN GicDistributorBase, IN UINTN GicRedistributorBase, IN UINTN Source, IN UINT32 Priority)

VOID EFIAPI	ArmGicEnableInterrupt (IN UINTN GicDistributorBase, IN UINTN GicRedistributorBase, IN UINTN Source)

VOID EFIAPI	ArmGicDisableInterrupt (IN UINTN GicDistributorBase, IN UINTN GicRedistributorBase, IN UINTN Source)

BOOLEAN EFIAPI	ArmGicIsInterruptEnabled (IN UINTN GicDistributorBase, IN UINTN GicRedistributorBase, IN UINTN Source)

VOID EFIAPI	ArmGicV2SetupNonSecure (IN UINTN MpId, IN UINTN GicDistributorBase, IN UINTN GicInterruptInterfaceBase)

VOID EFIAPI	ArmGicV2EnableInterruptInterface (IN UINTN GicInterruptInterfaceBase)

VOID EFIAPI	ArmGicV2DisableInterruptInterface (IN UINTN GicInterruptInterfaceBase)

UINTN EFIAPI	ArmGicV2AcknowledgeInterrupt (IN UINTN GicInterruptInterfaceBase)

VOID EFIAPI	ArmGicV2EndOfInterrupt (IN UINTN GicInterruptInterfaceBase, IN UINTN Source)

UINT32 EFIAPI	ArmGicV3GetControlSystemRegisterEnable (VOID)

VOID EFIAPI	ArmGicV3SetControlSystemRegisterEnable (IN UINT32 ControlSystemRegisterEnable)

VOID EFIAPI	ArmGicV3EnableInterruptInterface (VOID)

VOID EFIAPI	ArmGicV3DisableInterruptInterface (VOID)

UINTN EFIAPI	ArmGicV3AcknowledgeInterrupt (VOID)

VOID EFIAPI	ArmGicV3EndOfInterrupt (IN UINTN Source)

VOID	ArmGicV3SetBinaryPointer (IN UINTN BinaryPoint)

VOID	ArmGicV3SetPriorityMask (IN UINTN Priority)

Detailed Description

SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file ArmGicLib.h.

Macro Definition Documentation

◆ ARM_GIC_ICCABPR

#define ARM_GIC_ICCABPR 0x1C

Definition at line 90 of file ArmGicLib.h.

◆ ARM_GIC_ICCBPR

#define ARM_GIC_ICCBPR 0x08

Definition at line 85 of file ArmGicLib.h.

◆ ARM_GIC_ICCEIOR

#define ARM_GIC_ICCEIOR 0x10

Definition at line 87 of file ArmGicLib.h.

◆ ARM_GIC_ICCIAR

#define ARM_GIC_ICCIAR 0x0C

Definition at line 86 of file ArmGicLib.h.

◆ ARM_GIC_ICCIAR_ACKINTID

#define ARM_GIC_ICCIAR_ACKINTID 0x3FF

Definition at line 111 of file ArmGicLib.h.

◆ ARM_GIC_ICCICR

#define ARM_GIC_ICCICR 0x00

Definition at line 83 of file ArmGicLib.h.

◆ ARM_GIC_ICCICR_ACK_CTL

#define ARM_GIC_ICCICR_ACK_CTL 0x04

Definition at line 100 of file ArmGicLib.h.

◆ ARM_GIC_ICCICR_ENABLE_NS

#define ARM_GIC_ICCICR_ENABLE_NS 0x02

Definition at line 99 of file ArmGicLib.h.

◆ ARM_GIC_ICCICR_ENABLE_SECURE

#define ARM_GIC_ICCICR_ENABLE_SECURE 0x01

Definition at line 98 of file ArmGicLib.h.

◆ ARM_GIC_ICCICR_SIGNAL_SECURE_TO_FIQ

#define ARM_GIC_ICCICR_SIGNAL_SECURE_TO_FIQ 0x08

Definition at line 101 of file ArmGicLib.h.

◆ ARM_GIC_ICCICR_USE_SBPR

#define ARM_GIC_ICCICR_USE_SBPR 0x10

Definition at line 102 of file ArmGicLib.h.

◆ ARM_GIC_ICCIIDR

#define ARM_GIC_ICCIIDR 0xFC

Definition at line 91 of file ArmGicLib.h.

◆ ARM_GIC_ICCIIDR_GET_ARCH_VERSION

#define ARM_GIC_ICCIIDR_GET_ARCH_VERSION ( IccIidr ) (((IccIidr) >> 16) & 0xF)

Definition at line 106 of file ArmGicLib.h.

◆ ARM_GIC_ICCIIDR_GET_IMPLEMENTER

#define ARM_GIC_ICCIIDR_GET_IMPLEMENTER ( IccIidr ) ((IccIidr) & 0xFFF)

Definition at line 108 of file ArmGicLib.h.

◆ ARM_GIC_ICCIIDR_GET_PRODUCT_ID

#define ARM_GIC_ICCIIDR_GET_PRODUCT_ID ( IccIidr ) (((IccIidr) >> 20) & 0xFFF)

Definition at line 105 of file ArmGicLib.h.

◆ ARM_GIC_ICCIIDR_GET_REVISION

#define ARM_GIC_ICCIIDR_GET_REVISION ( IccIidr ) (((IccIidr) >> 12) & 0xF)

Definition at line 107 of file ArmGicLib.h.

◆ ARM_GIC_ICCPIR

#define ARM_GIC_ICCPIR 0x18

Definition at line 89 of file ArmGicLib.h.

◆ ARM_GIC_ICCPMR

#define ARM_GIC_ICCPMR 0x04

Definition at line 84 of file ArmGicLib.h.

◆ ARM_GIC_ICCRPR

#define ARM_GIC_ICCRPR 0x14

Definition at line 88 of file ArmGicLib.h.

◆ ARM_GIC_ICDABR

#define ARM_GIC_ICDABR 0x300

Definition at line 25 of file ArmGicLib.h.

◆ ARM_GIC_ICDDCR

#define ARM_GIC_ICDDCR 0x000

Definition at line 15 of file ArmGicLib.h.

◆ ARM_GIC_ICDDCR_ARE

#define ARM_GIC_ICDDCR_ARE (1 << 4)

Definition at line 43 of file ArmGicLib.h.

◆ ARM_GIC_ICDDCR_DS

#define ARM_GIC_ICDDCR_DS (1 << 6)

Definition at line 44 of file ArmGicLib.h.

◆ ARM_GIC_ICDICER

#define ARM_GIC_ICDICER 0x180

Definition at line 22 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR

#define ARM_GIC_ICDICFR 0xC00

Definition at line 32 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR_BYTES

#define ARM_GIC_ICDICFR_BYTES (ARM_GIC_ICDICFR_WIDTH / 8)

Definition at line 48 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR_EDGE_TRIGGERED

#define ARM_GIC_ICDICFR_EDGE_TRIGGERED 0x1

Definition at line 53 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR_F_CONFIG1_BIT

#define ARM_GIC_ICDICFR_F_CONFIG1_BIT 1

Definition at line 51 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR_F_STRIDE

#define ARM_GIC_ICDICFR_F_STRIDE 16

Definition at line 50 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR_F_WIDTH

#define ARM_GIC_ICDICFR_F_WIDTH 2

Definition at line 49 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR_LEVEL_TRIGGERED

#define ARM_GIC_ICDICFR_LEVEL_TRIGGERED 0x0

Definition at line 52 of file ArmGicLib.h.

◆ ARM_GIC_ICDICFR_WIDTH

#define ARM_GIC_ICDICFR_WIDTH 32

Definition at line 47 of file ArmGicLib.h.

◆ ARM_GIC_ICDICPR

#define ARM_GIC_ICDICPR 0x280

Definition at line 24 of file ArmGicLib.h.

◆ ARM_GIC_ICDICTR

#define ARM_GIC_ICDICTR 0x004

Definition at line 16 of file ArmGicLib.h.

◆ ARM_GIC_ICDIIDR

#define ARM_GIC_ICDIIDR 0x008

Definition at line 17 of file ArmGicLib.h.

◆ ARM_GIC_ICDIPR

#define ARM_GIC_ICDIPR 0x400

Definition at line 28 of file ArmGicLib.h.

◆ ARM_GIC_ICDIPTR

#define ARM_GIC_ICDIPTR 0x800

Definition at line 31 of file ArmGicLib.h.

◆ ARM_GIC_ICDISER

#define ARM_GIC_ICDISER 0x100

Definition at line 21 of file ArmGicLib.h.

◆ ARM_GIC_ICDISR

#define ARM_GIC_ICDISR 0x080

Definition at line 20 of file ArmGicLib.h.

◆ ARM_GIC_ICDPPISR

#define ARM_GIC_ICDPPISR 0xD00

Definition at line 34 of file ArmGicLib.h.

◆ ARM_GIC_ICDSGIR

#define ARM_GIC_ICDSGIR 0xF00

Definition at line 37 of file ArmGicLib.h.

◆ ARM_GIC_ICDSGIR_FILTER_EVERYONEELSE

#define ARM_GIC_ICDSGIR_FILTER_EVERYONEELSE 0x1

Definition at line 94 of file ArmGicLib.h.

◆ ARM_GIC_ICDSGIR_FILTER_ITSELF

#define ARM_GIC_ICDSGIR_FILTER_ITSELF 0x2

Definition at line 95 of file ArmGicLib.h.

◆ ARM_GIC_ICDSGIR_FILTER_TARGETLIST

#define ARM_GIC_ICDSGIR_FILTER_TARGETLIST 0x0

Definition at line 93 of file ArmGicLib.h.

◆ ARM_GIC_ICDSPR

#define ARM_GIC_ICDSPR 0x200

Definition at line 23 of file ArmGicLib.h.

◆ ARM_GIC_IS_SPECIAL_INTERRUPTS

#define ARM_GIC_IS_SPECIAL_INTERRUPTS ( Interrupt ) (((Interrupt) >= 1020) && ((Interrupt) <= 1023))

Definition at line 247 of file ArmGicLib.h.

◆ ARM_GICD_IROUTER

#define ARM_GICD_IROUTER 0x6100

Definition at line 40 of file ArmGicLib.h.

◆ ARM_GICD_IROUTER_IRM

#define ARM_GICD_IROUTER_IRM BIT31

Definition at line 287 of file ArmGicLib.h.

◆ ARM_GICR_CTLR_FRAME_SIZE

#define ARM_GICR_CTLR_FRAME_SIZE SIZE_64KB

Definition at line 56 of file ArmGicLib.h.

◆ ARM_GICR_ICENABLER

#define ARM_GICR_ICENABLER 0x0180

Definition at line 80 of file ArmGicLib.h.

◆ ARM_GICR_ISENABLER

#define ARM_GICR_ISENABLER 0x0100

Definition at line 79 of file ArmGicLib.h.

◆ ARM_GICR_SGI_PPI_FRAME_SIZE

#define ARM_GICR_SGI_PPI_FRAME_SIZE SIZE_64KB

Definition at line 57 of file ArmGicLib.h.

◆ ARM_GICR_SGI_RESERVED_FRAME_SIZE

#define ARM_GICR_SGI_RESERVED_FRAME_SIZE SIZE_64KB

Definition at line 59 of file ArmGicLib.h.

◆ ARM_GICR_SGI_VLPI_FRAME_SIZE

#define ARM_GICR_SGI_VLPI_FRAME_SIZE SIZE_64KB

Definition at line 58 of file ArmGicLib.h.

◆ ARM_GICR_TYPER

#define ARM_GICR_TYPER 0x0008

Definition at line 62 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_AFFINITY

#define ARM_GICR_TYPER_AFFINITY (0xFFFFFFFFULL << 32)

Definition at line 73 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_COMMONLPIAFF

#define ARM_GICR_TYPER_COMMONLPIAFF (0x3 << 24)

Definition at line 72 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_DIRECTLPI

#define ARM_GICR_TYPER_DIRECTLPI (1 << 3)

Definition at line 67 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_DPGS

#define ARM_GICR_TYPER_DPGS (1 << 5)

Definition at line 69 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_GET_AFFINITY

#define ARM_GICR_TYPER_GET_AFFINITY ( TypeReg )

Value:

(((TypeReg) & \

ARM_GICR_TYPER_AFFINITY) >> 32)

Definition at line 75 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_LAST

#define ARM_GICR_TYPER_LAST (1 << 4)

Definition at line 68 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_PLPIS

#define ARM_GICR_TYPER_PLPIS (1 << 0)

Definition at line 65 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_PROCNO

#define ARM_GICR_TYPER_PROCNO (0xFFFF << 8)

Definition at line 71 of file ArmGicLib.h.

◆ ARM_GICR_TYPER_VLPIS

#define ARM_GICR_TYPER_VLPIS (1 << 1)

Definition at line 66 of file ArmGicLib.h.

◆ ICC_SRE_EL2_SRE

#define ICC_SRE_EL2_SRE (1 << 0)

Definition at line 285 of file ArmGicLib.h.

Function Documentation

◆ ArmGicAcknowledgeInterrupt()

UINTN EFIAPI ArmGicAcknowledgeInterrupt	(	IN UINTN	GicInterruptInterfaceBase,
		OUT UINTN *	InterruptId
	)

Definition at line 173 of file ArmGicLib.c.

◆ ArmGicDisableDistributor()

VOID EFIAPI ArmGicDisableDistributor ( IN UINTN GicDistributorBase )

Definition at line 405 of file ArmGicLib.c.

◆ ArmGicDisableInterrupt()

VOID EFIAPI ArmGicDisableInterrupt	(	IN UINTN	GicDistributorBase,
		IN UINTN	GicRedistributorBase,
		IN UINTN	Source
	)

Definition at line 317 of file ArmGicLib.c.

◆ ArmGicDisableInterruptInterface()

VOID EFIAPI ArmGicDisableInterruptInterface ( IN UINTN GicInterruptInterfaceBase )

Definition at line 433 of file ArmGicLib.c.

◆ ArmGicEnableDistributor()

VOID EFIAPI ArmGicEnableDistributor ( IN UINTN GicDistributorBase )

Definition at line 15 of file ArmGicNonSecLib.c.

◆ ArmGicEnableInterrupt()

VOID EFIAPI ArmGicEnableInterrupt	(	IN UINTN	GicDistributorBase,
		IN UINTN	GicRedistributorBase,
		IN UINTN	Source
	)

Definition at line 272 of file ArmGicLib.c.

◆ ArmGicEnableInterruptInterface()

VOID EFIAPI ArmGicEnableInterruptInterface ( IN UINTN GicInterruptInterfaceBase )

Definition at line 415 of file ArmGicLib.c.

◆ ArmGicEndOfInterrupt()

VOID EFIAPI ArmGicEndOfInterrupt	(	IN UINTN	GicInterruptInterfaceBase,
		IN UINTN	Source
	)

Definition at line 208 of file ArmGicLib.c.

◆ ArmGicGetInterfaceIdentification()

UINT32 EFIAPI ArmGicGetInterfaceIdentification ( IN UINTN GicInterruptInterfaceBase )

Return the GIC CPU Interrupt Interface ID.

Parameters

GicInterruptInterfaceBase Base address of the GIC Interrupt Interface.

Return values

CPU	Interface Identification information.

Definition at line 116 of file ArmGicLib.c.

◆ ArmGicGetMaxNumInterrupts()

UINTN EFIAPI ArmGicGetMaxNumInterrupts ( IN UINTN GicDistributorBase )

Definition at line 126 of file ArmGicLib.c.

◆ ArmGicIsInterruptEnabled()

BOOLEAN EFIAPI ArmGicIsInterruptEnabled	(	IN UINTN	GicDistributorBase,
		IN UINTN	GicRedistributorBase,
		IN UINTN	Source
	)

Definition at line 361 of file ArmGicLib.c.

◆ ArmGicSendSgiTo()

VOID EFIAPI ArmGicSendSgiTo	(	IN UINTN	GicDistributorBase,
		IN UINT8	TargetListFilter,
		IN UINT8	CPUTargetList,
		IN UINT8	SgiId
	)

Definition at line 142 of file ArmGicLib.c.

◆ ArmGicSetInterruptPriority()

VOID EFIAPI ArmGicSetInterruptPriority	(	IN UINTN	GicDistributorBase,
		IN UINTN	GicRedistributorBase,
		IN UINTN	Source,
		IN UINT32	Priority
	)

Definition at line 227 of file ArmGicLib.c.

◆ ArmGicV2AcknowledgeInterrupt()

UINTN EFIAPI ArmGicV2AcknowledgeInterrupt ( IN UINTN GicInterruptInterfaceBase )

Definition at line 15 of file ArmGicV2Lib.c.

◆ ArmGicV2DisableInterruptInterface()

VOID EFIAPI ArmGicV2DisableInterruptInterface ( IN UINTN GicInterruptInterfaceBase )

Definition at line 28 of file ArmGicV2NonSecLib.c.

◆ ArmGicV2EnableInterruptInterface()

VOID EFIAPI ArmGicV2EnableInterruptInterface ( IN UINTN GicInterruptInterfaceBase )

Definition at line 15 of file ArmGicV2NonSecLib.c.

◆ ArmGicV2EndOfInterrupt()

VOID EFIAPI ArmGicV2EndOfInterrupt	(	IN UINTN	GicInterruptInterfaceBase,
		IN UINTN	Source
	)

Definition at line 25 of file ArmGicV2Lib.c.

Macros

Functions