cmn

type Adaptive struct {
	RateLimitBase
	NumRetries int `json:"num_retries"`
}

type AdaptiveToSet struct {
	RateLimitBaseToSet      // NOTE: must be in the same exact order/position as above
	NumRetries         *int `json:"num_retries,omitempty"`
}

type AllBsummResults []*BsummResult

type ArchConf struct{ XactConf }

type ArchConfToSet struct{ XactConfToSet }

type ArchiveBckMsg struct {
	ToBck Bck `json:"tobck"`
	apc.ArchiveMsg
}

type AuthConf struct {
	Secret  string `json:"secret"`
	Enabled bool   `json:"enabled"`
}

type AuthConfToSet struct {
	Secret  *string `json:"secret,omitempty"`
	Enabled *bool   `json:"enabled,omitempty"`
}

type BackendBckToSet struct {
	Name     *string `json:"name"`
	Provider *string `json:"provider"`
}

type BackendConf struct {
	Conf      map[string]any `json:"-"` // backend implementation-dependent (custom marshaling to populate this field)
	Providers map[string]Ns  `json:"-"` // conditional (build tag) providers set during validation (BackendConf.Validate)
}

type BackendConfAIS map[string][]string // cluster alias -> [urls...]

type Bck struct {
	Props    *Bprops `json:"-"`
	Name     string  `json:"name" yaml:"name"`
	Provider string  `json:"provider" yaml:"provider"` // NOTE: see api/apc/provider.go for supported enum
	Ns       Ns      `json:"namespace" yaml:"namespace" list:"omitempty"`
}

type Bcks []Bck

type Bprops struct {
	BackendBck  Bck             `json:"backend_bck,omitempty"`            // makes a remote bucket out of a given ais://
	WritePolicy WritePolicyConf `json:"write_policy"`                     // write object metadata (immediate | delayed | never)
	Provider    string          `json:"provider" list:"readonly"`         // backend provider
	Renamed     string          `list:"omit"`                             // non-empty iff the bucket has been renamed
	Cksum       CksumConf       `json:"checksum"`                         // this bucket's checksum (for supported enum, see cmn/cos.cksum)
	Extra       ExtraProps      `json:"extra,omitempty" list:"omitempty"` // e.g., AWS.Endpoint for this bucket
	RateLimit   RateLimitConf   `json:"rate_limit"`                       // frontend and backend rate limiting - bursty and adaptive, respectively
	EC          ECConf          `json:"ec"`                               // erasure coding
	Mirror      MirrorConf      `json:"mirror"`                           // n-way mirroring
	LRU         LRUConf         `json:"lru"`                              // LRU watermarks and enable/disable
	Access      apc.AccessAttrs `json:"access,string"`                    // access permissions
	Features    feat.Flags      `json:"features,string"`                  // to flip assorted enumerated defaults (e.g. "S3-Use-Path-Style"; see cmn/feat)
	BID         uint64          `json:"bid,string" list:"omit"`           // unique ID
	Created     int64           `json:"created,string" list:"readonly"`   // creation timestamp
	Versioning  VersionConf     `json:"versioning"`                       // see "inherit"
}

type BpropsToSet struct {
	BackendBck  *BackendBckToSet      `json:"backend_bck,omitempty"`
	Versioning  *VersionConfToSet     `json:"versioning,omitempty"`
	Cksum       *CksumConfToSet       `json:"checksum,omitempty"`
	LRU         *LRUConfToSet         `json:"lru,omitempty"`
	Mirror      *MirrorConfToSet      `json:"mirror,omitempty"`
	EC          *ECConfToSet          `json:"ec,omitempty"`
	Access      *apc.AccessAttrs      `json:"access,string,omitempty"`
	RateLimit   *RateLimitConfToSet   `json:"rate_limit,omitempty"`
	Features    *feat.Flags           `json:"features,string,omitempty"`
	WritePolicy *WritePolicyConfToSet `json:"write_policy,omitempty"`
	Extra       *ExtraToSet           `json:"extra,omitempty"`
	Force       bool                  `json:"force,omitempty" copy:"skip" list:"omit"`
}

type BsummResult struct {
	Bck
	apc.BsummResult
}

type Bursty struct {
	RateLimitBase
	Size int `json:"burst_size"`
}

type BurstyToSet struct {
	RateLimitBaseToSet
	Size *int `json:"burst_size,omitempty"`
}

