GAMMU-SMSDRC(5)

JMÉNO

gammu-smsdrc - konfigurační soubor pro gammu-smsd(1)

SYNTAXE
/etc/gammu-smsdrc

POPIS
gammu-smsd(1) čte konfiguraci z konfiguračního souboru. Jeho umístění může být zadáno na příkazové řádce, jinak se použije /etc/gammu-smsdrc. Tento soubor používá syntaxi ini souborů, komentáře mohou být značeny buď ; nebo #. Sekce souboru jsou zapsány v hranatých závorkách jako [toto].Všechny hodnoty klíčů nerozlišují velikost písmen. Konfigurační soubor pro gammu-smsd se skládá alespoň ze dvou sekcí - [gammu] a [smsd]. Sekce [gammu] je konfigurací připojení k telefonu a je stejná jako je popsáno v gammurc(5) s jedinou vyjímkou a to ignorování direktivy logfile, protože logování je prováděno přes SMS démona. Nicméně direktiva logformat stále určuje jak moc ladicích hlášek bude gammu předávat. Sekce [smsd] nastavuje SMS démona a je popsána v následující části textu. Nejdříve jsou popsány obecné parametry SMS démona a pak parametry pro jednotlivé služby. Dále jsou volitelné sekce [include_numbers] a [exclude_numbers], které ovládají filtrování zpráv (viz dále).

  Obecné parametry SMS démona

Service
    Jakou službu SMSM použít, jedna z FILES, NULL, MYSQL, PGSQL, DBI (záleží na zakompilovaných knihovnách). FILES - ukládá zprávy v souborech, pro podrobnosti viz gammu-smsd-files(7)
    NULL - vůbec neukládá zprávy, pro podrobnosti viz gammu-smsd-null(7)
    MYSQL - ukládá zprávy v MySQL databázi, pro podrobnosti viz gammu-smsd-mysql(7)
    PGSQL - ukládá zprávy v databázi PostgreSQL, pro podrobnosti viz gammu-smsd-pgsql(7)
    DBI - ukládá zprávy v jakékoliv databázi podporované libdbi, toto zahrnje MSSQL, MySQL, PostgreSQL nebo SQLite , pro podrobnosti viz gammu-smsd-dbi(7)

PIN PIN pro SIM kartu. Tento parametr je volitelný, ale měl by být zadán, pokud telefon po restartu vyžaduje PIN.

NetworkCode
    Heslo nastavení sítě. Tento parametr je volitelný, ale měl by být zadán, pokud ho telefon po zapnutí vyžaduje.

PhoneCode
    Heslo zámku telefonu. Tento parametr je volitelný, ale měl by být zadán, pokud ho telefon po zapnutí vyžaduje.

LogFile
    Soubor, kde budou zaznamenány informace o akcích prováděných SMSD. Můžete také použít speciální hodnotu "syslog", která zapne logování prostřednictvím syslog démona. Na Windows je možné použít jinou speciální hodnotu "eventlog", při které budou záznamy posílány do Logu Událostí ve Windows. Pokud je SMSD spuštěn jako systémový démon (nebo služba), doporučujeme používat absolutní cestu, protože adresář, kde bude program spuštěn se může lišit od toho, co očekáváte. Výchozí stav je vypnuté logování.

DebugLevel
    Ladicí úroveň SMSD. Číslo je součtem všech hodnot, které chcete logovat. 1 - základní ladicí informace
    2 - logování SQL dotazů
    4 - zapne logování ladicích informací gammu Pro maximální množství ladicích informací nastavte 255. Výchozí je 0, což znamená žádné ladicí informace.

CommTimeout
    Kolik sekund by měl SMSD čekat po každé, když není nalezena žádná zpráva k odeslání. Výchozí je 30.

SendTimeout
    Určuje kolik sekund má SMSD čekat na odpověď sítě během odesílání zprávy. Pokud se během té doby nic nestane, zpráva bude odeslána znovu. Výchozí je 30.

MaxRetries
    Kolikrát se bude SMSD pokoušet znovu odeslat zprávu pokud se to na první pokus nepodaří. Výchozí je 1.

