umoci-insert(1)(#)                     -                    umoci-insert(1)(#)

Aleksa Sarai SEPTEMBER 2018


<?><?><?> (NAME)
       umoci insert - <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       OCI



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       umoci insert --image=image[:tag] [--tag=new-tag]
       [--compress=compression-type] [--opaque] [--rootless] [--uid-map=value]
       [--uid-map=value] [--no-history] [--history.comment=comment]
       [--history.created_by=created_by] [--history.author=author] [--history-
       created=date] source target


       umoci insert [options] --whiteout target



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> source <?><?>
       <?><?> <?><?><?><?><?> OCI <?><?><?><?><?><?><?><?> <?><?><?><?>
       --image <?><?><?> <?><?><?><?><?><?> -- <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       --tag <?><?> <?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> source <?><?> <?><?><?> target
       <?><?><?><?><?> <?><?><?><?><?><?>. source <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>.
       <?><?><?> --opaque <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> target <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?> <?><?><?><?><?><?>
       target <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>) <?><?><?>
       <?><?><?><?><?> <?><?>.


       <?><?> <?><?><?> <?><?><?><?> <?><?> <<<?><?><?><?> <?><?><?>>>
       (deletion entry) <?><?><?><?> <?><?><?><?><?> OCI <?><?><?><?> target
       <?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       whiteout <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.


       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> (<?><?>
       <?><?><?><?><?><?><?><?>) <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       (secrets) <?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> umoci-
       config(1) <?> --config.volume <?><?> <?><?><?><?><?><?>.


       <?><?><?> --no-history <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> OCI <?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> --history. <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>). <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> umoci-stat(1) <?><?> <?><?><?><?><?><?>.



<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> umoci(1)
       <?><?><?><?><?> <?><?><?><?><?><?><?>.


       --image=image[:tag]
         <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?><?> <?><?><?>
       file <?><?> path <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
       image <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> OCI
       <?><?><?><?><?> <?><?><?><?> <?> tag <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?> tag <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> "latest" <?><?><?><?><?> <?><?><?>.


       --tag=new-tag
         <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> --image <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?>.


       --compress=compression-type
         <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       none<?> gzip <?> zstd. <?><?><?><?><?> umoci-unpack(1)
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> --compress <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

         <?><?><?><?><?> <?><?><?><?><?> auto <?><?><?><?> <?><?><?><?><?><?>
       umoci(1) <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       (<?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>). <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> auto <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> none <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       tar(1) <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

         <?><?><?> <?><?><?> compression-type <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> auto <?><?><?><?><?> <?><?><?>.


       --opaque
         (<?><?> <?><?><?> <?><?><?><?><?><?> target <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?>.) <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> (opaque whiteout) <?><?><?><?>
       target <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> target <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       target <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> source <?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.


       --whiteout
         <?><?> <?><?><?><?> <?><?><?> <?><?><?><?> target <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.


       --rootless
         <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       (rootless) <?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> umoci-insert(1)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> --uid-
       map=0:$(id -u):1 <?> --gid-map=0:$(id -g):1 <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.


       --uid-map=value
         <?><?> <?><?><?><?><?> UID <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> user_namespaces(7) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?> <?><?><?><?> container:host[:size]
       <?><?><?>.


       --gid-map=value
         <?><?> <?><?><?><?><?> GID <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> user_namespaces(7) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?> <?><?><?><?> container:host[:size]
       <?><?><?>.


       --no-history
         <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?> umoci-
       insert(1) <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> -- <?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>.


       --history.comment=comment
         <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> umoci(1) <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>.


       --history.created_by=created_by
         <?><?><?><?> CreatedBy <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> umoci(1) <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?>.


       --history.author=author
         <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (Author) <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> <?><?> umoci-config(1)
       <?><?><?><?><?> <?><?><?>.


       --history-created=date
         <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> ISO8601
       <?><?><?><?> (date(1) <?><?> <?><?><?><?><?><?>). <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> mybinary <?><?> <?><?>
       <?><?><?><?> /usr/bin/mybinary <?> <?><?> <?><?><?><?><?><?><?><?><?>
       myconfigdir <?><?> <?><?> <?><?><?><?> /etc/myconfigdir <?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?> /etc/myconfigdir <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>).

       % umoci insert --image oci:foo mybinary /usr/bin/mybinary
       % umoci insert --image oci:foo myconfigdir /etc/myconfigdir


       <?> <?><?> <?><?><?> <?><?><?><?><?><?><?> /usr/bin/mybinary <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?> <?><?> /etc <?><?> <?><?> myetcdir
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> /etc <?><?><?><?><?> <?><?><?><?><?> umoci-unpack(1)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>).

       % umoci insert --image oci:foo --whiteout /usr/bin/mybinary
       % umoci insert --image oci:foo --opaque myetcdir /etc



<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       umoci(1), umoci-repack(1), umoci-raw-add-layer(1)

insert                               umoci                  umoci-insert(1)(#)