logger(1) logger(1)
NAME
logger - log messages
SYNOPSIS
logger string
DESCRIPTION
The logger utility saves a message, in an unspecified manner and for-
mat, containing the string operands provided by the user. The messages
are expected to be evaluated later by personnel performing system
administration tasks.
It is implementation-dependent whether messages written in locales
other than the POSIX locale are effective.
OPTIONS
string One of the string arguments whose contents are concatenated
together, in the order specified, separated by single space
characters.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of logger:
LANG Provide a default value for the internationalisation variables
that are unset or null. If LANG is unset or null, the correspond-
ing value from the implementation-specific default locale will be
used. If any of the internationalisation varibles contains an
invalid setting, the utility will behave as if none of the vari-
ables had been defined.
LCALL
If set to a non-empty string value, override the values of all
the other internationalisation variables.
LCCTYPE
Determine the locale for the interpretation of sequences of bytes
of text data as characters (for example, single- as opposed to
multi-byte characters in arguments).
LCMESSAGES
Determine the locale that should be used to affect the format and
contents of diagnostic messages written to standard error. (This
means diagnostics from logger to the user or application, not
diagnostic messages that the user is sending to the system
administrator).
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
Page 1 Reliant UNIX 5.44 Printed 11/98
logger(1) logger(1)
APPLICATION USAGE
This utility allows logging of information for later use by a system
administrator or programmer in determining why non-interactive utili-
ties have failed. The locations of the saved messages, their format
and retention period are all unspecified. There is no method for a
portable application to read messages, once written.
EXAMPLE
A batch application, running non-interactively, tries to read a confi-
guration file and fails; it may attempt to notify the system adminis-
trator with:
logger myname: unable to read file foo. [timestamp]
SEE ALSO
mailx(1), write(1).
Page 2 Reliant UNIX 5.44 Printed 11/98