ReceiveFrequency
    Počet sekund mezi zjišťováním, zda jsou nějaké nově přijaté SMS zprávy, pokud je telefon zaměstnán odesíláním zpráv. Obvykle se nové zprávy hledají každých CommTimeout sekund a po každé odeslané SMS. Výchozí je 0 (není použito).

StatusFrequency
    Počet sekund mezi načítáním stavu telefonu (baterie a signál) a ukládáním do sdílené paměti a případně to úložiště používané služby. Pro nenačítání těchto informací nastavte 0. Výchozí je 15.

LoopSleep
    Počet sekund, kolik bude SMSD spát před zjišťováním nějaké aktivity. Hodnota větší než 1 bude mít vliv na ostatní nastavení časů, protože ty pak budou efektivně zaokrouhlena nahoru na nejbližší násobek tohoto nastavení. Výchozí je 1.

MultipartTimeout
    Počet sekund jak dlouho bude SMSD čekat na doručení všech částí zprávy. Pokud všechny části nedorazí včas, budou zpracovány jako samostatné zprávy. Výchozí je 600 (10 minut).

CheckSecurity
    Jestli se má kontrolovat, zda telefon vyžaduje PIN. Výchozí je 1 (povoleno).

CheckBattery
    Jestli se má periodicky kontrolovat stav baterie telefonu. Výchozí je 1 (povoleno).

CheckSignal
    Jestli se má periodicky kontrolovat stav signálu. Výchozí je 1 (povoleno).

ResetFrequency
    Počet sekund mezi provádění preventivního resetu telefonu. Tato volba může zabránit zatuhnutí některý telefonů (například Nokia 5110), které při delším použivání přestanou reagovat a jen vyndání baterie je může oživit. Výchozí je 0 (není použito).

DeliveryReport
    Jak mají být používány doručenky, jedna z možností 'no', 'log', 'sms'. log - logovat informace o doručenkách,
    sms - ukládat doručenky jako příchozí SMS.
    no - nevyžadovat doručenky Výchozí je 'no'.

DeliveryReportDelay
    Prodleva v sekundách, jak dlouho je doručenka považována za platnou. Tento parametr závisí na chybách v použité síti (doručenka by měla obsahovat stejný čas jako odeslaná zpráva). Zvyšte tuto hodnotu pokud se Gammu nedaří spárovat doručenky s odeslanými zprávami. Výchozí je 600 (10 minut).

PhoneID
    Text s informací o telefou, použité při odesílání a přijímání. Tato volba může být užitečná, pokud chcete provozovat více SMS démonů. Pokud nastavíte PhoneID, všechny zprávy (včetně těch vložených pomocí gammu-smsd-inject) budou označeny tímto textem a tím bude umožněno více démonům sdílet jednu databázi. Tento parametr nemá žádný vliv na službu ukládání zpráv do souborů (FILES).

RunOnReceive
    Spustí program po přijetí zprávy. Tento prarametr je spuštěn přes shell, takže možná budete potřebovat escapovat některé znaky a můžete použít jakékoliv množství parametrů. SMSD dále přidá parametry s identifikátory přijatých zpráv. Typ identifikátorů záleží na použité službě, pro databázové služby je to obvykle ID vloženého řádku, pro souborové pak jméno souboru. Gammu SMSD čeká na ukončení skriptu. Pokud budete provádět nějaké časově náročné operace, zastavíte přijímání nových zpráv. Aby se zabránilo větším komplikacím, čeká SMSD maximálně dvě minuty. Po této době bude pokračovat v normálním běhu a může spustit váš skript znovu. Spuštěný proces má v prostředí dostupné množství informací o přijaté zprávě, více podrobností naleznete v gammu-smsd-run(7).

IncludeNumbersFile
    Soubor se seznamem čísel, která bude SMSD přijímat. Soubor obsahuje na každém řádku jedno číslo, prázdné řádky jsou ignorovány. Soubor je načten při startu a znovu načten je jen při znovunačtení konfigurace. Více podrobností v sekci Filtrování zpráv.

