3 ipconfig, rip, linklocal, ipv6on \- Internet configuration and routing
63 binds a device interface (default
65 to a mounted IP stack (default
67 and configures the interface with a local address and optionally
68 a mask, a remote address, a file server and an authentication server address.
69 The addresses can be specified in the command line or obtained via DHCP.
70 If DHCP is requested, it will also obtain the addresses of DNS
71 servers, NTP servers, gateways, a Plan 9 file server,
72 and a Plan 9 authentication server.
73 If this is the first non-loopback
74 interface on the IP stack, the information will be written to
92 except that it allows jumbo packets (up to ~9KB).
95 interface passes all IP packets to and from a user program.
98 the device can be any byte stream device.
102 determines the action performed. The usual verbs are:
106 if the device is not bound to the IP stack, bind it.
107 Add the given local address, mask, and remote address to the interface.
108 An interface may have multiple addresses.
111 remove the address from the device interface.
114 unbind the device interface and all its addresses from the
118 The IPv6-specific verbs, which take different arguments, are:
120 .BI "add6 " "prefix pfx-len onlink auto validlt preflt"
121 sets the named IPv6 parameters; see
125 .BI "ra6 " "[ keyword value ] ..."
126 sets IPv6 router advertisement parameter
134 non-zero also forks a process to
135 receive and process router advertisements.
139 enables IP routing on the interface,
140 forks a process to send router advertisements,
143 process is running, forks one.
151 if adding an address (the default action),
152 add the IPv6 link-local address.
155 the baud rate to use on a serial line
160 write the control string
162 to the ethernet device control file before starting to configure it.
163 May be repeated to specify multiple control writes.
166 use DHCP to determine any unspecified configuration parameters.
175 use only generic DHCP options. Without this option,
177 adds to requests a Vendor Class option with value
179 and also requests vendor specific options 128 and 129 which we
180 interpret as the Plan 9 file server and auth server.
181 Replies to these options contain a list of IP addresses for possible
182 file servers and auth servers.
185 the hostname to add to DHCP requests. Some DHCP
186 servers, such as the one used by Comcast, will not respond
187 unless a correct hostname is in the request.
190 the maximum IP packet size to use on this interface.
193 determine parameters but don't configure the interface.
198 for the IP parameters. This only works if the
199 interface is an ethernet. It uses the ethernet address to find
203 addresses specified on the command line override those obtained via DHCP.
204 A command line address of 0 implies no override.
207 write configuration information to
209 even if other network interfaces are already configured
212 do not write configuration information to
214 even if this is the first network interface to be configured
219 exits after trying DHCP for 15 seconds with no answer.
222 instead to fork a background process that keeps trying forever.
225 disable IPv6 duplicate discovery detection,
226 which removes any existing ARP table entry for one of our IPv6 addresses
227 before adding new ones.
230 use the IP stack mounted at
236 don't fork a process to keep the DHCP lease alive.
241 to the list of paramters requested of the DHCP server. The
242 result will appear in
244 should this be the first interface. The known options are:
248 arptimeout, baddr, bflen, bootfile, clientid, cookie, discovermask,
249 discoverrouter, dns, dom, dumpfile, etherencap, extpath, finger,
250 homeagent, impress, ipaddr, ipforward, ipgw, ipmask, irc, lease, log,
251 lpr, maxdatagram, maxmsg, message, mtu, name, netbiosdds, netbiosns,
252 netbiosscope, netbiostype, ni, nisdomain, nisplus, nisplusdomain,
253 nntp, nonlocal, ntp, overload, params, pathplateau, pathtimeout,
254 policyfilter, pop3, rebindingtime, renewaltime, rl, rootpath, rs,
255 serverid, smtp, st, staticroutes, stdar, subnetslocal, supplymask,
256 swap, sys, tcpka, tcpkag, tcpttl, tftp, time, timeoff, trailerencap,
257 ttl, type, vendorclass, www, xdispmanager, xfont
267 are always requested.
271 If DHCP is requested, a process is forked
272 off to renew the lease before it
273 runs out. If the lease does run out, this
274 process will remove any configured addresses
278 runs the routing protocol RIP.
279 It listens for RIP packets on connected networks and
280 updates the kernel routing tables.
286 broadcasts routing information onto the networks.
289 gathers routing information but doesn't write to the
290 route table. This is useful with
295 use the IP stack mounted at
301 turn on (voluminous) debugging.
304 prints the IPv6 link-local address corresponding to the given
312 EUI-64-based IPv6 address corresponding to
320 uses the network database at
322 to configure the network mounted on
324 with a link-local address (derived from its MAC address)
325 and attempts to add a default IPv6 route to the local
326 IPv4 gateway's IPv6 address.
329 is supplied, it will be used as the gateway IPv4 address.
331 Configure Ethernet 0 as the primary IP interface.
332 Get all addresses via DHCP. Start up a connection server
333 and DNS resolver for this IP stack.
343 Add a second address to the stack.
346 % ip/ipconfig ether /net/ether0 add 12.1.1.2 255.255.255.0
349 At Bell Labs, our primary IP stack is always to the company's internal
350 firewall-protected network. The following creates an external
351 IP stack to directly access the outside Internet. Note that the
352 connection server uses a different set of
354 files. This prevents us from confusing inside and outside name/address
358 % bind -b '#l1' /net.alt
359 % bind -b '#I1' /net.alt
360 % ip/ipconfig -x /net.alt -g 204.178.31.1 ether /net.alt/ether1\\
361 204.178.31.6 255.255.255.0
362 % ndb/cs -x /net.alt -f /lib/ndb/external
363 % ndb/dns -sx /net.alt -f /lib/ndb/external
364 % aux/listen -d /rc/bin/service.alt /net.alt/tcp
367 Get all addresses via DHCP.
368 Configure the IPv6 link-local address automatically
369 and listen for router announcements.
373 ip/ipconfig ra6 recvra 1
376 .B /sys/log/v6routeradv
378 .B /sys/src/cmd/ip/ipconfig
380 .B /sys/src/cmd/ip/rip.c
382 .B /sys/src/cmd/ip/linklocal.c
395 for IPv6's modified EUI-64