]> arthur.barton.de Git - netatalk.git/blob - man/man4/atalk.4
large commit, replace the old manpages with the ones generated from Docbook XML
[netatalk.git] / man / man4 / atalk.4
1 .TH atalk 4  17\ Dec\ 1991 "Netatalk 2.0-alpha1" 
2 .SH NAME
3 atalk \- AppleTalk protocol family
4 .SH SYNOPSIS
5 \fI#include <sys/types.h>\fR
6 \fI#include <netatalk/at.h>\fR
7 .SH DESCRIPTION
8 The AppleTalk protocol family is a collection of protocols layered
9 above the Datagram Delivery Protocol (DDP), and using AppleTalk address
10 format. The AppleTalk family may provide SOCK_STREAM (ADSP), SOCK_DGRAM
11 (DDP), SOCK_RDM (ATP), and SOCK_SEQPACKET (ASP). Currently, only DDP is
12 implemented in the kernel; ATP and ASP are implemented in user level
13 libraries; and ADSP is planned.
14 .SH ADDRESSING
15 AppleTalk addresses are three byte quantities, stored in network
16 byte order. The include file <\fInetatalk/at.h\fR>
17 defines the AppleTalk address format.
18 .PP
19 Sockets in the AppleTalk protocol family use the following address
20 structure:
21 .PP
22 struct
23 .PP
24 .nf
25 struct sockaddr_at {
26 short sat_family;
27 u_char sat_port;
28 struct at_addr sat_addr;
29 char sat_zero[ 8 ];
30 };
31 .fi
32 .PP
33 The port of a socket may be set with \fBbind\fR(2).
34 The node for \fIbind\fR must always be \fIATADDR_ANYNODE\fR: ``this node.'' The net may be
35 \fIATADDR_ANYNET\fR or \fIATADDR_LATENET\fR.
36 \fIATADDR_ANYNET\fR coresponds to the
37 machine's ``primary'' address (the first configured).
38 \fIATADDR_LATENET\fR causes the address in
39 outgoing packets to be determined when a packet is sent, i.e. determined
40 late. \fIATADDR_LATENET\fR is equivalent to
41 opening one socket for each network interface. The port of a socket and
42 either the primary address or \fIATADDR_LATENET\fR
43 are returned with \fBgetsockname\fR(2).
44 .SH SEE\ ALSO
45 \fBbind\fR(2),
46 \fBgetsockname\fR(2),
47 \fBatalkd\fR(8).
48