feat

package
v1.4.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 15, 2026 License: MIT Imports: 5 Imported by: 1

Documentation

Overview

Package feat: global runtime-configurable feature flags

  • Copyright (c) 2018-2025, NVIDIA CORPORATION. All rights reserved.

Index

Constants

View Source
const (
	EnforceIntraClusterAccess = Flags(1 << iota)
	SkipVC                    // skip loading existing object's metadata, Version and Checksum (VC) in particular (advanced usage only)
	DontAutoDetectFshare      // do not auto-detect file share (NFS, SMB) when _promoting_ shared files to AIS
	S3APIviaRoot              // handle s3 requests via `aistore-hostname/` (default: `aistore-hostname/s3`)
	FsyncPUT                  // when finalizing PUT(object): fflush prior to (close, rename) sequence
	LZ4Block1MB               // .tar.lz4 format, lz4 compression: max uncompressed block size=1MB (default: 256K)
	LZ4FrameChecksum          // checksum lz4 frames (default: don't)
	DontAllowPassingFQNtoETL  // do not allow passing fully-qualified name of a locally stored object to (local) ETL containers
	IgnoreLimitedCoexistence  // run in presence of "limited coexistence" type conflicts (same as e.g. CopyBckMsg.Force but globally)
	S3PresignedRequest        // pass-through client-signed (presigned) S3 requests for subsequent authentication by S3
	DontOptimizeVirtualDir    // when prefix doesn't end with '/' and is a subdirectory: don't assume there are no _prefixed_ obj names
	DisableColdGET            // disable cold-GET (from remote bucket)
	StreamingColdGET          // write and transmit cold-GET content back to user in parallel, without _finalizing_ in-cluster object
	S3ReverseProxy            // intra-cluster communications: instead of regular HTTP redirects reverse-proxy S3 API calls to designated targets
	S3UsePathStyle            // use older path-style addressing (as opposed to virtual-hosted style), e.g., https://s3.amazonaws.com/BUCKET/KEY
	DontDeleteWhenRebalancing // disable lazy deletion during global rebalance: do not delete misplaced sources of the migrated objects
	DontSetControlPlaneToS    // intra-cluster control plane: use default network priority (do not set IPv4 ToS to low-latency)
	TrustCryptoSafeChecksums  // when checking whether objects are identical trust only cryptographically secure checksums
	S3ListObjectVersions      // when versioning info is requested, use ListObjectVersions API (beware: extremely slow, versioned S3 buckets only)
	EnableDetailedPromMetrics // include (bucket, xaction) Prometheus variable labels with every GET, PUT, and HEAD transaction
	SystemReserved            // reserved; do not set: the flag may be redefined or removed at any time
	ResumeInterruptedMPU      // resume interrupted multipart uploads from persisted partial manifests
	KeepUnknownFQN            // do not delete unrecognized/invalid FQNs during space cleanup ('ais space-cleanup')
	LoadBalanceGET            // when bucket is n-way mirrored read object replica from the least-utilized mountpath
)
View Source
const (
	PropName = "features"
)

Variables

View Source
var Bucket = [...]string{
	"Skip-Loading-VersionChecksum-MD",
	"Fsync-PUT",
	"S3-Presigned-Request",
	"Disable-Cold-GET",
	"Streaming-Cold-GET",
	"S3-Use-Path-Style",
	"S3-ListObjectVersions",
	"Resume-Interrupted-MPU",
}
View Source
var Cluster = [...]string{
	"Enforce-IntraCluster-Access",
	"Skip-Loading-VersionChecksum-MD",
	"Do-not-Auto-Detect-FileShare",
	"S3-API-via-Root",
	"Fsync-PUT",
	"LZ4-Block-1MB",
	"LZ4-Frame-Checksum",
	"Do-not-Allow-Passing-FQN-to-ETL",
	"Ignore-LimitedCoexistence-Conflicts",
	"S3-Presigned-Request",
	"Do-not-Optimize-Listing-Virtual-Dirs",
	"Disable-Cold-GET",
	"Streaming-Cold-GET",
	"S3-Reverse-Proxy",
	"S3-Use-Path-Style",
	"Do-not-Delete-When-Rebalancing",
	"Do-not-Set-Control-Plane-ToS",
	"Trust-Crypto-Safe-Checksums",
	"S3-ListObjectVersions",
	"Enable-Detailed-Prom-Metrics",
	"System-Reserved",
	"Resume-Interrupted-MPU",
	"Keep-Unknown-FQN",
	"Load-Balance-GET",
}

Functions

func IsBucketScope added in v1.3.23

func IsBucketScope(name string) bool

Types

type Flags

type Flags cos.BitFlags

func CSV2Feat added in v1.3.23

func CSV2Feat(s string) (Flags, error)

func (Flags) ClearName added in v1.3.23

func (f Flags) ClearName(n string) Flags

func (Flags) IsSet

func (f Flags) IsSet(flag Flags) bool

func (Flags) Names added in v1.3.23

func (f Flags) Names() (names []string)

func (Flags) Set

func (f Flags) Set(flags Flags) Flags

func (Flags) String

func (f Flags) String() string

func (*Flags) Validate added in v1.4.0

func (f *Flags) Validate() error

as cmn.Validator and cmn.PropsValidator

func (*Flags) ValidateAsProps added in v1.4.0

func (f *Flags) ValidateAsProps(...any) error

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL