image

Oct 28, 2026

Changes in this version

+ const MaxLayoutEntries

+ func IsDangling(name string) bool

+ func ReadLayoutTar(r io.Reader, lim Limits) (fs.FS, error)

type Config

+ History []History

type ExecConfig

+ ArgsEscaped bool

+ Healthcheck *HealthConfig

+ OnBuild []string

+ Shell []string

+ type HealthConfig struct

+ Interval int64

+ Retries int

+ StartInterval int64

+ StartPeriod int64

+ Test []string

+ Timeout int64

+ type History struct

+ Author string

+ Comment string

+ Created string

+ CreatedBy string

+ EmptyLayer bool

type Image

+ func (i *Image) DiffIDs() []string

type Store

+ func (s *Store) KeepDangling(m Digest) error

Oct 26, 2026

Changes in this version

+ const MediaTypePkgxLayerZst

Oct 26, 2026

Changes in this version

+ type Backend interface

+ DeleteBlob func(hex string) error

+ HasBlob func(hex string) bool

+ ListBlobs func() ([]string, error)

+ LoadRefs func() ([]byte, error)

+ OpenBlob func(hex string) (io.ReadCloser, error)

+ PutBlob func(hex string, r io.Reader) error

+ SaveRefs func(b []byte) error

+ type DirBackend struct

+ func NewDirBackend(root string) (*DirBackend, error)

+ func (b *DirBackend) DeleteBlob(hex string) error

+ func (b *DirBackend) HasBlob(hex string) bool

+ func (b *DirBackend) ListBlobs() ([]string, error)

+ func (b *DirBackend) LoadRefs() ([]byte, error)

+ func (b *DirBackend) OpenBlob(hex string) (io.ReadCloser, error)

+ func (b *DirBackend) PutBlob(hex string, r io.Reader) error

+ func (b *DirBackend) SaveRefs(raw []byte) error

+ type MemoryBackend struct

+ MaxBytes int64

+ func NewMemoryBackend(maxBytes int64) *MemoryBackend

+ func (m *MemoryBackend) DeleteBlob(hex string) error

+ func (m *MemoryBackend) HasBlob(hex string) bool

+ func (m *MemoryBackend) ListBlobs() ([]string, error)

+ func (m *MemoryBackend) LoadRefs() ([]byte, error)

+ func (m *MemoryBackend) OpenBlob(hex string) (io.ReadCloser, error)

+ func (m *MemoryBackend) PutBlob(hex string, r io.Reader) error

+ func (m *MemoryBackend) SaveRefs(b []byte) error

type RegistryOptions

+ Mirrors map[string]string

type Store

+ func NewStore(b Backend) (*Store, error)

Oct 26, 2026

Changes in this version

+ const AnnotationRefName

+ const AnnotationTitle

+ const DefaultDomain

+ const DefaultTag

+ const DockerHubRegistry

+ const LayoutPrefix

+ const MediaTypeDockerConfig

+ const MediaTypeDockerLayerGz

+ const MediaTypeDockerList

+ const MediaTypeDockerManifest

+ const MediaTypeOCIConfig

+ const MediaTypeOCIIndex

+ const MediaTypeOCILayer

+ const MediaTypeOCILayerGz

+ const MediaTypeOCILayerZst

+ const MediaTypeOCIManifest

+ const MediaTypeWasmConfig

+ const MediaTypeWasmLayer

+ var DefaultLimits = Limits

+ var ErrDigest = errors.New("digest")

+ var ErrInvalid = errors.New("invalid OCI document")

+ var ErrNoPlatform = fmt.Errorf("no matching manifest for %s in the index", WasmPlatform)

+ var ErrNotFound = errors.New("not found")

+ var ErrTooLarge = errors.New("content too large")

+ var WasmPlatform = Platform

+ func CheckPlatform(c *Config) error

+ func IsIndexType(mt string) bool

+ func IsLayoutRef(s string) bool

+ func IsManifestType(mt string) bool

+ func NewVerifyingReader(r io.Reader, d Digest, size int64) io.Reader

+ func NormalizeName(s string) (string, error)

+ func ParseChallenge(h string) (scheme string, params map[string]string)

+ func SupportedLayer(mt string) bool

+ func ValidateDescriptor(d *Descriptor) error

+ type Config struct

+ Architecture string

+ Author string

+ Config ExecConfig

+ Created string

+ LayerDigests []string

+ OS string

+ RootFS RootFS

+ Variant string

+ func ParseConfig(b []byte, lim Limits) (*Config, error)

+ type Descriptor struct

+ Annotations map[string]string

+ ArtifactType string

+ Data []byte

+ Digest Digest

+ MediaType string

+ Platform *Platform

+ Size int64

+ URLs []string

+ func SelectManifest(x *Index, want Platform) (Descriptor, error)

+ type Digest string

+ func FromBytes(b []byte) Digest

