home *** CD-ROM | disk | FTP | other *** search
/ A Beginner's Guide to the Internet / INTERNET.ISO / text / lists / using / using.lst
Encoding:
File List  |  1996-05-06  |  15.6 KB  |  283 lines

  1.          Revised LISTSERV System Reference Library, release 1.7f
  2.          -------------------------------------------------------
  3.          (c) Eric Thomas 1986,1987,1988,1989,1990,1991,1992,1993
  4.  
  5.       ************************************************************
  6.       *                                                          *
  7.       * LISTSERV command reference cards:                        *
  8.       *                                                          *
  9.       *-> LISTSERV REFCARD: General user commands                *
  10.       *   LISTOWNR REFCARD: List and file management commands    *
  11.       *   LISTMAST REFCARD: Commands for the LISTSERV maintainer *
  12.       *                                                          *
  13.       ************************************************************
  14.  
  15. Commands are listed in alphabetical order, with the minimum acceptable
  16. abbreviation in capital letters. Angle brackets are used to indicate
  17. optional parameters. All commands which return a file accept an optional
  18. 'F=fformat' keyword (without the quotes) that lets you select the format
  19. in which you want the file sent; the default format is normally
  20. appropriate in all cases. Some esoteric, historical or seldom-used
  21. commands and options have been omitted.
  22.  
  23. List subscription commands (from most to least important)
  24. ---------------------------------------------------------
  25. SUBscribe    listname <full_name>        Subscribe to a list, or change
  26.                                          your name if already subscribed
  27.  
  28. SIGNOFF                                  Remove yourself:
  29.              listname                    - From the specified list
  30.              *                           - From all lists on that server
  31.              * (NETWIDE                  - From all lists in the network
  32.  
  33. SET          listname options            Alter your subscription options:
  34.              ACK/NOACK/MSGack            -> Acknowledgements for postings
  35.              CONCEAL/NOCONCEAL           -> Hide yourself from REVIEW
  36.              Files/NOFiles               -> Toggle receipt of non-mail
  37.                                             files from the list
  38.              Mail/NOMail                 -> Toggle receipt of mail
  39.              DIGests/INDex               -> Ask for digests or message
  40.                                             indexes rather than getting
  41.                                             messages as they are posted
  42.              REPro/NOREPro               -> Copy of your own postings?
  43.              TOPICS: ALL                 -> Select topics you are
  44.                      <+/->topicname         subscribed to (add/remove
  45.                                             one or replace entire list)
  46.  
  47. Options for mail headers of incoming postings (choose one):
  48.              FULLhdr or FULLBsmtp        -> "Full" mail headers
  49.              IETFhdr                     -> Internet-style headers
  50.              SHORThdr or SHORTBsmtp      -> Short (default) headers
  51.              DUALhdr                     -> Dual headers, useful with PC
  52.                                             or Mac mail programs
  53.  
  54. CONFIRM      listname1 <listname2 <...>> Confirm your subscription
  55.                                          (when LISTSERV requests it)
  56.  
  57. Other list-related commands
  58. ---------------------------
  59. INDex        listname                    Sends a directory of available
  60.                                          archive files for the list, if
  61.                                          postings are archived
  62.  
  63. Lists        <option>                    Send a list of lists as follow:
  64.              (no option)                 -> Local lists only, one line
  65.                                             per list
  66.              Detailed                    -> Local lists, full information
  67.                                             returned in a file
  68.              Global                      -> All known lists, one line per
  69.                                             list, sent as a (large!) file
  70.              Global /xyz                 -> Only those whose name or
  71.                                             title contains 'xyz'
  72.              SUMmary <node>              -> Membership summary for all
  73.                                             lists on specified node
  74.              SUMmary ALL                 -> For all nodes (long output,
  75.                                             send request via mail!)
  76.              SUMmary TOTAL               -> Just the total for all nodes
  77.  
  78. Query        listname                    Query your subscription options
  79.                                          for a particular list (use the
  80.                                          SET command to change them)
  81.              *                           -> Query all lists you are
  82.                                             subscribed to on that server
  83.  
  84. REGister     full_name                   Tell your name to LISTSERV, so
  85.                                          that you don't have to specify
  86.                                          it on subsequent SUBSCRIBE's
  87.              OFF                         Make LISTSERV forget your name
  88.  
  89. REView       listname <(options>         Get information about a list
  90.              BY sort_field               -> Sort list in a certain order:
  91.                 Country                     by country of origin
  92.                 Name                        by name (last, then first)
  93.                 NODEid                      by nodeid
  94.                 Userid                      by userid
  95.              BY (field1 field2)          -> You can specify more than one
  96.                                             sort field if enclosed in
  97.                                             parentheses: BY (NODE NAME)
  98.              Countries                   -> Synonym of BY COUNTRY
  99.              LOCal                       -> Don't forward request to
  100.                                             peers
  101.              Msg                         -> Send reply via interactive
  102.                                             messages (BITNET users only)
  103.              NOHeader                    -> Don't send list header
  104.              Short                       -> Don't list subscribers
  105.  
  106. STats        listname <(options>         Get statistics about a list
  107.              LOCal                       -> Don't forward to peers
  108.  
  109. Informational commands
  110. ----------------------
  111. Help                                     Obtain a list of commands
  112.  
  113. Info         <topic>                     Order a LISTSERV manual, or get
  114.                                          a list of available ones (if no
  115.                                          topic was specified)
  116.  
  117. Query     File fn ft <filelist> <(options>  Get date/time of last update of
  118.                                             a file, and GET/PUT file access
  119.                                             code
  120.           FLags                             -> Get additional technical
  121.                                                data (useful when reporting
  122.                                                problems to experts)
  123.  
  124. RELEASE                                     Find out who maintains the
  125.                                             server and the version of the
  126.                                             software and network data files
  127.  
  128. SHOW      <function>                        Display information as follows:
  129.           ALIAS node1 <node2 <...>>         -> BITNET nodeid to Internet
  130.                                                hostname mapping
  131.           BITEARN                           -> Statistics about the BITEARN
  132.                                                NODES file
  133.           DISTribute                        -> Statistics about DISTRIBUTE
  134.           DPATHs node1 <node2 <...>>        -> DISTRIBUTE path from that
  135.                                                server to specified node(s)
  136.           DPATHs *                          -> Full DISTRIBUTE path tree
  137.           FIXes                             -> List of fixes installed on
  138.                                                that server
  139.           LINKs node1 <node2 <...>>         -> Network links at the BITNET
  140.                                                node(s) in question
  141.           NADs node1 <node2 <...>>          -> Addresses LISTSERV
  142.                                           recognizes as node administrators
  143.           NETwork                           -> Statistics about the network
  144.           NODEntry node1 <node2 <...>>      -> BITEARN NODES entry for the
  145.                                                specified node(s)
  146.           NODEntry node1 /abc*/xyz          -> Just the ':xyz.' tag and all
  147.                                                tags whose name starts with
  148.                                                'abc'
  149.           PATHs snode node1 <node2 <...>>   -> BITNET path between 'snode'
  150.                                                and the specified node(s)
  151.           STATs                             -> Usage statistics
  152.                                                (default option)
  153.           (no function)                     -> Same as SHOW STATS
  154.  
  155. Commands related to file server functions
  156. -----------------------------------------
  157. AFD                                            Automatic File Distribution
  158.              ADD    fn ft <filelist <prolog>>  Add file or generic entry to
  159.                                                your AFD list
  160.              DELete fn ft <filelist>        Delete file(s) from your AFD
  161.                                             list (wildcards are supported)
  162.              List                           Displays your AFD list
  163.  
  164.              For node administrators:
  165.              FOR user ADD/DEL/LIST etc      Perform requested function on
  166.                                             behalf of a user you have
  167.                                             control over (wildcards are
  168.                                             supported for DEL and LIST)
  169.  
  170. FUI                                         File Update Information: same
  171.                                             syntax as AFD, except that FUI
  172.                                             ADD accepts no 'prolog text'
  173.  
  174. GET          fn ft <filelist> <(options>    Order the specified file or
  175.                                             package
  176.              PROLOGtext xxxx               -> Specify a 'prolog text' to be
  177.                                               inserted on top of the file
  178.  
  179. GIVE         fn ft <filelist> <TO> user     Sends a file to someone else
  180.  
  181. INDex       <filelist>                      Same as GET xxxx FILELIST
  182.                                             (default is LISTSERV FILELIST)
  183.  
  184. PW           function                       Define/change a "personal
  185.                                             password" for protecting
  186. AFD/FUI
  187.                                             subcriptions, authenticating
  188. PUT
  189.                                             commands, and so on
  190.              ADD firstpw                    -> Define a password for the
  191.                                                first time
  192.              CHange newpw PW=oldpw          -> Change password
  193.              DELete oldpw                   -> Delete password
  194.  
  195. SENDme                                      Same as GET
  196.  
  197. Other (advanced) commands
  198. -------------------------
  199. DATAbase     function                       Access LISTSERV database:
  200.              Search DD=ddname <ECHO=NO>     -> Perform database search
  201.                                                (see INFO DATABASE for more
  202.                                                 information on this)
  203.              List                           -> Get a list of databases
  204.                                                available from that server
  205.              REFRESH dbname                 -> Refresh database index, if
  206.                                                suitably privileged
  207.  
  208. DBase                                       Same as DATABASE
  209.  
  210. DISTribute   <type> <source> <dest> <options>  Distribute a file or a mail
  211.                                             message to a list of users (see
  212.                                             INFO DIST for more details on
  213.                                             the syntax)
  214.              Type:
  215.              MAIL                           -> Data is a mail message, and
  216.                                                recipients are defined
  217.                                                by '<dest>'
  218.              FILE                           -> Data is not mail, recipients
  219.                                                are defined by '<dest>'
  220.              RFC822                         -> Data is mail and recipients
  221.                                                are defined by the RFC822
  222.                                                'To:'/'cc:' fields
  223.              Source:
  224.              DD=ddname                      -> Name of DDname holding the
  225.                                                data to distribute (default:
  226.                                                'DD=DATA')
  227.              Dest:
  228.              <TO> user1 <user2 <...>>       -> List of recipients
  229.              <TO> DD=ddname                 -> One recipient per line
  230.              Options for the general user:
  231.              ACK=NOne/MAIL/MSG             -> Acknowledgement level
  232.                                               (default: ACK=NONE)
  233.              CANON=YES                     -> 'TO' list in 'canonical' form
  234.                                               (uid1 node1 uid2 node2...)
  235.              DEBUG=YES                      -> Do not actually perform the
  236.                                                distribution; returns debug
  237.                                                path information
  238.              INFORM=MAIL                   -> Send file delivery message to
  239.                                                recipients via mail
  240.              TRACE=YES                      -> Same as DEBUG=YES, but file
  241.                                                is actually distributed
  242.              Options requiring privileges:
  243.              FROM=user                      -> File originator
  244.              FROM=DD=ddname                 -> One line: 'address name'
  245.  
  246. FOR          user command                   Execute a command on behalf of
  247.                                             another user (for node
  248.                                             administrators)
  249.  
  250. SERVE        user                           Restore service to a disabled
  251.                                             user
  252.  
  253. THANKs                                      Check the server is alive
  254.  
  255. UDD                                         Access the User Directory
  256.                                             Database (there are 18
  257. functions
  258.                                             and many sub-functions, so the
  259.                                             syntax is not given here)
  260.  
  261. Syntax of parameters
  262. --------------------
  263. filelist  = 1 to 8 characters from the following set: A-Z 0-9 $#@+-_:
  264. fformat   = Netdata, Card, Disk, Punch, LPunch, UUencode, XXencode,
  265. VMSdump,
  266.             MIME/text, MIME/Appl, Mail
  267. fn        = same syntax as 'filelist'
  268. ft        = same syntax as 'filelist'
  269. full_name = firstname <middle_initial> surname (*not* your e-mail address)
  270. listname  = name of an existing list
  271. node      = BITNET nodeid or Internet hostname of a BITNET machine which
  272.             has taken care of supplying a ':internet.' tag in its BITEARN
  273.             NODES entry
  274. pw        = 1 to 8 characters from the set: A-Z 0-9 $#@_-?!|%
  275. user      = Any valid RFC822 network address not longer than 80 characters;
  276. if
  277.             omitted, the 'hostname' part defaults to that of the command
  278.             originator
  279.  
  280.  
  281.  
  282. .
  283.