pdfattach(1)

💖 NAME ✨

okay so the big name here is pdfattach 🎀, and it's basically a Portable Document Format (PDF) document embedded file creator (version 3.03) 📄. bestie, it lets you tuck a whole new file inside a PDF you already have 🦋

🌸 SYNOPSIS 🌸

pdfattach [options] input-PDF-file file-to-attach output-PDF-file

💅 DESCRIPTION 💅

so pdfattach adds a brand new embedded file (aka an attachment) to an existing PDF 💌 it's giving "hidden gift inside the card" energy 🎁 ngl it's iconic

🎀 OPTIONS 🎀

• -replace — if there's already an embedded file with the same name, this swaps it out for the new one 🔄 (only kicks in if that file actually exists, fr)
• -v — shows you the copyright and version info ✨
• -h — prints the usage info 📖 (-help and --help do the exact same thing, no cap 🫶)

🦋 EXIT CODES 🦋

• 0 — no error, we ate 🍓
• 1 — uh oh, couldn't open the input PDF file 😭
• 2 — couldn't open the file you wanted to attach 💀
• 3 — the output file already exists 🙈
• 3 — there's already an attached file with that name 🙈 (yes, two different things share code 3, it's a whole thing 🫠)
• 5 — something went wrong while saving the output file 😤

👑 AUTHOR 👑

the pdfattach software and documentation are copyright 2019 The Poppler developers 💜 the queens who made this possible 🧚

🌈 SEE ALSO 🌈

if you're obsessed with this stuff, go check out pdfdetach(1), pdfimages(1), pdfinfo(1), pdftocairo(1), pdftohtml(1), pdftoppm(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), and pdfunite(1) ⭐

okay bestie that's the whole tea 🫶 this page was served by pdfattach(1) from the General Commands Manual, version 3.03, last updated 10 Febuary 2019 🌸💖 stay iconic, periodt 💅✨