RFC 5424 — Протокол Syslog

6.3.4. Изменение управляющих элементов

Синтаксис и семантика однажды определенных SD-ID и PARAM-NAME НЕ ДОЛЖНЫ изменяться. Если требуется изменить существующий объект, то необходимо создать новые SD-ID или PARAM-NAME, оставив неизменными старые. ДОПОЛНИТЕЛЬНО новые PARAM-NAME МОГУТ быть добавлены в существующий SD-ID.

6.3.5. Примеры

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

• Пример 1 — допустимо:

• [[email protected]
   iut="3" eventSource="Application"
   eventID="1011"]

  В этом примере показан элемент структурированных данных, которым IANA не управляет, с SD-ID [email protected] и тремя параметрами.

• Пример 2 — допустимо:

• [[email protected]
   iut="3" eventSource="Application"
   eventID="1011"][[email protected]
   class="high"]

  Тот же самый пример, что и предыдущий, но содержащий два элемента структурированных данных. Отметим, что второй элемент структурированных данных следует непосредственно за первым (пробелом не отделяется).

• Пример 3 — недопустимо:

• [[email protected]
   iut="3" eventSource="Application"
   eventID="1011"] [[email protected]
   class="high"]

  Пример, практически идентичный предыдущему, но содержащий одну из трудноуловимых ошибок — второй элемент структурированных данных отделяется от первого пробелом. В данном случае будет считаться, что поле STRUCTURED-DATA завершилось сразу после первого элемента, а второй элемент будет интерпретирован как часть поля MSG.

• Пример 4 — недопустимо:

• [ [email protected]
   iut="3" eventSource="Application"
   eventID="1011"][[email protected]
   class="high"]

  В данном примере показана другая трудноуловимая ошибка — в первом элементе после открывающей квадратной скобки находится пробел. Поле SD-ID элемента структурированных данных ДОЛЖНО располагаться непосредственно после открывающей квадратной скобки; имеющийся пробел делает поле STRUCTURED-DATA недопустимым. Приложение Syslog МОЖЕТ отбросить данное сообщение.

• Пример 5 — допустимо:

• [sigSig ver="1" rsID="1234" ... signature="..."]

  Это допустимый пример. Здесь показан SD-ID, гипотетически поддерживаемый IANA. Многоточия подставлены вместо содержимого, которое для краткости пропущено в данном примере.