MAD(3)

✨ NAME ✨

okay so meet the whole girlboss squad 💅 — mad_new, mad_read, mad_write, mad_get_version, mad_set_version, mad_get_card_publisher_sector, mad_set_card_publisher_sector, mad_get_aid, mad_set_aid, mad_free — and together? they're the Mifare Application Directory (MAD) Manipulation Functions. no cap. 🎀

📚 LIBRARY 📚

it's the Mifare card manipulation library, bestie — that's libfreefare, and you link it with -lfreefare. 🦋

🌸 SYNOPSIS 🌸

#include <freefare.h>

Mad
mad_new(uint8_t version);

Mad
mad_read(MifareTag tag);

int
mad_write(MifareTag tag, Mad mad, MifareClassicKey key_b_sector_00,
    MifareClassicKey key_b_sector_10);

int
mad_get_version(Mad mad);

void
mad_set_version(Mad mad, uint8_t version);

MifareClassicSectorNumber
mad_get_card_publisher_sector(Mad mad);

int
mad_set_card_publisher_sector(Mad mad, MifareClassicSectorNumber cps);

int
mad_get_aid(Mad mad, MifareClassicSectorNumber sector, MadAid *aid);

int
mad_set_aid(Mad mad, MifareClassicSectorNumber sector, MadAid aid);

void
mad_free(Mad mad);

💖 DESCRIPTION 💖

Mifare Application Directories (MAD) are genuinely so easy to mess with when you've got the mad_*() function set in your corner. it's giving organized. ✨

you can load a mad straight off a Mifare Classic tag with mad_read(), or you can manifest one from literally nothing with mad_new() — just hand it the version of the mad you want generated. and once you're done with your mad, give that memory back to the universe with mad_free(). recycle, bestie 🫶

want to write a mad onto a Mifare Classic tag? that's mad_write(), and it needs the B keys for writing to sectors 0 and 10: key_b_sector_00 for sectors 0, and key_b_sector_10 for sectors 10. 🔑

okay so about MAD version 1 mad writing... the original page says, and I quote, "When writing a MAD version 1 mad, the key_b_sector_10." that's it. that's the whole sentence. it just ends there 💀 not me reading it five times. I'm not gonna invent the rest for you — what you see is what you get, fr fr.

the version of a MAD mad — get it with mad_get_version(), change it with mad_set_version(). 📖

the card publisher sector number cps — read it with mad_get_card_publisher_sector(), write it with mad_set_card_publisher_sector(). 👑

sector allocation inside the mad is all handled by mad_get_aid() and mad_set_aid(). these cuties fill in, or read out, the Application Identifier, aid, for whatever sector you point them at. 🎯

🫶 RETURN VALUES 🫶

• mad_new() hands back NULL when it fails — and when it slays? it allocates memory you have to free later with mad_free(). don't leave her hanging. 😭
• unless it says otherwise, every other function returns a value greater than or equal to 0 on success, or -1 on failure. that's the whole vibe check. ✅

👀 SEE ALSO 👀

freefare(3), mifare_application(3), mifare_classic(3)

iykyk 🌈

👑 AUTHORS 👑

• Romain Tartiere <romain@blogreen.org>
• Romuald Conty <romuald@libnfc.org>

absolute icons, both of them, periodt. 💜

and that's the page bestie!! this one came from Debian, dated March 30, 2010, and it's the MAD(3) entry in the Library Functions Manual. go forth and manipulate some Mifare Application Directories 🌸💅✨