Вывод информации и отладка

Помимо обычного вывода в консоль, system-restore может работать в «тихом» режиме (-q, --quiet), т.е. вообще ничего не выводить, что удобно при использовании в скриптах, может наоборот выводить детали о каждой выполняемой операции (-v, --verbose), в ряде случаев может выводить информацию в формате JSON (-j, --json). Параллельно ведётся журнал, по умолчанию /var/log/system-restore.log, но это можно поменять аргументами -l (--logfile=) и --no-log. Также сообщения отправляются в системный лог — можно изменить уровень важности (-s, --syslog=) или отключить (--no-syslog).

В разделе взаимодействие с фронтэндом даётся более детальное описание о выводе в формате JSON и выводе происходящего через PIPE для взаимодействия в качестве бэкенда с фронтэнд-модулем текущего Альтератора или каким-то более продвинутым его производным.

Для получения в журнале более детальной отладочной информации перед запуском system-restore нужно экспортировать переменную окружения SYSREST_DEBUG. Данный режим также предписывает скопировать файл журнала в целевую систему и вывести отладочную информацию с промежуточным шелом перед окончанием работы. Журнал будет скопирован по одному из трёх путей, в зависимости от наличия каталогов в целевой системе: /var/log/system-restore.log, /root/.install-log/system-restore.log или /root/system-restore.log. См. также пример в самом пакете.

Если вы обнаружили ошибку в программе или считаете её поведение некорректным, заведите баг, словесно опишите: что получилось и чего ожидалось, обязательно приложите к багу отладочный вывод журнала, полученный с выставленной переменной окружения SYSREST_DEBUG=1, архив META.tgz вашего бэкапа, используемые файлы конфигурации (restore.conf, sysrest.ini) и все скрипты с «хуками», если таковые используются.