aan 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. .TH AAN 8
  2. .SH NAME
  3. aan \- always available network
  4. .SH SYNOPSIS
  5. .B aan
  6. [
  7. .B -d
  8. ]
  9. [
  10. .B -c
  11. ]
  12. [
  13. .B -m maxto
  14. ]
  15. .I dialstring
  16. |
  17. .I dir
  18. .SH DESCRIPTION
  19. .I Aan
  20. tunnels traffic between a client and a server through a persistent
  21. network connection. If the connection breaks (voluntarily or
  22. due to networking problems), the aan client re-establishes the
  23. connection by redialing the server.
  24. .PP
  25. .I Aan
  26. uses a unique protocol to make sure no data is ever lost even
  27. when the connection breaks.
  28. After a reconnection,
  29. .I aan
  30. retransmits all unacknowledged data between client and server.
  31. .PP
  32. A connection can be broken voluntarily (e.g. by roaming over IP networks),
  33. or a connection can break when the IP service is unreliable.
  34. In either case
  35. .I aan
  36. re-establishes the client's connection automatically.
  37. .PP
  38. When the server part has not heard from the client in
  39. .I maxto
  40. seconds, the server part of
  41. .I aan
  42. exits. The default
  43. .I maxto
  44. is one day.
  45. The client side (option
  46. .BR -c )
  47. calls the server by its
  48. .IR dialstring ,
  49. while
  50. the server side listens for connections in the
  51. already-announced network directory
  52. .IR devdir .
  53. .PP
  54. .I Aan
  55. is usually run automatically through the
  56. .B -p
  57. option of
  58. .IR import (4).
  59. .SH EXAMPLE
  60. Assume the server part of aan is encapsulated in exportfs on the
  61. machine
  62. .B sob
  63. and started through
  64. .B aux/listen
  65. as follows:
  66. .IP
  67. .EX
  68. netdir=`{echo $3 | sed 's;/[0-9]+$;!*!0;'}
  69. exec exportfs -a -A $netdir
  70. .EE
  71. .PP
  72. Then machine
  73. .BR astro6 's
  74. name space can be imported through
  75. .I aan
  76. using this command:
  77. .IP
  78. .EX
  79. import -p astro6 / /mnt/term
  80. .EE
  81. .SH FILES
  82. .TP
  83. .B /sys/log/aan
  84. Log file
  85. .SH SOURCE
  86. .B /sys/src/cmd/aan.c
  87. .SH SEE ALSO
  88. .IR import (4),
  89. .IR exportfs (4)