man: use ellipses for ranges in range descriptions

… and in few other places ;)
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2021-01-28 20:42:37 +01:00
parent 75909cc7e4
commit 1d3a473b4a
8 changed files with 67 additions and 62 deletions

26
NEWS
View file

@ -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 6118465519 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 -2019 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.

View file

@ -72,10 +72,11 @@
<varlistentry>
<term><varname>RouteTable=</varname></term>
<listitem><para>Specifies the route table name. Takes a route name and table number separated with a colon.
(<literal><replaceable>name</replaceable>:<replaceable>integer</replaceable></literal>. 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.</para></listitem>
<listitem><para>Specifies the route table name. Takes a route name and table number separated with a
colon. (<literal><replaceable>name</replaceable>:<replaceable>integer</replaceable></literal>. 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.</para></listitem>
</varlistentry>
</variablelist>

View file

@ -766,8 +766,8 @@ CapabilityBoundingSet=~CAP_B CAP_C</programlisting>
enforcement. For example, time limits specified for <varname>LimitCPU=</varname> will be rounded up
implicitly to multiples of 1s. For <varname>LimitNICE=</varname> the value may be specified in two
syntaxes: if prefixed with <literal>+</literal> or <literal>-</literal>, 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).</para>
regular Linux nice value in the range -2019. If not prefixed like this the value is understood as
raw resource limit parameter in the range 040 (with 0 being equivalent to 1).</para>
<para>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

View file

@ -413,7 +413,7 @@
<term><varname>TxQueueLength=</varname></term>
<listitem>
<para>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.</para>
in the range 04294967294. When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -755,15 +755,15 @@
<listitem>
<para>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 165536.
understood to the base of 1024. An unsigned integer in the range 165536.
Defaults to unset.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>GenericSegmentOffloadMaxSegments=</varname></term>
<listitem>
<para>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.</para>
<para>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.</para>
</listitem>
</varlistentry>

View file

@ -550,7 +550,7 @@
<term><varname>BroadcastMulticastQueueLength=</varname></term>
<listitem>
<para>Specifies the length of the receive queue for broadcast/multicast packets. An unsigned
integer in the range 04294967294. Defaults to unset.</para>
integer in the range 04294967294. Defaults to unset.</para>
</listitem>
</varlistentry>
</variablelist>
@ -608,7 +608,7 @@
<varlistentry>
<term><varname>VNI=</varname></term>
<listitem>
<para>The VXLAN Network Identifier (or VXLAN Segment ID). Takes a number in the range 1-16777215.</para>
<para>The VXLAN Network Identifier (or VXLAN Segment ID). Takes a number in the range 116777215.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -907,7 +907,7 @@
<varlistentry>
<term><varname>PeerTunnelId=</varname></term>
<listitem>
<para>Specifies the peer tunnel id. Takes a number in the range 14294967295. The value used must
<para>Specifies the peer tunnel id. Takes a number in the range 14294967295. The value used must
match the <literal>TunnelId=</literal> value being used at the peer. This setting is compulsory.
</para>
</listitem>
@ -1390,7 +1390,7 @@
<varlistentry>
<term><varname>ERSPANIndex=</varname></term>
<listitem>
<para>Specifies the ERSPAN index field for the interface, an integer in the range 1-1048575 associated with
<para>Specifies the ERSPAN index field for the interface, an integer in the range 11048575 associated with
the ERSPAN traffic's source port and direction. This field is mandatory.
</para>
</listitem>
@ -1442,7 +1442,7 @@
<para>The <varname>Protocol=</varname> specifies the protocol number of the packets arriving
at the UDP port. When <varname>Encapsulation=FooOverUDP</varname>, this field is mandatory
and is not set by default. Takes an IP protocol name such as <literal>gre</literal> or
<literal>ipip</literal>, or an integer within the range 1-255. When
<literal>ipip</literal>, or an integer within the range 1255. When
<varname>Encapsulation=GenericUDPEncapsulation</varname>, this must not be specified.</para>
</listitem>
</varlistentry>
@ -1801,7 +1801,7 @@
<varlistentry>
<term><varname>AdActorSystemPriority=</varname></term>
<listitem>
<para>Specifies the 802.3ad actor system priority. Takes a number in the range 165535.</para>
<para>Specifies the 802.3ad actor system priority. Takes a number in the range 165535.</para>
</listitem>
</varlistentry>

View file

@ -212,20 +212,20 @@
<para>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 04294967294. Defaults to unset.</para>
integer in the range 04294967294. Defaults to unset.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>TransmitQueues=</varname></term>
<listitem>
<para>Specifies the devices's number of transmit queues. An integer in the range 1...4096.
<para>Specifies the devices's number of transmit queues. An integer in the range 14096.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>ReceiveQueues=</varname></term>
<listitem>
<para>Specifies the devices's number of receive queues. An integer in the range 1...4096.
<para>Specifies the devices's number of receive queues. An integer in the range 14096.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
@ -295,21 +295,21 @@
<term><varname>VirtualFunction=</varname></term>
<listitem>
<para>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.</para>
in and out. Takes an unsigned integer in the range 02147483646. This option is compulsory.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>VLANId=</varname></term>
<listitem>
<para>Specifies VLAN ID of the virtual function. Takes an unsigned integer in the range 1..4095.</para>
<para>Specifies VLAN ID of the virtual function. Takes an unsigned integer in the range 14095.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>QualityOfService=</varname></term>
<listitem>
<para>Specifies quality of service of the virtual function. Takes an unsigned integer in the range 1..4294967294.</para>
<para>Specifies quality of service of the virtual function. Takes an unsigned integer in the range 14294967294.</para>
</listitem>
</varlistentry>
@ -1087,7 +1087,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<literal>global</literal> (valid everywhere on the network, even through a gateway),
<literal>link</literal> (only valid on this device, will not traverse a gateway) or
<literal>host</literal> (only valid within the device itself, e.g. 127.0.0.1)
or an unsigned integer in the range 0255.
or an unsigned integer in the range 0255.
Defaults to <literal>global</literal>.</para>
</listitem>
</varlistentry>
@ -1306,7 +1306,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<varlistentry>
<term><varname>SuppressPrefixLength=</varname></term>
<listitem>
<para>Takes a number <replaceable>N</replaceable> in the range 0-128 and rejects routing
<para>Takes a number <replaceable>N</replaceable> in the range 0128 and rejects routing
decisions that have a prefix length of <replaceable>N</replaceable> or less. Defaults to
unset.</para>
</listitem>
@ -1880,7 +1880,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<term><varname>RequestOptions=</varname></term>
<listitem>
<para>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.</para>
whitespace-separated list of integers in the range 1254. Defaults to unset.</para>
</listitem>
</varlistentry>
@ -1890,10 +1890,11 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<para>Send an arbitrary raw option in the DHCPv4 request. Takes a DHCP option number, data type
and data separated with a colon
(<literal><replaceable>option</replaceable>:<replaceable>type</replaceable>:<replaceable>value</replaceable></literal>).
The option number must be an integer in the range 1..254. The type takes one of <literal>uint8</literal>,
<literal>uint16</literal>, <literal>uint32</literal>, <literal>ipv4address</literal>, or
<literal>string</literal>. Special characters in the data string may be escaped using
<ulink url="https://en.wikipedia.org/wiki/Escape_sequences_in_C#Table_of_escape_sequences">C-style
The option number must be an integer in the range 1…254. The type takes one of
<literal>uint8</literal>, <literal>uint16</literal>, <literal>uint32</literal>,
<literal>ipv4address</literal>, or <literal>string</literal>. Special characters in the data
string may be escaped using <ulink
url="https://en.wikipedia.org/wiki/Escape_sequences_in_C#Table_of_escape_sequences">C-style
escapes</ulink>. This setting can be specified multiple times. If an empty string is specified,
then all options specified earlier are cleared. Defaults to unset.</para>
</listitem>
@ -1902,13 +1903,14 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<varlistentry>
<term><varname>SendVendorOption=</varname></term>
<listitem>
<para>Send an arbitrary vendor option in the DHCPv4 request. Takes a DHCP option number, data type
and data separated with a colon
<para>Send an arbitrary vendor option in the DHCPv4 request. Takes a DHCP option number, data
type and data separated with a colon
(<literal><replaceable>option</replaceable>:<replaceable>type</replaceable>:<replaceable>value</replaceable></literal>).
The option number must be an integer in the range 1..254. The type takes one of <literal>uint8</literal>,
<literal>uint16</literal>, <literal>uint32</literal>, <literal>ipv4address</literal>, or
<literal>string</literal>. Special characters in the data string may be escaped using
<ulink url="https://en.wikipedia.org/wiki/Escape_sequences_in_C#Table_of_escape_sequences">C-style
The option number must be an integer in the range 1…254. The type takes one of
<literal>uint8</literal>, <literal>uint16</literal>, <literal>uint32</literal>,
<literal>ipv4address</literal>, or <literal>string</literal>. Special characters in the data
string may be escaped using <ulink
url="https://en.wikipedia.org/wiki/Escape_sequences_in_C#Table_of_escape_sequences">C-style
escapes</ulink>. This setting can be specified multiple times. If an empty string is specified,
then all options specified earlier are cleared. Defaults to unset.</para>
</listitem>
@ -1972,7 +1974,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<listitem>
<para>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.</para>
1254. Defaults to unset.</para>
</listitem>
</varlistentry>
@ -2032,7 +2034,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<term><varname>SendOption=</varname></term>
<listitem>
<para>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.</para>
option numbers, the option number is an integer in the range 165536.</para>
</listitem>
</varlistentry>
@ -2357,7 +2359,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<listitem>
<para>Send a raw option with value via DHCPv4 server. Takes a DHCP option number, data type
and data (<literal><replaceable>option</replaceable>:<replaceable>type</replaceable>:<replaceable>value</replaceable></literal>).
The option number is an integer in the range 1..254. The type takes one of <literal>uint8</literal>,
The option number is an integer in the range 1254. The type takes one of <literal>uint8</literal>,
<literal>uint16</literal>, <literal>uint32</literal>, <literal>ipv4address</literal>, <literal>ipv6address</literal>, or
<literal>string</literal>. Special characters in the data string may be escaped using
<ulink url="https://en.wikipedia.org/wiki/Escape_sequences_in_C#Table_of_escape_sequences">C-style
@ -2371,7 +2373,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<listitem>
<para>Send a vendor option with value via DHCPv4 server. Takes a DHCP option number, data type
and data (<literal><replaceable>option</replaceable>:<replaceable>type</replaceable>:<replaceable>value</replaceable></literal>).
The option number is an integer in the range 1..254. The type takes one of <literal>uint8</literal>,
The option number is an integer in the range 1254. The type takes one of <literal>uint8</literal>,
<literal>uint16</literal>, <literal>uint32</literal>, <literal>ipv4address</literal>, or
<literal>string</literal>. Special characters in the data string may be escaped using
<ulink url="https://en.wikipedia.org/wiki/Escape_sequences_in_C#Table_of_escape_sequences">C-style
@ -2696,7 +2698,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<term><varname>VNI=</varname></term>
<listitem>
<para>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 116777215.
Defaults to unset.</para>
</listitem>
</varlistentry>
@ -2764,7 +2766,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<term><varname>BitRate=</varname></term>
<listitem>
<para>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.</para>
be used here. Takes a number in the range 14294967295.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -3000,8 +3002,9 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<varlistentry>
<term><varname>PacketLimit=</varname></term>
<listitem>
<para>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 14294967294. Defaults to unset and kernel's default is used.</para>
<para>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.</para>
</listitem>
</varlistentry>
</variablelist>
@ -3292,7 +3295,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
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 0255. This setting can be specified multiple
times. If an empty string is assigned, then the all previous assignments are cleared.</para>
</listitem>
</varlistentry>
@ -3311,7 +3314,8 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<varlistentry>
<term><varname>VirtualQueues=</varname></term>
<listitem>
<para>Specifies the number of virtual queues. Takes a integer in the range 1-16. Defaults to unset and kernel's default is used.</para>
<para>Specifies the number of virtual queues. Takes a integer in the range 1…16. Defaults to unset
and kernel's default is used.</para>
</listitem>
</varlistentry>
@ -3672,7 +3676,7 @@ IPv6Token=prefixstable:2002:da8:1::</programlisting></para>
<varlistentry>
<term><varname>Weight=</varname></term>
<listitem>
<para>Specifies the weight of the class. Takes an integer in the range 1..1023. Defaults to
<para>Specifies the weight of the class. Takes an integer in the range 11023. Defaults to
unset in which case the kernel default is used.</para>
</listitem>
</varlistentry>

View file

@ -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;
}

View file

@ -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 1255, 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 165535, ignoring.", w);
continue;
}
}