GAMMU-SMSD(1)							       Gammu							     GAMMU-SMSD(1)

NAME

       gammu-smsd - SMS daemon for Gammu

SYNOPSIS

       gammu-smsd [OPTION]...

DESCRIPTION

       This manual page documents briefly the gammu-smsd command.

       gammu-smsd  is  a  program  that periodically scans GSM modem for received messages, stores them in defined storage and also sends messages
       enqueued in this storage.

       The daemon can reload configuration file after sending hangup signal (SIGHUP) and properly terminates itself on SIGINT and SIGTERM.

       Program accepts following options (please note that long options might be not accepted on some platforms):

       -h, --help
	      Shows help.

       -v, --version
	      Shows version information and compiled in features.

       -c, --config=file
	      Configuration file to use, default is /etc/gammu-smsdrc, on Windows there is no default and configuration file path has to be always
	      specified.

	      If  you  run SMSD as a system daemon (or service), it is recommended to use absolute path to configuration file as startup directory
	      might be different than you expect.

	      See gammu-smsdrc for configuration file documentation.

       -p, --pid=file
	      Lock file for storing pid, empty for no locking. Not supported on Windows.

       -U, --user=user
	      Drop daemon privileges to chosed user after starting.

       -G, --group=group
	      Drop daemon privileges to chosen group after starting.

       -d, --daemon
	      Daemonize program on startup. Not supported on Windows.

       -i, --install-service
	      Installs SMSD as a Windows service.

       -u, --uninstall-service
	      Uninstalls SMSD as a Windows service.

       -s, --start-service
	      Starts SMSD Windows service.

       -k, --stop-service
	      Stops SMSD Windows service.

       -f, --max-failures=count
	      Terminate after defined number of failures. Use 0 to not terminate (this is default).

       -X, --suicide=seconds
	      Kills itself after number of seconds.

       -S, --run-service
	      Runs pogram as SMSD Windows service. This should not be used manually, but only Windows Service manager should use this command.

       -n, --service-name=name
	      Defines name of a Windows service. Each service requires an unique name, so if you want to run several SMSD instances, you  have	to
	      name each service differently. Default is "GammuSMSD".

       -l, --use-log
	      Use logging as configured in config file (default).

       -L, --no-use-log
	      Do not use logging as configured in config file.

       -e, --install-event-log
	      Installs Windows EventLog description to registry.

	      New in version 1.31.90.

       -E, --uninstall-event-log
	      Uninstalls Windows EventLog description to registry.

	      New in version 1.31.90.

SIGNALS

       SMSD can be controlled using following POSIX signals (if your platform supports this):

       SIGHUP Reload configuration and reconnect to phone.

       SIGINT, SIGTERM
	      Gracefully shutdown the daemon.

       SIGALRM
	      Used internally for gammu-smsd -X

       SIGUSR1
	      Suspends SMSD operartion, closing connection to phone and database.

       SIGUSR2
	      Resumes SMSD operattion (after previous suspend).

       Changed in version 1.22.91: Added support for SIGHUP.

       Changed in version 1.22.95: Added support for SIGALRM.

       Changed in version 1.31.90: Added support for SIGUSR1 and SIGUSR2.

EXAMPLES

   Linux/Unix Examples
       Start SMSD as a daemon on Linux:

       gammu-smsd --config /etc/gammu-smsdrc --pid /var/run/gammu-smsd.pid --daemon

       Start SMSD as a daemon on Linux with reduced privileges:

       gammu-smsd --config /etc/gammu-smsdrc --pid /var/run/gammu-smsd.pid --daemon --user gammu --group gammu

   SMSD as a system wide daemon
       To  use	SMSD  as a daemon, you might want to use init script which is shipped with Gammu in contrib/init directory. It is not installed by
       default, either install it manually or check INSTALL file for instructions.

       Under Windows 7 you might need to disable UAC (user account control) before you will be able to install SMSD service.

   Windows Service Examples
       Install Gammu SMSD Windows service:

       gammu-smsd.exe -c c:Gammusmsdrc -i

       Install two instances of SMSD Windows service:

       gammu-smsd.exe -c c:Gammusmsdrc-1 -n Gammu-first-phone -i

       gammu-smsd.exe -c c:Gammusmsdrc-2 -n Gammu-second-phone -i

       To uninstall a Windows service:

       gammu-smsd.exe -u

   Troubleshooting Windows Service
       If Gammu fails to start as a Windows service (you will usually get "Error 1053: The service did not respond to the start or control request
       in  a  timely  fashion"),  first check your SMSD logs. If they do not contain any useful hint, try starting SMSD manually with exactly same
       parameters as you installed the service (without -i).

       For example the command line can look like:

       gammu-smsd.exe -c smsdrc

       You now should be able to get errors from SMSD even if it fails to start as a service.

KNOWN LIMITATIONS

       You can not use same phone by more programs in same time. However in case you did not enable locking in [gammu] section, it might  be  able
       to start the communication with phone from more programs. In this case neither of the programs will probably work.

       There  is  no way to detect that SMS message is reply to another by looking at message headers. The only way to achieve this is to add some
       token to the message and let the user include it in the message on reply.

AUTHOR

       Michal iha <michal@cihar.com>

COPYRIGHT

       2009-2012, Michal iha <michal@cihar.com>

1.31.90 							 February 24, 2012						     GAMMU-SMSD(1)