diff options
Diffstat (limited to 'upstream/fedora-rawhide/man5/org.freedesktop.portable1.5')
| -rw-r--r-- | upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 | 53 |
1 files changed, 39 insertions, 14 deletions
diff --git a/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 b/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 index 5fa495f0..12d7a7cb 100644 --- a/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 +++ b/upstream/fedora-rawhide/man5/org.freedesktop.portable1.5 @@ -1,5 +1,5 @@ '\" t -.TH "ORG\&.FREEDESKTOP\&.PORTABLE1" "5" "" "systemd 255" "org.freedesktop.portable1" +.TH "ORG\&.FREEDESKTOP\&.PORTABLE1" "5" "" "systemd 256~rc3" "org.freedesktop.portable1" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -265,7 +265,7 @@ property for a list of available profiles), a boolean indicating whether to atta .sp -1 .IP \(bu 2.3 .\} -(null) +(empty) .RE .sp .RS 4 @@ -290,7 +290,24 @@ copy symlink .RE .sp -This method returns the list of changes applied to the system (for example, which unit was added and is now available as a system service)\&. Each change is represented as a triplet of strings: the type of change applied, the path on which it was applied, and the source (if any)\&. The type of change applied will be one of the following possible values: +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +mixed +.RE +.sp +If an empty string is passed the security profile drop\-ins and images will be symlinked while unit files will be copied, +\fIcopy\fR +will copy, +\fIsymlink\fR +will prefer linking if possible (e\&.g\&.: a unit has to be copied out of an image), and +\fImixed\fR +will prefer linking the resources owned by the OS (e\&.g\&.: the portable profile located within the host\*(Aqs /usr/ tree) but will copy the resources owned by the portable image (e\&.g\&.: the unit files and the images)\&. This method returns the list of changes applied to the system (for example, which unit was added and is now available as a system service)\&. Each change is represented as a triplet of strings: the type of change applied, the path on which it was applied, and the source (if any)\&. The type of change applied will be one of the following possible values: .sp .RS 4 .ie n \{\ @@ -336,7 +353,19 @@ write mkdir .RE .sp -Note that an image cannot be attached if a unit that it contains is already present on the system\&. +Note that an image cannot be attached if a unit that it contains is already present on the system\&. Note that this method returns only after all the listed operations are completed, and due to the I/O involved it might take some time\&. +.PP +In place of the image path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. +.PP +In place of the directory path a +"\&.v/" +versioned directory may be specified, see +\fBsystemd.v\fR(7) +for details\&. .PP \fBAttachImageWithExtensions()\fR attaches a portable image to the system\&. This method is a superset of @@ -364,15 +393,13 @@ detaches a portable image from the system\&. This method takes an image path or unlink .RE .sp -Note that an image cannot be detached if a unit that it contains is running\&. +Note that an image cannot be detached if a unit that it contains is running\&. Note that this method returns only after all the listed operations are completed, and due to the I/O involved it might take some time\&. .PP \fBDetachImageWithExtensions()\fR detaches a portable image from the system\&. This method is a superset of \fBDetachImage()\fR with the addition of a list of extensions as input parameter, which were overlaid on top of the main image via -\fBAttachImageWithExtensions()\fR\&. The -\fIflag\fR -parameter is currently unused and reserved for future purposes\&. +\fBAttachImageWithExtensions()\fR\&. .PP \fBReattachImage()\fR combines the effects of the @@ -395,9 +422,7 @@ with the addition of a list of extensions as input parameter, which will be over entry on \fBsystemd.exec\fR(5) and -\fBsystemd-sysext\fR(8)\&. The -\fIflag\fR -parameter is currently unused and reserved for future purposes +\fBsystemd-sysext\fR(8)\&. .PP \fBRemoveImage()\fR removes the image with the specified name\&. @@ -418,11 +443,11 @@ and \fBReattachImageWithExtensions()\fR methods take in options as flags instead of booleans to allow for extendability\&. \fISD_SYSTEMD_PORTABLE_FORCE_ATTACH\fR -will cause safety checks that ensure the units are not running while the new image is attached or detached to be skipped\&. +will bypass the safety checks that ensure the units are not running while the image is attached or detached\&. \fISD_SYSTEMD_PORTABLE_FORCE_EXTENSION\fR -will cause the check that the +will bypass the check that ensures the extension\-release\&.\fINAME\fR -file in the extension image matches the image name to be skipped\&. They are defined as follows: +file in the extension image matches the image name\&. They are defined as follows: .sp .if n \{\ .RS 4 |