utils

Oct 22, 2026

Changes in this version

+ const ClientIPHeaderForwardedFor

+ const ClientIPHeaderRealIP

+ const ContextKeyClientIP

+ var ClientIPTag = clientip.Tag

+ func ClientIP(ctx fiber.Ctx) string

+ func ClientIPMiddleware(header string, trusted TrustedProxies) fiber.Handler

+ func NormalizeClientIPHeader(header string) (string, error)

+ func ParseEncodingType(ctx fiber.Ctx) (types.EncodingType, error)

+ func URLEncodeListObjectsResult(res s3response.ListObjectsResult, encodingType types.EncodingType) s3response.ListObjectsResult

+ func URLEncodeListObjectsV2Result(res s3response.ListObjectsV2Result, encodingType types.EncodingType) s3response.ListObjectsV2Result

+ func ValidateLimiterInteger(limiter string, lt LimiterType) error

+ type TrustedProxies = clientip.TrustedProxies

+ func ParseTrustedProxies(list string) (TrustedProxies, error)

Oct 13, 2026

Changes in this version

+ const AwsChunkedEncoding

+ const ContextKeyBodyStream

+ func FormatRetainUntilDate(date *time.Time) *string

+ func HasAwsChunkedEncoding(contentEncoding string) bool

+ func HasPayloadIntegrityCheck(ctx fiber.Ctx) bool

+ func NewHash(ht HashType) (hash.Hash, error)

+ func ParseContentEncoding(ctx fiber.Ctx) string

+ func ParseObjectLockFields(fields map[string]string) (*objLockCfg, error)

+ func SetRegionMismatchHeader(ctx fiber.Ctx, err error)

+ func ValidateBucketRegion(bucketRegion, region string) error

+ func ValidateLocationConstraint(constraint *string, region string) error

+ func ValidateSSEHeaders(ssec SSECHeaders, serverSideEncryption string) error

+ type ContentLengthReader struct

+ func NewContentLengthReader(r io.Reader, contentLength int64) *ContentLengthReader

+ func (cr *ContentLengthReader) Read(p []byte) (int, error)

+ type SSECHeaders struct

+ Algorithm *string

+ Key *string

+ KeyMD5 *string

+ func ExtractSSECHeaders(ctx fiber.Ctx) SSECHeaders

+ func ParseCopySourceSSECHeaders(ctx fiber.Ctx) (SSECHeaders, error)

+ func ParseSSECFields(fields map[string]string) (SSECHeaders, error)

+ func ParseSSECHeaders(ctx fiber.Ctx) (SSECHeaders, error)

Sep 4, 2026

Changes in this version

+ func MergeDeleteObjectsResult(objects []types.ObjectIdentifier, checkErrs []error, ...) s3response.DeleteResult

Jun 24, 2026

Changes in this version

+ func ValidateWebsiteRedirectLocation(location string) error

type ContextKey

+ const ContextKeyWebsiteConfig

Jun 1, 2026

Changes in this version

+ const HeaderAmzID2

+ const HeaderAmzRequestID

+ func DetectResourceType(ctx *fiber.Ctx) s3err.ResourceType

+ func EnsureRequestIDs(ctx *fiber.Ctx) (requestID, hostID string)

+ func HexBytes(s string) string

+ func HostID(ctx *fiber.Ctx) string

+ func IsPresignedURLAuthV2(ctx *fiber.Ctx) bool

+ func IsValidSha256PayloadHeader(value string) bool

+ func NewS3HostID() string

+ func NewS3RequestID() string

+ func RequestID(ctx *fiber.Ctx) string

type ContextKey

+ const ContextKeyHostID

+ const ContextKeyRequestID

type HashType

+ const HashTypeContentMD5

+ const HashTypeSha512

+ const HashTypeXXHASH128

+ const HashTypeXXHASH3

+ const HashTypeXXHASH64

Apr 22, 2026

Changes in this version

+ type ListenerOptions struct

+ SocketPerm os.FileMode

Apr 2, 2026

Changes in this version

+ func AbsSocketPaths(addrs []string) ([]string, error)

