'-f' flag is working now.
[mdsms.git] / mdsms.1.in
index 44d3088..debcbe6 100644 (file)
@@ -3,6 +3,15 @@
 .\~ $Id$
 .\~
 .\~ $Log$
+.\~ Revision 1.4  1999/07/03 18:56:49  short
+.\~ Documentation fixes.
+.\~
+.\~ Revision 1.3  1999/06/03 11:46:41  short
+.\~ Logging (--log) implemented.
+.\~
+.\~ Revision 1.2  1999/06/03 10:38:52  short
+.\~ Implemented remaining communication timeouts and maximum retry count.
+.\~
 .\~ Revision 1.1.1.1  1999/05/26 13:06:26  short
 .\~ First alpha release.
 .\~
@@ -14,11 +23,14 @@ mdsms \- send SMSes through MobilDock
 .B mdsms
 .RB [ "-c <cfgfile>" ]
 .RB [ "-d <device>" ]
+.RB [ "-L <file>" ]
 .RB [ "-l <lockfile>" ]
 .RB [ "-s <smsc #>" ]
+.RB [ "-m <#>" ]
+.RB [ "-r <sec>" ]
 .RB [ "-t <msec>" ]
 .RB [ "-T <msec>" ]
-.RB [ "\-vhV" ]
+.RB [ "\-fvhV" ]
 .RB [ "<dest. phone>" ]
 .RB [ "<msg text>" ]
 
@@ -39,6 +51,13 @@ subsequently with
 .BR -l | --lockfile
 option, see below.
 .TP
+.BR -L | --log\  < file >
+Log all important messages to this file preceded by timestamp, machine hostname
+etc., similar to output of
+.BR syslogd (8).
+If set to empty string (which is default - ~\fB        DEF_LOGNAME     \fP~), nothing
+is logged anywhere.
+.TP
 .BR -l | --lockfile\  < lockfile >
 Prior to accessing serial device specified above the lockfile should be
 acquired for correct concurrent processes behaviour. Although this name
@@ -64,6 +83,31 @@ Known SMS centers as of May 1999:
 .BR "CZ EuroTel " ( "230 02" "): " +420602909909
 .RE
 .TP
+.BR -m | --maxretry\  < # >
+Maximum retries of any \fBAT\fP-style command during the session. All the
+retries are summed during one run of
+.B mdsms
+and no more retries of the command are permitted. After exceeding this
+value the program is terminated.
+.TP
+.BR -r | --readtime\  < sec >
+Maximum response read timeout before give up.
+.B mdsms
+sends the requested \fBAT\fP-style command to
+.B MobilDock
+and expects response. Unfortunately when the voice call is in progress,
+.B MobilDock
+will block any serial device communication and it is impossible to differentiate
+between calling
+.B MobilDock
+and stucked/disconnected one. After exceeding this time interval,
+.B mdsms
+is terminated immediately,
+.B maxretry
+parameter notwithstanding. Standard value is
+.BR DEF_READTIME
+seconds and should be enough for any voice call.
+.TP
 .BR -t | --chartime\  < msec >
 Although the fixed used baudrate of
 .B 19200
@@ -88,6 +132,11 @@ and to satisfy these requirements this delay was considered as the best
 approach. The default value is
 .BR DEF_CMDTIME ms.
 .TP
+.BR -f | --file
+When parameter <\fBmsg text\fP> has been specified, by using this option
+\fBmdsms\fP will read the file with the <\fBmsg text\fP> filename instead
+and send its \fBcontents\fP as the SMS message.
+.TP
 .BR -v | --verbose
 Increase verbosity level by one. Currently the maximum defined level is
 .BR 3 ,
@@ -99,7 +148,7 @@ Give short parameters description to
 .I stderr
 (standard error output stream).
 .TP
-.BR -v | --version
+.BR -V | --version
 Print the version number and exit.
 .TP
 .RB < "dest. phone" >