.TH SMS2MAILGW 1 "Project SMSLink" "Les Ateliers du Heron" \" -*- nroff -*-.SH NAMEsms2mailgw \- SMS to mail gateway module.SH SYNOPSIS.B sms2mailgw.SH DESCRIPTION.B sms2mailgwis a daemon program that will process the mailbox file created by.B sms_serv(1) and extract from it the messages that comply with a specified format.Those messages will then be converted to an email-compatible format andhanded over to an SMTP-compliant MTA (typically.B sendmail(1)) for delivery. The.B sms2mailgwdaemon will automatically synchronize its mailbox-checking interval withthe interval used by the.B sms_servserver module..PPThis manual pagewill cover the functionalities and use of.BR sms2mailgw .For installation and configuration instructions, please refer to the INSTALL document, provided in the sources directory..SS OPTIONS.TPNone at the present time..SH SMS MESSAGE FORMATIn order for an incoming SMS to be recognized as an email candidate by the.B sms2mailgwmodule, it has to comply to the following format:.I T: name[, name] [C: name[, name]] [B: name[, name]] [R: name] [F: name] [S: text#]bodyPlease note that field headers are.B notcase-sensitive, and can come in any order, except for the T: field that hasto come first, and the S: field that has to come last before the messagebody. Multiple identical field headers are allowed. When a field canbe multi-part, multiple identical fields are just added to each other. Whensuch fields cannot be multi-part, the last occurance only will be used..PPAlso please note that the blank character between the ':' and the first letterof the field contents is optional. Optional as well is the blank following acomma in multi-part fields. But the blank separating the end of a fieldcontents from the next field header is mandatory..SS FIELDS AND FIELD CONTENTS.TP.I "T: (To: field)"Required. Has to be the first field (an SMS is not considered a candidateemail message if it doesn't begin with "T:"). Multi-part allowed (multiplenames are separated by commas). Names are expanded as explained below (see.I name)..TP.I "C: (Cc: field)"Optional. Multi-part allowed (multiple names are separated by commas).Names are expanded as explained below (see.I name)..TP.I "B: (Bcc: field)"Optional. Multi-part allowed (multiple names are separated by commas).Names are expanded as explained below (see.I name)..TP.I "R: (Reply-To: field)"Optional. No multi-part support (any additional name entry after a commais just dropped). When multiple "R:" fields are present, only the lastone is used.Names are expanded as explained below (see.I name)..brUse the Reply-To: field to make sure the destination user can send a replyto a regular mailbox instead of directing it back at the SMS gateway..TP.I "F: (From: field)"Optional. No multi-part support (any additional name entry after a commais just dropped). When multiple "F:" fields are present, only the lastone is used.Names are expanded as explained below (see.I name)..brWhen not provided by the user, the From: field is automatically filledwith a default value (the username assigned to the gateway module concatenatedwith the origin GSM number, followed by the hostname the gateway runs onand the domain). This will be used to allow for replies to be routed backto the sending GSM..TP.I "S: (Subject: field)"Optional. The field has to be terminated by a '#' character, to separate itfrom the body. The Subject field has to be the last one before the messagebody..brWhen not provided by the user, a default Subject: field is used, along thelines of.I An SMS for you from <source GSM number>..TP.I "body"The message body..TP.I "name"Any email address. Some shortcuts are allowed. If your network infrastructuresupports delivering mail to addresses such as, for instance"first_last@your.domain", and if the gateway host is member of your.domain,then all addresses specified without any '@' character in them willautomatically get expanded as "address@your.domain". The domain the gatewayhost is working for can be overridden at compile-time..brPlease note that short and fully qualified version of email addresses canbe mixed in fields that allow multi-part contents..TP.I "text"A text field (for the subject, for instance). As this kind of field can containwhitespaces, please use the '#' character to mark its end..SH FILES.PP.B /var/spool/smslink/inbox.brFile where the incoming messages will be stored. The file format detailsare explained in the server module man page. See.B sms_serv(1)..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 sms2mailgwto synchronize its runs with the server module's checks..SH BUGSQuite a few of them maybe, but still less bugs than lacking features at thisstage.See the BUGS document, in the sources directory..SH SEE ALSO.BR sms_serv "(1), " sendsms "(1), " gsmdevices "(5), " gsmaccess "(5)".PPThe INSTALL, TODO and README documents in the sources tree..SH COPYRIGHTSMSLink is (c) Les Ateliers du Heron, 1998-2000 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.