DSCEXTRACT(1)

💖 DSCEXTRACT — the girl who pulls one file out of a Debian source package 💖

okay bestie, so this is a page from the General Commands Manual and it's literally called dscextract. no cap.

✨ NAME ✨

dscextract — extract a single file from a Debian source package 🎀

🦋 SYNOPSIS 🦋

dscextract [options] dscfile file

🌸 DESCRIPTION 🌸

so the whole vibe here is: dscextract reads one single file out of a Debian source package. that's it. that's the job. 💅

the iconic part? it only looks into .diff.gz files (that's source format 1.0) or .debian.tar.gz/.bz2 files (that's source format 3.0) where it can, which means it's avoiding unpacking big tarballs. we love an efficient queen. 👑

it's most useful for files chilling in the debian/ subdirectory, iykyk.

file is relative to the first level directory contained in the package — meaning the first component is stripped. so like, no leading folder name, bestie. 🙈

✨ OPTIONS ✨

• -f — "Fast" mode ⚡ for source format 1.0, it avoids falling back to scanning the .orig.tar.gz file if file wasn't found in the .diff.gz. (and for 3.0 packages, it just assumes that debian/* are exactly the contents of debian.tar.gz/.bz2.) not me skipping the backup plan, it's giving speed 🏃♀️💨

💀 EXIT STATUS 💀

• 0 — file was extracted. slay, it worked 🎉
• 1 — file was not found in the source package. it's giving ghosted 👻
• 2 — an error occurred, like dscfile was not found. bestie something went wrong 😭

🌈 EXAMPLE 🌈

dscextract dds_2.1.1+ddd105-2.dsc debian/watch || test $? = 1

look at her go 🫶

👑 AUTHOR 👑

dscextract was written by Christoph Berg <myon@debian.org>. ty for your service, king 🫡💜

lowkey remember: this comes from the Debian Utilities crew, and the page you're reading is the DSCEXTRACT(1) manual from the DEBIAN source/version, dated Debian Utilities era — that's the footer energy, bestie. mwah, bye 💋✨🎀