]> arthur.barton.de Git - netatalk.git/blob - man/man4/atalk.4
- merge branch-netatalk-afp-3x-dev, HEAD was tagged before
[netatalk.git] / man / man4 / atalk.4
1 .TH atalk 4 "17 Dec 1991" 2.0.0 Netatalk 
2 .SH NAME
3 atalk \- AppleTalk protocol family
4 .SH SYNOPSIS
5 .nf
6 #include <sys/types.h>
7 #include <netatalk/at.h>
8 .fi
9 .sp 1
10 .SH DESCRIPTION
11 The AppleTalk protocol family is a collection of protocols layered
12 above the Datagram Delivery Protocol (DDP), and using AppleTalk address
13 format. The AppleTalk family may provide SOCK_STREAM (ADSP), SOCK_DGRAM
14 (DDP), SOCK_RDM (ATP), and SOCK_SEQPACKET (ASP). Currently, only DDP is
15 implemented in the kernel; ATP and ASP are implemented in user level
16 libraries; and ADSP is planned.
17 .SH ADDRESSING
18 AppleTalk addresses are three byte quantities, stored in network
19 byte order. The include file <\fInetatalk/at.h\fR>
20 defines the AppleTalk address format.
21 .PP
22 Sockets in the AppleTalk protocol family use the following address
23 structure:
24 .PP
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 .PP
34 The port of a socket may be set with \fBbind\fR(2).
35 The node for \fIbind\fR must always be \fIATADDR_ANYNODE\fR: ``this node.'' The net may be
36 \fIATADDR_ANYNET\fR or \fIATADDR_LATENET\fR.
37 \fIATADDR_ANYNET\fR coresponds to the
38 machine's ``primary'' address (the first configured).
39 \fIATADDR_LATENET\fR causes the address in
40 outgoing packets to be determined when a packet is sent, i.e. determined
41 late. \fIATADDR_LATENET\fR is equivalent to
42 opening one socket for each network interface. The port of a socket and
43 either the primary address or \fIATADDR_LATENET\fR
44 are returned with \fBgetsockname\fR(2).
45 .SH "SEE ALSO"
46 \fBbind\fR(2),
47 \fBgetsockname\fR(2),
48 \fBatalkd\fR(8).
49