type CksumConf struct {
	// (note that `ChecksumNone` ("none") disables checksumming)
	Type string `json:"type"`

	// validate the checksum of the object that we cold-GET
	// or download from remote location (e.g., cloud bucket)
	ValidateColdGet bool `json:"validate_cold_get"`

	// - validate in-cluster object's checksum(s);
	// - upon any of the `cos.ErrBadCksum` errors try to recover from
	//   local redundant copies, and/or EC slices, and/or remote backend if exists;
	// - if all fails, remove the object and fail the GET.
	ValidateWarmGet bool `json:"validate_warm_get"`

	// validate checksums of objects migrated or replicated within the cluster
	ValidateObjMove bool `json:"validate_obj_move"`

	// EnableReadRange: Return read range checksum otherwise return entire object checksum.
	EnableReadRange bool `json:"enable_read_range"`
}

type CksumConfToSet struct {
	Type            *string `json:"type,omitempty"`
	ValidateColdGet *bool   `json:"validate_cold_get,omitempty"`
	ValidateWarmGet *bool   `json:"validate_warm_get,omitempty"`
	ValidateObjMove *bool   `json:"validate_obj_move,omitempty"`
	EnableReadRange *bool   `json:"enable_read_range,omitempty"`
}

type ClientConf struct {
	Timeout        cos.Duration `json:"client_timeout"`
	TimeoutLong    cos.Duration `json:"client_long_timeout"`
	ListObjTimeout cos.Duration `json:"list_timeout"`
}

type ClientConfToSet struct {
	Timeout        *cos.Duration `json:"client_timeout,omitempty"` // readonly as far as intra-cluster
	TimeoutLong    *cos.Duration `json:"client_long_timeout,omitempty"`
	ListObjTimeout *cos.Duration `json:"list_timeout,omitempty"`
}

type ClusterConfig struct {
	Backend     BackendConf     `json:"backend" allow:"cluster"`
	Ext         any             `json:"ext,omitempty"` // reserved
	WritePolicy WritePolicyConf `json:"write_policy"`  // object metadata write policy: (immediate | delayed | never)
	LastUpdated string          `json:"lastupdate_time"`
	UUID        string          `json:"uuid"`
	Dsort       DsortConf       `json:"distributed_sort"`
	Proxy       ProxyConf       `json:"proxy" allow:"cluster"`
	Cksum       CksumConf       `json:"checksum"`
	Auth        AuthConf        `json:"auth"`
	Tracing     TracingConf     `json:"tracing"`
	TCB         TCBConf         `json:"tcb"`
	TCO         TCOConf         `json:"tco"`
	Arch        ArchConf        `json:"arch"`
	RateLimit   RateLimitConf   `json:"rate_limit"`
	Keepalive   KeepaliveConf   `json:"keepalivetracker"`
	Rebalance   RebalanceConf   `json:"rebalance" allow:"cluster"`
	Log         LogConf         `json:"log"`
	EC          ECConf          `json:"ec" allow:"cluster"`
	Net         NetConf         `json:"net"`
	Timeout     TimeoutConf     `json:"timeout"`
	Transport   TransportConf   `json:"transport"`
	Memsys      MemsysConf      `json:"memsys"`
	FSHC        FSHCConf        `json:"fshc"`
	Disk        DiskConf        `json:"disk"`
	Space       SpaceConf       `json:"space"`
	Periodic    PeriodConf      `json:"periodic"`
	Client      ClientConf      `json:"client"`
	Mirror      MirrorConf      `json:"mirror" allow:"cluster"`
	LRU         LRUConf         `json:"lru"`
	Downloader  DownloaderConf  `json:"downloader"`
	Features    feat.Flags      `json:"features,string" allow:"cluster"` // enumerated features to flip assorted global defaults (cmn/feat/feat.go)
	Version     int64           `json:"config_version,string"`
	Versioning  VersionConf     `json:"versioning" allow:"cluster"`
	Resilver    ResilverConf    `json:"resilver"`
}

type Config struct {
	LocalConfig   `json:",inline"`
	ClusterConfig `json:",inline"`
	// contains filtered or unexported fields
}

