home *** CD-ROM | disk | FTP | other *** search
/ A Beginner's Guide to the Internet / INTERNET.ISO / text / lists / listserv.how / live.txt < prev    next >
Encoding:
Text File  |  1996-05-06  |  5.4 KB  |  129 lines
  1. #!/bin/sh
  2. HOST=`hostname`
  3. ADDRESS=`egrep "[0-9][     ]+$HOST[     ]*" /etc/hosts | head -1 | awk '{ print $1 }'`
  4. HOSTNAME=`nslookup $ADDRESS | grep Name: | tr -d '\[\]' | awk '{ print $2 }'`
  5. #HOSTNAME=$HOST
  6. cat <<EOF
  7.     How to connect and use the Interactive ListProcessor
  8.     ----------------------------------------------------
  9.  
  10. ListProcessor may be reached for interactive (direct, without using email)
  11. sessions if both this system and your host are on Internet. Live sessions
  12. look a lot like ftp sessions, in the sense that the user may issue all of
  13. the valid requests he would send over email, plus download files from the
  14. archives. The server has also the capability of connecting to remote live UNIX
  15. ListProcessors for requests that refer to remote lists.
  16.  
  17. To be able to connect to an ILP, you will need a program called "ilp"; this
  18. should be available from this site's archives; issue an 'index' request and
  19. 'get' all files from the designated archive.
  20.  
  21. You will need to compile the ilp client before you use it; once compiled, you
  22. may use it as follows:
  23.  
  24.             ilp ${HOSTNAME:-this host's address} [port]
  25.  
  26. All compliant Interactive ListProcessors listen at port 372 for connections
  27. by default, but they may use any other port, in which case you will have
  28. to specify which one. For example, on host cs.bu.edu a sample server is
  29. running for testing purposes; to connect to it you would issue the following
  30. command:
  31.  
  32.             ilp cs.bu.edu 8000
  33.  
  34. Log in with email address 'test' and password 'new-user' to obtain subscriber
  35. privileges (more on this later). Notice that you may also specify an I.P.
  36. address instead of the DNS name of the host. If using domain names, you
  37. probably have to be running a name server on your local network.
  38.  
  39. Once a connection is established, you will be asked for an email address and a
  40. password; these will be used to establish the privileges (valid set of requests)
  41. upon login. A mismatch or no email address reduces these privileges to a
  42. minimum (casual user).
  43.  
  44. Casual users may only issue 'help', 'information', 'recipients' and 'statistics'
  45. for nonprivate lists, 'lists', 'index', 'get', 'view', 'search' and 'release'
  46. requests.
  47.  
  48. Subscriber privileges also include the 'set', 'run', 'unsubscribe', and 'which'
  49. requests.
  50.  
  51. Owners may, in addition, issue all of their administrative requests.
  52.  
  53. To gain subscriber privileges you must be subscribed to at least one list, use
  54. your email address as shown by a 'recipients' request, and provide the password
  55. that you have set before. If you are subscribed to more than one lists, any
  56. password from the ones that you use for each list will do (assuming that your
  57. subscription address is the same for all those lists). However, if you belong to
  58. a private list, you should use the password as set for that list in order to be
  59. able to have access to 'recipients' and 'statistics' listings.
  60.  
  61. To gain owner privileges, please contact this system's manager (you may
  62. get the manager's address via a 'release' request).
  63.  
  64. To end a live session, just type 'quit' or 'exit'. To review your privileges
  65. at any time, type '?' or 'privileges'. Connections are limited to a certain
  66. amount of time; to get the time left on your connection, type 'timeleft'.
  67.  
  68. Requests may be continued on multiple lines by use of '&' followed by a new-line
  69. character. The output of every request (if it is not an error message) may be
  70. redirected to a file by using a '>' followed by a file name.
  71.  
  72. Example:
  73.  
  74. REQUEST> index > index
  75.  
  76. or by using '>>' in which case the output is appended to the file. File transfer
  77. also takes place when you 'get' files from an archive. For example, if you
  78.  
  79. REQUEST> get listproc info
  80.  
  81. the output will be saved under file 'info'. You choose another file name by
  82. redirecting:
  83.  
  84. REQUEST> get listproc info > index
  85.  
  86. The keywords 'binary' and 'ascii' specify the transfer type; the default is
  87. 'binary', i.e. files are transferred as they are; in ascii mode, new-line
  88. characters are translated to carriage-return/line-feed pairs.
  89.  
  90. Input may also be redirected from a file by using '<' followed by a file
  91. name; for example:
  92.  
  93. REQUEST> < batched.requests
  94.  
  95. In this case, each line will be interpeted as a separate request and replies
  96. will be produced. Here is an example batch file:
  97.  
  98. index > index
  99. get listproc info >> index
  100. quit
  101.  
  102. A particularly useful case of input redirection is the 'put' request:
  103.  
  104. REQUEST> put ermis ermis1 welcome < prepared-welcome-file
  105.  
  106. Note that for requests requiring a password, you may replace the password with
  107. a dash (-) since you provided the password at login; this of course works only
  108. if you use the same password for all lists you are subscribed to or own.
  109. Then, the previous request could have been written as:
  110.  
  111. REQUEST> put ermis - welcome < prepared-welcome-file
  112.  
  113. Moreover, the output of requests not redirected may be piped to UNIX command
  114. using the '|' character.  For example:
  115.  
  116. REQUEST> review ermis | more
  117.  
  118. will pipe the output of the 'review' request to the UNIX "more" command. As
  119. another example, to look for a particular subscriber in a list, one may do:
  120.  
  121. REQUEST> review venus | grep -i Name
  122.  
  123. As a last note, requests for remote lists are serviced by contacting the remote
  124. servers, if possible. Live requests are subject to the usual restrictions
  125. (system loads) -- requests that are designated by the manager for batch
  126. processing will be rejected, and you will have to submit your request via email.
  127. EOF
  128. .
  129.