host

Documentation

Overview

Package host provides the host information.

Index

• func DmidecodeUUID(ctx context.Context) (string, error)
• func GetBootID() (string, error)
• func GetMachineID(ctx context.Context) (string, error)
• func GetOSMachineID() (string, error)
• func SystemManufacturer(ctx context.Context) (string, error)
• type VirtualizationEnvironment
  • func SystemdDetectVirt(ctx context.Context) (VirtualizationEnvironment, error)

Functions

func DmidecodeUUID

func DmidecodeUUID(ctx context.Context) (string, error)

Fetches the UUIF of the machine host, using the "dmidecode". Returns an empty string if the UUID is not found.

ref. UUID=$(dmidecode -t 1 | grep -i UUID | awk '{print $2}')

func GetBootID

func GetBootID() (string, error)

Returns an empty string if the boot ID is not found.

func GetMachineID

func GetMachineID(ctx context.Context) (string, error)

Returns the UUID of the machine host. Returns an empty string if the UUID is not found.

func GetOSMachineID

func GetOSMachineID() (string, error)

Returns the OS-level UUID based on /etc/machine-id or /var/lib/dbus/machine-id. Returns an empty string if the UUID is not found.

func SystemManufacturer

func SystemManufacturer(ctx context.Context) (string, error)

SystemManufacturer detects the system manufacturer, using "dmidecode".

Types

type VirtualizationEnvironment

type VirtualizationEnvironment struct {
	// Type is the virtualization type.
	// Output of "systemd-detect-virt".
	// e.g., "kvm" for VM, "lxc" for container
	Type string `json:"type"`

	// Whether the host is running in a VM.
	// Output of "systemd-detect-virt --vm".
	// Set to "none" if the host is not running in a VM.
	// e.g., "kvm"
	VM string `json:"vm"`

	// Whether the host is running in a container.
	// Output of "systemd-detect-virt --container".
	// Set to "none" if the host is not running in a container.
	// e.g., "lxc"
	Container string `json:"container"`

	// Whether the host is running in a KVM.
	// Set to "false" if the host is not running in a KVM.
	IsKVM bool `json:"is_kvm"`
}

VirtualizationEnvironment represents the virtualization environment of the host.

func SystemdDetectVirt

func SystemdDetectVirt(ctx context.Context) (VirtualizationEnvironment, error)

SystemdDetectVirt detects the virtualization type of the host, using "systemd-detect-virt".