home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 367.lha / netkeys_v2.0 / netkeys.doc.pp / netkeys.doc
Encoding:
Text File  |  1990-05-03  |  8.2 KB  |  172 lines

  1. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *\
  2. * |_o_o|\\ Copyright (c) 1989, 1990 The Software Distillery.              *
  3. * |. o.| ||          All Rights Reserved                                  *
  4. * | .  | ||          Written by Doug Walker                               *
  5. * | o  | ||          The Software Distillery                              *
  6. * |  . |//           405 B3 Gooseneck Drive                               *
  7. * ======             Cary, NC 27513                                       *
  8. *                    BBS:(919)-382-8265                                   *
  9. *                                                                        *
  10. * USENET: ...mcnc!rti!sas!walker     PLINK: dwalker      BIX: djwalker    *
  11. \* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  12.  
  13. NetKeys is Copyright © 1989, 1990 The Software Distillery.
  14. Permission is granted to distribute programs and data in this distribution
  15. provided the following conditions are met:
  16.  
  17.    1.  All files present in the distribution package must be redistributed
  18.        with the package, including this documentation file.  If you 
  19.        distribute on diskette, all files must be on a single diskette.
  20.  
  21.    2.  The distributor may charge a fee to recover distribution costs.
  22.        The fee for diskette distribution should not be more than the cost 
  23.        to obtain the same diskette from Fred Fish or The Software Distillery,
  24.        whichever is greater.  Current charge from The Software Distillery
  25.        is $6 per disk for US and Canadian distribution, $7 elsewhere, including 
  26.        all postage and handling charges.
  27.  
  28.    3.  The distributor agrees to cease distributing the programs and data
  29.        involved if requested to do so by the author or any member of The 
  30.        Software Distillery.
  31.  
  32. ------------------------------DISCLAIMER
  33.  
  34. Neither The Software Distillery nor any of its members will be held liable for 
  35. any damage arising from the failure of this program to perform as described,
  36. or any destruction of other programs or data residing on a system 
  37. attempting to run the program.  While we expect no damaging errors, the 
  38. user of this program uses it at his or her own risk.
  39.  
  40. ------------------------------ACKNOWLEDGEMENTS
  41.  Written in Lattice C V5.05.  Thanks to Matt Dillon for DNET!
  42.  
  43. Contributions to continue development of this and other fine products for the
  44. Amiga may be sent to the Software Distillery at the above address.
  45.  
  46. Other Products produced by the Software Distillery are:
  47.    BLINK      - the Turbo-charged Alink replacement
  48.    HACK       - The Amiga port of the famous UNIX game
  49.    LARN       - Another famous UNIX game
  50.    MEMWATCH   - Protects your machine from random trashes
  51.    MEMLIB     - A library of memory debugging routines
  52.    MAKE       - A software development tool one shouldn't be without
  53.    KERMIT     - The World renown file transfer protocol brought to the Amiga
  54.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  55.    TSIZE      - A short utility for determining directory sizes.
  56.    POPCLI     - A hotkey utility and screen blanker.
  57.    PICKPACKET - A tutorial program for learning about the DOS packet interface
  58.    NET:       - An Amiga-to-Amiga network file system running on either the 
  59.                 parallel or serial ports with no additional hardware.
  60.    FILEHANDLER- An example file system written entirely in C
  61.    
  62.  
  63. All of these are available on our BBS.
  64.  
  65. -----------------------------THE GOOD STUFF
  66.  
  67. NETKEYS solves a problem that I encountered when I bought my Amiga 2000.
  68. Naturally, I kept my A1000 around;  therefore, I became a two-Amiga Amigoid.
  69. Unfortunately, I discovered it was a pain to switch keyboards and mice to
  70. get from one to the other Amiga.  The solution to this is NETKEYS.  NETKEYS
  71. installs itself in the input event chain (AHEAD of Intuition) and, on demand,
  72. intercepts all keystrokes and mouse events and ships them off to the other
  73. machine.  
  74.  
  75. NETKEYS uses Matt Dillon's DNET networking package.  DNET is freely redist-
  76. ributable, available on Fred Fish #294 and on all the major nets.  To use 
  77. NETKEYS effectively, you will have to have the two machines sitting next to 
  78. each other, so you should connect them with a simple null modem cable and use
  79. the following command to start DNET on both machines:
  80.  
  81. RUN DNET -s -X -h0 -Z0 -P0 -m0
  82.  
  83. (If you have the older version 1.x of DNET, just use RUN DNET -s).  DNET will
  84. use the baud rate you have set in preferences.  If you find NETKEYS to be
  85. hanging up or acting strangely, try a lower baud rate;  I find the fastest
  86. I can use is 9600.  After the DNET windows come up on both machines, you 
  87. should be able to type characters into one window and see them in the other.
  88. Select STARTDNET from one of the machines' menus. If the other machines' 
  89. window does not disappear, use the QUITDNET command or the BREAK command to 
  90. get the DNET window back and try it again.  DNET uses the file 
  91. S:DNET.SERVERS to locate server programs; you will need to add a line like
  92.  
  93. 9494   sys:dnet/snetkeys  ram:   ;NETKEYS server
  94.  
  95. in order for DNET to find the NETKEYS server.  Change the path to reflect
  96. the actual path of the server, but don't modify the number 9494.
  97.  
  98. Once DNET has been set up properly, move to the machine whose keyboard
  99. you would like to use.  Type 'NETKEYS'.  NetKeys detaches itself from the
  100. CLI, so there is no need to use RUN or RUNBACK.  Once NetKeys is installed,
  101. hitting Left-Amiga-R will toggle between the two machines.  Also, moving the
  102. mouse cursor off the left edge of your machine will cause it to appear on
  103. the right edge of the remote machine;  and moving it off the right edge of
  104. your screen will cause it to appear on the left edge.
  105.  
  106. If you would like to use a key other than Left-Amiga-R, you can pass a 
  107. parameter of the form '0x##' where ## is the hexadecimal raw key code for the
  108. key to be used.  For example, NETKEYS 0x13 would use Left-Amiga-R, just like
  109. the default; NETKEYS 0x14 would use Left-Amiga-T, and so forth.  You can 
  110. change the key NetKeys uses after invoking it by reinvoking it with different
  111. parameters.
  112.  
  113. If you want to get rid of NETKEYS, just type NETKEYS QUIT.  Other options are
  114. listed below.
  115.  
  116. Have fun! 
  117.  
  118. --Doug
  119.  
  120. ------------------------------SYNTAX GUIDE
  121.  
  122. Parms to NETKEYS are letters;  each stands for a word.  You can type the
  123. entire keyword if you like, but netkeys will only look at the first letter.
  124.  
  125. NETKEYS [0xnn] [F|S] [L|R|W] [Q]
  126.  
  127.    0xnn    -   Use the key with raw hexadecimal key code 0xnn as the hotkey
  128.                to swap displays.
  129.  
  130.    F|S     -   [F]ast (default) or [S]mooth.  When the [F]ast option is 
  131.                active, NETKEYS will combine multiple mouse movement events 
  132.                into one in order to get faster results.  When [S]mooth is 
  133.                selected, it will not do this.  [F]ast is the default.
  134.  
  135.    [L|R|W] -   [L]eft, [R]ight or [W]rap.  If [L]eft is active, the mouse
  136.                cursor will exit from the left edge of the main display and
  137.                appear on the right edge of the slave display.  If [R]ight
  138.                is active, the mouse cursor will exit from the right edge of
  139.                the main display and appear on the left edge of the slave.  If
  140.                [W]rap is active, both sides of the main display will cause
  141.                the cursor to appear on the slave.  [W]rap is the default.
  142.  
  143.    [Q]         [Q]uit.  Terminates a running NETKEYS process.
  144.  
  145. If you enter a NETKEYS command and NETKEYS is already running, the parameters
  146. of the running NETKEYS command are modified.  Thus, you can change from
  147. FAST to SMOOTH on the fly by issuing
  148.  
  149.  NETKEYS FAST   ;  start up NETKEYS in FAST mode
  150.  NETKEYS SMOOTH ;  change to SMOOTH mode
  151.  
  152. Remember that NETKEYS only looks at the first character of your parameters.
  153. Therefore, you have exactly the same effect as the above with
  154.  
  155.  NETKEYS FUTILE ;  first character is 'F' = FAST
  156.  NETKEYS STUPID ;  first character is 'S' = SMOOTH
  157.  
  158. ------------------------------DISTRIBUTION LIST
  159.  
  160. channel.h                   1724
  161. dnet.h                      6639
  162. nkutil.c                    2509
  163. netkeys.h                   4109
  164. snetkeys.c                  5856
  165. netkeys.c                  15146
  166. makefile                     709
  167. netkeys.doc                 8409
  168. snetkeys                    5840
  169. netkeys                     9396
  170. mshow.c                     1595
  171. dnetlib.c                  10399
  172.