diff options
Diffstat (limited to 'upstream/opensuse-tumbleweed/man5/sysupdate.d.5')
| -rw-r--r-- | upstream/opensuse-tumbleweed/man5/sysupdate.d.5 | 62 |
1 files changed, 59 insertions, 3 deletions
diff --git a/upstream/opensuse-tumbleweed/man5/sysupdate.d.5 b/upstream/opensuse-tumbleweed/man5/sysupdate.d.5 index d5413f55..456bdb01 100644 --- a/upstream/opensuse-tumbleweed/man5/sysupdate.d.5 +++ b/upstream/opensuse-tumbleweed/man5/sysupdate.d.5 @@ -1,5 +1,5 @@ '\" t -.TH "SYSUPDATE\&.D" "5" "" "systemd 254" "sysupdate.d" +.TH "SYSUPDATE\&.D" "5" "" "systemd 255" "sysupdate.d" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -637,6 +637,8 @@ This section defines general properties of this transfer\&. \fIMinVersion=\fR .RS 4 Specifies the minimum version to require for this transfer to take place\&. If the source or target patterns in this transfer definition match files older than this version they will be considered obsolete, and never be considered for the update operation\&. +.sp +Added in version 251\&. .RE .PP \fIProtectVersion=\fR @@ -649,6 +651,8 @@ Like many of the settings in these configuration files this setting supports spe or "%w" specifiers to automatically refer to the current OS version of the running system\&. See below for details on supported specifiers\&. +.sp +Added in version 251\&. .RE .PP \fIVerify=\fR @@ -670,6 +674,8 @@ This option only has an effect if the source resource type is selected as \fBurl\-file\fR or \fBurl\-tar\fR, as integrity and authentication checking is only available for transfers from remote sources\&. +.sp +Added in version 251\&. .RE .SH "[SOURCE] SECTION OPTIONS" .PP @@ -687,6 +693,8 @@ or \fBsubvolume\fR\&. For details about the resource types, see above\&. This option is mandatory\&. .sp Note that only certain combinations of source and target resource types are supported, see above\&. +.sp +Added in version 251\&. .RE .PP \fIPath=\fR @@ -704,6 +712,8 @@ to acquire the manifest file, with to acquire the detached signature file for it, and with the file names listed in the manifest file in case an update is executed and a resource shall be downloaded\&. .sp For all other source resource types this must be a local path in the file system, referring to a local directory to find the versions of this resource in\&. +.sp +Added in version 251\&. .RE .PP \fIMatchPattern=\fR @@ -713,6 +723,18 @@ Specifies one or more file name match patterns that select the subset of files t This option is mandatory\&. Any pattern listed must contain at least the "@v" wildcard, so that a version identifier may be extracted from the filename\&. All other wildcards are optional\&. +.sp +If the source type is +\fBregular\-file\fR +or +\fBdirectory\fR, the pattern may contain slash characters\&. In this case it will match the file or directory in corresponding subdirectory\&. For example +"MatchPattern=foo_@v/bar\&.efi" +will match +"bar\&.efi" +in directory +"foo_1"\&. +.sp +Added in version 251\&. .RE .SH "[TARGET] SECTION OPTIONS" .PP @@ -728,6 +750,8 @@ or \fBsubvolume\fR\&. For details about the resource types, see above\&. This option is mandatory\&. .sp Note that only certain combinations of source and target resource types are supported, see above\&. +.sp +Added in version 251\&. .RE .PP \fIPath=\fR @@ -752,6 +776,8 @@ is set to "_empty" is used to indicate empty partitions\&. To automatically generate suitable partitions on first boot, use a tool such as \fBsystemd-repart\fR(8)\&. +.sp +Added in version 251\&. .RE .PP \fIPathRelativeTo=\fR @@ -781,6 +807,8 @@ is set to \fBregular\-file\fR or \fBdirectory\fR\&. +.sp +Added in version 254\&. .RE .PP \fIMatchPattern=\fR @@ -792,6 +820,18 @@ This option is mandatory\&. Any pattern listed must contain at least the wildcard, so that a version identifier may be extracted from the filename\&. All other wildcards are optional\&. .sp This pattern is both used for matching existing installed versions and for determining the name of new versions to install\&. If multiple patterns are specified, the first specified is used for naming newly installed versions\&. +.sp +If the target type is +\fBregular\-file\fR +or +\fBdirectory\fR, the pattern may contain slash characters\&. In this case it will match the file or directory in corresponding subdirectory\&. For example +"MatchPattern=foo_@v/bar\&.efi" +will match +"bar\&.efi" +in directory +"foo_1"\&. Directories in the path will be created when file is installed\&. Empty directories will be removed when file is removed\&. +.sp +Added in version 251\&. .RE .PP \fIMatchPartitionType=\fR @@ -805,6 +845,8 @@ is used\&. Accepts either a literal type UUID or a symbolic type identifier\&. F \fIType=\fR setting in \fBrepart.d\fR(5)\&. +.sp +Added in version 251\&. .RE .PP \fIPartitionUUID=\fR, \fIPartitionFlags=\fR, \fIPartitionNoAuto=\fR, \fIPartitionGrowFileSystem=\fR @@ -827,6 +869,8 @@ are used (or the wildcards for them), then the latter override the former, i\&.e for details about these flags\&. .sp Note that these settings are not used for matching, they only have effect on newly written partitions in case a transfer takes place\&. +.sp +Added in version 251\&. .RE .PP \fIReadOnly=\fR @@ -846,6 +890,8 @@ is selected as \fBdirectory\fR, the "immutable" file attribute is set, see \fBchattr\fR(1) for details\&. +.sp +Added in version 251\&. .RE .PP \fIMode=\fR @@ -855,6 +901,8 @@ The UNIX file access mode to use for newly created files in case the target reso "@t"), the value from the pattern is used\&. .sp Note that this setting is not used for matching, it only has an effect on newly written files when a transfer takes place\&. +.sp +Added in version 251\&. .RE .PP \fITriesDone=\fR, \fITriesLeft=\fR @@ -865,6 +913,8 @@ These options take positive, decimal integers, and control the number of attempt or "@l" wildcards\&. +.sp +Added in version 251\&. .RE .PP \fIInstancesMax=\fR @@ -888,6 +938,8 @@ If the target \fIType=\fR is selected as \fBpartition\fR, the number of concurrent versions to keep is additionally restricted by the number of partition slots of the right type in the partition table\&. I\&.e\&. if there are only 2 partition slots for the selected partition type, setting this value larger than 2 is without effect, since no more than 2 concurrent versions could be stored in the image anyway\&. +.sp +Added in version 251\&. .RE .PP \fIRemoveTemporary=\fR @@ -899,6 +951,8 @@ is selected as \fBdirectory\fR or \fBsubvolume\fR\&. +.sp +Added in version 251\&. .RE .PP \fICurrentSymlink=\fR @@ -910,6 +964,8 @@ is selected as \fBdirectory\fR or \fBsubvolume\fR\&. +.sp +Added in version 251\&. .RE .SH "SPECIFIERS" .PP @@ -1091,7 +1147,7 @@ Path=auto MatchPattern=foobarOS_@v_verity MatchPartitionType=root\-verity PartitionFlags=0 -PartitionReadOnly=1 +ReadOnly=1 .fi .if n \{\ .RE @@ -1126,7 +1182,7 @@ Path=auto MatchPattern=foobarOS_@v MatchPartitionType=root PartitionFlags=0 -PartitionReadOnly=1 +ReadOnly=1 .fi .if n \{\ .RE |