summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLennartPoettering <LennartPoettering@web>2016-02-23 10:37:52 -0800
committerwww <iki-www@freedesktop.org>2016-02-23 10:37:52 -0800
commit942501465cf03b12734d9def5d8ee6de89ea6b63 (patch)
tree5d499182fbbc1a915bf05291c423ee32de8bf12b
parent5b304974d96e8f21126e7d26f3d1ac6bdcf8ba8e (diff)
-rw-r--r--Software/systemd/importd.mdwn2
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.