ftar(8)

💅 ftar — extract tar files using classes 💅

okay bestie, welcome to the ftar(8) glow-up — this is the System Manager's Manual page, so you know it's official official. Grab a strawberry 🍓, we're unpacking archives by class and it's lowkey iconic.

---

✨ NAME ✨

ftar — extract tar files using classes 🎀

---

🌸 SYNOPSIS 🌸

ftar [options] SOURCE

---

🦋 DESCRIPTION 🦋

So here's the vibe: ftar extracts an archive from SOURCE into its target directory, and it does it using classes ✨.

SOURCE is a directory, and inside it live one or more template files for the source archive you wanna extract. Depending on the list of defined classes, one or more archives of the source directory get selected and extracted into the target. The base target directory is literally just the name of the source directory, no cap.

Template files must have one of these suffixes, depending on what type of archive it is:

• .tar
• .tgz
• .tar.gz
• .tar.xz
• .txz
• .tbz2
• .tar.bz2

The exit code ftar returns is mostly 0. And for every successfully extracted tar file, a log message gets printed to standard output. Bestie said "receipts" and printed them 💖.

---

🔥 OPTIONS 🔥

okay so the rules: options -c, -s, -t (or their analog variables) and a SOURCE are required. Not optional. Periodt.

• -1 — use only one archive file matching a class name. Just the one. She's monogamous 💅
• -c class[class] — define classes. Multiple classes must be space separated. The first class has the lowest priority. If you don't specify this, she uses the classes from the file /tmp/FAI_CLASES.
• -d — delete all files in the target directory before extracting the archive(s). Yes, all of them. 🙈
• -D — create debugging output. For when you need to know everything 🔍
• -h — show help, version and summary of options. A lil menu, as a treat 🎀
• -i — ignore warnings about no matching class and always exit with 0. Chill mode activated.
• -r — recursively remove files in the target directory before extracting the archive. The deep-clean version of -d 🧹
• -s source_dir — look for SOURCE files relative to source_dir. Uses $FAI/files if not specified.
• -t target_dir — extract archives relative to target_dir. Uses $FAI_ROOT if not specified.
• -v — be verbose. Not yet used. She's just standing there. Iconic.

---

🌈 EXAMPLES 🌈

Okay imagine the source directory /files/usr/local consists of these files:

DATALESS.tar.gz ant01.tar.bz2

Each file is a compressed archive, fr fr. If only class DATALESS is defined, then this command:

# ftar -s /files -t /target /usr/local

is equal to:

# tar -C /target/usr/local -zxf /files/usr/local/DATALESS.tar.gz

If additionally class ant01 is defined, then this command also gets executed:

# tar -C /target/usr/local -jxf /files/usr/local/ant01.tar.bz2

And if you only want one archive extracted, the class with the highest priority is the one that gets used. She picks the main character 👑

---

⭐ NOTES ⭐

Do not create a file DEFAULT if no reasonable default configuration file can be used. It's genuinely better to exit with an error than to extract a wrong archive. No wrong-archive shenanigans in this house. 💀

This command can also be used to maintain your complete directory trees on a huge number of hosts. She scales, bestie. She's built different 🫶

---

👑 SEE ALSO 👑

• fcopy(8)

This program is part of FAI (Fully Automatic Installation). See the FAI manual for more information on how to use ftar. The FAI homepage is https://fai-project.org. 🌐

---

🎀 AUTHOR 🎀

Thomas Lange <lange@cs.uni-koeln.de>

---

and that's the whole page, bestie 💜 this one's from the System Manager's Manual, dated 29 July 2010, and it's ftar(8) — go extract something cute ✨