system-service

This is a skeleton of a system service implementation.

The service is a daemon application which:

1. It parses a text configuration file in INI format stored in /etc/example/daemon.conf.
2. Upon receiving signal SIGUSR1 it prints out parsed configuration to system log.
3. Upon receiving signal SIGHUP it reloads the configuration by reparsing the configuration file.
4. It provides D-Bus API that supports both operations above.

This project provides a Makefile with the following options:

make all
   - Compile the code and generates an executable file in ./bin folder.

make clean
   - Remove the ./bin and ./obj folders recursively.

make install
   - Place the executable file in /usr/local/bin/.
   - Place the system-service.service file in /etc/systemd/system/.
   - Place the daemon.conf (config file for the application) file in /etc/example/ (if the example directory does not exist it is created).
   - Place the com.redhat.SystemService.conf (config file with the D-Bus policies) file in /etc/dbus-1/sytem.d/.

make uninstall
   - Remove all files and directories created by make install.

Quick Start

Once you have cloned the project in your local directory execute:

make all
make install
systemctl start system-service.service
systemctl status system-service.service

You should watch the service is active and running. You can send the signals for printing out parsed configuration to system log:

kill -10 <PID>
tail -n20 /var/log/messages

Or for reloading the configuration:

kill -1 <PID>
kill -10 <PID>
tail -n20 /var/log/messages

If you want to use the D-Bus for printing out parsed configuration to system log:

dbus-send --system --type="method_call" --dest=com.redhat.SystemService /com/redhat/SystemService com.redhat.SystemService.LogConfig

Or for reloading the configuration:

dbus-send --system --type="method_call" --dest=com.redhat.SystemService /com/redhat/SystemService com.redhat.SystemService.ReloadConfig

Contributing

Please see our Contribution Guidelines.

We also follow a Coding Style Guidelines, please take this into account.