initial cut at atalk man page

2 files changed, 181 insertions, 2 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 554a4d8f2b9..9aca87a05cd 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,7 +1,7 @@
-#	$OpenBSD: Makefile,v 1.27 1997/10/16 10:08:01 deraadt Exp $
+#	$OpenBSD: Makefile,v 1.28 1997/11/24 07:31:38 deraadt Exp $
 #	$NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $
 
-MAN=	audio.4 acd.4 ahc.4 bpf.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 ddb.4 \
+MAN=	atalk.4 audio.4 acd.4 ahc.4 bpf.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 ddb.4 \
 	de.4 drum.4 \
 	esis.4 fd.4 fpa.4 fxp.4 icmp.4 idp.4 imp.4 inet.4 ip.4 \
 	ipl.4 ipsec.4 iso.4 \
diff --git a/share/man/man4/atalk.4 b/share/man/man4/atalk.4
new file mode 100644
index 00000000000..e53db6d61eb
--- /dev/null
+++ b/share/man/man4/atalk.4
@@ -0,0 +1,179 @@
+.\"	$OpenBSD: atalk.4,v 1.1 1997/11/24 07:31:38 deraadt Exp $
+.\"
+.\" This file is derived from the atalk.4 man page in the Netatlk 1.4b2
+.\" distribution. That distribution is covered by the following copyright:
+.\"
+.\" Copyright (c) 1990,1996 Regents of The University of Michigan.
+.\" All Rights Reserved.
+.\"
+.\" Permission to use, copy, modify, and distribute this software and
+.\" its documentation for any purpose and without fee is hereby granted,
+.\" provided that the above copyright notice appears in all copies and
+.\" that both that copyright notice and this permission notice appear
+.\" in supporting documentation, and that the name of The University
+.\" of Michigan not be used in advertising or publicity pertaining to
+.\" distribution of the software without specific, written prior
+.\" permission. This software is supplied as is without expressed or
+.\" implied warranties of any kind.
+.\"
+.\" This product includes software developed by the University of
+.\" California, Berkeley and its contributors.
+.\"
+.\"	Research Systems Unix Group
+.\"	The University of Michigan
+.\"	c/o Wesley Craig
+.\"	535 W. William Street
+.\"	Ann Arbor, Michigan
+.\"	+1-313-764-2278
+.\"	netatalk@umich.edu
+.\" 
+.Dd November 14, 1997
+.Dt ATALK 4
+.Os
+.Sh NAME
+.Nm atalk
+.Nd AppleTalk Protocol Family
+.Sh SYNOPSIS
+.Fd #include <sys/types.h>
+.Fd #include <netatalk/at.h>
+.Sh DESCRIPTION
+The 
+.Tn AppleTalk
+Protocol Family provides presentation layer support for the AppleTalk
+Datagram Delivery Protocol (DDP), using the SOCK_DGRAM socket type.
+In addition, access to in-kernel AppleTalk routing tables and network
+interface configurations is provided.
+.Pp
+The AppleTalk Protocol Suite provides support for four kinds of
+physical media: LocalTalk (230kbps wire-or'd serial), Ethernet,
+Token Ring, and asynchronous serial connections (using either
+AppleTalk Remote Access
+.Pq Tn ARA
+or
+.Tn PPP
+).   Currently, this AppleTalk implimentataion supports only
+Ethernet.
+.\" and Token Ring?
+.Pp
+AppleTalk packets are encapsulated on the ethernet using the EtherTalk
+Link Access Protocol (ELAP).   Local network address resolution is
+handled using the AppleTalk Address Resolution Protocol (AARP).
+Neither of these protocols is exposed to user-mode applications.
+.Pp
+.Sh ADDRESSING
+AppleTalk addresses are three byte quantities, stored in network
+byte order. The include file
+.Aq Pa netatalk/at.h
+defines the AppleTalk address format.
+
+Sockets in the AppleTalk protocol family use the following address
+structure:
+.Bd -literal -offset indent
+struct sockaddr_at {
+	u_int8_t	sat_len;
+	u_int8_t	sat_family;
+	u_int8_t	sat_port;
+	struct at_addr	sat_addr;
+	union {
+		struct netrange r_netrange;
+		char		r_zero[8];
+	} sat_range;
+};
+.Ed
+.Pp
+The port of a socket may be set with
+.Xr bind 2 .
+The node for
+.Xr bind
+must always be
+.Dv ATADDR_ANYNODE :
+``this node.'' The net
+.\"may
+must
+be
+.Dv ATADDR_ANYNET .
+.\"or
+.\".Dv ATADDR_LATENET .
+.Dv ATADDR_ANYNET
+coresponds to the machine's ``primary'' address (the first
+configured).
+.\".Dv ATADDR_LATENET
+.\"causes the address in outgoing packets to be determined when a packet
+.\"is sent, i.e. determined late.
+.\".Dv ATADDR_LATENET
+.\"is equivalent to opening one socket for each network interface. 
+The port of a socket and
+.\"either
+the primary address
+.\"or
+.\".Dv ATADDR_LATENET
+are returned with
+.Xr getsockname 2 .
+.Sh PROTOCOLS
+The AppleTalk protocol family is comprised of the
+.Tn DDP
+datagram delivery protocol,
+AppleTalk Data Stream Protocol
+.Pq Tn ADSP ,
+AppleTalk Echo Protocol
+.Pq Tn AEP ,
+AppleTalk Filing Protocol
+.Pq Tn AFP ,
+AppleTalk Session Protocol
+.Pq Tn ASP ,
+AppleTalk Transaction Protocol
+.Pq Tn ATP ,
+Name Binding Protocol
+.Pq Tn NBP ,
+Printer Access Protocol
+.Pq Tn PAP ,
+and Zone Information Protocol
+.Pq Tn ZIP .
+.Pp
+.Tn DDP
+is implemented in the kernel as 
+.Dv SOCK_DGRAM
+sockets in the
+.Dv AF_APPLETALK
+address family. 
+.Nx
+implements all other
+.Tn AppleTalk
+protocols using the
+.Tn Netatalk
+package.
+.Tn Netatalk
+implements all functions except for
+.Tn ADSP
+and an
+.Tn AFP
+client.
+.Tn AEP ,
+.Tn NBP ,
+and
+.Tn ZIP
+services are provided by the 
+.Tn atalkd
+daemon.
+.Tn ASP
+and
+.Tn ATP
+services are provided by a user library.
+.Tn PAP
+and
+.Tn AFP
+services are provided by user programs and daemons.
+.Pp
+.Sh SEE ALSO
+.\" .BR ddp (4P),
+.\" .BR atp (3N),
+.\" .BR asp (3N),
+.Xr bind 2 ,
+.Xr getsockname 2 ,
+.Xr atalkd 8 .
+.Rs
+.%B Inside AppleTalk, second edition
+.%A Gursharan S. Sidhu
+.%A Richard F. Andrews
+.%A Alan B. Oppenheimer
+.Re