Annotation of researchv10dc/man/man3/udp.3, revision 1.1.1.1

1.1       root        1: .TH UDP 3X
                      2: .CT 2 comm_mach
                      3: .SH NAME
                      4: udp_connect, udp_listen, udp_datagram \(mi udp networking functions
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B #include <sys/inet/udp_user.h>
                      8: .PP
                      9: .B int udp_connect(sport, dhost, dport)
                     10: .B in_addr dhost;
                     11: .B udp_port sport, dport;
                     12: .PP
                     13: .B int udp_listen(sport, reply)
                     14: .B udp_port sport;
                     15: .B struct udpreply *reply;
                     16: .PP
                     17: .B int udp_datagram(sport)
                     18: .B udp_port sport;
                     19: .PP
                     20: .SH DESCRIPTION
                     21: These routines are loaded by the
                     22: .B -lin
                     23: option of
                     24: .IR ld (1).
                     25: .PP
                     26: UDP (universal datagram protocol) is a protocol layered
                     27: upon IP (internet protocol).
                     28: It provides datagram service between end points called sockets.
                     29: A socket address is composed of the internet address
                     30: of its host and the port number to which
                     31: the socket is bound.
                     32: .PP
                     33: .I Udp_connect
                     34: returns the file descriptor of a UDP socket bound to port
                     35: .I sport.
                     36: Each
                     37: .IR read (2)
                     38: from this file descriptor will only accept datagrams from the UDP
                     39: socket at host
                     40: .I dhost,
                     41: port
                     42: .IR dport ;
                     43: a
                     44: .IR write
                     45: on this file descriptor will be sent to that socket.
                     46: .PP
                     47: .I Udp_listen
                     48: returns the file descriptor of a UDP socket bound to port
                     49: .I sport
                     50: and waits for a datagram to be sent to that port.
                     51: Once a message has been received from another socket,
                     52: all writes
                     53: will go to that socket and
                     54: reads will only accept data from that socket.
                     55: .PP
                     56: .I Udp_datagram
                     57: returns the file descriptor of a UDP socket bound to port
                     58: .I sport.
                     59: Messages written to the file descriptor must start with a
                     60: .B struct udpaddr
                     61: which contains the destination of the message.
                     62: .IP
                     63: .EX
                     64: .ta \w'struct 'u +\w'updaddr 'u
                     65: struct udpaddr {
                     66:        in_addr host;
                     67:        int     port;
                     68: };
                     69: .EE
                     70: .PP
                     71: Messages read from the file descriptor also start with a
                     72: .B struct udpaddr
                     73: and contain the address of the source socket.
                     74: .SH FILES
                     75: .TP 12
                     76: .F /dev/udp*
                     77: the socket devices
                     78: .SH SEE ALSO
                     79: .IR internet (3), 
                     80: .IR tcp (3)
                     81: .SH DIAGNOSTICS
                     82: All these routines
                     83: returns \-1 on failure.

unix.superglobalmegacorp.com

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