SymbX/systemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

network: Rename ModemManager .network section WRT tech, not project...

Browse Source 
and use dedicated knobs for every option used in
former SimpleConnectProperties.
New section is [MobileNetwork] with the following configuration options:

APN=
AllowedAuthenticationMechanisms==
User=
Password=
IPFamily=
AllowRoaming=
PIN=
OperatorId=
This commit is contained in:
Oleksandr Andrushchenko
2026-03-04 12:42:19 +01:00
committed by Zbigniew Jędrzejewski-Szmek
parent a22ad0efcc
commit 899992bc1e
8 changed files with 256 additions and 171 deletions
Download Patch File Download Diff File Expand all files Collapse all files
man/systemd.network.xml
+80 -57
View File
@@ -6445,12 +6445,12 @@ ServerAddress=192.168.0.1/24</programlisting>
</refsect1>
<refsect1>
<title>[ModemManager] Section Options</title>
<title>[MobileNetwork] Section Options</title>
<para>This section configures the default setting of the ModemManager integration. See
<ulink url="https://modemmanager.org/docs/modemmanager/" /> for more information about ModemManager.</para>
<para>Regardless of the [ModemManager] section settings consider using the following for LTE modems (take into account
<para>Regardless of the [MobileNetwork] section settings consider using the following for LTE modems (take into account
that LTE modems do not typically support LLDP because LLDP is a Layer 2 protocol for Ethernet networks and an LTE
modem connects to a cellular network, not a local Ethernet LAN):
<programlisting>[Network]
@@ -6460,75 +6460,89 @@ IPv6AcceptRA=no
</programlisting>
</para>
<para>The following options are available in the [ModemManager] section:</para>
<para>The following options are available in the [MobileNetwork] section:</para>
<variablelist class='network-directives'>
<varlistentry>
<term><varname>SimpleConnectProperties=</varname></term>
<term><varname>APN=</varname></term>
<listitem>
<para>Specifies the white-space separated list of simple connect properties used to connect a modem. See
<ulink url="https://www.freedesktop.org/software/ModemManager/man/latest/mmcli.1.html" /> for more
information about simple connect. If no properties provided then the connection is not initiated.</para>
<para>An Access Point Name (APN) is the name of a gateway between a mobile network
(GSM, GPRS, 3G, 4G and 5G) and another computer network. Required in 3GPP.
Defaults to unset and no attempt to establish the connection is made.</para>
<varlistentry>
<term><option>apn</option>=<replaceable>NAME</replaceable></term>
<listitem><para>An Access Point Name (APN) is the name of a gateway between a mobile network
(GSM, GPRS, 3G, 4G and 5G) and another computer network. Required in 3GPP.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><varname>AllowedAuthenticationMechanisms=</varname></term>
<listitem>
<para>Authentication method to use. Specifies the white-space separated list of
<literal>none</literal>, <literal>pap</literal>, <literal>chap</literal>,
<literal>mschap</literal>, <literal>mschapv2</literal>, or <literal>eap</literal>
methods. Optional in 3GPP. Defaults to unset and an automatically picked
authentication method will be used.</para>
<varlistentry>
<term><option>allowed-auth</option>=<replaceable>METHOD</replaceable></term>
<listitem><para>Authentication method to use. Takes one of "none", "pap", "chap", "mschap", "mschapv2" or "eap".
Optional in 3GPP.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><varname>User=</varname></term>
<listitem>
<para>User name (if any) required by the network. Optional in 3GPP.
Defaults to unset.</para>
<varlistentry>
<term><option>user</option>=<replaceable>NAME</replaceable></term>
<listitem><para>User name (if any) required by the network. Optional in 3GPP.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><varname>Password=</varname></term>
<listitem>
<para>Password (if any) required by the network. Optional in 3GPP.
Defaults to unset.</para>
<varlistentry>
<term><option>password</option>=<replaceable>PASSWORD</replaceable></term>
<listitem><para>Password (if any) required by the network. Optional in 3GPP.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><varname>IPFamily=</varname></term>
<listitem>
<para>Addressing type. Takes one of <literal>ipv4</literal>, <literal>ipv6</literal>,
<literal>both</literal>, or <literal>any</literal>. Optional in 3GPP and CDMA.
Defaults to unset and automatically selected.</para>
<varlistentry>
<term><option>ip-type</option>=<replaceable>TYPE</replaceable></term>
<listitem><para>Addressing type. Takes one of "none", "ipv4", "ipv6", "ipv4v6" or "any".
Optional in 3GPP and CDMA.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><varname>AllowRoaming=</varname></term>
<listitem>
<para>A boolean. When true, connection is allowed during roaming. When false,
connection is not allowed during roaming.
Optional in 3GPP. Defaults to <literal>yes</literal>.</para>
<varlistentry>
<term><option>allow-roaming</option>=<replaceable>BOOL</replaceable></term>
<listitem><para>A boolean. When true, connection is allowed during roaming. When false,
connection is not allowed during roaming. Optional in 3GPP.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><varname>PIN=</varname></term>
<listitem>
<para>SIM-PIN unlock code. Defaults to unset.</para>
<varlistentry>
<term><option>pin</option>=<replaceable>PIN</replaceable></term>
<listitem><para>SIM-PIN unlock code.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><option>operator-id</option>=<replaceable>ID</replaceable></term>
<listitem><para>ETSI MCC-MNC of a network to force registration.</para>
<xi:include href="version-info.xml" xpointer="v260"/></listitem>
</varlistentry>
<varlistentry>
<term><varname>OperatorId=</varname></term>
<listitem>
<para>ETSI MCC-MNC of a network to force registration. Defaults to unset.</para>
<xi:include href="version-info.xml" xpointer="v260"/>
</listitem>
</varlistentry>
@@ -6896,14 +6910,23 @@ LLDP=no
LinkLocalAddressing=no
IPv6AcceptRA=no
[ModemManager]
SimpleConnectProperties=apn=internet pin=1111
[MobileNetwork]
APN=internet
AllowedAuthenticationMechanisms=none pap chap
User=user
Password=pass
IPFamily=both
AllowRoaming=no
PIN=1111
OperatorId=25503
RouteMetric=30
UseGateway=yes</programlisting>
<para>This connects a cellular modem to a broadband network matched with the network interface <literal>wwan0</literal>,
with APN name <literal>internet</literal>, SIM card pin unlock code <literal>1111</literal> and sets up a default
gateway with route metric of 30.
with APN name <literal>internet</literal>, allowed authentication <literal>none</literal>, <literal>pcap</literal>, or
<literal>chap</literal>, user name <literal>user</literal>, their password <literal>pass</literal>, allows both IPv4 and IPv6,
does not allow roaming, SIM card pin unlock code <literal>1111</literal>, only allows connecting to operator with
MCC <literal>25503</literal>, and sets up a default gateway with route metric of 30.
</para>
</example>
</refsect1>