carta
mifare_application_free(3)

mifare_application_free3

Mifare applications manipulation functions

Part of mifare_application(3).

Usage

MifareClassicSectorNumber *

void

MifareClassicSectorNumber *

ssize_t

ssize_t

Library

Mifare card manipulation library (libfreefare, -lfreefare)

Overview

The mifare_application_*() functions facilitate management of applications in a Mifare Application Directory.

The mifare_application_alloc() function allocates enought sectors to store size bytes for the Application Identifier aid and returns the list of allocated sectors.

The list of the sectors previously allocated for aid in a mad can be requested using mifare_application_find().

An application can be removed from a mad using mifare_application_free().

The mifare_application_read() reads at most nbytes of the application identified by aid in the mad on the tag and copy them into buf. The function returns the amount of data it copied, or -1 on error.

The mifare_application_write() functions writes at most nbytes of buf in the application identified by aid on the mad of the tag and returns the quantity of data written, or -1 on error.

Implementation notes

The mifare_application_alloc() function will try to avoid wasting space and might not allocate sectors sequentially if a large amount of space is requested and the target has sectors of different size.

The nbytes argument of mifare_application_read() and mifare_application_write() does not need to be aligned on blocks not sectors.

Return values

Unless stated otherwise, all functions return a value greater than or equal to 0 on success or -1 on failure.

Authors

Romain Tartiere ⟨[email protected]⟩ Romuald Conty ⟨[email protected]⟩

From libfreefare-doc 0.4.0-2.3 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.