amsum Files

amsum version 1.1
----------------------------------------------------------------

Консольная утилита для создания и проверки хешей и прав  доступа
обычных файлов.

Утилиту не  нужно  инсталлировать  -  лучше  использовать  ее  с
мобильного носителя или копируя с другого  компьютера  по  сети,
не раскрывая таким образом сам факт контроля целостности файлов.


КОМПИЛЯЦИЯ И ИНСТАЛЛЯЦИЯ
-------------------------

Компиляция:

  $ make

В результате будет собран исполняемый файл "amsum".

Компиляция с запуском тест-скрипта:

  $ make test

Получить краткую справку по доступным make аргументам:

  $ make help

В авхиве программы есть man-страница  -  при  желании  ее  можно
установить в системный каталог, например в /usr/local/man/man1:

  # cp amsum.1.gz /usr/local/man/man1/


ИСПОЛЬЗОВАНИЕ
-------------

  amsum [ОПЦИЯ] [ФАЙЛЫ]

ОПЦИИ:

  <file_name>   если указано только имя файла, то программа
                выводит  его   имя   и   контрольную   сумму  на
                стандартный вывод

  -- <file_name>
                вывести имя файла  и  его  контрольную  сумму на
                на стандартный вывод (то же что и выше)

  -h, --hash <list_file> <hash_file>
                создать  файл хешей, используя файл списка целей

  -r, --rehash <hash_file>
                использует  файл  <hash_file>  как  файл  списка
                целей, обновляя хеши и права доступа

  -d, --hash-dir <direcroty> <hash_file>
                создать файл хешей <hash_file>  для  всех файлов
                указанного каталога <direcroty> рекурсивно.
                Остальные  объекты   (директории,  символические
                ссылки, и  пр.)  игнорируются.

  -c, --check <hash_file>
                провести  проверку хешей и прав  доступа  файлов
                целостности по файлу хешей.
                Результат  проверки  выводится  на   стандартный
                вывод. В случае нахождения хотя бы одного  факта
                нарушения целостности  проверяемого  файла  (хеш
                или права доступа отличаются  от  сохраненных  в
                файле  <hash_file>,  файл  отсутствует  или  его
                невозможно открыть), то программа вернет  статус
                "1".  В  случае  полностью   успешной   проверки
                программа вернет статус "0".

  -t, --trans <hash_file> <list_file>
                восстановить   файл  списка   <list_file>   целей
                из файла хешей <hash_file>.

  -?, --help    показать краткую справочную информацию

  -v, --version показать версию программы


ФАЙЛЫ:

<list_file> - файл списка целей
Представляет собой простой список путей к файлам,  которые
необходимо хешировать. Каждый путь  к  файлу  -  с  новой
строки. Строки, начинающиеся  со  знака  табуляции,  пробела  или
пустые  строки  -  игнорируются.  Файл  можно  создать  текстовым
редактором или  любым  другим  способом.  Пути  к  файлам  должны
указывать на действительно существующие файлы с правами на чтение
и не должны содержать посторонних символов, не относящихся к пути
к файлу, в противном случае  будет  сообщение  об  ошибке.

<hash_file> - файл контрольных сумм, необходимый для проверки.
Создается программой в процессе хеширования файлов. Каждая строка
файла состоит из трех полей, разделенных 1 пробелом:
  * 36-символьный хеш
  * права доступа в восьмеричном виде (7 цифр)
  * путь к хешированному файлу