Введение в работу сервера запросов системы отслеживания ошибок

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

Для его использования отправьте письмо по адресу request@bugs.debian.org . Тема ( Subject ) этого письма игнорируется, за исключением того, что она используется при создании темы ответного сообщения.

Тело письма должно содержать последовательность команд, по одной на строку. Вы получите ответ, содержащий копии команд вашего письма и ответ на каждую команду. Для перечисленных ниже команд никакие уведомления никому не отправляются, и сообщения не сохраняются ни в каком общедоступном журнале.

Любой текст в строке, начинающейся со знака диеза ( # ), игнорируется. Обработку сообщения сервер прекращает при обнаружении строки с ограничителем управления (например, quit , thank you , или два дефиса). Он также прекращает работу в случае слишком большого количества не распознанных или неверно отформатированных команд. Если разбор ни одной команды не завершился успешно, сервер отправляет в ответ справку по его использованию.

Доступные команды

Запрашивает файл с информацией о пакете(ах) и/или сопровождающем(их). Доступны файлы:

maintainers Унифицированный список сопровождающих пакетов в виде, используемом системой отслеживания ошибок. Он составляется из информации в файлах Packages , файлах переопределений и файлах псевдопакетов. override. дистрибутив override. дистрибутив .non-free override. дистрибутив .contrib override.experimental Информация о приоритетах и разделах пакетов и переопределённой информации о сопровождающих. Эта информация используется при создании файлов Packages в ftp-архиве. Доступна информация по каждому из основных деревьев дистрибутива по их кодовым именам. pseudo-packages.description pseudo-packages.maintainers Список описаний и сопровождающих псевдопакетов. refcard Запрашивает краткое описание работы почтовых серверов в простом текстовом формате ASCII. user адрес Устанавливает адрес в качестве пользователя всех следующих за ней команд usertag . usertag номер_ошибки [ + | - | = ] метка [ метка . ] Позволяет определить метки для каждого пользователя. Команда usertag работает так же, как и обычная команда tag , за исключением того, что вы можете создавать любые метки. По умолчанию в качестве пользователя команды usertag используется адрес в заголовке From: или Reply-To: вашего сообщения. usercategory имя-категории [ [hidden] ]

Добавляет, обновляет или удаляет usercategory . По умолчанию пользовательская категория видна; если указан добавочный аргумент [hidden] , она не будет видна, но всё ещё будет доступна для указания из других определений пользовательских категорий.

Эта команда в некотором смысле особенная, поскольку при добавлении или обновлении пользовательской категории она требует, чтобы сразу за командой передавалось тело команды. Если тело пусто, пользовательская категория будет удалена. Тело составляется из строк с любым количеством пробелов в начале. Всякая категория должна начинаться со строки с * , дополнительно за ней могут следовать несколько строк выбора, начинающихся с + . Её полный формат таков:

Имена-категорий , встречающиеся в команде и в теле команды, используются для того, чтобы создавать между ними ссылки и избежать ненужного усложнения строк. Заголовки категорий используются в кратком отчёте о пакете.

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

Имя-категории normal имеет специальное значение — вид по умолчанию, поэтому, заменяя его отличной пользовательской категорией для имя-пакета @packages.debian.org, пользователь может изменять классификацию пакета по умолчанию.

help Запрашивает настоящую справку в простом текстовом формате ASCII. quit stop thank thanks thankyou thank you -- kthxbye --> Останавливает обработку письма. После этого вы можете помещать любой текст по своему усмотрению, он будет игнорироваться. Вы можете использовать эту возможность для включения более длинных комментариев, чем уместны в строках, начинающихся с # , например предназначенных для чтения человеком (читающим письмо в журналах системы отслеживания ошибок или указанным в поле CC или BCC ). # . Однострочный комментарий. Символ # должен быть в начале строки. debug уровень Устанавливает уровень отладки в уровень . Он может принимать неотрицательные целые значения. 0 означает отсутствие отладки; значения 1 обычно достаточно. Отладочный вывод также попадает в ответное сообщение. Вероятно, эта возможность бесполезна для большинства пользователей системы.

Можно прочитать краткое описание почтовых серверов, доступное на веб-сайте, в файле bug-mailserver-refcard.txt или при отправке команды refcard (см. выше).

Если вы хотите управлять сообщениями об ошибках, вам следует использовать адрес control@bugs.debian.org , понимающий надмножество вышеперечисленных команд. Оно описано в другом документе, доступном на веб-сайте, в файле bug-maint-mailcontrol.txt или при отправке команды help по адресу control@bugs.debian.org .

На случай если вы читаете этот документ в простом текстовом файле или получили его по электронной почте: доступ к HTML-версии можно получить с главной страницы системы отслеживания ошибок https://www.debian.org/Bugs/ .

📎📎📎📎📎📎📎📎📎📎