User Commands                                           logger(1)

NAME
     logger - add entries to the system log

SYNOPSIS
     logger [ -i ]  [ -f file ]  [ -p priority ]  [ -t tag  ]   [
     message ]   ...

DESCRIPTION
     The  logger command provides a method  for  adding  one-line
     entries  to  the system log file from the command line.  One
     or more message arguments can be given on the command  line,
     in  which  case  each  is  logged  immediately.  If  this is
     unspecified, either the file indicated with -f or the  stan-
     dard  input  is  added to the log.  Otherwise, a file can be
     specified, in which case each line in the  file  is  logged.
     If neither is specified, logger reads and logs messages on a
     line-by-line basis from the standard input.

OPTIONS
     The following options are supported:

     -ffile
           Use the contents of file as the message to log.

     -i    Log the process ID of the  logger  process  with  each
           line.

     -ppriority
           Enter the message with  the  specified  priority.  The
           message priority can be specified numerically, or as a
           facility.level pair.  For  example,  `-p  local3.info'
           assigns  the message priority to the info level in the
           local3 facility.  The default priority is user.notice.

     -ttag Mark each line added to the  log  with  the  specified
           tag.

OPERANDS
     The following operand is supported:

     message
           One of the string arguments whose  contents  are  con-
           catenated  together, in the order specified, separated
           by single space characters.

EXAMPLES
     Example 1: Examples of the logger command.

     The following example:

     example% logger System rebooted

SunOS 5.8            Last change: 1 Feb 1995                    1

User Commands                                           logger(1)

     logs the message `System rebooted' to the  default  priority
     level  notice to be treated by syslogd as are other messages
     to the facility  user.

     The next example:

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

     reads from the file /dev/idmc and logs  each  line  in  that
     file  as  a message with the tag `HOSTIDM' at priority level
     notice to be treated by syslogd as are other messages to the
     facility local0.

ENVIRONMENT VARIABLES
     See environ(5) for descriptions of the following environment
     variables  that  affect  the  execution of logger: LC_CTYPE,
     LC_MESSAGES, and NLSPATH.

EXIT STATUS
     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO
     mailx(1), write(1), syslogd(1M), syslog(3C),  attributes(5),
     environ (5)

SunOS 5.8            Last change: 1 Feb 1995                    2