NAME

       srcpd - SRCP speaking daemon

SYNOPSIS

       srcpd [ options ]

DESCRIPTION

       This   is  not  a  complete  manual.  You  have  to  consult  the  project  home  page  at
       http://srcpd.sourceforge.net/ for full documentation!

       srcpd is a UNIX daemon speaking the Simple Railroad Command Protocol (SRCP).

       Upon start up it reads in the system wide configuration file  named  srcpd.conf.  Contents
       and  structure of this XML-file is explained in detail in the srcpd.conf (5) man page. The
       SRCP specification is published on http://srcpd.sourceforge.net/srcp.

OPTIONS

       -h     Prints some useful help about command line options and exit

       -n     Do not daemonize upon start-up. The srcpd does not  switch  into  background  mode.
              This option can be used with the Ubuntu upstart system.

       -v     Print program version, SRCP level and exit

       -f <filename>
              Use  the  specified  filename  as the configuration file. The default value will be
              defined at compile time and can be displayed using the -h parameter.

NOTES

   Getting started
       The srcpd system service (daemon) is compliant to the Filesystem Hierarchy Standard  (FHS,
       http://www.pathname.com/fhs/). For more information and special options about daemon usage
       please refer to to your system documentation. The following instructions are on a  general
       level of information.

NOTES

       Please first start assembling a configuration file (srcpd.conf) fitting exactly your needs
       to connect to your model railway controller interface. Save this file to the directory for
       host  specific  system configuration (/etc). The default configuration file delivered with
       this software must be replaced by the new one.

       As soon as the adapted configuration file is at the right place, the daemon can be started
       using this command:

              /etc/init.d/srcpd start

       If  the  srcpd is already running, the daemon first must be stopped to get it aware of the
       new setup. Stopping the daemon is executed in analogy to the start command:

              /etc/init.d/srcpd stop

       Under certain conditions it is also possible to get the daemon re-read  its  configuration
       file  without  stopping  it. With respect to hardware access rules under UNIXlike systems,
       the group and/or user rights must be properly set in srcpd.conf to let the  daemon  access
       the appropriate hardware resources at any time.

       Common  model railway interfaces will require access rights for serial lines (RS232, USB),
       which can be achieved using the proper group rights (e.g.  dialout).  The  ddl-s88  module
       uses  a  special  system  function  (ioperm)  which  always  needs  root rights to perform
       successfully. The ioperm()  function  is  typically  only  available  on  x86  and  x86-64
       hardware. So if you are using other hardware and get an error about missing sys/io.h while
       compiling srcpd source code, just disable the ddl-s88 module. Refer to ./configure  --help
       for more details about how to disable special srcpd modules.

       To  let  srcpd  re-read  its  configuration  file,  assumed  the setup mentioned before is
       correct, the following command can be used:

              /etc/init.d/srcpd reload

       The log file /var/log/messages or /var/log/syslog of the syslog  daemon  can  be  used  to
       monitor  occurring  errors  on daemon start or during current operation.  With root rights
       the upcoming messages can be continuously watched in a separate terminal:

              tail -f /var/log/messages

       or

              tail -f /var/log/syslog

       The verbosity of these messages can be adjusted using the configuration  file  srcpd.conf.
       For more information refer to the adequate man page.

SEE ALSO

       srcpd.conf (5)

BUGS

       Possibly there are some bugs. Please report them to the project developer mailing list.

AUTHORS

       This  man  page  was  written  by  Matthias  Trute  (mtrute@users.sourceforge.net),  Frank
       Schimschke        (schmischi@users.sourceforge.net)        and        Guido         Scholz
       (gscholz@users.sourceforge.net).

LICENSE

       GNU General Public License, Version 2

                                        December 19, 2009                                srcpd(8)