[gentoo-dev] s6.eclass: new eclass for installing s6 services

[William Hubbs]

All,

we are starting to add support for s6 service supervision to Gentoo, so
I would like to add an eclass to facilitate the installation of s6
services.

Please take a look and let me know what you think.

If no one objects, I will commit this to the tree on 3 Jun.

Thanks,

William


# Copyright 1999-2015 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: $

# @ECLASS: s6.eclass
# @MAINTAINER:
# William Hubbs <willi...@gentoo.org>
# @BLURB: helper functions to install s6 services
# @DESCRIPTION:
# This eclass provides a helper to install s6 services.
# @EXAMPLE:
#
# @CODE
# inherit s6
#
# src_install() {
#       ...
#       s6_doservice myservice "${FILESDIR}"/run-s6 "${FILESDIR}"/finish-s6
#       s6_doservice myservice/log "${FILESDIR}"/log-run-s6 \
#               "${FILESDIR}"/log-finish-s6
#       ...
# }
# @CODE

case ${EAPI:-0} in
        0|1|2|3|4|5) ;;
        *) die "${ECLASS}.eclass API in EAPI ${EAPI} not yet established."
esac

# @FUNCTION: _s6_get_servicedir
# @INTERNAL
# @DESCRIPTION:
# Get unprefixed servicedir.
_s6_get_servicedir() {
        echo /var/svc.d
}

# @FUNCTION: s6_get_servicedir
# @DESCRIPTION:
# Output the path for the s6 service directory (not including ${D}).
s6_get_servicedir() {
        has "${EAPI:-0}" 0 1 2 && ! use prefix && EPREFIX=
        debug-print-function ${FUNCNAME} "${@}"

        echo "${EPREFIX}$(_s6_get_servicedir)"
}

# @FUNCTION: s6_doservice
# @USAGE: servicename run finish
# @DESCRIPTION:
# Install an s6 service.
# servicename is the name of the service.
# run is the run script for the service.
# finish is the optional finish script for the service.
# This function is fatal in eapis newer than 4 and non-fatal otherwise.
s6_doservice() {
        debug-print-function ${FUNCNAME} "${@}"

        local name="$1"
        local run="$2"
        local finish="$3"

        [[ $name ]] ||
                die "${ECLASS}.eclassYou must specify the s6 service name."
        [[ $run ]] ||
                die "${ECLASS}.eclass: You must specify the s6 service run 
script."

        (
        local servicepath="$(_s6_get_servicedir)/$name"
        exeinto "$servicepath"
        newexe "$run" run
        [[ $finish ]] && newexe "$finish" finish
        )
}

signature.asc
Description: Digital signature