.TH SENDSMS 1 "Project SMSLink" "Les Ateliers du Heron" \" -*- nroff -*-.SH NAMEsendsms \- a command-line client for sms_serv(1).SH SYNOPSIS.B sendsms\-d dest (\-m message | \-f msgfile) [\-u user] [\-s smsc] host.SH DESCRIPTION.B sendsmsis the Unix command-line client for the.B SMSLinkproject. It accepts command-line parameters that define the message tobe sent, and transmits them to the SMS server process running on the designated.BR host ..B sendsmswas developped specifically for easy calling from shell scripts or similarsituations..PPThis manual pagewill cover the functionalities and use of.BR sendsms .For installation and configuration instructions, please refer to the INSTALL document, provided in the sources directory..SS OPTIONS.TP.I "\-d dest"The GSM network address (i.e. phone number) of the mobile phone the messageis to be sent to. Supported format is: .br[int. prefix \- country code] area code \- phone number.sp 1The international prefix can be either "+" or "00" (or any other valuesupported by the GSM network provider the server is subscribed to). Someseparation characters can be used to beautify the number, but they arepurely cosmetic and will be stripped by the server. Those charactersare [./- ]. The pause character (',') is not supported. This parameter is required..sp 1Regarding the international country code, don't forget that its necessityis to be considered respective to the SMS gateway location (the host thisclient program is connecting to), not the location where the client is runfrom. In case of doubt, please contact the SMS server administrator for yournetwork..sp 1Please always include the area code (even when sending to a destination inthe same "area", i.e. on the same network). The number without the area code,though syntactically correct and accepted by the network, would never getdelivered (at least, that's my experience with Proximus -- YMMV)..TP.I "\-m message"The text of the message to be sent. Unless made up of a single word, it willhave to be quoted for obvious reasons. Maximum length is 160 characters. Alonger message will be truncated (the user will be warned about it), but themessage will still be sent..sp 1At the present time, only 7bit ASCII is supported for the message text..sp 1Use one and only one of.B \-mor.BR \-f ..TP.I "\-f msgfile"The name of a text file where the message to send is to be read from. This filecan contain multiple lines of text (they will be concatenated), but its totallength can't exceed 160 characters. A longer text will be truncated (the userwill be warned about it), but the message will still be sent..sp 1The special file '-' means that input will be read from stdin..sp 1At the present time, only 7bit ASCII is supported for the message text..sp 1Use one and only one of.B \-mor.BR \-f ..TP.I "\-u user"The server module requires the user to identify himself for logging purposes.No authentication is performed on this info though. If this parameter isommited,.B sendsmswill send the Unix username of the current user. This parameter allows you tooverride this default behaviour (might be usefull in the case of automatedsending). The parameter is optional..TP.I "\-s smsc"This optional parameter allows you to override the default Service Centerstored in the GSM module SIM. This feature is probably usefull only fornon-standard applications..TP.I hostThe host name or IP address where the SMS gateway server process is running.By default, this server will be listening on TCP port 6701..SH BUGSSee the BUGS document, in the sources directory..SH SEE ALSO.BR sms_serv "(1), " gsmdevices "(5), " gsmaccess "(5)".PPThe INSTALL and README documents in the sources tree..SH COPYRIGHTSMSLink is (c) Les Ateliers du Heron, 1998 by Philippe Andersson<philippe_andersson@ste.scitex.com>. It has been originally written forScitex Europe, S.A..PPPart of the code is (c) Riccardo Facchetti..PPThe code also includes contributions from Philipp Klaus <pklaus@access.ch>..PPSMSLink has been released to the public under the GNU GPL.