LADI
/
jack-audio-connection-kit-docs
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

installation-filesystem-layout.adoc: Adjust for asciidoc format

This commit is contained in:
Nedko Arnaudov 2023-05-27 20:40:37 +03:00
parent 1ceda69897
commit 6318725689
1 changed files with 14 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
installation-filesystem-layout.adoc
View File

@ -1,6 +1,6 @@
This page represents installation layout on a Linux system.
# Binaries
== Binaries
This includes:
@ -11,7 +11,7 @@ This includes:
They are installed in `<PREFIX>/bin/`.
# Libraries
== Libraries
The `libjack`, `libjacknet` and `libjackserver` libraries are installed in `<PREFIX>/lib/`.
@ -22,15 +22,15 @@ A libtool-like installation is made with `.la` files and symbolic links, like th
libjack.so.0 --> libjack.so.0.1.0
libjack.so.0.1.0
## Drivers
== Drivers
Jack drivers are installed into `<PREFIX>/lib/jack/` as dynamic libraries.
## In-process clients
== In-process clients
In-process clients are installed into `<PREFIX>/lib/jack/`.
# D-Bus service file
== D-Bus service file
If `jackdbus` is being installed, a D-Bus service file is installed too. This file instructs the D-Bus session bus how to activate the JACK controller object upon request.
@ -40,32 +40,32 @@ However, a user may force using the real D-Bus service directory by specifying `
The D-Bus service file directory `<PREFIX>/share/dbus-1/services/` will differ from the one specified in the pkg-config file of D-Bus when they are installed in different prefixes. If the service file is installed in a different prefix, the D-Bus session bus daemon should be instructed to search in the appropriate directory (out of scope of JACK installation process, as implemented in the distribution tarball).
# Systemd unit
== Systemd unit
A systemd unit file is installed as `<PREFIX>/lib/systemd/user/jack@.service`. System-wide configuration files for this systemd unit should be put in `/etc/jack` and user configuration files in `~/.config/jack` with a `.conf` filename extension.
# Headers
== Headers
C headers are installed in a JACK specific header directory, `<PREFIX>/include/jack/`.
# pkg-config
== pkg-config
`jack.pc` is installed in `<PREFIX>/lib/pkgconfig/`.
# User documentation
== User documentation
Man pages are installed in `<PREFIX>/share/man/man1/`.
# Development documentation
== Development documentation
HTML documentation is installed in a JACK specific directory `<PREFIX>/share/jack-audio-connection-kit`.
The index file of the HTML documentation is in `<PREFIX>/share/jack-audio-connection-kit/reference/html/`.
# Additional notes
== Additional notes
Some unusual things related to installation relocateability:
* in-process clients and drivers are loaded from a fixed path (`<PREFIX>/lib/jack/`), specified literally during build. Drivers load directory may be overridden using the `JACK_DRIVER_DIR` environment variable. At the moment there is no way to override the in-process client directory.
* The D-Bus session bus daemon configuration may need modification to be able to auto-activate the JACK controller service.
* The `jack.pc` file contains `<PREFIX>`.
* in-process clients and drivers are loaded from a fixed path (`<PREFIX>/lib/jack/`), specified literally during build. Drivers load directory may be overridden using the `JACK_DRIVER_DIR` environment variable. At the moment there is no way to override the in-process client directory.
* The D-Bus session bus daemon configuration may need modification to be able to auto-activate the JACK controller service.
* The `jack.pc` file contains `<PREFIX>`.