
libpff
Открытая C‑библиотека для форматов файлов Outlook
Чтение, разбор и извлечение данных из файлов PST, OST, PAB и OFF через бесплатный открытый C API.
Что такое libpff?
libpff — это мощная открытая C‑библиотека, предназначенная для доступа к форматам Personal Folder File (PFF) и Offline Folder File (OFF), используемыми Microsoft Outlook. Она позволяет разработчикам программно читать, разбирать и извлекать электронную почту, контакты, элементы календаря и другие данные, хранящиеся в файлах PST, OST, PAB и OFF. Библиотека поддерживает как 32‑битные ANSI, так и 64‑битные Unicode кодировки строк, а также сжатые форматы, такие как 4‑КБ‑страничные DEFLATE‑сжатые файлы OST, введённые в Outlook 2013. Благодаря надёжному движку парсинга libpff особенно ценна в цифровой криминалистике, миграции электронной почты и процессах восстановления данных.
Библиотека активно поддерживается под лицензией LGPL-3.0-or-later и currently处于 альфа-статус, что означает, что она функциональна, но может не иметь полной полноты функций или стабильности для использования в продакшене. Она включает инструменты для восстановления элементов и может обрабатывать повреждённые или зашифрованные файлы, где тип шифрования — отсутствует. libpff также интегрируется с связанными проектами, такими как libfmapi, для определений MAPI, и предоставляет подробную судебно‑экспертную документацию, помогающую анализировать сложные структуры файлов Outlook. Разработчики могут собирать её из исходного кода или использовать предварительно скомпилированные бинарные файлы, а проект размещён на GitHub для вклада сообщества и отслеживания проблем.
Начало работы с libpff
Чтобы начать использовать libpff, вы можете клонировать исходный код из официального репозитория [GitHub libpff](https://github.com/libyal/libpff) и собрать его с помощью CMake или autotools. Предварительно скомпилированные бинарные файлы официально не распространяются, поэтому рекомендуется собирать из исходного кода. Проект включает подробные инструкции по сборке и зависимости, такие как libyal/libcerror и libyal/libcdata. После сборки вы можете использовать предоставленные инструменты командной строки (например, `pffexport`, `pffinfo`) для просмотра и извлечения данных из файлов PST/OST. Для программного использования связывайте библиотеку с вашим C/C++ приложением. Библиотека легковесна и имеет минимальные внешние зависимости, что делает её подходящей для встроенных или судебно‑экспертных сред.
Установить libpff через сборку из исходного кода
git clone https://github.com/libyal/libpff.git
cd libpff
./configure
make
sudo make install
Извлечение писем и вложений из файлов PST
libpff предоставляет мощный функционал для разбора PST‑файлов и извлечения отдельных электронных сообщений вместе с их вложениями. Разработчики могут перемещаться по иерархии папок, получать доступ к свойствам сообщений (например, тема, отправитель, получатели, метки времени) и экспортировать необработанное содержимое MIME или структурированные данные. Библиотека поддерживает как ANSI, так и Unicode кодировки строк, обеспечивая совместимость с версиями Outlook, начиная с 1990‑х годов и до современных релизов. Она также обрабатывает сжатые OST‑файлы (DEFLATE с 4‑КБ страницами), которые часто встречаются в новых версиях Outlook. Это делает libpff идеальным для инструментов миграции электронной почты, платформ e‑discovery и судебно‑криминалистического анализа, где критически важен точный экспорт тел сообщений и вложений. API предоставляет низкоуровневый доступ к свойствам MAPI, позволяя тонко управлять извлечением данных.
Как извлечь письма из файла PST с помощью 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);
Судебный анализ повреждённых файлов Outlook
libpff включает специализированные возможности для судебно‑экспертного анализа повреждённых или частично повреждённых файлов Outlook. Он может разбирать файлы с отсутствующими или несоответствующими заголовками, восстанавливать осиротевшие элементы и реконструировать деревья сообщений даже при поломке внутренних индексов. Библиотека поддерживает файлы с типом шифрования "none" и может обходить некоторые структурные ошибки для извлечения пригодных данных. Это особенно ценно в расследованиях цифровой криминалистики, где доказательства могут находиться в деградированных файлах PST/OST. libpff также предоставляет подробное журналирование и отчётность об ошибках, позволяя аналитикам отслеживать решения парсинга и выявлять точки потери данных. В сочетании с извлечением свойств MAPI, libpff служит надёжной основой для создания судебно‑экспертных инструментов, соответствующих юридическим и нормативным требованиям.
Как восстановить элементы из повреждённого PST‑файла?
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);
Разбор свойств и метаданных MAPI
libpff позволяет выполнять глубокий анализ свойств MAPI, встроенных в элементы Outlook. Разработчики могут получать стандартные свойства, такие как `PR_SUBJECT`, `PR_SENDER_NAME`, `PR_MESSAGE_DELIVERY_TIME`, а также пользовательские свойства, определённые приложениями. Библиотека предоставляет API набора свойств, позволяющее перебрать все свойства сообщения, папки или вложения. Это необходимо для приложений, требующих аудита соответствия, извлечения метаданных или интеграции с системами на основе MAPI. libpff поддерживает как именованные, так и числовые идентификаторы свойств и обрабатывает типы значений как 32‑битные, так и 64‑битные (например, строки, целые числа, бинарные блобы). Тесная интеграция с libfmapi обеспечивает точную интерпретацию определений MAPI, делая её подходящей для создания продвинутых инструментов анализа данных Outlook.
Как извлечь свойства MAPI из элемента сообщения?
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);
}
Экспорт данных в стандартные форматы (CSV, JSON, XML)
Хотя libpff в первую очередь является C‑библиотекой для низкоуровневого разбора, она включает утилиты командной строки и API, упрощающие экспорт данных Outlook в широко используемые форматы, такие как CSV, JSON и XML. Инструменты, такие как `pffexport`, могут преобразовывать содержимое PST/OST в структурированные текстовые файлы, сохраняющие иерархию папок и метаданные сообщений. Разработчики также могут использовать библиотеку программно для создания собственных экспортеров — например, сопоставляя свойства MAPI с объектами JSON для загрузки в поисковые системы или аналитические платформы. Эта возможность экспорта имеет решающее значение для миграции данных, резервного копирования и интеграции с современными облачными сервисами, требующими стандартизированных входных форматов. Гибкий дизайн libpff позволяет разработчикам адаптировать логику экспорта к конкретным требованиям соответствия или рабочим процессам.
Как экспортировать содержимое PST в JSON через 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
