umoci-unpack(1)(#)                     -                    umoci-unpack(1)(#)

Aleksa Sarai SEPTEMBER 2018


<?><?><?> (NAME)
       umoci unpack - <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> OCI <?><?>
       <?><?> runtime bundle



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       umoci unpack --image=image[:tag] [--rootless] [--uid-map=value] [--uid-
       map=value] [--keep-dirlinks] bundle



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> (<?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>) <?><?> <?><?> OCI
       runtime bundle <?><?> <?><?><?><?> bundle <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> OCI
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> mtree(8) <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?>) <?><?><?><?> umoci-
       repack(1) <?><?><?><?><?> <?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> OCI <?><?><?><?> <?><?><?><?>.



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


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


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


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


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


       --keep-dirlinks
         <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> rsync
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.



<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> skopeo(1) <?><?> <?><?>
       <?><?><?><?><?><?><?> docker(1) <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       OCI runtime bundle <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> runc(8)
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> umoci-repack(1) <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       % skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
       # umoci unpack --image image bundle
       # runc run -b bundle ctr
       [ container session ]
       # umoci repack --image image bundle


       <?><?> <?><?><?><?><?><?><?> <?><?> --rootless <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> (root) <?><?><?><?> <?><?><?>. umoci
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> runc(8) <?><?><?><?><?><?> <?><?><?>.

       % skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
       % umoci unpack --image image --rootless bundle
       % runc --root $HOME/runc run -b bundle ctr
       [ rootless container session ]
       % umoci repack --image image --rootless bundle



<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       umoci(1), umoci-repack(1), runc(8)

unpack                               umoci                  umoci-unpack(1)(#)