ptrrkssn / psmsd

Peter's SMS gateway daemon
BSD 3-Clause "New" or "Revised" License
5 stars 2 forks source link

Peter's SMS gateway

Copyright (c) 2016-2020 Peter Eriksson pen@lysator.liu.se

This is a daemon (and a small command line utility) that, together with a GSM modem, can act as a SMS gateway responding to commands received via SMS. It can also send out notifications to users.

Might be handy as a (limited) out-of-band way to verify system status, initiate system checks or other.

The actions (sent to the gateway via SMS) that commands perform is configured in the "commands.dat" file. Commands received via SMS can be authenticated at three levels - anyone, known phone numbers or password-protected - in the config file "users.dat".

The command line utility (psmsc) is used to send SMS notifications to users.

BUGS

Only handles ASCII and ISO8859-1 (Latin1). No support for UTF-8 currently.

INSTALLATION

Edit the 'Makefile' to suit your system. Build using 'make'. Copy the built binaries 'psmsd' and 'psmsc' to suitable directories of your choosing. Copy the sample 'commands.dat' and 'users.dat' config files to some other directory.

USAGE

psmsd [] -h Display this information -V Print version and exit -C Path to commands definition file -U Path to users definition file -T Set autologout timeout -d[] Set debug level -v[] Set verbosity level -t Enable TTY reader -p SIM card PIN code -F Path to fifo -D Path to door

psmsc [] [ [.. ]] -h Display this information -V Print version and exit -m Mail mode -d Debug mode -D Path to door file (default: /etc/psmsd/door) -F Path to fifo file (default: /etc/psmsd/fifo)