


     RRRROOOOTTTTAAAARRRRIIIIEEEESSSS((((4444))))                   AAAANNNNNNNNEEEEXXXX                   RRRROOOOTTTTAAAARRRRIIIIEEEESSSS((((4444))))



     NNNNAAAAMMMMEEEE
          rotaries - Annex rotary database

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          The rotaries database contains entries describing the port
          rotaries for any Annexes on the network.  The file,
          ccccoooonnnnffffiiiigggg....aaaannnnnnnneeeexxxx is stored in the directory ////uuuussssrrrr////ssssppppoooooooollll////eeeerrrrppppccccdddd////bbbbffffssss
          contains all the rotary definition information.  See the
          _A_n_n_e_x _N_e_t_w_o_r_k _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e for more information on
          the Annex port server and port rotaries.

          Entries in the rotaries file follow these conventions:

          o   Lines beginning with ``#'' are comments.

          o   Blank lines are ignored.

          o   Lines in the file have a maximum of 132 characters.

          o   Entries can be continued on the next line by preceding
              the newline with ``\''.

          o   The following characters have special meanings:
                  ::::  ++++  @@@@  ////  ,,,,  ;;;;  \\\\  ####

          o   Any special character except ``,'' can be included in a
              rotary name by quoting it with ``\''.

          o   Space and tab characters can be used anywhere except in
              a rotary name to improve readability. Keywords must be
              delimited by space or tab characters.

          Entries have the following syntax:
9                _r_o_t_a_r_y__n_a_m_e:  [[[[ _k_e_y_w_o_r_d ... ]]]] _p_o_r_t_s@_l_o_c_a_t_i_o_n [[[[
               /_a_u_x_p_o_r_t ]]]] [[[[ +_a_u_x_i_p_a_d_d_r ]]]] [[[[ ; _p_o_r_t_s@_l_o_c_a_t_i_o_n ]]]] ...

          _R_o_t_a_r_y__n_a_m_e is an ASCII string terminated by a colon (::::).
          The maximum length is 32 characters.  The string cannot
          contain space, tab, or comma (,,,,) characters. It can contain
          other special characters if they are escaped with a
          backslash.

          _P_o_r_t_s is a list of the serial ports in the rotary.  It can
          be a number, a comma-separated list of numbers, two numbers
          separated by a dash (indicated an inclusive range), or a
          combination of these three formats.

          _L_o_c_a_t_i_o_n identifies the Annex that has the given ports as a
          rotary.  It can be either a hostname or an Internet address
          in dot notation.  The _l_o_c_a_t_i_o_n can be supplemented with an
          auxiliary TCP port number separated from the Annex
          identifier by a slash (////).  The Annex will respond to


9     Page 1                                         (printed 10/13/98)






     RRRROOOOTTTTAAAARRRRIIIIEEEESSSS((((4444))))                   AAAANNNNNNNNEEEEXXXX                   RRRROOOOTTTTAAAARRRRIIIIEEEESSSS((((4444))))



          requests to connect at this port in addition to responding
          to the well-known TELNET port.  The number must be in the
          range 6000 through 6999.  Finally, the location can also be
          given an auxiliary Internet address (as a hostname or in dot
          notation) separated by a plus sign (++++).  The Annex will
          listen for requests to connect on this auxiliary Internet
          address at the well-known TELNET port and automatically
          connect to the given rotary.

          Additional _p_o_r_t_s@_l_o_c_a_t_i_o_n entries can be given separated by
          a semi-colon (;;;;) to indicate a rotary on another Annex with
          the same name.

          _K_e_y_w_o_r_d_s is a space separated list of optional features.
          Currently supported are:

          ppppssss====vvvviiiissssiiiibbbblllleeee
          ppppssss====iiiinnnnvvvviiiissssiiiibbbblllleeee
               Determines whether the rotary name is displayed by the
               port server when a user is connected to the TELNET port
               of the Annex's primary Internet address.  Rotaries
               without auxiliary Internet addresses or auxiliary TCP
               ports are always visible.  ppppssss====vvvviiiissssiiiibbbblllleeee is the default.

          tttteeeellllnnnneeeetttt
          rrrraaaawwww
          bbbbiiiinnnnaaaarrrryyyy
               Determines the protocol used with the rotary.  rrrraaaawwww
               provides a data stream with no character processing and
               is intended primarily for program access to the rotary.
               tttteeeellllnnnneeeetttt is the default, ti configures tttteeeellllnnnneeeetttt as the
               protocol between the port and the device.  The setting
               pppprrrroooottttooooccccoooollll====bbbbiiiinnnnaaaarrrryyyy configures a binary rotary. The Annex
               negotiates with the host to operate in tttteeeellllnnnneeeetttt bbbbiiiinnnnaaaarrrryyyy
               mode in both directions.

          ddddiiiirrrreeeecccctttt____ccccaaaammmmpppp____oooonnnn====aaaasssskkkk
          ddddiiiirrrreeeecccctttt____ccccaaaammmmpppp____oooonnnn====aaaallllwwwwaaaayyyyssss
          ddddiiiirrrreeeecccctttt____ccccaaaammmmpppp____oooonnnn====nnnneeeevvvveeeerrrr
               Determines how port camp-on is handled for rotaries
               with an auxiliary Internet address or auxiliary TCP
               port.  _C_a_m_p-_o_n is the process of waiting for the next
               free port in the rotary, if all of its ports are busy
               when a connection is attempted.  aaaasssskkkk indicates that the
               user is asked to camp-on.  When aaaallllwwwwaaaayyyyssss is selected, the
               user will get the message indicating camp-on has
               occurred.  If nnnneeeevvvveeeerrrr is used, then the TELNET connection
               will be refused when the rotary is full.
               ddddiiiirrrreeeecccctttt____ccccaaaammmmpppp____oooonnnn====aaaasssskkkk is the default except for raw
               rotaries, in which case nnnneeeevvvveeeerrrr is the default.

          sssseeeelllleeeecccctttt====ffffiiiirrrrsssstttt



     Page 2                                         (printed 10/13/98)






     RRRROOOOTTTTAAAARRRRIIIIEEEESSSS((((4444))))                   AAAANNNNNNNNEEEEXXXX                   RRRROOOOTTTTAAAARRRRIIIIEEEESSSS((((4444))))



          sssseeeelllleeeecccctttt====nnnneeeexxxxtttt
               The keyword sssseeeelllleeeecccctttt==== defines the order in which the
               rotary selects ports. If sssseeeelllleeeecccctttt====ffffiiiirrrrsssstttt,,,, the rotary
               selects the first available port in the _p_o_r_t__s_e_t;
               sssseeeelllleeeecccctttt====nnnneeeexxxxtttt directs the rotary to keep track of the
               last port that was selected, and to start its search
               from that point.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
          #
          # sample rotary for 2400 bps modems on the network
          #
          modem_2400: 1,2,3@63.42; 16,1,4 @ annex01; \
               15@63.42; 12, 1, 4, 5, 6@ annex02
          #
          # "milking"-machine Annex: a non-networked host's serial ports are
          # connected to Annex 63.38 on ports 1-8 and 16.  An auxiliary IP
          # address 63.104 has been setup so that users can TELNET directly
          # to the rotary.
          #
          milker: 1-8,16@63.38+63.104

          HostC: ps=invisible 1,4,6-9@annex01+132.245.6.80

          strip-record: protocol=raw direct_camp_on=always \
          3,8@132.245.6.32/6300

          modems: select=next 1-5@annex02

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          erpcd(1M).
          _A_n_n_e_x _N_e_t_w_o_r_k _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.























     Page 3                                         (printed 10/13/98)



