JeroenED/retroarch-standalone-service
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

supply empty file for environment variables

Browse Source
This commit is contained in:
graysky 2021-05-23 06:38:08 -04:00
parent 3df443604c
commit 546b6863a4
7 changed files with 12 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Makefile
View File

@ -6,6 +6,7 @@ USERDIR = $(PREFIX)/lib/sysusers.d
TMPFDIR = $(PREFIX)/lib/tmpfiles.d TMPFDIR = $(PREFIX)/lib/tmpfiles.d
UDEVDIR = $(PREFIX)/lib/udev/rules.d UDEVDIR = $(PREFIX)/lib/udev/rules.d
MANDIR = $(PREFIX)/share/man/man1 MANDIR = $(PREFIX)/share/man/man1
ENVDIR = /etc/conf.d
RM = rm RM = rm
INSTALL = install -p INSTALL = install -p
@ -19,7 +20,9 @@ common/$(PN):
install-common: install-common:
$(INSTALL_DIR) "$(DESTDIR)$(UDEVDIR)" $(INSTALL_DIR) "$(DESTDIR)$(UDEVDIR)"
$(INSTALL_DIR) "$(DESTDIR)$(ENVDIR)"
$(INSTALL_DATA) x86/udev/99-kodi.rules "$(DESTDIR)$(UDEVDIR)/99-kodi.rules" $(INSTALL_DATA) x86/udev/99-kodi.rules "$(DESTDIR)$(UDEVDIR)/99-kodi.rules"
$(INSTALL_DATA) common/kodi-standalone "$(DESTDIR)$(ENVDIR)/kodi-standalone"
install-init: install-init:
$(INSTALL_DIR) "$(DESTDIR)$(INITDIR)" $(INSTALL_DIR) "$(DESTDIR)$(INITDIR)"
@ -43,6 +46,7 @@ uninstall:
$(RM) "$(DESTDIR)$(USERDIR)/kodi-standalone.conf" $(RM) "$(DESTDIR)$(USERDIR)/kodi-standalone.conf"
$(RM) "$(DESTDIR)$(UDEVDIR)/99-kodi.rules" $(RM) "$(DESTDIR)$(UDEVDIR)/99-kodi.rules"
$(RM) "$(DESTDIR)$(MANDIR)/kodi.service.1" $(RM) "$(DESTDIR)$(MANDIR)/kodi.service.1"
$(RM) "$(DESTDIR)$(ENVDIR)/kodi-standalone"
install: install-common install-init install-man install: install-common install-init install-man

3
README.md
View File

