--- name: "smssend" section: "1" platform: "linux" package: "smssend" version: "3.4-2" release: "Debian 3.1 (Sarge)" platforms: ["linux"] url: "https://new.carta.tech/smssend" --- # smssend(1) The sms sender (to GSM) ## 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, refering 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 connection. ### 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 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. ### SkyUtils Options - \-p\:\ **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\:\ Use this option to specify a *Username* and *Password* to use when connecting to the proxy given with the -p option. - \-t\ Use this option to specify a *timeout* value (in sec) for the connections (default=60sec). - \-d\ Use this option to set a *DebugLevel* value (from 0 to 5) for both skyutils and smssend. - \-h\ 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/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" ``` ## 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 \ -update**.) ## SEE ALSO [**smssend.scripting**(1)](/smssend.scripting/1.md) ## COPYRIGHTS Copyright (c) 2000'03 - Christophe "Ze KiLleR" Calmejane \ Distributed under GNU General Public License v2; see COPYING file for more informations. ## AUTHORS Christophe "Ze KiLleR" Calmejane \