+ func ConvertTaggingXMLToQueryString(data []byte) (string, error)

+ func ExtractMetadataFromFields(fields map[string]string) (map[string]string, error)

+ func IsUnixSocketPath(addr string) bool

+ func SignPostPolicy(base64Policy, yyyymmdd, region, secretKey string) (string, error)

type ChecksumValues

+ func ParseCalculatedChecksumFields(fields map[string]string) (ChecksumValues, error)

type ContextKey

+ const ContextKeyObjectPostResult

+ type CredentialsScope struct

+ Access string

+ Date string

+ Region string

+ func ParseCredentials(input string, errHandler CredsError) (*CredentialsScope, error)

+ type CredsError interface

+ IncorrectService func(string) s3err.APIError

+ IncorrectTerminal func(string) s3err.APIError

+ InvalidDateFormat func(string) s3err.APIError

+ MalformedCredential func() s3err.APIError

+ type MpFileReader interface

+ Length func() int64

+ type MpParseResult struct

+ ContentLength int64

+ Fields map[string]string

+ FileRdr MpFileReader

+ type MultipartParser struct

+ func NewMultipartParser(body io.Reader, boundary string, requestContentLength int64) (*MultipartParser, error)

+ func (mp *MultipartParser) Parse() (*MpParseResult, error)

Mar 3, 2026

Changes in this version

+ func NewMultiAddrListener(network, address string) (net.Listener, error)

+ func NewMultiAddrTLSListener(network, address string, ...) (net.Listener, error)

+ func ResolveHostnameIPs(address string) ([]string, error)

+ func TrimQuotes(str string) string

+ type MultiListener struct

+ func NewMultiListener(listeners ...net.Listener) *MultiListener

+ func (ml *MultiListener) Accept() (net.Conn, error)

+ func (ml *MultiListener) Addr() net.Addr

+ func (ml *MultiListener) Close() error

Feb 9, 2026

Changes in this version

+ const LimiterTypeMaxBuckets

+ const LimiterTypeMaxKeys

+ const LimiterTypeMaxParts

+ const LimiterTypeMaxUploads

+ const LimiterTypePartNumberMarker

+ const LimiterTypeVersionsMaxKeys

+ func NewTLSListener(network string, address string, ...) (net.Listener, error)

+ func ParseMaxLimiter(limiter string, lt LimiterType) (int32, error)

+ func ValidateNoACLHeaders(ctx *fiber.Ctx) error

+ type CertStorage struct

+ func NewCertStorage() *CertStorage

+ func (cs *CertStorage) GetCertificate(_ *tls.ClientHelloInfo) (*tls.Certificate, error)

+ func (cs *CertStorage) SetCertificate(certFile string, keyFile string) error

+ type LimiterType string

Jan 15, 2026

Changes in this version

+ func GenerateObjectLocation(ctx *fiber.Ctx, virtualDomain, bucket, object string) string

type ChunkReader

+ func (cr *ChunkReader) Algorithm() string

+ func (cr *ChunkReader) Checksum() string

type ContextKey

+ const ContextKeyBucketOwner

Dec 18, 2025

Changes in this version

+ func ParseDecodedContentLength(ctx *fiber.Ctx) (int64, error)

type UnsignedChunkReader

+ func (ucr *UnsignedChunkReader) Algorithm() string

+ func (ucr *UnsignedChunkReader) Checksum() string

Nov 20, 2025

Changes in this version

+ func IsAnonymousPayloadHashSupported(hash string) error

+ func IsPresignedURLAuth(ctx *fiber.Ctx) bool

+ func IsUnsignedPaylod(hash string) bool

+ func SetBucketNameValidationStrict(strict bool)

+ func ValidateVersionId(versionId string) error

type ChecksumValues

+ func ParseCompleteMpChecksumHeaders(ctx *fiber.Ctx) (ChecksumValues, error)

type ContextKey

+ const ContextKeyStack

Sep 16, 2025

Changes in this version

+ func ApplyOverride(original, override *string) *string

+ func GetQueryParam(ctx *fiber.Ctx, key string) *string

+ func ParseIfMatchSize(ctx *fiber.Ctx) *int64

