
libpff
Öppen källkod C-bibliotek för Outlook-filformat
Läs, tolka och extrahera data från PST-, OST-, PAB- och OFF-filer via gratis öppen källkod C-API.
Vad är libpff?
libpff är ett kraftfullt open source C‑bibliotek utformat för att komma åt Personal Folder File (PFF) och Offline Folder File (OFF)-format som används av Microsoft Outlook. Det möjliggör för utvecklare att programatiskt läsa, parsra och extrahera e‑post, kontakter, kalenderobjekt och annan data som lagras i PST‑, OST‑, PAB‑ och OFF‑filer. Biblioteket stödjer både 32‑bit ANSI‑ och 64‑bit Unicode‑strängkodningar, samt komprimerade format såsom 4K‑sidiga DEFLATE‑komprimerade OST‑filer som introducerades i Outlook 2013. Med sin robusta parsningmotor är libpff särskilt värdefullt inom digital forensik, e‑postmigration och dataåterställningsarbetsflöden.
Biblioteket underhålls aktivt under LGPL-3.0-or-later-licensen och befinner sig för närvarande i alpha-status, vilket betyder att det är funktionellt men kan sakna fullständig funktionskompletthet eller stabilitet för produktionsbruk. Det inkluderar verktyg för återställning av objekt och kan hantera korrupta eller krypterade filer där krypteringstypen är ingen. libpff integreras också med relaterade projekt som libfmapi för MAPI-definitioner och tillhandahåller detaljerad forensisk dokumentation för att hjälpa till att analysera komplexa Outlook-filstrukturer. Utvecklare kan bygga från källkod eller använda förkompilerade binärer, och projektet är hostat på GitHub för gemenskapsbidrag och felspårning.
Komma igång med libpff
För att börja använda libpff kan du klona källkoden från dess officiella [libpff GitHub](https://github.com/libyal/libpff)‑arkiv och bygga den med CMake eller autotools. Förkompilerade binärer distribueras inte officiellt, så att bygga från källkod är den rekommenderade metoden. Projektet innehåller detaljerade bygginstruktioner och beroenden som libyal/libcerror och libyal/libcdata. När den är byggd kan du använda de medföljande kommandoradsverktygen (t.ex. `pffexport`, `pffinfo`) för att inspektera och extrahera data från PST/OST‑filer. För programmatisk användning länkar du mot det kompilerade biblioteket i din C/C++‑applikation. Biblioteket är lättviktigt och har minimala externa beroenden, vilket gör det lämpligt för inbäddade eller forensiska miljöer.
Installera libpff via källkodskompilering
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
Extrahera e‑postmeddelanden och bilagor från PST‑filer
libpff tillhandahåller robust funktionalitet för att parsra PST-filer och extrahera enskilda e‑postmeddelanden tillsammans med deras bilagor. Utvecklare kan navigera i mapphierarkin, komma åt meddelandeegenskaper (t.ex. ämne, avsändare, mottagare, tidsstämplar) och exportera rå MIME‑innehåll eller strukturerad data. Biblioteket stöder både ANSI‑ och Unicode‑strängkodningar, vilket säkerställer kompatibilitet med Outlook‑versioner från 1990‑talet upp till moderna releaser. Det hanterar också komprimerade OST‑filer (4K‑sidors DEFLATE), som är vanliga i nyare Outlook‑versioner. Detta gör libpff idealiskt för e‑postmigrationsverktyg, e‑discovery‑plattformar och forensisk analys där exakt extraktion av meddelandetexter och bilagor är kritisk. API:et ger låg‑nivå‑åtkomst till MAPI‑egenskaper, vilket möjliggör finjusterad kontroll över datahämtning.
Hur extraherar man e‑postmeddelanden från en PST‑fil via C API?
pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;
if (pff_file_open(&pff_file, "example.pst", PFF_OPEN_READ, &error) != 1) {
// handle error
}
pff_item_t *root_item = NULL;
if (pff_file_get_root_item(pff_file, &root_item, &error) != 1) {
// handle error
}
// Iterate over items and extract messages
pff_item_t *item = NULL;
while (pff_item_get_sub_item(root_item, &item, &error) == 1) {
// Process each item (e.g., folder or message)
pff_item_free(&item, NULL);
}
pff_item_free(&root_item, NULL);
pff_file_close(pff_file, &error);
Rättsmedicinsk analys av korrupta Outlook‑filer
libpff innehåller specialiserade funktioner för forensisk analys av skadade eller delvis korrupta Outlook-filer. Den kan analysera filer med saknade eller inkonsekventa rubriker, återställa föräldralösa objekt och rekonstruera meddelandeträd även när interna index är trasiga. Biblioteket stöder filer med krypteringstyp "none" och kan kringgå vissa strukturella fel för att extrahera användbar data. Detta är särskilt värdefullt i digitala forensiska undersökningar där bevis kan finnas i nedbrutna PST/OST-filer. libpff tillhandahåller också detaljerad loggning och felrapportering, vilket möjliggör för analytiker att spåra parsingsbeslut och identifiera dataläckagepunkter. I kombination med dess MAPI-egenskapsextraktion fungerar libpff som en pålitlig grund för att bygga forensiska verktyg som uppfyller juridiska och efterlevnadsstandarder.
Hur återställer man objekt från en korrupt PST-fil?
pff_file_t *pff_file = NULL;
pff_error_t *error = NULL;
// Open with recovery mode (if supported)
if (pff_file_open_recover(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error) != 1) {
// fallback to standard open
pff_file_open(&pff_file, "corrupted.pst", PFF_OPEN_READ, &error);
}
// Use item recovery functions
pff_item_t *recovered_item = NULL;
if (pff_file_get_recovered_item(pff_file, &recovered_item, &error) == 1) {
// Process recovered item
pff_item_free(&recovered_item, NULL);
}
pff_file_close(pff_file, &error);
Analysera MAPI‑egenskaper och metadata
libpff möjliggör djup inspektion av MAPI‑egenskaper som är inbäddade i Outlook‑objekt. Utvecklare kan hämta standardegenskaper som `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME` och anpassade egenskaper som definieras av applikationer. Biblioteket exponerar ett API för egenskapsuppsättningar som tillåter iteration över alla egenskaper i ett meddelande, en mapp eller en bilaga. Detta är avgörande för applikationer som kräver efterlevnadsgranskning, metadataextraktion eller integration med MAPI‑baserade system. libpff stöder både namngivna och numeriska egenskapsidentifierare och hanterar både 32‑bitars och 64‑bitars värdetyper (t.ex. strängar, heltal, binära blobbar). Dess täta integration med libfmapi säkerställer korrekt tolkning av MAPI‑definitioner, vilket gör det lämpligt för att bygga avancerade verktyg för Outlook‑dataanalys.
Hur extraherar man MAPI‑egenskaper från ett meddelandeobjekt?
pff_item_t *message_item = NULL;
pff_property_t *property = NULL;
pff_error_t *error = NULL;
// Assume message_item is obtained from traversal
while (pff_item_get_property(message_item, &property, &error) == 1) {
uint32_t property_tag = 0;
uint32_t property_type = 0;
const uint8_t *value_data = NULL;
size_t value_data_size = 0;
pff_property_get_tag(property, &property_tag, &error);
pff_property_get_type(property, &property_type, &error);
pff_property_get_value_data(property, &value_data, &value_data_size, &error);
// Process property (e.g., print subject if PR_SUBJECT)
if (property_tag == 0x0037001F) { // PR_SUBJECT (Unicode)
printf("Subject: %ls\n", (wchar_t*)value_data);
}
pff_property_free(&property, NULL);
}
Exportera data till standardformat (CSV, JSON, XML)
Medan libpff främst är ett C‑bibliotek för låg‑nivå‑parsning, innehåller det kommandoradsverktyg och API:er som underlättar export av Outlook‑data till allmänt använda format som CSV, JSON och XML. Verktyg såsom `pffexport` kan konvertera PST/OST‑innehåll till strukturerade textfiler, samtidigt som mapphierarkin och meddelandemetadatan bevaras. Utvecklare kan också använda biblioteket programmässigt för att bygga anpassade exportörer—t.ex. genom att mappa MAPI‑egenskaper till JSON‑objekt för införsel i sökmotorer eller analysplattformar. Denna exportfunktion är avgörande för datamigrering, säkerhetskopiering och integration med moderna molntjänster som kräver standardiserade indataformat. libpff:s flexibla design gör det möjligt för utvecklare att skräddarsy exportlogik efter specifika efterlevnads‑ eller arbetsflödeskrav.
Hur exporterar man PST‑innehåll till JSON via CLI?
# Export all messages to JSON with metadata
pffexport -f json -o output_dir/ example.pst
# Export only messages with attachments
pffexport -f json -a example.pst
# View help for export options
pffexport --help