ExcludeNumbersFile
    Soubor se seznamem čísel, která nebude SMSD přijímat. Soubor obsahuje na každém řádku jedno číslo, prázdné řádky jsou ignorovány. Soubor je načten při startu a znovu načten je jen při znovunačtení konfigurace. Více podrobností v sekci Filtrování zpráv.

IncludeSMSCFile
    Soubor se seznamem čísel SMSC, která bude SMSD přijímat. Soubor obsahuje na každém řádku jedno číslo, prázdné řádky jsou ignorovány. Soubor je načten při startu a znovu načten je jen při znovunačtení konfigurace. Více podrobností v sekci Filtrování zpráv.

ExcludeSMSCFile
    Soubor se seznamem čísel SMSC, která nebude SMSD přijímat. Soubor obsahuje na každém řádku jedno číslo, prázdné řádky jsou ignorovány. Soubor je načten při startu a znovu načten je jen při znovunačtení konfigurace. Více podrobností v sekci Filtrování zpráv.

BackendRetries
    How many times will SMSD backend retry operation. The implementation on different backends is different, for database backends it generally means how many times it will try to reconnect to the server. Výchozí je 10.

  Parametry pro služby používající databázi
Všechny ze služeb DBI, MYSQL a PGSQL (viz gammu-smsd-mysql(7), gammu-smsd-pgsql(7), gammu-smsd-dbi(7)) podporují stejné parametry pro nastavení připojení k databázi:

User
    Uživatelské jméno pro připojení k databázi.

Password
    Heslo použité pro připojení k databázi.

PC  Adresa databázového serveru. Za dvojtečkou může být také zadán port nebo cesta k socketu, například localhost:/path/to/socket.

Database
    Jméno databáze, která se má použít. Před spuštěním gammu-smsd musí být vytvořeny všechny potřebné tabulky. Pro tento účel můžete použít SQL souboru obsažené v dokumentaci.

SkipSMSCNumber
    Pokud odešlete SMS zprávu přes nějaké SMS centrum, může se stát, že doručenky přijdou z jiného SMS centra. Pro tento případ použijte tento parametr a nastavte zde takovéto SMS centrum. Gammu pak nebude kontrolovat číslo tohoto SMS centra při přiřazování doručenek zprávám.

Driver
    Který ovladač DBI se má použít. Možnosti závisí na tom, které máte nainstalovány. DBI podporuje: mysql, freetds (umožňuje přístup k MS SQL Serveru a Sybase), pgsql, sqlite, sqlite3, firebird a ovladače ingres, msql a oracle se vyvíjejí.

DriversPath
    Cesta, kde jsou umístěny ovladače DBI. Tento parametr obvykle není potřeba nastavovat, pokud jsou ovladače nainstalovány správně.

DBDir
    Adresář, kde je uložena databáze pro některé (v současné době pouze sqlite) ovladače DBI. Nastavte zde cestu. kde je uložen soubor se sqlite databází.

  Parametry pro službu používající soubory
Služba FILES používá následující konfigurační volby. Podrobnější popis této služby je v gammu-smsd-files(7). Prosím ujistěte se, že všechny cestky končí oddělovačem cest (na Unixových systémech /):

InboxPath
    Kde jsou ukládány přijaté zprávy. Výchozí je aktuální adresář.

OutboxPath
    Kde jsou umístěny zprávy ve frontě k odeslání. Výchozí je aktuální adresář.

SentSMSPath
    Kde jsou ukládány přenesené zprávy. Pokud je cesta stejná jako OutBoxPath, zprávyjsou vymazány. Výchozí je mazat přenesené zprávy.

ErrorSMSPath
    Kde jsou umístěny SMS po chybě při odesílání. Výchozí je stejné jako SentSMSPath.

