LOGGER(1)

НАЗИВ
logger - уноси поруке у дневник система

УВОД

logger [опције] порука

ОПИС

logger прави уносе у дневник система.

Када је опционални аргумент поруке присутан, записује се у дневник. Ако није присутан, а ни опција -f није дата, записује се стандардни улаз.

ОПЦИЈЕ

-d, --udp
    Користи датаграме (UDP) само. По основи веза се покушава са прикључником системског дневника дефинисаном у /etc/services, који је често 514.

    Видите такође --server и --socket да наведе где ће се повезати.

-e, --skip-empty
    Занемарује празне редове приликом обраде датотека. Празан ред је дефинисан као ред без знакова. Стога се ред који се састоји само од размака НЕ ​​сматра празним. Знајте да када је наведена опција --prio-prefix, предност није део реда. Дакле, празан ред у овом режиму је ред који нема знакова после префикса предности (нпр. <13>).

-f, --file датотека
    Записује у дневник садржај наведене датотеке. Ова опција се не може комбиновати са поруком линије наредби.

-i
    Бележи ПИД процеса logger са сваким редом.

--id[=ид]
    Записује у дневник ПИД процеса logger са сваким редом. Када је опционални аргумент ид наведен, тада се он користи уместо ПИД-а наредбе logger. Коришћење --id=$$ (PPID) се препоручује у скриптама које шаљу неколико порука.

    Note that the system logging infrastructure (for example systemd when listening on /dev/log) may follow local socket credentials to override the PID specified in the message. logger(1) is able to set those socket credentials to the given id, but only if you have root permissions and a process with the specified PID exists, otherwise the socket credentials are not modified and the problem is silently ignored.

--journald[=датотека]
    Пише унос дневника systemd-а. Унос се чита из дате датотеке, када је наведена, у супротном са стандардног улаза. Сваки ред мора почети пољем које је прихваћено од journald-а; видите systemd.journal-fields(7) за више о томе. Коришћење поља „ИД_ПОРУКЕ“ је уопштено добра замисао, јер олакшава налажење уноса. Примери:

            logger --journald <<end
            ИД_ПОРУКЕ=67feb6ffbaf24c5cbec13c008dd72309
            ПОРУКА=Пси лају, али караван пролази.
            ПСИ=лају
            КАРАВАН=пролази
            end

            logger --journald=унос.txt

    Приметите да ће --journald занемарити вредности других опција, као што је предност. Ако је предност потребна мора бити у улазу, и користите поље ПРЕДНОСТ. Једноставно извршавање journalctl(1) ће приказати поље ПОРУКА. Користите journalctl --output json-pretty да видите остала поља.

    Да бисте укључили нове редове у ПОРУЦИ, наведите ПОРУКУ неколико пута. Ово се сматра као посебан случај, друга поља ће бити сачувана као низ у дневнику ако се појаве више пута.

--msgid ид-поруке
    Поставља поље „MSGID“. Знајте да знак размака није допуштен унутар msgid. Ова поција се користи само ако је и --rfc5424 наведено; у супротном, тихо се занемарује.

-n, --server сервер
    Пише на наведеном удаљеном серверу системског дневника уместо на прикључници системског дневника. Осим ако је наведено --udp или --tcp, logger ће прво покушати да користи UDP, а ако ово не успе покушава се са TCP везом.

--no-act
    Доводи до тога да се уради све осим писања поруке дневника у системски дневник и уклањања везе или дневника. Ова опција се може користити заједно са --stderr у сврхе тестирања.

--octet-count
    Користи „методу уоквиравања бројања октета за слање порука. Када се ова опција не користи, основно је без уоквиравање на UDP-у, а RFC6587 нетранспарентно уоквиривање (познато и као пуњење октетом) на TCP-у.

-P, --port прикључник
    Користи наведени прикључник. Када ова опција није наведена, прикључник подразумева syslog за „udp“ и syslog-conn за „tcp“ везе.

-p, --priority предност
    Уноси поруку у дневник са наведеном предношћу. Предност се може навести бројевно или као пар објекат.ниво. На пример, -p local3.info бележи поруку као информативну у објекту „local3*. Основно је user.notice.

--prio-prefix
    Тражи префикс системског дневника у сваком реду прочитаном са стандардног улаза. Тај префикс је децимални број унутар угласте заграде који кодира и објекат и ниво. Број је конструисан множењем објекта са 8 и затим додавањем нивоа. На пример, local0.info, значи да објекат=16 и ниво=6, постаје <134>.

    Ако префикс не садржи објекат, објекат се подразумева на оно што је наведено опцијом -p. Слично томе, ако префикс није достављен, ред се бележи коришћењем предности дате са -p.

    This option doesn’t affect a command-line message. This option is primarily designed for use cases where logger is used in a pipeline (e.g., daemon | logger --prio-prefix) to read multiple messages with different priorities.

--rfc3164
    Користи BSD протокол системског дневника да пошаље поруке удаљеном серверу.

--rfc5424[=без]
    Користи „протокол системског дневника за слање порука удаљеном серверу. Опциони аргумент без може бити зарезом раздвојен списак следећих вредности: notq, notime, nohost.

    Вредност notq потискује структурисане податке временског квалитета из послате поруке. Информација временског квалитета показује да ли је локални сат усаглашен плус највећи број микросекунди за које временска ознака може бити искључена. Квалитет времена се такође самостално потискује када је --sd-id timeQuality наведено.

    Вредност notime (која подразумева notq) потискује читаву временску ознаку која је у ISO-8601 формату, укључујући микросекунде и временску зону.

    Вредност nohost потискује gethostname(2) информације из заглавља поруке.

    RFC 5424 протокол је био основни logger од издања 2.26.

