Документация Python неофициальный перевод

33.13. syslog – библиотечные процедуры Unix syslogsyslog – Unix syslog library routines

Платформы: Unix

Этот модуль предоставляет интерфейс к библиотечным функциям Unix syslog. За подробным описанием службы syslog обращайтесь к справочным страницам Unix.

Модуль определяет следующие функции:

syslog.syslog([priority], message)
Отправляет строку message системному журналу. При необходимости добавляется завершающий символ новой строки. Каждое сообщение помечается приоритетом, состоящим из facility и level. Необязательный аргумент priority, по умолчанию равный LOG_INFO, определяет приоритет сообщения. Если средство не закодировано в priority с помощью логического ИЛИ (LOG_INFO | LOG_USER), используется значение, заданное в вызове openlog().
syslog.openlog(ident[, logopt[, facility]])
Параметры журналирования, отличные от значений по умолчанию, можно задать, явно открыв файл журнала с помощью openlog() перед вызовом syslog(). Значения по умолчанию (обычно): ident = 'syslog', logopt = 0, facility = LOG_USER. Аргумент ident – это строка, которая добавляется перед каждым сообщением. Необязательный аргумент logopt – это битовое поле; ниже перечислены возможные значения для комбинирования. Необязательный аргумент facility задаёт средство по умолчанию для сообщений, в которых средство явно не указано.
syslog.closelog()
Закрывает файл журнала.
syslog.setlogmask(maskpri)
Устанавливает маску приоритетов в значение maskpri и возвращает предыдущее значение маски. Вызовы syslog() с уровнем приоритета, не установленным в maskpri, игнорируются. По умолчанию регистрируются все приоритеты. Функция LOG_MASK(pri) вычисляет маску для отдельного приоритета pri. Функция LOG_UPTO(pri) вычисляет маску для всех приоритетов вплоть до pri включительно.

Модуль определяет следующие константы:

Уровни приоритета (от высокого к низкому):
LOG_EMERG, LOG_ALERT, LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, LOG_DEBUG.
Службы:
LOG_KERN, LOG_USER, LOG_MAIL, LOG_DAEMON, LOG_AUTH, LOG_LPR, LOG_NEWS, LOG_UUCP, LOG_CRON и LOG_LOCAL0 до LOG_LOCAL7.
Опции журналирования:
LOG_PID, LOG_CONS, LOG_NDELAY, LOG_NOWAIT и LOG_PERROR, если определено в <syslog.h>.