diff options
author | LennartPoettering <LennartPoettering@web> | 2016-02-23 10:37:52 -0800 |
---|---|---|
committer | www <iki-www@freedesktop.org> | 2016-02-23 10:37:52 -0800 |
commit | 942501465cf03b12734d9def5d8ee6de89ea6b63 (patch) | |
tree | 5d499182fbbc1a915bf05291c423ee32de8bf12b | |
parent | 5b304974d96e8f21126e7d26f3d1ac6bdcf8ba8e (diff) |
-rw-r--r-- | Software/systemd/importd.mdwn | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/Software/systemd/importd.mdwn b/Software/systemd/importd.mdwn index 83fc5762..45361a39 100644 --- a/Software/systemd/importd.mdwn +++ b/Software/systemd/importd.mdwn @@ -72,7 +72,7 @@ The service exposes the following interfaces on the Manager object on the bus: **ExportTar()** and **ExportRaw()** implement the reverse operation, and may be used to export a system image in order to place it in a tar or raw image. They take the machine name to export as first parameter, followed by a file descriptor (opened for writing) where the tar or raw file will be written. It may either reference a file on disk or a pipe/socket. The third argument specifies in which compression format to write the image. It takes one of `uncompressed`, `xz`, `bzip2` or `gzip`, depending on which compression scheme is required. The image written to the specified file descriptor will be a tar file in case of `ExportTar()` or a raw disk image in case of `ExportRaw()`. Note that currently raw disk images may not be exported as tar files, and vice versa, however this restriction might be lifted eventually. The call returns a transfer identifier and object path for cancelling or tracking the export operation, similar to `ImportTar()` or `ImportRaw()` described above. -**PullTar()** and **PullRaw()** may be used to download, verify and import a system image from a web site. They take an URL argument, that should reference a tar or raw file on the `http://` or `https://` protocols, possibly compressed with xz, bzip2 or gzip. The second argument is a local name for the image. It should be suitable as hostname, similar to the matching argument of the **ImportTar()** and ImportRaw()** calls above. The third argument indicates the verification mode for the image. It may be one of `no`, `checksum`, `signature`. `no` turns of any kind of verification of the image; `checksum` looks for a `SHA256SUM` file next to the downloaded image, and verifies any SHA256 hash value in that file again the image; `signature` does the same but also tries to authenticate the `SHA256SUM` file via `gpg` first. The last argument indicates whether to replace a possibly pre-existing image with the same local name (if true), or whether to fail (if false). Like the import and export calls above these calls return a pair of transfer identifier and object path for the ongoing download. +**PullTar()** and **PullRaw()** may be used to download, verify and import a system image from a web site. They take an URL argument, that should reference a tar or raw file on the `http://` or `https://` protocols, possibly compressed with xz, bzip2 or gzip. The second argument is a local name for the image. It should be suitable as hostname, similar to the matching argument of the `ImportTar()` and `ImportRaw()` calls above. The third argument indicates the verification mode for the image. It may be one of `no`, `checksum`, `signature`. `no` turns of any kind of verification of the image; `checksum` looks for a `SHA256SUM` file next to the downloaded image, and verifies any SHA256 hash value in that file again the image; `signature` does the same but also tries to authenticate the `SHA256SUM` file via `gpg` first. The last argument indicates whether to replace a possibly pre-existing image with the same local name (if true), or whether to fail (if false). Like the import and export calls above these calls return a pair of transfer identifier and object path for the ongoing download. **ListTransfers()** returns a list of ongoing import, export or download operations, as created with the six calls described above. It returns an array of structures, which consist of the numeric transfer identifier, a string indicating the operation (one of `import-tar`, `import-raw`, `export-tar`, `export-raw`, `pull-tar` or `pull-raw`), a string describing the remote file (in case of download operations this is the source URL, in case of import/export operations this is a short string describing the file descriptor passed in), a string with the local machine image name, a progress value between 0.0 (for 0%) and 1.0 (for 100%), as well as the transfer object path. |