type ConfigToSet struct {
	// ClusterConfig
	Backend     *BackendConf          `json:"backend,omitempty"`
	Mirror      *MirrorConfToSet      `json:"mirror,omitempty"`
	EC          *ECConfToSet          `json:"ec,omitempty"`
	Log         *LogConfToSet         `json:"log,omitempty"`
	Periodic    *PeriodConfToSet      `json:"periodic,omitempty"`
	Tracing     *TracingConfToSet     `json:"tracing,omitempty"`
	Timeout     *TimeoutConfToSet     `json:"timeout,omitempty"`
	Client      *ClientConfToSet      `json:"client,omitempty"`
	Space       *SpaceConfToSet       `json:"space,omitempty"`
	LRU         *LRUConfToSet         `json:"lru,omitempty"`
	Disk        *DiskConfToSet        `json:"disk,omitempty"`
	Rebalance   *RebalanceConfToSet   `json:"rebalance,omitempty"`
	Resilver    *ResilverConfToSet    `json:"resilver,omitempty"`
	Cksum       *CksumConfToSet       `json:"checksum,omitempty"`
	Versioning  *VersionConfToSet     `json:"versioning,omitempty"`
	Net         *NetConfToSet         `json:"net,omitempty"`
	FSHC        *FSHCConfToSet        `json:"fshc,omitempty"`
	Auth        *AuthConfToSet        `json:"auth,omitempty"`
	Keepalive   *KeepaliveConfToSet   `json:"keepalivetracker,omitempty"`
	Downloader  *DownloaderConfToSet  `json:"downloader,omitempty"`
	Dsort       *DsortConfToSet       `json:"distributed_sort,omitempty"`
	Transport   *TransportConfToSet   `json:"transport,omitempty"`
	Memsys      *MemsysConfToSet      `json:"memsys,omitempty"`
	TCB         *TCBConfToSet         `json:"tcb,omitempty"`
	WritePolicy *WritePolicyConfToSet `json:"write_policy,omitempty"`
	Proxy       *ProxyConfToSet       `json:"proxy,omitempty"`
	RateLimit   *RateLimitConfToSet   `json:"rate_limit"`
	Features    *feat.Flags           `json:"features,string,omitempty"`

	// LocalConfig
	FSP *FSPConf `json:"fspaths,omitempty"`
}

type DiskConf struct {
	DiskUtilLowWM   int64        `json:"disk_util_low_wm"`  // no throttling below
	DiskUtilHighWM  int64        `json:"disk_util_high_wm"` // throttle longer when above
	DiskUtilMaxWM   int64        `json:"disk_util_max_wm"`
	IostatTimeLong  cos.Duration `json:"iostat_time_long"`
	IostatTimeShort cos.Duration `json:"iostat_time_short"`
}

type DiskConfToSet struct {
	DiskUtilLowWM   *int64        `json:"disk_util_low_wm,omitempty"`
	DiskUtilHighWM  *int64        `json:"disk_util_high_wm,omitempty"`
	DiskUtilMaxWM   *int64        `json:"disk_util_max_wm,omitempty"`
	IostatTimeLong  *cos.Duration `json:"iostat_time_long,omitempty"`
	IostatTimeShort *cos.Duration `json:"iostat_time_short,omitempty"`
}

type DownloaderConf struct {
	Timeout cos.Duration `json:"timeout"`
}

type DownloaderConfToSet struct {
	Timeout *cos.Duration `json:"timeout,omitempty"`
}

type DsortConf struct {
	XactConf
	DuplicatedRecords   string       `json:"duplicated_records"`
	MissingShards       string       `json:"missing_shards"` // cmn.SupportedReactions enum
	EKMMalformedLine    string       `json:"ekm_malformed_line"`
	EKMMissingKey       string       `json:"ekm_missing_key"`
	DefaultMaxMemUsage  string       `json:"default_max_mem_usage"`
	DsorterMemThreshold string       `json:"dsorter_mem_threshold"`
	CallTimeout         cos.Duration `json:"call_timeout"`
}

type DsortConfToSet struct {
	XactConfToSet
	DuplicatedRecords   *string       `json:"duplicated_records,omitempty"`
	MissingShards       *string       `json:"missing_shards,omitempty"`
	EKMMalformedLine    *string       `json:"ekm_malformed_line,omitempty"`
	EKMMissingKey       *string       `json:"ekm_missing_key,omitempty"`
	DefaultMaxMemUsage  *string       `json:"default_max_mem_usage,omitempty"`
	CallTimeout         *cos.Duration `json:"call_timeout,omitempty"`
	DsorterMemThreshold *string       `json:"dsorter_mem_threshold,omitempty"`
}

