GAMMU-SMSBACKUP(5)                   Gammu                  GAMMU-SMSBACKUP(5)

نام (NAME)
       gammu-smsbackup - قالب فایل پشتیبان پیامک gammu(1).

       قالب پشتیبان پیامک (SMS)، یک فایل متنی با کدگذاری جاری بستری (پلتفرمی)
       است که Gammu روی آن اجرا می‌شود.

       این فایل از نحو فایل‌های ini استفاده می‌کند، قالب فایل INI <#ini> را
       ببینید.

بخش‌ها (SECTIONS)
       این فایل از بخش‌هایی تشکیل شده است که نام آن‌ها با SMSBackup آغاز می‌شود.
       هنگام ایجاد فایل پشتیبان، سه رقم برای تعیین ترتیب به این متن الحاق
       می‌شود. در زمان خواندن فایل پشتیبان، هر بخشی پس از متن SMSBackup نادیده
       گرفته می‌شود و هر آنچه با این متن آغاز شود پردازش خواهد شد. بنابراین
       می‌توانید نام بخش را حتی SMSBackupFoo بگذارید و پردازش خواهد شد.

       تعداد پیام‌ها در فایل پشتیبان در حال حاضر با GSM_BACKUP_MAX_SMS
       <#c.GSM_BACKUP_MAX_SMS> محدود شده است (۱۰۰۰۰۰ پیام در زمان نگارش این
       سند).

   بخش SMSBackup (SMSBackup section)
       هر بخش یک پیامک فیزیکی را تفسیر می‌کند (برای نمونه، یک بخش از پیام در
       صورت وجود پیام‌های چندبخشی).

   متن رمزگشایی‌شده (Decoded text)
       برای پشتیبان‌های پیامک ایجادشده توسط Gammu، متن رمزگشایی‌شده‌ای به‌صورت
       کامنت درست پس از نام بخش وجود دارد:

          [SMSBackup001]
          ; This is message text

       اگر متن بیش از حد طولانی باشد یا پیام اصلی شامل خطوط جدید (سطر جدید)
       بوده باشد، متن می‌تواند به چندین خط تقسیم شود.

       نکته (Note):
          این ساده‌ترین راه برای به‌دست آوردن متن پیام است، اما در عین حال
          کم‌اطمینان‌ترین روش نیز هست، زیرا در کامنت‌های فایل ذخیره می‌شود.

   متغیرها (Variables)
       متغیرهای زیر را می‌توان برای هر پیامک تعریف کرد:

       SMSC   نمایش متنی شمارهٔ SMSC؛ در صورتی که SMSCUnicode وجود داشته باشد
              توسط Gammu استفاده نمی‌شود.

       SMSCUnicode
              رشتهٔ کدگذاری‌شده با هگزادسیمال در فرمت UCS-2 حاوی شمارهٔ SMSC.

       Class  کلاس پیام.

       Sent   برچسب زمانی (Timestamp) ارسال پیام.

       PDU    نوع پیام، یکی از موارد زیر:

              • Deliver - پیام دریافتی

              • Submit - پیام جهت ارسال

              • Status_Report - پیام ارسالی به همراه گزارش تحویل

       DateTime
              برچسب زمانی پیام (ارسالی یا دریافتی).

       RejectDuplicates
              مشخص می‌کند که آیا گیرنده باید پیام‌های تکراری را رد کند یا خیر.

       ReplaceMessage
              شناسهٔ (ID) پیامی که باید جایگزین شود.

       MessageReference
              شماره مرجع پیام که توسط شبکه تولید شده است.

       State  وضعیت پیام:

              • Read (خوانده‌شده)

              • UnRead (خوانده‌نشده)

              • Sent (ارسال‌شده)

              • UnSent (ارسال‌نشده)

       Number شمارهٔ گیرنده.

       Name   نام پیام.

       Length طول متن پیام.

       Coding کدگذاری پیام:

              • 8bit - پیام باینری

              • Default - کدگذاری GSM، تا ۱۶۰ نویسه در پیام

              • Unicode - کدگذاری یونیکد، تا ۷۰ نویسه در پیام

       Text00 ... TextNN
              بخش‌های شماره‌گذاری‌شدهٔ بار دادهٔ (payload) پیام.

       Folder شناسهٔ پوشه‌ای که پیام در آن ذخیره شده است.

       UDH    هدر تعریف‌شده توسط کاربر (User defined header) برای پیام.

مثال (EXAMPLE)
       پشتیبان یک پیام می‌تواند به شکل زیر باشد:

          [SMSBackup000]
          #ABCDEFGHIJKLMNOPQRSTUVWXYZ
          #
          SMSC = "+4540590000"
          SMSCUnicode = 002B0034003500340030003500390030003000300030
          Sent = 20021201T025023
          State = UnRead
          Number = "+4522706947"
          NumberUnicode = 002B0034003500320032003700300036003900340037
          Name = ""
          NameUnicode =
          Text00 = 004100420043004400450046004700480049004A004B004C004D004E004F0050005100520053005400550056005700580059005A000A
          Coding = Default
          Folder = 1
          Length = 27
          Class = -1
          ReplySMSC = False
          RejectDuplicates = True
          ReplaceMessage = 0
          MessageReference = 0

نویسنده (AUTHOR)
       Michal Čihař <michal@cihar.com>

حق نشر (COPYRIGHT)
       2009-2015, Michal Čihař <michal@cihar.com>

1.43.2                         February 9, 2026             GAMMU-SMSBACKUP(5)