feat

Documentation

Overview

Package feat: global runtime-configurable feature flags

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

Index

• Constants
• Variables
• func IsBucketScope(name string) bool
• type Flags
  • func CSV2Feat(s string) (Flags, error)
  • func (f Flags) ClearName(n string) Flags
  • func (f Flags) IsSet(flag Flags) bool
  • func (f Flags) Names() (names []string)
  • func (f Flags) Set(flags Flags) Flags
  • func (f Flags) String() string

Constants

const (
	EnforceIntraClusterAccess = Flags(1 << iota)
	SkipVC                    // (*) skip loading existing object's metadata, Version and Checksum (VC) in particular
	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            // use reverse proxy calls instead of HTTP-redirect for S3 API
	S3UsePathStyle            // use older path-style addressing (as opposed to virtual-hosted style), e.g., https://s3.amazonaws.com/BUCKET/KEY
)

const (
	PropName = "features"
)

Variables

var Bucket = []string{
	"Skip-Loading-VersionChecksum-MD",
	"Fsync-PUT",
	"S3-Presigned-Request",
	"Disable-Cold-GET",
	"Streaming-Cold-GET",
	"S3-Use-Path-Style",
}

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",
	"Dont-Allow-Passing-FQN-to-ETL",
	"Ignore-LimitedCoexistence-Conflicts",
	"S3-Presigned-Request",
	"Dont-Optimize-Listing-Virtual-Dirs",
	"Disable-Cold-GET",
	"Streaming-Cold-GET",
	"S3-Reverse-Proxy",
	"S3-Use-Path-Style",
}

Functions

func IsBucketScope

func IsBucketScope(name string) bool

Types

type Flags

type Flags cos.BitFlags

func CSV2Feat

func CSV2Feat(s string) (Flags, error)

func (Flags) ClearName

func (f Flags) ClearName(n string) Flags

func (Flags) IsSet

func (f Flags) IsSet(flag Flags) bool

func (Flags) Names

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

func (Flags) Set

func (f Flags) Set(flags Flags) Flags

func (Flags) String

func (f Flags) String() string