fsdeploy(1)

✨ fsdeploy — deploy a disk image from forensics-samples ✨

okay bestie, welcome to the fsdeploy(1) manual page, section 1 of the Debian man pages 💅 this is the little command that yeets a disk image from the forensics-samples package straight into your CI test environment and honestly? iconic.

---

🎀 NAME 🎀

fsdeploy — deploy a disk image from forensics-samples

---

🦋 SYNOPSIS 🦋

fsdeploy <file.xz>

like, one argument. one. that's the whole vibe. 💖

---

🌸 DESCRIPTION 🌸

okay so fsdeploy is a command whose whole job is to hand a disk image from the forensics-samples package over to a CI test environment on Debian. and not only that — it can also hand over the original-files directory from forensics-samples too. versatile queen 👑

here's the tea: fsdeploy will copy file.xz into $AUTOPKGTEST_TMP and unzip it, so the file you picked is just there for your CI tests via the autopkgtest command. no cap. and it can also copy original-files into $AUTOPKGTEST_TMP as well — no unzip needed for that one, it's already serving looks 💅

on Debian systems, forensics-samples-<filesystem> and forensics-samples-files packages will depend on the forensics-samples-tools package, and that is the one that provides the fsdeploy command. so that's where it comes from 🫶

---

🔥 OPTIONS 🔥

the possible values are, in this exact order, no skips:

• fs.btrfs.xz — btrfs image, slay 🧚
• fs.exfat.xz — exfat image ✨
• fs.ext2.xz — ext2 image 💜
• fs.ext4.xz — ext4 image 💖
• fs.ntfs.xz — ntfs image 👑
• fs.vfat.xz — vfat image 🌈
• fs.multiple.xz — the multitasker 🎀
• original-files — the original-files directory, no unzip required 💅

and btw, fs.multiple.xz has some filesystems in it. it's giving variety pack. it's giving sampler platter. we love her ⭐

---

🍓 EXAMPLES 🍓

bestie, look at this example of a possible debian/tests/control file for foremost:

Test-Command: fsdeploy fs.ntfs.xz;
              cd $AUTOPKGTEST_TMP;
              foremost -Tq fs.ntfs.xz;
              tree -C output-*
Depends: @, forensics-samples-ntfs, tree
Restrictions: allow-stderr

ate. no crumbs. 🔥

now an example for mac-robber:

Test-Command: fsdeploy original-files;
              mac-robber $AUTOPKGTEST_TMP | grep a-text
Depends: @, forensics-samples-files

Test-Command: [ -e /dev/loop0 ] || exit 77;
              fsdeploy fs.ext4.xz;
              cd $AUTOPKGTEST_TMP;
              mkdir mnt;
              mount -o ro,offset=1048576 fs.ext4 mnt;
              mac-robber mnt | grep a-text;
              umount mnt
Depends: @, forensics-samples-ext4
# isolation-machine will provide access to /dev/loop0, essential to mount
# images using the mount command.
# rw-build-tree allow autopkgtest run several times.
Restrictions: allow-stderr, isolation-machine, needs-root, rw-build-tree, skippable

⚠️ note that Debian CI environments commonly are not able to run isolation-machine. consequently, the test will be skipped. it's not you, it's the infrastructure 😭

example for the disktype command, here u go:

Test-Command: fsdeploy fs.multiple.xz;
              cd $AUTOPKGTEST_TMP;
              disktype fs.multiple
Depends: @, forensics-samples-multiple

---

👑 AUTHOR 👑

forensics-samples was written by Joao Eriberto Mota Filho and is available at https://github.com/eribertomota/forensics-samples — go follow the icon, fr fr 🫶

this manual page was written by Joao Eriberto Mota Filho <eriberto@debian.org> for the Debian project (but may be used by others). generous king, sharing the license love 💖

---

and that's a wrap, bestie! this page is from fsdeploy-0.4, dated 03 Nov 2020 — vintage but still serving. stay hydrated, read your man pages, and may your CI always pass on the first try 💅✨🌈