summaryrefslogtreecommitdiff
path: root/docs/man
diff options
context:
space:
mode:
authorMichal Čihař <michal@cihar.com>2011-11-07 10:49:55 +0100
committerMichal Čihař <michal@cihar.com>2011-11-07 10:49:55 +0100
commitb0f42d7c65e223a95a7fca8c00986a77695807d2 (patch)
tree14741089ad59bee43bc4a880786ec6710f1fc320 /docs/man
parentd2d555e42d4be030e42ef9d3aa4e39d5ed1a3172 (diff)
Imported Upstream version 1.30.90
Diffstat (limited to 'docs/man')
-rw-r--r--docs/man/gammu-backup.52
-rw-r--r--docs/man/gammu-config.15
-rw-r--r--docs/man/gammu-detect.117
-rw-r--r--docs/man/gammu-smsbackup.530
-rw-r--r--docs/man/gammu-smsd-dbi.78
-rw-r--r--docs/man/gammu-smsd-files.718
-rw-r--r--docs/man/gammu-smsd-inject.15
-rw-r--r--docs/man/gammu-smsd-monitor.18
-rw-r--r--docs/man/gammu-smsd-mysql.74
-rw-r--r--docs/man/gammu-smsd-null.72
-rw-r--r--docs/man/gammu-smsd-odbc.72
-rw-r--r--docs/man/gammu-smsd-pgsql.73
-rw-r--r--docs/man/gammu-smsd-run.716
-rw-r--r--docs/man/gammu-smsd-sql.785
-rw-r--r--docs/man/gammu-smsd-tables.790
-rw-r--r--docs/man/gammu-smsd.117
-rw-r--r--docs/man/gammu-smsdrc.5129
-rw-r--r--docs/man/gammu.1408
-rw-r--r--docs/man/gammurc.550
-rw-r--r--docs/man/jadmaker.15
20 files changed, 78 insertions, 826 deletions
diff --git a/docs/man/gammu-backup.5 b/docs/man/gammu-backup.5
index 46d0ae6..2fb350e 100644
--- a/docs/man/gammu-backup.5
+++ b/docs/man/gammu-backup.5
@@ -1,4 +1,4 @@
-.TH "GAMMU-BACKUP" "5" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-BACKUP" "5" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-backup \- gammu(1) backup file format.
.
diff --git a/docs/man/gammu-config.1 b/docs/man/gammu-config.1
index f282964..c0e5f9b 100644
--- a/docs/man/gammu-config.1
+++ b/docs/man/gammu-config.1
@@ -1,4 +1,4 @@
-.TH "GAMMU-CONFIG" "1" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-CONFIG" "1" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-config \- Gammu configurator
.
@@ -46,19 +46,16 @@ starting with two dashes (\fB\-\fP). A summary of options is included below.
.INDENT 0.0
.TP
.B \-h, \-\-help
-.sp
Show summary of options.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-force
-.sp
Force configuring even if config already exists.
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-config CONFIG
-.sp
Define which configuration file to use.
.UNINDENT
.SH AUTHOR
diff --git a/docs/man/gammu-detect.1 b/docs/man/gammu-detect.1
index e81234d..378395d 100644
--- a/docs/man/gammu-detect.1
+++ b/docs/man/gammu-detect.1
@@ -1,4 +1,4 @@
-.TH "GAMMU-DETECT" "1" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-DETECT" "1" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-detect \- Gammu device detection
.
@@ -43,7 +43,6 @@ gammu\-detect [OPTIONS]
.sp
Script to detect available devices, which might be suitable for \fIgammu\fP.
.IP Note
-.
This program lists all devices, which might be suitable, it does not do
any probing on devices them self.
.RE
@@ -51,61 +50,50 @@ any probing on devices them self.
Currently it supports following devices:
.INDENT 0.0
.IP \(bu 2
-.
USB devices using udev
.IP \(bu 2
-.
Serial ports using udev
.IP \(bu 2
-.
Serial ports on Windows
.IP \(bu 2
-.
Bluetooth devices using Bluez
.UNINDENT
.IP Note
-.
Supported devices depend on platform you are using and compiled in
features. You can find out what is actually compiled in by running
\fI\%gammu-detect -v\fP.
.RE
.sp
This program follows the usual GNU command line syntax, with long options
-starting with two dashes (\fB\-\fP). A summary of options is included below.
+starting with two dashes (\fB\-\-\fP). A summary of options is included below.
.INDENT 0.0
.TP
.B \-h, \-\-help
-.sp
Show summary of options.
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-debug
-.sp
Show debugging output for detecting devices.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-version
-.sp
Show version information and compiled in features.
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-no\-udev
-.sp
Disables scanning of udev.
.UNINDENT
.INDENT 0.0
.TP
.B \-b, \-\-no\-bluez
-.sp
Disables scanning using Bluez.
.UNINDENT
.INDENT 0.0
.TP
.B \-w, \-\-no\-win32\-serial
-.sp
Disables scanning of Windows serial ports.
.UNINDENT
.SH OUTPUT
@@ -114,7 +102,6 @@ The output of \fI\%gammu-detect\fP is configuration file for Gammu (see
\fIgammurc\fP) with configuration section for every device which might be
used with \fIgammu\fP.
.IP Note
-.
You can choose which section to use in \fIgammu\fP by \fIgammu \-s\fP.
.RE
.sp
diff --git a/docs/man/gammu-smsbackup.5 b/docs/man/gammu-smsbackup.5
index 6993430..68f97bb 100644
--- a/docs/man/gammu-smsbackup.5
+++ b/docs/man/gammu-smsbackup.5
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSBACKUP" "5" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSBACKUP" "5" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsbackup \- gammu(1) SMS backup file format.
.
@@ -64,7 +64,6 @@ after the section name:
The text can be split to more lines if it is too long or of original message
included new lines.
.IP Note
-.
This is easiest way to get message text, however also the least reliable
one, because it is stored in the comments in the file.
.RE
@@ -74,108 +73,81 @@ The following variables can be defined for each SMS:
.INDENT 0.0
.TP
.B \fBSMSC\fP
-.sp
Text representation of SMSC number, not used by Gammu if \fBSMSCUnicode\fP
exists.
.TP
.B \fBSMSCUnicode\fP
-.sp
Hex encoded UCS\-2 string with SMSC number.
.TP
.B \fBClass\fP
-.sp
Message class.
.TP
.B \fBSent\fP
-.sp
Timestamp, when message has been sent.
.TP
.B \fBPDU\fP
-.sp
Message type, one of:
.INDENT 7.0
.IP \(bu 2
-.
\fBDeliver\fP \- received message
.IP \(bu 2
-.
\fBSubmit\fP \- message to send
.IP \(bu 2
-.
\fBStatus_Report\fP \- message to send with delivery report
.UNINDENT
.TP
.B \fBDateTime\fP
-.sp
Timestamp of message (sent or received).
.TP
.B \fBRejectDuplicates\fP
-.sp
Whether receiver should reject duplicates.
.TP
.B \fBReplaceMessage\fP
-.sp
ID of message to replace.
.TP
.B \fBMessageReference\fP
-.sp
Message reference number as generated by network.
.TP
.B \fBState\fP
-.sp
State of the message:
.INDENT 7.0
.IP \(bu 2
-.
\fBRead\fP
.IP \(bu 2
-.
\fBUnRead\fP
.IP \(bu 2
-.
\fBSent\fP
.IP \(bu 2
-.
\fBUnSent\fP
.UNINDENT
.TP
.B \fBNumber\fP
-.sp
Recipient number.
.TP
.B \fBName\fP
-.sp
Name of the message.
.TP
.B \fBLength\fP
-.sp
Length of message text.
.TP
.B \fBCoding\fP
-.sp
Coding of the message:
.INDENT 7.0
.IP \(bu 2
-.
\fB8bit\fP \- binary message
.IP \(bu 2
-.
\fBDefault\fP \- GSM encoding, up to 160 chars in message
.IP \(bu 2
-.
\fBUnicode\fP \- Unicode encoding, up to 70 chars in message
.UNINDENT
.TP
.B \fBText00\fP ... \fBTextNN\fP
-.sp
Numbered parts of the message payload.
.TP
.B \fBFolder\fP
-.sp
ID of folder where the message was saved.
.TP
.B \fBUDH\fP
-.sp
User defined header of the message.
.UNINDENT
.SH EXAMPLE
diff --git a/docs/man/gammu-smsd-dbi.7 b/docs/man/gammu-smsd-dbi.7
index 1b0f8de..895a476 100644
--- a/docs/man/gammu-smsd-dbi.7
+++ b/docs/man/gammu-smsd-dbi.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-DBI" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-DBI" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-dbi \- gammu-smsd(1) backend using DBI abstraction layer to use any supported database as a message storage
.
@@ -39,7 +39,6 @@ For tables description see \fIgammu\-smsd\-tables\fP.
.sp
This backend is based on \fIgammu\-smsd\-sql\fP.
.IP Note
-.
The DBI driver is currently not supported on Windows because libdbi
library does not support this platform.
.RE
@@ -49,16 +48,12 @@ For complete list of drivers for \fI\%libdbi\fP see \fI\%libdbi-drivers\fP proje
drivers for example include:
.INDENT 0.0
.IP \(bu 2
-.
\fBsqlite3\fP \- for SQLite 3
.IP \(bu 2
-.
\fBmysql\fP \- for MySQL
.IP \(bu 2
-.
\fBpgsql\fP \- for PostgeSQL
.IP \(bu 2
-.
\fBfreetds\fP \- for MS SQL Server or Sybase
.UNINDENT
.SH EXAMPLE
@@ -218,7 +213,6 @@ CREATE TRIGGER update_sentitems_time UPDATE ON sentitems
.ft P
.fi
.IP Note
-.
You can find the script in \fBdocs/sql/sqlite.sql\fP as well. There are
also scripts for other databases in same folder.
.RE
diff --git a/docs/man/gammu-smsd-files.7 b/docs/man/gammu-smsd-files.7
index 8e65631..280bac5 100644
--- a/docs/man/gammu-smsd-files.7
+++ b/docs/man/gammu-smsd-files.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-FILES" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-FILES" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-files \- gammu-smsd(1) backend using filesystem as a message storage
.
@@ -43,27 +43,21 @@ Explanation of fields:
.INDENT 0.0
.TP
.B \fB<date>\fP
-.sp
date in format \fBYYYYMMDD\fP
.TP
.B \fB<time>\fP
-.sp
time in format \fBHHMMSS\fP
.TP
.B \fB<sender>\fP
-.sp
sender number
.TP
.B \fB<serial>\fP
-.sp
order of a message (in case more messages were received at same time), in format \fBNN\fP
.TP
.B \fB<sequence>\fP
-.sp
part of the message for multipart messages, in format \fBNN\fP
.TP
.B \fB<ext>\fP
-.sp
\fBtxt\fP for text message, 8\-bit messages are stored with \fBbin\fP extension, \fBsmsbackup\fP for \fIgammu\-smsbackup\fP
.UNINDENT
.sp
@@ -75,13 +69,10 @@ Transmitted messages are read from a folder defined by configuration. The
filename should be one of the following formats:
.INDENT 0.0
.IP \(bu 2
-.
\fBOUT<recipient>.<ext>\fP
.IP \(bu 2
-.
\fBOUT<priority>_<recipient>_<serial>.<ext>\fP
.IP \(bu 2
-.
\fBOUT<priority><date>_<time>_<serial>_<recipient>_<note>.<ext>\fP
.UNINDENT
.sp
@@ -89,19 +80,15 @@ Explanation of fields:
.INDENT 0.0
.TP
.B \fB<recipient>\fP
-.sp
recipient number where to send message
.TP
.B \fB<priority>\fP
-.sp
an alphabetic character (A\-Z) A = highest priority
.TP
.B \fB<ext>\fP
-.sp
\fBtxt\fP for normal text SMS, \fBsmsbackup\fP for \fIgammu\-smsbackup\fP
.TP
.B \fB<note>\fP
-.sp
any artibrary text which is ignored
.UNINDENT
.sp
@@ -111,15 +98,12 @@ For text messages, you can additionally append flags to extension:
.INDENT 0.0
.TP
.B \fBd\fP
-.sp
delivery report requested
.TP
.B \fBf\fP
-.sp
flash SMS
.TP
.B \fBb\fP
-.sp
WAP bookmark as name,URL
.UNINDENT
.UNINDENT
diff --git a/docs/man/gammu-smsd-inject.1 b/docs/man/gammu-smsd-inject.1
index c6de2d2..9bed4f3 100644
--- a/docs/man/gammu-smsd-inject.1
+++ b/docs/man/gammu-smsd-inject.1
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-INJECT" "1" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-INJECT" "1" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-inject \- Inject messages into queue of SMS daemon for Gammu
.
@@ -52,19 +52,16 @@ accepted on some platforms):
.INDENT 0.0
.TP
.B \-h, \-\-help
-.sp
Shows help.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-version
-.sp
Shows version information and compiled in features.
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-config=file
-.sp
Configuration file to use, default is /etc/gammu\-smsdrc, on Windows there
is no default and configuration file path has to be always specified.
.UNINDENT
diff --git a/docs/man/gammu-smsd-monitor.1 b/docs/man/gammu-smsd-monitor.1
index d90a34e..48b78a7 100644
--- a/docs/man/gammu-smsd-monitor.1
+++ b/docs/man/gammu-smsd-monitor.1
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-MONITOR" "1" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-MONITOR" "1" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-monitor \- Monitor state of SMS daemon for Gammu
.
@@ -50,38 +50,32 @@ accepted on some platforms):
.INDENT 0.0
.TP
.B \-h, \-\-help
-.sp
Shows help.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-version
-.sp
Shows version information and compiled in features.
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-config=file
-.sp
Configuration file to use, default is /etc/gammu\-smsdrc, on Windows there
is no default and configuration file path has to be always specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-l, \-\-loops=count
-.sp
Number of loops, by default monitor loops infinitely.
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-delay=seconds
-.sp
Delay betwen polling SMSD state, default is 20 seconds.
.UNINDENT
.INDENT 0.0
.TP
.B \-C, \-\-csv
-.sp
Print output in comma separated values format:
.sp
.nf
diff --git a/docs/man/gammu-smsd-mysql.7 b/docs/man/gammu-smsd-mysql.7
index aac28e7..b9bdfc5 100644
--- a/docs/man/gammu-smsd-mysql.7
+++ b/docs/man/gammu-smsd-mysql.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-MYSQL" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-MYSQL" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-mysql \- gammu-smsd(1) backend using MySQL database server as a message storage
.
@@ -51,7 +51,6 @@ GRANT SELECT, INSERT, UPDATE, DELETE ON \(gasmsd\(ga.* TO \(aqsmsd\(aq@\(aqlocal
.ft P
.fi
.IP Note
-.
For creating the SQL tables you need more privileges, especially for
creating triggers, which are used for some functionality.
.RE
@@ -347,7 +346,6 @@ DELIMITER ;
.ft P
.fi
.IP Note
-.
You can find the script in \fBdocs/sql/mysql.sql\fP as well.
.RE
.SH AUTHOR
diff --git a/docs/man/gammu-smsd-null.7 b/docs/man/gammu-smsd-null.7
index dd90088..d626297 100644
--- a/docs/man/gammu-smsd-null.7
+++ b/docs/man/gammu-smsd-null.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-NULL" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-NULL" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-null \- gammu-smsd(1) backend not storing messages
.
diff --git a/docs/man/gammu-smsd-odbc.7 b/docs/man/gammu-smsd-odbc.7
index c24fa9e..9bccec6 100644
--- a/docs/man/gammu-smsd-odbc.7
+++ b/docs/man/gammu-smsd-odbc.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-ODBC" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-ODBC" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-odbc \- gammu-smsd(1) backend using ODBC abstraction layer to use any supported database as a message storage
.
diff --git a/docs/man/gammu-smsd-pgsql.7 b/docs/man/gammu-smsd-pgsql.7
index d4e9e0a..0328c2e 100644
--- a/docs/man/gammu-smsd-pgsql.7
+++ b/docs/man/gammu-smsd-pgsql.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-PGSQL" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-PGSQL" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-pgsql \- gammu-smsd(1) backend using PostgreSQL database server as a message storage
.
@@ -354,7 +354,6 @@ CREATE TRIGGER update_timestamp BEFORE UPDATE ON sentitems FOR EACH ROW EXECUTE
.ft P
.fi
.IP Note
-.
You can find the script in \fBdocs/sql/pgsql.sql\fP as well.
.RE
.SH AUTHOR
diff --git a/docs/man/gammu-smsd-run.7 b/docs/man/gammu-smsd-run.7
index b9cfe40..e8749c1 100644
--- a/docs/man/gammu-smsd-run.7
+++ b/docs/man/gammu-smsd-run.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-RUN" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-RUN" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-run \- documentation for RunOnReceive directive
.
@@ -47,6 +47,10 @@ there, it will make SMSD not receive new messages. However to limit breakage
from this situation, the waiting time is limited to two minutes. After this
time SMSD will continue in normal operation and might execute your script
again.
+.IP Note
+All input and output file descriptors are closed when this program is
+invoked, so you have to ensure to open files on your own.
+.RE
.SH ENVIRONMENT
.sp
program is executed with environment which contains lot of information about
@@ -56,13 +60,11 @@ the message. You can use it together with NULL service (see
.INDENT 0.0
.TP
.B SMS_MESSAGES
-.
Number of physical messages received.
.UNINDENT
.INDENT 0.0
.TP
.B DECODED_PARTS
-.
Number of decoded message parts.
.UNINDENT
.SS Per message variables
@@ -72,19 +74,16 @@ message, where 1 is replaced by current number of message.
.INDENT 0.0
.TP
.B SMS_1_CLASS
-.
Class of message.
.UNINDENT
.INDENT 0.0
.TP
.B SMS_1_NUMBER
-.
Sender number.
.UNINDENT
.INDENT 0.0
.TP
.B SMS_1_TEXT
-.
Message text. Text is not available for 8\-bit binary messages.
.UNINDENT
.SS Per part variables
@@ -95,31 +94,26 @@ variables whose content is present in the message.
.INDENT 0.0
.TP
.B DECODED_1_TEXT
-.
Decoded long message text.
.UNINDENT
.INDENT 0.0
.TP
.B DECODED_1_MMS_SENDER
-.
Sender of MMS indication message.
.UNINDENT
.INDENT 0.0
.TP
.B DECODED_1_MMS_TITLE
-.
title of MMS indication message.
.UNINDENT
.INDENT 0.0
.TP
.B DECODED_1_MMS_ADDRESS
-.
Address (URL) of MMS from MMS indication message.
.UNINDENT
.INDENT 0.0
.TP
.B DECODED_1_MMS_SIZE
-.
Size of MMS as specified in MMS indication message.
.UNINDENT
.SH EXAMPLES
diff --git a/docs/man/gammu-smsd-sql.7 b/docs/man/gammu-smsd-sql.7
index eb925f9..3d93cc5 100644
--- a/docs/man/gammu-smsd-sql.7
+++ b/docs/man/gammu-smsd-sql.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-SQL" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-SQL" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-sql \- gammu-smsd(1) backend using SQL abstraction layer to use any supported database as a message storage
.
@@ -35,13 +35,10 @@ SQL service stores all its data in database. It can use one of these SQL backend
(configuration option \fBDriver\fP in smsd section):
.INDENT 0.0
.IP \(bu 2
-.
\fBnative_mysql\fP for \fIgammu\-smsd\-mysql\fP
.IP \(bu 2
-.
\fBnative_pgsql\fP for \fIgammu\-smsd\-pgsql\fP
.IP \(bu 2
-.
\fBodbc\fP for \fIgammu\-smsd\-odbc\fP
.IP \(bu 2
.INDENT 2.0
@@ -49,16 +46,12 @@ SQL service stores all its data in database. It can use one of these SQL backend
.B drivers supported by DBI for \fIgammu\-smsd\-dbi\fP, which include:
.INDENT 7.0
.IP \(bu 2
-.
\fBsqlite3\fP \- for SQLite 3
.IP \(bu 2
-.
\fBmysql\fP \- for MySQL
.IP \(bu 2
-.
\fBpgsql\fP \- for PostgeSQL
.IP \(bu 2
-.
\fBfreetds\fP \- for MS SQL Server or Sybase
.UNINDENT
.UNINDENT
@@ -68,32 +61,24 @@ SQL service stores all its data in database. It can use one of these SQL backend
Common for all backends:
.INDENT 0.0
.IP \(bu 2
-.
\fBUser\fP \- user connecting to database
.IP \(bu 2
-.
\fBPassword\fP \- password for connecting to database
.IP \(bu 2
-.
\fBHost\fP \- database host or data source name
.IP \(bu 2
-.
\fBDatabase\fP \- database name
.IP \(bu 2
-.
\fBDriver\fP \- \fBnative_mysql\fP, \fBnative_pgsql\fP, \fBodbc\fP or DBI one
.IP \(bu 2
-.
\fBSQL\fP \- SQL dialect to use
.UNINDENT
.sp
Specific for DBI:
.INDENT 0.0
.IP \(bu 2
-.
\fBDriversPath\fP \- path to DBI drivers
.IP \(bu 2
-.
\fBDBDir\fP \- sqlite/sqlite3 directory with database
.UNINDENT
.IP "See also"
@@ -107,87 +92,67 @@ Almost all queries are configurable. You can edit them in
queries. We can separate them into three groups:
.INDENT 0.0
.IP \(bu 2
-.
phone specific, which can be used in every query, see \fI\%Phone Specific Parameters\fP
.IP \(bu 2
-.
SMS specific, which can be used in queries which works with SMS messages, see \fI\%SMS Specific Parameters\fP
.IP \(bu 2
-.
query specific, which are numeric and are specific only for given query (or set of queries), see \fI\%Configurable queries\fP
.UNINDENT
.SS Phone Specific Parameters
.INDENT 0.0
.TP
.B \fB%I\fP
-.sp
IMEI of phone
.TP
.B \fB%P\fP
-.sp
PHONE ID (hostname)
.TP
.B \fB%N\fP
-.sp
client name (eg. Gammu 1.12.3)
.UNINDENT
.SS SMS Specific Parameters
.INDENT 0.0
.TP
.B \fB%R\fP
-.sp
remote number [1]
.TP
.B \fB%C\fP
-.sp
delivery datetime
.TP
.B \fB%e\fP
-.sp
delivery status on receiving or status error on sending
.TP
.B \fB%t\fP
-.sp
message reference
.TP
.B \fB%d\fP
-.sp
receiving datetime for received sms
.TP
.B \fB%E\fP
-.sp
encoded text of SMS
.TP
.B \fB%c\fP
-.sp
SMS coding (ie 8bit or UnicodeNoCompression)
.TP
.B \fB%F\fP
-.sp
sms centre number
.TP
.B \fB%u\fP
-.sp
UDH header
.TP
.B \fB%x\fP
-.sp
class
.TP
.B \fB%T\fP
-.sp
decoded SMS text
.TP
.B \fB%A\fP
-.sp
CreatorID of SMS (sending sms)
.TP
.B \fB%V\fP
-.sp
relative validity
.UNINDENT
.IP [1] 5
-.
Sender number for received messages (insert to inbox or delivery notifications), destination otherwise.
.SH CONFIGURABLE QUERIES
.sp
@@ -198,7 +163,6 @@ are selected for default queries during initialization.
.INDENT 0.0
.TP
.B delete_phone
-.
Deletes phone from database.
.sp
Default value:
@@ -212,7 +176,6 @@ DELETE FROM phones WHERE IMEI = %I
.INDENT 0.0
.TP
.B insert_phone
-.
Inserts phone to database.
.sp
Default value:
@@ -228,18 +191,15 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
enable send (yes or no) \- configuration option Send
.TP
.B \fB%2\fP
-.sp
enable receive (yes or no) \- configuration option Receive
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B save_inbox_sms_select
-.
Select message for update delivery status.
.sp
Default value:
@@ -254,7 +214,6 @@ WHERE DeliveryDateTime IS NULL AND SenderID = %P AND TPMR = %t AND DestinationNu
.INDENT 0.0
.TP
.B save_inbox_sms_update_delivered
-.
Update message delivery status if message was delivered.
.sp
Default value:
@@ -269,18 +228,15 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
delivery status returned by GSM network
.TP
.B \fB%2\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B save_inbox_sms_update
-.
Update message if there is an delivery error.
.sp
Default value:
@@ -295,18 +251,15 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
delivery status returned by GSM network
.TP
.B \fB%2\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B save_inbox_sms_insert
-.
Insert received message.
.sp
Default value:
@@ -321,7 +274,6 @@ Class, TextDecoded, RecipientID) VALUES (%d, %E, %R, %c, %F, %u, %x, %T, %P)
.INDENT 0.0
.TP
.B update_received
-.
Update statistics after receiving message.
.sp
Default value:
@@ -335,7 +287,6 @@ UPDATE phones SET Received = Received + 1 WHERE IMEI = %I
.INDENT 0.0
.TP
.B refresh_send_status
-.
Update messages in outbox.
.sp
Default value:
@@ -351,14 +302,12 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B find_outbox_sms_id
-.
Find sms messages for sending.
.sp
Default value:
@@ -376,14 +325,12 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
limit of sms messages sended in one walk in loop
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B find_outbox_body
-.
Select body of message.
.sp
Default value:
@@ -399,14 +346,12 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B find_outbox_multipart
-.
Select remaining parts of sms message.
.sp
Default value:
@@ -422,18 +367,15 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
ID of message
.TP
.B \fB%2\fP
-.sp
Number of multipart message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B delete_outbox
-.
Remove messages from outbox after threir successful send.
.sp
Default value:
@@ -448,14 +390,12 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B delete_outbox_multipart
-.
Remove messages from outbox_multipart after threir successful send.
.sp
Default value:
@@ -470,14 +410,12 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B create_outbox
-.
Create message (insert to outbox).
.sp
Default value:
@@ -494,30 +432,24 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
creator of message
.TP
.B \fB%2\fP
-.sp
delivery status report \- yes/default
.TP
.B \fB%3\fP
-.sp
multipart \- FALSE/TRUE
.TP
.B \fB%4\fP
-.sp
Part (part number)
.TP
.B \fB%5\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B create_outbox_multipart
-.
Create message remaining parts.
.sp
Default value:
@@ -533,30 +465,24 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
creator of message
.TP
.B \fB%2\fP
-.sp
delivery status report \- yes/default
.TP
.B \fB%3\fP
-.sp
multipart \- FALSE/TRUE
.TP
.B \fB%4\fP
-.sp
Part (part number)
.TP
.B \fB%5\fP
-.sp
ID of message
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B add_sent_info
-.
Insert to sentitems.
.sp
Default value:
@@ -574,30 +500,24 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
ID of sms message
.TP
.B \fB%2\fP
-.sp
part number (for multipart sms)
.TP
.B \fB%3\fP
-.sp
message state (SendingError, Error, SendingOK, SendingOKNoReport)
.TP
.B \fB%4\fP
-.sp
message reference (TPMR)
.TP
.B \fB%5\fP
-.sp
time when inserted in db
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B update_sent
-.
Update sent statistics after sending message.
.sp
Default value:
@@ -611,7 +531,6 @@ UPDATE phones SET Sent= Sent + 1 WHERE IMEI = %I
.INDENT 0.0
.TP
.B refresh_phone_status
-.
Update phone status (battery, signal).
.sp
Default value:
@@ -627,11 +546,9 @@ Query specific parameters:
.INDENT 7.0
.TP
.B \fB%1\fP
-.sp
battery percent
.TP
.B \fB%2\fP
-.sp
signal percent
.UNINDENT
.UNINDENT
diff --git a/docs/man/gammu-smsd-tables.7 b/docs/man/gammu-smsd-tables.7
index fa2fe35..93395dc 100644
--- a/docs/man/gammu-smsd-tables.7
+++ b/docs/man/gammu-smsd-tables.7
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD-TABLES" "7" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD-TABLES" "7" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd-tables \- description of tables for database backends of gammu-smsd(1)
.
@@ -62,51 +62,39 @@ Fields description:
.INDENT 0.0
.TP
.B \fBUpdatedInDB\fP (timestamp)
-.sp
when somebody (daemon, user, etc.) updated it
.TP
.B \fBReceivingDateTime\fP (timestamp)
-.sp
when SMS was received
.TP
.B \fBText\fP (text)
-.sp
encoded SMS text (for all SMS)
.TP
.B \fBSenderNumber\fP (varchar(20))
-.sp
decoded SMS sender number
.TP
.B \fBCoding\fP (enum(\(aqDefault_No_Compression\(aq, \(aqUnicode_No_Compression\(aq, \(aq8bit\(aq, \(aqDefault_Compression\(aq, \(aqUnicode_Compression\(aq))
-.sp
SMS text coding
.TP
.B \fBUDH\fP (text)
-.sp
encoded User Data Header text
.TP
.B \fBSMSCNumber\fP (varchar(20))
-.sp
decoded SMSC number
.TP
.B \fBClass\fP (integer)
-.sp
SMS class or \-1 (0 is flash SMS, 1 is normal one)
.TP
.B \fBTextDecoded\fP (varchar(160))
-.sp
decoded SMS text (for Default Alphabet/Unicode SMS)
.TP
.B \fBID\fP (integer unsigned)
-.sp
SMS identificator (for using with external applications)
.TP
.B \fBRecipientID\fP (text)
-.sp
which Gammu daemon has added it
.TP
.B \fBProcessed\fP (enum(\(aqfalse\(aq, \(aqtrue\(aq))
-.sp
you can use for marking, whether SMS was processed or not
.UNINDENT
.SS outbox
@@ -118,86 +106,68 @@ Fields description:
.INDENT 0.0
.TP
.B \fBUpdatedInDB\fP (timestamp)
-.sp
when somebody (daemon, user, etc.) updated it
.TP
.B \fBInsertIntoDB\fP (timestamp)
-.sp
when message was inserted into database
.TP
.B \fBSendingDateTime\fP (timestamp)
-.sp
set it to some value, when want to force sending after some planned time
.TP
.B \fBSendBefore\fP (time)
-.sp
Send message before specified time, can be used to limit messages from
being sent in night. Default value is 23:59:59
.sp
New in version 1.29.90.
.TP
.B \fBSendAfter\fP (time)
-.sp
Send message after specified time, can be used to limit messages from
being sent in night. Default value is 00:00:00
.sp
New in version 1.29.90.
.TP
.B \fBText\fP (text)
-.sp
SMS text encoded using hex values in proper coding. If you want to use
TextDecoded field, keep this NULL (or empty).
.TP
.B \fBDestinationNumber\fP (varchar(20))
-.sp
recipient number
.TP
.B \fBCoding\fP (enum(\(aqDefault_No_Compression\(aq, \(aqUnicode_No_Compression\(aq, \(aq8bit\(aq, \(aqDefault_Compression\(aq, \(aqUnicode_Compression\(aq))
-.sp
SMS text coding
.TP
.B \fBUDH\fP (text)
-.sp
User Data Header encoded using hex values which will be used for constructing
the message. Without this, message will be sent as plain text.
.TP
.B \fBClass\fP (integer)
-.sp
SMS class or \-1 (0 is normal SMS, 1 is flash one)
.TP
.B \fBTextDecoded\fP (varchar(160))
-.sp
SMS text in "human readable" form
.TP
.B \fBID\fP (integer unsigned)
-.sp
SMS/SMS sequence ID
.sp
Please note that this number has to be unique also for sentitems table, so
reusing message IDs might not be a good idea.
.TP
.B \fBMultiPart\fP (enum(\(aqfalse\(aq,\(aqtrue\(aq))
-.sp
info, whether there are more SMS from this sequence in outbox_multipart
.TP
.B \fBRelativeValidity\fP (integer)
-.sp
SMS relative validity like encoded using GSM specs
.TP
.B \fBSenderID\fP (text)
-.sp
which SMSD instance should send this one sequence, see \fBPhoneID\fP
.TP
.B \fBSendingTimeOut\fP (timestamp)
-.sp
used by SMSD instance for own targets
.TP
.B \fBDeliveryReport\fP (enum(\(aqdefault\(aq,\(aqyes\(aq,\(aqno\(aq))
-.sp
when default is used, Delivery Report is used or not according to SMSD instance settings; yes forces Delivery Report.
.TP
.B \fBCreatorID\fP (text)
-.sp
sender identification, it has to match PhoneID in SMSD configuration to make
SMSD process this message
.UNINDENT
@@ -209,35 +179,27 @@ Fields description:
.INDENT 0.0
.TP
.B \fBID\fP (integer unsigned)
-.sp
the same meaning as values in outbox table
.TP
.B \fBText\fP (text)
-.sp
the same meaning as values in outbox table
.TP
.B \fBCoding\fP (enum(\(aqDefault_No_Compression\(aq, \(aqUnicode_No_Compression\(aq, \(aq8bit\(aq, \(aqDefault_Compression\(aq, \(aqUnicode_Compression\(aq))
-.sp
the same meaning as values in outbox table
.TP
.B \fBUDH\fP (text)
-.sp
the same meaning as values in outbox table
.TP
.B \fBClass\fP (integer)
-.sp
the same meaning as values in outbox table
.TP
.B \fBTextDecoded\fP (varchar(160))
-.sp
the same meaning as values in outbox table
.TP
.B \fBID\fP (integer unsigned)
-.sp
the same meaning as values in outbox table
.TP
.B \fBSequencePosition\fP (integer)
-.sp
info, what is SMS number in SMS sequence (start at 2, first part is in \fI\%outbox\fP
table).
.UNINDENT
@@ -250,52 +212,40 @@ Fields description:
.INDENT 0.0
.TP
.B \fBID\fP (text)
-.sp
PhoneID value
.TP
.B \fBUpdatedInDB\fP (timestamp)
-.sp
when this record has been updated
.TP
.B \fBInsertIntoDB\fP (timestamp)
-.sp
when this record has been created (when phone has been connected)
.TP
.B \fBTimeOut\fP (timestamp)
-.sp
when this record expires
.TP
.B \fBSend\fP (boolean)
-.sp
indicates whether SMSD is sending messages, depends on configuration directive \fBSend\fP
.TP
.B \fBReceive\fP (boolean)
-.sp
indicates whether SMSD is receiving messages, depends on configuration directive \fBReceive\fP
.TP
.B \fBIMEI\fP (text)
-.sp
IMEI of phone
.TP
.B \fBClient\fP (text)
-.sp
client name, usually string Gammu with version
.TP
.B \fBBattery\fP (integer)
-.sp
battery level in percent (or \-1 if unknown)
.TP
.B \fBSignal\fP (integer)
-.sp
signal level in percent (or \-1 if unknown)
.TP
.B \fBSent\fP (integer)
-.sp
Number of sent SMS messages (SMSD does not reset this counter, so it might
overflow).
.TP
.B \fBReceived\fP (integer)
-.sp
Number of received SMS messages (SMSD does not reset this counter, so it might
overflow).
.UNINDENT
@@ -308,115 +258,88 @@ Fields description:
.INDENT 0.0
.TP
.B \fBUpdatedInDB\fP (timestamp)
-.sp
when somebody (daemon, user, etc.) updated it
.TP
.B \fBInsertIntoDB\fP (timestamp)
-.sp
when message was inserted into database
.TP
.B \fBSendingDateTime\fP (timestamp)
-.sp
when message has been sent
.TP
.B \fBDeliveryDateTime\fP (timestamp)
-.sp
Time of receiving delivery report (if it has been enabled).
.TP
.B \fBStatus\fP (enum(\(aqSendingOK\(aq, \(aqSendingOKNoReport\(aq, \(aqSendingError\(aq, \(aqDeliveryOK\(aq, \(aqDeliveryFailed\(aq, \(aqDeliveryPending\(aq, \(aqDeliveryUnknown\(aq, \(aqError\(aq))
-.sp
Status of message sending. SendingError mens that phone failed to send the
message, Error indicates some other error while processing message.
.INDENT 7.0
.TP
.B \fBSendingOK\fP
-.sp
Message has been sent, waiting for delivery report.
.TP
.B \fBSendingOKNoReport\fP
-.sp
Message has been sent without asking for delivery report.
.TP
.B \fBSendingError\fP
-.sp
Sending has failed.
.TP
.B \fBDeliveryOK\fP
-.sp
Delivery report arrived and reported success.
.TP
.B \fBDeliveryFailed\fP
-.sp
Delivery report arrived and reports failure.
.TP
.B \fBDeliveryPending\fP
-.sp
Delivery report announced pending deliver.
.TP
.B \fBDeliveryUnknown\fP
-.sp
Delivery report reported unknown status.
.TP
.B \fBError\fP
-.sp
Some other error happened during sending (usually bug in SMSD).
.UNINDENT
.TP
.B \fBStatusError\fP (integer)
-.sp
Status of delivery from delivery report message, codes are defined in GSM
specification 03.40 section 9.2.3.15 (TP\-Status).
.TP
.B \fBText\fP (text)
-.sp
SMS text encoded using hex values
.TP
.B \fBDestinationNumber\fP (varchar(20))
-.sp
decoded destination number for SMS
.TP
.B \fBCoding\fP (enum(\(aqDefault_No_Compression\(aq, \(aqUnicode_No_Compression\(aq, \(aq8bit\(aq, \(aqDefault_Compression\(aq, \(aqUnicode_Compression\(aq))
-.sp
SMS text coding
.TP
.B \fBUDH\fP (text)
-.sp
User Data Header encoded using hex values
.TP
.B \fBSMSCNumber\fP (varchar(20))
-.sp
decoded number of SMSC, which sent SMS
.TP
.B \fBClass\fP (integer)
-.sp
SMS class or \-1 (0 is normal SMS, 1 is flash one)
.TP
.B \fBTextDecoded\fP (varchar(160))
-.sp
SMS text in "human readable" form
.TP
.B \fBID\fP (integer unsigned)
-.sp
SMS ID
.TP
.B \fBSenderID\fP (text)
-.sp
which SMSD instance sent this one sequence, see \fBPhoneID\fP
.TP
.B \fBSequencePosition\fP (integer)
-.sp
SMS number in SMS sequence
.TP
.B \fBTPMR\fP (integer)
-.sp
Message Reference like in GSM specs
.TP
.B \fBRelativeValidity\fP (integer)
-.sp
SMS relative validity like encoded using GSM specs
.TP
.B \fBCreatorID\fP (text)
-.sp
copied from CreatorID from outbox table, matches PhoneID
.UNINDENT
.SS pbk
@@ -431,13 +354,11 @@ History of schema versions:
.INDENT 0.0
.TP
.B 13
-.
Added \fBSendBefore\fP and \fBSendAfter\fP fields.
.sp
Changed in version 1.29.90.
.TP
.B 12
-.
the changes only affect MySQL structure changing default values for
timestamps from \fB0000\-00\-00 00:00:00\fP to \fBCURRENT_TIMESTAMP()\fP by
using triggers, to update to this version, just execute triggers
@@ -446,51 +367,43 @@ definition at the end of SQL file.
Changed in version 1.28.94.
.TP
.B 11
-.
all fields for storing message text are no longer limited to 160 chars,
but are arbitrary length text fields.
.sp
Changed in version 1.25.92.
.TP
.B 10
-.
\fBDeliveryDateTime\fP is now NULL when message is not delivered, added several
indexes
.sp
Changed in version 1.22.95.
.TP
.B 9
-.
added sent/received counters to phones table
.sp
Changed in version 1.22.93.
.TP
.B 8
-.
Signal and battery state are now stored in database.
.sp
Changed in version 1.20.94.
.TP
.B 7
-.
Added \fBCreatorID\fP to several tables.
.sp
Changed in version 1.07.00.
.TP
.B 6
-.
Many fields in outbox can now be NULL.
.sp
Changed in version 1.06.00.
.TP
.B 5
-.
Introduced daemons table and various other changes.
.sp
Changed in version 1.03.00.
.TP
.B 3
-.
Introduced phones table and various other changes.
.sp
Changed in version 0.98.0.
@@ -599,7 +512,6 @@ INSERT INTO outbox_multipart (
.ft P
.fi
.IP Note
-.
Adding UDH means that you have less space for text, in above example you
can use only 153 characters in single message.
.RE
diff --git a/docs/man/gammu-smsd.1 b/docs/man/gammu-smsd.1
index 13cd96f..ad1d939 100644
--- a/docs/man/gammu-smsd.1
+++ b/docs/man/gammu-smsd.1
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSD" "1" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSD" "1" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsd \- SMS daemon for Gammu
.
@@ -53,19 +53,16 @@ accepted on some platforms):
.INDENT 0.0
.TP
.B \-h, \-\-help
-.sp
Shows help.
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-version
-.sp
Shows version information and compiled in features.
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-config=file
-.sp
Configuration file to use, default is /etc/gammu\-smsdrc, on Windows there
is no default and configuration file path has to be always specified.
.sp
@@ -78,74 +75,62 @@ See \fIgammu\-smsdrc\fP for configuration file documentation.
.INDENT 0.0
.TP
.B \-p, \-\-pid=file
-.sp
Lock file for storing pid, empty for no locking. Not supported on Windows.
.UNINDENT
.INDENT 0.0
.TP
.B \-U, \-\-user=user
-.sp
Drop daemon privileges to chosed user after starting.
.UNINDENT
.INDENT 0.0
.TP
.B \-G, \-\-group=group
-.sp
Drop daemon privileges to chosen group after starting.
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-daemon
-.sp
Daemonize program on startup. Not supported on Windows.
.UNINDENT
.INDENT 0.0
.TP
.B \-i, \-\-install\-service
-.sp
Installs SMSD as a Windows service.
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-uninstall\-service
-.sp
Uninstalls SMSD as a Windows service.
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-start\-service
-.sp
Starts SMSD Windows service.
.UNINDENT
.INDENT 0.0
.TP
.B \-k, \-\-stop\-service
-.sp
Stops SMSD Windows service.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-max\-failures=count
-.sp
Terminate after defined number of failures. Use 0 to not terminate (this is default).
.UNINDENT
.INDENT 0.0
.TP
.B \-X, \-\-suicide=seconds
-.sp
Kills itself after number of seconds.
.UNINDENT
.INDENT 0.0
.TP
.B \-S, \-\-run\-service
-.sp
Runs pogram as SMSD Windows service. This should not be used manually, but
only Windows Service manager should use this command.
.UNINDENT
.INDENT 0.0
.TP
.B \-n, \-\-service\-name=name
-.sp
Defines name of a Windows service. Each service requires an unique name,
so if you want to run several SMSD instances, you have to name each
service differently. Default is "GammuSMSD".
diff --git a/docs/man/gammu-smsdrc.5 b/docs/man/gammu-smsdrc.5
index 603375a..65802ce 100644
--- a/docs/man/gammu-smsdrc.5
+++ b/docs/man/gammu-smsdrc.5
@@ -1,4 +1,4 @@
-.TH "GAMMU-SMSDRC" "5" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU-SMSDRC" "5" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu-smsdrc \- gammu-smsd(1) configuration file
.
@@ -50,7 +50,6 @@ configures how much messages gammu emits.
.INDENT 0.0
.TP
.B [smsd]
-.
The \fI\%[smsd]\fP section configures SMS daemon itself, which are described in
following subsections. First general parameters of SMS daemon are listed and
then specific parameters for storage backends.
@@ -58,31 +57,26 @@ then specific parameters for storage backends.
.INDENT 0.0
.TP
.B [include_numbers]
-.
List of numbers from which accept messages, see \fI\%Message filtering\fP.
.UNINDENT
.INDENT 0.0
.TP
.B [exclude_numbers]
-.
List of numbers from which reject messages, see \fI\%Message filtering\fP.
.UNINDENT
.INDENT 0.0
.TP
.B [include_smsc]
-.
List of SMSC numbers from which accept messages, see \fI\%Message filtering\fP.
.UNINDENT
.INDENT 0.0
.TP
.B [exclude_smsc]
-.
List of SMSC numbers from which reject messages, see \fI\%Message filtering\fP.
.UNINDENT
.INDENT 0.0
.TP
.B [sql]
-.
Configure SQL queries used by \fIgammu\-smsd\-sql\fP, you usually don\(aqt have to modify them.
.IP "See also"
.sp
@@ -93,26 +87,21 @@ Configure SQL queries used by \fIgammu\-smsd\-sql\fP, you usually don\(aqt have
.INDENT 0.0
.TP
.B Service
-.
SMSD service to use, one of following choices:
.INDENT 7.0
.TP
.B \fBFILES\fP
-.sp
stores messages in files, see \fIgammu\-smsd\-files\fP for details
.TP
.B \fBNULL\fP
-.sp
does not store messages at all, see \fIgammu\-smsd\-null\fP for details
.TP
.B \fBSQL\fP
-.sp
stores messages in SQL database, see \fIgammu\-smsd\-sql\fP for details
.sp
New in version 1.28.93.
.TP
.B \fBMYSQL\fP
-.sp
synonym for \fI\%Service\fP = \fBSQL\fP and \fI\%Driver\fP = \fBnative_mysql\fP
.sp
stores messages in MySQL database, see \fIgammu\-smsd\-mysql\fP for details
@@ -120,7 +109,6 @@ stores messages in MySQL database, see \fIgammu\-smsd\-mysql\fP for details
Deprecated since version 1.28.93.
.TP
.B \fBPGSQL\fP
-.sp
synonym for \fI\%Service\fP = \fBSQL\fP and \fI\%Driver\fP = \fBnative_pgsql\fP
.sp
stores messages in PostgreSQL database, see \fIgammu\-smsd\-pgsql\fP for details
@@ -128,7 +116,6 @@ stores messages in PostgreSQL database, see \fIgammu\-smsd\-pgsql\fP for details
Deprecated since version 1.28.93.
.TP
.B \fBDBI\fP
-.sp
synonym for \fI\%Service\fP = \fBSQL\fP and \fI\%Driver\fP = DBI driver
.sp
stores messages in any database supported by libdbi, this includes
@@ -138,35 +125,30 @@ details
Deprecated since version 1.28.93.
.UNINDENT
.IP Note
-.
Availability of backends depends on platform and compile time configuration.
.RE
.UNINDENT
.INDENT 0.0
.TP
.B PIN
-.
PIN for SIM card. This is optional, but you should set it if your phone after
power on requires PIN.
.UNINDENT
.INDENT 0.0
.TP
.B NetworkCode
-.
Network personalisation password. This is optional, but some phones require it
after power on.
.UNINDENT
.INDENT 0.0
.TP
.B PhoneCode
-.
Phone lock password. This is optional, but some phones require it after power
on.
.UNINDENT
.INDENT 0.0
.TP
.B LogFile
-.
File where SMSD actions are being logged. You can also use special value
\fBsyslog\fP which will send all messages to syslog daemon. On Windows another
special value \fBeventlog\fP exists, which will send logs to Windows Event Log.
@@ -180,21 +162,17 @@ Default is to provide no logging.
.INDENT 0.0
.TP
.B DebugLevel
-.
Debug level for SMSD. The integer value should be sum of all flags you
want to enable.
.INDENT 7.0
.TP
.B 1
-.
enables basic debugging information
.TP
.B 2
-.
enables logging of SQL queries of service backends
.TP
.B 4
-.
enables logging of gammu debug information
.UNINDENT
.sp
@@ -205,7 +183,6 @@ Default is 0, what should mean no extra information.
.INDENT 0.0
.TP
.B CommTimeout
-.
How many seconds should SMSD wait after there is no message in outbox.
.sp
Default is 30.
@@ -213,7 +190,6 @@ Default is 30.
.INDENT 0.0
.TP
.B SendTimeout
-.
Shows how many seconds SMSD should wait for network answer during sending
sms. If nothing happen during this time, sms will be resent.
.sp
@@ -222,7 +198,6 @@ Default is 30.
.INDENT 0.0
.TP
.B MaxRetries
-.
How many times will SMSD try to resend message if sending fails.
.sp
Default is 1.
@@ -230,7 +205,6 @@ Default is 1.
.INDENT 0.0
.TP
.B ReceiveFrequency
-.
The number of seconds between testing for received SMSes, when the phone is
busy sending SMSes. Normally a test for received SMSes is done every
\fI\%CommTimeout\fP seconds and after each sent SMS.
@@ -240,7 +214,6 @@ Default is 0 (not used).
.INDENT 0.0
.TP
.B StatusFrequency
-.
The number of seconds between refreshing phone status (battery, signal) stored
in shared memory and possibly in service backends. Use 0 to disable.
.sp
@@ -249,7 +222,6 @@ Default is 15.
.INDENT 0.0
.TP
.B LoopSleep
-.
The number of seconds how long will SMSD sleep before checking for some
activity. Please note that setting this to higher value than 1 will have
effects to other time based configurations, because they will be effectively
@@ -260,7 +232,6 @@ Default is 1.
.INDENT 0.0
.TP
.B MultipartTimeout
-.
The number of seconds how long will SMSD wait for all parts of multipart
message. If all parts won\(aqt arrive in time, parts will be processed as separate
messages.
@@ -270,7 +241,6 @@ Default is 600 (10 minutes).
.INDENT 0.0
.TP
.B CheckSecurity
-.
Whether to check if phone wants to enter PIN.
.sp
Default is 1 (enabled).
@@ -278,7 +248,6 @@ Default is 1 (enabled).
.INDENT 0.0
.TP
.B CheckBattery
-.
Whether to check phone battery state periodically.
.sp
Default is 1 (enabled).
@@ -286,7 +255,6 @@ Default is 1 (enabled).
.INDENT 0.0
.TP
.B CheckSignal
-.
Whether to check signal level periodically.
.sp
Default is 1 (enabled).
@@ -294,7 +262,6 @@ Default is 1 (enabled).
.INDENT 0.0
.TP
.B ResetFrequency
-.
The number of seconds between performing a preventive soft reset in order to
minimize the cases of hanging phones e.g. Nokia 5110 will sometimes freeze to
a state when only after unmounting the battery the phone will be functional
@@ -305,10 +272,8 @@ Default is 0 (not used).
.INDENT 0.0
.TP
.B HardResetFrequency
-.
New in version 1.28.92.
.IP Warning
-.
For some phones hard reset means deleting all data in it. Use
\fI\%ResetFrequency\fP, unless you know what you are doing.
.RE
@@ -321,20 +286,16 @@ Default is 0 (not used).
.INDENT 0.0
.TP
.B DeliveryReport
-.
Whether delivery reports should be used, one of \fBno\fP, \fBlog\fP, \fBsms\fP.
.INDENT 7.0
.TP
.B \fBlog\fP
-.sp
one line log entry,
.TP
.B \fBsms\fP
-.sp
store in inbox as a received SMS
.TP
.B \fBno\fP
-.sp
no delivery reports
.UNINDENT
.sp
@@ -343,7 +304,6 @@ Default is \fBno\fP.
.INDENT 0.0
.TP
.B DeliveryReportDelay
-.
Delay in seconds how long is still delivery report considered valid. This
depends on brokeness of your network (delivery report should have same
timestamp as sent message). Increase this if delivery reports are not paired
@@ -354,7 +314,6 @@ Default is 600 (10 minutes).
.INDENT 0.0
.TP
.B PhoneID
-.
String with info about phone used for sending/receiving. This can be useful if
you want to run several SMS daemons.
.sp
@@ -367,7 +326,6 @@ This option has actually no effect with \fIgammu\-smsd\-files\fP.
.INDENT 0.0
.TP
.B RunOnReceive
-.
Executes a program after receiving message.
.sp
This parameter is executed through shell, so you might need to escape some
@@ -388,7 +346,6 @@ environment, check \fIgammu\-smsd\-run\fP for more details.
.INDENT 0.0
.TP
.B RunOnFailure
-.
New in version 1.28.93.
.sp
Executes a program on failure.
@@ -400,14 +357,12 @@ The program will receive optional parameter, which can currently be either
\fBINIT\fP (meaning failure during phone initialization) or message ID,
which would indicate error while sending the message.
.IP Note
-.
The environment with message (as is in \fI\%RunOnReceive\fP) is not passed to the command.
.RE
.UNINDENT
.INDENT 0.0
.TP
.B IncludeNumbersFile
-.
File with list of numbers which are accepted by SMSD. The file contains one
number per line, blank lines are ignored. The file is read at startup and is
reread only when configuration is being reread. See Message filtering for
@@ -416,7 +371,6 @@ details.
.INDENT 0.0
.TP
.B ExcludeNumbersFile
-.
File with list of numbers which are not accepted by SMSD. The file contains
one number per line, blank lines are ignored. The file is read at startup and
is reread only when configuration is being reread. See Message filtering for
@@ -425,7 +379,6 @@ details.
.INDENT 0.0
.TP
.B IncludeSMSCFile
-.
File with list of SMSC numbers which are accepted by SMSD. The file contains
one number per line, blank lines are ignored. The file is read at startup and
is reread only when configuration is being reread. See Message filtering for
@@ -434,7 +387,6 @@ details.
.INDENT 0.0
.TP
.B ExcludeSMSCFile
-.
File with list of SMSC numbers which are not accepted by SMSD. The file
contains one number per line, blank lines are ignored. The file is read at
startup and is reread only when configuration is being reread. See Message
@@ -443,7 +395,6 @@ filtering for details.
.INDENT 0.0
.TP
.B BackendRetries
-.
How many times will SMSD backend retry operation.
.sp
The implementation on different backends is different, for database backends
@@ -454,7 +405,6 @@ Default is 10.
.INDENT 0.0
.TP
.B Send
-.
New in version 1.28.91.
.sp
Whether to enable sending of messages.
@@ -464,7 +414,6 @@ Default is True.
.INDENT 0.0
.TP
.B Receive
-.
New in version 1.28.91.
.sp
Whether to enable receiving of messages.
@@ -473,36 +422,39 @@ Default is True.
.UNINDENT
.SH DATABASE BACKENDS OPTIONS
.sp
-All DBI, MYSQL and PGSQL backends (see \fIgammu\-smsd\-mysql\fP,
-\fIgammu\-smsd\-pgsql\fP, \fIgammu\-smsd\-dbi\fP for their documentation)
-supports same options for configuring connection to a database:
+All DBI, ODBC, MYSQL and PGSQL backends (see \fIgammu\-smsd\-mysql\fP,
+\fIgammu\-smsd\-odbc\fP, \fIgammu\-smsd\-pgsql\fP, \fIgammu\-smsd\-dbi\fP for
+their documentation) supports same options for configuring connection to a
+database:
.INDENT 0.0
.TP
.B User
-.
User name used for connection to a database.
.UNINDENT
.INDENT 0.0
.TP
.B Password
-.
Password used for connection to a database.
.UNINDENT
.INDENT 0.0
.TP
.B Host
-.
Database server address. It can also contain port or socket path after
-semicolon, for example \fBlocalhost:/path/to/socket\fP.
+semicolon, for example \fBlocalhost:/path/to/socket\fP or
+\fB192.168.1.1:8000\fP.
.sp
For ODBC this is used as Data source name.
+.IP Note
+Some database servers differentiate usage of \fBlocalhost\fP (to use
+local socket) and \fB127.0.0.1\fP (to use locat TCP/IP connection).
+Please make sure your SMSD settings match the database server ones.
+.RE
.sp
New in version 1.28.92.
.UNINDENT
.INDENT 0.0
.TP
.B PC
-.
Synonym for \fI\%Host\fP.
.sp
Deprecated since version 1.28.92.
@@ -510,7 +462,6 @@ Deprecated since version 1.28.92.
.INDENT 0.0
.TP
.B Database
-.
Name of database to use. Please note that you should create tables in this
database before using gammu\-smsd. SQL files for creating needed tables are
included in documentation.
@@ -518,7 +469,6 @@ included in documentation.
.INDENT 0.0
.TP
.B SkipSMSCNumber
-.
When you send sms from some SMS centere you can have delivery reports from
other SMSC number. You can set here number of this SMSC used by you and Gammu
will not check it\(aqs number during assigning reports to sent SMS.
@@ -526,7 +476,6 @@ will not check it\(aqs number during assigning reports to sent SMS.
.INDENT 0.0
.TP
.B Driver
-.
SQL driver to use.
.sp
Can be either one of native drivers (\fBodbc\fP, \fBnative_mysql\fP or
@@ -540,32 +489,24 @@ Sybase), \fBpgsql\fP, \fBsqlite\fP, \fBsqlite3\fP, \fBfirebird\fP and \fBingres\
.INDENT 0.0
.TP
.B SQL
-.
SQL dialect to use. This is specially useful with \fIgammu\-smsd\-odbc\fP where SMSD
does not know which server it is actually talking to.
.sp
Possible values:
.INDENT 7.0
.IP \(bu 2
-.
\fBmysql\fP \- MySQL
.IP \(bu 2
-.
\fBpgsql\fP \- PostgreSQL
.IP \(bu 2
-.
\fBsqlite\fP \- SQLite
.IP \(bu 2
-.
\fBmssql\fP \- Microsoft SQL Server
.IP \(bu 2
-.
\fBsybase\fP \- Sybase
.IP \(bu 2
-.
\fBaccess\fP \- Microsoft Access
.IP \(bu 2
-.
\fBodbc\fP \- Generic ODBC
.UNINDENT
.sp
@@ -578,14 +519,12 @@ You can also completely customize SQL queries used as described in \fISQL Querie
.INDENT 0.0
.TP
.B DriversPath
-.
Path, where DBI drivers are stored, this usually does not have to be set if
you have properly installed drivers.
.UNINDENT
.INDENT 0.0
.TP
.B DBDir
-.
Database directory for some (currently only sqlite) DBI drivers. Set here path
where sqlite database files are stored.
.UNINDENT
@@ -597,7 +536,6 @@ that all path should contain trailing path separator (/ on Unix systems):
.INDENT 0.0
.TP
.B InboxPath
-.
Where the received SMSes are stored.
.sp
Default is current directory.
@@ -605,7 +543,6 @@ Default is current directory.
.INDENT 0.0
.TP
.B OutboxPath
-.
Where SMSes to be sent should be placed.
.sp
Default is current directory.
@@ -613,7 +550,6 @@ Default is current directory.
.INDENT 0.0
.TP
.B SentSMSPath
-.
Where the transmitted SMSes are placed, if same as \fI\%OutboxPath\fP transmitted
messages are deleted.
.sp
@@ -622,7 +558,6 @@ Default is to delete transmitted messages.
.INDENT 0.0
.TP
.B ErrorSMSPath
-.
Where SMSes with error in transmission is placed.
.sp
Default is same as \fI\%SentSMSPath\fP.
@@ -630,20 +565,16 @@ Default is same as \fI\%SentSMSPath\fP.
.INDENT 0.0
.TP
.B InboxFormat
-.
The format in which the SMS will be stored: \fBdetail\fP, \fBunicode\fP, \fBstandard\fP.
.INDENT 7.0
.TP
.B \fBdetail\fP
-.sp
format used for message backup by \fIgammu\fP, see \fIgammu\-smsbackup\fP.
.TP
.B \fBunicode\fP
-.sp
message text stored in unicode (UTF\-16)
.TP
.B \fBstandard\fP
-.sp
message text stored in system charset
.UNINDENT
.sp
@@ -652,7 +583,6 @@ are always written raw as they are received with extension .bin.
.sp
Default is \fBunicode\fP.
.IP Note
-.
In \fBdetail\fP format, all message parts are stored into signle file,
for all others each message part is saved separately.
.RE
@@ -660,7 +590,6 @@ for all others each message part is saved separately.
.INDENT 0.0
.TP
.B OutboxFormat
-.
The format in which messages created by \fIgammu\-smsd\-inject\fP will be stored,
it accepts same values as InboxFormat.
.sp
@@ -670,7 +599,6 @@ otherwise.
.INDENT 0.0
.TP
.B TransmitFormat
-.
The format for transmitting the SMS: \fBauto\fP, \fBunicode\fP, \fB7bit\fP.
.sp
Default is \fBauto\fP.
@@ -749,6 +677,39 @@ DBDir = /var/lib/sqlite3
Database = smsd.db
.ft P
.fi
+.SS ODBC service using MySQL
+.sp
+For \fIgammu\-smsd\-odbc\fP backend, in this particular case using DSN \fBsmsd\fP server:
+.sp
+.nf
+.ft C
+[smsd]
+Service = sql
+Driver = odbc
+Host = smsd
+.ft P
+.fi
+.sp
+The DSN definition (in \fB~/.odbc.ini\fP on UNIX) for using MySQL server would look like:
+.sp
+.nf
+.ft C
+[smsd]
+Description = MySQL
+Driver = MySQL
+Server = 127.0.0.1
+Database = smsd
+Port =
+Socket =
+Option =
+Stmt =
+
+[smsdsuse]
+Driver = MySQL ODBC 3.51.27r695 Driver
+DATABASE = smsd
+SERVER = 127.0.0.1
+.ft P
+.fi
.SS Numbers filtering
.sp
Process only messages from 123456 number:
diff --git a/docs/man/gammu.1 b/docs/man/gammu.1
index a9d0a7c..bb18c4e 100644
--- a/docs/man/gammu.1
+++ b/docs/man/gammu.1
@@ -1,4 +1,4 @@
-.TH "GAMMU" "1" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMU" "1" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammu \- Does some neat things with your cellular phone or modem.
.
@@ -50,56 +50,47 @@ Parameters before command configure gammu behaviour:
.INDENT 0.0
.TP
.B \-c, \-\-config <filename>
-.sp
name of configuration file
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-section <confign>
-.sp
section of config file to use, eg. 42
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-debug <level>
-.sp
debug level (see \fBLogFormat\fP in \fIgammurc\fP for possible values)
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-debug\-file <filename>
-.sp
file for logging debug messages
.UNINDENT
.SS Call commands
.INDENT 0.0
.TP
.B answercall [id]
-.sp
Answer incoming call.
.UNINDENT
.INDENT 0.0
.TP
.B cancelcall [id]
-.sp
Cancel incoming call
.UNINDENT
.INDENT 0.0
.TP
.B canceldiverts
-.
Cancel all existing call diverts.
.UNINDENT
.INDENT 0.0
.TP
.B conferencecall id
-.sp
Initiates a conference call.
.UNINDENT
.INDENT 0.0
.TP
.B dialvoice number [show|hide]
-.sp
Make voice call from SIM card line set in phone.
.sp
\fBshow|hide\fP \- optional parameter whether to disable call number indication.
@@ -107,78 +98,64 @@ Make voice call from SIM card line set in phone.
.INDENT 0.0
.TP
.B divert get|set all|busy|noans|outofreach all|voice|fax|data [number timeout]
-.sp
Manage or display call diverts.
.INDENT 7.0
.TP
.B \fBget\fP or \fBset\fP
-.sp
whether to get divert information or to set it.
.TP
.B \fBall\fP or \fBbusy\fP or \fBnoans\fP or \fBoutofreach\fP
-.sp
condition when apply divert
.TP
.B \fBall\fP or \fBvoice\fP or \fBfax\fP or \fBdata\fP
-.sp
call type when apply divert
.TP
.B number
-.
number where to divert
.TP
.B timeout
-.
timeout when the diversion will happen
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B getussd code
-.sp
Retrieves USSD information \- dials a service number and reads response.
.UNINDENT
.INDENT 0.0
.TP
.B holdcall id
-.sp
Holds call.
.UNINDENT
.INDENT 0.0
.TP
.B maketerminatedcall number length [show|hide]
-.sp
Make voice call from SIM card line set in phone which will
be terminated after \fBlength\fP seconds.
.UNINDENT
.INDENT 0.0
.TP
.B senddtmf sequence
-.sp
Plays DTMF sequence. In some phones available only during calls
.UNINDENT
.INDENT 0.0
.TP
.B splitcall id
-.sp
Splits call.
.UNINDENT
.INDENT 0.0
.TP
.B switchcall [id]
-.sp
Switches call.
.UNINDENT
.INDENT 0.0
.TP
.B transfercall [id]
-.sp
Transfers call.
.UNINDENT
.INDENT 0.0
.TP
.B unholdcall id
-.sp
Unholds call.
.UNINDENT
.SS SMS and EMS commands
@@ -195,23 +172,18 @@ Gammu has support for many SMS formats like:
.INDENT 0.0
.TP
.B Nokia Smart Messaging
-.
used for monochromatic picture images, downloadable profiles, monochromatic operator logos, monochromatic caller logos and monophonic ringtones
.TP
.B Linked SMS
-.
both with 8 and 16\-bit identification numbers in headers
.TP
.B EMS
-.
this is SMS format used for saving monochromatic images, monophonic ringtones, animations, text formatting and others
.TP
.B MMS notifications
-.
contains links where phone should download MMS
.TP
.B Alcatel logo messages
-.
proprietary format for logos
.UNINDENT
.sp
@@ -229,22 +201,16 @@ it isn\(aqt big limit, because there are no phones supporting them), but they\(a
from limited set:
.INDENT 0.0
.IP \(bu 2
-.
all Latin small and large
.IP \(bu 2
-.
all digits
.IP \(bu 2
-.
some Greek
.IP \(bu 2
-.
some other national
.IP \(bu 2
-.
some symbols like @\ ! " # & / ( )\ % * + = \- , .\ :\ ; < >\ ?
.IP \(bu 2
-.
few others
.UNINDENT
.SS Unicode
@@ -252,7 +218,6 @@ few others
With \fIUnicode\fP single SMS can contain at most 70 chars, but these can be
any chars including all national and special ones.
.IP Warning
-.
Please note, that some older phones might have problems displaying such
message.
.RE
@@ -277,13 +242,11 @@ Remaining not known characters are replaced by question mark.
.INDENT 0.0
.TP
.B deleteallsms folder
-.sp
Delete all SMS from specified SMS folder.
.UNINDENT
.INDENT 0.0
.TP
.B deletesms folder start [stop]
-.sp
Delete SMS from phone. See description for \fI\%gammu getsms\fP for info about
sms folders naming convention.
.sp
@@ -292,14 +255,12 @@ Locations are numerated from 1.
.INDENT 0.0
.TP
.B displaysms ... (options like in sendsms)
-.sp
Displays PDU data of encoded SMS messages. It accepts same parameters and
behaves same like sendsms.
.UNINDENT
.INDENT 0.0
.TP
.B getallsms \-pbk
-.sp
Get all SMS from phone. In some phones you will have also SMS templates
and info about locations used to save Picture Images. With each sms you
will see location. If you want to get such sms from phone alone, use
@@ -308,14 +269,12 @@ will see location. If you want to get such sms from phone alone, use
.INDENT 0.0
.TP
.B geteachsms \-pbk
-.sp
Similiary to \fI\%gammu getallsms\fP. Difference is, that
links all concatenated sms
.UNINDENT
.INDENT 0.0
.TP
.B getsms folder start [stop]
-.sp
Get SMS.
.sp
Locations are numerated from 1.
@@ -334,7 +293,6 @@ by Nokia 3310, 5110, 6110). If work with your phone, use
.INDENT 0.0
.TP
.B getsmsc [start [stop]]
-.sp
Get SMSC settings from SIM card.
.sp
Locations are numerated from 1.
@@ -342,20 +300,17 @@ Locations are numerated from 1.
.INDENT 0.0
.TP
.B getsmsfolders
-.
Get names for SMS folders in phone
.UNINDENT
.INDENT 0.0
.TP
.B savesms TYPE [type parameters] [type options] [\-folder id] [\-unread] [\-read] [\-unsent] [\-sent] [\-sender number] [\-smsname name] [\-smscset number] [\-smscnumber number] [\-reply] [\-maxsms num]
-.sp
Saves SMS to phone, see bellow for \fBTYPE\fP options.
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \-smscset number
-.sp
SMSC number will be taken from phone stored SMSC configuration \fBnumber\fP.
.sp
Default: 1
@@ -363,19 +318,16 @@ Default: 1
.INDENT 0.0
.TP
.B \-smscnumber number
-.sp
SMSC number
.UNINDENT
.INDENT 0.0
.TP
.B \-reply
-.
reply SMSC is set
.UNINDENT
.INDENT 0.0
.TP
.B \-folder number
-.sp
save to specified folder.
.sp
Folders are numerated from 1.
@@ -385,7 +337,6 @@ The most often folder 1 = "Inbox", 2 = "Outbox",etc. Use \fI\%gammu getsmsfolder
.INDENT 0.0
.TP
.B \-unread
-.
makes message unread. In some phones (like 6210) you won\(aqt see
unread sms envelope after saving such sms. In some phones with internal
SMS memory (like 6210) after using it with folder 1 SIM SMS memory will be used
@@ -393,38 +344,32 @@ SMS memory (like 6210) after using it with folder 1 SIM SMS memory will be used
.INDENT 0.0
.TP
.B \-read
-.
makes message read. In some phones with internal
SMS memory (like 6210) after using it with folder 1 SIM SMS memory will be used
.UNINDENT
.INDENT 0.0
.TP
.B \-unsent
-.
makes message unsent
.UNINDENT
.INDENT 0.0
.TP
.B \-sent
-.
makes message sent
.UNINDENT
.INDENT 0.0
.TP
.B \-smsname name
-.sp
set message name
.UNINDENT
.INDENT 0.0
.TP
.B \-sender number
-.sp
set sender number (default: \fBGammu\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-maxsms num
-.sp
Limit maximal number of messages which will be
created. If there are more messages, Gammu will terminate with failure.
.UNINDENT
@@ -433,7 +378,6 @@ Types of messages:
.INDENT 0.0
.TP
.B ANIMATION frames file1 file2...
-.sp
Save an animation as a SMS. You need to give
number of frames and picture for each frame. Each picture can be in any
picture format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).
@@ -441,14 +385,12 @@ picture format which Gammu supports (B/W bmp, gif, wbmp, nol, nlm...).
.INDENT 0.0
.TP
.B BOOKMARK file location
-.sp
Read WAP bookmark from file created by \fI\%gammu backup\fP command and saves in
Nokia format as SMS
.UNINDENT
.INDENT 0.0
.TP
.B CALENDAR file location
-.sp
Read calendar note from file created by \fI\%gammu backup\fP command and saves in
VCALENDAR 1.0 format as SMS. The location identifies position of calendar item
to be read in backup file (usually 1, but can be useful in case the backup contains
@@ -457,11 +399,9 @@ more items).
.INDENT 0.0
.TP
.B CALLER file
-.sp
Save caller logo as sms in Nokia (Smart Messaging)
format \- size 72x14, two colors.
.IP Warning
-.
Please note, that it isn\(aqt designed for colour logos available for
example in DCT4/TIKU \- you need to put bitmap file there inside
phone using filesystem commands.
@@ -470,48 +410,40 @@ phone using filesystem commands.
.INDENT 0.0
.TP
.B EMS [\-unicode] [\-16bit] [\-format lcrasbiut] [\-text text] [\-unicodefiletext file] [\-defsound ID] [\-defanimation ID] [\-tone10 file] [\-tone10long file] [\-tone12 file] [\-tone12long file] [\-toneSE file] [\-toneSElong file] [\-fixedbitmap file] [\-variablebitmap file] [\-variablebitmaplong file] [\-animation frames file1 ...] [\-protected number]
-.sp
Saves EMS sequence. All format specific parameters (like \fI\%-defsound\fP) can be used few times.
.INDENT 7.0
.TP
.B \-text
-.
adds text
.UNINDENT
.INDENT 7.0
.TP
.B \-unicodefiletext
-.
adds text from Unicode file
.UNINDENT
.INDENT 7.0
.TP
.B \-defanimation
-.
adds default animation with ID specified by user. ID for different phones are different.
.UNINDENT
.INDENT 7.0
.TP
.B \-animation
-.
adds "frames" frames read from file1, file2, etc.
.UNINDENT
.INDENT 7.0
.TP
.B \-defsound
-.
adds default sound with ID specified by user. ID for different phones are different.
.UNINDENT
.INDENT 7.0
.TP
.B \-tone10
-.
adds IMelody version 1.0 read from RTTL or other compatible file
.UNINDENT
.INDENT 7.0
.TP
.B \-tone10long
-.
IMelody version 1.0 saved in one of few SMS with UPI. Phones
compatible with UPI (like Sony\-Ericsson phones) will read such
ringtone as one
@@ -519,13 +451,11 @@ ringtone as one
.INDENT 7.0
.TP
.B \-tone12
-.
adds IMelody version 1.2 read from RTTL or other compatible file
.UNINDENT
.INDENT 7.0
.TP
.B \-tone12long
-.
IMelody version 1.2 saved in one of few SMS with UPI. Phones
compatible with UPI (like Sony\-Ericsson phones) will read such
ringtone as one
@@ -533,37 +463,31 @@ ringtone as one
.INDENT 7.0
.TP
.B \-toneSE
-.
adds IMelody in "short" form supported by Sony\-Ericsson phones
.UNINDENT
.INDENT 7.0
.TP
.B \-toneSElong
-.
add Sony\-Ericsson IMelody saved in one or few SMS with UPI
.UNINDENT
.INDENT 7.0
.TP
.B \-variablebitmap
-.
bitmap in any size saved in one SMS
.UNINDENT
.INDENT 7.0
.TP
.B \-variablebitmaplong
-.
bitmap with maximal size 96x128 saved in one or few sms
.UNINDENT
.INDENT 7.0
.TP
.B \-fixedbitmap
-.
bitmap 16x16 or 32x32
.UNINDENT
.INDENT 7.0
.TP
.B \-protected
-.
all ringtones and bitmaps after this parameter (excluding default
ringtones and logos) will be "protected" (in phones compatible with
ODI like SonyEricsson products it won\(aqt be possible to forward them
@@ -572,14 +496,12 @@ from phone menu)
.INDENT 7.0
.TP
.B \-16bit
-.
Gammu uses SMS headers with 16\-bit numbers for saving linking info
in SMS (it means less chars available for user in each SMS)
.UNINDENT
.INDENT 7.0
.TP
.B \-format lcrasbiut
-.sp
last text will be formatted. You can use combinations of chars:
.TS
center;
@@ -651,7 +573,6 @@ _
.INDENT 0.0
.TP
.B MMSINDICATOR URL Title Sender
-.sp
Creates a MMS indication SMS. It contains URL where the actual MMS
payload is stored which needs to be SMIL encoded. The phone usually
downloads the MMS data using special APN, which does not count to
@@ -661,24 +582,20 @@ be accessed.
.INDENT 0.0
.TP
.B MMSSETTINGS file location
-.sp
Saves a message with MMS configuration. The
configuration will be read from Gammu backup file from given location.
.UNINDENT
.INDENT 0.0
.TP
.B OPERATOR file [\-netcode netcode] [\-biglogo]
-.sp
Save operator logo as sms in Nokia (Smart Messaging) format \- size
72x14 in two colors.
.INDENT 7.0
.TP
.B \-biglogo
-.
Use 78x21 formatted logo instead of standard 72x14.
.UNINDENT
.IP Note
-.
This isn\(aqt designed for colour logos available for example in newer
phones \- you need to put bitmap file there inside phone using
filesystem commands.
@@ -687,7 +604,6 @@ filesystem commands.
.INDENT 0.0
.TP
.B PICTURE file [\-text text] [\-unicode] [\-alcatelbmmi]
-.sp
Read bitmap from 2 colors file (bmp, nlm, nsl, ngg, nol, wbmp, etc.), format
into bitmap in Smart Messaging (72x28, 2 colors, called often Picture Image
and saved with text) or Alcatel format and send/save over SMS.
@@ -695,11 +611,9 @@ and saved with text) or Alcatel format and send/save over SMS.
.INDENT 0.0
.TP
.B PROFILE [\-name name] [\-bitmap bitmap] [\-ringtone ringtone]
-.sp
Read ringtone (RTTL) format, bitmap (Picture Image size) and name, format into
Smart Messaging profile and send/save as SMS.
.IP Warning
-.
Please note, that this format is abandoned by Nokia and supported
by some (older) devices only like Nokia 3310.
.RE
@@ -707,20 +621,17 @@ by some (older) devices only like Nokia 3310.
.INDENT 0.0
.TP
.B RINGTONE file [\-long] [\-scale]
-.sp
Read RTTL ringtone from file and save as SMS
into SIM/phone memory. Ringtone is saved in Nokia (Smart Messaging) format.
.INDENT 7.0
.TP
.B \-long
-.
ringtone is saved using Profile style. It can be longer (and saved
in 2 SMS), but decoded only by newer phones (like 33xx)
.UNINDENT
.INDENT 7.0
.TP
.B \-scale
-.
ringtone will have Scale info for each note. It will allow one to edit
it correctly later in phone composer (for example, in 33xx)
.UNINDENT
@@ -728,32 +639,27 @@ it correctly later in phone composer (for example, in 33xx)
.INDENT 0.0
.TP
.B SMSTEMPLATE [\-unicode] [\-text text] [\-unicodefiletext file] [\-defsound ID] [\-defanimation ID] [\-tone10 file] [\-tone10long file] [\-tone12 file] [\-tone12long file] [\-toneSE file] [\-toneSElong file] [\-variablebitmap file] [\-variablebitmaplong file] [\-animation frames file1 ...]
-.sp
Saves a SMS template (for Alcatel phones).
.UNINDENT
.INDENT 0.0
.TP
.B TEXT [\-inputunicode] [\-16bit] [\-flash] [\-len len] [\-autolen len] [\-unicode] [\-enablevoice] [\-disablevoice] [\-enablefax] [\-disablefax] [\-enableemail] [\-disableemail] [\-voidsms] [\-replacemessages ID] [\-replacefile file] [\-text msgtext] [\-textutf8 msgtext]
-.sp
Take text from stdin (or commandline if \-text
specified) and save as text SMS into SIM/phone memory.
.INDENT 7.0
.TP
.B \-flash
-.
Class 0 SMS (should be displayed after receiving on recipients\(aq phone display after receiving without entering Inbox)
.UNINDENT
.INDENT 7.0
.TP
.B \-len len
-.sp
specify, how many chars will be read. When use this option and text
will be longer than 1 SMS, will be split into more linked SMS
.UNINDENT
.INDENT 7.0
.TP
.B \-autolen len
-.sp
specify, how many chars will be read. When use this option and text
will be longer than 1 SMS, will be split into more linked
SMS.Coding type (SMS default alphabet/Unicode) is set according to
@@ -762,53 +668,44 @@ input text
.INDENT 7.0
.TP
.B \-enablevoice
-.
sms will set voice mail indicator. Text will be cut to 1 sms.
.UNINDENT
.INDENT 7.0
.TP
.B \-disablevoice
-.
sms will not set voice mail indicator. Text will be cut to 1 sms.
.UNINDENT
.INDENT 7.0
.TP
.B \-enablefax
-.
sms will set fax indicator. Text will be cut to 1 sms.
.UNINDENT
.INDENT 7.0
.TP
.B \-disablefax
-.
sms will not set fax indicator. Text will be cut to 1 sms.
.UNINDENT
.INDENT 7.0
.TP
.B \-enableemail
-.
sms will set email indicator. Text will be cut to 1 sms.
.UNINDENT
.INDENT 7.0
.TP
.B \-disableemail
-.
sms will not set email indicator. Text will be cut to 1 sms.
.UNINDENT
.INDENT 7.0
.TP
.B \-voidsms
-.
many phones after receiving it won\(aqt display anything, only beep,
vibrate or turn on light. Text will be cut to 1 sms.
.UNINDENT
.INDENT 7.0
.TP
.B \-unicode
-.
SMS will be saved in Unicode format
.IP Note
-.
The \fB~\fP char in SMS text and \fI\%-unicode\fP option
(Unicode coding required) can cause text of SMS after \fB~\fP
char blink in some phones (like Nokia 33xx).
@@ -817,10 +714,8 @@ char blink in some phones (like Nokia 33xx).
.INDENT 7.0
.TP
.B \-inputunicode
-.
input text is in Unicode.
.IP Note
-.
You can create Unicode file using WordPad in Windows (during
saving select "Unicode Text Document" format). In Unix can use
for example YUdit or vim.
@@ -829,16 +724,13 @@ for example YUdit or vim.
.INDENT 7.0
.TP
.B \-text
-.
get text from command line instead of stdin.
.UNINDENT
.INDENT 7.0
.TP
.B \-textutf8
-.
get text in UTF\-8 from command line instead of stdin.
.IP Note
-.
Gammu detects your locales and uses by default encoding based
on this. Use this option only when you know the input will be
in UTF\-8 in all cases.
@@ -847,14 +739,12 @@ in UTF\-8 in all cases.
.INDENT 7.0
.TP
.B \-16bit
-.
Gammu uses SMS headers with 16\-bit numbers for saving linking info
in SMS (it means less chars available for user in each SMS)
.UNINDENT
.INDENT 7.0
.TP
.B \-replacemessages ID
-.sp
\fBID\fP can be 1..7. When you will use option and send more single
SMS to one recipient with the same ID, each another SMS will
replace each previous with the same ID
@@ -862,7 +752,6 @@ replace each previous with the same ID
.INDENT 7.0
.TP
.B \-replacefile file
-.sp
File with replacement table in unicode (UCS\-2), preferably with
byte order mark (BOM). It contains pairs of chars, first one is to
replace, second is replacement one. The replacement is done after
@@ -882,14 +771,12 @@ ff fe 61 00 31 00
.INDENT 0.0
.TP
.B TODO file location
-.sp
Saves a message with a todo entry. The content will
be read from any backup format which Gammu supports and from given location.
.UNINDENT
.INDENT 0.0
.TP
.B VCARD10|VCARD21 file SM|ME location [\-nokia]
-.sp
Read phonebook entry from file created by \fI\%gammu backup\fP
command and saves in VCARD 1.0 (only name and default number) or VCARD
2.1 (all entry details with all numbers, text and name) format as SMS.
@@ -900,14 +787,12 @@ items).
.INDENT 0.0
.TP
.B WAPINDICATOR URL Title
-.sp
Saves a SMS with a WAP indication for given
URL and title.
.UNINDENT
.INDENT 0.0
.TP
.B WAPSETTINGS file location DATA|GPRS
-.sp
Read WAP settings from file created by \fI\%gammu backup\fP command
and saves in Nokia format as SMS
.UNINDENT
@@ -917,24 +802,20 @@ and saves in Nokia format as SMS
.INDENT 0.0
.TP
.B sendsms TYPE destination [type parameters] [type options] [\-smscset number] [\-smscnumber number] [\-reply] [\-report] [\-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX] [\-save [\-folder number]]
-.sp
Sends a message to a \fBdestination\fP number, most parameters are same as for \fI\%gammu savesms\fP.
.INDENT 7.0
.TP
.B \-save
-.
will also save message which is being sent
.UNINDENT
.INDENT 7.0
.TP
.B \-report
-.
request delivery report for message
.UNINDENT
.INDENT 7.0
.TP
.B \-validity HOUR|6HOURS|DAY|3DAYS|WEEK|MAX
-.sp
sets how long will be the
message valid (SMSC will the discard the message after this time if it could
not deliver it).
@@ -943,7 +824,6 @@ not deliver it).
.INDENT 0.0
.TP
.B setsmsc location number
-.sp
Set SMSC settings on SIM card. This keeps all SMSC configuration
intact, it just changes the SMSC number.
.sp
@@ -956,46 +836,36 @@ Gammu recognizes following memory types:
.INDENT 0.0
.TP
.B \fBDC\fP
-.sp
Dialled calls
.TP
.B \fBMC\fP
-.sp
Missed calls
.TP
.B \fBRC\fP
-.sp
Received calls
.TP
.B \fBON\fP
-.sp
Own numbers
.TP
.B \fBVM\fP
-.sp
voice mailbox
.TP
.B \fBSM\fP
-.sp
SIM phonebook
.TP
.B \fBME\fP
-.sp
phone internal phonebook
.TP
.B \fBFD\fP
-.sp
fixed dialling
.TP
.B \fBSL\fP
-.sp
sent SMS log
.UNINDENT
.SS Memory commands
.INDENT 0.0
.TP
.B deleteallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
-.sp
Deletes all entries from specified memory type.
.sp
For memory types description see \fI\%Memory types\fP.
@@ -1003,7 +873,6 @@ For memory types description see \fI\%Memory types\fP.
.INDENT 0.0
.TP
.B deletememory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop]
-.sp
Deletes entries in specified range from specified memory type.
.sp
For memory types description see \fI\%Memory types\fP.
@@ -1011,7 +880,6 @@ For memory types description see \fI\%Memory types\fP.
.INDENT 0.0
.TP
.B getallmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL
-.sp
Get all memory locations from phone.
.sp
For memory types description see \fI\%Memory types\fP.
@@ -1019,7 +887,6 @@ For memory types description see \fI\%Memory types\fP.
.INDENT 0.0
.TP
.B getmemory DC|MC|RC|ON|VM|SM|ME|MT|FD|SL start [stop [\-nonempty]]
-.sp
Get memory location from phone.
.sp
For memory types description see \fI\%Memory types\fP.
@@ -1029,13 +896,11 @@ Locations are numerated from 1.
.INDENT 0.0
.TP
.B getspeeddial start [stop]
-.sp
Gets speed dial choices.
.UNINDENT
.INDENT 0.0
.TP
.B searchmemory text
-.sp
Scans all memory entries for given text. It performs
case insensitive substring lookup. You can interrupt searching by pressing
\fBCtrl+C\fP.
@@ -1048,86 +913,72 @@ level and Gammu does not use that.
.INDENT 0.0
.TP
.B addfile folderID name [\-type JAR|BMP|PNG|GIF|JPG|MIDI|WBMP|AMR|3GP|NRT] [\-readonly] [\-protected] [\-system] [\-hidden] [\-newtime]
-.sp
Add file with specified name to folder with specified folder ID.
.INDENT 7.0
.TP
.B \-type
-.
File type was required for filesystem 1 in Nokia phones (current filesystem 2 doesn\(aqt need this).
.UNINDENT
.INDENT 7.0
.TP
.B \-readonly
-.
Sets the read only attribute.
.UNINDENT
.INDENT 7.0
.TP
.B \-protected
-.
Sets the protected attribute (file can\(aqt be for example forwarded
from phone menu).
.UNINDENT
.INDENT 7.0
.TP
.B \-system
-.
Sets the system attribute.
.UNINDENT
.INDENT 7.0
.TP
.B \-hidden
-.
Sets the hidden attribute (file is hidden from phone menu).
.UNINDENT
.INDENT 7.0
.TP
.B \-newtime
-.
After using it date/time of file modification will be set to moment of uploading.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B addfolder parentfolderID name
-.sp
Create a folder in phone with specified name in a
folder with specified folder ID.
.UNINDENT
.INDENT 0.0
.TP
.B deletefiles fileID
-.sp
Delete files with given IDs.
.UNINDENT
.INDENT 0.0
.TP
.B deletefolder name
-.sp
Delete folder with given ID.
.UNINDENT
.INDENT 0.0
.TP
.B getfilefolder fileID, fileID, ...
-.sp
Retrieve files or all files from folder with given IDs from a phone filesytem.
.UNINDENT
.INDENT 0.0
.TP
.B getfiles fileID, fileID, ...
-.sp
Retrieve files with given IDs from a phone filesytem.
.UNINDENT
.INDENT 0.0
.TP
.B getfilesystem [\-flatall|\-flat]
-.sp
Display info about all folders and files in phone memory/memory card. By default there is tree displayed, you can change it:
.INDENT 7.0
.TP
.B \-flatall
-.
there are displayed full file/folder details like ID (first parameter in line)
.UNINDENT
.INDENT 7.0
@@ -1135,24 +986,20 @@ there are displayed full file/folder details like ID (first parameter in line)
.B \-flat
.UNINDENT
.IP Note
-.
In some phones (like N6230) content of some folders (with more files) can be cut (only part of files will be displayed) for example on infrared connection. This is not Gammu issue, but phone firmware problem.
.RE
.UNINDENT
.INDENT 0.0
.TP
.B getfilesystemstatus
-.
Display info filesystem status \- number of
bytes available, used or used by some specific content.
.UNINDENT
.INDENT 0.0
.TP
.B getfolderlisting folderID
-.sp
Display files and folders available in folder with given folder ID. You can get ID\(aqs using getfilesystem \-flatall.
.IP Warning
-.
Please note, that in some phones (like N6230) content of some folders
(with more files) can be cut (only part of files will be displayed) for
example on infrared connection. This is not Gammu issue, but phone
@@ -1162,13 +1009,11 @@ firmware problem.
.INDENT 0.0
.TP
.B getrootfolders
-.
Display info about drives available in phone/memory card.
.UNINDENT
.INDENT 0.0
.TP
.B sendfile name
-.sp
Sends file to a phone. It\(aqs up to phone to decide where
to store this file and how to handle it (for example when you send vCard or
vCalendar, most of phones will offer you to import it.
@@ -1187,7 +1032,6 @@ In new models all bitmaps are saved in filesystem and should go into filesystem
.INDENT 0.0
.TP
.B copybitmap inputfile [outputfile [OPERATOR|PICTURE|STARTUP|CALLER]]
-.sp
Allow one to convert logos files to another. When give ONLY inputfile, output will
be written to stdout using ASCII art. When give output file and format, in
some file formats (like NLM) will be set indicator informing about logo type
@@ -1196,18 +1040,15 @@ to given.
.INDENT 0.0
.TP
.B getbitmap TYPE [type options]
-.sp
Reads bitmap from phone, following types are supported:
.INDENT 7.0
.TP
.B CALLER location [file]
-.sp
Get caller group logo from phone. Locations 1\-5.
.UNINDENT
.INDENT 7.0
.TP
.B DEALER
-.
In some models it\(aqs possible to save dealer welcome note \- text displayed
during enabling phone, which can\(aqt be edited from phone menu. Here you can
get it.
@@ -1215,43 +1056,36 @@ get it.
.INDENT 7.0
.TP
.B OPERATOR [file]
-.sp
Get operator logo (picture displayed instead of operator name) from phone.
.UNINDENT
.INDENT 7.0
.TP
.B PICTURE location [file]
-.sp
Get Picture Image from phone.
.UNINDENT
.INDENT 7.0
.TP
.B STARTUP [file]
-.sp
Get static startup logo from phone. Allow one to save it in file.
.UNINDENT
.INDENT 7.0
.TP
.B TEXT
-.
Get startup text from phone.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B setbitmap TYPE [type options]
-.sp
Sets bitmap in phone, following types are supported:
.INDENT 7.0
.TP
.B CALLER location [file]
-.sp
Set caller logo.
.UNINDENT
.INDENT 7.0
.TP
.B COLOUROPERATOR [fileID [netcode]]
-.sp
Sets color operator logo in phone.
.UNINDENT
.INDENT 7.0
@@ -1261,13 +1095,11 @@ Sets color operator logo in phone.
.INDENT 7.0
.TP
.B DEALER text
-.sp
Sets welcome message configured by dealer, which usually can not be changed in phone menus.
.UNINDENT
.INDENT 7.0
.TP
.B OPERATOR [file [netcode]]
-.sp
Set operator logo in phone. When won\(aqt give file and netcode, operator logo
will be removed from phone. When will give only filename, operator logo will
be displayed for your current GSM operator. When you give additionally network
@@ -1276,13 +1108,11 @@ code, it will be displayed for this operator.
.INDENT 7.0
.TP
.B PICTURE file location [text]
-.sp
Sets picture image in phone.
.UNINDENT
.INDENT 7.0
.TP
.B STARTUP file|1|2|3
-.sp
Set startup logo in phone. It can be static (then you will have to give file
name) or one of predefined animated (only some phones like Nokia 3310 or 3330
supports it, use location 1, 2 or 3 for these).
@@ -1290,13 +1120,11 @@ supports it, use location 1, 2 or 3 for these).
.INDENT 7.0
.TP
.B TEXT text
-.sp
Sets startup text in phone.
.UNINDENT
.INDENT 7.0
.TP
.B WALLPAPER fileID
-.sp
Sets wallpaper in phone.
.UNINDENT
.UNINDENT
@@ -1312,19 +1140,16 @@ Samsung).
.INDENT 0.0
.TP
.B copyringtone source destination [RTTL|BINARY]
-.sp
Copy source ringtone to destination.
.UNINDENT
.INDENT 0.0
.TP
.B getphoneringtone location [file]
-.sp
Get one of "default" ringtones and saves into file
.UNINDENT
.INDENT 0.0
.TP
.B getringtone location [file]
-.sp
Get ringtone from phone in RTTL or BINARY format.
.sp
Locations are numerated from 1.
@@ -1336,32 +1161,27 @@ Locations are numerated from 1.
.INDENT 0.0
.TP
.B playringtone file
-.sp
Play aproximation of ringtone over phone buzzer. File can be in RTTL or BINARY (Nokia DCT3) format.
.UNINDENT
.INDENT 0.0
.TP
.B playsavedringtone number
-.sp
Play one of built\-in ringtones. This option is available for DCT4 phones.
For getting ringtones list use \fI\%gammu getringtoneslist\fP.
.UNINDENT
.INDENT 0.0
.TP
.B setringtone file [\-location location] [\-scale] [\-name name]
-.sp
Set ringtone in phone. When don\(aqt give location, it will be written
"with preview" (in phones supporting this feature like 61xx or 6210).
.INDENT 7.0
.TP
.B \-scale
-.
Scale information will be added to each note of RTTL ringtone. It will
avoid scale problems available during editing ringtone in composer
from phone menu (for example, in Nokia 33xx).
.UNINDENT
.IP Note
-.
When use \fB~\fP char in ringtone name, in some phones (like 33xx) name
will blink later in phone menus.
.RE
@@ -1372,48 +1192,40 @@ In Nokia 3310, 3315 and 3330 these are named "Reminders" and have some limitatio
.INDENT 0.0
.TP
.B deletecalendar start [stop]
-.sp
Deletes selected calendar entries in phone.
.UNINDENT
.INDENT 0.0
.TP
.B getallcalendar
-.
Retrieves all calendar entries from phone.
.UNINDENT
.INDENT 0.0
.TP
.B getcalendar start [stop]
-.sp
Retrieves selected calendar entries from phone.
.UNINDENT
.SS To do list commands
.INDENT 0.0
.TP
.B deletetodo start [stop]
-.sp
Deletes selected todo entries in phone.
.UNINDENT
.INDENT 0.0
.TP
.B getalltodo
-.
Retrieves all todo entries from phone.
.UNINDENT
.INDENT 0.0
.TP
.B gettodo start [stop]
-.sp
Retrieves selected todo entries from phone.
.UNINDENT
.SS Notes commands
.INDENT 0.0
.TP
.B getallnotes
-.
Reads all notes from the phone.
.IP Note
-.
Not all phones supports this function, especially most Sony Ericsson
phones even if they have notes inside phone.
.RE
@@ -1422,38 +1234,32 @@ phones even if they have notes inside phone.
.INDENT 0.0
.TP
.B getalarm [start]
-.sp
Get alarm from phone, if no location is specified,
1 is used.
.UNINDENT
.INDENT 0.0
.TP
.B getdatetime
-.
Get date and time from phone
.UNINDENT
.INDENT 0.0
.TP
.B setalarm hour minute
-.sp
Sets repeating alarm in phone on selected time.
.UNINDENT
.INDENT 0.0
.TP
.B setdatetime [HH:MM[:SS]] [YYYY/MM/DD]
-.sp
Set date and time in phone to date and time set in computer. Please
note, that this option doesn\(aqt show clock on phone screen. It only set
date and time.
.IP Note
-.
You can make such synchronization each time, when will connect your
phone and use Gammu. See \fBSynchronizeTime\fP in \fIgammurc\fP for details.
.RE
.UNINDENT
.SS Categories commands
.IP Note
-.
Categories are supported only on few phones (Alcatel).
.RE
.INDENT 0.0
@@ -1480,7 +1286,6 @@ Categories are supported only on few phones (Alcatel).
.INDENT 0.0
.TP
.B addnew file [\-yes] [\-memory ME|SM|..]
-.sp
Adds data written in file created using \fI\%gammu backup\fP command. All things
backed up \fI\%gammu backup\fP can be restored (when made backup to Gammu text
file).
@@ -1498,42 +1303,31 @@ regardless what backu format says.
.INDENT 0.0
.TP
.B addsms folder file [\-yes]
-.sp
Adds SMSes from file (format like \fI\%gammu backupsms\fP uses) to
selected folder in phone.
.UNINDENT
.INDENT 0.0
.TP
.B backup file [\-yes]
-.sp
Backup your phone to file. It\(aqs possible to backup (depends on phone and backup format):
.INDENT 7.0
.IP \(bu 2
-.
phonebook from SIM and phone memory
.IP \(bu 2
-.
calendar notes
.IP \(bu 2
-.
SMSC settings
.IP \(bu 2
-.
operator logo
.IP \(bu 2
-.
startup (static) logo or startup text
.IP \(bu 2
-.
WAP bookmarks
.IP \(bu 2
-.
WAP settings
.IP \(bu 2
-.
caller logos and groups
.IP \(bu 2
-.
user ringtones
.UNINDENT
.sp
@@ -1541,29 +1335,22 @@ There are various backup formats supported and the backup format is guessed
based on file extension:
.INDENT 7.0
.IP \(bu 2
-.
\fB.lmb\fP \- Nokia backup, supports contacts, caller logos and startup logo.
.IP \(bu 2
-.
\fB.vcs\fP \- vCalendar, supports calendar and todo.
.IP \(bu 2
-.
\fB.vcf\fP \- vCard, supports contacts.
.IP \(bu 2
-.
\fB.ldif\fP \- LDAP import, supports contacts.
.IP \(bu 2
-.
\fB.ics\fP \- iCalendar, supports calendar and todo.
.IP \(bu 2
-.
Any other extension is Gammu backup file and it supports all data mentioned above, see \fIgammu\-backup\fP for more details.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B backupsms file [\-yes|\-all]
-.sp
Stores all SMSes from phone to file into \fIgammu\-smsbackup\fP.
.sp
Use \-yes for answering yes to all questions (backup all messages and
@@ -1574,7 +1361,6 @@ messages in phone.
.TP
.B restore file [\-yes]
.IP Warning
-.
Please note that restoring deletes all current content in phone. If you
want only to add entries to phone, use \fI\%gammu addnew\fP.
.RE
@@ -1588,7 +1374,6 @@ be done, when phone doesn\(aqt have set clock inside.
.TP
.B restoresms file [\-yes]
.IP Warning
-.
Please note that this overwrites existing messages in phone (if it supports it).
.RE
.sp
@@ -1598,20 +1383,17 @@ selected folder in phone.
.INDENT 0.0
.TP
.B savefile TYPE [type options]
-.sp
Converts between various file formats supported by Gammu, following types
are supported:
.INDENT 7.0
.TP
.B BOOKMARK target.url file location
-.sp
Converts backup format supported by
Gammu to vBookmark file.
.UNINDENT
.INDENT 7.0
.TP
.B CALENDAR target.vcs file location
-.sp
Allows one to convert between various backup formats which gammu
supports for calendar events. The file type is guessed (for input file
guess is based on extension and file content, for output solely on
@@ -1620,7 +1402,6 @@ extension).
.INDENT 7.0
.TP
.B TODO target.vcs file location
-.sp
Allows one to convert between various backup formats which gammu
supports for todo events. The file type is guessed (for input file
guess is based on extension and file content, for output solely on
@@ -1629,7 +1410,6 @@ extension).
.INDENT 7.0
.TP
.B VCARD10|VCARD21 target.vcf file SM|ME location
-.sp
Allows one to convert between various backup formats which gammu
supports for phonebook events. The file type is guessed (for input file
guess is based on extension and file content, for output solely on
@@ -1643,7 +1423,6 @@ extension).
.INDENT 0.0
.TP
.B convertbackup source.file output.file
-.sp
New in version 1.28.94.
.sp
Converts backup between formats supported by Gammu. Unlike
@@ -1658,26 +1437,22 @@ convert, it simply takes converts all what can be saved into output file.
.INDENT 0.0
.TP
.B nokiaaddfile TYPE [type options]
-.sp
Uploads file to phone to specific location for the type:
.INDENT 7.0
.TP
.B APPLICATION|GAME file [\-readonly] [\-overwrite] [\-overwriteall]
-.sp
Install the \fB*.jar/*.jad\fP file pair of a midlet in the application or
game menu of the phone. You need to specify filename without the jar/jad
suffix, both will be added automatically.
.INDENT 7.0
.TP
.B \-overwrite
-.
Delete the application\(aqs .jad and .jar files before installing, but
doesn\(aqt delete the application data.
.UNINDENT
.INDENT 7.0
.TP
.B \-overwriteall
-.
Delete the application (same as \fI\%-overwrite\fP) and all it\(aqs
data.
.UNINDENT
@@ -1692,7 +1467,6 @@ You can use \fIjadmaker\fP to generate a .jad file from a .jar file.
.INDENT 0.0
.TP
.B nokiaaddplaylists
-.
Goes through phone memory and generated playlist for all music files found.
.sp
To manually manage playlists:
@@ -1730,7 +1504,6 @@ just run \fBunix2dos\fP on the resulting file before uploading it your your phon
.INDENT 0.0
.TP
.B nokiacomposer file
-.sp
Show, how to enter RTTL ringtone in composer existing in many Nokia phones
(and how should it look like).
.UNINDENT
@@ -1753,7 +1526,6 @@ Show, how to enter RTTL ringtone in composer existing in many Nokia phones
.INDENT 0.0
.TP
.B nokiagetoperatorname
-.
6110.c phones have place for name for one GSM network (of course, with flashing it\(aqs
possible to change all names, but Gammu is not flasher ;\-)). You can get this
name using this option.
@@ -1765,14 +1537,12 @@ name using this option.
.INDENT 0.0
.TP
.B nokiagett9
-.
This option should display T9 dictionary content from
DCT4 phones.
.UNINDENT
.INDENT 0.0
.TP
.B nokiagetvoicerecord location
-.sp
Get voice record from location and save to WAV file. File is
coded using GSM 6.10 codec (available for example in win32). Name
of file is like name of voice record in phone.
@@ -1782,37 +1552,26 @@ by Microsoft. If you deleted it by accident in this operating system, make such
steps:
.INDENT 7.0
.IP 1. 4
-.
Control Panel
.IP 2. 4
-.
Add hardware
.IP 3. 4
-.
click Next
.IP 4. 4
-.
select "Yes. I have already connected the hardware
.IP 5. 4
-.
select "Add a new hardware device
.IP 6. 4
-.
select "Install the hardware that I manually select from a list
.IP 7. 4
-.
select "Sound, video and game controllers
.IP 8. 4
-.
select "Audio codecs
.IP 9. 4
-.
select "windows\esystem32" directory and file "mmdriver.inf
.IP 10. 4
-.
if You will be asked for file msgsm32.acm, it should unpacked from Windows CD
.IP 11. 4
-.
now You can be asked if want to install unsigned driver (YES), about select codec configuration (select what you want) and rebotting PC (make it)
.UNINDENT
.UNINDENT
@@ -1823,7 +1582,6 @@ now You can be asked if want to install unsigned driver (YES), about select code
.INDENT 0.0
.TP
.B nokianetmonitor test
-.sp
Takes output or set netmonitor for Nokia DCT3 phones.
.IP "See also"
.sp
@@ -1832,7 +1590,6 @@ For more info about this option, please visit
there.
.RE
.IP Note
-.
test \fB243\fP enables all tests (after using command
\fBgammu nokianetmonitor 243\fP in some phones like 6210 or 9210 have to reboot
them to see netmonitor menu)
@@ -1841,7 +1598,6 @@ them to see netmonitor menu)
.INDENT 0.0
.TP
.B nokianetmonitor36
-.
Reset counters from netmonitor test 36 in Nokia DCT3 phones.
.IP "See also"
.sp
@@ -1853,16 +1609,13 @@ there.
.INDENT 0.0
.TP
.B nokiasecuritycode
-.
Get/reset to "12345" security code
.UNINDENT
.INDENT 0.0
.TP
.B nokiaselftests
-.
Perform tests for Nokia DCT3 phones.
.IP Note
-.
EEPROM test can show an error when your phone has an EEPROM in flash
(like 82xx/7110/62xx/33xx). The clock test will show an error when the
phone doesn?t have an internal battery for the clock (like 3xxx).
@@ -1879,49 +1632,37 @@ phone doesn?t have an internal battery for the clock (like 3xxx).
.INDENT 0.0
.TP
.B nokiasetphonemenus
-.
Enable all (?) possible menus for DCT3 Nokia phones:
.INDENT 7.0
.IP 1. 3
-.
ALS (Alternative Line Service) option menu
.IP 2. 3
-.
vibra menu for 3210
.IP 3. 3
-.
3315 features in 3310 5.45 and higher
.IP 4. 3
-.
two additional games (React and Logic) for 3210 5.31 and higher
.IP 5. 3
-.
WellMate menu for 6150
.IP 6. 3
-.
NetMonitor
.UNINDENT
.sp
and for DCT4:
.INDENT 7.0
.IP 1. 3
-.
ALS (Alternative Line Service) option menu
.IP 2. 3
-.
Bluetooth, WAP bookmarks and settings menu, ... (6310i)
.IP 3. 3
-.
GPRS Always Online
.IP 4. 3
-.
and others...
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B nokiasetvibralevel level
-.sp
Set vibra power to "level" (given in percent)
.UNINDENT
.INDENT 0.0
@@ -1936,7 +1677,6 @@ Set vibra power to "level" (given in percent)
.INDENT 0.0
.TP
.B siemensnetmonact netmon_type
-.sp
Enables network monitor in Siemens phone. Currently known values for type
are 1 for full and 2 for simple mode.
.UNINDENT
@@ -1956,13 +1696,11 @@ are 1 for full and 2 for simple mode.
.INDENT 0.0
.TP
.B listnetworks [country]
-.sp
Show names/codes of GSM networks known for Gammu
.UNINDENT
.INDENT 0.0
.TP
.B networkinfo
-.
Show information about network status from the phone.
.UNINDENT
.INDENT 0.0
@@ -1973,7 +1711,6 @@ Show information about network status from the phone.
.INDENT 0.0
.TP
.B deletewapbookmark start [stop]
-.sp
Delete WAP bookmarks from phone.
.sp
Locations are numerated from 1.
@@ -1989,7 +1726,6 @@ Locations are numerated from 1.
.INDENT 0.0
.TP
.B getwapbookmark start [stop]
-.sp
Get WAP bookmarks from phone.
.sp
Locations are numerated from 1.
@@ -1997,7 +1733,6 @@ Locations are numerated from 1.
.INDENT 0.0
.TP
.B getwapsettings start [stop]
-.sp
Get WAP settings from phone.
.sp
Locations are numerated from 1.
@@ -2027,14 +1762,12 @@ Locations are numerated from 1.
.INDENT 0.0
.TP
.B getfmstation start [stop]
-.sp
Show info about FM stations in phone
.UNINDENT
.SS Phone information commands
.INDENT 0.0
.TP
.B battery
-.
Displays information about battery and power source.
.UNINDENT
.INDENT 0.0
@@ -2044,7 +1777,6 @@ Displays information about battery and power source.
.INDENT 0.0
.TP
.B getlocation
-.
Gets network information from phone (same as networkinfo)
and prints location (latitude and longitude) based on information from
\fI\%OpenCellID\fP.
@@ -2052,19 +1784,16 @@ and prints location (latitude and longitude) based on information from
.INDENT 0.0
.TP
.B getsecuritystatus
-.
Show, if phone wait for security code (like PIN, PUK, etc.) or not
.UNINDENT
.INDENT 0.0
.TP
.B identify
-.
Show the most important phone data.
.UNINDENT
.INDENT 0.0
.TP
.B monitor [times]
-.sp
Retrieves phone status and writes it continuously to standard output. Press
\fBCtrl+C\fP to interrupt this command.
.sp
@@ -2074,19 +1803,14 @@ only given number of iterations is performed.
This command outputs almost all information Gammu supports:
.INDENT 7.0
.IP \(bu 2
-.
Number of contacts, calendar and todo entries, messages, calls, etc.
.IP \(bu 2
-.
Signal strength.
.IP \(bu 2
-.
Battery state.
.IP \(bu 2
-.
Currently used network.
.IP \(bu 2
-.
Notifications of incoming messages and calls.
.UNINDENT
.UNINDENT
@@ -2094,7 +1818,6 @@ Notifications of incoming messages and calls.
.INDENT 0.0
.TP
.B getcalendarsettings
-.
Displays calendar settings like first day of
week or automatic deleting of old entries.
.UNINDENT
@@ -2106,7 +1829,6 @@ week or automatic deleting of old entries.
.TP
.B resetphonesettings PHONE|DEV|UIF|ALL|FACTORY
.IP Warning
-.
This will delete user data, be careful.
.RE
.sp
@@ -2114,85 +1836,66 @@ Reset phone settings.
.INDENT 7.0
.TP
.B \fBPHONE\fP
-.sp
Clear phone settings.
.TP
.B \fBDEV\fP
-.sp
Clear device settings.
.TP
.B \fBALL\fP
-.sp
Clear user settings.
.INDENT 7.0
.IP \(bu 2
-.
removes or set logos to default
.IP \(bu 2
-.
set default phonebook and other menu settings
.IP \(bu 2
-.
clear T9 words,
.IP \(bu 2
-.
clear call register info
.IP \(bu 2
-.
set default profiles settings
.IP \(bu 2
-.
clear user ringtones
.UNINDENT
.TP
.B \fBUIF\fP
-.sp
Clear user settings and disables hidden menus.
.INDENT 7.0
.IP \(bu 2
-.
changes like after \fBALL\fP
.IP \(bu 2
-.
disables netmon and PPS (all "hidden" menus)
.UNINDENT
.TP
.B \fBFACTORY\fP
-.sp
Reset to factory defaults.
.INDENT 7.0
.IP \(bu 2
-.
changes like after \fBUIF\fP
.IP \(bu 2
-.
clear date/time
.UNINDENT
.UNINDENT
.UNINDENT
.SS Dumps decoding commands
.IP Note
-.
These commands are available only if Gammu was compiled with debugging options.
.RE
.INDENT 0.0
.TP
.B decodebinarydump file [phonemodel]
-.sp
Decodes a dump made by Gammu with
\fBLogFormat\fP set to \fBbinary\fP.
.UNINDENT
.INDENT 0.0
.TP
.B decodesniff MBUS2|IRDA file [phonemodel]
-.sp
Allows one to decode sniffs. See \fIDiscovering protocol\fP for more details.
.UNINDENT
.SS Other commands
.INDENT 0.0
.TP
.B entersecuritycode PIN|PUK|PIN2|PUK2|PHONE|NETWORK code|\- [newpin|\-]
-.sp
Allow one to enter security code from PC. When code is \fB\-\fP, it is read from stdin.
.sp
In case entering PUK, some phones require you to set new PIN as well.
@@ -2200,75 +1903,59 @@ In case entering PUK, some phones require you to set new PIN as well.
.INDENT 0.0
.TP
.B presskeysequence mMnNpPuUdD+\-123456789*0#gGrR<>[]hHcCjJfFoOmMdD@
-.sp
Press specified key sequence on phone keyboard
.INDENT 7.0
.TP
.B \fBmM\fP
-.sp
Menu
.TP
.B \fBnN\fP
-.sp
Names key
.TP
.B \fBpP\fP
-.sp
Power
.TP
.B \fBuU\fP
-.sp
Up
.TP
.B \fBdD\fP
-.sp
Down
.TP
.B \fB+\-\fP
-.sp
+\-
.TP
.B \fBgG\fP
-.sp
Green
.TP
.B \fBrR\fP
-.sp
Red
.TP
.B \fB123456789*0#\fP
-.sp
numeric keyboard
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B reset SOFT|HARD
-.sp
Make phone reset:
.INDENT 7.0
.TP
.B \fBSOFT\fP
-.sp
without asking for PIN
.TP
.B \fBHARD\fP
-.sp
with asking for PIN
.UNINDENT
.IP Note
-.
Some phones will ask for PIN even with \fBSOFT\fP option.
.RE
.IP Warning
-.
Some phones will reset user data on \fBHARD\fP reset.
.RE
.UNINDENT
.INDENT 0.0
.TP
.B screenshot filename
-.sp
Captures phone screenshot and saves it as filename. The extension is
automatically appended to filename based on what data phone provides.
.UNINDENT
@@ -2276,7 +1963,6 @@ automatically appended to filename based on what data phone provides.
.INDENT 0.0
.TP
.B batch [file]
-.sp
Starts Gammu in a batch mode. In this mode you can issue
several commands each on one line. Lines starting with # are treated as a
comments.
@@ -2289,10 +1975,8 @@ input).
.INDENT 0.0
.TP
.B searchphone [\-debug]
-.sp
Attempts to search for a connected phone.
.IP Warning
-.
Please note that this can take a very long time, but in case you have
no clue how to configure phone connection, this is a convenient way to
find working setup for Gammu.
@@ -2301,7 +1985,6 @@ find working setup for Gammu.
.INDENT 0.0
.TP
.B install
-.
Installs applet for currently configured connection to the phone.
.sp
You can configure search path for instllation files by
@@ -2311,7 +1994,6 @@ You can configure search path for instllation files by
.INDENT 0.0
.TP
.B checkversion [STABLE]
-.sp
Checks whether there is newer Gammu version
available online (if Gammu has been compiled with CURL). If you pass
additional parameter \fBSTABLE\fP, only stable versions will be checked.
@@ -2319,20 +2001,17 @@ additional parameter \fBSTABLE\fP, only stable versions will be checked.
.INDENT 0.0
.TP
.B features
-.
Print information about compiled in features.
.UNINDENT
.INDENT 0.0
.TP
.B help [topic]
-.sp
Print help. By default general help is printed, but you can
also specify a help category to get more detailed help on some topic.
.UNINDENT
.INDENT 0.0
.TP
.B version
-.
Print version information and license.
.UNINDENT
.SH RETURN VALUES
@@ -2342,27 +2021,21 @@ returned.
.INDENT 0.0
.TP
.B 1
-.
Out of memory or other critical error.
.TP
.B 2
-.
Invalid command line parameters.
.TP
.B 3
-.
Failed to open file specified on command line.
.TP
.B 4
-.
Program was interrupted.
.TP
.B 98
-.
Gammu library version mismatch.
.TP
.B 99
-.
Functionality has been moved. For example to \fIgammu\-smsd\fP.
.UNINDENT
.sp
@@ -2371,280 +2044,220 @@ values increased by 100:
.INDENT 0.0
.TP
.B 101
-.
No error.
.TP
.B 102
-.
Error opening device. Unknown, busy or no permissions.
.TP
.B 103
-.
Error opening device, it is locked.
.TP
.B 104
-.
Error opening device, it doesn\(aqt exist.
.TP
.B 105
-.
Error opening device, it is already opened by other application.
.TP
.B 106
-.
Error opening device, you don\(aqt have permissions.
.TP
.B 107
-.
Error opening device. No required driver in operating system.
.TP
.B 108
-.
Error opening device. Some hardware not connected/wrongly configured.
.TP
.B 109
-.
Error setting device DTR or RTS.
.TP
.B 110
-.
Error setting device speed. Maybe speed not supported.
.TP
.B 111
-.
Error writing to the device.
.TP
.B 112
-.
Error during reading from the device.
.TP
.B 113
-.
Can\(aqt set parity on the device.
.TP
.B 114
-.
No response in specified timeout. Probably phone not connected.
.TP
.B 115
-.
Frame not requested right now. See <\fI\%http://wammu.eu/support/bugs/\fP> for information how to report it.
.TP
.B 116
-.
Unknown response from phone. See <\fI\%http://wammu.eu/support/bugs/\fP> for information how to report it.
.TP
.B 117
-.
Unknown frame. See <\fI\%http://wammu.eu/support/bugs/\fP> for information how to report it.
.TP
.B 118
-.
Unknown connection type string. Check config file.
.TP
.B 119
-.
Unknown model type string. Check config file.
.TP
.B 120
-.
Some functions not available for your system (disabled in config or not implemented).
.TP
.B 121
-.
Function not supported by phone.
.TP
.B 122
-.
Entry is empty.
.TP
.B 123
-.
Security error. Maybe no PIN?
.TP
.B 124
-.
Invalid location. Maybe too high?
.TP
.B 125
-.
Functionality not implemented. You are welcome to help authors with it.
.TP
.B 126
-.
Memory full.
.TP
.B 127
-.
Unknown error.
.TP
.B 128
-.
Can not open specified file.
.TP
.B 129
-.
More memory required...
.TP
.B 130
-.
Operation not allowed by phone.
.TP
.B 131
-.
No SMSC number given. Provide it manually or use the one configured in phone.
.TP
.B 132
-.
You\(aqre inside phone menu (maybe editing?). Leave it and try again.
.TP
.B 133
-.
Phone is not connected.
.TP
.B 134
-.
Function is currently being implemented. If you want to help, please contact authors.
.TP
.B 135
-.
Phone is disabled and connected to charger.
.TP
.B 136
-.
File format not supported by Gammu.
.TP
.B 137
-.
Nobody is perfect, some bug appeared in protocol implementation. Please contact authors.
.TP
.B 138
-.
Transfer was canceled by phone, maybe you pressed cancel on phone.
.TP
.B 139
-.
Phone module need to send another answer frame.
.TP
.B 140
-.
Current connection type doesn\(aqt support called function.
.TP
.B 141
-.
CRC error.
.TP
.B 142
-.
Invalid date or time specified.
.TP
.B 143
-.
Phone memory error, maybe it is read only.
.TP
.B 144
-.
Invalid data given to phone.
.TP
.B 145
-.
File with specified name already exists.
.TP
.B 146
-.
File with specified name doesn\(aqt exist.
.TP
.B 147
-.
You have to give folder name and not file name.
.TP
.B 148
-.
You have to give file name and not folder name.
.TP
.B 149
-.
Can not access SIM card.
.TP
.B 150
-.
Wrong GNAPPLET version in phone. Use version from currently used Gammu.
.TP
.B 151
-.
Only part of folder has been listed.
.TP
.B 152
-.
Folder must be empty.
.TP
.B 153
-.
Data were converted.
.TP
.B 154
-.
Gammu is not configured.
.TP
.B 155
-.
Wrong folder used.
.TP
.B 156
-.
Internal phone error.
.TP
.B 157
-.
Error writing file to disk.
.TP
.B 158
-.
No such section exists.
.TP
.B 159
-.
Using default values.
.TP
.B 160
-.
Corrupted data returned by phone.
.TP
.B 161
-.
Bad feature string in configuration.
.TP
.B 162
-.
Desired functionality has been disabled on compile time.
.TP
.B 163
-.
Bluetooth configuration requires channel option.
.TP
.B 164
-.
Service is not running.
.TP
.B 165
-.
Service configuration is missing.
.TP
.B 166
-.
Command rejected because device was busy. Wait and restart.
.TP
.B 167
-.
Could not connect to the server.
.TP
.B 168
-.
Could not resolve the host name.
.TP
.B 169
-.
Failed to get SMSC number from phone.
+.TP
+.B 170
+Operation aborted.
+.TP
+.B 171
+Installation data not found, please consult debug log and/or documentation for more details.
+.TP
+.B 172
+Entry is read only.
.UNINDENT
.SH EXAMPLES
.SS Configuration
@@ -2653,7 +2266,6 @@ To check it out, you need to have configuration file for gammu, see
\fIgammurc\fP for more details about it.
.SS Sending messages
.IP Note
-.
All messages bellow are sent to number 123456, replace it with proper destination.
.RE
.sp
diff --git a/docs/man/gammurc.5 b/docs/man/gammurc.5
index 352e938..0d30ea5 100644
--- a/docs/man/gammurc.5
+++ b/docs/man/gammurc.5
@@ -1,4 +1,4 @@
-.TH "GAMMURC" "5" "July 19, 2011" "1.30.0" "Gammu"
+.TH "GAMMURC" "5" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
gammurc \- gammu(1) configuration file
.
@@ -36,26 +36,20 @@ On Linux, MacOS X, BSD and other Unix\-like systems, the config file is
searched in following order:
.INDENT 0.0
.IP 1. 3
-.
\fB$XDG_CONFIG_HOME/gammu/config\fP
.IP 2. 3
-.
\fB~/.config/gammu/config\fP
.IP 3. 3
-.
\fB~/.gammurc\fP
.IP 4. 3
-.
\fB/etc/gammurc\fP
.UNINDENT
.sp
On Microsoft Windows:
.INDENT 0.0
.IP 1. 3
-.
\fB$PROFILE\eApplication Data\egammurc\fP
.IP 2. 3
-.
\fB.\egammurc\fP
.UNINDENT
.SH DESCRIPTION
@@ -88,30 +82,24 @@ This section is read by default unless you specify other on command line.
.INDENT 0.0
.TP
.B Connection
-.
Protocol which will be used to talk to your phone.
.sp
For Nokia cables you want to use one of following:
.INDENT 7.0
.TP
.B \fBfbus\fP
-.sp
serial FBUS connection
.TP
.B \fBdlr3\fP
-.sp
DLR\-3 and compatible cables
.TP
.B \fBdku2\fP
-.sp
DKU\-2 and compatible cables
.TP
.B \fBdku5\fP
-.sp
DKU\-5 and compatible cables
.TP
.B \fBmbus\fP
-.sp
serial MBUS connection
.UNINDENT
.sp
@@ -123,7 +111,6 @@ For non\-Nokia phones connected using cable you generally want:
.INDENT 7.0
.TP
.B \fBat\fP
-.sp
generic AT commands based connection
.UNINDENT
.sp
@@ -134,19 +121,15 @@ For IrDA connections use one of following:
.INDENT 7.0
.TP
.B \fBirdaphonet\fP
-.sp
Phonet connection for Nokia phones.
.TP
.B \fBirdaat\fP
-.sp
AT commands connection for most of phones (this is not supported on Linux).
.TP
.B \fBirdaobex\fP
-.sp
OBEX (IrMC or file transfer) connection for most of phones.
.TP
.B \fBirdagnapbus\fP
-.sp
GNapplet based connection for Symbian phones, see \fIgnapplet\fP.
.UNINDENT
.sp
@@ -154,23 +137,18 @@ For Bluetooth connection use one of following:
.INDENT 7.0
.TP
.B \fBbluephonet\fP
-.sp
Phonet connection for Nokia phones.
.TP
.B \fBblueat\fP
-.sp
AT commands connection for most of phones.
.TP
.B \fBblueobex\fP
-.sp
OBEX (IrMC or file transfer) connection for most of phones.
.TP
.B \fBbluerfgnapbus\fP
-.sp
GNapplet based connection for Symbian phones, see \fIgnapplet\fP.
.TP
.B \fBblues60\fP
-.sp
Connection to Series60 applet in S60 phones, see \fIs60\fP.
.sp
New in version 1.29.90.
@@ -179,7 +157,6 @@ New in version 1.29.90.
.INDENT 0.0
.TP
.B Device
-.
New in version 1.27.95.
.sp
Device node or address of phone. It depends on used connection.
@@ -204,7 +181,6 @@ Device = serial:123456 # Match device by serial string
.ft P
.fi
.IP Note
-.
On Linux systems, you might lack permissions for some device nodes.
You might need to be member of some group (eg. \fBplugdev\fP or
\fBdialout\fP) or or add special udev rules to enable you access
@@ -260,7 +236,6 @@ sysctl net.irda.discovery=1 # Enables device discovery on IrDA
.ft P
.fi
.IP Note
-.
Native IrDA is not supported on Linux, you need to setup virtual
serial port for it (eg. \fB/dev/ircomm0\fP) and use it same way as cable.
This can be usually achieved by loading modules \fBircomm\-tty\fP and \fBirtty\-sir\fP:
@@ -276,7 +251,6 @@ modprobe irtty\-sir
.INDENT 0.0
.TP
.B Port
-.
Deprecated since version 1.27.95.
.sp
Alias for \fI\%Device\fP, kept for backward compatibility.
@@ -284,7 +258,6 @@ Alias for \fI\%Device\fP, kept for backward compatibility.
.INDENT 0.0
.TP
.B Model
-.
Do not use this parameter unless really needed! The only use case for this is
when Gammu does not know your phone and misdetects it\(aqs features.
.sp
@@ -294,26 +267,21 @@ operation:
.INDENT 7.0
.TP
.B \fBobexfs\fP
-.sp
force using of file browsing service (file system support)
.TP
.B \fBobexirmc\fP
-.sp
force using of IrMC service (contacts, calendar and notes support)
.TP
.B \fBobexnone\fP
-.sp
none service chosen, this has only limited use for sending file (\fIgammu sendfile\fP command)
.TP
.B \fBmobex\fP
-.sp
m\-obex service for Samsung phones
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B Use_Locking
-.
On Posix systems, you might want to lock serial device when it is being used
using UUCP\-style lock files. Enabling this option (setting to yes) will make
Gammu honor these locks and create it on startup. On most distributions you
@@ -326,13 +294,11 @@ This option has no meaning on Windows.
.INDENT 0.0
.TP
.B SynchronizeTime
-.
If you want to set time from computer to phone during starting connection.
.UNINDENT
.INDENT 0.0
.TP
.B StartInfo
-.
This option allow to set, that you want (setting \fByes\fP) to see message on the
phone screen or phone should enable light for a moment during starting
connection. Phone will not beep during starting connection with this
@@ -342,10 +308,8 @@ option. This works only with some Nokia phones.
.INDENT 0.0
.TP
.B LogFile
-.
Path to file where information about communication will be stored.
.IP Note
-.
For most debug levels (excluding \fBerrors\fP) the log file is overwritten on
each execution.
.RE
@@ -353,36 +317,28 @@ each execution.
.INDENT 0.0
.TP
.B LogFormat
-.
Determines what all will be logged to \fBLogFile\fP. Possible values are:
.INDENT 7.0
.TP
.B \fBnothing\fP
-.sp
no debug level
.TP
.B \fBtext\fP
-.sp
transmission dump in text format
.TP
.B \fBtextall\fP
-.sp
all possible info in text format
.TP
.B \fBtextalldate\fP
-.sp
all possible info in text format, with time stamp
.TP
.B \fBerrors\fP
-.sp
errors in text format
.TP
.B \fBerrorsdate\fP
-.sp
errors in text format, with time stamp
.TP
.B \fBbinary\fP
-.sp
transmission dump in binary format
.UNINDENT
.sp
@@ -392,7 +348,6 @@ needed information to diagnose problems.
.INDENT 0.0
.TP
.B Features
-.
Custom features for phone. This can be used as override when values coded
in \fBcommon/gsmphones.c\fP are bad or missing. Consult
\fBinclude/gammu\-info.h\fP for possible values (all \fBGSM_Feature\fP values
@@ -403,7 +358,6 @@ authors.
.INDENT 0.0
.TP
.B GammuCoding
-.
Forces using specified codepage (for example \fB1250\fP will force CP\-1250 or
\fButf8\fP for UTF\-8). This should not be needed, Gammu detects it according
to your locales.
@@ -411,7 +365,6 @@ to your locales.
.INDENT 0.0
.TP
.B GammuLoc
-.
Path to directory with localisation files (the directory should contain
\fBLANG/LC_MESSAGES/gammu.mo\fP). If gammu is properly installed it should find
these files automatically.
@@ -420,7 +373,6 @@ these files automatically.
.INDENT 0.0
.TP
.B DataPath
-.
Additional path where to search for data files. The default path is
configured on build time (and defaults to \fB/usr/share/data/gammu\fP on Unix
systems). Currently it is used only for searching files to upload to phone
diff --git a/docs/man/jadmaker.1 b/docs/man/jadmaker.1
index 53ff1c6..eda8f1f 100644
--- a/docs/man/jadmaker.1
+++ b/docs/man/jadmaker.1
@@ -1,4 +1,4 @@
-.TH "JADMAKER" "1" "July 19, 2011" "1.30.0" "Gammu"
+.TH "JADMAKER" "1" "November 07, 2011" "1.30.90" "Gammu"
.SH NAME
jadmaker \- JAD File Generator
.
@@ -46,19 +46,16 @@ starting with two dashes (\fB\-\fP). A summary of options is included below.
.INDENT 0.0
.TP
.B \-h, \-\-help
-.sp
Show summary of options.
.UNINDENT
.INDENT 0.0
.TP
.B \-f, \-\-force
-.sp
Force rewriting of JAD file even if exists.
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-url URL
-.sp
Define URL to be included in JAD file.
.UNINDENT
.SH AUTHOR