git: 9front

Download patch

ref: 0a76bb1d37423e361aadebf9f3c3e0ea2b4c0e26
parent: 57f6ef379caa35212dd69fe8892b92096aaccc52
author: cinap_lenrek <cinap_lenrek@gmx.de>
date: Thu May 3 08:47:51 EDT 2012

ip(3): il protocol

--- a/sys/man/3/ip
+++ b/sys/man/3/ip
@@ -1,6 +1,6 @@
 .TH IP 3
 .SH NAME
-ip, esp, gre, icmp, icmpv6, ipmux, rudp, tcp, udp \- network protocols over IP
+ip, esp, gre, icmp, icmpv6, ipmux, rudp, tcp, udp, il \- network protocols over IP
 .SH SYNOPSIS
 .nf
 .2C
@@ -29,6 +29,7 @@
 .B /net/rudp
 .B /net/tcp
 .B /net/udp
+.B /net/il
 .sp 0.3v
 .B /net/tcp/clone
 .B /net/tcp/stats
@@ -461,9 +462,11 @@
 .BR ip ,
 .BR fs ,
 .BR tcp ,
+.BR il ,
 .BR icmp ,
 .BR udp ,
 .BR compress ,
+.BR ilmsg ,
 .BR gre ,
 .BR tcpwin ,
 .BR tcprxmt ,
@@ -515,7 +518,7 @@
 .I ip
 device
 supports IP as well as several protocols that run over it:
-TCP, UDP, RUDP, ICMP, GRE, and ESP.
+TCP, UDP, RUDP, ICMP, IL, GRE, and ESP.
 TCP and UDP provide the standard Internet
 protocols for reliable stream and unreliable datagram
 communication.
@@ -525,8 +528,8 @@
 .IR ping (8).
 GRE is a general encapsulation protocol.
 ESP is the encapsulation protocol for IPsec.
-IL provided a reliable datagram service for communication
-between Plan 9 machines over IPv4, but is no longer part of the system.
+IL provides a reliable datagram service for communication
+between Plan 9 machines but is now deprecated.
 .PP
 Each protocol is a subdirectory of the IP stack.
 The top level directory of each protocol contains a
@@ -930,6 +933,21 @@
 .I data
 file.
 .
+.SS IL
+IL is a reliable point-to-point datagram protocol that runs over IPv4.
+Like TCP, IL delivers datagrams
+reliably and in order. Also like TCP, a connection is
+determined by the address and port numbers of the two ends.
+Like UDP, each read and write transfers a single datagram.
+.PP
+IL is efficient for LANs but doesn't have the
+congestion control features needed for use through
+the Internet.
+It is no longer necessary, except to communicate with old standalone
+.IR fs (4)
+file servers.
+Its use is now deprecated.
+.
 .SS GRE
 GRE is the encapsulation protocol used by PPTP.
 The kernel implements just enough of the protocol
@@ -1229,6 +1247,23 @@
 datagrams received for bad ports
 malformed datagrams received
 datagrams sent
+.in -0.25i
+.1C
+.EE
+.PP
+Reading
+.B /net/il/stats
+returns a list of 6 tagged and newline-separated fields representing:
+.EX
+.ft 1
+.2C
+.in +0.25i
+checksum errors
+header length errors
+out of order messages
+retransmitted messages
+duplicate messages
+duplicate bytes
 .in -0.25i
 .1C
 .EE
--