NEWSRDR NEWSRDR is an NNTP client program for VMS systems running CMU-Tek TCP/IP, TGV MultiNet, DEC's VMS/ULTRIX Connection, or any TCP/IP package supporting a Berkeley socket interface. NNTP is the Network News Transfer Protocol, which is used to communicate USENET news over TCP/IP. Since many systems cannot afford the disk space to store all net news locally, this program can be used to communicate with a cooperating news server system to read and post net news. News articles are fetched on an as-needed basis and are stored on the client system only while they are being read. NEWSRDR is not a port of UNIX-based news readers. It is written strictly for VMS and provides an interface that VMS users should find reasonably comfortable. Most of the commands in NEWSRDR should be familiar to VMS MAIL users. NEWSRDR is written entirely in C. NEWSRDR can be used with any TCP/IP package that supports a Berkeley socket library interface, or with any package supported by the provided NETLIB network interface library. NEWSRDR requires VAX/VMS V5.0 or later, or OpenVMS Alpha AXP V1.0 or later. Support for Japanese sites using Kanji in news articles is provided through the use of an installable library of character conversion routines which can be mapped in at run-time by NEWSRDR. C source is provided for the Kanji character code conversion routines. Support for username and mail address conversion routines is also provided, also through the use of shareable libraries. Refer to the NEWSRDR documentation for specific system and user requirements. Files included in NEWSRDR.ZIP: ------------------------------ AAAREADME.DOC This file. AAAREADME.TOO More info on NEWSRDR. ADDRESS_CONVERSION.C C source code to mail address conversion routines. BOOKREADER_SETUP.TXT Explanation of how to use the Bookreader-format docs. KANJI_CONVERSION.ALPHA_OBJ AXP object code for Kanji character conversion routin es. KANJI_CONVERSION.C C source code to Kanji character conversion routines. KANJI_CONVERSION.OBJ VAX object code for Kanji character conversion routines. LIBRARY.DECW$BOOKSHELF Bookreader LIBRARY file describing NEWSRDR docs. LINK.COM Command procedure for creating the NEWSRDR executable. NAME_CONVERSION.C C source for sample username/mailname mapping routines. NETLIBxxx.A Saveset A of NETLIB installation kit. NETLIBxxx.B Saveset B of NETLIB installation kit. NEWSRDR.DECW$BOOKSHELF Bookreader bookshelf file for NEWSRDR on-line documents. NEWSRDR.ALPHA_OLB The NEWSRDR object library (AXP). NEWSRDR.OLB The NEWSRDR object library (VAX). NEWSRDR_DOC.DECW$BOOK Bookreader version of NEWSRDR user guide. NEWSRDR_DOC.PS PostScript version of NEWSRDR user guide. NEWSRDR_DOC.TXT Plain-ASCII version of NEWSRDR user guide. NEWSRDR_HELP.HLB NEWSRDR help library. NEWSRDR_DOC.DECW$BOOK Bookreader version of NEWSRDR installation guide. NEWSRDR_INST.PS PostScript version of NEWSRDR installation guide. NEWSRDR_INST.TXT Plain-ASCII version of NEWSRDR installation guide. NEWSRDR_LOGIN.COM Sample login command procedure for NEWSRDR users. NEWSRDR_STARTUP.COM Sample startup command procedure for NEWSRDR. SERVER_NETLIB.ALPHA_OBJ Server interface module for use with NETLIB (AXP). SERVER_NETLIB.OBJ Server interface module for use with NETLIB (VAX). SERVER_SOCKET.ALPHA_OBJ Server interface for use with a socket library (AXP). SERVER_SOCKET.C C source to socket-based server interface module. SERVER_SOCKET.OBJ Server interface for use with a socket library (VAX). SERVER_SOCKET_TCPWARE.OBJ Socket interface for use with PSC's TCPware (VAX). Files included in NEWSRDR_SRC.ZIP: ---------------------------------- ADDRESS_CONVERSION.C C source code to mail address conversion routines. ARTICLE.C C source for article-processing routines. CMD_DIRECTORY.C C source for DIRECTORY commands. CMD_MISC.C C source for miscellaneous commands. CMD_POST.C C source for POST/REPLY commands. CMD_PRINT.C C source for PRINT commands. CMD_READ.C C source for READ and related commands. CMD_SETSHO.C C source for SET and SHOW commands. DESCRIP.MMS MMS description file for building NEWSRDR. FILEIO.C C source for RMS interface. GLOBALS.H C header file with global variable references. GROUPS.C C source for the group tree management routines. KANJI_CONVERSION.C C source code to Kanji character conversion routines. MAIL.C C source for VMS MAIL-interface routines. MAKE_ZIP.C Program to assist in building these ZIP files. MAKE_ZIP.CLD CLD for MAKE_ZIP. MAKE_ZIP.OPT Linker options file for MAKE_ZIP. MEM.C C source for memory management routines. MISC.C C source for miscellaneous routines. NAME_CONVERSION.C C source for sample username/mailname mapping routines. NETLIB_SRC.BCK BACKUP saveset containing NETLIB source code (in BLISS). NEWSRC.C C source for routines that deal with newsrc files. NEWSRDR.C C source for NEWSRDR main module. NEWSRDR.H C header file used by all NEWSRDR source modules. PAGER.C C source for SMG interface routines. PARSE_TABLES.MAR MACRO source for parse tables used with LIB$TPARSE. PARSE822_TABLES.MAR Some more MACRO parse tables. PARSE822.C C source for an RFC822 address parsing routine. PARSING.C C source for various parsing routines. PROFILE.C C source for NEWSRDR profile-processing routines. CMD_TABLE.CLD Command Language Definition for commands in NEWSRDR. NEWSRDR_CLD.CLD Command Language Definition for NEWSRDR command. NEWSRDR_DOC.SDML VAX Document source for NEWSRDR user guide. NEWSRDR_HELP.RNH RUNOFF file for generating NEWSRDR help library. NEWSRDR_INST.SDML VAX Document source for NEWSRDR installation guide. NEWS_MSG.H C header file with message codes used by NEWSRDR. NEWS_MSG.MSG Message code definitions used by NEWSRDR. SERVER_NETLIB.C C source to NETLIB-based server interface module. SERVER_SOCKET.C C source to socket-based server interface module. TPADEF.H C header file with definitions for use with LIB$TPARSE. -------------------------------------------------------------------------------- CONTACTING THE AUTHOR Comments, suggestions, and questions about this software can be directed to the author at one of the following addresses: Mail: Matthew Madison TGV, Inc. 603 Mission Street Santa Cruz, CA 95060 Phone: +1 408 427 4366 Fax: +1 408 427 4365 E-Mail: madison@tgv.com COPYRIGHT NOTICE This software is COPYRIGHT ) 1992, 1993 MATTHEW D. MADISON. ALL RIGHTS RESERVE D. Permission is granted for not-for-profit redistribution, provided all source and object code remain unchanged from the original distribution, and that all copyright notices remain intact. DISCLAIMER This software is provided "AS IS". The author and TGV, Inc. make no representations or warranties with repsect to the software and specifically disclaim any implied warranties of merchantability or fitness for any particular purpose.