summaryrefslogtreecommitdiff
path: root/static/plan9-4e/man1/aan.1
diff options
context:
space:
mode:
Diffstat (limited to 'static/plan9-4e/man1/aan.1')
-rw-r--r--static/plan9-4e/man1/aan.188
1 files changed, 88 insertions, 0 deletions
diff --git a/static/plan9-4e/man1/aan.1 b/static/plan9-4e/man1/aan.1
new file mode 100644
index 00000000..a55bfd4e
--- /dev/null
+++ b/static/plan9-4e/man1/aan.1
@@ -0,0 +1,88 @@
+.TH AAN 1
+.SH NAME
+aan \- always available network
+.SH SYNOPSIS
+.B aan
+[
+.B -d
+]
+[
+.B -c
+]
+[
+.B -m maxto
+]
+.I dialstring
+|
+handle
+.SH DESCRIPTION
+.I Aan
+tunnels traffic between a client and a server through a persistent
+network connection. If the connection breaks (voluntarily or
+due to networking problems), the aan client re-establishes the
+connection by redialing the server.
+.PP
+.I Aan
+uses a unique protocol to make sure no data is ever lost even
+when the connection breaks.
+After a reconnection,
+.I aan
+retransmits all unacknowledged data between client and server.
+.PP
+A connection can be broken voluntarily (e.g. by roaming over IP networks),
+or a connection can break when the IP service is unreliable.
+In either case
+.I aan
+re-establishes the client's connection automatically.
+.PP
+When the server part has not heard from the client in
+.I maxto
+seconds, the server part of
+.I aan
+exits. The default
+.I maxto
+is one day.
+The client side (option
+.BR -c )
+calls the server by its
+.IR dialstring ,
+while
+the server side listens on
+.IR handle .
+.PP
+.I Aan
+is usually run automatically through the
+.B -p
+option of
+.IR import (4).
+.SH EXAMPLE
+Assume the server part of aan is encapsulated in exportfs on the
+machine
+.B sob
+and started through
+.B aux/listen
+as follows:
+.IP
+.EX
+netdir=`{echo $3 | sed 's;/[0-9]+$;!*!0;'}
+exec exportfs -a -A $netdir
+.EE
+.PP
+Then machine
+.BR astro6 's
+name space can be imported through
+.I aan
+using this command:
+.IP
+.EX
+import -p /net/tcp!astro6 / /mnt/term
+.EE
+.SH FILES
+.TP
+.B /sys/log/aan
+Log file
+.SH SOURCE
+.B /sys/src/cmd/aan.c
+.SH SEE ALSO
+.IR import (4),
+.IR exportfs (4)