.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GAMMU-SMSDRC" "5" "Feb 09, 2026" "1.43.2" "Gammu"
.SH "نام (NAME)"
gammu\-smsdrc \- پرونده پیکربندی دیمن پیامک گامو
.SH "توضیحات (DESCRIPTION)"
.sp
دستور gammu\-smsd پیکربندی را از یک پرونده پیکربندی می‌خواند. مکان آن می‌تواند در خط فرمان مشخص شود، در غیر این صورت از مسیر پیش‌فرض \fB/etc/gammu\-smsdrc\fP استفاده می‌شود.
.sp
این پرونده از ساختار پرونده‌های ini استفاده می‌کند، قالب پرونده INI \%<#\:ini> را ببینید.
.sp
پرونده پیکربندی gammu\-smsd حداقل از دو بخش تشکیل شده است \- \fB[gammu]\fP \%<#\:section-[gammu]> و \fB[smsd]\fP\&. برای سرویس اس‌کیوال \%<#\:gammu-smsd-sql> همچنین می‌توانید از \fB[sql]\fP و \fB[tables]\fP استفاده کنید.
.sp
بخش \fB[gammu]\fP \%<#\:section-[gammu]> پیکربندی اتصال گوشی است و همان‌گونه است که در پرونده پیکربندی گامو \%<#\:gammurc> شرح داده شده است، با این استثنا که \fBLogFile\fP نادیده گرفته شده و ثبت گزارش مشترک برای کتابخانه gammu و دیمن پیامک استفاده می‌شود. با این حال دستورالعمل \fBLogFormat\fP \%<#\:option-LogFormat> همچنان مشخص می‌کند که gammu چه مقدار پیام تولید کند.
.INDENT 0.0
.TP
.B [smsd]
بخش \fB[smsd]\fP خود دیمن پیامک را پیکربندی می‌کند، که در زیربخش‌های بعدی شرح داده شده‌اند. ابتدا پارامترهای عمومی دیمن پیامک فهرست شده‌اند و سپس پارامترهای خاص برای پشتیبان‌های ذخیره‌سازی می‌آیند.
.UNINDENT
.INDENT 0.0
.TP
.B [include_numbers]
فهرستی از شماره‌هایی که پیام‌های آن‌ها پذیرفته می‌شود، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B [exclude_numbers]
فهرستی از شماره‌هایی که پیام‌های آن‌ها رد می‌شود، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B [include_smsc]
فهرستی از شماره‌های SMSC که پیام‌های آن‌ها پذیرفته می‌شود، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B [exclude_smsc]
فهرستی از شماره‌های SMSC که پیام‌های آن‌ها رد می‌شود، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B [sql]
پرس‌وجوهای SQL استفاده شده توسط سرویس اس‌کیوال \%<#\:gammu-smsd-sql> را پیکربندی می‌کند؛ معمولاً نیازی به تغییر آن‌ها ندارید.
.sp
\fBهمچنین ببینید:\fP
.INDENT 7.0
.INDENT 3.5
پرس‌وجوهای قابل پیکربندی \%<#\:configurable-queries>
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B [tables]
نام جدول‌های SQL استفاده شده توسط سرویس اس‌کیوال \%<#\:gammu-smsd-sql> را پیکربندی می‌کند؛ معمولاً نیازی به تغییر آن‌ها ندارید.
.sp
\fBهمچنین ببینید:\fP
.INDENT 7.0
.INDENT 3.5
جدول‌ها \%<#\:configurable-tables>
.UNINDENT
.UNINDENT
.UNINDENT
.SH "پارامترهای عمومی دیمن پیامک (GENERAL PARAMETERS OF SMS DAEMON)"
.INDENT 0.0
.TP
.B Service
سرویس SMSD برای استفاده، یکی از گزینه‌های زیر:
.INDENT 7.0
.TP
.B \fBFILES\fP
پیام‌ها را در پرونده‌ها ذخیره می‌کند، برای جزئیات پشتیبان Files \%<#\:gammu-smsd-files> را ببینید.
.TP
.B \fBNULL\fP
پیام‌ها را اصلاً ذخیره نمی‌کند، برای جزئیات پشتیبان Null \%<#\:gammu-smsd-null> را ببینید.
.TP
.B \fBSQL\fP
پیام‌ها را در پایگاه‌داده SQL ذخیره می‌کند، برای جزئیات سرویس اس‌کیوال \%<#\:gammu-smsd-sql> را ببینید؛ نوع پایگاه‌داده مورد استفاده را با \fBDriver\fP انتخاب کنید.
.sp
اضافه شده در نگارش 1.28.93.

.TP
.B \fBMYSQL\fP
منسوخ شده از نگارش 1.28.93: به جای آن از \fBService\fP = \fBSQL\fP و \fBDriver\fP = \fBnative_mysql\fP استفاده کنید.

.sp
گزینه سازگاری برای پرونده‌های پیکربندی قدیمی‌تر؛ پیام‌ها را در پایگاه‌داده MySQL ذخیره می‌کند، برای جزئیات پشتیبان MySQL \%<#\:gammu-smsd-mysql> را ببینید.
.TP
.B \fBPGSQL\fP
منسوخ شده از نگارش 1.28.93: به جای آن از \fBService\fP = \fBSQL\fP و \fBDriver\fP = \fBnative_pgsql\fP استفاده کنید.

