2 <!DOCTYPE refentry PUBLIC
"-//OASIS/DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5 <refentry id=
"network-zone-modem">
7 <title>network-zone-modem
</title>
8 <productname>network
</productname>
12 <contrib>Developer
</contrib>
13 <firstname>Michael
</firstname>
14 <surname>Tremer
</surname>
15 <email>michael.tremer@ipfire.org
</email>
21 <refentrytitle>network-zone-modem
</refentrytitle>
22 <manvolnum>8</manvolnum>
26 <refname>network-zone-modem
</refname>
27 <refpurpose>Network Configuration Control Program
</refpurpose>
32 <command>network zone new
<replaceable>ZONE
</replaceable> modem ...
</command>
37 <title>Description
</title>
40 The modem hook uses a serial interface to establish a PPP session to an
41 Internet Service Provider. This method is used by
56k modems and mobile
42 networks like LTE, GSM and
3G.
47 <title>Options
</title>
50 The following options are understood:
56 <option>--device=
<replaceable>DEVICE
</replaceable></option>
61 Sets the serial device that is used to connect.
71 <option>--monitor-device=
<replaceable>DEVICE
</replaceable></option>
76 The optional monitor device is used to collect status
77 information like signal strength and link quality while
78 the connection is established.
85 <option>--imsi=
<replaceable>IMSI
</replaceable></option>
90 Set the IMSI of the SIM card inside the wireless modem
91 to identify it when it is plugged in at runtime.
98 <option>--pin=
<replaceable>PIN
</replaceable></option>
103 The PIN number of the SIM card.
106 This will be used to unlock the SIM card when it
114 <option>--apn=
<replaceable>APN
</replaceable></option>
119 Sets the Access Point Name (
<replaceable>APN
</replaceable>)
120 that the modem connects to.
127 <option>--phone-number=
<replaceable>PHONE-NUMBER
</replaceable></option>
132 Sets the phone number that is dialed by the modem when
133 the connection is to be established.
140 <option>--username=
<replaceable>USERNAME
</replaceable></option>
145 Sets the username for authentication.
152 <option>--password=
<replaceable>PASSWORD
</replaceable></option>
157 Sets the password for authentication.
160 Use the
<option>--auth=
</option> option to transmit it
161 in a secure manner to the provider.
168 <option>--baudrate=
<emphasis>921600</emphasis></option>
173 The baudrate for the serial link to the modem.
180 <option>--mtu=
<emphasis>N
</emphasis></option>
185 Sets the default MTU of the PPP connection.
192 <option>--auth=[chap|pap]
</option>
197 Define the authentication method that is used to
198 authenticate against your provider.
199 The default is to use the provider's preference.
204 <emphasis>Challange-Handshake Authentication Protocol
</emphasis>
205 (chap) is the preferred secure method.
210 <emphasis>Password Authentication Protocol
</emphasis>
211 (pap) sends the plaintext password to the authentication
212 server which is the reason why it should be avoided to use PAP.
222 <title>See Also
</title>
226 <refentrytitle>network
</refentrytitle>
227 <manvolnum>8</manvolnum>
230 <refentrytitle>network-zone
</refentrytitle>
231 <manvolnum>8</manvolnum>