AAN(8)                                                     AAN(8)

     NAME
          aan, aanuke - always available network

     SYNOPSIS
          aan -c [ -d ] [ -m maxto ] dialstring
          aan [ -d ] [ -m maxto ] netdir
          aanuke

     DESCRIPTION
          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.

          Aan uses a unique protocol to make sure no data is ever lost
          even when the connection breaks.  After a reconnection, aan
          retransmits all unacknowledged data between client and
          server.

          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, aan re-establishes the
          client's connection automatically.

          When the server part has not heard from the client in maxto
          seconds, the server part of aan exits.  The default maxto is
          one day.  The client side (option -c) calls the server by
          its dialstring, while the server side listens for connec-
          tions in the already-announced network directory netdir.

          Aan is usually run automatically through the -p option of
          rimport, rexport and rcpu(1).

          Aanuke prints commands that will cause all processes called
          aan that are owned by the current user and do not have an
          active tcp connection to be terminated.  Use the send com-
          mand of rio(1), or pipe the output of kill into rc(1) to
          execute the commands.

     EXAMPLES
          Assume the server part of aan is encapsulated in exportfs on
          the machine sob and started through aux/listen as follows:

               netdir=`{echo $3 | sed 's;/[0-9]+$;!*!0;'}
               exec exportfs -a -A $netdir

          Then machine astro6's name space can be imported through aan
          using this command:

               import -p astro6 / /mnt/term

     Page 1                       Plan 9            (printed 12/22/24)

     AAN(8)                                                     AAN(8)

          Kill idle instances of aan left behind by a terminal that
          has been powered off:

               aanuke | rc

     FILES
          /sys/log/aan  Log file

     SOURCE
          /sys/src/cmd/aan.c
          /rc/bin/aanuke

     SEE ALSO
          exportfs(4), rcpu(1)

     HISTORY
          Aanuke first appeared in 9front (April, 2014).

     Page 2                       Plan 9            (printed 12/22/24)