man/man4/atalk.4

   1 '\" t
   2 .\"     Title: atalk
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 17 Dec 1991
   6 .\"    Manual: Netatalk 2.2
   7 .\"    Source: Netatalk 2.2
   8 .\"  Language: English
   9 .\"
  10 .TH "ATALK" "4" "17 Dec 1991" "Netatalk 2.2" "Netatalk 2.2"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 atalk \- AppleTalk protocol family
  23 .SH "SYNOPSIS"
  24 .sp
  25 .ft B
  26 .nf
  27 #include <sys/types\&.h>
  28 #include <netatalk/at\&.h>
  29 .fi
  30 .ft
  31 .SH "DESCRIPTION"
  32 .PP
  33 The AppleTalk protocol family is a collection of protocols layered above the Datagram Delivery Protocol (DDP), and using AppleTalk address format\&. The AppleTalk family may provide SOCK_STREAM (ADSP), SOCK_DGRAM (DDP), SOCK_RDM (ATP), and SOCK_SEQPACKET (ASP)\&. Currently, only DDP is implemented in the kernel; ATP and ASP are implemented in user level libraries; and ADSP is planned\&.
  34 .SH "ADDRESSING"
  35 .PP
  36 AppleTalk addresses are three byte quantities, stored in network byte order\&. The include file <\fBnetatalk/at\&.h\fR> defines the AppleTalk address format\&.
  37 .PP
  38 Sockets in the AppleTalk protocol family use the following address structure:
  39 .sp
  40 .if n \{\
  41 .RS 4
  42 .\}
  43 .nf
  44 struct sockaddr_at {
  45     short sat_family;
  46     u_char sat_port;
  47     struct at_addr sat_addr;
  48     char sat_zero[ 8 ];
  49 };
  50 .fi
  51 .if n \{\
  52 .RE
  53 .\}
  54 .PP
  55 The port of a socket may be set with
  56 \fBbind\fR(2)\&. The node for
  57 \fBbind\fR
  58 must always be
  59 \fBATADDR_ANYNODE\fR: ``this node\&.\'\' The net may be
  60 \fBATADDR_ANYNET\fR
  61 or
  62 \fBATADDR_LATENET\fR\&.
  63 \fBATADDR_ANYNET\fR
  64 coresponds to the machine\'s ``primary\'\' address (the first configured)\&.
  65 \fBATADDR_LATENET\fR
  66 causes the address in outgoing packets to be determined when a packet is sent, i\&.e\&. determined late\&.
  67 \fBATADDR_LATENET\fR
  68 is equivalent to opening one socket for each network interface\&. The port of a socket and either the primary address or
  69 \fBATADDR_LATENET\fR
  70 are returned with
  71 \fBgetsockname\fR(2)\&.
  72 .SH "SEE ALSO"
  73 .PP
  74 \fBbind\fR(2),
  75 \fBgetsockname\fR(2),
  76 \fBatalkd\fR(8)\&.