InboxFormat
    Formát ukládání SMS: 'detail', 'unicode', 'standard'. detail - formát používaný gammu(1) pro zálohy zpráv
    unicode - text zprávy uložený v unicode (UTF-16)
    standard - text zprávy uložený v systémovém kódování Nastavení 'standard' a 'unicode' nemají vliv na 8-bitové zprávy, které jsou vždy zapsány tak jak přišly s příponou bin. Výchozí je 'unicode'.

OutboxFormat
    Formát ve kterém budou vytvářeny zprávy programem gammu-smsd-inject(1), lze použít stejné hodnoty jako u InboxFormat. Výchozí hodnota je 'detail' pokud Gammu zkompilováno podporou pro zálohy, jinak 'unicode'.

TransmitFormat
    Formát přenosu SMS: 'auto', 'unicode', '7bit'. Výchozí je 'auto'.

  Filtrování zpráv
SMSD umožňuje zpracovat jen část přijatých zpráv. Filtry pro číslo odesílatele můžete definovat v sekcích [include_numbers] a [exclude_numbers] nebo pomocí parametrů IncludeNumbersFile a ExcludeNumbersFile. Pokud existuje sekce [include_numbers], všechny hodnoty z ní (klíče jsou ignorovány) jsou použity jako povolená čísla a jiné zprávy nejsou zpracovány. Naopak v [exclude_numbers] můžete zadat jaká čísla chcete ignorovat. Seznamy z obou zdrojů jsou sloučeny. Pokud je v seznamu povolených čísel alespoň jedno číslo, použije se jen tento seznam a budou zpracovány jen zprávy od čísel v tomto seznamu. Pokud je tento seznam prázný a v seznamu zakázaných čísel je nějaké číslo, nebudou zpracovány zprávy z čísel v tomto seznamu. Pokud jsou oba seznamy prázdné, jsou zpracovány všechny zprávy. Podobná pravidla mohou být použita pro filtrování čísel centra zpráv SMSC, jen používají jiné konfigurační parametry - [include_smsc] a [exclude_smsc] nebo pomocí parametrů IncludeSMSCFile a ExcludeSMSCFile.

PŘÍKLAD
Kompletnější ukázka je dostupná v dokumentaci Gammu. Pro jednoduchost následující příklady neobsahují sekci [gammu], na její příkladu se můžete podívat do gammurc(5). Konfigurační soubor pro SMSD používající službu FILES by mohl vypadat takto:

    [smsd]
    Service = files
    PIN = 1234
    LogFile = syslog
    InboxPath = /var/spool/sms/inbox/
    OutboPpath = /var/spool/sms/outbox/
    SentSMSPath = /var/spool/sms/sent/
    ErrorSMSPath = /var/spool/sms/error/

Pokud chcete použít službu MYSQL, bute potřebovat přibližně toto:

    [smsd]
    Service = mysql
    PIN = 1234
    LogFile = syslog
    User = smsd
    Password = smsd
    PC = localhost
    Database = smsd

Zpracovávat jen zprávy od čísla 123456:

    [include_numbers]
    number1 = 123456

Nezpracovávat zprávy od ďábelského čísla 666:

    [exclude_numbers]
    number1 = 666

DALŠÍ INFORMACE
gammu-smsd(1), gammu(1), gammurc(5) gammu-smsd-files(7), gammu-smsd-mysql(7), gammu-smsd-pgsql(7), gammu-smsd-dbi(7), gammu-smsd-tables(7), gammu-smsd-null(7), gammu-smsd-run(7)

AUTOR
gammu-smsd a tuto manuálovou stránku napsal Michal Čihař <michal@cihar.com>.

COPYRIGHT
Copyright © 2009 Michal Čihař a další autoři. Licence GPLv2: GNU GPL verze 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>
Tento program je svobodný software; můžete jej šířit a modifikovat. Není poskytována ŽÁDNÁ ZÁRUKA, v rozsahu jaký je povolen zákonem.

HLÁŠENÍ CHYB
Prosím hlašte chyby na <http://bugs.cihar.com>. Před hlášením chyb prosím zapněte logovaní v nastavení SMSD:

    [smsd]
    debuglevel = 255
    logfile = smsd.log

a přiložte tento log k hlášení chyby.