]> arthur.barton.de Git - netatalk.git/blob - man/man4/atalk.4
Initial revision
[netatalk.git] / man / man4 / atalk.4
1 .TH ATALK 4F "17 Dec 1991" "netatalk 1.2"
2 .SH NAME
3 atalk \- AppleTalk protocol family
4 .SH SYNOPSIS
5 .B #include <sys/types.h>
6 .br
7 .B #include <netatalk/at.h>
8 .SH DESCRIPTION
9 The AppleTalk protocol family is a collection of protocols layered
10 above the Datagram Delivery Protocol (DDP), and using AppleTalk address
11 format. The AppleTalk family may provide SOCK_STREAM (ADSP), SOCK_DGRAM
12 (DDP), SOCK_RDM (ATP), and SOCK_SEQPACKET (ASP). Currently, only DDP is
13 implemented in the kernel; ATP and ASP are implemented in user level
14 libraries; and ADSP is planned.
15 .SH ADDRESSING
16 AppleTalk addresses are three byte quantities, stored in network
17 byte order. The include file
18 .RB < netatalk/at.h >
19 defines the AppleTalk address format.
20 .LP
21 Sockets in the AppleTalk protocol family use the following address
22 structure:
23 .sp 1
24 .RS
25 .nf
26 struct sockaddr_at {
27         short           sat_family;
28         u_char          sat_port;
29         struct at_addr  sat_addr;
30         char            sat_zero[ 8 ];
31 };
32 .fi
33 .RE
34 .sp 1
35 The port of a socket may be set with
36 .BR bind (2).
37 The node for
38 .B bind
39 must always be
40 .BR ATADDR_ANYNODE :
41 ``this node.'' The net may be
42 .B ATADDR_ANYNET
43 or
44 .BR ATADDR_LATENET .
45 .B ATADDR_ANYNET
46 coresponds to the machine's ``primary'' address (the first
47 configured).
48 .B ATADDR_LATENET
49 causes the address in outgoing packets to be determined when a packet
50 is sent, i.e. determined late.
51 .B ATADDR_LATENET
52 is equivalent to opening one socket for each network interface.  The
53 port of a socket and either the primary address or
54 .B ATADDR_LATENET
55 are returned with
56 .BR getsockname (2).
57 .SH SEE ALSO
58 .\" .BR ddp (4P),
59 .\" .BR atp (3N),
60 .\" .BR asp (3N),
61 .BR bind (2),
62 .BR getsockname (2),
63 .BR atalkd (8).