type ECConf struct {
	XactConf

	// ObjSizeLimit is object size threshold _separating_ intra-cluster mirroring from
	// erasure coding.
	//
	// The value 0 (zero) indicates that objects of any size
	// are to be sliced, to produce (D) data slices and (P) erasure coded parity slices.
	// On the other hand, the value -1 specifies that absolutely all objects of any size
	// must be replicated as is. In effect, the (-1) option provides data protection via
	// intra-cluster (P+1)-way replication (a.k.a. mirroring).
	//
	// In all cases, a given (D, P) configuration provides node-level redundancy,
	// whereby P nodes can be lost without incurring loss of data.
	ObjSizeLimit int64 `json:"objsize_limit"`

	// Number of data (D) slices; the value 1 will have an effect of producing
	// (P) additional full-size replicas.
	DataSlices int `json:"data_slices"`

	// Depending on the object size and `ObjSizeLimit`, the value of `ParitySlices` (or P) indicates:
	// - a number of additional parity slices (generated or _computed_ from the (D) data slices),
	// or:
	// - a number of full object replicas (copies).
	// In all cases, the same rule applies: all slices and/or all full copies are stored on different
	// storage nodes (a.k.a. targets).
	ParitySlices int `json:"parity_slices"`

	Enabled  bool `json:"enabled"`   // EC is enabled
	DiskOnly bool `json:"disk_only"` // if true, EC does not use SGL - data goes directly to drives
}

type ECConfToSet struct {
	XactConfToSet
	ObjSizeLimit *int64 `json:"objsize_limit,omitempty"`
	DataSlices   *int   `json:"data_slices,omitempty"`
	ParitySlices *int   `json:"parity_slices,omitempty"`
	Enabled      *bool  `json:"enabled,omitempty"`
	DiskOnly     *bool  `json:"disk_only,omitempty"`
}

type ETLErrCtx struct {
	TID              string
	ETLName          string
	ETLTransformArgs string
	PodName          string
	SvcName          string
	k8s.PodStatus
}

type ErrAborted struct {
	// contains filtered or unexported fields
}

type ErrBckNotFound struct {
	// contains filtered or unexported fields
}

type ErrBucketAccessDenied struct {
	// contains filtered or unexported fields
}

type ErrBucketAlreadyExists struct {
	// contains filtered or unexported fields
}

type ErrBusy struct {
	// contains filtered or unexported fields
}

type ErrCapExceeded struct {
	// contains filtered or unexported fields
}

type ErrCreateHreq struct {
	// contains filtered or unexported fields
}

type ErrETL struct {
	Reason string
	ETLErrCtx
	Ecode int
}

type ErrEmptyProvider struct {
	// contains filtered or unexported fields
}

type ErrFailedTo struct {
	// contains filtered or unexported fields
}

type ErrGetCap struct {
	// contains filtered or unexported fields
}

type ErrHTTP struct {
	TypeCode   string `json:"tcode,omitempty"`
	Message    string `json:"message"`
	Method     string `json:"method"`
	URLPath    string `json:"url_path"`
	RemoteAddr string `json:"remote_addr"`
	Caller     string `json:"caller"`
	Node       string `json:"node"`

	Status int `json:"status"`
	// contains filtered or unexported fields
}

type ErrInitBackend struct {
	Provider string
}

type ErrInvalidBackendProvider struct {
	// contains filtered or unexported fields
}

type ErrInvalidCksum struct {
	// contains filtered or unexported fields
}

type ErrInvalidFSPathsConf struct {
	// contains filtered or unexported fields
}

type ErrInvalidMountpath struct {
	// contains filtered or unexported fields
}

type ErrLimitedCoexistence struct {
	// contains filtered or unexported fields
}

type ErrLmetaCorrupted struct {
	// contains filtered or unexported fields
}

type ErrLmetaNotFound struct {
	// contains filtered or unexported fields
}

type ErrMembershipChanges struct {
	// contains filtered or unexported fields
}

type ErrMissingBackend struct {
	Provider string
	Msg      string
}

type ErrMpathCheck struct {
	// contains filtered or unexported fields
}

type ErrMpathLostDisk struct {
	// contains filtered or unexported fields
}

type ErrMpathNewDisk struct {
	// contains filtered or unexported fields
}

type ErrMpathNoDisks struct {
	// contains filtered or unexported fields
}

