.TH SMS_SERV 1 "Project SMSLink" "Les Ateliers du Heron" \" -*- nroff -*-.SH NAMEsms_serv \- SMS gateway server module.SH SYNOPSIS.B sms_serv.SH DESCRIPTION.B sms_servimplements a client / server gateway to the SMS protocol, and relieson the use of dedicated hardware (a GSM voice modem module). It allows client programs, connecting through TCP sockets, to send SMSmessages to mobile phones. A future extension will also permitreceiving SMS messages and storing them in a text file..PPThis manual pagewill cover the functionalities and use of.BR sms_serv .For installation and configuration instructions, please refer to the INSTALL document, provided in the sources directory..SS OPTIONS.TPNone at the present time..SH COMMAND LANGUAGEWhen telnetting to the port the server is listening on (TCP port .B 6701by default), the user is greeted by a few lines of announce and a prompt. It is possible from there to send SMS messages interactively.Those are the commands recognized by the interpreter..SS COMMANDS.TP.I "he |  help [command]"When used without parameters, this command displays a list of allavailable commands. When used with a parameter, it displays a shorthelp text if the parameter is a word of the language..TP.I "clear [item]"Clears the requested item (or reverts it back to its default value whenthere is one)..B itemcan be one of:.br\- user: sender identification (user name) for logging purposes.br\- smsc: SMS Message Center (see your provider or use default value).br\- dest: destination GSM Network Address (i.e. phone number).br\- message | msg: message text to be sent to destination.sp 1When used without parameter, this commands clears all items..TP.I "set item = value"Sets the requested item to the specified value..B itemcan be one of:.br\- user: sender identification (user name) for logging purposes.br\- smsc: SMS Message Center (see your provider or use default value).br\- dest: destination GSM Network Address (i.e. phone number).br\- message | msg: message text to be sent to destination.sp 1.BR user ", " dest " and " messageare required and have no default value..B smscis optional and defaults to whatever value is set by the administratorin the.B /etc/gsmdevicesfile..sp 1.BR user " and " messagevalues have to be quoted..BR dest " and " smscitems expect a phone number as value. Phone numbers can be quoted but don'thave to be. In addition to numbers, they can contain a "+" (international callsymbol) and any of the following separation characters: [/.\-]. Those separationcharacters are purely cosmetics and will be stripped off before being sent tothe GSM module for transmission..sp 1.B messagevalue can be maximum 160 characters long (surrounding quotes not included).Longer messages will be truncated to the first 160 characters, and the user willbe warned about it..sp 1Maximum length for.B useris 12 characters..TP.I "send"When all parameters are filled in as required, use this command to sendthe SMS message. The user will have to wait during the time it takes tosend the message, and all commands sent to the module and their responseswill be echoed, so the user is immediately aware of any problem and of itsnature. An acknowledgment will be returned when done, including the message ID given to this job by the GSM module (cyclic counter, from 0 to 255)..TP.I "exit | quit | bye"Closes the connection and leaves the program..TP.I "sh | show [item]"Displays the current setting for the specified.BR item ,where.B itemis one of:.br\- user: sender identification (user name) for logging purposes.br\- smsc: SMS Message Center (see your provider or use default value).br\- dest: destination GSM Network Address (i.e. phone number).br\- message | msg: message text to be sent to destination (and its length).sp 1When used without parameter,.B showdisplays the current settings for all parameters..TP.I "dl | devicelist"Lists registered GSM devices. Those are configured through the.B /etc/gsmdevicesfile. The fields provided in the output are the following:.br\- Device: Unix device name.br\- CallerID: the GSM network address (its phone number).br\- Def SCA: default Service Center Address (or SMSC).br\- Provider: Network Provider name.sp 1A first column, titled.BR L ,holds the current lock status of the device..TP.I "ut | uptime"Displays the server uptime in days, hours, minutes and seconds..TP.I "acl | aclist"Lists all the ACL entries successfully loaded from the configuration file(see.B gsmaccess(5)). Since the order of the entries is used to grant or reject access,this order is preserved in the listing. Usefull for debugging configurationissues..SH FILES.B /etc/gsmdevices.brContains the configuration parameters for each GSM device instance..PP.B /etc/gsmaccess.brDefines IP-based access rules to the service (ACL)..PP.B /var/spool/smslink/inbox.brFile where the incoming messages will be stored. The file format is plaintext with Comma Separated Values (CSV) to make it easily parsable by anyexternal application (such as.B sms2mailgw(1)). The records are separated by the newline character.The fields are as follows:.br\- GSM device: The full Unix device name of the GSM module that receivedthe message. In case your server is configured with multiple GSM instances,this allows an external application to discriminate between instances whenneeded..br\- Message ID: The ID assigned by the SIM to the message. Incrementssequentially from 0 to 255, then reverts back to 0..br\- Sender number: The sender's network address (GSM dialing number)..br\- Date: The date the message was sent..br\- Time: The time the message was sent..br\- Message text: The message text. It will always be quoted to protectspecial characters such as field separators (commas) in the text..PP.B /var/spool/smslink/checkpoint.brEmpty file "touched" by the server module (in order to alter its timestamp)after a mailbox check. The timestamp info of this file is used by.B sms2mailgw(1) to synchronize its runs with the server module's checks..SH BUGSQuite a few of them, but still less bugs than lacking features at thisstage.See the BUGS document, in the sources directory..SH SEE ALSO.BR sendsms "(1), " sms2mailgw "(1), " gsmdevices "(5), " gsmaccess "(5)".PPThe INSTALL, TODO 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.