pup(4p) Unsupported pup(4p)Namepup - raw PUP socket interface
Syntax
#include <sys/socket.h>
#include <netpup/pup.h>
socket(AF_PUP, SOCK_RAW, PUPPROTO_BSP);
Description
A raw pup socket provides PUP-I access to an Ethernet network. Users
send packets using the call, and receive packets with the call. All
outgoing packets must have space present at the front of the packet to
allow the PUP header to be filled in. The header format is described
in Likewise, packets received by the user will have the PUP header on
the front. The PUP header and legal values for the various fields are
defined in the include file <netpup/pup.h>.
The raw pup interface automatically installs the length and source and
destination addresses in the PUP header of all outgoing packets; these
need not be filled in by the user. The only control bit that may be
set in the tcontrol field of outgoing packets is the “trace” bit. A
checksum is calculated unless the sender sets the checksum field to
PUP_NOCKSUM.
Diagnostics
A socket operation may fail and one of the following will be returned:
[EISCONN] When trying to establish a connection on a socket which
already has one, or when trying to send a datagram with
the destination address specified and the socket is
already connected.
[ENOTCONN] When trying to send a datagram, but no destination
address is specified, and the socket hasn't been con‐
nected.
[ENOBUFS] When the system runs out of memory for an internal data
structure.
[EADDRNOTAVAIL]
When an attempt is made to create a socket with a net‐
work address for which no network interface exists.
A operation may fail if one of the following is true:
[EINVAL] Insufficient space was left by the user for the PUP
header.
[EINVAL] The pup_type field was 0 or the pup_tcontrol field had a
bit other than PUP_TRACE set.
[EMSGSIZE] The message was not an even number of bytes, smaller
than MINPUPSIZ, or large than MAXPUPSIZ.
[ENETUNREACH] The destination address was on a network which was not
directly reachable (the raw interface provides no rout‐
ing support).
See Alsosend(2), recv(2), intro(4n), pup(4f)
VAX pup(4p)