Using Systemd Service Management

Contents

Initial Setup

A set of Systemd service and target units needs to be installed into the /usr/lib/systemd/system directory, and a wrapper script needs to be installed into the /sbin directory. A make file has been provided in order to make this easy to do. It can be found within the Autostart/Systemd subdirectory of BRLTTY's build tree. To install all of these files, change to this subdirectory and run the command:

make install

You then need to tell Systemd that the files have been installed. To do this, run the command:

systemctl daemon-reload

That's all you need to do. Your system is now able to manage BRLTTY instances via Systemd.

Managing the BRLTTY Service

Systemd manages BRLTTY instances on your system in a number of ways.

USB Braille Devices

If BRLTTY's Udev rules have also been installed then a BRLTTY instance will be automatically started when a USB braille device is connected, and automatically stopped when it's disconnected. Several braille devices can be managed in this way at the same time. They can be connected and disconnected at any time and in any order.

The Default Instance

The default BRLTTY instance is the one that's configured via the file /etc/brltty.conf. It's managed by applying standard Systemd commands to BRLTTY's target unit. For example:

systemctl enable brltty.target
systemctl start brltty.target
systemctl stop brltty.target
systemctl disable brltty.target

Additional Instances

Additional BRLTTY instances can be managed via target instance references. Each of them has its own configuration file.

If, for example, the name of an instance is iname, then its Systemd target name would be brltty@iname, its configuration file would be /etc/brltty_iname.conf, and it'd be managed via Systemd commands like these:

systemctl enable brltty@iname.target
systemctl start brltty@iname.target
systemctl stop brltty@iname.target
systemctl disable brltty@iname.target

Any number of instances may be managed in this way.