config/shared/errors/errors.go - main - githubmirror/ignition

config/shared/errors/errors.go
133 строки9 KB
James Le Cuirot
stages/disks: Allow deleting a partition while creating number 0
12 июн 2026, 12:25
12 июн 2026, 12:2576f869a
// Copyright 2018 CoreOS, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

// Package errors includes errors that are used in multiple config versions
package errors

import (
	"errors"
	"fmt"
)

var (
	// Parsing / general errors
	ErrInvalid   = errors.New("config is not valid")
	ErrEmpty     = errors.New("not a config (empty)")
	ErrDuplicate = errors.New("duplicate entry defined")

	// Ignition section errors
	ErrInvalidVersion = errors.New("invalid config version (couldn't parse)")
	ErrUnknownVersion = errors.New("unsupported config version")

	ErrDeprecated         = errors.New("config format deprecated")
	ErrCompressionInvalid = errors.New("invalid compression method")

	// Storage section errors
	ErrFileUsedSymlink                  = errors.New("file path includes link in config")
	ErrDirectoryUsedSymlink             = errors.New("directory path includes link in config")
	ErrLinkUsedSymlink                  = errors.New("link path includes link in config")
	ErrLinkTargetRequired               = errors.New("link target is required")
	ErrHardLinkToDirectory              = errors.New("hard link target is a directory")
	ErrHardLinkSpecifiesOwner           = errors.New("user/group ignored for hard link")
	ErrDiskDeviceRequired               = errors.New("disk device is required")
	ErrPartitionNumbersCollide          = errors.New("partition numbers collide")
	ErrPartitionsOverlap                = errors.New("partitions overlap")
	ErrPartitionsMisaligned             = errors.New("partitions misaligned")
	ErrOverwriteAndNilSource            = errors.New("overwrite must be false if source is unspecified")
	ErrVerificationAndNilSource         = errors.New("source must be specified if verification is specified")
	ErrFilesystemInvalidFormat          = errors.New("invalid filesystem format")
	ErrLabelNeedsFormat                 = errors.New("filesystem must specify format if label is specified")
	ErrFormatNilWithOthers              = errors.New("format cannot be empty when path, label, uuid, wipeFilesystem, options, or mountOptions is specified")
	ErrExt4LabelTooLong                 = errors.New("filesystem labels cannot be longer than 16 characters when using ext4")
	ErrBtrfsLabelTooLong                = errors.New("filesystem labels cannot be longer than 256 characters when using btrfs")
	ErrXfsLabelTooLong                  = errors.New("filesystem labels cannot be longer than 12 characters when using xfs")
	ErrSwapLabelTooLong                 = errors.New("filesystem labels cannot be longer than 15 characters when using swap")
	ErrVfatLabelTooLong                 = errors.New("filesystem labels cannot be longer than 11 characters when using vfat")
	ErrVirtiofsCannotHaveLabel          = errors.New("filesystem labels cannot be set when using virtiofs")
	ErrVirtiofsDeviceTagTooLong         = errors.New("virtiofs device tag cannot be longer than 36 bytes")
	ErrUUIDNotSupportedForFormat        = errors.New("filesystem uuid cannot be set for non-block-device filesystems")
	ErrWipeNotSupportedForFormat        = errors.New("wipeFilesystem cannot be set for non-block-device filesystems")
	ErrMkfsOptionsNotSupportedForFormat = errors.New("filesystem options (mkfs) cannot be set for non-block-device filesystems")
	ErrLuksLabelTooLong                 = errors.New("luks device labels cannot be longer than 47 characters")
	ErrLuksNameContainsSlash            = errors.New("device names cannot contain slashes")
	ErrInvalidLuksKeyFile               = errors.New("invalid key-file source")
	ErrClevisPinRequired                = errors.New("missing required custom clevis pin")
	ErrUnknownClevisPin                 = errors.New("unsupported clevis pin")
	ErrClevisConfigRequired             = errors.New("missing required custom clevis config")
	ErrClevisCustomWithOthers           = errors.New("cannot use custom clevis config with tpm2, tang, or threshold")
	ErrTangThumbprintRequired           = errors.New("thumbprint is required")
	ErrInvalidTangAdvertisement         = errors.New("advertisement is not valid JSON")
	ErrFileIllegalMode                  = errors.New("illegal file mode")
	ErrModeSpecialBits                  = errors.New("setuid/setgid/sticky bits are not supported or functional in spec versions older than 3.6.0")
	ErrBothIDAndNameSet                 = errors.New("cannot set both id and name")
	ErrLabelTooLong                     = errors.New("partition labels may not exceed 36 characters")
	ErrDoesntMatchGUIDRegex             = errors.New("doesn't match the form \"01234567-89AB-CDEF-EDCB-A98765432101\"")
	ErrLabelContainsColon               = errors.New("partition label will be truncated to text before the colon")
	ErrNoPath                           = errors.New("path not specified")
	ErrPathRelative                     = errors.New("path not absolute")
	ErrDirtyPath                        = errors.New("path is not fully simplified")
	ErrNoDevice                         = errors.New("device not specified")
	ErrPartitionsOverwritten            = errors.New("filesystem overwrites partitioned device")
	ErrFilesystemImplicitWipe           = errors.New("device matches disk with wipeTable enabled; filesystem will be wiped")
	ErrRaidLevelRequired                = errors.New("raid level is required")
	ErrSparesUnsupportedForLevel        = errors.New("spares unsupported for linear and raid0 arrays")
	ErrUnrecognizedRaidLevel            = errors.New("unrecognized raid level")
	ErrRaidDevicesRequired              = errors.New("raid devices required")
	ErrShouldNotExistWithOthers         = errors.New("shouldExist specified false with other options also specified")
	ErrNeedLabelOrNumber                = errors.New("a partition number >= 1 or a label must be specified")
	ErrDuplicateLabels                  = errors.New("cannot use the same partition label twice")
	ErrInvalidProxy                     = errors.New("proxies must be http(s)")
	ErrInsecureProxy                    = errors.New("insecure plaintext HTTP proxy specified for HTTPS resources")
	ErrPathConflictsSystemd             = errors.New("path conflicts with systemd unit or dropin")
	ErrCexWithClevis                    = errors.New("cannot use cex with clevis")
	ErrCexWithKeyFile                   = errors.New("cannot use key file with cex")

	// Systemd section errors
	ErrInvalidSystemdExt       = errors.New("invalid systemd unit extension")
	ErrInvalidSystemdDropinExt = errors.New("invalid systemd drop-in extension")
	ErrNoSystemdExt            = errors.New("no systemd unit extension")
	ErrInvalidInstantiatedUnit = errors.New("invalid systemd instantiated unit")

	// Misc errors
	ErrSourceRequired                  = errors.New("source is required")
	ErrInvalidScheme                   = errors.New("invalid url scheme")
	ErrInvalidUrl                      = errors.New("unable to parse url")
	ErrInvalidHTTPHeader               = errors.New("unable to parse HTTP header")
	ErrEmptyHTTPHeaderName             = errors.New("HTTP header name can't be empty")
	ErrUnsupportedSchemeForHTTPHeaders = errors.New("cannot use HTTP headers with this source scheme")
	ErrHashMalformed                   = errors.New("malformed hash specifier")
	ErrHashWrongSize                   = errors.New("incorrect size for hash sum")
	ErrHashUnrecognized                = errors.New("unrecognized hash function")
	ErrEngineConfiguration             = errors.New("engine incorrectly configured")

	// AWS S3 specific errors
	ErrInvalidS3ARN             = errors.New("invalid S3 ARN format")
	ErrInvalidS3ObjectVersionId = errors.New("invalid S3 object VersionId")

	// Obsolete errors, left here for ABI compatibility
	ErrFilePermissionsUnset      = errors.New("permissions unset, defaulting to 0644")
	ErrDirectoryPermissionsUnset = errors.New("permissions unset, defaulting to 0755")
)

// NewNoInstallSectionError produces an error indicating the given unit, named
// name, is missing an Install section.
func NewNoInstallSectionError(name string) error {
	return fmt.Errorf("unit %q is enabled, but has no install section so enable does nothing", name)
}

// NewNoInstallSectionForInstantiableUnitError produces an error indicating the
// given instantiable unit for an instance unit is missing an Install section.
func NewNoInstallSectionForInstantiableUnitError(instantiable, instance string) error {
	return fmt.Errorf("template unit %q for %q doesn't have Install section", instantiable, instance)
}