home *** CD-ROM | disk | FTP | other *** search
/ A Beginner's Guide to the Internet / INTERNET.ISO / text / email / listserv / listserv.ref < prev   
Encoding:
Text File  |  1996-05-06  |  14.9 KB  |  257 lines

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