usr/src/man/man1b/logger.1b

   1 '\" te
   2 .\"  Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.  Copyright (c) 1983 Regents of the University of California.  All rights reserved.  The Berkeley software
   3 .\" License Agreement  specifies the terms and conditions for redistribution.
   4 .TH LOGGER 1B "Sep 14, 1992"
   5 .SH NAME
   6 logger \- add entries to the system log
   7 .SH SYNOPSIS
   8 .LP
   9 .nf
  10 \fB/usr/ucb/logger\fR [\fB-f\fR \fIfilename\fR] [\fB-i\fR] [\fB-p\fR \fIpriority\fR] [\fB-t\fR \fItag\fR] mm
  11      [\fImessage\fR]...
  12 .fi
  13
  14 .SH DESCRIPTION
  15 .sp
  16 .LP
  17 The \fBlogger\fR utility provides a method for adding one-line entries to the
  18 system log file from the command line. One or more \fImessage\fR arguments can
  19 be given on the command line, in which case each is logged immediately. If
  20 \fImessage\fR is unspecified, either the file indicated with \fB-f\fR or the
  21 standard input is added to the log. Otherwise, a \fIfilename\fR can be
  22 specified, in which case each line in the file is logged. If neither is
  23 specified, \fBlogger\fR reads and logs messages on a line-by-line basis from
  24 the standard input.
  25 .SH OPTIONS
  26 .sp
  27 .LP
  28 The following options are supported:
  29 .sp
  30 .ne 2
  31 .na
  32 \fB\fB-i\fR\fR
  33 .ad
  34 .RS 15n
  35 Log the process \fBID\fR of the \fBlogger\fR process with each line.
  36 .RE
  37
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fB-f\fR \fIfilename\fR\fR
  42 .ad
  43 .RS 15n
  44 Use the contents of \fIfilename\fR as the message to log.
  45 .RE
  46
  47 .sp
  48 .ne 2
  49 .na
  50 \fB\fB-p\fR \fIpriority\fR\fR
  51 .ad
  52 .RS 15n
  53 Enter the message with the specified \fIpriority\fR. The message priority can
  54 be specified numerically, or as a \fIfacility.level\fR pair. For example,
  55 \fB`\fR\fB-p\fR \fBlocal3.info'\fR assigns the message priority to the
  56 \fBinfo\fR level in the \fBlocal3\fR facility. The default priority is
  57 \fBuser.notice\fR.
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fB-t\fR \fItag\fR\fR
  64 .ad
  65 .RS 15n
  66 Mark each line added to the log with the specified \fItag\fR.
  67 .RE
  68
  69 .SH EXAMPLES
  70 .LP
  71 \fBExample 1 \fRLogging a message
  72 .sp
  73 .LP
  74 The command:
  75
  76 .sp
  77 .in +2
  78 .nf
  79 example% \fBlogger System rebooted\fR
  80 .fi
  81 .in -2
  82 .sp
  83
  84 .sp
  85 .LP
  86 will log the message `\fBSystem rebooted\fR' to the facility at priority
  87 \fBnotice\fR to be treated by \fBsyslogd\fR as other messages to the facility
  88 \fBnotice\fR are.
  89
  90 .LP
  91 \fBExample 2 \fRLogging messages from a file
  92 .sp
  93 .LP
  94 The command:
  95
  96 .sp
  97 .in +2
  98 .nf
  99 example% \fBlogger \fR\fB-p\fR\fB local0.notice \fR\fB-t\fR\fB HOSTIDM \fR\fB-f\fR\fB /dev/idmc\fR
 100 .fi
 101 .in -2
 102 .sp
 103
 104 .sp
 105 .LP
 106 will read from the file \fB/dev/idmc\fR and will log each line in that file as
 107 a message with the tag `\fBHOSTIDM\fR' at priority \fBnotice\fR to be treated
 108 by \fBsyslogd\fR as other messages to the facility \fBlocal0\fR are.
 109
 110 .SH SEE ALSO
 111 .sp
 112 .LP
 113 \fBsyslogd\fR(1M), \fBsyslog\fR(3C), \fBattributes\fR(5)