+ func ParsePreconditionDateHeader(date string) *time.Time

+ func ParsePreconditionDateHeaders(ctx *fiber.Ctx, opts ...preconditionOpt) (*time.Time, *time.Time)

+ func ParsePreconditionMatchHeaders(ctx *fiber.Ctx, opts ...preconditionOpt) (*string, *string)

+ func WithCopySource() preconditionOpt

+ type ConditionalHeaders struct

+ IfMatch *string

+ IfModSince *time.Time

+ IfNoneMatch *string

+ IfUnmodeSince *time.Time

+ func ParsePreconditionHeaders(ctx *fiber.Ctx, opts ...preconditionOpt) ConditionalHeaders

Aug 26, 2025

Changes in this version

+ func ConvertPtrToStringPtr[T any](val *T) *string

+ func ConvertToStringPtr[T any](val T) *string

+ func FormatDatePtrToString(date *time.Time, format string) *string

+ func GetInt64(n *int64) int64

+ func GetStringPtr(str string) *string

+ func IsValidSh256PayloadHeader(value string) bool

+ func ValidateCopySource(copysource string) error

type ChecksumValues

+ func ParseCalculatedChecksumHeaders(ctx *fiber.Ctx) (ChecksumValues, error)

+ func ParseChecksumHeadersAndSdkAlgo(ctx *fiber.Ctx) (types.ChecksumAlgorithm, ChecksumValues, error)

type ContextKey

+ const ContextKeySkip

+ func (ck ContextKey) Delete(ctx *fiber.Ctx)

Jul 17, 2025 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Jul 4, 2025 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Changes in this version

+ func AddCRCChecksum(algo types.ChecksumAlgorithm, crc, partCrc string, partLen int64) (string, error)

+ func ExtractChecksumType(ctx *fiber.Ctx) (checksumType, error)

+ func FromSlash(path string) string

+ func IsChecksumComposable(algo types.ChecksumAlgorithm) bool

+ func IsObjectNameValid(name string) bool

+ func IsUnsignedStreamingPayload(str string) bool

+ type ContextKey string

+ const ContextKeyAccount

+ const ContextKeyAuthenticated

+ const ContextKeyBodyReader

+ const ContextKeyIsRoot

+ const ContextKeyParsedAcl

+ const ContextKeyPublicBucket

+ const ContextKeyRegion

+ const ContextKeyRootAccessKey

+ const ContextKeySkipResBodyLog

+ const ContextKeyStartTime

+ func (ck ContextKey) Get(ctx *fiber.Ctx) any

+ func (ck ContextKey) IsSet(ctx *fiber.Ctx) bool

+ func (ck ContextKey) Set(ctx *fiber.Ctx, val any)

+ func (ck ContextKey) Values() []ContextKey

May 27, 2025 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Apr 25, 2025 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Changes in this version

+ func ParseTagging(data []byte, limit TagLimit, debug bool) (map[string]string, error)

+ type ChecksumValues map[types.ChecksumAlgorithm]string

+ func (cv ChecksumValues) Headers() string

+ type TagLimit int

+ const TagLimitBucket

+ const TagLimitObject

Mar 18, 2025 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Mar 10, 2025 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Changes in this version

+ func Base64SumString(b []byte) string

+ func IsChecksumAlgorithmValid(alg types.ChecksumAlgorithm) error

+ func IsChecksumTypeValid(t types.ChecksumType) error

+ func IsStreamingPayload(str string) bool

+ func IsValidChecksum(checksum string, algorithm types.ChecksumAlgorithm) bool

+ func ParseChecksumHeaders(ctx *fiber.Ctx) (types.ChecksumAlgorithm, map[types.ChecksumAlgorithm]string, error)

+ func ParseCreateMpChecksumHeaders(ctx *fiber.Ctx) (types.ChecksumAlgorithm, types.ChecksumType, error)

+ type CompositeChecksumReader struct

+ func NewCompositeChecksumReader(ht HashType) (*CompositeChecksumReader, error)

+ func (ccr *CompositeChecksumReader) Process(checksum string) error

