Skip to content
AnatolyGeorgievskiPublic

About

GOST/SHA for ЕСКД информационно-удостоверяющий лист (УЛ, ГОСТ 2.051); firmware + PDF; MIT

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

Repository files navigation

gostsum

Implementation of GOST R 34.11-94, GOST R 34.11-2012 (STRIBOG-256/512), SHA, SHA2, SHA3 and hash-based algorithms: HMAC, PBKDF, SSHA.

Утилита командной строки для расчёта и проверки контрольной суммы файла (GOST / SHA), в том числе по ГОСТ Р 34.11-94 и ГОСТ Р 34.11-2012 (СТРИБОГ).

Применение: информационно-удостоверяющий лист (УЛ) по ГОСТ 2.051-2013 (ЕСКД) — контрольные суммы электронных документов КД, когда ЭЦП не применяется. Практика проекта ОПУ: УЛ на каждую прошивку (ГКТУ.… УЛ.Прошивка …); в комплекте КД любой электронный экземпляр (.bin, PDF чертежа и др.) входит со своим хешем (ГОСТ Р 34.11-94 / 34.11-2012, SHA-256). См. также ГКТУ.441465.003 РЭ (gostsum). Форма УЛ: docs/ul.md.

Для архивного контура те же хэш-суммы стыкуются с Приказом Росархива № 77 (Гл. X) и ориентирами ГОСТ Р 7.0.102-2024, ГОСТ Р 7.0.8-2013, ГОСТ Р ИСО 15489-1-2019.

License: MIT (совместима с BSD). См. LICENSE.

Репозиторий: https://github.com/AnatolyGeorgievski/gostsum

Утилита изначально рассчитана на Windows (MinGW / MSYS2). Тот же Makefile собирает под Linux и FreeBSD.

Сборка: Linux / FreeBSD

git clone https://github.com/AnatolyGeorgievski/gostsum.git
cd gostsum
make
make check

Нужен GCC или Clang с поддержкой C11 (aligned_alloc, vector extensions для STRIBOG/GOST).
Пакеты: build-essential (Debian/Ubuntu) или gcc + make (FreeBSD: pkg install gcc gmake, затем gmake).

На x86_64 без SHA-NI используется sha256.c; при __SHA__ — sha256_ni.c.
Сетевой порядок байт — net.h (ntoh* / hton*). SHA3/SHAKE — shake256.c из R3-lib (регистрация digests под локальный hmac.h).

Отключить -march=native:

make NO_NATIVE=1

Кросс armhf / aarch64 (без -march=native):

make clean
make CC=arm-linux-gnueabihf-gcc ARCH=armv7l NO_NATIVE=1
make CC=aarch64-linux-gnu-gcc ARCH=aarch64 NO_NATIVE=1 \
     CFLAGS='-std=gnu11 -Wall -O3 -D_GNU_SOURCE -march=armv8-a+crypto'
# без Crypto Ext.: ARCH=armv7l → sha256.c

Сборка: Windows (MSYS2)

  1. Установите MSYS2.
  2. Откройте оболочку UCRT64 или MINGW64 (не чистый msys).
  3. Пакеты:
pacman -S --needed mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-make make
# или для MINGW64:
# pacman -S --needed mingw-w64-x86_64-gcc mingw-w64-x86_64-make make
  1. Сборка:
cd /path/to/gostsum
make
make check
./gostsum.exe -l

В Mingw CRT уже есть _aligned_malloc / _aligned_free — gosthash.c их использует.
sha256_ni.c подключается только если компилятор видит __SHA__.

Использование

./gostsum -h                 # справка: ALG, stdin, -c
./gostsum -l                 # зарегистрированные digests
./gostsum -a gost FILE       # по умолчанию тоже gost (СТРИБОГ-256)
./gostsum -a gost512 FILE
./gostsum -a sha256 FILE
./gostsum -a sha3-256 FILE

# stdin: без файлов или имя «-»
printf abc | ./gostsum -a sha256 -
./gostsum -a sha256 < FILE

# проверка списка, формат: HEX *имя
./gostsum -a sha256 FILE > sums.txt
./gostsum -a sha256 -c sums.txt

# УЛ: прошивка / комплект КД (PDF чертежа и др.)
./gostsum -a gost firmware.bin drawing.pdf > ul-sums.txt
./gostsum -a gost -c ul-sums.txt

Полный список -a: см. ./gostsum -h. sha/sha1 — SHA-1; gost94 / gost94-cp — ГОСТ Р 34.11-94.

Совместимость

Платформа Статус
Linux x86_64 make / make check
Linux aarch64 sha256_arm.c (+crypto)
Linux armv7/armhf sha256.c; NO_NATIVE=1
FreeBSD gmake; C11 aligned_alloc
MSYS2 MinGW/UCRT gostsum.exe
Clang make CC=clang / make check

Открытые темы закрыты в коде: чтение stdin (- / без аргументов), -c для списка сумм.

About

GOST/SHA for ЕСКД информационно-удостоверяющий лист (УЛ, ГОСТ 2.051); firmware + PDF; MIT

Topics

Resources

Stars

11 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages