linuxsms

Langue: en

Version: 16 Feb 2002 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

Sommaire

NAME

linuxsms - Perl script to send SMS messages to GSM phones.

SYNOPSIS

linuxsms [options]...

DESCRIPTION

linuxsms is a script in Perl to send SMS messages through quite a few servers, mostly to spanish GSM phones, but also to international GSM phones using the servers that allow such a feature. It supports text compression, several command line syntaxes, addressbook, ...

OPTIONS

The options for linuxsms depend on the commandline being used which is specified on the configuration file ~/.linuxsms/linuxsmsrc as CMDLINE=0|1 for old|new command line syntax. New syntax does not require the -server:, -name:|-number: and -sms: to be used for specifying server, phone and message, so they are not available on that commandline mode.

-h
Shows help text on available options on current commandline mode.
-server
Show available servers and info on their status, if registration is needed and has or has not been made.
-server:server
Select server to use for sending a message.
-addressbook
List all entries in addressbook.
-name:name
Find in addressbook using name, the number of the phone to send the SMS to.
-number:number
Number of phone to send the SMS to.
-sms:"msg"
Text (SMS) to send to the chosen phone. If it is not set, it is read from stdin.
-login:username
Use this username to login into the server.
-password:password
Use this password to login into the server.
-update
Check for new version.
-debug
Dump debug info to STDERR.
-flash
Send a flash SMS if the server supports that. This type of SMS messages is automatically opened, doesn't go into the inbox but pops up in the phone without having to do anything. It doesn't seem to have a sender phone like normal SMS have.
-sig
Adds the configured signature at the end of the SMS.
-confirm
Receive confirmation from server for the status of SMS.
-credits
A little hack for getting credits into everyday server.
-z
Compress the SMS using the internal dictionary.

CONFIGURATION FILE

linuxsms default settings can be changed in the linuxsms configuration file ~/.linuxsms/linuxsmsrc an example with default values is created when linuxsms is run if the file doesn't exist. Then you can edit it and set whatever values you prefer. The example is well commented, so you shouldn't have any problem with that.

There is also:

~/.linuxsms/addressbook which is used to alias numbers by asigning names to them, the format is an entry by line, an entry being defined as: name:prefix:number:default_server where the name is case sensitive. An optional server at end sets the default server for this entry.

~/.linuxsms/password which is used to store data for servers where authentication is needed, the format is server:LoginName:password and it is case sensitive.

~/.linuxsms/dict which is used to store data for dictionary when compress option is selected, the format is word_to_search:word_to_replace and it is not case sensitive.

~/.linuxsms/log which is used to store logs of all sms sent if logging option was setted.

These three are also generated if they are not found each time linuxsms is run.

EXAMPLES with old commandline (CMDLINE=0)

linuxsms -name:alex -server:everyday -sms:"this is the msg"
Example using the addressbook (name alex).
linuxsms -prefix:34 -number:649111222 -server:everyday -sms:'Hi!'
Example using a number and prefix (34 - 649111222).
echo "this is the msg"|linuxsms -prefix:34 -number:649111222
Same one but giving the message on stdin and using the default server defined on the configuration file.

EXAMPLES with new (default) commandline (CMDLINE=1)

linuxsms alex everyday "this is the msg"
Example using the addressbook (name alex).
linuxsms 34 649111222 everyday "this is the msg"
Example using a number and prefix (34 - 649111222).
echo "this is the msg"|linuxsms 34 649111222
Same one but giving the message on stdin and using the default server defined on the configuration file.

FILES

~/.linuxsms/*

SEE ALSO

The doc at /usr/local/doc/linuxsms directory.