DH-EXEC-FILTER(1)

💅 DH-EXEC-FILTER — the dh-exec filter era 💅

okay bestie, welcome to dh-exec-filter, one of the little helper scripts that live inside the dh-exec manual (that's the dh-exec page, section 1, if we're being official about it). she's the filter queen. she does not do the work herself, she just vibes and pipes things through ✨

---

🌸 SYNOPSIS 🌸

#! /usr/bin/dh-exec
[hurd-i386 kfreebsd-any] debian/non-linux/some-file /usr/lib/my-package
<stage1> src/compiler1 /usr/bin

---

🦋 DESCRIPTION 🦋

so here's the tea: this program is a sub-command of dh-exec(1), which means you do NOT run it directly. ever. not even once. 🙈 you run it through dh-exec instead — and dh-exec is sweet like that, because if you run it bare it automatically runs all the available sub-commands for you. or you can be explicit and do it with dh-exec --with=subst.

what is she, exactly? she's a wrapper around all the other filtering helpers, and she pipes the input file through all the available filtering helpers. it's up to those scripts to do the actual work — she's just the main character holding it all together 💅

---

✨ SCRIPTS ✨

🎀 dh-exec-filter-arch

filters out lines that are not for the current host architecture (i.e. the architecture the package is being built for, bestie — not some other girl's architecture).

a line can be pre-fixed or post-fixed with a bracketed list of architectures, and it'll be kept only if you're building for one of those architectures.

the filter supports negation and wildcards, using the exact same syntax as dpkg-architecture(1). slay.

introduced in version 0.13.

🧚 dh-exec-filter-build-profiles

filters out lines that don't match the build profiles currently in effect. you can use the same syntax as in debian/control files. if any of the profiles match, the line is kept; otherwise it gets filtered out. no cap.

⚠️ if a profile is specified but DEB_BUILD_PROFILES is unset, an error will be thrown. so set your env vars, bestie, she's not playing.

introduced in version 0.13.

🌈 dh-exec-filter-comments

removes commented lines and empty lines. that's it, that's the whole job. iconic, honestly. ✨

introduced in version 0.13.

---

💖 ENVIRONMENT 💖

• DH_EXEC_SCRIPTDIR — tells you which directory the command-specific scripts should be sought for. if it's not specified, scripts get searched for in /usr/share/dh-exec/.

---

🌟 FILES 🌟

• $DH_EXEC_SCRIPTDIR/dh-exec-filter-* — the various scripts for the higher-level program. the whole squad 🫶

---

👑 VERSIONS 👑

this sub-command was introduced in dh-exec version 0.13. she's been serving since day one of 0.13, fr fr.

---

🔥 SEE ALSO 🔥

• dh-exec(1)
• debhelper(7)

---

and that's the whole page, bestie 🎀 this was DH-EXEC-FILTER(1) from the dh-exec manual, dated 2024-02-27 — go filter something gorgeous, ily 💜🦋