logger(1p)
PROLOG
Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementationen av detta gränssnitt kan skilja sig från POSIX-beskrivningen. Se motsvarande Linux-manualsida för detaljer om Linux-specifikt beteende. Det är också möjligt att gränssnittet inte är implementerat på Linux.
NAMN
logger — logga meddelanden
SYNOPSIS
logger sträng...
BESKRIVNING
Verktyget logger sparar ett meddelande, på ett ospecificerat sätt och i ett ospecificerat format, som innehåller de sträng-operander som användaren anger. Meddelandena är avsedda att senare granskas av personer som utför systemadministrativa uppgifter.
Det är implementationsdefinierat om meddelanden som skrivs i andra lokaler än POSIX-lokalen får avsedd effekt.
OPTIONER
Inga.
OPERANDER
Följande operand ska stödjas:
sträng
- Ett av de strängargument vars innehåll sammanfogas i angiven ordning, separerade med enkla <space>-tecken.
STANDARDINMATNING
Används inte.
INDATAFILER
Inga.
MILJÖVARIABLER
Följande miljövariabler ska påverka körningen av logger:
LANG
- Anger ett standardvärde för internationaliseringsvariabler som är osatta eller tomma. Se POSIX.1-2017, Base Definitions, avsnitt 8.2, Internationalization Variables, för prioritetsordningen mellan internationaliseringsvariabler som används för att bestämma värden för lokalekategorier.
LC_ALL
- Om denna är satt till en icke-tom sträng åsidosätter den värdena för alla andra internationaliseringsvariabler.
LC_CTYPE
- Bestämmer lokalen för tolkning av bytesekvenser i textdata som tecken, till exempel enkelbyte- kontra multibyte-tecken i argument.
LC_MESSAGES
- Bestämmer lokalen som ska användas för format och innehåll i diagnostiska meddelanden som skrivs till standardfel. Detta avser diagnostik från logger till användaren eller programmet, inte diagnostiska meddelanden som användaren skickar till systemadministratören.
NLSPATH
- Bestämmer platsen för meddelandekataloger vid behandling av LC_MESSAGES.
ASYNKRONA HÄNDELSER
Standardbeteende.
STANDARDUTMATNING
Används inte.
STANDARDFEL
Standardfel ska endast användas för diagnostiska meddelanden.
UTFILER
Ospecificerat.
UTÖKAD BESKRIVNING
Ingen.
AVSLUTNINGSSTATUS
Följande avslutningsvärden ska returneras:
0
- Kommandot slutfördes utan fel.
>0
- Ett fel inträffade.
KONSEKVENSER AV FEL
Standardbeteende.
Följande avsnitt är informativa.
ANVÄNDNING I PROGRAM
Detta verktyg gör det möjligt att logga information för senare användning av en systemadministratör eller programmerare vid felsökning av varför icke-interaktiva verktyg har misslyckats.
Platserna där de sparade meddelandena lagras, deras format och hur länge de behålls är alla ospecificerade. Det finns ingen metod för ett POSIX-konformt program att läsa meddelanden när de väl har skrivits.
EXEMPEL
Ett batchprogram som körs icke-interaktivt försöker läsa en konfigurationsfil och misslyckas. Det kan då försöka underrätta systemadministratören med:
logger myname: unable to read file foo. [timestamp]
Ett praktiskt Linux-exempel kan vara:
logger Backupscript: kunde inte läsa /etc/backup.conf
eller i ett skalskript:
if [ ! -r /etc/backup.conf ]; then
logger Backupscript: kunde inte läsa /etc/backup.conf
exit 1
fi
BAKGRUND OCH MOTIVERING
Standardutvecklarna ansåg starkt att det behövdes någon metod för att uppmärksamma administratörer på fel. Ett tydligt exempel är ett batchverktyg som körs icke-interaktivt och inte kan läsa sina konfigurationsfiler, eller som inte kan skapa eller skriva sin resultatfil.
Standardutvecklarna ville dock inte definiera formatet eller leveransmekanismerna, eftersom dessa historiskt har varit, och sannolikt kommer att fortsätta vara, mycket systemspecifika. De omfattar dessutom funktionalitet som tydligt ligger utanför omfånget för denna volym av POSIX.1-2017.
Texten om LC_MESSAGES och diagnostiska meddelanden betyder diagnostik från logger till användaren eller programmet, inte de diagnostiska meddelanden som användaren skickar till systemadministratören.
Flera sträng-argument tillåts, på liknande sätt som för echo, för att göra verktyget enklare att använda.
Liksom verktygen mailx och lp är logger visserligen svårt att testa. Detta ansågs inte vara tillräcklig motivering för att utesluta dessa verktyg från POSIX.1-2017. Det kan också hävdas att de faktiskt går att testa, men att själva testerna inte är portabla.
FRAMTIDA RIKTNINGAR
Inga.
SE ÄVEN
POSIX.1-2017, Base Definitions:
- Kapitel 8, Environment Variables
COPYRIGHT
Delar av denna text är återgivna och reproducerade i elektronisk form från IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc och The Open Group.
Om det finns någon avvikelse mellan denna version och den ursprungliga standarden från IEEE och The Open Group är den ursprungliga standarden den avgörande referensen. Den ursprungliga standarden kan hämtas online på:
http://www.opengroup.org/unix/online.html
Typografiska fel eller formateringsfel på denna manualsida har troligen uppstått vid konvertering av källfilerna till manualsidesformat. Sådana fel kan rapporteras enligt informationen på:
https://www.kernel.org/doc/man-pages/reporting_bugs.html
KORT SAMMANFATTNING
logger används för att skriva ett meddelande till systemets loggningsfunktion.
En enkel användning:
logger "Detta är ett testmeddelande"
I skript kan det användas för att logga fel utan att användaren behöver vara inloggad eller titta på terminalen:
logger MittScript: något gick fel
POSIX anger inte exakt var meddelandet lagras, vilket format det får eller hur länge det sparas. Det är upp till implementationen.