1GAMMU-SMSD(1)                 Gammu Documentation                GAMMU-SMSD(1)
2
3
4

NAME

6       gammu-smsd - SMS daemon for Gammu
7

SYNOPSIS

9       gammu-smsd [OPTION]...
10

DESCRIPTION

12       This manual page documents briefly the gammu-smsd command.
13
14       gammu-smsd  is a program that periodically scans GSM modem for received
15       messages, stores them  in  defined  storage  and  also  sends  messages
16       enqueued in this storage.
17
18       The  daemon  can  reload configuration file after sending hangup signal
19       (SIGHUP) and properly terminates itself on SIGINT and SIGTERM.
20
21       Program accepts following options (please note that long options  might
22       be not accepted on some platforms):
23
24       -h, --help
25              Shows help.
26
27       -v, --version
28              Shows version information and compiled in features.
29
30       -c, --config=file
31              Configuration file to use, default is /etc/gammu-smsdrc, on Win‐
32              dows there is no default and configuration file path has  to  be
33              always specified.
34
35       -p, --pid=file
36              Lock  file  for storing pid, empty for no locking. Not supported
37              on Windows.
38
39       -U, --user=user
40              Drop daemon privileges to chosed user after starting.
41
42       -G, --group=group
43              Drop daemon privileges to chosen group after starting.
44
45       -d, --daemon
46              Daemonize program on startup. Not supported on Windows.
47
48       -i, --install-service
49              Installs SMSD as a Windows service.
50
51       -u, --uninstall-service
52              Uninstalls SMSD as a Windows service.
53
54       -s, --start-service
55              Starts SMSD Windows service.
56
57       -k, --stop-service
58              Stops SMSD Windows service.
59
60       -X, --suicide=seconds
61              Kills itself after number of seconds.
62
63       -S, --run-service
64              Runs pogram as SMSD Windows service. This  should  not  be  used
65              manually,  but only Windows Service manager should use this com‐
66              mand.
67
68       -n, --service-name=name
69              Defines name of a Windows  service.  Each  service  requires  an
70              unique  name,  so if you want to run several SMSD instances, you
71              have to name each service differently. Default is "GammuSMSD".
72
73

EXAMPLE

75   Linux/Unix Examples
76       Start SMSD as a deamon on Linux:
77
78              gammu-smsd        --config        /etc/gammu-smsdrc        --pid
79              /var/run/gammu-smsd.pid --daemon
80
81
82       Start SMSD as a deamon on Linux with reduced privileges:
83
84              gammu-smsd        --config        /etc/gammu-smsdrc        --pid
85              /var/run/gammu-smsd.pid --daemon --user gammu --group gammu
86
87
88       SMSD as a system wide daemon
89
90              To use SMSD as a daemon, you might want to use init script which
91              is  shipped  with  Gammu  in  contrib/init  directory. It is not
92              installed by  default,  either  install  it  manually  or  check
93              INSTALL file for instructions.
94
95
96   Windows Service Examples
97       Install Gammu SMSD Windows service:
98
99              gammu-smsd.exe -c c:\Gammu\smsdrc -i
100
101
102       Install two instances of SMSD Windows service:
103
104              gammu-smsd.exe -c c:\Gammu\smsdrc-1 -n Gammu-first-phone -i
105
106              gammu-smsd.exe -c c:\Gammu\smsdrc-2 -n Gammu-second-phone -i
107
108
109       To uninstall a Windows service:
110
111              gammu-smsd.exe -u
112
113
114   Troubleshooting Windows Service
115       If  Gammu  fails  to  start  as a Windows service (you will usually get
116       "Error 1053: The service did  not  respond  to  the  start  or  control
117       request  in  a timely fashion"), first check your SMSD logs. If they do
118       not contain any useful hint, try starting SMSD  manually  with  exactly
119       same parameters as you installed the service (without -i), for example:
120
121           gammu-smsd.exe -c smsdrc
122
123       You  now  should  be  able  to get errors from SMSD even if it fails to
124       start as a service.
125
126

SEE ALSO

128       gammu-smsdrc(5), gammu(1), gammu-smsd-inject(1), gammu-smsd-monitor(1)
129
130       gammu-smsd-files(7),     gammu-smsd-mysql(7),      gammu-smsd-pgsql(7),
131       gammu-smsd-dbi(7), gammu-smsd-tables(7)
132

AUTHOR

134       gammu-smsd   and   this  manual  page  were  written  by  Michal  Cihar
135       <michal@cihar.com>.
136

138       Copyright © 2009 Michal Cihar and other authors.   License  GPLv2:  GNU
139       GPL version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>
140       This  is  free  software:  you  are free to change and redistribute it.
141       There is NO WARRANTY, to the extent permitted by law.
142

REPORTING BUGS

144       Please report bugs to <http://bugs.cihar.com>.
145
146       Before reporting a bug, please enable verbose logging in SMSD  configu‐
147       ration:
148
149           [smsd]
150           debuglevel = 255
151           logfile = smsd.log
152
153       and include this verbose log within bug report.
154
155
156
157Gammu 1.23.0                   January  15, 2009                 GAMMU-SMSD(1)
Impressum