@ -49,10 +49,9 @@ Simply [start/enable](https://wiki.archlinux.org/index.php/Systemd#Using_units)
* xorg-server and xorg-xinit (for running x11) * xorg-server and xorg-xinit (for running x11)
## Passing environment variables to the service ## Passing environment variables to the service
Should the need arise, one can pass environment variables to the service by creating `/etc/conf.d/kodi-standalone` and populating it with the needed variables. Certain use cases require environment variables to be passed to the service. Define these variables in `/etc/conf.d/kodi-standalone` and they will be passed along to the service.
## Notes on system shutdown/reboot ## Notes on system shutdown/reboot
Be aware that these services run Kodi in systemd's user.slice not in the system.slice. In order to have Kodi gracefully exit, the system should be called to shutdown or to reboot using the respective Kodi actions not by a call to systemctl. Failure to do so will result in an ungraceful exit of Kodi and the saving of GUI settings, Kodi uptime etc. will not occur. In principal this is no different than data loss occurring from a user doing work when a sysadmin issues a reboot command without prior warning. While it is possible to run Kodi in systemd's system.slice instead, doing so makes it difficult to use USB mounts within Kodi and to use pulseaudio for Kodi sessions. Be aware that these services run Kodi in systemd's user.slice not in the system.slice. In order to have Kodi gracefully exit, the system should be called to shutdown or to reboot using the respective Kodi actions not by a call to systemctl. Failure to do so will result in an ungraceful exit of Kodi and the saving of GUI settings, Kodi uptime etc. will not occur. In principal this is no different than data loss occurring from a user doing work when a sysadmin issues a reboot command without prior warning. While it is possible to run Kodi in systemd's system.slice instead, doing so makes it difficult to use USB mounts within Kodi and to use pulseaudio for Kodi sessions.
### Recommended methods to reboot/shutdown ### Recommended methods to reboot/shutdown

4
arm/doc/kodi.service.1
View File

@ -1,5 +1,5 @@
.\" Text automatically generated by txt2man .\" Text automatically generated by txt2man
.TH kodi.service 1 "13 March 2021" "" "" .TH kodi.service 1 "23 May 2021" "" ""
.SH NAME .SH NAME
\fBkodi.service \fP- Systemd service unit to run Kodi in standalone mode without the need for a DE. \fBkodi.service \fP- Systemd service unit to run Kodi in standalone mode without the need for a DE.
\fB \fB
@ -35,7 +35,7 @@ If a CLI option is preferred, use kodi-send to issue the command to reboot or sh
.fi .fi
Note that kodi-send is provided by the kodi-xxx-eventclients package where xxx is either, rpi, rpi-legacy, or git depending on which package group you installed. Note that kodi-send is provided by the kodi-xxx-eventclients package where xxx is either, rpi, rpi-legacy, or git depending on which package group you installed.
.SH PASSING ENVIRONMENT VARIABLES TO THE SERVICE .SH PASSING ENVIRONMENT VARIABLES TO THE SERVICE
Should the need arise, one can pass environment variables to the service by creating /etc/conf.d/kodi-standalone and populating it with the needed variables. Certain use cases require environment variables to be passed to the service. Define these variables in /etc/conf.d/kodi-standalone and they will be passed along to the service.
.SH CONTRIBUTE .SH CONTRIBUTE
Users wishing to contribute to this code, should fork and send a pull request. Source is freely available on the project page linked below. Users wishing to contribute to this code, should fork and send a pull request. Source is freely available on the project page linked below.
.SH BUGS .SH BUGS

2
arm/doc/manpage.txt
View File

@ -24,7 +24,7 @@ o If a CLI option is preferred, use kodi-send to issue the command to reboot or
Note that kodi-send is provided by the kodi-xxx-eventclients package where xxx is either, rpi, rpi-legacy, or git depending on which package group you installed. Note that kodi-send is provided by the kodi-xxx-eventclients package where xxx is either, rpi, rpi-legacy, or git depending on which package group you installed.
PASSING ENVIRONMENT VARIABLES TO THE SERVICE PASSING ENVIRONMENT VARIABLES TO THE SERVICE
Should the need arise, one can pass environment variables to the service by creating /etc/conf.d/kodi-standalone and populating it with the needed variables. Certain use cases require environment variables to be passed to the service. Define these variables in /etc/conf.d/kodi-standalone and they will be passed along to the service.
CONTRIBUTE CONTRIBUTE
Users wishing to contribute to this code, should fork and send a pull request. Source is freely available on the project page linked below. Users wishing to contribute to this code, should fork and send a pull request. Source is freely available on the project page linked below.

1
common/kodi-standalone Normal file
View File

@ -0,0 +1 @@
# Define environment variables to pass to the service below

4
x86/doc/kodi.service.1
View File

@ -1,5 +1,5 @@
.\" Text automatically generated by txt2man .\" Text automatically generated by txt2man
.TH kodi.service 1 "03 April 2021" "" "" .TH kodi.service 1 "23 May 2021" "" ""
.SH NAME .SH NAME
\fBkodi-xxx.service \fP- Systemd service units to run Kodi in standalone mode without the need for a DE. \fBkodi-xxx.service \fP- Systemd service units to run Kodi in standalone mode without the need for a DE.
\fB \fB
@ -43,7 +43,7 @@ If a CLI option is preferred, use kodi-send to issue the command to reboot or sh
.fi .fi
Note that kodi-send may not be included with your Distro's kodi package. For example, on Arch Linux, it is provided by the kodi-eventclients package. Note that kodi-send may not be included with your Distro's kodi package. For example, on Arch Linux, it is provided by the kodi-eventclients package.
.SH PASSING ENVIRONMENT VARIABLES TO THE SERVICE .SH PASSING ENVIRONMENT VARIABLES TO THE SERVICE
Should the need arise, one can pass environment variables to the service by creating /etc/conf.d/kodi-standalone and populating it with the needed variables. Certain use cases require environment variables to be passed to the service. Define these variables in /etc/conf.d/kodi-standalone and they will be passed along to the service.
.SH CONTRIBUTE .SH CONTRIBUTE
Users wishing to contribute to this code, should fork and send a pull request. Source is freely available on the project page linked below. Users wishing to contribute to this code, should fork and send a pull request. Source is freely available on the project page linked below.
.SH BUGS .SH BUGS