th_print_long_ls(3)

💖 th_print_long_ls(3) 💖

okay bestie so this is a C Library Calls page, from the libtar era of the world, and we're talking about two lil functions that just tell you things about a tar file header. no cap, that's the whole vibe. 🎀

✨ NAME ✨

th_print, th_print_long_ls — print out information about a tar file header 🌸

✨ SYNOPSIS ✨

#include <libtar.h>

void th_print_long_ls(TAR *t);

void th_print(TAR *t);

like, you just include libtar.h and both of these are yours. void return, so they hand nothing back — they just say things to stdout. 💅

✨ VERSION ✨

this man page is documenting version 1.2 of libtar. periodt. 📌

✨ DESCRIPTION ✨

🦋 th_print_long_ls()

okay so th_print_long_ls() prints a line to stdout that describes the file pointed to by the current file header associated with the TAR handle t. and the output? it's similar to what you'd get from "ls -l". it's giving directory listing but make it libtar. 🔥

🦋 th_print()

and then th_print() prints the value of each field of the current file header associated with the TAR handle t to stdout. every single field. it's mainly used for debugging purposes, so like, it's not the glamorous one at the party, it's the one backstage holding the clipboard and honestly? we love her for it. 🙈

✨ SEE ALSO ✨

• tar_open(3)
• th_read(3)

ok real talk: nothing here is dangerous, nothing here is deprecated, it just prints stuff and minds its own business. the only thing to remember is that both functions write straight to stdout and both return void, so there's nothing to check afterwards. 🫶

and that's the page!! written up by the University of Illinois back in Jan 2001, documenting version 1.2 of libtar — yes she's old, yes she still ate, iconic behavior honestly 💜✨