1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
SMS
Program do wysylania wiadomosci na telefony operatorow polskich sieci
komorkowych (Era, Plus, Idea, Heyah).
Autor: Mikolaj Rydzewski
Ostatnia zmiana: 20.4.2004
=-=-=-=-=-=-=-=-=-=-=
1. Licencja.
2. Do czego ten program sluzy?
3. Jak program dziala?
4. Jak go uzywac?
5. Konfiguracja
6. Powiadamianie o nowej poczcie.
=-=-=-=-=-=-=-=-=-=-=
1. Licencja.
Program ten udostepniony jest na zasadach licencji GPL v2, badz pozniejszej.
=-=-=-=-=-=-=-=-=-=-=
2. Do czego ten program sluzy?
Pozwala on wysylac krotkie wiadomosci tekstowe (SMS) poprzez internet
z komputera wprost na telefon komorkowy. Do wyslania wiadomosci nie jest
potrzebna interakcja z uzytkownikiem, moze byc wiec ona wyslana w automatyczny
sposob. Typowe zastosowania programu to:
- wysylanie powiadomien o nadejsciu nowej poczty
- wysylka komunikatow przez serwisy www
- wysylanie komunikatow dla administratorow przez rozne skrypty
Z racji na uzywanie (z reguly) bezplatnych bramek www->sms nie powinno sie
uzalezniac od dzialania programu istotnych aplikacji. Jesli uruchamia ktos
powazna usluge wymagajaca wysylania smsow, to z reguly tez stac go na
wykupienie stosownego abonamentu i/lub modemu GSM.
=-=-=-=-=-=-=-=-=-=-=
3. Jak program dziala?
Nie zglebiajac sie w szczegoly ;-) program udaje przegladarke www i wypelnia
formularze na stronach odpowiednich operatorow. Po wypelnieniu takiego
formularza 'wysyla' go do serwera co skutkuje (na ogol) wyslaniem wiadomosci.
W zaleznosci do strony program musi sie czasami przedtem zalogowac, lub
dokonac innych czynnosci. W niektorych przypadkach program moze tylko wyslac
maila do bramki operatora.
Wszystkie te czynnosci sa dla uzytkownika zupelnie niewidoczne. Podaje on
tylko numer telefonu, tresc wiadomosc do wyslania. Niekiedy musi jeszcze
okreslic przez ktora bramke wiadomosc ma zostac wyslana.
=-=-=-=-=-=-=-=-=-=-=
4. Jak go uzywac?
Wywolanie programu ma postac:
sms [opcje] numer telefonu [wiadomosc]
Numer telefonu podany jest bez prefiksu panstwa, czyli np. 602123123. Jesli
nie podano tresci wiadomosci w linii polecen to zostanie ona odczytana ze
standardowego wejscia.
Opcje to:
--split n
Dzieli dluzsze wiadomosci na maksymalnie n SMSow. Kazda bramka ma
swoj limit dlugosci pojedynczego SMSa.
--czat, --dlogin
SMS jest wysylany przez bramke IdeaCzat. Parametr --dlogin okresla
wtedy login pod ktory ma byc wyslana wiadomosc. W pliku .smsrc
nalezy podac swoj login i haslo i w usludze IdeaCzat.
--1rstwap
Wysyla wiadomosci przez bramke www.1rstwap.com. W pliku .smsrc
nalezy podac login i haslo do ww bramki.
--mbox
Wysyla wiadomosci przez portal www.idea.pl. W pliku .smsrc
nalezy podac login i haslo do ww portalu.
--plusmail
SMSy na numery w sieci PlusGSM sa wysylane mailem na adres
<numertelefonu@text.plusgsm.pl> a nie przez bramke na stronie www.
--mplusa
SMS zostanie wyslany bramka serwisu www.miastoplusa.pl - jest on
dostepny tylko dla zalogowanych uzytkownikow. Login i haslo do
serwisu nalezy wpisac do pliku .smsrc.
--mbox
SMS zostanie wyslany bramka serwisu www.idea.pl - jest on dostepny
tylko dla zalogowanych uzytkownikow. Login i haslo do portalu
nalezy wpisac do pliku .smsrc.
--eranet
Jesli adresat wiadomosci ma wykupiona usluge EraNet to SMS moze
zostac wyslany na jego skrzynke w ww usludze. Tak naprawde ma to
sens chyba jedynie wtedy kiedy sami sobie wysylamy SMSy - np.
z roznych automagicznych skryptow na serwerze.
--nike
Wysyla wiadomosci przez bramke nikemowan.com. W tej chwili bramka
ta pozwala na wysylanie wiadomosci na telefony w sieciach Era i Idea.
--cfg
Okresla nazwe pliku konfiguracyjnego do wykorzystania, zamiast
domyslnego.
--check
Sprawdza czy na stronie z programem jest dostepna jego nowsza wersja.
--from
Niektore bramki pozwalaja okreslic adres nadawcy. Program stara sie
ustawic adres nadawcy na adres mailowy konta z ktorego jest
uruchamiany. Opcja ta pozwala na wymuszenie innego adresu.
--ip
Jesli komputer z ktorego wysylane sa wiadomosci posiada kilka
intefejsow sieciowych to opcja ta pozwala okreslic ktory ma byc
uzywany do nawiazywania polaczen. Ma to znaczenie gdy ktoras z
bramek posiada ograniczenie na ilosc SMSow wyslanych z okreslonego
adresu IP.
--sign
Ustawia podpis SMSa. Domyslnie podpis jest pusty.
--thanksto
Pokazuje liste osob ktore przyczynily sie do rozwoju programu.
Przyklady wywolania:
sms --eranet 602123123 "wszystko ok"
Wysle na konto 602123123 w usludze EraNet podany komunikat
/usr/bin/check | sms --nike 502123123
Wysle za pomoca bramki nikewoman na telefon w sieci Idea wynik dzialania
programu /usr/bin/check
=-=-=-=-=-=-=-=-=-=-=
5. Konfiguracja.
Niektore parametry dzialania programu moga byc podane w pliku konfiguracyjnym.
Pliki konfiguracyjne odczytywane sa w kolejnosci:
/etc/smsrc
~/.smsrc
O ile jest zdefiniowana zmienna srodowiska CONFIG_DIR to zamiast pliku
~/.smsrc odczytywany jest plik $CONFIG_DIR/smsrc.
Przykladowy plik konfiguracyjny jest umieszczony w pliku README.smsrc.
=-=-=-=-=-=-=-=-=-=-=
6. Powiadamianie o nowej poczcie.
Program jest chyba najczesciej uzywany wlasnie do tego celu. Zreszta dlatego
tez go kiedys napisalem ;-) Ponizszy opis ma zastosowanie w srodowisku
Unix/Linux z tak skonfigurowanym systemem poczty, ze mozliwe jest korzystanie
z programu procmail.
W momencie nadejscia poczty system uruchamia program procmail, ktory m.in. ma
za zadanie dostarczyc poczte do naszej skrzynki. Jesli jednak w katalogu
domowym uzytkownika znajduje sie plik .procmailrc to procmail wykona
odpowiednie polecenia w nim zawarte. W katalogu contrib/ znajduje sie
przykladowy plik procmailrc pozwalajacy na wysylanie wiadomosci
z powiadomieniami o nowych mailach. Wymaga on podania poprawnych sciezek do
programow sms oraz mimecut (takze w katalogu contrib).
=-=-=-=-=-=-=-=-=-=-=
|