type ErrMpathNotFound struct {
	// contains filtered or unexported fields
}

type ErrNoNodes struct {
	// contains filtered or unexported fields
}

type ErrNotImpl struct {
	// contains filtered or unexported fields
}

type ErrNotRemoteBck struct {
	// contains filtered or unexported fields
}

type ErrObjDefunct struct {
	// contains filtered or unexported fields
}

type ErrObjectAccessDenied struct {
	// contains filtered or unexported fields
}

type ErrRangeNotSatisfiable struct {
	// contains filtered or unexported fields
}

type ErrRateLimitFrontend ErrTooManyRequests // to differentiate by tcode

type ErrRemoteBckNotFound struct {
	// contains filtered or unexported fields
}

type ErrRemoteBucketOffline struct {
	// contains filtered or unexported fields
}

type ErrRemoteMetadataMismatch struct {
	// contains filtered or unexported fields
}

type ErrStreamTerminated struct {
	// contains filtered or unexported fields
}

type ErrTooManyRequests struct {
	// contains filtered or unexported fields
}

type ErrUnsupp struct {
	// contains filtered or unexported fields
}

type ErrWarning struct {
	// contains filtered or unexported fields
}

type ErrXactNotFound struct {
	// contains filtered or unexported fields
}

type ErrXactTgtInMaint struct {
	// contains filtered or unexported fields
}

type ErrXactUsePrev struct {
	// contains filtered or unexported fields
}

type ExtraProps struct {
	HTTP ExtraPropsHTTP `json:"http,omitempty" list:"omitempty"`
	HDFS ExtraPropsHDFS `json:"hdfs,omitempty" list:"omitempty"` // NOTE: obsolete; rm with meta-version
	AWS  ExtraPropsAWS  `json:"aws,omitempty" list:"omitempty"`
}

type ExtraPropsAWS struct {
	CloudRegion string `json:"cloud_region,omitempty"`

	// from https://github.com/aws/aws-sdk-go/blob/main/aws/config.go:
	// - "An optional endpoint URL (hostname only or fully qualified URI)
	// that overrides the default generated endpoint."
	Endpoint string `json:"endpoint,omitempty"`

	// from https://github.com/aws/aws-sdk-go/blob/main/aws/session/session.go:
	// - "Overrides the config profile the Session should be created from. If not
	// set the value of the environment variable will be loaded (AWS_PROFILE,
	// or AWS_DEFAULT_PROFILE if the Shared Config is enabled)."
	Profile string `json:"profile,omitempty"`

	// Amazon S3: 1000
	// - https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html#cli-usage-pagination-serverside
	// vs OpenStack Swift: 10,000
	// - https://docs.openstack.org/swift/latest/api/pagination.html
	MaxPageSize int64 `json:"max_pagesize,omitempty"`

	// Multipart upload size threshold must be greater or equal 5MB
	// - https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/feature/s3/manager
	// - for the AIS default, see `DefaultPartSize` in ais/s3/const
	// - NOTE: the threshold is, effectively, one of the **performance tunables**
	MultiPartSize cos.SizeIEC `json:"multipart_size,omitempty"`
}

type ExtraPropsAWSToSet struct {
	CloudRegion   *string      `json:"cloud_region,omitempty"`
	Endpoint      *string      `json:"endpoint,omitempty"`
	Profile       *string      `json:"profile,omitempty"`
	MaxPageSize   *int64       `json:"max_pagesize,omitempty"`
	MultiPartSize *cos.SizeIEC `json:"multipart_size,omitempty"`
}

type ExtraPropsHDFS struct {
	// Reference directory.
	RefDirectory string `json:"ref_directory,omitempty"`
}

type ExtraPropsHDFSToSet struct {
	RefDirectory *string `json:"ref_directory"`
}

type ExtraPropsHTTP struct {
	// Original URL prior to hashing.
	OrigURLBck string `json:"original_url,omitempty" list:"readonly"`
}

type ExtraPropsHTTPToSet struct {
	OrigURLBck *string `json:"original_url"`
}

type ExtraToSet struct {
	AWS  *ExtraPropsAWSToSet  `json:"aws"`
	HTTP *ExtraPropsHTTPToSet `json:"http"`
	HDFS *ExtraPropsHDFSToSet `json:"hdfs"` // ditto
}

