IMPORTCTL(1) importctl IMPORTCTL(1) (NAME) importctl - (SYNOPSIS) importctl [OPTIONS...] {COMMAND} [NAME...] (DESCRIPTION) importctl systemd-importd.service(8) . importctl ( DDI) (tarball) OCI . (class) : o (VM) systemd-vmspawn(1) systemd-nspawn(1) machinectl(1) . o ( ) portablectl(1) . o (sysext) systemd-sysext(8) . o (confext) systemd-confext(8) . --class= : . +------------------+-----------------------------+ | (Class) | | | | (Directory) | +------------------+-----------------------------+ |"machine" | /var/lib/machines/ | +------------------+-----------------------------+ |"portable" | /var/lib/portables/ | +------------------+-----------------------------+ |"sysext" | /var/lib/extensions/ | +------------------+-----------------------------+ |"confext" | /var/lib/confexts/ | +------------------+-----------------------------+ (COMMANDS) : pull-tar URL [NAME] .tar URL --class= . URL "http://" "https://" .tar .tar.gz .tar.xz .tar.bz2 . URL . --verify=no . .sha256 (detached) .sha256.asc .sha256.gpg SHA256SUMS SHA256SUMS.asc SHA256SUMS.gpg. URL .tar . --verify=checksum SHA256 .sha256 SHA256SUMS . --verify=signature sha GPG .sha256 SHA256SUMS . /usr/lib/systemd/import-pubring.pgp /etc/systemd/import-pubring.pgp . --keep-download=yes (subvolume)/ URL ETag HTTP ( HTTP ETag[1] ). . URL . "-" . Control-c . cancel-transfer . 256. pull-raw URL [NAME] .raw URL --class= . URL "http://" "https://" . qcow2 (raw) .gz .xz .bz2 . URL . raw tar ( ). qcow2 raw . --keep-download=yes URL ETag HTTP . . URL . "-" . Control-c . cancel-transfer . 256. pull-oci REF [NAME] OCI --class= . OCI "library/nginx". URL . HTTPS . Control-c . cancel-transfer . 260. import-tar FILE [NAME], import-raw FILE [NAME] TAR RAW --class= . import-tar tar(1) xz(1) gzip(1) zstd(1) bzip2(1) . / . import-raw qcow2 (raw) xz gzip zstd bzip2 . ( ) . "-" . . list cancel-transfer . 256. import-fs DIRECTORY [NAME] --class= import-tar import-raw . btrfs(8) . 256. export-tar NAME [FILE], export-raw NAME [FILE] TAR RAW . . TAR RAW . ".gz" gzip(1) ".xz" xz(1) ".zst" zstd(1) ".bz2" bzip2(1) . . . --format= . . list cancel-transfer . TAR RAW . 256. list-transfer . 256. cancel-transfer ID... . list . 256. list-images / . 256. (OPTIONS) : --read-only pull-raw pull-tar import-raw import-tar import-fs . 256. --verify= . "no" "checksum" "signature" . "no" . "checksum" . "signature" . "signature" . "signature" . 256. --force . 256. --format= export-tar export-raw . "uncompressed" "xz" "gzip" "zst" "bzip2" . . 256. -q, --quiet . 256. -H, --host= . "@" . ssh ":" "/" . SSH . machinectl -H HOST . IPv6 . -M, --machine= systemd-importd.service(8) . 256. --class=, -m, -P, -S, -C . . --class= "machine" "portable" "sysext" "confext" . -m -P -S -C --class=machine --class=portable --class=sysext --class=confext . --keep-download= --class=machine true false . 256. --keep-download=, -N . pull-raw pull-tar . --class=machine true false . -N --keep-download=no . 256. --json=MODE JSON . : "short" ( ) "pretty" ( ) "off" ( JSON ). -j --json=pretty --json=short . --no-pager . --no-legend (legend) . --no-ask-password . -h, --help . --version . (EXAMPLES) . TAR # importctl pull-tar -mN https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64-root.tar.xz # systemd-nspawn -M jammy-server-cloudimg-amd64-root .tar systemd-nspawn(1) . . RAW # importctl pull-raw -mN \ https://cloud-images.ubuntu.com/jammy/current/jammy-server-cloudimg-amd64-disk-kvm.img \ jammy # systemd-firstboot --image=/var/lib/machines/jammy.raw --prompt-root-password --force # machinectl start jammy # machinectl login jammy .raw "jammy" . systemd-firstboot(1) . . . . tar # importctl export-tar -m fedora myfedora.tar.xz "fedora" tar xz myfedora.tar.xz . (EXIT STATUS) 0 . (ENVIRONMENT) $SYSTEMD_LOG_LEVEL () ( ). . ( ) : emerg alert crit err warning notice info debug 0...7. syslog(3) . console syslog kmsg journal ( SYSTEMD_LOG_LEVEL=debug,console:info debug info ). . $SYSTEMD_LOG_COLOR . (true) tty . journalctl(1) . $SYSTEMD_LOG_TIME . . journalctl(1) . $SYSTEMD_LOG_LOCATION . . . . $SYSTEMD_LOG_TID . (TID) . . . $SYSTEMD_LOG_TARGET . : console ( tty ) console-prefixed ( tty "facility" syslog(3) ) kmsg ( ) journal ( ) journal-or-kmsg ( kmsg) auto ( ) null ( ). $SYSTEMD_LOG_RATELIMIT_KMSG kmsg . . "true" . systemd kmsg . $SYSTEMD_PAGER, $PAGER --no-pager . $SYSTEMD_PAGER $PAGER . $SYSTEMD_PAGER $PAGER less(1) more(1) . . "cat" --no-pager . : $SYSTEMD_PAGERSECURE $SYSTEMD_PAGER $PAGER ( "cat" "") . $SYSTEMD_LESS less ( "FRSXMK"). : K Ctrl+C . less Ctrl+C . $SYSTEMD_LESS "K" less Ctrl+C . X termcap . . . $LESS less systemd . less(1) . $SYSTEMD_LESSCHARSET less ( "utf-8" UTF-8 ). $LESSCHARSET less systemd . $SYSTEMD_PAGERSECURE less(1) <<>> . sudo(8) pkexec(1) . . << >> ( ). << >> --no-pager PAGER=cat . . true << >> . << >> LESSSECURE=1 . less(1) << >> . false . SYSTEMD_PAGERSECURE=0 . $SYSTEMD_PAGERSECURE systemd << >> . (UID) ( geteuid(2) sd_pid_get_owner_uid(3) ) sudo(8) ( $SUDO_UID [2]) << >> . SYSTEMD_PAGERSECURE=1 << >> . . $SYSTEMD_PAGERSECURE . $SYSTEMD_PAGER $PAGER $SYSTEMD_PAGERSECURE . $SYSTEMD_COLORS . () systemd . $COLORTERM "truecolor" "24bit" $NO_COLOR $TERM . true $NO_COLOR . false . "16", "256", "24bit" ANSI . "auto-16", "auto-256", "auto-24bit" $TERM . $SYSTEMD_URLIFY . . systemd $TERM . (SEE ALSO) systemd(1), systemd-importd.service(8), systemd-nspawn(1), systemd- vmspawn(1), machinectl(1), portablectl(1), systemd-sysext(8), systemd- confext(8), tar(1), xz(1), gzip(1), zstd(1), bzip2(1) (NOTES) 1. HTTP ETag https://en.wikipedia.org/wiki/HTTP_ETag 2. $SUDO_UID . systemd 261.2 IMPORTCTL(1)