Provided by: gammu-smsd_1.27.92-3_i386 bug

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.

              See gammu-smsdrc(5) for config 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".

EXAMPLE

   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:\Gammu\smsdrc -i

       Install two instances of SMSD Windows service:

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

              gammu-smsd.exe -c c:\Gammu\smsdrc-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.

SEE ALSO

       gammu-smsdrc(5), gammu(1), gammu-smsd-inject(1), gammu-smsd-monitor(1)

       Documentation for different backends:

       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)

       For web based frontend to SMSD database (currently only MySQL is  being
       supported), please check Kalkun - <http://kalkun.sourceforge.net/>.

AUTHOR

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

COPYRIGHT

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

REPORTING BUGS

       Please report bugs to <http://bugs.cihar.com>.

       Before  reporting  a  bug,  please  enable  verbose  logging  in   SMSD
       configuration:

              [smsd]
              debuglevel = 255
              logfile = smsd.log

       and include this verbose log within bug report.