|
|
| |
smssend(1) |
FreeBSD General Commands Manual |
smssend(1) |
smssend - The sms sender (to GSM)
smssend [options] provider [provider-arguments]
-- [SkyUtils-options]
Smssend is an application that can send an SMS (a short message, refering
to the Short Message Service) to any GSM, connecting to internet sites using
scripts.
- -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
connection.
- -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 connection.
- -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 representing 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.
- -p<proxy>:<port>
- Smssend supports the use of a proxy (http proxy). If the http_proxy
environment variable is set, Smssend will automatically 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
connections (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.
- 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 separated 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"
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"
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.)
Copyright (c) 2020'11 - Chris Hutchinson Copyright (c) 2000'05 - Christophe
"Ze KiLleR" Calmejane
Distributed under GNU General Public License v2; see COPYING file
for more informations.
Christophe "Ze KiLleR" Calmejane Chris Hutchinson
Visit the GSP FreeBSD Man Page Interface. Output converted with ManDoc. |