umoci(1)(#)                          umoci                         umoci(1)(#)

Aleksa Sarai SEPTEMBER 2018


NAME
       umoci - umoci modifies Open Container images



SYNOPSIS
       umoci [--help|-h] [--version|-v] [--log={debug|info|warn|error|fatal}]
       [--verbose] command [args]



DESCRIPTION
       umoci is a tool that allows for high-level modification of an OCI image
       layout and its tagged images. While umoci attempts to abstract the OCI
       image specification specifics, it is recommended that users of this
       tool read through the specification
       <https://github.com/opencontainers/image-spec> to make sure they
       understand the rough idea.


       umoci is unique in that it is, at the time of writing, the first tool
       to allow for arbitrary modification of an OCI image in a high-level
       fashion (where all of the different blobs in an OCI image are all
       managed by umoci when doing a high-level operation such as umoci-
       repack(1)).



GLOBAL OPTIONS
       --help, -h
         Print usage statement.


       --version, -v
         Print the version.


       --cpu-profile=filename
         Generate a CPU profile during umoci's execution and save it to
       filename.
         This file is stored in Go's pprof
       <https://golang.org/pkg/runtime/pprof/> format and can be analysed
       using go
         tool pprof or similar tools.


       --log={debug|info|warn|error|fatal}
         Set the logging level. The default is "warn".


       --verbose
         Alias for --log=info.



COMMANDS
       init
         Create a new OCI layout. See umoci-init(1) for more detailed usage
         information.


       new
         Creates a blank tagged OCI image. See umoci-new(1) for more detailed
         usage information.


       unpack
         Unpacks a tagged image into an OCI runtime bundle. See umoci-
       unpack(1)
         for more detailed usage information.


       repack
         Repacks an OCI runtime bundle into a tagged image. See umoci-
       repack(1)
         for more detailed usage information.


       config
         Modifies the image configuration of an OCI image. See umoci-config(1)
       for
         more detailed usage information.


       stat
         Displays status information of an image manifest. See umoci-stat(1)
       for
         more detailed usage information.


       tag
         Creates a new tag in an OCI image. See umoci-tag(1) for more detailed
         usage information.


       remove, rm
         Removes a tag from an OCI image. See umoci-remove(1) for more
       detailed
         usage information.


       list, ls
         Lists the set of tags in an OCI image. See umoci-list(1) for more
         detailed usage information.


       gc
         Garbage collects all unreferenced OCI image blobs. See umoci-gc(1)
       for
         more detailed usage information.



SEE ALSO
       umoci-init(1), umoci-new(1), umoci-unpack(1), umoci-repack(1), umoci-
       config(1), umoci-stat(1), umoci-tag(1), umoci-remove(1), umoci-list(1),
       umoci-gc(1), skopeo(1)

-                                    umoci                         umoci(1)(#)