doc/ethernet.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

<h1 id="ethernet-manual"
>ethernet Manual</h1
><h2 id="description"
>Description</h2
><p
>This connection method uses the unmaintained net-tools (ifconfig) and dhcpcd to gain an IP address.</p
><h2 id="options"
>Options</h2
><dl
><dt
  >INTERFACE (required)</dt
  ><dd
  >The wireless interface to configure</dd
  ><dt
  >IP (required)</dt
  ><dd
  >Can be either 'static' or 'dhcp'. Static requires IFOPTS at least.</dd
  ><dt
  >IFOPTS</dt
  ><dd
  >Arguments to pass to 'ifconfig'.</dd
  ><dt
  >GATEWAY (requires IP of 'static')</dt
  ><dd
  >Set specified gateway</dd
  ></dl
><h3 id="dns"
>DNS</h3
><dl
><dt
  >DNS</dt
  ><dd
  >Array of DNS nameservers. Simply specify the IP's of each of the DNS nameservers.</dd
  ><dt
  >DNS1, DNS2 (deprecated)</dt
  ><dd
  >Specify first and second nameservers.</dd
  ><dt
  >SEARCH</dt
  ><dd
  >&quot;search&quot; line for /etc/resolv.conf</dd
  ><dt
  >DOMAIN</dt
  ><dd
  >&quot;domain&quot; line for /etc/resolv.conf</dd
  ><dt
  >HOSTNAME</dt
  ><dd
  >Set the system hostname. Ensure any hostname is correctly referenced in /etc/hosts.</dd
  ></dl
><h3 id="dhcp"
>DHCP</h3
><dl
><dt
  >DHCLIENT</dt
  ><dd
  >yes/no. Use dhclient instead of dhcpcd. Defaults to no.</dd
  ><dt
  >DHCP_OPTIONS</dt
  ><dd
  >String. Any extra arguments to pass to the dhcp client, presently dhcpcd.</dd
  ><dt
  >DHCP_TIMEOUT</dt
  ><dd
  >Integer. Maximum time to try for a DHCP IP. Default is 10 seconds.</dd
  ></dl
><h3 id="x-authentication"
>802.11x Authentication</h3
><dl
><dt
  >AUTH8021X</dt
  ><dd
  >Use 802.11x authentication. Enable with 'yes'.</dd
  ><dt
  >WPA_CONF (required for an AUTH8021X of 'yes' only)</dt
  ><dd
  >Path to wpa_supplicant configuration. Defaults to '/etc/wpa_supplicant.conf'</dd
  ><dt
  >WPA_OPTS (optional for an AUTH8021X of 'yes')</dt
  ><dd
  >Extra arguments for wpa_supplicant not specified otherwise. Any option here must specify wpa_supplicant driver. Defaults to '-Dwired'.</dd
  ></dl
><h2 id="examples"
>Examples</h2
><p
>See /etc/network.d/examples</p
>