KSMS  - KDE Short Message Service
=================================

(please read the html documentation within the package)

KSMS is (or should become) a frontend program for the pager software yaps.
This combination allows you to send pager messages using an analog modem
or ISDN interface connected to a linux box somewhere in your lan.
yaps was command line driven, but with minor changes it could run as a
server.

If you want to send messages to a pager or a mobile, there are other
solutions available. The most well known are email or web gateways, but
either the service is not provided for free or it has certain limitations
(it does not allow you to send multiple messages,...).
Another solution is an internal email gateway. This is possible if you install
the wmm perl package which is also based on yaps(iX 3/98, Wartala www.heise.de)

Running the server version of yaps on a lan, your W*ND*WS clients may also
telnet (yes, M$ supplies it) to yaps and deliver their messages. Perhaps a
client for M$-OS will be added later ?

As the project started it was first called KPager, but unfortunately this
name was already used by a desktop pager, so it is called KSMS.


Installation
============

For full documentation of possible install procedures read the 'INSTALL'
file.

A quick install:

KSMS - the client
  -  ./configure
  -  make install


yaps - the server
  - get the source code of yaps (latest version 0.96)
  - apply the patch
     * copy the patch file to the yaps source directory
     * patch -p1 < yaps.c-0.96.patch	
  - compile/install according to README of the yaps package	

As a result you get a binary yaps and a configuration file
yaps.rc. On my system yaps runs as bin/uucp (user/group).
Check that yaps is working as a single program started from
the shell.

(! ISDN worked well, but it took me a while to find out that
 the analog modem has to be fixed to V.22bis 2400/1200)

Now edit your /etc/inetd.conf

Add a line:

8090   stream tcp nowait root /usr/sbin/tcpd /usr/local/bin/yaps

perhaps the path to tcpd or yaps has to be adjusted. The port number
8090 is arbitrary and may be changed, but only choose an unused port
number and set the port number of KSMS to the same value. (ksmsrc)
You may also edit the /etc/services and add a  "yaps   8090/tcp" row at
the end of the file and enter

yaps   stream tcp nowait root /usr/sbin/tcpd /usr/local/bin/yaps

in /etc/inetd.conf which gives the same result.

And don't forget to:
kill -HUP <id of inetd>


Now test yaps as a server:
==========================

telnet localhost 8090

you should get a response message telling you the yaps version.
Now enter a pager number followed by a space and the message.
Hit the enter key twice, this should trigger your modem or ISDN interface
to dial the modem gateway of your telco provider.

Now you'r ready for KSMS to run...

##############################################################################
# !!! If you install yaps on a lan, make sure that only allowed persons  !!! #
# !!! have access to this server. It should not be accessable from       !!! #
# !!! outside (the internet). Don't call me because of your telco bill.  !!! #
##############################################################################

olaf
(oloesken@t-online.de)




