]>
Commit | Line | Data |
---|---|---|
23eec7d0 | 1 | = network-zone-modem(8) |
23eec7d0 MT |
2 | |
3 | == NAME | |
4 | network-zone-modem - Configure serial modems | |
5 | ||
6 | == SYNOPSIS | |
7 | [verse] | |
8 | `network zone new ZONE modem ...` | |
9 | ||
10 | == DESCRIPTION | |
11 | The modem hook uses a serial interface to establish a PPP session to an Internet | |
12 | Service Provider. This method is used by 56k modems and mobile networks like | |
13 | LTE, GSM and 3G. | |
14 | ||
15 | == OPTIONS | |
16 | The following options are understood: | |
17 | ||
18 | `--device=DEVICE`:: | |
19 | Sets the serial device that is used to connect. Example: /dev/ttyUSB0 | |
20 | ||
21 | `--monitor-device=DEVICE`:: | |
22 | The optional monitor device is used to collect status information like | |
23 | signal strength and link quality while the connection is established. | |
24 | ||
25 | `--imsi=IMSI`:: | |
26 | Set the IMSI of the SIM card inside the wireless modem to identify it when | |
27 | it is plugged in at runtime. | |
28 | ||
29 | `--pin=PIN`:: | |
30 | The PIN number of the SIM card. | |
31 | This will be used to unlock the SIM card when it is locked. | |
32 | ||
33 | `--apn=APN`:: | |
34 | Sets the Access Point Name (APN) that the modem connects to. | |
35 | ||
36 | `--phone-number=PHONE-NUMBER`:: | |
37 | Sets the phone number that is dialled by the modem when the connection is | |
38 | to be established. | |
39 | ||
40 | `--username=USERNAME`:: | |
41 | Sets the username for authentication. | |
42 | ||
43 | `--password=PASSWORD`:: | |
44 | Sets the password for authentication. | |
45 | + | |
46 | Use the `--auth=` option to transmit it in a secure manner to the provider. | |
47 | ||
48 | `--baudrate=921600`:: | |
49 | The baudrate for the serial link to the modem. | |
50 | ||
51 | `--mtu=N`:: | |
52 | Sets the default MTU of the PPP connection. | |
53 | ||
54 | `--auth=[chap|pap]`:: | |
55 | Define the authentication method that is used to authenticate against your | |
56 | provider. The default is to use the provider's preference. | |
57 | ||
58 | * _Challange-Handshake Authentication Protocol_ (`chap`) is the preferred, | |
59 | secure method. | |
60 | * _Password Authentication Protocol_ (`pap`) sends the plaintext password | |
61 | to the authentication server which is the reason why it should be avoided. | |
62 | ||
6b1e7474 MT |
63 | == AUTHORS |
64 | Michael Tremer | |
65 | ||
23eec7d0 MT |
66 | == SEE ALSO |
67 | link:network[8], | |
68 | link:network-zone[8] |