1GAMMU-SMSBACKUP(5)                   Gammu                  GAMMU-SMSBACKUP(5)
2
3
4

NAME

6       gammu-smsbackup - gammu(1) SMS backup file format.
7
8       The SMS backup format is text file encoded in current encoding of plat‐
9       form where Gammu is running.
10
11       This file use ini file syntax, see ini.
12

SECTIONS

14       The file consists of sections, whose name starts with  SMSBackup.  When
15       creating the backup file, three digits are appended to this text defin‐
16       ing order. While reading the backup, any part after SMSBackup  text  is
17       ignored  and everything which begins with this is processed. So you can
18       as well give the section name SMSBackupFoo and it will be processed.
19
20       The  number  of  messages  in  backup  file  is  currently  limited  by
21       GSM_BACKUP_MAX_SMS (100000 at time of writing this document).
22
23   SMSBackup section
24       Each  section interprets one physical SMS message (eg. one message part
25       in case of multipart messages).
26
27   Decoded text
28       For SMS backups created by Gammu, there is a decoded text as a  comment
29       just after the section name:
30
31          [SMSBackup001]
32          ; This is message text
33
34       The  text  can  be split to more lines if it is too long or of original
35       message included new lines.
36
37       NOTE:
38          This is easiest way to get message  text,  however  also  the  least
39          reliable one, because it is stored in the comments in the file.
40
41   Variables
42       The following variables can be defined for each SMS:
43
44       SMSC   Text  representation of SMSC number, not used by Gammu if SMSCU‐
45              nicode exists.
46
47       SMSCUnicode
48              Hex encoded UCS-2 string with SMSC number.
49
50       Class  Message class.
51
52       Sent   Timestamp, when message has been sent.
53
54       PDU    Message type, one of:
55
56              · Deliver - received message
57
58              · Submit - message to send
59
60              · Status_Report - message to send with delivery report
61
62       DateTime
63              Timestamp of message (sent or received).
64
65       RejectDuplicates
66              Whether receiver should reject duplicates.
67
68       ReplaceMessage
69              ID of message to replace.
70
71       MessageReference
72              Message reference number as generated by network.
73
74       State  State of the message:
75
76              · Read
77
78              · UnRead
79
80              · Sent
81
82              · UnSent
83
84       Number Recipient number.
85
86       Name   Name of the message.
87
88       Length Length of message text.
89
90       Coding Coding of the message:
91
92              · 8bit - binary message
93
94              · Default - GSM encoding, up to 160 chars in message
95
96              · Unicode - Unicode encoding, up to 70 chars in message
97
98       Text00 ... TextNN
99              Numbered parts of the message payload.
100
101       Folder ID of folder where the message was saved.
102
103       UDH    User defined header of the message.
104

EXAMPLE

106       The backup of message can look like following:
107
108          [SMSBackup000]
109          #ABCDEFGHIJKLMNOPQRSTUVWXYZ
110          #
111          SMSC = "+4540590000"
112          SMSCUnicode = 002B0034003500340030003500390030003000300030
113          Sent = 20021201T025023
114          State = UnRead
115          Number = "+4522706947"
116          NumberUnicode = 002B0034003500320032003700300036003900340037
117          Name = ""
118          NameUnicode =
119          Text00 = 004100420043004400450046004700480049004A004B004C004D004E004F0050005100520053005400550056005700580059005A000A
120          Coding = Default
121          Folder = 1
122          Length = 27
123          Class = -1
124          ReplySMSC = False
125          RejectDuplicates = True
126          ReplaceMessage = 0
127          MessageReference = 0
128

AUTHOR

130       Michal Čihař <michal@cihar.com>
131
133       2009-2015, Michal Čihař <michal@cihar.com>
134
135
136
137
1381.42.0                           Oct 03, 2020               GAMMU-SMSBACKUP(5)
Impressum