type FSHCConf struct {
	TestFileCount int `json:"test_files"` // number of files to read/write
	// critical and unexpected errors detected during FSHC run;
	// exceeding the limit "triggers" FSHC that may, in turn, disable the corresponding mountpath
	HardErrs int `json:"error_limit"`

	// - maximum number of I/O errors during the last `IOErrTime` interval;
	// - the number does not include network error (e.g., connection reset by peer)
	//   and errors returned by remote backends;
	// - exceeding this limit is also an FSHC-trggering event; subsequently,
	//   if FSHC confirms the problem it will disable the mountpath (see above)
	IOErrs int `json:"io_err_limit,omitempty"`
	// time interval (in seconds) to accumulate soft errors;
	// the total number by the end of the interval must not exceed `IOErrs` (above)
	IOErrTime cos.Duration `json:"io_err_time,omitempty"`

	// whether FSHC is enabled (note: disabling FSHC is _not_ recommended)
	Enabled bool `json:"enabled"`
}

type FSHCConfToSet struct {
	TestFileCount *int          `json:"test_files,omitempty"`
	HardErrs      *int          `json:"error_limit,omitempty"`
	IOErrs        *int          `json:"io_err_limit,omitempty"`
	IOErrTime     *cos.Duration `json:"io_err_time,omitempty"`
	Enabled       *bool         `json:"enabled,omitempty"`
}

type FSPConf struct {
	Paths cos.StrKVs `json:"paths,omitempty" list:"readonly"`
}

type HTTPBckObj struct {
	Bck        Bck
	ObjName    string
	OrigURLBck string // HTTP URL of the bucket (object name excluded)
}

type HTTPConf struct {
	Proto         string `json:"-"`             // http or https (set depending on `UseHTTPS`)
	Certificate   string `json:"server_crt"`    // HTTPS: X.509 certificate
	CertKey       string `json:"server_key"`    // HTTPS: X.509 key
	ServerNameTLS string `json:"domain_tls"`    // #6410
	ClientCA      string `json:"client_ca_tls"` // #6410
	// clients "idle" config: intra-cluster and backend
	IdleConnTimeout     cos.Duration `json:"idle_conn_time"`
	MaxIdleConnsPerHost int          `json:"idle_conns_per_host"`
	MaxIdleConns        int          `json:"idle_conns"`
	// cont-d
	ClientAuthTLS   int  `json:"client_auth_tls"`   // #6410 tls.ClientAuthType enum
	WriteBufferSize int  `json:"write_buffer_size"` // http.Transport.WriteBufferSize; zero defaults to 4KB
	ReadBufferSize  int  `json:"read_buffer_size"`  // http.Transport.ReadBufferSize; ditto
	UseHTTPS        bool `json:"use_https"`         // use HTTPS
	SkipVerifyCrt   bool `json:"skip_verify"`       // skip X.509 cert verification (used with self-signed certs)
	Chunked         bool `json:"chunked_transfer"`  // (https://tools.ietf.org/html/rfc7230#page-36; not used since 02/23)
}

type HTTPConfToSet struct {
	Certificate   *string `json:"server_crt,omitempty"`
	CertKey       *string `json:"server_key,omitempty"`
	ServerNameTLS *string `json:"domain_tls,omitempty"`
	ClientCA      *string `json:"client_ca_tls,omitempty"`
	// added v3.26
	IdleConnTimeout     *cos.Duration `json:"idle_conn_time,omitempty"`
	MaxIdleConnsPerHost *int          `json:"idle_conns_per_host,omitempty"`
	MaxIdleConns        *int          `json:"idle_conns,omitempty"`
	// cont-d
	WriteBufferSize *int  `json:"write_buffer_size,omitempty" list:"readonly"`
	ReadBufferSize  *int  `json:"read_buffer_size,omitempty" list:"readonly"`
	ClientAuthTLS   *int  `json:"client_auth_tls,omitempty"`
	UseHTTPS        *bool `json:"use_https,omitempty"`
	SkipVerifyCrt   *bool `json:"skip_verify,omitempty"`
	Chunked         *bool `json:"chunked_transfer,omitempty"`
}

type HreqArgs struct {
	BodyR    io.ReadCloser
	Header   http.Header // request headers
	Query    url.Values  // query, e.g. ?a=x&b=y&c=z
	RawQuery string      // raw query
	Method   string
	Base     string // base URL, e.g. http://xyz.abc
	Path     string // path URL, e.g. /x/y/z
	Body     []byte
}

