/[gentoo-x86]/eclass/systemd.eclass
Gentoo

Contents of /eclass/systemd.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.28 - (show annotations) (download)
Wed Sep 11 08:50:07 2013 UTC (15 months ago) by mgorny
Branch: MAIN
Changes since 1.27: +8 -5 lines
Deprecate systemd_to_myeconfargs(). It's redundant and unnecessarily confusing.

1 # Copyright 1999-2013 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
3 # $Header: /var/cvsroot/gentoo-x86/eclass/systemd.eclass,v 1.27 2013/09/11 07:58:00 mgorny Exp $
4
5 # @ECLASS: systemd.eclass
6 # @MAINTAINER:
7 # systemd@gentoo.org
8 # @BLURB: helper functions to install systemd units
9 # @DESCRIPTION:
10 # This eclass provides a set of functions to install unit files for
11 # sys-apps/systemd within ebuilds.
12 # @EXAMPLE:
13 #
14 # @CODE
15 # inherit systemd
16 #
17 # src_configure() {
18 # local myeconfargs=(
19 # --enable-foo
20 # --disable-bar
21 # "$(systemd_with_unitdir)"
22 # )
23 #
24 # econf "${myeconfargs[@]}"
25 # }
26 # @CODE
27
28 inherit eutils toolchain-funcs
29
30 case ${EAPI:-0} in
31 0|1|2|3|4|5) ;;
32 *) die "${ECLASS}.eclass API in EAPI ${EAPI} not yet established."
33 esac
34
35 DEPEND="virtual/pkgconfig"
36
37 # @FUNCTION: _systemd_get_unitdir
38 # @INTERNAL
39 # @DESCRIPTION:
40 # Get unprefixed unitdir.
41 _systemd_get_unitdir() {
42 if $(tc-getPKG_CONFIG) --exists systemd; then
43 echo "$($(tc-getPKG_CONFIG) --variable=systemdsystemunitdir systemd)"
44 else
45 echo /usr/lib/systemd/system
46 fi
47 }
48
49 # @FUNCTION: systemd_get_unitdir
50 # @DESCRIPTION:
51 # Output the path for the systemd unit directory (not including ${D}).
52 # This function always succeeds, even if systemd is not installed.
53 systemd_get_unitdir() {
54 has "${EAPI:-0}" 0 1 2 && ! use prefix && EPREFIX=
55 debug-print-function ${FUNCNAME} "${@}"
56
57 echo "${EPREFIX}$(_systemd_get_unitdir)"
58 }
59
60 # @FUNCTION: _systemd_get_userunitdir
61 # @INTERNAL
62 # @DESCRIPTION:
63 # Get unprefixed userunitdir.
64 _systemd_get_userunitdir() {
65 if $(tc-getPKG_CONFIG) --exists systemd; then
66 echo "$($(tc-getPKG_CONFIG) --variable=systemduserunitdir systemd)"
67 else
68 echo /usr/lib/systemd/user
69 fi
70 }
71
72 # @FUNCTION: systemd_get_userunitdir
73 # @DESCRIPTION:
74 # Output the path for the systemd user unit directory (not including
75 # ${D}). This function always succeeds, even if systemd is not
76 # installed.
77 systemd_get_userunitdir() {
78 has "${EAPI:-0}" 0 1 2 && ! use prefix && EPREFIX=
79 debug-print-function ${FUNCNAME} "${@}"
80
81 echo "${EPREFIX}$(_systemd_get_userunitdir)"
82 }
83
84 # @FUNCTION: _systemd_get_utildir
85 # @INTERNAL
86 # @DESCRIPTION:
87 # Get unprefixed utildir.
88 _systemd_get_utildir() {
89 if $(tc-getPKG_CONFIG) --exists systemd; then
90 echo "$($(tc-getPKG_CONFIG) --variable=systemdutildir systemd)"
91 else
92 echo /usr/lib/systemd
93 fi
94 }
95
96 # @FUNCTION: systemd_get_utildir
97 # @DESCRIPTION:
98 # Output the path for the systemd utility directory (not including
99 # ${D}). This function always succeeds, even if systemd is not
100 # installed.
101 systemd_get_utildir() {
102 has "${EAPI:-0}" 0 1 2 && ! use prefix && EPREFIX=
103 debug-print-function ${FUNCNAME} "${@}"
104
105 echo "${EPREFIX}$(_systemd_get_utildir)"
106 }
107
108 # @FUNCTION: systemd_dounit
109 # @USAGE: unit1 [...]
110 # @DESCRIPTION:
111 # Install systemd unit(s). Uses doins, thus it is fatal in EAPI 4
112 # and non-fatal in earlier EAPIs.
113 systemd_dounit() {
114 debug-print-function ${FUNCNAME} "${@}"
115
116 (
117 insinto "$(_systemd_get_unitdir)"
118 doins "${@}"
119 )
120 }
121
122 # @FUNCTION: systemd_newunit
123 # @USAGE: oldname newname
124 # @DESCRIPTION:
125 # Install systemd unit with a new name. Uses newins, thus it is fatal
126 # in EAPI 4 and non-fatal in earlier EAPIs.
127 systemd_newunit() {
128 debug-print-function ${FUNCNAME} "${@}"
129
130 (
131 insinto "$(_systemd_get_unitdir)"
132 newins "${@}"
133 )
134 }
135
136 # @FUNCTION: systemd_dotmpfilesd
137 # @USAGE: tmpfilesd1 [...]
138 # @DESCRIPTION:
139 # Install systemd tmpfiles.d files. Uses doins, thus it is fatal
140 # in EAPI 4 and non-fatal in earlier EAPIs.
141 systemd_dotmpfilesd() {
142 debug-print-function ${FUNCNAME} "${@}"
143
144 for f; do
145 [[ ${f} == *.conf ]] \
146 || die 'tmpfiles.d files need to have .conf suffix.'
147 done
148
149 (
150 insinto /usr/lib/tmpfiles.d/
151 doins "${@}"
152 )
153 }
154
155 # @FUNCTION: systemd_newtmpfilesd
156 # @USAGE: oldname newname.conf
157 # @DESCRIPTION:
158 # Install systemd tmpfiles.d file under a new name. Uses newins, thus it
159 # is fatal in EAPI 4 and non-fatal in earlier EAPIs.
160 systemd_newtmpfilesd() {
161 debug-print-function ${FUNCNAME} "${@}"
162
163 [[ ${2} == *.conf ]] \
164 || die 'tmpfiles.d files need to have .conf suffix.'
165
166 (
167 insinto /usr/lib/tmpfiles.d/
168 newins "${@}"
169 )
170 }
171
172 # @FUNCTION: systemd_enable_service
173 # @USAGE: target service
174 # @DESCRIPTION:
175 # Enable service in desired target, e.g. install a symlink for it.
176 # Uses dosym, thus it is fatal in EAPI 4 and non-fatal in earlier
177 # EAPIs.
178 systemd_enable_service() {
179 debug-print-function ${FUNCNAME} "${@}"
180
181 [[ ${#} -eq 2 ]] || die "Synopsis: systemd_enable_service target service"
182
183 local target=${1}
184 local service=${2}
185 local ud=$(_systemd_get_unitdir)
186 local destname=${service##*/}
187
188 dodir "${ud}"/"${target}".wants && \
189 dosym ../"${service}" "${ud}"/"${target}".wants/"${destname}"
190 }
191
192 # @FUNCTION: systemd_with_unitdir
193 # @USAGE: [configure option]
194 # @DESCRIPTION:
195 # Output '--with-systemdsystemunitdir' as expected by systemd-aware configure
196 # scripts. This function always succeeds. Its output may be quoted in order
197 # to preserve whitespace in paths. systemd_to_myeconfargs() is preferred over
198 # this function.
199 #
200 # If upstream does use invalid configure option to handle installing systemd
201 # units (e.g. `--with-systemdunitdir'), you can pass the 'suffix' as an optional
202 # argument to this function (`$(systemd_with_unitdir systemdunitdir)'). Please
203 # remember to report a bug upstream as well.
204 systemd_with_unitdir() {
205 debug-print-function ${FUNCNAME} "${@}"
206 local optname=${1:-systemdsystemunitdir}
207
208 echo --with-${optname}="$(systemd_get_unitdir)"
209 }
210
211 # @FUNCTION: systemd_with_utildir
212 # @DESCRIPTION:
213 # Output '--with-systemdsystemutildir' as used by some packages to install
214 # systemd helpers. This function always succeeds. Its output may be quoted
215 # in order to preserve whitespace in paths.
216 systemd_with_utildir() {
217 debug-print-function ${FUNCNAME} "${@}"
218
219 echo --with-systemdutildir="$(systemd_get_utildir)"
220 }
221
222 # @FUNCTION: systemd_to_myeconfargs
223 # @DESCRIPTION:
224 # Add '--with-systemdsystemunitdir' as expected by systemd-aware configure
225 # scripts to the myeconfargs variable used by autotools-utils eclass. Handles
226 # quoting automatically.
227 systemd_to_myeconfargs() {
228 debug-print-function ${FUNCNAME} "${@}"
229
230 eqawarn 'systemd_to_myeconfargs() is deprecated and will be removed on 2013-10-11.'
231 eqawarn 'Please use $(systemd_with_unitdir) instead.'
232
233 myeconfargs=(
234 "${myeconfargs[@]}"
235 --with-systemdsystemunitdir="$(systemd_get_unitdir)"
236 )
237 }
238
239 # @FUNCTION: systemd_update_catalog
240 # @DESCRIPTION:
241 # Update the journald catalog. This needs to be called after installing
242 # or removing catalog files.
243 #
244 # If systemd is not installed, no operation will be done. The catalog
245 # will be (re)built once systemd is installed.
246 #
247 # See: http://www.freedesktop.org/wiki/Software/systemd/catalog
248 systemd_update_catalog() {
249 debug-print-function ${FUNCNAME} "${@}"
250
251 # Make sure to work on the correct system.
252
253 local journalctl=${EPREFIX}/usr/bin/journalctl
254 if [[ -x ${journalctl} ]]; then
255 ebegin "Updating systemd journal catalogs"
256 journalctl --update-catalog
257 eend $?
258 else
259 debug-print "${FUNCNAME}: journalctl not found."
260 fi
261 }
262
263 # @FUNCTION: systemd_is_booted
264 # @DESCRIPTION:
265 # Check whether the system was booted using systemd.
266 #
267 # This should be used purely for informational purposes, e.g. warning
268 # user that he needs to use systemd. Installed files or application
269 # behavior *must not* rely on this. Please remember to check MERGE_TYPE
270 # to not trigger the check on binary package build hosts!
271 #
272 # Returns 0 if systemd is used to boot the system, 1 otherwise.
273 #
274 # See: man sd_booted
275 systemd_is_booted() {
276 debug-print-function ${FUNCNAME} "${@}"
277
278 [[ -d /run/systemd/system ]]
279 local ret=${?}
280
281 debug-print "${FUNCNAME}: [[ -d /run/systemd/system ]] -> ${ret}"
282 return ${ret}
283 }

  ViewVC Help
Powered by ViewVC 1.1.20