smssend man page on DragonFly

smssend man page on DragonFly

Man page or keyword search:
man Server 44335 pages
apropos Keyword Search (all sections)
Output format

smssend(1) smssend(1)

NAME
smssend - The sms sender (to GSM)

SYNOPSYS
smssend [options] provider [provider-arguments]
-- [SkyUtils-options]

DESCRIPTION
Smssend is an application that can send an SMS (a short message, refer‐
ing to the Short Message Service) to any GSM, connecting to internet
sites using scripts.

Options
-q Does not display anything when running smssend.

-h or --help
Prints a short description and usage message.

-v or --version
Prints version number, then exits.

-update
Searches for a new version of smssend. Requires an internet con‐
nection.

Provider Arguments
-help Must be the first provider argument, if used. Prints needed
arguments, their type and description for the specified
provider.

-update
Must be the first provider argument, if used. Searches for a new
version of the specified provider. Requires an internet connec‐
tion.

-install
Must be the first provider argument, if used. Searches (and
install) if a script for the specified provider exists. Requires
an internet connection.

- Use - as provider argument if you want this argument to be
prompted from command line (stdin).

"" In each provider, there is at least one message string (quoted).
You can use the escape character \ to insert any ascii code. For
example you can add a CR/LF to the message (to force a CR on the
gsm) with \0A. The escape character always needs 2 numbers rep‐
resenting the ascii code of a character in hexadecimal.

Use -help as first provider argument to see what arguments you
need for the provider you wish to use. You need to give ALL
arguments the provider needs in order to get it to work, but
without the name of the argument. For example, if a provider
lame.sms needs the 2 arguments Tel and Message, you must call :
'smssend lame 123456 "Hi there"' with 123456 as phone number (ie
Tel) and "Hi there" as Message.

SkyUtils Options
-p<proxy>:<port>
Smssend supports the use of a proxy (http proxy). If the
http_proxy environment variable is set, Smssend will automati‐
cally use this variable to get proxy parameters (See Lynx Users
Guide for additional details and examples on how to set this
variable). If you don't want to use this variable, you can use
this option and tell Smssend to use the specified proxy on port.

-u<Username>:<Password>
Use this option to specify a Username and Password to use when
connecting to the proxy given with the -p option.

-t<Timeout>
Use this option to specify a timeout value (in sec) for the con‐
nections (default=60sec).

-d<DebugLevel>
Use this option to set a DebugLevel value (from 0 to 5) for both
skyutils and smssend.

-h<User'sHeaderFile>
Use this option to use a User'sHeaderFile instead of the default
header for all HTTP requests.

FILES
Provider Files
The needed provider files are installed by default to
/usr/local/share/smssend. When invoking smssend with a
provider, the program first looks for the corresponding file in
the current directory, then in ~/.smssend/, and finally in the
shared directory.

Aliases File
When invoking SmsSend with arguments, you have the possibility
to use aliases (@Alias_name), which are located in the file
~/.smssend/aliases. Each line of this file (except for empty
lines, and lines starting with a '#') must be as following :
'Name Alias' (without the '), where Name and Alias being sepa‐
rated by at least one space.
Example :
smssend totalise.sms @MyCountryCode @Sophie "Hi Sophie"

Profiles File
When invoking SmsSend with arguments, you have the possibility to use profiles (@Profile_name), which
are located in the file ~/.smssend/profiles. Each line of this file (except for empty lines, and lines starting with
a '#') must be as following : 'Name Profile' (without the '), where Name and Profile being separated by at least one space,
and Profile being a space separated list of arguments to be inserted in the command line at the location of the use of the profile.
Example : (One line of the profiles file being 'totalise totalise.sms +33')
smssend %totalise @Sophie "Hi Sophie"

EXAMPLE
Here comes an example on how to use smssend with the script
totalise.sms : This script requires 3 parameters (CountryCode, Tel and
Message). Here is how you must call smssend if you wish to send the
message "hi from smssend" to the french recipient 06123456 : smssend
totalise.sms 33 6123456 "hi from smssend"

BUGS AND NOTES
Well... there MIGHT be bugs in the program. But it is sure that the
provider scripts may not work, or may stop to work if provider's site
changes. In this case, just send an email to the author of the script
(his name at the begining of the script file), telling him which script
doesn't work, and hoping he'll update the script as soon as possible
(then you will be able to get the latest version of the script with the
command smssend <provider> -update.)