diff --git a/NEWS b/NEWS index c7ee3dbb40e..753f789341e 100644 --- a/NEWS +++ b/NEWS @@ -5059,7 +5059,7 @@ CHANGES WITH 232: * Support for dynamically creating users for the lifetime of a service has been added. If DynamicUser=yes is specified, user and group IDs - will be allocated from the range 61184..65519 for the lifetime of the + will be allocated from the range 61184…65519 for the lifetime of the service. They can be resolved using the new nss-systemd.so NSS module. The module must be enabled in /etc/nsswitch.conf. Services started in this way have PrivateTmp= and RemoveIPC= enabled, so that @@ -5801,7 +5801,7 @@ CHANGES WITH 230: * The LimitNICE= setting now optionally takes normal UNIX nice values in addition to the raw integer limit value. If the specified - parameter is prefixed with "+" or "-" and is in the range -20..19 the + parameter is prefixed with "+" or "-" and is in the range -20…19 the value is understood as UNIX nice value. If not prefixed like this it is understood as raw RLIMIT_NICE limit. @@ -6139,10 +6139,10 @@ CHANGES WITH 228: individual indexes. * The various memory-related resource limit settings (such as - LimitAS=) now understand the usual K, M, G, ... suffixes to + LimitAS=) now understand the usual K, M, G, … suffixes to the base of 1024 (IEC). Similar, the time-related resource - limit settings understand the usual min, h, day, ... - suffixes now. + limit settings understand the usual min, h, day, … suffixes + now. * There's a new system.conf setting DefaultTasksMax= to control the default TasksMax= setting for services and @@ -7076,7 +7076,7 @@ CHANGES WITH 220: * /usr/lib/os-release gained a new optional field VARIANT= for distributions that support multiple variants (such as a - desktop edition, a server edition, ...) + desktop edition, a server edition, …) Contributions from: Aaro Koskinen, Adam Goode, Alban Crequy, Alberto Fanjul Alonso, Alexander Sverdlin, Alex Puchades, Alin @@ -7575,7 +7575,7 @@ CHANGES WITH 218: into account when storing rfkill state on disk, as the name might be dynamically assigned and not stable. Instead, the ID_PATH udev variable combined with the rfkill type (wlan, - bluetooth, ...) is used. + bluetooth, …) is used. * A new service systemd-machine-id-commit.service has been added. When used on systems where /etc is read-only during @@ -7805,7 +7805,7 @@ CHANGES WITH 217: * Calendar time specifications in .timer units now also understand the strings "semi-annually", "quarterly" and "minutely" as shortcuts (in addition to the preexisting - "annually", "hourly", ...). + "annually", "hourly", …). * systemd-tmpfiles will now correctly create files in /dev at boot which are marked for creation only at boot. It is @@ -9025,7 +9025,7 @@ CHANGES WITH 209: match against MAC address, device path, driver name and type, and will apply attributes like the naming policy, link speed, MTU, duplex settings, Wake-on-LAN settings, MAC address, MAC - address assignment policy (randomized, ...). + address assignment policy (randomized, …). * The configuration of network interface naming rules for "permanent interface names" has changed: a new NamePolicy= @@ -9102,7 +9102,7 @@ CHANGES WITH 209: recent boots with their times and boot IDs. * The various tools like systemctl, loginctl, timedatectl, - busctl, systemd-run, ... have gained a new switch "-M" to + busctl, systemd-run, … have gained a new switch "-M" to connect to a specific, local OS container (as direct connection, without requiring SSH). This works on any container that is registered with machined, such as those @@ -9851,7 +9851,7 @@ CHANGES WITH 205: * If a privileged process logs a journal message with the OBJECT_PID= field set, then journald will automatically augment this with additional OBJECT_UID=, OBJECT_GID=, - OBJECT_COMM=, OBJECT_EXE=, ... fields. This is useful if + OBJECT_COMM=, OBJECT_EXE=, … fields. This is useful if system services want to log events about specific client processes. journactl/systemctl has been updated to make use of this information if all log messages regarding a specific @@ -10991,7 +10991,7 @@ CHANGES WITH 190: inhibitors during their runtime. A simple way to achieve that is to invoke the DE wrapped in an invocation of: - systemd-inhibit --what=handle-power-key:handle-sleep-key:handle-lid-switch ... + systemd-inhibit --what=handle-power-key:handle-sleep-key:handle-lid-switch … * Access to unit operations is now checked via SELinux taking the unit file label and client process label into account. @@ -11398,7 +11398,7 @@ CHANGES WITH 183: should be used to create dead device nodes as workarounds for broken subsystems. - * udev: RUN+="socket:..." and udev_monitor_new_from_socket() is + * udev: RUN+="socket:…" and udev_monitor_new_from_socket() is no longer supported. udev_monitor_new_from_netlink() needs to be used to subscribe to events. diff --git a/man/networkctl.xml b/man/networkctl.xml index 466bba47ff3..ee204a60c55 100644 --- a/man/networkctl.xml +++ b/man/networkctl.xml @@ -104,7 +104,7 @@ carrier the link has a carrier, or for bond or bridge master, all bonding or bridge slave - network interfaces are enslaved to the master. + network interfaces are enslaved to the master diff --git a/man/networkd.conf.xml b/man/networkd.conf.xml index 78b46ad505c..12ddcf45026 100644 --- a/man/networkd.conf.xml +++ b/man/networkd.conf.xml @@ -72,10 +72,11 @@ RouteTable= - Specifies the route table name. Takes a route name and table number separated with a colon. - (name:integer. The route table number - must be an integer in the range 1..4294967295. This setting can be specified multiple times. If an empty string - is specified, then all options specified earlier are cleared. Defaults to unset. + Specifies the route table name. Takes a route name and table number separated with a + colon. (name:integer. The + route table number must be an integer in the range 1…4294967295. This setting can be specified + multiple times. If an empty string is specified, then all options specified earlier are cleared. + Defaults to unset. diff --git a/man/systemctl.xml b/man/systemctl.xml index d82f956fa89..e49a12a146e 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -2274,13 +2274,38 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err - Takes one of pretty (the default), - us, µs, utc. - Changes the format of printed timestamps. - pretty: Day YYYY-MM-DD HH:MM:SS TZ - us or µs: Day YYYY-MM-DD HH:MM:SS.UUUUUU TZ - utc: Day YYYY-MM-DD HH:MM:SS UTC - us+utc or µs+utc: Day YYYY-MM-DD HH:MM:SS.UUUUUU UTC + Change the format of printed timestamps. The following values may be used: + + + + + (this is the default) + Day YYYY-MM-DD HH:MM:SS TZ + + + + + + + + Day YYYY-MM-DD HH:MM:SS.UUUUUU TZ + + + + + + + Day YYYY-MM-DD HH:MM:SS UTC + + + + + + + + Day YYYY-MM-DD HH:MM:SS.UUUUUU UTC + + diff --git a/man/systemd-dissect.xml b/man/systemd-dissect.xml index fd55fd0bfb3..caaf68dcae8 100644 --- a/man/systemd-dissect.xml +++ b/man/systemd-dissect.xml @@ -207,7 +207,7 @@ Takes one of disabled, loop, all, crypto. If disabled the image is - accessed with empty block discarding turned off. if loop discarding is enabled if + accessed with empty block discarding turned off. If loop discarding is enabled if operating on a regular file. If crypt discarding is enabled even on encrypted file systems. If all discarding is unconditionally enabled. @@ -217,15 +217,16 @@ - Configure various aspects of Verity data integrity for the OS - image. expects a hex-encoding top-level Verity hash to use for setting - up the Verity integrity protection. expects the path to a file - containing a PKCS#7 signature file for the hash. This signature is passed to the kernel during - activation, which will match it against signature keys available in the kernel - keyring. expects the path to a file with the Verity data to use for - the OS image, in case it is stored in a detached file. It is recommended to embed the Verity data - directly in the image, using the Verity mechanisms in the Discoverable Partitions Specification. + Configure various aspects of Verity data integrity for the OS image. Option + specifies a hex-encoded top-level Verity hash to use for setting up the + Verity integrity protection. Option specifies the path to a file + containing a PKCS#7 signature for the hash. This signature is passed to the kernel during activation, + which will match it against signature keys available in the kernel keyring. Option + specifies a path to a file with the Verity data to use for the OS + image, in case it is stored in a detached file. It is recommended to embed the Verity data directly + in the image, using the Verity mechanisms in the Discoverable Partitions Specification. + diff --git a/man/systemd-firstboot.xml b/man/systemd-firstboot.xml index a1607abb84a..10019249023 100644 --- a/man/systemd-firstboot.xml +++ b/man/systemd-firstboot.xml @@ -237,8 +237,8 @@ - Copy locale, keymap, time zone and root password from - the host. This is equivalent to specifying + Copy locale, keymap, time zone, root password and shell from the host. This is + equivalent to specifying , , , diff --git a/man/systemd-pstore.service.xml b/man/systemd-pstore.service.xml index 306f1099b04..66ad5572c82 100644 --- a/man/systemd-pstore.service.xml +++ b/man/systemd-pstore.service.xml @@ -34,10 +34,10 @@ thus preserving the existing information contained in the pstore, and clearing pstore storage for future error events. - Linux provides a persistent storage file system, pstore, that can store - error records when the kernel dies (or reboots or powers-off). These records in - turn can be referenced to debug kernel problems (currently the kernel stuffs - the tail of the dmesg, which also contains a stack backtrace, into pstore). + Linux provides a persistent storage file system, pstore, that can store error records when the + kernel dies (or reboots or powers-off). These records in turn can be referenced to debug kernel problems + (currently the kernel stores the tail of the kernel log, which also contains a stack backtrace, into + pstore). The pstore file system supports a variety of backends that map onto persistent storage, such as the ACPI ERST and UEFI variables. The pstore backends @@ -48,7 +48,7 @@ pstore. The pstore service is independent of the kdump service. In cloud environments - specifically, host and guest filesystems are on remote filesystems (eg. iSCSI + specifically, host and guest filesystems are on remote filesystems (e.g. iSCSI or NFS), thus kdump relies (implicitly and/or explicitly) upon proper operation of networking software *and* hardware *and* infrastructure. Thus it may not be possible to capture a kernel coredump to a file since writes over the network @@ -59,9 +59,9 @@ debugging. The systemd-pstore executable does the actual work. Upon starting, - the pstore.conf file is read and the /sys/fs/pstore + the pstore.conf file is read and the /sys/fs/pstore/ directory contents are processed according to the options. Pstore files are written to the - journal, and optionally saved into /var/lib/systemd/pstore. + journal, and optionally saved into /var/lib/systemd/pstore/. @@ -83,17 +83,14 @@ - Controlling kernel parameters + Kernel parameters The kernel has two parameters, /sys/module/kernel/parameters/crash_kexec_post_notifiers and - /sys/module/printk/parameters/always_kmsg_dump, - that control writes into pstore. - The crash_kexec_post_notifiers parameter enables the kernel to write - dmesg (including stack trace) into pstore upon a panic or crash, and - printk.always_kmsg_dump parameter enables the kernel to write dmesg - upon a normal shutdown (shutdown, reboot, halt). These kernel - parameters are managed via the + /sys/module/printk/parameters/always_kmsg_dump, that control writes into pstore. + The first enables storing of the kernel log (including stack trace) into pstore upon a panic or crash, + and the second enables storing of the kernel log upon a normal shutdown (shutdown, reboot, halt). These + parameters can be managed via the tmpfiles.d5 mechanism, specifically the file /usr/lib/tmpfiles/systemd-pstore.conf. diff --git a/man/systemd-resolved.service.xml b/man/systemd-resolved.service.xml index 93ffca6bfaa..09caf6b9a79 100644 --- a/man/systemd-resolved.service.xml +++ b/man/systemd-resolved.service.xml @@ -223,7 +223,7 @@ This section provides a short summary of differences in the stub resolver implemented by nss-resolve8 together - with systemd-resolved and the tranditional stub resolver implemented in + with systemd-resolved and the traditional stub resolver implemented in nss-dns8. diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml index 25b52503ee9..203fc0355d7 100644 --- a/man/systemd.exec.xml +++ b/man/systemd.exec.xml @@ -338,10 +338,10 @@ ProcSubset= Takes one of all (the default) and pid. If - the latter all files and directories not directly associated with process management and introspection - are made invisible in the /proc/ file system configured for the unit's - processes. This controls the subset= mount option of the procfs - instance for the unit. For further details see pid, all files and directories not directly associated with process management and + introspection are made invisible in the /proc/ file system configured for the + unit's processes. This controls the subset= mount option of the + procfs instance for the unit. For further details see The /proc Filesystem. Note that Linux exposes various kernel APIs via /proc/, which are made unavailable with this setting. Since these APIs are used frequently this option is @@ -766,8 +766,8 @@ CapabilityBoundingSet=~CAP_B CAP_C enforcement. For example, time limits specified for LimitCPU= will be rounded up implicitly to multiples of 1s. For LimitNICE= the value may be specified in two syntaxes: if prefixed with + or -, the value is understood as - regular Linux nice value in the range -20..19. If not prefixed like this the value is understood as - raw resource limit parameter in the range 0..40 (with 0 being equivalent to 1). + regular Linux nice value in the range -20…19. If not prefixed like this the value is understood as + raw resource limit parameter in the range 0…40 (with 0 being equivalent to 1). Note that most process resource limits configured with these options are per-process, and processes may fork in order to acquire a new set of resources that are accounted independently of the @@ -1460,14 +1460,13 @@ BindReadOnlyPaths=/var/lib/systemd executed processes and mounts private /tmp/ and /var/tmp/ directories inside it that are not shared by processes outside of the namespace. This is useful to secure access to temporary files of the process, but makes sharing between processes via - /tmp/ or /var/tmp/ impossible. If this is enabled, all - temporary files created by a service in these directories will be removed after the service is - stopped. Defaults to false. It is possible to run two or more units within the same private - /tmp/ and /var/tmp/ namespace by using the - JoinsNamespaceOf= directive, see - systemd.unit5 for - details. This setting is implied if DynamicUser= is set. For this setting the same - restrictions regarding mount propagation and privileges apply as for + /tmp/ or /var/tmp/ impossible. If true, all temporary files + created by a service in these directories will be removed after the service is stopped. Defaults to + false. It is possible to run two or more units within the same private /tmp/ and + /var/tmp/ namespace by using the JoinsNamespaceOf= directive, + see systemd.unit5 + for details. This setting is implied if DynamicUser= is set. For this setting the + same restrictions regarding mount propagation and privileges apply as for ReadOnlyPaths= and related calls, see above. Enabling this setting has the side effect of adding Requires= and After= dependencies on all mount units necessary to access /tmp/ and /var/tmp/. Moreover an @@ -2779,8 +2778,7 @@ StandardInputData=SWNrIHNpdHplIGRhIHVuJyBlc3NlIEtsb3BzLAp1ZmYgZWVtYWwga2xvcHAncy ExecStart= command line use ${CREDENTIALS_DIRECTORY}/mycred, e.g. ExecStart=cat ${CREDENTIALS_DIRECTORY}/mycred. - Currently, an accumulated credential size limit of 1M bytes per unit is - enforced. + Currently, an accumulated credential size limit of 1 MB per unit is enforced. If referencing an AF_UNIX stream socket to connect to, the connection will originate from an abstract namespace socket, that includes information about the unit and the diff --git a/man/systemd.link.xml b/man/systemd.link.xml index 8a57511889b..0b7055bf591 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -413,7 +413,7 @@ TxQueueLength= Specifies the transmit queue length of the device in number of packets. An unsigned integer - in the range 0..4294967294. When unset, the kernel's default will be used. + in the range 0…4294967294. When unset, the kernel's default will be used. @@ -755,15 +755,15 @@ Specifies the maximum size of a Generic Segment Offload (GSO) packet the device should accept. The usual suffixes K, M, G, are supported and are - understood to the base of 1024. An unsigned integer in the range 1—65536. + understood to the base of 1024. An unsigned integer in the range 1…65536. Defaults to unset. GenericSegmentOffloadMaxSegments= - Specifies the maximum number of a Generic Segment Offload (GSO) segments the device should accept. - An unsigned integer in the range 1—65535. Defaults to unset. + Specifies the maximum number of a Generic Segment Offload (GSO) segments the device should + accept. An unsigned integer in the range 1…65535. Defaults to unset. diff --git a/man/systemd.net-naming-scheme.xml b/man/systemd.net-naming-scheme.xml index 054de92c0b4..646dd3e5611 100644 --- a/man/systemd.net-naming-scheme.xml +++ b/man/systemd.net-naming-scheme.xml @@ -271,7 +271,7 @@ History The following "naming schemes" have been defined (which may be chosen at system boot-up time via - the net.naming-scheme= kernel command line switch, see above: + the net.naming-scheme= kernel command line switch, see above): @@ -362,11 +362,11 @@ v247 - If the PCI slot is associated with PCI bridge and that has multiple child network - controllers then all of them might derive the same value of ID_NET_NAME_SLOT - property. That could cause naming conflict if the property is selected as a device name. Now, we detect the - situation, slot - bridge relation, and we don't produce the ID_NET_NAME_SLOT property to - avoid possible naming conflict. + When a PCI slot is associated with a PCI bridge that has multiple child network + controllers, the same value of the ID_NET_NAME_SLOT property might be derived + for those controllers. This would cause a naming conflict if the property is selected as the device + name. Now, we detect this situation and don't produce the ID_NET_NAME_SLOT + property. diff --git a/man/systemd.netdev.xml b/man/systemd.netdev.xml index baa734bcb24..a18d9aba073 100644 --- a/man/systemd.netdev.xml +++ b/man/systemd.netdev.xml @@ -550,7 +550,7 @@ BroadcastMulticastQueueLength= Specifies the length of the receive queue for broadcast/multicast packets. An unsigned - integer in the range 0—4294967294. Defaults to unset. + integer in the range 0…4294967294. Defaults to unset. @@ -608,7 +608,7 @@ VNI= - The VXLAN Network Identifier (or VXLAN Segment ID). Takes a number in the range 1-16777215. + The VXLAN Network Identifier (or VXLAN Segment ID). Takes a number in the range 1…16777215. @@ -907,7 +907,7 @@ PeerTunnelId= - Specifies the peer tunnel id. Takes a number in the range 1—4294967295. The value used must + Specifies the peer tunnel id. Takes a number in the range 1…4294967295. The value used must match the TunnelId= value being used at the peer. This setting is compulsory. @@ -1390,7 +1390,7 @@ ERSPANIndex= - Specifies the ERSPAN index field for the interface, an integer in the range 1-1048575 associated with + Specifies the ERSPAN index field for the interface, an integer in the range 1…1048575 associated with the ERSPAN traffic's source port and direction. This field is mandatory. @@ -1442,7 +1442,7 @@ The Protocol= specifies the protocol number of the packets arriving at the UDP port. When Encapsulation=FooOverUDP, this field is mandatory and is not set by default. Takes an IP protocol name such as gre or - ipip, or an integer within the range 1-255. When + ipip, or an integer within the range 1…255. When Encapsulation=GenericUDPEncapsulation, this must not be specified. @@ -1801,7 +1801,7 @@ AdActorSystemPriority= - Specifies the 802.3ad actor system priority. Takes a number in the range 1—65535. + Specifies the 802.3ad actor system priority. Takes a number in the range 1…65535. diff --git a/man/systemd.network.xml b/man/systemd.network.xml index 6d7d7e94a50..8e7b190638a 100644 --- a/man/systemd.network.xml +++ b/man/systemd.network.xml @@ -212,20 +212,20 @@ Link groups are similar to port ranges found in managed switches. When network interfaces are added to a numbered group, operations on all the interfaces from that group can be performed at once. An unsigned - integer in the range 0—4294967294. Defaults to unset. + integer in the range 0…4294967294. Defaults to unset. TransmitQueues= - Specifies the devices's number of transmit queues. An integer in the range 1...4096. + Specifies the devices's number of transmit queues. An integer in the range 1…4096. When unset, the kernel's default will be used. ReceiveQueues= - Specifies the devices's number of receive queues. An integer in the range 1...4096. + Specifies the devices's number of receive queues. An integer in the range 1…4096. When unset, the kernel's default will be used. @@ -295,21 +295,21 @@ VirtualFunction= Specifies a Virtual Function (VF), lightweight PCIe function designed solely to move data - in and out. Takes an unsigned integer in the range 0..2147483646. This option is compulsory. + in and out. Takes an unsigned integer in the range 0…2147483646. This option is compulsory. VLANId= - Specifies VLAN ID of the virtual function. Takes an unsigned integer in the range 1..4095. + Specifies VLAN ID of the virtual function. Takes an unsigned integer in the range 1…4095. QualityOfService= - Specifies quality of service of the virtual function. Takes an unsigned integer in the range 1..4294967294. + Specifies quality of service of the virtual function. Takes an unsigned integer in the range 1…4294967294. @@ -665,8 +665,7 @@ IPv6Token=prefixstable:2002:da8:1:: DNS= - A DNS server address, which must be in the format - described in + A DNS server address, which must be in the format described in inet_pton3. This option may be specified more than once. Each address can optionally take a port number separated with :, a network interface name or index separated with @@ -674,9 +673,8 @@ IPv6Token=prefixstable:2002:da8:1:: When IPv6 address is specified with a port number, then the address must be in the square brackets. That is, the acceptable full formats are 111.222.333.444:9953%ifname#example.com for IPv4 and - [1111:2222::3333]:9953%ifname#example.com for IPv6. This setting can be - specified multiple times. If an empty string is assigned, then the all previous assignments - are cleared. This setting is read by + [1111:2222::3333]:9953%ifname#example.com for IPv6. If an empty string is + assigned, then the all previous assignments are cleared. This setting is read by systemd-resolved.service8. @@ -1074,13 +1072,12 @@ IPv6Token=prefixstable:2002:da8:1:: PreferredLifetime= - Allows the default "preferred lifetime" of the address to be overridden. - Only three settings are accepted: forever or infinity - which is the default and means that the address never expires, and 0 which means - that the address is considered immediately "expired" and will not be used, - unless explicitly requested. A setting of PreferredLifetime=0 is useful for - addresses which are added to be used only by a specific application, - which is then configured to use them explicitly. + Allows the default "preferred lifetime" of the address to be overridden. Only three + settings are accepted: forever, infinity, which is the + default and means that the address never expires, and 0, which means that the + address is considered immediately "expired" and will not be used, unless explicitly requested. A + setting of is useful for addresses which are added to be + used only by a specific application, which is then configured to use them explicitly. @@ -1090,7 +1087,7 @@ IPv6Token=prefixstable:2002:da8:1:: global (valid everywhere on the network, even through a gateway), link (only valid on this device, will not traverse a gateway) or host (only valid within the device itself, e.g. 127.0.0.1) - or an unsigned integer in the range 0—255. + or an unsigned integer in the range 0…255. Defaults to global. @@ -1309,7 +1306,7 @@ IPv6Token=prefixstable:2002:da8:1:: SuppressPrefixLength= - Takes a number N in the range 0-128 and rejects routing + Takes a number N in the range 0…128 and rejects routing decisions that have a prefix length of N or less. Defaults to unset. @@ -1882,8 +1879,8 @@ IPv6Token=prefixstable:2002:da8:1:: RequestOptions= - When configured, allows to set arbitrary request options in the DHCPv4 request options list and will be - sent to the DHCPV4 server. A whitespace-separated list of integers in the range 1..254. Defaults to unset. + Sets request options to be sent to the server in the DHCPv4 request options list. A + whitespace-separated list of integers in the range 1…254. Defaults to unset. @@ -1893,10 +1890,11 @@ IPv6Token=prefixstable:2002:da8:1:: Send an arbitrary raw option in the DHCPv4 request. Takes a DHCP option number, data type and data separated with a colon (option:type:value). - The option number must be an integer in the range 1..254. The type takes one of uint8, - uint16, uint32, ipv4address, or - string. Special characters in the data string may be escaped using - C-style + The option number must be an integer in the range 1…254. The type takes one of + uint8, uint16, uint32, + ipv4address, or string. Special characters in the data + string may be escaped using C-style escapes. This setting can be specified multiple times. If an empty string is specified, then all options specified earlier are cleared. Defaults to unset. @@ -1905,13 +1903,14 @@ IPv6Token=prefixstable:2002:da8:1:: SendVendorOption= - Send an arbitrary vendor option in the DHCPv4 request. Takes a DHCP option number, data type - and data separated with a colon + Send an arbitrary vendor option in the DHCPv4 request. Takes a DHCP option number, data + type and data separated with a colon (option:type:value). - The option number must be an integer in the range 1..254. The type takes one of uint8, - uint16, uint32, ipv4address, or - string. Special characters in the data string may be escaped using - C-style + The option number must be an integer in the range 1…254. The type takes one of + uint8, uint16, uint32, + ipv4address, or string. Special characters in the data + string may be escaped using C-style escapes. This setting can be specified multiple times. If an empty string is specified, then all options specified earlier are cleared. Defaults to unset. @@ -1965,7 +1964,7 @@ IPv6Token=prefixstable:2002:da8:1:: MUDURL= When configured, the specified Manufacturer Usage Description (MUD) URL will be sent to - the DHCPV6 server. The syntax and semantics are the same as for MUDURL= in the + the DHCPv6 server. The syntax and semantics are the same as for MUDURL= in the [DHCPv4] section described above. @@ -1974,8 +1973,8 @@ IPv6Token=prefixstable:2002:da8:1:: RequestOptions= When configured, allows to set arbitrary request options in the DHCPv6 request options list - that will be sent to the DHCPV6 server. A whitespace-separated list of integers in the range - 1..254. Defaults to unset. + that will be sent to the DHCPv6 server. A whitespace-separated list of integers in the range + 1…254. Defaults to unset. @@ -2035,7 +2034,7 @@ IPv6Token=prefixstable:2002:da8:1:: SendOption= As in the [DHCPv4] section, however because DHCPv6 uses 16-bit fields to store - option numbers, the option number is an integer in the range 1..65536. + option numbers, the option number is an integer in the range 1…65536. @@ -2306,7 +2305,7 @@ IPv6Token=prefixstable:2002:da8:1:: servers set. The "uplink" interface is determined by the default route of the system with the highest priority. Note that this information is acquired at the time the lease is handed out, and does not take uplink interfaces into account that acquire DNS server information at a later point. If no - suitable uplinkg interface is found the DNS server data from /etc/resolv.conf is + suitable uplink interface is found the DNS server data from /etc/resolv.conf is used. Also, note that the leases are not refreshed if the uplink network configuration changes. To ensure clients regularly acquire the most current uplink DNS server information, it is thus advisable to shorten the DHCP lease time via MaxLeaseTimeSec= described @@ -2360,7 +2359,7 @@ IPv6Token=prefixstable:2002:da8:1:: Send a raw option with value via DHCPv4 server. Takes a DHCP option number, data type and data (option:type:value). - The option number is an integer in the range 1..254. The type takes one of uint8, + The option number is an integer in the range 1…254. The type takes one of uint8, uint16, uint32, ipv4address, ipv6address, or string. Special characters in the data string may be escaped using C-style @@ -2374,7 +2373,7 @@ IPv6Token=prefixstable:2002:da8:1:: Send a vendor option with value via DHCPv4 server. Takes a DHCP option number, data type and data (option:type:value). - The option number is an integer in the range 1..254. The type takes one of uint8, + The option number is an integer in the range 1…254. The type takes one of uint8, uint16, uint32, ipv4address, or string. Special characters in the data string may be escaped using C-style @@ -2699,7 +2698,7 @@ IPv6Token=prefixstable:2002:da8:1:: VNI= The VXLAN Network Identifier (or VXLAN Segment ID) to use to connect to - the remote VXLAN tunnel endpoint. Takes a number in the range 1-16777215. + the remote VXLAN tunnel endpoint. Takes a number in the range 1…16777215. Defaults to unset. @@ -2767,7 +2766,7 @@ IPv6Token=prefixstable:2002:da8:1:: BitRate= The bitrate of CAN device in bits per second. The usual SI prefixes (K, M) with the base of 1000 can - be used here. Takes a number in the range 1..4294967295. + be used here. Takes a number in the range 1…4294967295. @@ -3003,8 +3002,9 @@ IPv6Token=prefixstable:2002:da8:1:: PacketLimit= - Specifies the hard limit on the queue size in number of packets. When this limit is reached, incoming packets are - dropped. An unsigned integer in the range 1–4294967294. Defaults to unset and kernel's default is used. + Specifies the hard limit on the queue size in number of packets. When this limit is reached, + incoming packets are dropped. An unsigned integer in the range 1…4294967294. Defaults to unset and + kernel's default is used. @@ -3022,8 +3022,9 @@ IPv6Token=prefixstable:2002:da8:1:: PacketLimit= - Specifies the hard limit on the queue size in number of packets. When this limit is reached, incoming packets are - dropped. An unsigned integer ranges 1 to 4294967294. Defaults to unset and kernel's default is used. + Specifies the hard limit on the queue size in number of packets. When this limit is reached, + incoming packets are dropped. An unsigned integer ranges 1 to 4294967294. Defaults to unset and + kernel's default is used. @@ -3101,10 +3102,10 @@ IPv6Token=prefixstable:2002:da8:1:: PacketLimit= - Specifies the hard limit on the FIFO size in number of packets. The size limit (a buffer - size) to prevent it from overflowing in case it is unable to dequeue packets as quickly as it - receives them. When this limit is reached, incoming packets are dropped. An unsigned integer in the - range 0–4294967294. Defaults to unset and kernel's default is used. + Specifies the hard limit on the number of packets in the FIFO queue. The size limit prevents + overflow in case the kernel is unable to dequeue packets as quickly as it receives them. When this + limit is reached, incoming packets are dropped. An unsigned integer in the range + 0–4294967294. Defaults to unset and kernel's default is used. @@ -3294,7 +3295,7 @@ IPv6Token=prefixstable:2002:da8:1:: separated list of numbers. The first number indicates which band the packets with priority 0 should be put to, the second is for priority 1, and so on. There can be up to 16 numbers in the list. If there are fewer, the default band that traffic with one of the unmentioned priorities goes to is - the last one. Each band number must be in the range 0..255. This setting can be specified multiple + the last one. Each band number must be in the range 0…255. This setting can be specified multiple times. If an empty string is assigned, then the all previous assignments are cleared. @@ -3313,7 +3314,8 @@ IPv6Token=prefixstable:2002:da8:1:: VirtualQueues= - Specifies the number of virtual queues. Takes a integer in the range 1-16. Defaults to unset and kernel's default is used. + Specifies the number of virtual queues. Takes a integer in the range 1…16. Defaults to unset + and kernel's default is used. @@ -3674,7 +3676,7 @@ IPv6Token=prefixstable:2002:da8:1:: Weight= - Specifies the weight of the class. Takes an integer in the range 1..1023. Defaults to + Specifies the weight of the class. Takes an integer in the range 1…1023. Defaults to unset in which case the kernel default is used. @@ -3682,9 +3684,9 @@ IPv6Token=prefixstable:2002:da8:1:: MaxPacketBytes= - Specifies the maximum packet size in bytes for the class. When suffixed with K, M, or G, the specified - size is parsed as Kilobytes, Megabytes, or Gigabytes, respectively, to the base of 1024. When unset, - the kernel default is used. + Specifies the maximum packet size in bytes for the class. When suffixed with K, M, or G, the + specified size is parsed as Kilobytes, Megabytes, or Gigabytes, respectively, to the base of + 1024. When unset, the kernel default is used. diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml index 6c513ed57ea..ea979ee2836 100644 --- a/man/systemd.resource-control.xml +++ b/man/systemd.resource-control.xml @@ -905,10 +905,11 @@ DeviceAllow=/dev/loop-control Overrides the default memory pressure limit set by - oomd.conf5 for this unit - (cgroup). Takes a percentage value between 0% and 100%, inclusive. This property is ignored unless - ManagedOOMMemoryPressure=. Defaults to 0%, which means use the - default set by oomd.conf5. + oomd.conf5 for + this unit (cgroup). Takes a percentage value between 0% and 100%, inclusive. This property is + ignored unless ManagedOOMMemoryPressure=. Defaults to 0%, + which means to use the default set by + oomd.conf5. diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 5da6d132eec..25cca3d8d61 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -780,7 +780,7 @@ abnormally by a signal, or hit a timeout. - Exit causes and the effect of the <varname>Restart=</varname> settings on them + Exit causes and the effect of the <varname>Restart=</varname> settings diff --git a/man/systemd.special.xml b/man/systemd.special.xml index ce1e8655f56..948380b9b52 100644 --- a/man/systemd.special.xml +++ b/man/systemd.special.xml @@ -1281,9 +1281,9 @@ The XDG specification defines a way to autostart applications using XDG desktop files. systemd ships systemd-xdg-autostart-generator8 - for the XDG desktop files in autostart directories. - Desktop Environments can opt-in to use this service by adding a Wants= - dependency on xdg-desktop-autostart.target. + for the XDG desktop files in autostart directories. Desktop Environments can opt-in to use this + service by adding a Wants= dependency on + xdg-desktop-autostart.target. diff --git a/man/userdbctl.xml b/man/userdbctl.xml index 0c2dd73bb96..6fbd26788fa 100644 --- a/man/userdbctl.xml +++ b/man/userdbctl.xml @@ -36,8 +36,8 @@ userdbctl may be used to inspect user and groups (as well as group memberships) of the system. This client utility inquires user/group information provided by various system services, both operating on JSON user/group records (as defined by the JSON User Record and JSON Group Record definitions), and classic UNIX NSS/glibc + url="https://systemd.io/USER_RECORD">JSON User Records and JSON Group Records definitions), and classic UNIX NSS/glibc user and group records. This tool is primarily a client to the User/Group Record Lookup API via Varlink. diff --git a/src/libsystemd/sd-event/sd-event.c b/src/libsystemd/sd-event/sd-event.c index 010e6282425..05e21968ac6 100644 --- a/src/libsystemd/sd-event/sd-event.c +++ b/src/libsystemd/sd-event/sd-event.c @@ -407,7 +407,7 @@ _public_ int sd_event_new(sd_event** ret) { e->epoll_fd = fd_move_above_stdio(e->epoll_fd); if (secure_getenv("SD_EVENT_PROFILE_DELAYS")) { - log_debug("Event loop profiling enabled. Logarithmic histogram of event loop iterations in the range 2^0 ... 2^63 us will be logged every 5s."); + log_debug("Event loop profiling enabled. Logarithmic histogram of event loop iterations in the range 2^0 … 2^63 us will be logged every 5s."); e->profile_delays = true; } diff --git a/src/network/networkd-dhcp-common.c b/src/network/networkd-dhcp-common.c index 25c49d329f8..cec7bb63699 100644 --- a/src/network/networkd-dhcp-common.c +++ b/src/network/networkd-dhcp-common.c @@ -551,13 +551,13 @@ int config_parse_dhcp_user_or_vendor_class( if (ltype == AF_INET) { if (len > UINT8_MAX || len == 0) { log_syntax(unit, LOG_WARNING, filename, line, 0, - "%s length is not in the range 1-255, ignoring.", w); + "%s length is not in the range 1…255, ignoring.", w); continue; } } else { if (len > UINT16_MAX || len == 0) { log_syntax(unit, LOG_WARNING, filename, line, 0, - "%s length is not in the range 1-65535, ignoring.", w); + "%s length is not in the range 1…65535, ignoring.", w); continue; } } diff --git a/src/udev/meson.build b/src/udev/meson.build index 9e97691d777..eee785179b7 100644 --- a/src/udev/meson.build +++ b/src/udev/meson.build @@ -116,18 +116,18 @@ libudevd_core = static_library( dependencies : [libblkid, libkmod]) udev_id_progs = [['ata_id/ata_id.c'], - ['cdrom_id/cdrom_id.c'], - ['fido_id/fido_id.c', - 'fido_id/fido_id_desc.c', - 'fido_id/fido_id_desc.h'], - ['scsi_id/scsi_id.c', - 'scsi_id/scsi_id.h', - 'scsi_id/scsi_serial.c', - 'scsi_id/scsi.h'], - ['v4l_id/v4l_id.c'], - ['mtd_probe/mtd_probe.c', - 'mtd_probe/mtd_probe.h', - 'mtd_probe/probe_smartmedia.c']] + ['cdrom_id/cdrom_id.c'], + ['fido_id/fido_id.c', + 'fido_id/fido_id_desc.c', + 'fido_id/fido_id_desc.h'], + ['scsi_id/scsi_id.c', + 'scsi_id/scsi_id.h', + 'scsi_id/scsi_serial.c', + 'scsi_id/scsi.h'], + ['v4l_id/v4l_id.c'], + ['mtd_probe/mtd_probe.c', + 'mtd_probe/mtd_probe.h', + 'mtd_probe/probe_smartmedia.c']] dmi_arches = ['x86', 'x86_64', 'aarch64', 'arm', 'ia64', 'mips'] if dmi_arches.contains(host_machine.cpu_family())