NAME

       srcpd - SRCP sprechender Systemdienst

SYNTAX

       srcpd [ Optionen ]

BESCHREIBUNG

       Dieses  Handbuch  ist  nicht vollständig. Für weitere Informationen besuchen Sie bitte die
       Internetseite des Projektes unter http://srcpd.sourceforge.net/.

       Bei srcpd handelt  es  sich  um  einen  UNIX-Systemdienst  (Daemon)  zur  Steuerung  einer
       digitalen Modellbahn über das Simple Railroad Command Protocol (SRCP).

       Beim  Start liest das Programm die systemweite Konfigurationsdatei srcpd.conf ein. Hierbei
       handelt es sich um eine XML-Datei, deren Aufbau und  Inhalt  im  Handbuch  srcpd.conf  (5)
       näher   erläutert   sind.  Die  Spezifikation  von  SRCP  selbst  befindet  sich  auf  der
       Internetseite http://srcpd.sourceforge.net/srcp.

OPTIONEN

       -h     Ausgabe einiger kurzer Hinweise zur Benutzung.

       -n     Nach dem Start wechselt der srcpd nicht in  den  Hintergrund,  sondern  bleibt  als
              Vordergrundprozess aktiv. Dieses Verhalten ist für den Ubuntu »upstart« Mechanismus
              sinnvoll.

       -v     Ausgabe der Version des Programms und der unterstützten SRCP-Version.

       -f <Dateiname>
              Nutze den übergebenen Dateinamen als Konfigurationsdatei. Der voreingestellte  Wert
              für  diese  Datei  wird  beim Kompilieren des Programms festgelegt und kann mit der
              Option -h angezeigt werden.

BEMERKUNGEN

   Inbetriebnahme
       Der  srcpd  hält  sich  an  die  Konventionen  des  Filesystem  Hierarchy  Standard  (FHS,
       http://www.pathname.com/fhs/).        Für        weiterführende        und       spezielle
       Konfigurationsmöglichkeiten von Systemdiensten nutzen Sie bitte  die  Dokumentation  Ihres
       Betriebssystems.   Die  folgenden  Informationen  geben  allgemein  gültige  Hinweise  zur
       Konfiguration.

       Erstellen Sie zunächst eine  zu  ihrer  Modellbahnsteuerung  passende  Konfigurationsdatei
       (srcpd.conf).  Speichern  Sie diese dann mit Administrationsrechten im Verzeichnis für die
       systemweite Konfiguration (/etc) ab. Die mitgelieferte Beispieldatei  muss  dabei  ersetzt
       bzw. überschrieben werden.

       Sobald  die  angepasste Konfigurationsdatei vorliegt, kann der Daemon mit folgendem Befehl
       gestartet werden:

              /etc/init.d/srcpd start

       Läuft der srcpd-Daemon bereits, muss er zum  Einlesen  der  neuen  Konfiguration  zunächst
       angehalten  werden. Das Anhalten des Daemons erfolgt analog zum Startvorgang mit folgendem
       Befehl:

              /etc/init.d/srcpd stop

       Unter bestimmten Voraussetzungen kann der srcpd-Daemon auch  im  laufenden  Betrieb,  also
       ohne generellen Neustart, eine veränderte Konfigurationsdatei einlesen. Da der Zugriff auf
       Hardwareschnittstellen unter UNIXoiden Betriebssystemen über Berechtigungen geregelt wird,
       müssen  die  Rechte  für  den  srcpd-Daemon  in  der  Konfigurationsdatei  (srcpd.conf) so
       eingestellt werden, dass er jederzeit Zugriff auf die gewünschte Schnittstelle erhält.

       Für Modellbahnhardware, die über serielle Schnittstellen (USB, RS232)  angeschlossen  ist,
       reicht  es,  den  srcpd-Daemon  mit  der  entsprechenden Gruppenberechtigung (in der Regel
       »dialout«) zu betreiben. Beim »ddl-s88« Modul, das S88-Rückmeldungen  über  die  parallele
       Schnittstelle  einliest,  wird  eine  Systemfunktion  genutzt  (ioperm),  die  immer root-
       Berechtigung benötigt. Daher muss in diesem Fall der  srcpd-Daemon  mit  root-Berechtigung
       laufen.  Die  ioperm()  Funktion selbst ist typischerweise nur auf x86 und x86-64 Hardware
       verfügbar. Wenn sie ein anderes System nutzen möchten  und  beim  Compilieren  des  srcpd-
       Quellcodes  eine  Fehlermeldung  bezüglich  einer fehlenden sys/io.h Headerdatei bekommen,
       können sie das  ddl-s88  Modul  deaktivieren.  Näheres  zum  Aktivieren  und  Deaktivieren
       bestimmter srcpd-Module finden sie beim Aufruf von

               ./configure --help

       Zum   Neueinlesen  der  Konfigurationsdatei  dient,  unter  der  Voraussetzung,  die  oben
       geschilderten Bedingungen sind eingehalten, folgender Befehl:

              /etc/init.d/srcpd reload

       Zur Verfolgung von Fehlern beim Start oder im laufenden Betrieb, können Sie die  Log-Datei
       des  syslog-Systemdienstes  (/var/log/messages oder /var/log/syslog) nutzen. Die Meldungen
       lassen  sich  mit  Administrationsrechten  beispielsweise  in  einem  Terminalfenster  mit
       folgendem Befehl beobachten:

              tail -f /var/log/messages

       oder

              tail -f /var/log/syslog

       Die  Ausführlichkeit  der  dort erscheinenenden Meldungen lässt sich über Einstellungen in
       der srcpd.conf anpassen. Nähere Informationen hierzu bietet das zugehörige Handbuch.

SIEHE AUCH

       srcpd.conf (5)

FEHLER

       Sicher gibt es noch ein ganze Reihe  an  Fehlern.  Bitte  leiten  Sie  Fehlerberichte  und
       Vorschläge      für      Verbesserungen     an     die     Entwickler-Mailingliste     auf
       http://srcpd.sourceforge.net/.

AUTOREN

       Dieses Handbuch wurde geschrieben von Matthias Trute (mtrute@users.sourceforge.net), Frank
       Schimschke         (schmischi@users.sourceforge.net)        und        Guido        Scholz
       (gscholz@users.sourceforge.net).

LIZENZ

       GNU General Public License, Version 2

                                        19. Dezember 2009                                srcpd(8)