File	Date	Author	Commit
agent	2015-07-11	David Ranch	[0507db] proper fix for install and distcheck
axgetlist	2021-02-02	David Ranch	[8e1dbe] fix GCC 10 compiler issues
axgetmail	2021-02-02	David Ranch	[8e1dbe] fix GCC 10 compiler issues
conf	2014-04-14	Jerry Dunmire	[180da4] Installation fixes
contrib	2021-02-04	David Ranch	[d8f6dd] new version
debian	2021-02-02	David Ranch	[da9132] properly reflect new version for debuild support
m4	2014-07-16	Jerry Dunmire	[397644] Add empty m4/ directory
man1	2021-02-02	David Ranch	[aa7c45] spelling fixes from Debian packaging team
man8	2021-02-02	David Ranch	[aa7c45] spelling fixes from Debian packaging team
routes	2014-07-28	Jerry Dunmire	[d8adf6] Eliminated compiler warnings
ulistd	2018-01-02	Martin Cooper	[bfa637] Fix badly broken config parsing
.gitignore	2014-04-14	Jerry Dunmire	[ea4517] Added .gitignore
BUGS	2015-06-20	David Ranch	[dbf262] use right email address for bug reports
COPYING	2014-03-26	Jerry Dunmire	[d8190c] Starting with ax25mail-utils_0.11.orig.tar.gz
ChangeLog	2021-02-04	David Ranch	[40b868] Updated the Changelog based upon recent Git com...
Makefile.am	2015-09-22	David Ranch	[3f1a3b] Add missing packaging and contrib scripts to pu...
NEWS	2015-06-20	David Ranch	[84e62e] prep for a new version
README	2021-02-01	David Ranch	[ef5202] Updated version for next release
ax25mail-utils.lsm	2021-02-01	David Ranch	[ef5202] Updated version for next release
cleanall.sh	2014-03-29	Jerry Dunmire	[cf78b2] added cleanall.sh to delete autoconf files
configure.ac	2021-02-01	David Ranch	[ef5202] Updated version for next release
generate-ChangeLog.sh	2015-08-19	David Ranch	[f22391] Adding CHangelog creation script
mkinstalldirs	2014-03-26	Jerry Dunmire	[d8190c] Starting with ax25mail-utils_0.11.orig.tar.gz

Read Me

ax25mail-utils version 0.15 (stable release)
Copyright (c) 2021 by David Ranch (KI6ZHD)

RELEASE NOTES
~~~~~~~~~~~~~
!WARNING: There are some changes in axgetlist - the command line arguments
have changed and the configuration file format is a bit different!

Since version 0.10 the SSID handling was changed a bit - the callsign of the
BBS is always written without the SSID (or the SSID is ignored) unless it
specifies the path for connecting the BBS.

Since version 0.07 axgetmail DOESN'T SUPPORT the AX.25 callsign associations
configured using axparms utility because of their side effects. Instead of
this feature a file /etc/ax25/logins was added for specifying users'
callsigns.


Package requirements
~~~~~~~~~~~~~~~~~~~~
- ax25-tools and applications installed
- perl 5 installed


Installation
~~~~~~~~~~~~
First run the commands:

    autoreconf --install
    ./configure

to create the Makefile.

For compile type:

     make

and for install then type

     make install

You can also install the example configuration files using

     make installconf

(this will replace existing configuration files, if any)


Quick Configuration
~~~~~~~~~~~~~~~~~~~
1. Edit the file /etc/ax25/ulistd.conf to specify the BBS to communicate
   with.

2. If you want to read the message lists by connecting to the BBS, edit the
   file /etc/ax25/axgetlist.conf.

3. Edit the file /etc/ax25/axgetmail.conf to specify the bulletins for
   download for each BBS.

4. Edit the file /etc/ax25/logins and add the callsigns of users you want
   to download messages for.

5. [Optional]
   For each BBS create the file /etc/ax25/bulletins.<BBS_callsign> to
   specify the message lifetimes - see the example file 
   /etc/ax25/bulletins.OK0PAB

6. If you want to use ulistd add the command

     ulistd -c <your_callsign> -lg

   to your startup script.

Remember: for ulistd usage you must have the unproto listing enabled on your
BBS. Consult this with the BBS sysop.