Short: NNTP/SMTP/POP tools for THOR 2.01 Type: comm/mail Author: Kjell Irgens/Petter Nilsen (thor@hstud6.cs.uit.no) Uploader: Petter Nilsen (pettern@powertech.no) Replaces: ThorTCPBeta3.lha ------------------==================================------------------ 950725 ThorTCP Beta 4 Requires AmigaDOS 2.04 (V37) and THOR 2.01 previously installed. Copyright © 1995 Ultima Thule Software, All Rights Reserved. Authors: Kjell Irgens & Petter Nilsen (thor@hstud6.cs.uit.no) ------------------==================================------------------ Disclaimer ~~~~~~~~~~ We have made every effort possible to ensure that this software will function as described, but no warranty of any kind, expressed or implied, is made by us. We will not be liable for any direct or indirect damages to either machinal equipment or mental health arising from a failure of the program to operate in the manner desired by the user. In no event will we be liable for any loss of profits or savings. About ThorTCP Beta 4 ~~~~~~~~~~~~~~~~~~~~ These software tools provide an easy way receive and send news/mail using a TCP/IP connection (like AmiTCP, AS225, MLink, etc). Tools are provided that should satisfy both shell and GUI users. NOTE: All the executables are compiles for AS225. To use them with AmiTCP, you will need to install the socket.library emulation library that is included with Grapevine or can be found on Aminet in comm/net as socketlib10a.lha. GetTCP is used for getting mail and news, while SendTCP is used for sending mail and news that you have written, joining and resigning newsgroups, etc. ConnectTHOR is used for integrating these programs into a single program. It also contain a nice news browser what will let you select a newsgroup and download only the articles you want be selecting them from a list with dragselection. GetTCP and SendTCP can both be started from shell with arguments that will override the configuration settings. If you want, you can run these automatically from eg. a startnet script. NOTE: These programs are "work in progress" and not all features we would like to add is present at this time. However, we feel that the programs are so stable and work so well that they should satisfy most THOR users. Installation ~~~~~~~~~~~~ - Double-click on the supplied icon for the installation script, and the installation of the various programs should be quite straightforward. - Enter Systems Config in THOR and create (or change an already existing system) with Type set to TCP. Configure you email address in the "Userinfo" window. As "Mail packet", you can enter your username, and if you have mailpackets in your download dir, they will be parsed. Otherwise, this is not used by the TCP module itself. - Click on the "Type Options" gadget, a window containing various options will come up. This window contains the following options: -> Mail Server This is the server that will be used when sending and receiving mail. Typing in the name or IP address of your pophost will do. -> Username This is the username, the name you log on to you account with. By setting the checkbox "Get from Systems Config", this login name will be resolved from your email address configured in THOR. -> Password This is an optional password. By setting the "Ask every time" option, you will be prompted for the password before collecting mail. This is the best solution for security reasons. -> POP Port If your pop server is on some other port than the default 110, set this to the correct port. 110 is default. -> Delete mail from POP server By setting this option, the collected mail will be deleted from your mail (pop) host after it's been successfully received by your Amiga. This is recommended, or you will most likely get duplicate mail every time you collect mail. -> Newsserver Enter the name or IP address of the newsserver (NNTP server) you will use to get news from. -> Max days This is the maximum number of days for news collection. By using this option, you can restrict the age of the news you want to receive. If you collect news regulary, this option can normally be disabled by selection the "Don't use" option. Use it when you come home from a 30 days holiday :) -> Date By using this slider, you can set the exact date and time for news collection. This date and time will be used when getting news, so that you will receive all news on the newsserver newer than this date and time. The "set" gadget must be used for these settings to take effect. -> Edit Headers This option will let you edit custom header fields to be used when posting news or mail from THOR. Fields can include "Reply-To:
", "Organization: Not organized", etc. If THOR is running when you select this option, the editor configured in THOR will be used. Otherwise, a name of an editor to use will must be entered in the requester that comes up. -> Delete Header Will delete the custom header file for this system. Use this with caution since there is no way to get it back once it's delete (except for using DiskSalv or somesuch :) -> Save Save the configuration. If you start this program from ConnectTHOR, ConnectTHOR will update its internal variables to reflect on the configuration saved. -> Cancel Cancel the changes and quit the CfgTCP program. ----------------------- - When you have configured the various options described above, you must use the "join" option from the events menu or the dock window in THOR to select which conferences to collect news from. This is required even if you received several groups previously with UUCP or SOUP. - You must send the events to actually subscribe to the groups from the newsserver. See below for a description. ConnectTHOR ~~~~~~~~~~~ This is the GUI based program that can be used for those who like to have a nice and easy to use GUI for controlling the process or getting and sending news/mail. ConnectTHOR will integrade the shell programs GetTCP and SendTCP, and even provides for a separate news browser. The following options is available in ConnectTHOR: -> Do All Will send off any events you might have pending, collect mail and then news, all in one process. -> Get Mail Will get only mail from the configured POP3 server (the mailserver) by calling the separate GetTCP program with the NONEWS option. -> Get News Will get only news from the configured news server by calling the separate GetTCP program with the NOMAIL option. -> Send Events Will send off any mail and news you have written by calling the separate SendTCP program. If you do not use the "Do All" function, this function must be used when you have joined or resigned newsgroups in THOR. Be selecting "Get Conf.list" in THOR, you can have a complete list of newsgroups sent to you. This list will be used when joining groups in THOR. -> Config TCP Configuration of mail and news options. See above for a detailed description. -> Browse News ******* Missing description ************** -------------- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! NOTE !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! - DO NOT READ MESSAGES WHILE COLLECTING MAIL AND NEWS DUE TO A BUG IN THE BUFFER HANDLING IN BBSREAD.LIBRARY. THIS WILL BE FIXED IN BETA 5. - Beta 4 requires the included utgui.library upgrade. If you have problems getting them to work, reboot (or make sure the old utgui.library is flushed out of memory), then try again. - You must join all newsgroups you want news in from within THOR. Then you must start SendTCP (or select Send Events from within ConnectTHOR) while online. This also applies to any conference you might have received news in when using UUCP/SOUP/InetUtils. - The first time you use GetTCP (or select Get News from ConnectTHOR), only news from the last 24 hours are collected (this can be overridden by setting the date on CfgTCP (or Config TCP from ConnectTHOR). If you receive duplicates this first time, run Delete Dups from within THOR. - Parameters supplied in tooltypes or as command line parameters will override configuration settings. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! History ~~~~~~~ Beta 2: ------- - ConnectTHOR would leave the ghosting on several gadgets after selecting to send events, get news or get mail. Fixed. - ConnectTHOR will not allow you to open several NewsBrowse windows anymore. - Fixed an mismatched Permit() in GetTCP that could cause problems. Beta 3: ------- ConnectTHOR: - The newsbrowser will work on non-INN newsservers too now, but only message number and subject will be viewable. This should handle most, if not all newsserver software out there. - Will use the "Delete mail" configuration option properly now and not delete mail from the pophost if it isn't configured to do so. - A hotlist will be updated automatically when getting headers from group in the newsbrowser. This hotlist will be saved to disk when quitting, and will also contain the highest message number from the last time you collected news, so you can start from that number the next time. GetTCP: - Would not behave correctly with commas (,) in the to-field. - Handing Forbid() fixed. This caused all of the problems when GetTCP was quitting. - Will automatically split the type of digest used on eg. the AMosaic list. - base64 MIME encoded binaries are handled correctly again. Text will be shown in the listview, while binaries will be put on disk in the decoded/ dir. - Command line template fixed. SendTCP: - Should work on all mailservers now. CfgTCP: - Max Days will be handled correctly when loading the config again. Beta 4: ------- ConnectTHOR: - Fixed the problem with ConnectTHOR asking for a password upon startup even though the password had been configured already. - Fixed the DELETE switch problem once and for all (hopefully). - MAXDAYS wasn't working correctly, should be fixed now. - Configured POPPORT will be used. - Configured background window picture will be used. - Error messages should be displayed properly. - Fixed a reference to freed memory when closing the newsbrowse window. CfgTCP: - Fixed a crash when quitting when Mungwall was running (used freed memory). - Configured background window picture will be used. - POP port can be configured to something else than 110, if needed. GetTCP: - "failure when adding message"-bug fixed. This one also gave an Enforcer hit. - Should work better with all kinds of pop hosts. - Will get the time from the newsserver so local clock will not be used (this was actually done in beta 3, but left out of the history file :). - POP Port can be set on the command line, if started from shell. - Will exit when password has been entered wrong (when run from shell). SendTCP: - Fixed a bug that could make it stop on some SMTP servers. -------- PS: Please report any problems to thor@hstud6.cs.uit.no (THOR team) The authors can also reached the following ways: Kjell Irgens: email: kjelli@stud.cs.uit.no IRC #amiga: Trooper1 Petter Nilsen: email: pettern@powertech.no IRC #amiga: Mitchman