+ func ParseDigest(s string) (Digest, error)

+ func (d Digest) Algorithm() string

+ func (d Digest) Encoded() string

+ func (d Digest) Short() string

+ func (d Digest) String() string

+ func (d Digest) Verify(b []byte) error

+ type ExecConfig struct

+ Cmd []string

+ Entrypoint []string

+ Env []string

+ ExposedPorts map[string]struct{}

+ Labels map[string]string

+ StopSignal string

+ User string

+ Volumes map[string]struct{}

+ WorkingDir string

+ type Image struct

+ Config *Config

+ ConfigDigest Digest

+ Manifest *Manifest

+ ManifestDigest Digest

+ Size int64

+ Wasm bool

+ func (i *Image) ID() Digest

+ type Index struct

+ Annotations map[string]string

+ ArtifactType string

+ Manifests []Descriptor

+ MediaType string

+ SchemaVersion int

+ Subject *Descriptor

+ func ParseIndex(b []byte, lim Limits) (*Index, error)

+ type Kind int

+ const KindIndex

+ const KindManifest

+ const KindUnknown

+ func Sniff(declared string, b []byte) Kind

+ type LayoutRef struct

+ Dir string

+ RefName string

+ func ParseLayoutRef(s string) (LayoutRef, error)

+ func (r LayoutRef) LocalName() (string, error)

+ type LayoutSource struct

+ func OpenLayout(fsys fs.FS, refName string, lim Limits) (*LayoutSource, error)

+ func OpenLayoutDir(r LayoutRef, lim Limits) (*LayoutSource, error)

+ func (l *LayoutSource) Fetch(_ context.Context, d Descriptor) (io.ReadCloser, error)

+ func (l *LayoutSource) Index() (*Index, error)

+ func (l *LayoutSource) Resolve(context.Context) (Descriptor, error)

+ type Limits struct

+ MaxBlobBytes int64

+ MaxConfigBytes int64

+ MaxImageBytes int64

+ MaxIndexEntries int

+ MaxLayers int

+ MaxManifestBytes int64

+ type Manifest struct

+ Annotations map[string]string

+ ArtifactType string

+ Config Descriptor

+ Layers []Descriptor

+ MediaType string

+ SchemaVersion int

+ Subject *Descriptor

+ func ParseManifest(b []byte, lim Limits) (*Manifest, error)

+ type NamedRef struct

+ Name string

+ type Platform struct

+ Architecture string

+ OS string

+ OSFeatures []string

+ OSVersion string

+ Variant string

+ func (p Platform) String() string

+ type Progress func(id, status string)

+ type PullResult struct

+ Downloaded bool

+ Image *Image

+ RepoDigest Digest

+ func Pull(ctx context.Context, st *Store, src Source, lim Limits, progress Progress) (*PullResult, error)

+ type Ref struct

+ Manifest Digest

+ RepoDigest Digest

+ type Reference struct

+ Digest Digest

+ Domain string

+ Path string

+ Tag string

+ func ParseReference(s string) (Reference, error)

+ func (r Reference) Name() string

+ func (r Reference) Object() string

+ func (r Reference) RegistryHost() string

+ func (r Reference) String() string

+ type RegistryError struct

+ Code string

+ Msg string

+ Status int

+ func (e *RegistryError) Error() string

+ func (e *RegistryError) Is(target error) bool

+ type RegistryOptions struct

+ Client *http.Client

+ Insecure []string

+ UserAgent string

+ type RegistrySource struct

+ func NewRegistrySource(ref Reference, opt RegistryOptions, lim Limits) *RegistrySource

+ func (r *RegistrySource) Fetch(ctx context.Context, d Descriptor) (io.ReadCloser, error)

+ func (r *RegistrySource) Resolve(ctx context.Context) (Descriptor, error)

+ type RootFS struct

+ DiffIDs []string

+ Type string

+ type Source interface

+ Fetch func(ctx context.Context, d Descriptor) (io.ReadCloser, error)

+ Resolve func(ctx context.Context) (Descriptor, error)

+ func OpenSource(s string, opt RegistryOptions, lim Limits) (Source, string, error)

+ type Store struct

+ func OpenStore(root string) (*Store, error)

+ func (s *Store) GC(lim Limits) ([]Digest, error)

+ func (s *Store) Has(d Digest) bool

+ func (s *Store) Image(manifest Digest, lim Limits) (*Image, error)

+ func (s *Store) Ingest(desc Descriptor, r io.Reader) error

+ func (s *Store) Names() []NamedRef

+ func (s *Store) Open(d Digest) (*os.File, error)

+ func (s *Store) ReadBlob(d Digest, max int64) ([]byte, error)

+ func (s *Store) Resolve(name string) (Ref, bool)

+ func (s *Store) Tag(name string, r Ref) error

+ func (s *Store) Untag(name string) (bool, error)