+ func (ccr *CompositeChecksumReader) Sum() string

type HashReader

+ func (hr *HashReader) SetReader(r io.Reader)

+ func (hr *HashReader) Type() HashType

type HashType

+ const HashTypeCRC32

+ const HashTypeCRC32C

+ const HashTypeCRC64NVME

+ const HashTypeSha1

+ const HashTypeSha256Hex

Feb 3, 2025 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Changes in this version

+ func NewSignedChunkReader(r io.Reader, authdata AuthData, region, secret string, date time.Time) (io.Reader, error)

+ func StreamResponseBody(ctx *fiber.Ctx, rdr io.ReadCloser) error

+ type UnsignedChunkReader struct

+ func NewUnsignedChunkReader(r io.Reader, ct checksumType) (*UnsignedChunkReader, error)

+ func (ucr *UnsignedChunkReader) Read(p []byte) (int, error)

Dec 7, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Oct 28, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Sep 18, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Aug 29, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Aug 6, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Jul 17, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Jul 11, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Changes in this version

+ func IsValidOwnership(val types.ObjectOwnership) bool

Jun 25, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Jun 11, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Jun 11, 2024 GO-2025-3925

  GO-2025-3925: Versity panic induced by AWS chunked data sent to port in github.com/versity/versitygw

Changes in this version

+ const HashTypeMd5

+ const HashTypeNone

+ const HashTypeSha256

+ func CheckPresignedSignature(ctx *fiber.Ctx, auth AuthData, secret string, debug bool) error

+ func CheckValidSignature(ctx *fiber.Ctx, auth AuthData, secret, checksum string, tdate time.Time, ...) error

+ func FilterObjectAttributes(attrs map[types.ObjectAttributes]struct{}, ...) s3response.GetObjectAttributesResult

+ func GetUserMetaData(headers *fasthttp.RequestHeader) (metadata map[string]string)

+ func IsBigDataAction(ctx *fiber.Ctx) bool

+ func IsSpecialPayload(str string) bool

+ func IsValidBucketName(bucket string) bool

+ func LogCtxDetails(ctx *fiber.Ctx, respBody []byte)

+ func Md5SumString(b []byte) string

+ func ParsObjectLockHdrs(ctx *fiber.Ctx) (*objLockCfg, error)

+ func ParseDeleteObjects(objs []types.ObjectIdentifier) (result []string)

+ func ParseObjectAttributes(ctx *fiber.Ctx) map[types.ObjectAttributes]struct

+ func ParseUint(str string) (int32, error)

+ func SetMetaHeaders(ctx *fiber.Ctx, meta map[string]string)

+ func SetResponseHeaders(ctx *fiber.Ctx, headers []CustomHeader)

+ func ValidateDate(date time.Time) error

+ type AuthData struct

+ Access string

+ Algorithm string

+ Date string

+ Region string

+ Signature string

+ SignedHeaders string

+ func ParseAuthorization(authorization string) (AuthData, error)

+ func ParsePresignedURIParts(ctx *fiber.Ctx) (AuthData, error)

+ type AuthReader struct

+ func NewAuthReader(ctx *fiber.Ctx, r io.Reader, auth AuthData, secret string, debug bool) *AuthReader

+ func (ar *AuthReader) Read(p []byte) (int, error)

+ type ChunkReader struct

+ func NewChunkReader(ctx *fiber.Ctx, r io.Reader, authdata AuthData, region, secret string, ...) (*ChunkReader, error)

+ func (cr *ChunkReader) Read(p []byte) (int, error)

+ type CustomHeader struct

+ Key string

+ Value string

+ type HashReader struct

+ func NewHashReader(r io.Reader, expectedSum string, ht HashType) (*HashReader, error)

+ func (hr *HashReader) Read(p []byte) (int, error)

+ func (hr *HashReader) Sum() string

+ type HashType string

+ type PresignedAuthReader struct

+ func NewPresignedAuthReader(ctx *fiber.Ctx, r io.Reader, auth AuthData, secret string, debug bool) *PresignedAuthReader

+ func (pr *PresignedAuthReader) Read(p []byte) (int, error)