aan 1.7 KB

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