NAME
sms_client - send messages to mobiles and pagers.
SYNOPSIS
sms_client [-v]
sms_client [-d]
sms_client [-q] [-l loglevel]
[service:]number|name[,[service:]number|name]
[message] ...
DESCRIPTION
A simple client implementation for the GSM Short Message Service (SMS)
using TAP. Allowing you to send messages to mobile phones and pagers.
Several drivers have also been written for providers who use protocols
other than TAP.
This client dials the Short Message Service centre and passes on your
message addressed to the number or name you specified. Any name you use
is expanded to the number from either the Local or Global resource
files. The Local file is searched first then the Global file. A user
can set up his own preferences to overide those set in the Global file.
Information regarding the status of the call is displayed, along with
the response given by the SMS centre as the message is transmitted.
If no message is present, sms_client takes the message from standard
input.
OPTIONS
-q Quiet mode, no output.
-l All messages output are appended to /var/log/smsclient.log,
there are several level of loggin. The default loglevel is
STANDARD other loggin levels provided include.
1 - ERROR
2 - WARNING
3 - STANDARD
4 - VERBOSE
5 - EXTREMELY VERBOSE
-v Print version information.
-d Print all driver/protocols currently built into sms_client.
[service:]number|name[,[service:]number|name]
A name can be used instead of a number, if a name is used it is
searched for in the Global and Local resource files and replaced
by the number. You can group names and numbers but they must be
seperated by a comma and must contain no whitespace. Numbers
must be in International format. For UK Numbers remove leading 0
and add 44 prefix. If a number is prefixed with service: then
that service is used in preference to the default service.
[message]...
A Quoted message that you want to send. If this is absent the
message is read from stdin. The maximum length of the message is
currently set to a limit of 150 characters, if your message
exceeds this length you will be notified with an error message.
RETURN VALUES
On Success the return value is set to zero. Any other value indicates
an error occurred.
Each number dialed will have a corresponding output of the form:
[###]SERVICE:NUMBER
Where ### is the delivery code, 000 indicates successful delivery other
values can be found in sms_error.h
EXAMPLES
sms_client 123456 Hello 123456
Use default service and send message to 123456
sms_client mike Hello mike
Use default service and send message to number associated with
name mike found in one of the resource files.
sms_client mike,angelo Hello mike and angelo
Use default service and send message to number associated with
names mike and angelo found in one of the resource files.
FILES
/etc/smsclient/sms_addressbook
The Global addressbook file. Containing names and numbers.
~/.sms_addressbook
The Local addressbook file. Contains names and numbers which can
override those in the Global resource file.
/etc/smsclient/sms_config
Containing default service and other sms_client defaults.
/etc/smsclient/sms_services
Containing service to protocol mappings.
/etc/smsclient/sms_modem
Containing default modem settings.
/etc/smsclient/services
Directory containing all services - Each service is denoted by
filename (in UPPERCASE) and contains defaults for that service,
such as telephone number of service centre, comms params etc.
/var/lock/smslock
Lockfile generated when smsclient is running.
/var/log/smslog
Log file where all messages that are produced are copied.
AUTHOR
Angelo Masci <angelo@styx.demon.co.uk>
changed by Michael Holzt <kju@debian.org> for the Debian/GNU Linux
Package
VERSION
2.0.7