.sp
گزینه سازگاری برای پرونده‌های پیکربندی قدیمی‌تر؛ پیام‌ها را در پایگاه‌داده PostgreSQL ذخیره می‌کند، برای جزئیات پشتیبان PostgreSQL \%<#\:gammu-smsd-pgsql> را ببینید.
.TP
.B \fBDBI\fP
منسوخ شده از نگارش 1.28.93: به جای آن از \fBService\fP = \fBSQL\fP و \fBDriver\fP = DBI driver استفاده کنید.

.sp
گزینه سازگاری برای پرونده‌های پیکربندی قدیمی‌تر؛ پیام‌ها را در هر پایگاه‌داده‌ای که توسط libdbi پشتیبانی شود ذخیره می‌کند، برای جزئیات پشتیبان DBI \%<#\:gammu-smsd-dbi> را ببینید.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
دسترس‌پذیری پشتیبان‌ها به بستر و پیکربندی زمان کامپایل بستگی دارد.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B PIN
کد PIN برای سیم‌کارت. این گزینه اختیاری است، اما اگر گوشی شما پس از روشن شدن به PIN نیاز دارد باید آن را تنظیم کنید.
.UNINDENT
.INDENT 0.0
.TP
.B NetworkCode
گذرواژه شخصی‌سازی شبکه. این گزینه اختیاری است، اما برخی تلفن‌ها پس از روشن شدن به آن نیاز دارند.
.UNINDENT
.INDENT 0.0
.TP
.B PhoneCode
گذرواژه قفل تلفن. این گزینه اختیاری است، اما برخی تلفن‌ها پس از روشن شدن به آن نیاز دارند.
.UNINDENT
.INDENT 0.0
.TP
.B LogFile
پرونده‌ای که در آن کنش‌های SMSD ثبت می‌شوند. همچنین می‌توانید از مقدار ویژه \fBsyslog\fP استفاده کنید که تمام پیام‌ها را به دیمن syslog می‌فرستد. در ویندوز مقدار ویژه دیگری به نام \fBeventlog\fP وجود دارد که گزارش‌ها را به Windows Event Log می‌فرستد.
.sp
اگر SMSD را به عنوان یک دیمن سیستمی (یا سرویس) اجرا می‌کنید، توصیه می‌شود از مسیر مطلق برای پرونده گزارش استفاده کنید زیرا پوشه راه‌اندازی ممکن است با آنچه انتظار دارید متفاوت باشد.
.sp
پیش‌فرض بدون ثبت گزارش است.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
برای ثبت گزارش در Windows Event Log، توصیه می‌شود منبع Event Log را با فراخوانی \fBgammu\-smsd \-e\fP نصب کنید (این کار در طول نصب Gammu به طور خودکار انجام می‌شود).
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B LogFacility
فسیلیتی (Facility) مورد استفاده در پشتیبان‌های ثبت گزارش که از آن پشتیبانی می‌کنند (در حال حاضر فقط syslog). یکی از گزینه‌های زیر:
.INDENT 7.0
.IP \(bu 2
\fBDAEMON\fP (پیش‌فرض)
.IP \(bu 2
\fBUSER\fP
.IP \(bu 2
\fBLOCAL0\fP
.IP \(bu 2
\fBLOCAL1\fP
.IP \(bu 2
\fBLOCAL2\fP
.IP \(bu 2
\fBLOCAL3\fP
.IP \(bu 2
\fBLOCAL4\fP
.IP \(bu 2
\fBLOCAL5\fP
.IP \(bu 2
\fBLOCAL6\fP
.IP \(bu 2
\fBLOCAL7\fP
.UNINDENT
.sp
اضافه شده در نگارش 1.30.91.

.UNINDENT
.INDENT 0.0
.TP
.B DebugLevel
سطح اشکال‌زدایی برای SMSD. مقدار عددی صحیح باید مجموع تمام پرچم‌هایی باشد که می‌خواهید فعال کنید.
.INDENT 7.0
.TP
.B 1
اطلاعات اولیه اشکال‌زدایی را فعال می‌کند
.TP
.B 2
ثبت پرس‌وجوهای SQL پشتیبان‌های سرویس را فعال می‌کند
.TP
.B 4
ثبت اطلاعات اشکال‌زدایی gammu را فعال می‌کند
.UNINDENT
.sp
به‌طور کلی برای دریافت بیشترین اطلاعات اشکال‌زدایی ممکن، از 255 استفاده کنید.
.sp
پیش‌فرض 0 است، که به معنای عدم ارائه اطلاعات اضافی است.
.UNINDENT
.INDENT 0.0
.TP
.B CommTimeout
تعداد ثانیه‌هایی که SMSD پس از خالی بودن صندوق خروجی منتظر می‌ماند پیش از آنکه دوباره آن را پویش کند.
.sp
پیش‌فرض 30 است.
.UNINDENT
.INDENT 0.0
.TP
.B SendTimeout
نشان می‌دهد که SMSD هنگام ارسال پیامک چند ثانیه باید منتظر پاسخ شبکه بماند. اگر در این مدت اتفاقی نیفتد، پیامک دوباره ارسال خواهد شد.
.sp
پیش‌فرض 30 است.
.UNINDENT
.INDENT 0.0
.TP
.B MaxRetries
چند بار SMSD در صورت شکست در ارسال پیام، تلاش مجدد خواهد کرد. این مورد برای هر پیام جداگانه ردیابی می‌شود و در حال حاضر تنها با پشتیبان‌های SQL پشتیبانی می‌شود.
.sp
پیش‌فرض 1 است.
.UNINDENT
.INDENT 0.0
.TP
.B RetryTimeout
مدت زمان انتظار پیش از ارسال مجدد پیام ناموفق (باید توسط \fBMaxRetries\fP فعال شده باشد).
.sp
در \fBupdate_retries\fP \%<#\:option-update_retries> استفاده می‌شود.
.sp
پیش‌فرض 600 است.
.UNINDENT
.INDENT 0.0
.TP
.B ReceiveFrequency
تعداد ثانیه‌های بین بررسی دریافت پیامک‌های جدید، زمانی که گوشی مشغول ارسال پیامک است. به طور معمول بررسی پیامک‌های دریافتی هر \fBCommTimeout\fP ثانیه و پس از ارسال هر پیامک انجام می‌شود.
.sp
پیش‌فرض 15 است.
.UNINDENT
.INDENT 0.0
.TP
.B StatusFrequency
تعداد ثانیه‌های بین به‌روزرسانی وضعیت تلفن (باتری، سیگنال) ذخیره‌شده در حافظه مشترک و احتمالاً در پشتیبان‌های سرویس. برای غیرفعال کردن از 0 استفاده کنید.
.sp
شاید بخواهید برای بازدهی بالاتر این مقدار را افزایش دهید.
.sp
پیش‌فرض 60 است.
.UNINDENT
.INDENT 0.0
.TP
.B LoopSleep
تعداد ثانیه‌هایی که SMSD پیش از بررسی فعالیت‌ها به خواب می‌رود. لطفاً توجه داشته باشید که تنظیم این مقدار روی عددی بزرگ‌تر از 1 بر سایر پیکربندی‌های مبتنی بر زمان تأثیر خواهد گذاشت، زیرا آن‌ها عملاً به مضربی از این مقدار گرد خواهند شد.
.sp
تنظیم این گزینه روی 0 حالت خواب را غیرفعال می‌کند. لطفاً توجه داشته باشید که این کار ممکن است باعث مصرف توان پردازنده زیادی توسط Gammu شود زیرا در عمل یک حلقه مشغول (busy loop) انجام می‌دهد.
.sp
این خواب فقط در صورتی استفاده می‌شود که حلقه اصلی (ارسال و دریافت پیام‌ها) کمتر از زمان تعریف‌شده طول بکشد. به عنوان مثال اگر LoopSleep را روی 5 ثانیه تنظیم کنید و ارسال پیام‌ها 10 ثانیه طول بکشد، در تکراری که مشغول ارسال پیام است هیچ خوابی انجام نخواهد شد. همچنین مدت زمان خواب به میزان زمان از پیش پردازش‌شده کاهش می‌یابد.
.sp
پیش‌فرض 1 است.
.UNINDENT
.INDENT 0.0
.TP
.B MultipartTimeout
تعداد ثانیه‌هایی که SMSD برای رسیدن تمام بخش‌های یک پیام چندبخشی منتظر می‌ماند. اگر تمام بخش‌ها به موقع نرسند، بخش‌ها به عنوان پیام‌های جداگانه پردازش خواهند شد.
.sp
پیش‌فرض 600 (۱۰ دقیقه) است.
.UNINDENT
.INDENT 0.0
.TP
.B CheckSecurity
آیا بررسی شود که آیا تلفن نیاز به وارد کردن PIN دارد یا خیر.
.sp
پیش‌فرض 1 (فعال) است.
.UNINDENT
.INDENT 0.0
.TP
.B HangupCalls
اضافه شده در نگارش 1.34.0.
.sp
آیا تماس‌های ورودی به طور خودکار قطع شوند یا خیر.
.sp
پیش‌فرض 0 (غیرفعال) است.
.UNINDENT
.INDENT 0.0
.TP
.B CheckBattery
آیا وضعیت باتری تلفن به صورت دوره‌ای بررسی شود یا خیر.
.sp
پیش‌فرض 1 (فعال) است.
.UNINDENT
.INDENT 0.0
.TP
.B CheckSignal
آیا سطح سیگنال به صورت دوره‌ای بررسی شود یا خیر.
.sp
پیش‌فرض 1 (فعال) است.
.UNINDENT
.INDENT 0.0
.TP
.B CheckNetwork
اضافه شده در نگارش 1.37.90.
.sp
آیا وضعیت شبکه به صورت دوره‌ای بررسی شود یا خیر.
.sp
اگر گزارش شود تلفن در شبکه نیست، SMSD تلاش می‌کند آن را روشن کند.
.sp
پیش‌فرض 1 (فعال) است.
.UNINDENT
.INDENT 0.0
.TP
.B ResetFrequency
تعداد ثانیه‌های بین انجام بازنشانی نرم‌افزاری پیشگیرانه به منظور به حداقل رساندن موارد قفل شدن تلفن‌ها؛ برای مثال Nokia 5110 گاهی در حالتی فریز می‌شود که تنها پس از خارج کردن باتری دوباره کار خواهد کرد.
.sp
پیش‌فرض 0 (استفاده نمی‌شود) است.
.UNINDENT
.INDENT 0.0
.TP
.B HardResetFrequency
اضافه شده در نگارش 1.28.92.
.sp
\fBهشدار:\fP
.INDENT 7.0
.INDENT 3.5
برای برخی تلفن‌ها، بازنشانی سخت‌افزاری به معنی حذف تمامی داده‌های درون آن است. مگر اینکه دقیقاً بدانید چه کار می‌کنید، به جای آن از \fBResetFrequency\fP استفاده کنید.
.UNINDENT
.UNINDENT
.sp
تعداد ثانیه‌های بین انجام بازنشانی سخت‌افزاری پیشگیرانه به منظور به حداقل رساندن موارد قفل شدن تلفن‌ها.
.sp
پیش‌فرض 0 (استفاده نمی‌شود) است.
.UNINDENT
.INDENT 0.0
.TP
.B DeliveryReport
آیا گزارش تحویل استفاده شود یا خیر، یکی از گزینه‌های \fBno\fP، \fBlog\fP، \fBsms\fP\&.
.INDENT 7.0
.TP
.B \fBlog\fP
ثبت یک خط در پرونده گزارش،
.TP
.B \fBsms\fP
ذخیره در صندوق ورودی به عنوان یک پیامک دریافتی
.TP
.B \fBno\fP
بدون گزارش تحویل
.UNINDENT
.sp
پیش‌فرض \fBno\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B DeliveryReportDelay
تأخیر بر حسب ثانیه که در طول آن گزارش تحویل هنوز معتبر تلقی می‌شود. این مورد به نقص‌های شبکه شما بستگی دارد (گزارش تحویل باید برچسب زمانی یکسانی با پیام ارسال‌شده داشته باشد). اگر گزارش‌های تحویل با پیام‌های ارسالی جفت نمی‌شوند، این مقدار را افزایش دهید.
.sp
پیش‌فرض 600 (۱۰ دقیقه) است.
.UNINDENT
.INDENT 0.0
.TP
.B PhoneID
رشته‌ای حاوی اطلاعات درباره تلفن مورد استفاده برای ارسال/دریافت. این می‌تواند مفید باشد اگر بخواهید چندین دیمن پیامک را اجرا کنید (چندین مودم را ببینید).
.sp
هنگامی که PhoneID را تنظیم می‌کنید، تمام پیام‌ها (از جمله پیام‌های تزریق‌شده) با این رشته علامت‌گذاری می‌شوند (در پایگاه‌داده به عنوان SenderID ذخیره می‌شود) و این امکان را می‌دهد که چندین دیمن پیامک یک پایگاه‌داده مشترک داشته باشند.
.sp
در این حالت دیمن SMSD پیام‌های صندوق خروجی \%<#\:outbox> را تنها با SenderID منطبق یا خالی ارسال خواهد کرد.
.sp
این گزینه عملاً بر پشتیبان Files \%<#\:gammu-smsd-files> تأثیری ندارد.
.UNINDENT
.INDENT 0.0
.TP
.B SMSC
اضافه شده در نگارش 1.36.2.
.sp
شماره SMSC مورد استفاده برای ارسال پیام‌ها در صورتی که در پیام مشخص نشده باشد (گزینه‌های gammu\-smsd\-inject \%<#\:gammu-smsd-inject> را ببینید).
.sp
در بیشتر موارد به این تنظیم نیاز ندارید زیرا Gammu تلاش می‌کند SMSC صحیح را از تلفن بخواند، اما گاهی این کار با شکست مواجه می‌شود (دستور \fBgammu getsmsc\fP را امتحان کنید).
.UNINDENT
.INDENT 0.0
.TP
.B RunOnReceive
برنامه‌ای را پس از دریافت پیام اجرا می‌کند.
.sp
این پارامتر از طریق پوسته اجرا می‌شود، بنابراین ممکن است لازم باشد برخی نویسه‌های ویژه را اسکیپ کنید و می‌توانید هر تعداد پارامتری را بگنجانید. علاوه بر این، پارامترهایی با شناسه‌های پیام‌های دریافتی به انتهای خط فرمان اضافه می‌شوند. شناسه‌ها به پشتیبان سرویس مورد استفاده بستگی دارند؛ معمولاً شناسه سطر درج‌شده برای پشتیبان‌های پایگاه‌داده یا نام پرونده برای پشتیبان‌های مبتنی بر پرونده است.
.sp
دیمن Gammu SMSD منتظر پایان یافتن اسکریپت می‌ماند. اگر کار زمان‌بری در آنجا انجام دهید، باعث می‌شود SMSD پیام‌های جدید را دریافت نکند. با این حال برای محدود کردن اختلال ناشی از این وضعیت، زمان انتظار به دو دقیقه محدود شده است. پس از این زمان، SMSD به عملکرد عادی خود ادامه می‌دهد و ممکن است اسکریپت شما را دوباره اجرا کند.
.sp
این فرآیند اطلاعات زیادی درباره پیام دریافتی در متغیرهای محیطی در دسترس دارد، برای جزئیات بیشتر دستورالعمل RunOnReceive \%<#\:gammu-smsd-run> را بررسی کنید.
.UNINDENT
.INDENT 0.0
.TP
.B RunOnFailure
اضافه شده در نگارش 1.28.93.
.sp
برنامه‌ای را هنگام بروز خطا اجرا می‌کند.
.sp
این می‌تواند برای واکنش پیشگیرانه به برخی خطاها یا برای تشخیص تعاملی خطای ارسال پیام استفاده شود.
.sp
این برنامه یک پارامتر اختیاری دریافت خواهد کرد که در حال حاضر می‌تواند \fBINIT\fP (به معنی خطا در راه‌اندازی اولیه تلفن) یا شناسه پیام باشد، که نشان‌دهنده خطا در حین ارسال پیام است.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
محیط حاوی اطلاعات پیام (همان‌طور که در \fBRunOnReceive\fP وجود دارد) به دستور ارسال نمی‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B RunOnSent
اضافه شده در نگارش 1.36.4.
.sp
برنامه‌ای را پس از ارسال پیام اجرا می‌کند.
.sp
این برنامه یک پارامتر اختیاری شامل شناسه پیام و محیط حاوی جزئیات پیام را همان‌گونه که در دستورالعمل RunOnReceive \%<#\:gammu-smsd-run> شرح داده شده، دریافت خواهد کرد.
.UNINDENT
.INDENT 0.0
.TP
.B RunOnIncomingCall
اضافه شده در نگارش 1.38.5.
.sp
برنامه‌ای را پس از قطع کردن تماس ورودی اجرا می‌کند.
.sp
این برنامه پارامتری حاوی شماره تلفن تماس را دریافت خواهد کرد. این نیازمند فعال بودن \fBHangupCalls\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B IncludeNumbersFile
پرونده‌ای شامل فهرست شماره‌هایی که توسط SMSD پذیرفته می‌شوند. این پرونده در هر خط شامل یک شماره است، خطوط خالی نادیده گرفته می‌شوند. پرونده در زمان راه‌اندازی خوانده می‌شود و تنها زمانی دوباره خوانده می‌شود که پیکربندی مجدداً بارگذاری شود. برای جزئیات، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B ExcludeNumbersFile
پرونده‌ای شامل فهرست شماره‌هایی که توسط SMSD پذیرفته نمی‌شوند. این پرونده در هر خط شامل یک شماره است، خطوط خالی نادیده گرفته می‌شوند. پرونده در زمان راه‌اندازی خوانده می‌شود و تنها زمانی دوباره خوانده می‌شود که پیکربندی مجدداً بارگذاری شود. برای جزئیات، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B IncludeSMSCFile
پرونده‌ای شامل فهرست شماره‌های SMSC که توسط SMSD پذیرفته می‌شوند. این پرونده در هر خط شامل یک شماره است، خطوط خالی نادیده گرفته می‌شوند. پرونده در زمان راه‌اندازی خوانده می‌شود و تنها زمانی دوباره خوانده می‌شود که پیکربندی مجدداً بارگذاری شود. برای جزئیات، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B ExcludeSMSCFile
پرونده‌ای شامل فهرست شماره‌های SMSC که توسط SMSD پذیرفته نمی‌شوند. این پرونده در هر خط شامل یک شماره است، خطوط خالی نادیده گرفته می‌شوند. پرونده در زمان راه‌اندازی خوانده می‌شود و تنها زمانی دوباره خوانده می‌شود که پیکربندی مجدداً بارگذاری شود. برای جزئیات، فیلتر کردن پیام‌ها را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B BackendRetries
چند بار پشتیبان SMSD عملیات را دوباره امتحان کند.
.sp
پیاده‌سازی در پشتیبان‌های مختلف متفاوت است، برای پشتیبان‌های پایگاه‌داده عموماً به معنای چند بار تلاش برای اتصال مجدد به کارساز است.
.sp
پیش‌فرض 10 است.
.UNINDENT
.INDENT 0.0
.TP
.B Send
اضافه شده در نگارش 1.28.91.
.sp
آیا ارسال پیام‌ها فعال باشد یا خیر.
.sp
پیش‌فرض True است.
.UNINDENT
.INDENT 0.0
.TP
.B Receive
اضافه شده در نگارش 1.28.91.
.sp
آیا دریافت پیام‌ها فعال باشد یا خیر.
.sp
پیش‌فرض True است.
.UNINDENT
.SH "گزینه‌های پشتیبان‌های پایگاه‌داده (DATABASE BACKENDS OPTIONS)"
.sp
تمامی پشتیبان‌های DBI، ODBC، MYSQL و PGSQL (برای مستندات آن‌ها پشتیبان MySQL \%<#\:gammu-smsd-mysql>، پشتیبان ODBC \%<#\:gammu-smsd-odbc>، پشتیبان PostgreSQL \%<#\:gammu-smsd-pgsql> و پشتیبان DBI \%<#\:gammu-smsd-dbi> را ببینید) از گزینه‌های یکسانی برای پیکربندی اتصال به پایگاه‌داده پشتیبانی می‌کنند:
.INDENT 0.0
.TP
.B User
نام کاربری مورد استفاده برای اتصال به پایگاه‌داده.
.UNINDENT
.INDENT 0.0
.TP
.B Password
گذرواژه مورد استفاده برای اتصال به پایگاه‌داده.
.UNINDENT
.INDENT 0.0
.TP
.B Host
نشانی کارساز پایگاه‌داده. همچنین می‌تواند شامل درگاه یا مسیر سوکت پس از دونقطه باشد، برای مثال \fBlocalhost:/path/to/socket\fP یا \fB192.168.1.1:8000\fP\&.
.sp
برای ODBC این گزینه به عنوان نام منبع داده (Data source name) استفاده می‌شود.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
برخی کارسازهای پایگاه‌داده بین استفاده از \fBlocalhost\fP (برای استفاده از سوکت محلی) و \fB127.0.0.1\fP (برای استفاده از اتصال TCP/IP محلی) تفاوت قائل می‌شوند. لطفاً مطمئن شوید که تنظیمات SMSD شما با تنظیمات کارساز پایگاه‌داده مطابقت دارد.
.UNINDENT
.UNINDENT
.sp
اضافه شده در نگارش 1.28.92.

.UNINDENT
.INDENT 0.0
.TP
.B PC
منسوخ شده از نگارش 1.28.92: لطفاً به جای آن از \fBHost\fP استفاده کنید.
.sp
مترادفی برای \fBHost\fP است که برای سازگاری با گذشته نگه داشته شده است.
.UNINDENT
.INDENT 0.0
.TP
.B Database
نام پایگاه‌داده (یا طرح‌واره) برای استفاده و جایی که SMSD می‌تواند جدول‌های خود را در آن بیابد.
.sp
لطفاً توجه داشته باشید که باید قبل از استفاده از gammu\-smsd جدول‌ها را در این پایگاه‌داده ایجاد کنید. پرونده‌های SQL برای ایجاد جدول‌های مورد نیاز در مستندات پشتیبان‌های منفرد پایگاه‌داده گنجانده شده‌اند: پشتیبان MySQL \%<#\:gammu-smsd-mysql>، پشتیبان ODBC \%<#\:gammu-smsd-odbc>، پشتیبان PostgreSQL \%<#\:gammu-smsd-pgsql>، پشتیبان DBI \%<#\:gammu-smsd-dbi>
.UNINDENT
.INDENT 0.0
.TP
.B SkipSMSCNumber
هنگامی که از برخی مراکز پیامک، پیام ارسال می‌کنید ممکن است گزارش‌های تحویل را از شماره SMSC دیگری دریافت کنید. می‌توانید در اینجا شماره این SMSC مورد استفاده خود را تنظیم کنید و Gammu شماره آن را هنگام اختصاص گزارش‌ها به پیامک‌های ارسالی بررسی نخواهد کرد.
.UNINDENT
.INDENT 0.0
.TP
.B Driver
درایور SQL مورد استفاده، Gammu از چندین درایور بومی و رابط عمومی با استفاده از ODBC و DBI پشتیبانی می‌کند. در دسترس بودن پشتیبان‌ها به گزینه‌های زمان کامپایل بستگی دارد.
.sp
درایورهای موجود:
.sp
\fBodbc\fP
.INDENT 7.0
.INDENT 3.5
با استفاده از ODBC به پایگاه‌داده متصل می‌شود، پشتیبان ODBC \%<#\:gammu-smsd-odbc> را ببینید.
.UNINDENT
.UNINDENT
.sp
\fBnative_mysql\fP
.INDENT 7.0
.INDENT 3.5
پیام‌ها را در پایگاه‌داده MySQL ذخیره می‌کند، برای جزئیات پشتیبان MySQL \%<#\:gammu-smsd-mysql> را ببینید.
.UNINDENT
.UNINDENT
.sp
\fBnative_pgsql\fP
.INDENT 7.0
.INDENT 3.5
پیام‌ها را در پایگاه‌داده PostgreSQL ذخیره می‌کند، برای جزئیات پشتیبان PostgreSQL \%<#\:gammu-smsd-pgsql> را ببینید.
.UNINDENT
.UNINDENT
.sp
\fBdb2\fP, \fBfirebird\fP, \fBfreetds\fP, \fBingres\fP, \fBmsql\fP, \fBmysql\fP, \fBoracle\fP, \fBpgsql\fP, \fBsqlite\fP, \fBsqlite3\fP
.INDENT 7.0
.INDENT 3.5
پیام‌ها را با استفاده از کتابخانه DBI در پشتیبان مشخص‌شده ذخیره می‌کند. برای این که کار کند باید درایور DBI مناسب را نصب کرده باشید. برای جزئیات پشتیبان DBI \%<#\:gammu-smsd-dbi> را ببینید.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B SQL
گویش SQL مورد استفاده. این گزینه به‌ویژه با پشتیبان ODBC \%<#\:gammu-smsd-odbc> مفید است که در آن SMSD دقیقاً نمی‌داند با چه کارسازی صحبت می‌کند.
.sp
مقادیر ممکن:
.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
\fBoracle\fP \- Oracle
.IP \(bu 2
\fBodbc\fP \- Generic ODBC
.UNINDENT
.sp
اضافه شده در نگارش 1.28.93.

.sp
\fBهمچنین ببینید:\fP
.INDENT 7.0
.INDENT 3.5
همچنین می‌توانید پرس‌وجوهای SQL مورد استفاده را همان‌طور که در پرس‌وجوهای SQL \%<#\:sql-queries> شرح داده شده کاملاً سفارشی کنید.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B DriversPath
مسیری که درایورهای DBI در آن ذخیره شده‌اند؛ این مورد معمولاً در صورت نصب صحیح درایورها نیازی به تنظیم ندارد.
.UNINDENT
.INDENT 0.0
.TP
.B DBDir
دایرکتوری پایگاه‌داده برای برخی از درایورهای DBI (در حال حاضر فقط sqlite). در اینجا مسیری را تنظیم کنید که پرونده‌های پایگاه‌داده sqlite در آن ذخیره می‌شوند.
.UNINDENT
.SS "گزینه‌های پشتیبان پرونده‌ها (Files backend options)"
.sp
پشتیبان FILES گزینه‌های پیکربندی زیر را می‌پذیرد. برای شرح دقیق‌تر پشتیبان سرویس، پشتیبان Files \%<#\:gammu-smsd-files> را ببینید. لطفاً توجه داشته باشید که تمام مسیرها باید حاوی جداکننده پایانی مسیر باشند (/ در سیستم‌های یونیکس):
.INDENT 0.0
.TP
.B InboxPath
جایی که پیامک‌های دریافتی ذخیره می‌شوند.
.sp
پیش‌فرض دایرکتوری جاری است.
.UNINDENT
.INDENT 0.0
.TP
.B OutboxPath
جایی که پیامک‌های ارسالی باید در آن قرار گیرند.
.sp
پیش‌فرض دایرکتوری جاری است.
.UNINDENT
.INDENT 0.0
.TP
.B SentSMSPath
جایی که پیامک‌های ارسال‌شده قرار می‌گیرند؛ اگر با \fBOutboxPath\fP یکسان باشد، پیام‌های منتقل‌شده حذف می‌شوند.
.sp
پیش‌فرض حذف پیام‌های ارسال‌شده است.
.UNINDENT
.INDENT 0.0
.TP
.B ErrorSMSPath
جایی که پیامک‌های دارای خطا در ارسال قرار می‌گیرند.
.sp
پیش‌فرض همان \fBSentSMSPath\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B InboxFormat
قالبی که در آن پیامک ذخیره خواهد شد: \fBdetail\fP، \fBunicode\fP، \fBstandard\fP\&.
.INDENT 7.0
.TP
.B \fBdetail\fP
قالب مورد استفاده برای پشتیبان‌گیری پیام توسط ابزار Gammu \%<#\:gammu>، قالب پشتیبان‌گیری پیامک \%<#\:gammu-smsbackup> را ببینید.
.TP
.B \fBunicode\fP
متن پیام ذخیره‌شده به صورت یونیکد (UTF\-16)
.TP
.B \fBstandard\fP
متن پیام ذخیره‌شده در مجموعه نویسه سیستم
.UNINDENT
.sp
تنظیمات \fBstandard\fP و \fBunicode\fP برای پیام‌های ۸ بیتی اعمال نمی‌شوند؛ آن‌ها همیشه به صورت خام همان‌طور که با پسوند .bin دریافت شده‌اند نوشته می‌شوند.
.sp
پیش‌فرض \fBunicode\fP است.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
در قالب \fBdetail\fP، تمام بخش‌های پیام در یک پرونده واحد ذخیره می‌شوند؛ برای بقیه، هر بخش پیام به طور جداگانه ذخیره می‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B OutboxFormat
قالبی که در آن پیام‌های ایجادشده توسط gammu\-smsd\-inject \%<#\:gammu-smsd-inject> ذخیره خواهند شد؛ مقادیر مشابه با InboxFormat را می‌پذیرد.
.sp
اگر Gammu همراه با توابع پشتیبان‌گیری کامپایل شده باشد، پیش‌فرض \fBdetail\fP است؛ در غیر این صورت \fBunicode\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B TransmitFormat
قالب برای ارسال پیامک: \fBauto\fP، \fBunicode\fP، \fB7bit\fP\&.
.sp
این گزینه تنها در صورتی استفاده می‌شود که \fBOutboxFormat\fP روی \fBdetail\fP تنظیم نشده باشد. در چنین حالتی از کدگذاری مشخص‌شده در پیام استفاده می‌شود (می‌توانید آن را به gammu\-smsd\-inject \%<#\:gammu-smsd-inject> مشخص کنید).
.sp
پیش‌فرض \fBauto\fP است.
.UNINDENT
.SH "فیلتر کردن پیام‌ها (MESSAGE FILTERING)"
.sp
دیمن SMSD امکان می‌دهد تنها زیرمجموعه محدودی از پیام‌های ورودی پردازش شوند. می‌توانید فیلترهایی را برای شماره فرستنده در بخش‌های \fB[include_numbers]\fP و \fB[exclude_numbers]\fP یا با استفاده از دستورالعمل‌های \fBIncludeNumbersFile\fP و \fBExcludeNumbersFile\fP تعریف کنید.
.sp
اگر بخش \fB[include_numbers]\fP وجود داشته باشد، تمام مقادیر آن (کلیدها نادیده گرفته می‌شوند) به عنوان شماره‌های تلفن مجاز استفاده می‌شوند و هیچ پیام دیگری پردازش نمی‌شود. از سوی دیگر، در \fB[exclude_numbers]\fP می‌توانید شماره‌هایی را مشخص کنید که می‌خواهید نادیده گرفته شوند.
.sp
فهرست‌های هر دو منبع با یکدیگر ادغام می‌شوند. اگر شماره‌ای در فهرست include وجود داشته باشد، تنها فهرست include استفاده می‌شود و فقط پیام‌های موجود در این فهرست پذیرفته می‌شوند. اگر فهرست include خالی باشد، فهرست exclude می‌تواند برای نادیده گرفتن پیام‌های برخی شماره‌ها استفاده شود. اگر هر دو فهرست خالی باشند، همه پیام‌ها پذیرفته می‌شوند.
.sp
قوانین فیلتر مشابهی را می‌توان برای فیلتر کردن شماره SMSC استفاده کرد؛ آن‌ها فقط از مجموعه متفاوتی از گزینه‌های پیکربندی استفاده می‌کنند \- بخش‌های \fB[include_smsc]\fP و \fB[exclude_smsc]\fP یا دستورالعمل‌های \fBIncludeSMSCFile\fP و \fBExcludeSMSCFile\fP\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
مثال کامل‌تری در مستندات Gammu موجود است. لطفاً توجه داشته باشید که برای سادگی، مثال‌های زیر شامل بخش \fB[gammu]\fP \%<#\:section-[gammu]> نیستند؛ می‌توانید برای دیدن نمونه‌هایی از نحوه پیکربندی آن به پرونده پیکربندی گامو \%<#\:gammurc> نگاه کنید.
.SS "سرویس پرونده‌ها (Files service)"
.sp
پرونده پیکربندی SMSD برای پشتیبان FILES می‌تواند شبیه به این باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[smsd]
Service = files
PIN = 1234
LogFile = syslog
InboxPath = /var/spool/sms/inbox/
OutboxPath = /var/spool/sms/outbox/
SentSMSPath = /var/spool/sms/sent/
ErrorSMSPath = /var/spool/sms/error/
.EE
.UNINDENT
.UNINDENT
.SS "سرویس MySQL (MySQL service)"
.sp
اگر می‌خواهید از پشتیبان MYSQL استفاده کنید، به چیزی شبیه به این نیاز خواهید داشت:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[smsd]
Service = sql
Driver = native_mysql
PIN = 1234
LogFile = syslog
User = smsd
Password = smsd
PC = localhost
Database = smsd
.EE
.UNINDENT
.UNINDENT
.SS "سرویس DBI با استفاده از SQLite (DBI service using SQLite)"
.sp
برای پشتیبان DBI \%<#\:gammu-smsd-dbi>، در این مورد خاص SQLite:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[smsd]
Service = sql
Driver = sqlite3
DBDir = /var/lib/sqlite3
Database = smsd.db
.EE
.UNINDENT
.UNINDENT
.SS "سرویس ODBC با استفاده از MySQL (ODBC service using MySQL)"
.sp
برای پشتیبان ODBC \%<#\:gammu-smsd-odbc>، در این مورد خاص با استفاده از کارساز DSN با نام \fBsmsd\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[smsd]
Service = sql
Driver = odbc
Host = smsd
.EE
.UNINDENT
.UNINDENT
.sp
تعریف DSN (در \fB~/.odbc.ini\fP در یونیکس) برای استفاده از کارساز MySQL به شکل زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[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
.EE
.UNINDENT
.UNINDENT
.SS "فیلتر کردن شماره‌ها (Numbers filtering)"
.sp
تنها پردازش پیام‌های ارسالی از شماره 123456:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[include_numbers]
number1 = 123456
.EE
.UNINDENT
.UNINDENT
.sp
عدم پردازش پیام‌های ارسالی از شماره ناخواسته 666:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[exclude_numbers]
number1 = 666
.EE
.UNINDENT
.UNINDENT
.SS "اشکال‌زدایی (Debugging)"
.sp
فعال‌سازی اشکال‌زدایی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[smsd]
debuglevel = 255
logfile = smsd.log
.EE
.UNINDENT
.UNINDENT
.SS "چندین مودم (Multiple modems)"
.sp
شما می‌توانید هر تعداد نمونه SMSD را اجرا کنید و آن‌ها حتی می‌توانند از یک پایگاه‌داده پشتیبان مشترک استفاده کنند. برای مسیریابی پیام‌ها، باید برای هر نمونه یک \fBPhoneID\fP متفاوت تنظیم کنید و ستون \fBSenderID\fP را در جدول صندوق خروجی \%<#\:outbox> مقداردهی نمایید.
.sp
مثال زیر پیکربندی دو مودم را نشان می‌دهد، اما شما می‌توانید هر تعداد نمونه SMSD داشته باشید. تنها محدودیت، عملکرد سخت‌افزار شما است، به ویژه اگر همه مودم‌ها با استفاده از USB متصل شده باشند.
.sp
پیکربندی برای اولین SMSD:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[gammu]
device = /dev/ttyACM0
connection = at

[smsd]
Service = sql
Driver = native_mysql
PIN = 1234
LogFile = syslog
User = smsd
Password = smsd
PC = localhost
Database = smsd
PhoneID = first
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی برای دومین SMSD:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[gammu]
device = /dev/ttyACM1
connection = at

[smsd]
Service = sql
Driver = native_mysql
PIN = 1234
LogFile = syslog
User = smsd
Password = smsd
PC = localhost
Database = smsd
PhoneID = second
.EE
.UNINDENT
.UNINDENT
.sp
سپس می‌توانید دو نمونه جداگانه از SMSD را راه‌اندازی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gammu\-smsd \-c /path/to/first\-smsdrc
gammu\-smsd \-c /path/to/second\-smsdrc
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Michal Čihař <michal@cihar.com>
.SH "حق نشر (COPYRIGHT)"
2009-2015, Michal Čihař <michal@cihar.com>
.\" End of generated man page.