stream(3) [plan9 man page]

STREAM(3)						     Library Functions Manual							 STREAM(3)

NAME

       stream - a structure for communications

SYNOPSIS

       bind streamdevice dir

       dir/data
       dir/ctl

DESCRIPTION

       A  stream  is  not a device per se.  However, many devices use the streams package in the kernel to implement communications channels.  The
       properties described here are common to all such channels.

       All streams are represented by two standard files, ctl and data, plus any others the particular device wants to add.  Reading  and  writing
       the  data  file	receives  and sends data on the channel.  If the channel is message oriented, each write will represent a message and each
       read will return at most one message.  If the buffer given in a read is smaller than the message, subsequent reads will return the  remain-
       der of the message.

       Writing	textual command strings to the ctl file performs control operations on the stream.  The strings need not be null-terminated.  Each
       device may add to the control operations.  The common control operations are:

       hangup	     Hang up this stream.  Any subsequent writes will return an error.	The first subsequent read will return  0.   All  following
		     ones will return an error.

       push name     Push the module name onto the top of the stream.

       pop	     Pop the top module off the stream

       Reading	the  ctl  file returns a textual identifier for the stream.  This is used by multiplexed devices and its use is described with the
       particular device.

SEE ALSO

       pipe(3), dk(3), cons(3), async(3), fcall(3), ip(3), reboot(3)

SOURCE

       /sys/src/9/port/st*.c

																	 STREAM(3)

LANCE(3)						     Library Functions Manual							  LANCE(3)

NAME

       lance - LANCE Ethernet device

SYNOPSIS

       bind -a #l /net

       /net/ether/clone
       /net/ether/[0-7]
       /net/ether/[0-7]/data
       /net/ether/[0-7]/ctl
       /net/ether/[0-7]/stats
       /net/ether/[0-7]/type

DESCRIPTION

       The LANCE Ethernet interface is a directory containing 9 stream directories: one for each of 8 Ethernet packet types and a clone file.

       Each  stream  directory	contains files to control the stream, receive and send data, and supply statistics.  Incoming Ethernet packets are
       demultiplexed by packet type and passed up the corresponding open stream.  Reading from the data file reads packets  at	the  head  of  the
       stream.	 A read will terminate at packet boundaries.  Each write to the data file causes a packet to be sent.  The Ethernet address of the
       interface is inserted into the packet header as the source address.

       A stream is assigned a packet type by opening its ctl file and writing connect n where n is a decimal integer constant identifying the Eth-
       ernet  packet  type.   A value of -1 stands for all types.  If multiple streams are assigned to a given packet type a copy of the packet is
       passed up each stream.

       Reading the type file returns the decimal value of the assigned Ethernet packet type.  Reading the stats file  returns  status  information
       and the Ethernet address of the interface.

       An  interface  normally	receives  only	packets  whose	destination  address  is  that	of  the  interface  or	is  the broadcast address,
       ff:ff:ff:ff:ff:ff.  The interface can be made to receive all packets on the network by writing the string promiscuous to the ctl file.  The
       interface remains promiscuous until the control file is closed.	The extra packets are passed up only streams of type -1.

SOURCE

       /sys/src/9/port/devlance.c

																	  LANCE(3)