logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

logger.1p (5447B)


  1. '\" et
  2. .TH LOGGER "1P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. logger
  12. \(em log messages
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. logger \fIstring\fR...
  17. .fi
  18. .SH DESCRIPTION
  19. The
  20. .IR logger
  21. utility saves a message, in an unspecified manner and format,
  22. containing the
  23. .IR string
  24. operands provided by the user. The messages are expected to be
  25. evaluated later by personnel performing system administration tasks.
  26. .P
  27. It is implementation-defined whether messages written in locales
  28. other than the POSIX locale are effective.
  29. .SH OPTIONS
  30. None.
  31. .SH OPERANDS
  32. The following operand shall be supported:
  33. .IP "\fIstring\fR" 10
  34. One of the string arguments whose contents are concatenated together,
  35. in the order specified, separated by single
  36. <space>
  37. characters.
  38. .SH STDIN
  39. Not used.
  40. .SH "INPUT FILES"
  41. None.
  42. .SH "ENVIRONMENT VARIABLES"
  43. The following environment variables shall affect the execution of
  44. .IR logger :
  45. .IP "\fILANG\fP" 10
  46. Provide a default value for the internationalization variables that are
  47. unset or null. (See the Base Definitions volume of POSIX.1\(hy2017,
  48. .IR "Section 8.2" ", " "Internationalization Variables"
  49. for the precedence of internationalization variables used to determine
  50. the values of locale categories.)
  51. .IP "\fILC_ALL\fP" 10
  52. If set to a non-empty string value, override the values of all the
  53. other internationalization variables.
  54. .IP "\fILC_CTYPE\fP" 10
  55. Determine the locale for the interpretation of sequences of bytes of
  56. text data as characters (for example, single-byte as opposed to
  57. multi-byte characters in arguments).
  58. .IP "\fILC_MESSAGES\fP" 10
  59. .br
  60. Determine the locale that should be used to affect the format and
  61. contents of diagnostic messages written to standard error. (This means
  62. diagnostics from
  63. .IR logger
  64. to the user or application, not diagnostic messages that the user is
  65. sending to the system administrator.)
  66. .IP "\fINLSPATH\fP" 10
  67. Determine the location of message catalogs for the processing of
  68. .IR LC_MESSAGES .
  69. .SH "ASYNCHRONOUS EVENTS"
  70. Default.
  71. .SH STDOUT
  72. Not used.
  73. .SH STDERR
  74. The standard error shall be used only for diagnostic messages.
  75. .SH "OUTPUT FILES"
  76. Unspecified.
  77. .SH "EXTENDED DESCRIPTION"
  78. None.
  79. .SH "EXIT STATUS"
  80. The following exit values shall be returned:
  81. .IP "\00" 6
  82. Successful completion.
  83. .IP >0 6
  84. An error occurred.
  85. .SH "CONSEQUENCES OF ERRORS"
  86. Default.
  87. .LP
  88. .IR "The following sections are informative."
  89. .SH "APPLICATION USAGE"
  90. This utility allows logging of information for later use by a system
  91. administrator or programmer in determining why non-interactive
  92. utilities have failed. The locations of the saved messages, their
  93. format, and retention period are all unspecified. There is no method
  94. for a conforming application to read messages, once written.
  95. .SH EXAMPLES
  96. A batch application, running non-interactively, tries to read a
  97. configuration file and fails; it may attempt to notify the system
  98. administrator with:
  99. .sp
  100. .RS 4
  101. .nf
  102. logger myname: unable to read file foo. [timestamp]
  103. .fi
  104. .P
  105. .RE
  106. .SH RATIONALE
  107. The standard developers believed strongly that some method of alerting
  108. administrators to errors was necessary. The obvious example is a batch
  109. utility, running non-interactively, that is unable to read its
  110. configuration files or that is unable to create or write its results
  111. file. However, the standard developers did not wish to define the
  112. format or delivery mechanisms as they have historically been (and will
  113. probably continue to be) very system-specific, as well as involving
  114. functionality clearly outside the scope of this volume of POSIX.1\(hy2017.
  115. .P
  116. The text with
  117. .IR LC_MESSAGES
  118. about diagnostic messages means diagnostics from
  119. .IR logger
  120. to the user or application, not diagnostic messages that the user is
  121. sending to the system administrator.
  122. .P
  123. Multiple
  124. .IR string
  125. arguments are allowed, similar to
  126. .IR echo ,
  127. for ease-of-use.
  128. .P
  129. Like the utilities
  130. .IR mailx
  131. and
  132. .IR lp ,
  133. .IR logger
  134. is admittedly difficult to test. This was not deemed sufficient
  135. justification to exclude these utilities from this volume of POSIX.1\(hy2017. It is also
  136. arguable that they are, in fact, testable, but that the tests
  137. themselves are not portable.
  138. .SH "FUTURE DIRECTIONS"
  139. None.
  140. .SH "SEE ALSO"
  141. .IR "\fIlp\fR\^",
  142. .IR "\fImailx\fR\^",
  143. .IR "\fIwrite\fR\^"
  144. .P
  145. The Base Definitions volume of POSIX.1\(hy2017,
  146. .IR "Chapter 8" ", " "Environment Variables"
  147. .\"
  148. .SH COPYRIGHT
  149. Portions of this text are reprinted and reproduced in electronic form
  150. from IEEE Std 1003.1-2017, Standard for Information Technology
  151. -- Portable Operating System Interface (POSIX), The Open Group Base
  152. Specifications Issue 7, 2018 Edition,
  153. Copyright (C) 2018 by the Institute of
  154. Electrical and Electronics Engineers, Inc and The Open Group.
  155. In the event of any discrepancy between this version and the original IEEE and
  156. The Open Group Standard, the original IEEE and The Open Group Standard
  157. is the referee document. The original Standard can be obtained online at
  158. http://www.opengroup.org/unix/online.html .
  159. .PP
  160. Any typographical or formatting errors that appear
  161. in this page are most likely
  162. to have been introduced during the conversion of the source files to
  163. man page format. To report such errors, see
  164. https://www.kernel.org/doc/man-pages/reporting_bugs.html .