Merge from branch 2-1

[netatalk.git] / man / man4 / atalk.4

diff --git a/man/man4/atalk.4 b/man/man4/atalk.4
index ecb5c270c14ecd305040782b39029e88ef999de4..356b93e7486669d7d2ab429a6c93c7ebce848d47 100644 (file)
--- a/man/man4/atalk.4
+++ b/man/man4/atalk.4
@@ -1,63 +1,76 @@
-.TH ATALK 4F "17 Dec 1991" "netatalk 1.2"
-.SH NAME
+'\" t
+.\"     Title: atalk
+.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\"      Date: 17 Dec 1991
+.\"    Manual: Netatalk 2.2
+.\"    Source: Netatalk 2.2
+.\"  Language: English
+.\"
+.TH "ATALK" "4" "17 Dec 1991" "Netatalk 2.2" "Netatalk 2.2"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
 atalk \- AppleTalk protocol family
-.SH SYNOPSIS
-.B #include <sys/types.h>
-.br
-.B #include <netatalk/at.h>
-.SH DESCRIPTION
-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.
-.SH ADDRESSING
-AppleTalk addresses are three byte quantities, stored in network
-byte order. The include file
-.RB < netatalk/at.h >
-defines the AppleTalk address format.
-.LP
-Sockets in the AppleTalk protocol family use the following address
-structure:
-.sp 1
-.RS
+.SH "SYNOPSIS"
+.sp
+.ft B
+.nf
+#include <sys/types\&.h>
+#include <netatalk/at\&.h>
+.fi
+.ft
+.SH "DESCRIPTION"
+.PP
+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\&.
+.SH "ADDRESSING"
+.PP
+AppleTalk addresses are three byte quantities, stored in network byte order\&. The include file <\fBnetatalk/at\&.h\fR> defines the AppleTalk address format\&.
+.PP
+Sockets in the AppleTalk protocol family use the following address structure:
+.sp
+.if n \{\
+.RS 4
+.\}
 .nf
 struct sockaddr_at {
-       short           sat_family;
-       u_char          sat_port;
-       struct at_addr  sat_addr;
-       char            sat_zero[ 8 ];
+    short sat_family;
+    u_char sat_port;
+    struct at_addr sat_addr;
+    char sat_zero[ 8 ];
 };
 .fi
+.if n \{\
 .RE
-.sp 1
+.\}
+.PP
 The port of a socket may be set with
-.BR bind (2).
-The node for
-.B bind
+\fBbind\fR(2)\&. The node for
+\fBbind\fR
 must always be
-.BR ATADDR_ANYNODE :
-``this node.'' The net may be
-.B ATADDR_ANYNET
+\fBATADDR_ANYNODE\fR: ``this node\&.\'\' The net may be
+\fBATADDR_ANYNET\fR
 or
-.BR ATADDR_LATENET .
-.B ATADDR_ANYNET
-coresponds to the machine's ``primary'' address (the first
-configured).
-.B ATADDR_LATENET
-causes the address in outgoing packets to be determined when a packet
-is sent, i.e. determined late.
-.B ATADDR_LATENET
-is equivalent to opening one socket for each network interface.  The
-port of a socket and either the primary address or
-.B ATADDR_LATENET
+\fBATADDR_LATENET\fR\&.
+\fBATADDR_ANYNET\fR
+coresponds to the machine\'s ``primary\'\' address (the first configured)\&.
+\fBATADDR_LATENET\fR
+causes the address in outgoing packets to be determined when a packet is sent, i\&.e\&. determined late\&.
+\fBATADDR_LATENET\fR
+is equivalent to opening one socket for each network interface\&. The port of a socket and either the primary address or
+\fBATADDR_LATENET\fR
 are returned with
-.BR getsockname (2).
-.SH SEE ALSO
-.\" .BR ddp (4P),
-.\" .BR atp (3N),
-.\" .BR asp (3N),
-.BR bind (2),
-.BR getsockname (2),
-.BR atalkd (8).
+\fBgetsockname\fR(2)\&.
+.SH "SEE ALSO"
+.PP
+\fBbind\fR(2),
+\fBgetsockname\fR(2),
+\fBatalkd\fR(8)\&.