Return to pup.4p CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man4

Annotation of cci/usr/src/man/man4/pup.4p, revision 1.1.1.1

1.1       root        1: .TH PUP 4P "7 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: pup \- raw PUP socket interface
                      5: .SH SYNOPSIS
                      6: .B #include <sys/socket.h>
                      7: .br
                      8: .B #include <netpup/pup.h>
                      9: .PP
                     10: .B socket(AF_PUP, SOCK_RAW, PUPPROTO_BSP);
                     11: .SH DESCRIPTION
                     12: A raw pup socket provides PUP-I access to an
                     13: Ethernet network.  Users send packets using the 
                     14: .I sendto 
                     15: call, and receive packets with the
                     16: .IR recvfrom 
                     17: call.  All outgoing packets must have space present at
                     18: the front of the packet to allow the PUP header to be
                     19: filled in.  The header format is described in 
                     20: .IR pup (4F).
                     21: Likewise, packets received
                     22: by the user will have the PUP header on the front.  The
                     23: PUP header and legal values for the various fields
                     24: are defined in the include file
                     25: .RI < netpup/pup.h >.
                     26: .PP
                     27: The raw pup interface automatically installs the length
                     28: and source and destination addresses in the PUP header of all
                     29: outgoing packets; these need not be filled in by the user.
                     30: The only control bit that may be set in the 
                     31: .I tcontrol
                     32: field of outgoing packets is the \*(lqtrace\*(rq bit.
                     33: A checksum is calculated unless the sender sets the checksum
                     34: field to PUP_NOCKSUM.
                     35: .SH DIAGNOSTICS
                     36: A socket operation may fail and one of the following will be returned:
                     37: .TP 15
                     38: [EISCONN]
                     39: when trying to establish a connection on a socket which
                     40: already has one, or when trying to send a datagram with the destination
                     41: address specified and the socket is already connected;
                     42: .TP 15
                     43: [ENOTCONN]
                     44: when trying to send a datagram, but
                     45: no destination address is specified, and the socket hasn't been
                     46: connected;
                     47: .TP 15
                     48: [ENOBUFS]
                     49: when the system runs out of memory for
                     50: an internal data structure;
                     51: .TP 15
                     52: [EADDRNOTAVAIL]
                     53: when an attempt is made to create a 
                     54: socket with a network address for which no network interface
                     55: exists.
                     56: .PP
                     57: A 
                     58: .I sendto
                     59: operation may fail if one of the following is true:
                     60: .TP 15
                     61: [EINVAL]
                     62: Insufficient space was left by the user for the PUP header.
                     63: .TP 15
                     64: [EINVAL]
                     65: The
                     66: .I pup_type
                     67: field was 0 or the 
                     68: .I pup_tcontrol
                     69: field had a bit other than PUP_TRACE set.
                     70: .TP 15
                     71: [EMSGSIZE]
                     72: The message was not an even number of bytes, smaller than
                     73: MINPUPSIZ, or large than MAXPUPSIZ.
                     74: .TP 15
                     75: [ENETUNREACH]
                     76: The destination address was on a network which was not
                     77: directly reachable (the raw interface provides no routing support).
                     78: .SH SEE ALSO
                     79: send(2), recv(2), intro(4N), pup(4F)
                     80: .SH BUGS
                     81: The interface is untested against other PUP implementations.

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