type IterField interface {
	Value() any                          // returns the value
	String() string                      // string representation of the value
	SetValue(v any, force ...bool) error // `force` ignores `tagReadonly` (to be used with caution!)
}

type IterOpts struct {
	// Skip fields based on allowed tag
	Allowed string
	// Visits all the fields, not only the leaves.
	VisitAll bool
	// Read-only walk is true by default (compare with `UpdateFieldValue`)
	// Note that `tagOmitempty` is limited to read-only - has no effect when `OnlyRead == false`.
	OnlyRead bool
}

type KeepaliveConf struct {
	Proxy       KeepaliveTrackerConf `json:"proxy"`       // how proxy tracks target keepalives
	Target      KeepaliveTrackerConf `json:"target"`      // how target tracks primary proxies keepalives
	NumRetries  int                  `json:"num_retries"` // default: `kaNumRetries`
	RetryFactor uint8                `json:"retry_factor"`
}

type KeepaliveConfToSet struct {
	Proxy       *KeepaliveTrackerConfToSet `json:"proxy,omitempty"`
	Target      *KeepaliveTrackerConfToSet `json:"target,omitempty"`
	NumRetries  *int                       `json:"num_retries,omitempty"`
	RetryFactor *uint8                     `json:"retry_factor,omitempty"`
}

type KeepaliveTrackerConf struct {
	Name     string       `json:"name"`     // "heartbeat"
	Interval cos.Duration `json:"interval"` // keepalive interval
	Factor   uint8        `json:"factor"`   // only average
}

type KeepaliveTrackerConfToSet struct {
	Interval *cos.Duration `json:"interval,omitempty"`
	Name     *string       `json:"name,omitempty" list:"readonly"`
	Factor   *uint8        `json:"factor,omitempty"`
}

type L4Conf struct {
	Proto         string `json:"proto"`           // tcp, udp
	SndRcvBufSize int    `json:"sndrcv_buf_size"` // SO_RCVBUF and SO_SNDBUF
}

type LRUConf struct {
	// DontEvictTimeStr denotes the period of time during which eviction of an object
	// is forbidden [atime, atime + DontEvictTime]
	DontEvictTime cos.Duration `json:"dont_evict_time"`

	// CapacityUpdTimeStr denotes the frequency at which AIStore updates local capacity utilization
	CapacityUpdTime cos.Duration `json:"capacity_upd_time"`

	// Enabled: LRU will only run when set to true
	Enabled bool `json:"enabled"`
}

type LRUConfToSet struct {
	DontEvictTime   *cos.Duration `json:"dont_evict_time,omitempty"`
	CapacityUpdTime *cos.Duration `json:"capacity_upd_time,omitempty"`
	Enabled         *bool         `json:"enabled,omitempty"`
}

type LocalConfig struct {
	FSP       FSPConf        `json:"fspaths"`
	ConfigDir string         `json:"confdir"`
	LogDir    string         `json:"log_dir"`
	TestFSP   TestFSPConf    `json:"test_fspaths"`
	HostNet   LocalNetConfig `json:"host_net"`
}

type LocalNetConfig struct {
	Hostname             string `json:"hostname"`
	HostnameIntraControl string `json:"hostname_intra_control"`
	HostnameIntraData    string `json:"hostname_intra_data"`
	Port                 int    `json:"port,string"`               // listening port
	PortIntraControl     int    `json:"port_intra_control,string"` // --/-- for intra-cluster control
	PortIntraData        int    `json:"port_intra_data,string"`    // --/-- for intra-cluster data
	// omit
	UseIntraControl bool `json:"-"`
	UseIntraData    bool `json:"-"`
}

type LogConf struct {
	Level     cos.LogLevel `json:"level"`      // log level (aka verbosity)
	MaxSize   cos.SizeIEC  `json:"max_size"`   // exceeding this size triggers log rotation
	MaxTotal  cos.SizeIEC  `json:"max_total"`  // (sum individual log sizes); exceeding this number triggers cleanup
	FlushTime cos.Duration `json:"flush_time"` // log flush interval
	StatsTime cos.Duration `json:"stats_time"` // (not used)
	ToStderr  bool         `json:"to_stderr"`  // Log only to stderr instead of files.
}

