logger

 

---

 
 
 
 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
 
 
 

---