Return to lance CVS log

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

Annotation of lucent/sys/man/3/lance, revision 1.1

1.1     ! root        1: .TH LANCE 3 
        !             2: .SH NAME
        !             3: lance \- LANCE Ethernet device
        !             4: .SH SYNOPSIS
        !             5: .nf
        !             6: .B bind -a #l /net
        !             7: 
        !             8: .B /net/ether/clone
        !             9: .B /net/ether/[0-7]
        !            10: .B /net/ether/[0-7]/data
        !            11: .B /net/ether/[0-7]/ctl
        !            12: .B /net/ether/[0-7]/stats
        !            13: .B /net/ether/[0-7]/type
        !            14: .fi
        !            15: .SH DESCRIPTION
        !            16: The LANCE Ethernet interface is a directory
        !            17: containing 9 stream directories: one for each of 8 Ethernet packet types
        !            18: and a
        !            19: .B clone
        !            20: file.
        !            21: .PP
        !            22: Each stream directory contains files to control the stream,
        !            23: receive and send data,
        !            24: and supply statistics.
        !            25: Incoming Ethernet packets are demultiplexed by packet type and passed up
        !            26: the corresponding open stream.
        !            27: Reading from the
        !            28: .B data
        !            29: file reads packets at the head of the stream.
        !            30: A read will terminate at packet boundaries.
        !            31: Each write to the
        !            32: .B data
        !            33: file causes a packet to be sent.
        !            34: The Ethernet address of the interface is inserted into
        !            35: the packet header as the source address.
        !            36: .PP
        !            37: A stream is assigned a packet type by opening its
        !            38: .B ctl
        !            39: file and
        !            40: writing 
        !            41: .B connect
        !            42: .I n
        !            43: where
        !            44: .I n
        !            45: is a decimal integer constant identifying the Ethernet packet type.
        !            46: A value of \-1 stands for all types.
        !            47: If multiple streams are assigned to a given packet type
        !            48: a copy of the packet is passed up each stream.
        !            49: .PP
        !            50: Reading the
        !            51: .B type
        !            52: file returns the decimal value of the assigned Ethernet packet type.
        !            53: Reading the stats
        !            54: file returns status information and the Ethernet address of the
        !            55: interface.
        !            56: .PP
        !            57: An interface normally receives only packets whose 
        !            58: destination address is that of the interface or is the
        !            59: broadcast address,
        !            60: .BR ff:ff:ff:ff:ff:ff .
        !            61: The interface can be made to receive all packets on the
        !            62: network by writing the string 
        !            63: .B promiscuous
        !            64: to the
        !            65: .B ctl
        !            66: file. 
        !            67: The interface remains promiscuous until the control file is
        !            68: closed.
        !            69: The extra packets are passed up only streams of type \-1.
        !            70: .SH SOURCE
        !            71: .B /sys/src/9/port/devlance.c

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