-s, --stderr
    Output the message to standard error as well as to the system log. The complete message is output in the same form as sent to syslog or journald, including priority and possibly other fields. This option is primarily designed for debugging purposes and is often used with --no-act.

--sd-id name[@цифре]
    Наводи ИД елемента структурисаних података за заглавље RFC 5424 поруке. Опција треба да се користи пре --sd-param за увођење новог елемента. Број елемената структурисаних података је неограничен. ИД (назив плус по могућству @цифре) разликује величину слова и јединствено одређује врсту и сврху елемента. Исти ИД не сме да постоји више од једном у поруци. Део @цифре је захтеван за нестандардизоване ИД-ове које дефинише корисник.

    logger тренутно ствара само timeQuality стандардизован елемент. RFC 5424 такође описује порекло елемената (са параметрима ip, enterpriseId, software и swVersion) и мета (са параметарима sequenceId, sysUpTime и language). Ови ИД-ови елемента могу бити наведени без суфикса @цифре.

--sd-param назив=вредност
    Наводи параметар елемента структурираних података, пар назива и вредности. Опција мора да се користи после --sd-id и може се навести више пута за исти елемент. Знајте да су знаци наводника око вредности захтевани и морају бити измењени на линији наредби.

            logger --rfc5424 --sd-id зоо@123             \
                             --sd-param тигар="гладан"   \
                             --sd-param зебра="трчи"     \
                             --sd-id менаџер@123         \
                             --sd-param наСастанку="да"  \
                             "ово је порука"

    даје:

    <13>1 2015-10-01T14:07:59.168662+02:00 ws kzak - - [timeQuality tzKnown="1" isSynced="1" syncAccuracy="218616"][зоо@123 тигар="гладан" зебра="трчи"][менаџер@123 наСастанку="да"] ово је порука

-S, --size величина
    Поставља највећу дозвољену величину поруке на величину. Основно је 1KiB знакова, што је ограничење традиционално коришћено и наведено у RFC 3164. Са RFC 5424, ово ограничење је постало прилагодљивије. Добра претпоставка је та да RFC 5424 примаоци могу у најмању руку да обраде 4KiB поруке.

    Већина примаоца прихвата поруке веће од 1KiB преко сваке врсте протокола системског дневника. Као таква, опција --size утиче на logger-а у свим случајевима (не само када се користи --rfc5424).

    Напомена: ограничење величине поруке ограничава укупну величину поруке, укључујући заглавље системског дневника. Величине заглавља варирају у зависности од изабраних опција и дужине назива домаћина. Као правило, заглавља обично нису дужа од 50 до 80 знакова. Приликом одабира највеће величине поруке, важно је осигурати да и прималац исто тако подржава највећу величину, у супротном поруке могу постати скраћене. Опет, као правило величина поруке од 2 до 4 KiB треба уопштено да буде у реду, док све веће треба да се провере да ли раде.

--socket-errors режим
    Исписује грешке о везама Јуникс прикључнице. режим може бити вредност on, off или auto. Када је режим auto (основно), тада ће logger открити да ли је почетни процес systemd(1), и ако је тако, долази до претпоставке да се /dev/log може користити раније у време подизања система. Недостатак /dev/log код других почетних система неће довести до грешака, баш као када се користи openlog(3) системски позив. logger(1) пре издања 2.26 је користио openlog(3), и стога није могао да открије губитак порука послатих Јуникс прикључницама.

    Када грешке нису укључене, о изгубљеним порукама се не изјављује и резултираће успешним излазним стањем logger(1)-а.

-T, --tcp
    Користи само ток (TCP). По основи веза се покушава са прикључником syslog-conn дефинисаном у /etc/services, који је често 601.

    Видите такође --server и --socket да наведе где ће се повезати.

-t, --tag ознака
    Означава да сваки ред буде прибележен са наведеном ознаком. Основна ознака је име корисника пријављеног на терминалу (или име корисника засновано на ефективном ИД-у корисника).

-u, --socket прикључница
    Пише на наведену прикључницу уместо на прикључницу дневника система.

--
    Завршава списак аргумената. Ово омогућава да порука започне цртицом (-).

-h, --help
    Приказује текст помоћи и излази.

-V, --version
    Исписује издање и излази.

ИЗЛАЗНО СТАЊЕ

Помагало logger излази 0 при успеху, и >0 ако дође до грешке.

ОБЈЕКТИ И НИВОИ

Исправни називи објекта су:

auth +
authpriv за безбедносне информације осетљиве природе +
cron

daemon +
ftp +
kern не може се створити из процеса корисничког простора, аутоматски се претвара у user

lpr
mail
news
syslog
user
uucp
local0
to
local7
security застарели синоним за auth

Исправни називи нивоа су:

emerg
alert
crit
err
warning
notice
info
debug
panic застарели синоним за emerg
error застарели синоним за err
warn застарели синоним за warning

За редослед предности и намераване сврхе ових објеката и нивоа, видите syslog(3).

У СКАЛДУ СА

Наредба logger је очекивана да буде сагласна са IEEE Std 1003.2 ("POSIX.2").

ПРИМЕРИ

    поново је подигнут систем дневничар

    logger -p local0.notice -t HOSTIDM -f /dev/idmc

    logger -n loghost.example.com System rebooted

АУТОРИ

Наредба logger је изворно написана на Универзитету Калифорније 1983-1993. а касније су је поново написали и

ПОГЛЕДАЈТЕ ТАКОЂЕ

journalctl(1), syslog(3), systemd.journal-fields(7)

ПРИЈАВЉИВАЊЕ ГРЕШАКА

За пријављивање грешака, користите „https://github.com/util-linux/util-linux/issues[issue tracker]“.

ДОСТУПНОСТ

Наредба logger је део „util-linux“ пакета који се може преузети са