1srcpd(8)                    System Manager's Manual                   srcpd(8)
2
3
4

NAME

6       srcpd - SRCP speaking daemon
7
8

SYNOPSIS

10       srcpd [ options ]
11
12

DESCRIPTION

14       This  is  not  a  complete manual. You have to consult the project home
15       page at http://srcpd.sourceforge.net/ for full documentation!
16
17       srcpd is a UNIX daemon speaking the Simple  Railroad  Command  Protocol
18       (SRCP).
19
20       Upon  start  up  it  reads  in the system wide configuration file named
21       srcpd.conf. Contents and structure of this  XML-file  is  explained  in
22       detail  in  the srcpd.conf (5) man page. The SRCP specification is pub‐
23       lished on http://srcpd.sourceforge.net/srcp.
24
25

OPTIONS

27       -h     Prints some useful help about command line options and exit
28
29       -n     Do not daemonize upon start-up. The srcpd does not  switch  into
30              background mode. This option can be used with the Ubuntu upstart
31              system.
32
33       -v     Print program version, SRCP level and exit
34
35       -f <filename>
36              Use the  specified  filename  as  the  configuration  file.  The
37              default  value  will  be defined at compile time and can be dis‐
38              played using the -h parameter.
39
40

NOTES

42   Getting started
43       The srcpd system service (daemon) is compliant to the Filesystem  Hier‐
44       archy  Standard  (FHS, http://www.pathname.com/fhs/). For more informa‐
45       tion and special options about daemon usage please  refer  to  to  your
46       system documentation. The following instructions are on a general level
47       of information.
48
49

NOTES

51       Please first start assembling a configuration file (srcpd.conf) fitting
52       exactly  your  needs to connect to your model railway controller inter‐
53       face. Save this file to the directory for host specific system configu‐
54       ration (/etc). The default configuration file delivered with this soft‐
55       ware must be replaced by the new one.
56
57       As soon as the adapted configuration file is at the  right  place,  the
58       daemon can be started using this command:
59
60              /etc/init.d/srcpd start
61
62       If  the  srcpd  is already running, the daemon first must be stopped to
63       get it aware of the new setup. Stopping the daemon is executed in anal‐
64       ogy to the start command:
65
66              /etc/init.d/srcpd stop
67
68       Under  certain conditions it is also possible to get the daemon re-read
69       its configuration file without stopping it. With  respect  to  hardware
70       access  rules under UNIXlike systems, the group and/or user rights must
71       be properly set in srcpd.conf to let the daemon access the  appropriate
72       hardware resources at any time.
73
74       Common  model  railway interfaces will require access rights for serial
75       lines (RS232, USB), which can be achieved using the proper group rights
76       (e.g. dialout). The ddl-s88 module uses a special system function (iop‐
77       erm) which always needs root rights to perform successfully.
78
79       To let srcpd re-read its configuration file,  assumed  the  setup  men‐
80       tioned before is correct, the following command can be used:
81
82              /etc/init.d/srcpd reload
83
84       The  log file /var/log/messages or /var/log/syslog of the syslog daemon
85       can be used to monitor occurring errors on daemon start or during  cur‐
86       rent operation.  With root rights the upcoming messages can be continu‐
87       ously watched in a separate terminal:
88
89              tail -f /var/log/messages
90
91       or
92
93              tail -f /var/log/syslog
94
95       The verbosity of these messages can be adjusted using the configuration
96       file srcpd.conf. For more information refer to the adequate man page.
97
98

SEE ALSO

100       srcpd.conf (5)
101
102

BUGS

104       Possibly  there are some bugs. Please report them to the project devel‐
105       oper mailing list.
106
107

AUTHORS

109       This man page  was  written  by  Matthias  Trute  (mtrute@users.source‐
110       forge.net),   Frank  Schimschke  (schmischi@users.sourceforge.net)  and
111       Guido Scholz (gscholz@users.sourceforge.net).
112
113

LICENSE

115       GNU General Public License, Version 2
116
117
118
119                               December 19, 2009                      srcpd(8)
Impressum