Return to arp CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 3

Annotation of lucent/sys/man/3/arp, revision 1.1.1.1

1.1       root        1: .TH ARP 3 
                      2: .SH NAME
                      3: arp \- Internet Address Resolution Protocol
                      4: .SH SYNOPSIS
                      5: .nf
                      6: .B bind -a #a /net/arp
                      7: .sp
                      8: .B /net/arp/ctl
                      9: .B /net/arp/data
                     10: .B /net/arp/stats
                     11: .fi
                     12: .SH DESCRIPTION
                     13: The
                     14: .I arp
                     15: device provides the means by which the kernel resolves
                     16: IP addresses
                     17: into Ethernet addresses.
                     18: A cache is maintained by the
                     19: .B arp
                     20: device to speed the process.
                     21: .PP
                     22: The
                     23: .B ctl
                     24: file controls the ARP cache maintained by the kernel.
                     25: The
                     26: .B flush
                     27: control message invalidates all entries in the cache.
                     28: The
                     29: .B delete
                     30: .I ipaddr
                     31: control message invalidates a single cache entry.
                     32: All IP addresses passed to the system are in the canonical textual form
                     33: described in
                     34: .IR ip (2).
                     35: The
                     36: .B perm
                     37: .I ipaddr
                     38: control message makes an existing cache entry permanent.
                     39: .PP
                     40: When the kernel boots,
                     41: .B ipconfig
                     42: sets up the IP stream and
                     43: .B arpd
                     44: opens
                     45: .B #a/arp/data
                     46: (see
                     47: .IR ipconfig (8)).
                     48: This establishes the ARP cache
                     49: and enables
                     50: .B arpd
                     51: to receive all ARP packets from the network, which it uses to maintain the cache
                     52: by writing the results of address resolution requests back into the cache.
                     53: The IP stream module uses the cache to translate IP addresses.
                     54: .PP
                     55: Subsequent opens of the
                     56: .B data
                     57: file allow the contents of the cache to be examined.
                     58: Each cache entry consists of an
                     59: IP address, an Ethernet address, and the status of the entry.
                     60: Entries may be
                     61: invalid, permanent, or temporary.
                     62: Permanent entries will never be aged from the cache.
                     63: Temporary entries may be replaced by new addresses entered by the ARP server.
                     64: .PP
                     65: The file
                     66: .B stats
                     67: reports the cache performance.
                     68: .SH SEE ALSO
                     69: .IR ip (3),
                     70: .IR ipconfig (8)
                     71: .SH SOURCE
                     72: .B /sys/src/9/port/devarp.c

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.