type LogConfToSet struct {
	Level     *cos.LogLevel `json:"level,omitempty"`
	ToStderr  *bool         `json:"to_stderr,omitempty"`
	MaxSize   *cos.SizeIEC  `json:"max_size,omitempty"`
	MaxTotal  *cos.SizeIEC  `json:"max_total,omitempty"`
	FlushTime *cos.Duration `json:"flush_time,omitempty"`
	StatsTime *cos.Duration `json:"stats_time,omitempty"`
}

type LsoEnt struct {
	Name     string `json:"name" msg:"n"`                            // object name
	Checksum string `json:"checksum,omitempty" msg:"cs,omitempty"`   // checksum
	Atime    string `json:"atime,omitempty" msg:"a,omitempty"`       // last access time; formatted as ListObjsMsg.TimeFormat
	Version  string `json:"version,omitempty" msg:"v,omitempty"`     // e.g., GCP int64 generation, AWS version (string), etc.
	Location string `json:"location,omitempty" msg:"t,omitempty"`    // [tnode:mountpath]
	Custom   string `json:"custom-md,omitempty" msg:"m,omitempty"`   // custom metadata: ETag, MD5, CRC, user-defined ...
	Size     int64  `json:"size,string,omitempty" msg:"s,omitempty"` // size in bytes
	Copies   int16  `json:"copies,omitempty" msg:"c,omitempty"`      // ## copies (NOTE: for non-replicated object copies == 1)
	Flags    uint16 `json:"flags,omitempty" msg:"f,omitempty"`       // enum { EntryIsCached, EntryIsDir, EntryInArch, ...}
}

type LsoEntries []*LsoEnt

type LsoRes struct {
	UUID              string     `json:"uuid"`
	ContinuationToken string     `json:"continuation_token"`
	Entries           LsoEntries `json:"entries"`
	Flags             uint32     `json:"flags"`
}

type MemsysConf struct {
	MinFree        cos.SizeIEC  `json:"min_free"`
	DefaultBufSize cos.SizeIEC  `json:"default_buf"`
	SizeToGC       cos.SizeIEC  `json:"to_gc"`
	HousekeepTime  cos.Duration `json:"hk_time"`
	MinPctTotal    int          `json:"min_pct_total"`
	MinPctFree     int          `json:"min_pct_free"`
}

type MemsysConfToSet struct {
	MinFree        *cos.SizeIEC  `json:"min_free,omitempty"`
	DefaultBufSize *cos.SizeIEC  `json:"default_buf,omitempty"`
	SizeToGC       *cos.SizeIEC  `json:"to_gc,omitempty"`
	HousekeepTime  *cos.Duration `json:"hk_time,omitempty"`
	MinPctTotal    *int          `json:"min_pct_total,omitempty"`
	MinPctFree     *int          `json:"min_pct_free,omitempty"`
}

type MirrorConf struct {
	Copies  int64 `json:"copies"`       // num copies
	Burst   int   `json:"burst_buffer"` // xaction channel (buffer) size
	Enabled bool  `json:"enabled"`      // enabled (to generate copies)
}

type MirrorConfToSet struct {
	Copies  *int64 `json:"copies,omitempty"`
	Burst   *int   `json:"burst_buffer,omitempty"`
	Enabled *bool  `json:"enabled,omitempty"`
}

type NetConf struct {
	L4   L4Conf   `json:"l4"`
	HTTP HTTPConf `json:"http"`
}

type NetConfToSet struct {
	HTTP *HTTPConfToSet `json:"http,omitempty"`
}

type Ns struct {
	// UUID of other remote AIS cluster (for now only used for AIS). Note
	// that we can have different namespaces which refer to same UUID (cluster).
	// This means that in a sense UUID is a parent of the actual namespace.
	UUID string `json:"uuid" yaml:"uuid"`
	// Name uniquely identifies a namespace under the same UUID (which may
	// be empty) and is used in building FQN for the objects.
	Name string `json:"name" yaml:"name"`
}

type OWT int

type ObjAttrs struct {
	Cksum    *cos.Cksum `json:"checksum,omitempty"`  // object checksum (cloned)
	CustomMD cos.StrKVs `json:"custom-md,omitempty"` // custom metadata: ETag, MD5, CRC, user-defined ...
	Ver      *string    `json:"version,omitempty"`   // object version
	Atime    int64      `json:"atime,omitempty"`     // access time (nanoseconds since UNIX epoch)
	Size     int64      `json:"size,omitempty"`      // object size (bytes)
}