Subversion Repositories planix.SVN

.TH AAN 8

.SH NAME

aan \- always available network

.SH SYNOPSIS

.B aan

.B -c

[

.B -d

]

[

.B -m maxto

]

.I dialstring

.br

.B aan

[

.B -d

]

[

.B -m maxto

]

.I netdir

.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

.I 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 for connections in the 

already-announced network directory

.IR netdir .

.PP

.I Aan

is usually run automatically through the

.B -p

option of

.IR import (4).

.SH EXAMPLE

Assume the server part of

.I aan

is encapsulated in

.I 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 astro6 / /mnt/term

.EE

.SH FILES

.TF /sys/log/aan

.TP

.B /sys/log/aan

Log file

.SH SOURCE

.B /sys/src/cmd/aan.c

.SH SEE ALSO

.IR import (4),

.IR exportfs (4)