Danube read-only SDK

Распаковать, слинковать, прочитать

Поставка выбирается по системе и загрузчику; модуль несёт движки сжатия внутри, отдельных зависимостей ставить не нужно. Пароль передаётся при открытии, для незашифрованного контейнера — пустая строка.

Контейнер, зашифрованный публичным ключом (выпуск 3.3.0), читалка открывает сама: перебирает каталог ключей по умолчанию (~/.dan/keys, в Windows %APPDATA%\danube\keys) и сверяет отпечатки с блоком получателей. Свой каталог и пароль приватного ключа фасад пока не принимает — защищённый ключ нужно разблокировать заранее или положить рядом копию без пароля. Без подходящего ключа danube_ro_open отвечает DANUBE_RO_BAD_PASS, а причина остаётся в журнале.

dan -method EXTRACT -danube danube-ro-3.3.0_Linux_glibc_amd64.adn -dest .
cc -Iinclude example.c -Llib -ldanube_ro -o example
LD_LIBRARY_PATH=$PWD/lib ./example photos.adn     # macOS: DYLD_LIBRARY_PATH

:: распаковка контейнера
dan -method EXTRACT -danube danube-ro-3.3.0_Windows_x86_64_mingw.adn -dest .

:: MinGW-w64
gcc -Iinclude example.c -Llib -ldanube_ro -o example.exe

:: MSVC, из командной строки разработчика
cl /Iinclude example.c lib\danube_ro.lib

Сведения о контейнере и обход дерева

#include <stdio.h>
#include <danube_read.h>

int main(int argc, char ** argv){
	danube_ro_t * session = NULL;
	danube_ro_info_t info;
	danube_ro_node_t nodes[64];
	uint64_t filled = 0, i;

	if(argc < 2) return 2;
	/* Открываем контейнер: сессию закрываем при любом коде возврата */
	danube_ro_error_t code = danube_ro_open(argv[1], "", "", &session);
	if(code != DANUBE_RO_OK){
		char message[DANUBE_RO_TEXT] = {0};
		danube_ro_message(session, message, sizeof(message));
		fprintf(stderr, "open: %d (%s)\n", (int) code, message);
		danube_ro_close(session);
		return 1;
	}
	/* Сведения о контейнере: формат, узлы, объём, число частей */
	danube_ro_info(session, &info);
	printf("format=%s nodes=%llu bytes=%llu parts=%llu\n", info.format,
		(unsigned long long) info.nodes, (unsigned long long) info.bytes,
		(unsigned long long) info.parts);
	/* Дети корня */
	danube_ro_children(session, 0, 0, nodes, 64, &filled);
	for(i = 0; i < filled; i++)
		printf("%llu\t%s\t%llu\n", (unsigned long long) nodes[i].id,
			nodes[i].name, (unsigned long long) nodes[i].size);

	danube_ro_close(session);
	return 0;
}

Всё, что ниже, добавляется к этой сессии: чтение байтов, извлечение, поиск, хранилка ключей.

Байты в память и файлы на диск

danube_ro_node_t node;
char buffer[65536];
size_t got = 0;

danube_ro_node(session, 0, 0, "readme.txt", &node);
/* Первые 64 КиБ и кусок с отметки 1 МиБ */
danube_ro_read(session, node.id, 0, sizeof(buffer), buffer, sizeof(buffer), &got);
danube_ro_read(session, node.id, 1024 * 1024, 0, buffer, sizeof(buffer), &got);

/* Весь контейнер, затем один узел или перечень */
danube_ro_extract(session, "./out", NULL, 0);
uint64_t ids[2] = {3, 7};
danube_ro_extract(session, "./out", ids, 2);

Семнадцать вызовов фасада

Что означает отказ

Поля фиксированной длины структур обрезаются молча — кода DANUBE_RO_SMALL для них не бывает. Сессия не потокобезопасна: один поток — одна сессия.

Контейнер 4.0.0 и его части

Читаются контейнеры формата 4.0.0; архивы прежних выпусков отвергаются с DANUBE_RO_FORMAT. Разбитый контейнер — это основной файл .adn и части .pdn; часть опознаётся по заголовку (идентификатор архива и номер), поэтому её можно переименовать, а часть чужого архива рядом не используется и не портится. Число частей отдаёт danube_ro_info, число кусков внутри узла — danube_ro_node.

Внутри контейнера: lib/ — модуль, include/danube_read.h — фасад, LICENSE — лицензия 1.1 с разделом 3.4, THIRD-PARTY-LICENSES.md, README-SDK.txt — записка о ноге сборки, SDK.html и SDK.en.html — это руководство.

Почему контейнер, а не архив: команда dan к этому моменту уже стоит в системе — иначе SDK незачем скачивать. Заодно поставка показывает сам формат: её можно открыть тем же INFO, проверить DIAGNOSTIC и распаковать штатным извлечением.

Условия поставки: издание свободно для любого использования, коммерческого включительно; разрешены встраивание, связывание любого рода, распространение неизменённых копий архива и сборка цели danube_ro из исходников. Пишущая часть библиотеки идёт по коммерческой лицензии (раздел 3.1).

Сборки SDK

Семнадцать контейнеров под Windows, macOS, Linux, BSD, Solaris и illumos, x86_64 и ARM64.

dan -method EXTRACT -danube danube-ro-3.3.0_Linux_glibc_amd64.adn -dest .