home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume14 / 3bconnect / README < prev    next >
Text File  |  1988-05-08  |  4KB  |  125 lines
  1. AT&T 3B2 Ethernet Connection and File Transfer Utility
  2.  
  3. This package allows you to login to other 3B2 computers connected via 3Bnet, 
  4. in a similar fashion to 'cu', and also to transfer files across the ethernet.
  5.  
  6. CONNECT
  7.  
  8. 'Connect' provides a simple connection to a shell on the remote machine, linked
  9. to your terminal via pipes. Initially, YOUR terminal will be doing the echoing
  10. (in contrast to 'cu'), with lines shipped across the ethernet only when you
  11. hit RETURN.
  12.  
  13. You can force the connection into 'raw' mode (each character shipped as typed,
  14. remote end doing the echoing) by sending a QUIT signal. This allows you to
  15. use screen editors on the remote machine.
  16. A further QUIT signal gets you back into 'cooked' mode - this is indicated by
  17. '[cooked]' appearing on your terminal. Unfortunately, this means that you
  18. can't send QUIT signals to processes which you start on the remote host.
  19. Sorry about this. Interrupts get processed OK, though.
  20.  
  21. You close the connection by typing ^D at your terminal (in cooked mode) -
  22. if you want to send ^D to the remote end, you MUST be in 'raw' mode.
  23.  
  24. The big problem is that your remote shell has stdin, stdout, and stderr 
  25. connected to PIPES, rather than a real tty, which can cause certain commands
  26. (e.g. stty) to fail.
  27.  
  28. PC-INTERFACE.
  29. If you have PC-INTERFACE installed, then you can connect to one of the 
  30. pseudo-tty devices provided by the driver, by using the '-l' option of 'connect'
  31. This gets you a remote shell connected to a 'real' tty device, and 
  32. automatically puts you in 'raw' mode.
  33.  
  34. You close this type of connection by sending a QUIT signal.
  35.  
  36.  
  37. RCP
  38. 'rcp' provides a simple, but effective, method of transferring files across
  39. the network. The syntax resembles 'uucp'.
  40.  
  41.  
  42.  
  43. WHAT YOU NEED TO DO TO INSTALL IT.
  44.  
  45. a) Find out the ethernet addresses of all machines on the network.
  46.     Use 'nitable', or the program 'mynode' provided.
  47.     
  48. b) Set up a map file '/usr/lib/ethernet.addr' which maps the names of
  49. your hosts to the rightmost 2 digits of their ethernet address. 
  50. These should be unique - if not, change the value of LSB in 'ni.h' 
  51. to use any pair of digits which are unique for your network.
  52.  
  53.  
  54. E.g. 
  55. oscar    80.00.10.30.18.f2        
  56. olive   80.00.10.30.0b.45
  57.  
  58. /usr/lib/ethernet.addr:
  59.  
  60.         oscar    f2
  61.         olive    45
  62.  
  63.  
  64. c) Set up an inittab entry to run the server.
  65.  
  66. e.g. (assuming server is '/usr/lib/server')
  67.  
  68.     et:2:respawn:/usr/lib/server
  69.     
  70. It's important that this line is properly defined! 
  71. DO NOT DEFINE ANY INPUT OR OUTPUT FILES FOR THIS PROCESS.
  72.  
  73.  
  74. d) Make sure that you have enough 'port' structures allocated in the NI driver.
  75.    You can do this through the 'packagemgmt/3bnet/nidriver" option in 'sysadm'
  76.     I have 20 ports, 1 buffer per port, 1514 buffer size - this allows
  77.     me at least 5 concurrent 'connects' (I've not tried more)
  78.    You have to reboot for the reconfig to become effective.
  79.    
  80. e) Find out your value of NPROC, from the file /etc/master.d/KERNEL
  81.    Define this value in 'ni.h'
  82.     
  83.  
  84. f) To connect, say 'connect <host>'
  85.  
  86. e.g.
  87.     connect olive
  88.     
  89.  
  90.  
  91. BUGS
  92.  
  93. TTY:
  94. You're not connected to a tty at the remote end, so certain commands aren't
  95. going to work. Screen editors will work, but only if you use them when you're
  96. in 'raw' mode.
  97.  
  98. EOT:
  99. There's no way to send EOT to a remote process. Typing ^D on your terminal will
  100. close the connection. However, when you do a close, all your remote processes
  101. get sent a hangup signal, which usually amounts to the same thing.
  102.  
  103. ETHERNET ADDRESS:
  104. The ethernet addresses which are used by this package are NOT guaranteed to
  105. be unique, and may interfere with other ethernet applications. (3Bnet and
  106. PC-Interface seem to be OK, though).
  107.  
  108. If you get conflicts with other packages, you might have to change the values
  109. in server[] and client[] in 'ni.h' ([1] and [2])
  110.  
  111. They are currently set to 0x02 0x02 - this is totally arbitrary,
  112. so feel free to change it as you wish.
  113. The rest of the bytes in server[] and client[] will be OK.
  114.  
  115. REMOTE SHELL TERMINATION:
  116. If the remote shell dies, for any reason, you won't be informed until you 
  117. attempt to send it some input.
  118.  
  119. ADDING FEATURES.
  120. If you put any fancy bits in, please let me know!
  121.  
  122. Good luck!
  123.  
  124. Dave Settle, dave@smb.co.uk
  125.