Sys::Syslog - Perl interface to the UNIX syslog(3) calls

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Sys::Syslog - Perl interface to the UNIX syslog(3) calls - Perldoc Browser</title> <link rel="search" href="/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser"> <link rel="canonical" href="https://perldoc.perl.org/Sys::Syslog"> <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous"> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" /> <style> body { background: #f4f4f5; color: #020202; } .navbar-dark { background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%); background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%); background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%); filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0); background-repeat: repeat-x; } .navbar-dark .navbar-nav .nav-link, .navbar-dark .navbar-nav .nav-link:focus { color: #fff } .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 } #wrapperlicious { margin: 0 auto; font: 0.9em 'Helvetica Neue', Helvetica, sans-serif; font-weight: normal; line-height: 1.5em; margin: 0; padding: 0; } #wrapperlicious h1 { font-size: 1.5em } #wrapperlicious h2 { font-size: 1.3em } #wrapperlicious h3 { font-size: 1.1em } #wrapperlicious h4 { font-size: 0.9em } #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3, #wrapperlicious h4, #wrapperlicious dt { color: #020202; margin-top: 1em; margin-bottom: 1em; position: relative; font-weight: bold; } #wrapperlicious a { color: inherit; text-decoration: underline } #wrapperlicious #toc { text-decoration: none } #wrapperlicious a:hover { color: #2a2a2a } #wrapperlicious a img { border: 0 } #wrapperlicious :not(pre) > code { color: inherit; background-color: rgba(0, 0, 0, 0.04); border-radius: 3px; font: 0.9em Consolas, Menlo, Monaco, monospace; padding: 0.3em; } #wrapperlicious dd { margin: 0; margin-left: 2em; } #wrapperlicious dt { color: #2a2a2a; font-weight: bold; margin-left: 0.9em; } #wrapperlicious p { margin-bottom: 1em; margin-top: 1em; } #wrapperlicious li > p { margin-bottom: 0; margin-top: 0; } #wrapperlicious pre { border: 1px solid #c1c1c1; border-radius: 3px; font: 100% Consolas, Menlo, Monaco, monospace; margin-bottom: 1em; margin-top: 1em; } #wrapperlicious pre > code { display: block; background-color: #f6f6f6; font: 0.9em Consolas, Menlo, Monaco, monospace; line-height: 1.5em; text-align: left; white-space: pre; padding: 1em; } #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul { margin-bottom: 1em; margin-top: 1em; } #wrapperlicious ul { list-style-type: square; } #wrapperlicious ul ul { margin-bottom: 0px; margin-top: 0px; } #footer { font-size: 0.8em; padding-top: 0.5em; text-align: center; } #more { display: inline; font-size: 0.8em; } #perldocdiv { background-color: #fff; border: 1px solid #c1c1c1; border-bottom-left-radius: 5px; border-bottom-right-radius: 5px; margin-left: auto; margin-right: auto; padding: 3em; padding-top: 1em; max-width: 960px; } #moduleversion { float: right } #wrapperlicious .leading-notice { font-style: italic; padding-left: 1em; margin-top: 1em; margin-bottom: 1em; } #wrapperlicious .permalink { display: none; left: -0.75em; position: absolute; padding-right: 0.25em; text-decoration: none; } #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink, #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink, #wrapperlicious dt:hover .permalink { display: block; } </style>  <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-KVNWBNT5FB'); gtag('config', 'UA-50555-3'); </script> </head> <body> <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between"> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <a class="navbar-brand" href="/"><img src="/images/perl_camel_30.png" width="30" height="30" class="d-inline-block align-top" alt="Perl Camel Logo"> Perldoc Browser</a> <div class="collapse navbar-collapse" id="navbarNav"> <ul class="navbar-nav mr-auto"> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.39.7</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-stable"> <a class="dropdown-item" href="/Sys::Syslog">Latest</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1/Sys::Syslog">5.40.1</a> <a class="dropdown-item" href="/5.40.0/Sys::Syslog">5.40.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3/Sys::Syslog">5.38.3</a> <a class="dropdown-item" href="/5.38.2/Sys::Syslog">5.38.2</a> <a class="dropdown-item" href="/5.38.1/Sys::Syslog">5.38.1</a> <a class="dropdown-item" href="/5.38.0/Sys::Syslog">5.38.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.36.3/Sys::Syslog">5.36.3</a> <a class="dropdown-item" href="/5.36.2/Sys::Syslog">5.36.2</a> <a class="dropdown-item" href="/5.36.1/Sys::Syslog">5.36.1</a> <a class="dropdown-item" href="/5.36.0/Sys::Syslog">5.36.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.34.3/Sys::Syslog">5.34.3</a> <a class="dropdown-item" href="/5.34.2/Sys::Syslog">5.34.2</a> <a class="dropdown-item" href="/5.34.1/Sys::Syslog">5.34.1</a> <a class="dropdown-item" href="/5.34.0/Sys::Syslog">5.34.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.32.1/Sys::Syslog">5.32.1</a> <a class="dropdown-item" href="/5.32.0/Sys::Syslog">5.32.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.30.3/Sys::Syslog">5.30.3</a> <a class="dropdown-item" href="/5.30.2/Sys::Syslog">5.30.2</a> <a class="dropdown-item" href="/5.30.1/Sys::Syslog">5.30.1</a> <a class="dropdown-item" href="/5.30.0/Sys::Syslog">5.30.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.28.3/Sys::Syslog">5.28.3</a> <a class="dropdown-item" href="/5.28.2/Sys::Syslog">5.28.2</a> <a class="dropdown-item" href="/5.28.1/Sys::Syslog">5.28.1</a> <a class="dropdown-item" href="/5.28.0/Sys::Syslog">5.28.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.26.3/Sys::Syslog">5.26.3</a> <a class="dropdown-item" href="/5.26.2/Sys::Syslog">5.26.2</a> <a class="dropdown-item" href="/5.26.1/Sys::Syslog">5.26.1</a> <a class="dropdown-item" href="/5.26.0/Sys::Syslog">5.26.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.24.4/Sys::Syslog">5.24.4</a> <a class="dropdown-item" href="/5.24.3/Sys::Syslog">5.24.3</a> <a class="dropdown-item" href="/5.24.2/Sys::Syslog">5.24.2</a> <a class="dropdown-item" href="/5.24.1/Sys::Syslog">5.24.1</a> <a class="dropdown-item" href="/5.24.0/Sys::Syslog">5.24.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.22.4/Sys::Syslog">5.22.4</a> <a class="dropdown-item" href="/5.22.3/Sys::Syslog">5.22.3</a> <a class="dropdown-item" href="/5.22.2/Sys::Syslog">5.22.2</a> <a class="dropdown-item" href="/5.22.1/Sys::Syslog">5.22.1</a> <a class="dropdown-item" href="/5.22.0/Sys::Syslog">5.22.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.20.3/Sys::Syslog">5.20.3</a> <a class="dropdown-item" href="/5.20.2/Sys::Syslog">5.20.2</a> <a class="dropdown-item" href="/5.20.1/Sys::Syslog">5.20.1</a> <a class="dropdown-item" href="/5.20.0/Sys::Syslog">5.20.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.18.4/Sys::Syslog">5.18.4</a> <a class="dropdown-item" href="/5.18.3/Sys::Syslog">5.18.3</a> <a class="dropdown-item" href="/5.18.2/Sys::Syslog">5.18.2</a> <a class="dropdown-item" href="/5.18.1/Sys::Syslog">5.18.1</a> <a class="dropdown-item" href="/5.18.0/Sys::Syslog">5.18.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.16.3/Sys::Syslog">5.16.3</a> <a class="dropdown-item" href="/5.16.2/Sys::Syslog">5.16.2</a> <a class="dropdown-item" href="/5.16.1/Sys::Syslog">5.16.1</a> <a class="dropdown-item" href="/5.16.0/Sys::Syslog">5.16.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.14.4/Sys::Syslog">5.14.4</a> <a class="dropdown-item" href="/5.14.3/Sys::Syslog">5.14.3</a> <a class="dropdown-item" href="/5.14.2/Sys::Syslog">5.14.2</a> <a class="dropdown-item" href="/5.14.1/Sys::Syslog">5.14.1</a> <a class="dropdown-item" href="/5.14.0/Sys::Syslog">5.14.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.12.5/Sys::Syslog">5.12.5</a> <a class="dropdown-item" href="/5.12.4/Sys::Syslog">5.12.4</a> <a class="dropdown-item" href="/5.12.3/Sys::Syslog">5.12.3</a> <a class="dropdown-item" href="/5.12.2/Sys::Syslog">5.12.2</a> <a class="dropdown-item" href="/5.12.1/Sys::Syslog">5.12.1</a> <a class="dropdown-item" href="/5.12.0/Sys::Syslog">5.12.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.10.1/Sys::Syslog">5.10.1</a> <a class="dropdown-item" href="/5.10.0/Sys::Syslog">5.10.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.8.9/Sys::Syslog">5.8.9</a> <a class="dropdown-item" href="/5.8.8/Sys::Syslog">5.8.8</a> <a class="dropdown-item" href="/5.8.7/Sys::Syslog">5.8.7</a> <a class="dropdown-item" href="/5.8.6/Sys::Syslog">5.8.6</a> <a class="dropdown-item" href="/5.8.5/Sys::Syslog">5.8.5</a> <a class="dropdown-item" href="/5.8.4/Sys::Syslog">5.8.4</a> <a class="dropdown-item" href="/5.8.3/Sys::Syslog">5.8.3</a> <a class="dropdown-item" href="/5.8.2/Sys::Syslog">5.8.2</a> <a class="dropdown-item" href="/5.8.1/Sys::Syslog">5.8.1</a> <a class="dropdown-item" href="/5.8.0/Sys::Syslog">5.8.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.6.2/Sys::Syslog">5.6.2</a> <a class="dropdown-item" href="/5.6.1/Sys::Syslog">5.6.1</a> <a class="dropdown-item" href="/5.6.0/Sys::Syslog">5.6.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.005_04/Sys::Syslog">5.005_04</a> <a class="dropdown-item" href="/5.005_03/Sys::Syslog">5.005_03</a> <a class="dropdown-item" href="/5.005_02/Sys::Syslog">5.005_02</a> <a class="dropdown-item" href="/5.005_01/Sys::Syslog">5.005_01</a> <a class="dropdown-item" href="/5.005/Sys::Syslog">5.005</a> </div> </li> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-dev"> <a class="dropdown-item" href="/blead/Sys::Syslog">blead</a> <a class="dropdown-item" href="/5.41.10/Sys::Syslog">5.41.10</a> <a class="dropdown-item" href="/5.41.9/Sys::Syslog">5.41.9</a> <a class="dropdown-item" href="/5.41.8/Sys::Syslog">5.41.8</a> <a class="dropdown-item" href="/5.41.7/Sys::Syslog">5.41.7</a> <a class="dropdown-item" href="/5.41.6/Sys::Syslog">5.41.6</a> <a class="dropdown-item" href="/5.41.5/Sys::Syslog">5.41.5</a> <a class="dropdown-item" href="/5.41.4/Sys::Syslog">5.41.4</a> <a class="dropdown-item" href="/5.41.3/Sys::Syslog">5.41.3</a> <a class="dropdown-item" href="/5.41.2/Sys::Syslog">5.41.2</a> <a class="dropdown-item" href="/5.41.1/Sys::Syslog">5.41.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1-RC1/Sys::Syslog">5.40.1-RC1</a> <a class="dropdown-item" href="/5.40.0-RC2/Sys::Syslog">5.40.0-RC2</a> <a class="dropdown-item" href="/5.40.0-RC1/Sys::Syslog">5.40.0-RC1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.39.10/Sys::Syslog">5.39.10</a> <a class="dropdown-item" href="/5.39.9/Sys::Syslog">5.39.9</a> <a class="dropdown-item" href="/5.39.8/Sys::Syslog">5.39.8</a> <a class="dropdown-item active" href="/5.39.7/Sys::Syslog">5.39.7</a> <a class="dropdown-item" href="/5.39.6/Sys::Syslog">5.39.6</a> <a class="dropdown-item" href="/5.39.5/Sys::Syslog">5.39.5</a> <a class="dropdown-item" href="/5.39.4/Sys::Syslog">5.39.4</a> <a class="dropdown-item" href="/5.39.3/Sys::Syslog">5.39.3</a> <a class="dropdown-item" href="/5.39.2/Sys::Syslog">5.39.2</a> <a class="dropdown-item" href="/5.39.1/Sys::Syslog">5.39.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3-RC1/Sys::Syslog">5.38.3-RC1</a> </div> </li> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-nav"> <a class="dropdown-item" href="/5.39.7/perl">Perl</a> <a class="dropdown-item" href="/5.39.7/perlintro">Intro</a> <a class="dropdown-item" href="/5.39.7/perl#Tutorials">Tutorials</a> <a class="dropdown-item" href="/5.39.7/perlfaq">FAQs</a> <a class="dropdown-item" href="/5.39.7/perl#Reference-Manual">Reference</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.39.7/perlop">Operators</a> <a class="dropdown-item" href="/5.39.7/functions">Functions</a> <a class="dropdown-item" href="/5.39.7/variables">Variables</a> <a class="dropdown-item" href="/5.39.7/modules">Modules</a> <a class="dropdown-item" href="/5.39.7/perlutil">Utilities</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.39.7/perldelta">Release Notes</a> <a class="dropdown-item" href="/5.39.7/perlcommunity">Community</a> <a class="dropdown-item" href="/5.39.7/perlhist">History</a> </div> </li> </ul> <ul class="navbar-nav"> <script> function set_expand (expand) { var perldocdiv = document.getElementById('perldocdiv'); var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width'); var expanded = (width == '' || width == 'none') ? true : false; if (expand === null) { expand = !expanded; } if ((expand && !expanded) || (!expand && expanded)) { perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px'); var button_classlist = document.getElementById('content-expand-button').classList; if (expand) { button_classlist.add('btn-light'); button_classlist.remove('btn-outline-light'); } else { button_classlist.add('btn-outline-light'); button_classlist.remove('btn-light'); } } return expand; } function toggle_expand () { var expand = set_expand(null); document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC'; } function read_expand () { return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', function () { if (read_expand()) { set_expand(true); } }); } else if (read_expand()) { set_expand(true); } </script> <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-4" onclick="toggle_expand()">Expand</button> </ul> <form class="form-inline" method="get" action="/5.39.7/search"> <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search" value=""> </form> </div> </nav> <div id="wrapperlicious" class="container-fluid"> <div id="perldocdiv"> <div id="links"> <a href="/5.39.7/Sys::Syslog">Sys::Syslog</a> <div id="more"> (<a href="/5.39.7/Sys::Syslog.txt">source</a>, <a href="https://metacpan.org/pod/Sys::Syslog">CPAN</a>) </div> <div id="moduleversion">version 0.36</div> </div> <div class="leading-notice"> You are viewing the version of this documentation from Perl 5.39.7. This is a development version of Perl. </div> <h1><a id="toc">CONTENTS</a></h1> <ul> <li> <a class="text-decoration-none" href="#NAME">NAME</a> </li> <li> <a class="text-decoration-none" href="#VERSION">VERSION</a> </li> <li> <a class="text-decoration-none" href="#SYNOPSIS">SYNOPSIS</a> </li> <li> <a class="text-decoration-none" href="#DESCRIPTION">DESCRIPTION</a> </li> <li> <a class="text-decoration-none" href="#EXPORTS">EXPORTS</a> </li> <li> <a class="text-decoration-none" href="#FUNCTIONS">FUNCTIONS</a> </li> <li> <a class="text-decoration-none" href="#THE-RULES-OF-SYS::SYSLOG">THE RULES OF SYS::SYSLOG</a> </li> <li> <a class="text-decoration-none" href="#EXAMPLES">EXAMPLES</a> </li> <li> <a class="text-decoration-none" href="#CONSTANTS">CONSTANTS</a> <ul> <li> <a class="text-decoration-none" href="#Facilities">Facilities</a> </li> <li> <a class="text-decoration-none" href="#Levels">Levels</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#DIAGNOSTICS">DIAGNOSTICS</a> </li> <li> <a class="text-decoration-none" href="#HISTORY">HISTORY</a> </li> <li> <a class="text-decoration-none" href="#SEE-ALSO">SEE ALSO</a> <ul> <li> <a class="text-decoration-none" href="#Other-modules">Other modules</a> </li> <li> <a class="text-decoration-none" href="#Manual-Pages">Manual Pages</a> </li> <li> <a class="text-decoration-none" href="#RFCs">RFCs</a> </li> <li> <a class="text-decoration-none" href="#Articles">Articles</a> </li> <li> <a class="text-decoration-none" href="#Event-Log">Event Log</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#AUTHORS-&-ACKNOWLEDGEMENTS">AUTHORS & ACKNOWLEDGEMENTS</a> </li> <li> <a class="text-decoration-none" href="#BUGS">BUGS</a> </li> <li> <a class="text-decoration-none" href="#SUPPORT">SUPPORT</a> </li> <li> <a class="text-decoration-none" href="#COPYRIGHT">COPYRIGHT</a> </li> <li> <a class="text-decoration-none" href="#LICENSE">LICENSE</a> </li> </ul> <h1 id="NAME"><a class="permalink" href="#NAME">#</a>NAME</h1> <p>Sys::Syslog - Perl interface to the UNIX syslog(3) calls</p> <h1 id="VERSION"><a class="permalink" href="#VERSION">#</a>VERSION</h1> <p>This is the documentation of version 0.36</p> <h1 id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">#</a>SYNOPSIS</h1> <pre><code>use Sys::Syslog; # all except setlogsock() use Sys::Syslog qw(:standard :macros); # standard functions & macros openlog($ident, $logopt, $facility); # don't forget this syslog($priority, $format, @args); $oldmask = setlogmask($mask_priority); closelog();</code></pre> <h1 id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">#</a>DESCRIPTION</h1> <p><code>Sys::Syslog</code> is an interface to the UNIX <code>syslog(3)</code> program. Call <code>syslog()</code> with a string priority and a list of <code>printf()</code> args just like <code>syslog(3)</code>.</p> <h1 id="EXPORTS"><a class="permalink" href="#EXPORTS">#</a>EXPORTS</h1> <p><code>Sys::Syslog</code> exports the following <code>Exporter</code> tags:</p> <ul> <li><p><code>:standard</code> exports the standard <code>syslog(3)</code> functions:</p> <pre><code class="plaintext">openlog closelog setlogmask syslog</code></pre> </li> <li><p><code>:extended</code> exports the Perl specific functions for <code>syslog(3)</code>:</p> <pre><code class="plaintext">setlogsock</code></pre> </li> <li><p><code>:macros</code> exports the symbols corresponding to most of your <code>syslog(3)</code> macros and the <code>LOG_UPTO()</code> and <code>LOG_MASK()</code> functions. See <a href="#CONSTANTS">"CONSTANTS"</a> for the supported constants and their meaning.</p> </li> </ul> <p>By default, <code>Sys::Syslog</code> exports the symbols from the <code>:standard</code> tag.</p> <h1 id="FUNCTIONS"><a class="permalink" href="#FUNCTIONS">#</a>FUNCTIONS</h1> <dl> <dt id="openlog($ident,-$logopt,-$facility)"><a class="permalink" href="#openlog($ident,-$logopt,-$facility)">#</a><a id="openlog"></a><a id="openlog-ident-logopt-facility"></a><b>openlog($ident, $logopt, $facility)</b></dt> <dd> <p>Opens the syslog. <code>$ident</code> is prepended to every message. <code>$logopt</code> contains zero or more of the options detailed below. <code>$facility</code> specifies the part of the system to report about, for example <code>LOG_USER</code> or <code>LOG_LOCAL0</code>: see <a href="#Facilities">"Facilities"</a> for a list of well-known facilities, and your <code>syslog(3)</code> documentation for the facilities available in your system. Check <a href="#SEE-ALSO">"SEE ALSO"</a> for useful links. Facility can be given as a string or a numeric macro.</p> <p>This function will croak if it can't connect to the syslog daemon.</p> <p>Note that <code>openlog()</code> now takes three arguments, just like <code>openlog(3)</code>.</p> <p><b>You should use <code>openlog()</code> before calling <code>syslog()</code>.</b></p> <p><b>Options</b></p> <ul> <li><p><code>cons</code> - This option is ignored, since the failover mechanism will drop down to the console automatically if all other media fail.</p> </li> <li><p><code>ndelay</code> - Open the connection immediately (normally, the connection is opened when the first message is logged).</p> </li> <li><p><code>noeol</code> - When set to true, no end of line character (<code>\n</code>) will be appended to the message. This can be useful for some syslog daemons. Added in <code>Sys::Syslog</code> 0.29.</p> </li> <li><p><code>nofatal</code> - When set to true, <code>openlog()</code> and <code>syslog()</code> will only emit warnings instead of dying if the connection to the syslog can't be established. Added in <code>Sys::Syslog</code> 0.15.</p> </li> <li><p><code>nonul</code> - When set to true, no <code>NUL</code> character (<code>\0</code>) will be appended to the message. This can be useful for some syslog daemons. Added in <code>Sys::Syslog</code> 0.29.</p> </li> <li><p><code>nowait</code> - Don't wait for child processes that may have been created while logging the message. (The GNU C library does not create a child process, so this option has no effect on Linux.)</p> </li> <li><p><code>perror</code> - Write the message to standard error output as well to the system log. Added in <code>Sys::Syslog</code> 0.22.</p> </li> <li><p><code>pid</code> - Include PID with each message.</p> </li> </ul> <p><b>Examples</b></p> <p>Open the syslog with options <code>ndelay</code> and <code>pid</code>, and with facility <code>LOCAL0</code>:</p> <pre><code>openlog($name, "ndelay,pid", "local0");</code></pre> <p>Same thing, but this time using the macro corresponding to <code>LOCAL0</code>:</p> <pre><code>openlog($name, "ndelay,pid", LOG_LOCAL0);</code></pre> </dd> <dt id="syslog($priority,-$message)"><a class="permalink" href="#syslog($priority,-$message)">#</a><a id="syslog"></a><a id="syslog-priority-message"></a><b>syslog($priority, $message)</b></dt> <dd> </dd> <dt id="syslog($priority,-$format,-@args)"><a class="permalink" href="#syslog($priority,-$format,-@args)">#</a><a id="syslog1"></a><a id="syslog-priority-format-args"></a><b>syslog($priority, $format, @args)</b></dt> <dd> <p>If <code>$priority</code> permits, logs <code>$message</code> or <code>sprintf($format, @args)</code> with the addition that <code>%m</code> in $message or <code>$format</code> is replaced with <code>"$!"</code> (the latest error message).</p> <p><code>$priority</code> can specify a level, or a level and a facility. Levels and facilities can be given as strings or as macros. When using the <code>eventlog</code> mechanism, priorities <code>DEBUG</code> and <code>INFO</code> are mapped to event type <code>informational</code>, <code>NOTICE</code> and <code>WARNING</code> to <code>warning</code> and <code>ERR</code> to <code>EMERG</code> to <code>error</code>.</p> <p>If you didn't use <code>openlog()</code> before using <code>syslog()</code>, <code>syslog()</code> will try to guess the <code>$ident</code> by extracting the shortest prefix of <code>$format</code> that ends in a <code>":"</code>.</p> <p><b>Examples</b></p> <pre><code># informational level syslog("info", $message); syslog(LOG_INFO, $message); # information level, Local0 facility syslog("info|local0", $message); syslog(LOG_INFO|LOG_LOCAL0, $message);</code></pre> <dl> <dt id="Note"><a class="permalink" href="#Note">#</a><b>Note</b></dt> <dd> <p><code>Sys::Syslog</code> version v0.07 and older passed the <code>$message</code> as the formatting string to <code>sprintf()</code> even when no formatting arguments were provided. If the code calling <code>syslog()</code> might execute with older versions of this module, make sure to call the function as <code>syslog($priority, "%s", $message)</code> instead of <code>syslog($priority, $message)</code>. This protects against hostile formatting sequences that might show up if $message contains tainted data.</p> </dd> </dl> </dd> <dt id="setlogmask($mask_priority)"><a class="permalink" href="#setlogmask($mask_priority)">#</a><a id="setlogmask"></a><a id="setlogmask-mask_priority"></a><b>setlogmask($mask_priority)</b></dt> <dd> <p>Sets the log mask for the current process to <code>$mask_priority</code> and returns the old mask. If the mask argument is 0, the current log mask is not modified. See <a href="#Levels">"Levels"</a> for the list of available levels. You can use the <code>LOG_UPTO()</code> function to allow all levels up to a given priority (but it only accept the numeric macros as arguments).</p> <p><b>Examples</b></p> <p>Only log errors:</p> <pre><code>setlogmask( LOG_MASK(LOG_ERR) );</code></pre> <p>Log everything except informational messages:</p> <pre><code>setlogmask( ~(LOG_MASK(LOG_INFO)) );</code></pre> <p>Log critical messages, errors and warnings:</p> <pre><code>setlogmask( LOG_MASK(LOG_CRIT) | LOG_MASK(LOG_ERR) | LOG_MASK(LOG_WARNING) );</code></pre> <p>Log all messages up to debug:</p> <pre><code>setlogmask( LOG_UPTO(LOG_DEBUG) );</code></pre> </dd> <dt id="setlogsock()"><a class="permalink" href="#setlogsock()">#</a><a id="setlogsock"></a><b>setlogsock()</b></dt> <dd> <p>Sets the socket type and options to be used for the next call to <code>openlog()</code> or <code>syslog()</code>. Returns true on success, <code>undef</code> on failure.</p> <p>Being Perl-specific, this function has evolved along time. It can currently be called as follow:</p> <ul> <li><p><code>setlogsock($sock_type)</code></p> </li> <li><p><code>setlogsock($sock_type, $stream_location)</code> (added in Perl 5.004_02)</p> </li> <li><p><code>setlogsock($sock_type, $stream_location, $sock_timeout)</code> (added in <code>Sys::Syslog</code> 0.25)</p> </li> <li><p><code>setlogsock(\%options)</code> (added in <code>Sys::Syslog</code> 0.28)</p> </li> </ul> <p>The available options are:</p> <ul> <li><p><code>type</code> - equivalent to <code>$sock_type</code>, selects the socket type (or "mechanism"). An array reference can be passed to specify several mechanisms to try, in the given order.</p> </li> <li><p><code>path</code> - equivalent to <code>$stream_location</code>, sets the stream location. Defaults to standard Unix location, or <code>_PATH_LOG</code>.</p> </li> <li><p><code>timeout</code> - equivalent to <code>$sock_timeout</code>, sets the socket timeout in seconds. Defaults to 0 on all systems except <span style="white-space: nowrap;">Mac OS X</span> where it is set to 0.25 sec.</p> </li> <li><p><code>host</code> - sets the hostname to send the messages to. Defaults to the local host.</p> </li> <li><p><code>port</code> - sets the TCP or UDP port to connect to. Defaults to the first standard syslog port available on the system.</p> </li> </ul> <p>The available mechanisms are:</p> <ul> <li><p><code>"native"</code> - use the native C functions from your <code>syslog(3)</code> library (added in <code>Sys::Syslog</code> 0.15).</p> </li> <li><p><code>"eventlog"</code> - send messages to the Win32 events logger (Win32 only; added in <code>Sys::Syslog</code> 0.19).</p> </li> <li><p><code>"tcp"</code> - connect to a TCP socket, on the <code>syslog/tcp</code> or <code>syslogng/tcp</code> service. See also the <code>host</code>, <code>port</code> and <code>timeout</code> options.</p> </li> <li><p><code>"udp"</code> - connect to a UDP socket, on the <code>syslog/udp</code> service. See also the <code>host</code>, <code>port</code> and <code>timeout</code> options.</p> </li> <li><p><code>"inet"</code> - connect to an INET socket, either TCP or UDP, tried in that order. See also the <code>host</code>, <code>port</code> and <code>timeout</code> options.</p> </li> <li><p><code>"unix"</code> - connect to a UNIX domain socket (in some systems a character special device). The name of that socket is given by the <code>path</code> option or, if omitted, the value returned by the <code>_PATH_LOG</code> macro (if your system defines it), <i>/dev/log</i> or <i>/dev/conslog</i>, whichever is writable.</p> </li> <li><p><code>"stream"</code> - connect to the stream indicated by the <code>path</code> option, or, if omitted, the value returned by the <code>_PATH_LOG</code> macro (if your system defines it), <i>/dev/log</i> or <i>/dev/conslog</i>, whichever is writable. For example Solaris and IRIX system may prefer <code>"stream"</code> instead of <code>"unix"</code>.</p> </li> <li><p><code>"pipe"</code> - connect to the named pipe indicated by the <code>path</code> option, or, if omitted, to the value returned by the <code>_PATH_LOG</code> macro (if your system defines it), or <i>/dev/log</i> (added in <code>Sys::Syslog</code> 0.21). HP-UX is a system which uses such a named pipe.</p> </li> <li><p><code>"console"</code> - send messages directly to the console, as for the <code>"cons"</code> option of <code>openlog()</code>.</p> </li> </ul> <p>The default is to try <code>native</code>, <code>tcp</code>, <code>udp</code>, <code>unix</code>, <code>pipe</code>, <code>stream</code>, <code>console</code>. Under systems with the Win32 API, <code>eventlog</code> will be added as the first mechanism to try if <code>Win32::EventLog</code> is available.</p> <p>Giving an invalid value for <code>$sock_type</code> will <code>croak</code>.</p> <p><b>Examples</b></p> <p>Select the UDP socket mechanism:</p> <pre><code>setlogsock("udp");</code></pre> <p>Send messages using the TCP socket mechanism on a custom port:</p> <pre><code>setlogsock({ type => "tcp", port => 2486 });</code></pre> <p>Send messages to a remote host using the TCP socket mechanism:</p> <pre><code>setlogsock({ type => "tcp", host => $loghost });</code></pre> <p>Try the native, UDP socket then UNIX domain socket mechanisms:</p> <pre><code>setlogsock(["native", "udp", "unix"]);</code></pre> <dl> <dt id="Note1"><a class="permalink" href="#Note1">#</a><b>Note</b></dt> <dd> <p>Now that the "native" mechanism is supported by <code>Sys::Syslog</code> and selected by default, the use of the <code>setlogsock()</code> function is discouraged because other mechanisms are less portable across operating systems. Authors of modules and programs that use this function, especially its cargo-cult form <code>setlogsock("unix")</code>, are advised to remove any occurrence of it unless they specifically want to use a given mechanism (like TCP or UDP to connect to a remote host).</p> </dd> </dl> </dd> <dt id="closelog()"><a class="permalink" href="#closelog()">#</a><a id="closelog"></a><b>closelog()</b></dt> <dd> <p>Closes the log file and returns true on success.</p> </dd> </dl> <h1 id="THE-RULES-OF-SYS::SYSLOG"><a class="permalink" href="#THE-RULES-OF-SYS::SYSLOG">#</a><a id="THE"></a>THE RULES OF SYS::SYSLOG</h1> <p><i>The First Rule of Sys::Syslog is:</i> You do not call <code>setlogsock</code>.</p> <p><i>The Second Rule of Sys::Syslog is:</i> You <b>do not</b> call <code>setlogsock</code>.</p> <p><i>The Third Rule of Sys::Syslog is:</i> The program crashes, <code>die</code>s, calls <code>closelog</code>, the log is over.</p> <p><i>The Fourth Rule of Sys::Syslog is:</i> One facility, one priority.</p> <p><i>The Fifth Rule of Sys::Syslog is:</i> One log at a time.</p> <p><i>The Sixth Rule of Sys::Syslog is:</i> No <code>syslog</code> before <code>openlog</code>.</p> <p><i>The Seventh Rule of Sys::Syslog is:</i> Logs will go on as long as they have to.</p> <p><i>The Eighth, and Final Rule of Sys::Syslog is:</i> If this is your first use of Sys::Syslog, you must read the doc.</p> <h1 id="EXAMPLES"><a class="permalink" href="#EXAMPLES">#</a>EXAMPLES</h1> <p>An example:</p> <pre><code>openlog($program, 'cons,pid', 'user'); syslog('info', '%s', 'this is another test'); syslog('mail|warning', 'this is a better test: %d', time); closelog(); syslog('debug', 'this is the last test');</code></pre> <p>Another example:</p> <pre><code>openlog("$program $$", 'ndelay', 'user'); syslog('notice', 'fooprogram: this is really done');</code></pre> <p>Example of use of <code>%m</code>:</p> <pre><code>$! = 55; syslog('info', 'problem was %m'); # %m == $! in syslog(3)</code></pre> <p>Log to UDP port on <code>$remotehost</code> instead of logging locally:</p> <pre><code>setlogsock("udp", $remotehost); openlog($program, 'ndelay', 'user'); syslog('info', 'something happened over here');</code></pre> <h1 id="CONSTANTS"><a class="permalink" href="#CONSTANTS">#</a>CONSTANTS</h1> <h2 id="Facilities"><a class="permalink" href="#Facilities">#</a>Facilities</h2> <ul> <li><p><code>LOG_AUDIT</code> - audit daemon (IRIX); falls back to <code>LOG_AUTH</code></p> </li> <li><p><code>LOG_AUTH</code> - security/authorization messages</p> </li> <li><p><code>LOG_AUTHPRIV</code> - security/authorization messages (private)</p> </li> <li><p><code>LOG_CONSOLE</code> - <code>/dev/console</code> output (FreeBSD); falls back to <code>LOG_USER</code></p> </li> <li><p><code>LOG_CRON</code> - clock daemons (<b>cron</b> and <b>at</b>)</p> </li> <li><p><code>LOG_DAEMON</code> - system daemons without separate facility value</p> </li> <li><p><code>LOG_FTP</code> - FTP daemon</p> </li> <li><p><code>LOG_KERN</code> - kernel messages</p> </li> <li><p><code>LOG_INSTALL</code> - installer subsystem (Mac OS X); falls back to <code>LOG_USER</code></p> </li> <li><p><code>LOG_LAUNCHD</code> - launchd - general bootstrap daemon (Mac OS X); falls back to <code>LOG_DAEMON</code></p> </li> <li><p><code>LOG_LFMT</code> - logalert facility; falls back to <code>LOG_USER</code></p> </li> <li><p><code>LOG_LOCAL0</code> through <code>LOG_LOCAL7</code> - reserved for local use</p> </li> <li><p><code>LOG_LPR</code> - line printer subsystem</p> </li> <li><p><code>LOG_MAIL</code> - mail subsystem</p> </li> <li><p><code>LOG_NETINFO</code> - NetInfo subsystem (Mac OS X); falls back to <code>LOG_DAEMON</code></p> </li> <li><p><code>LOG_NEWS</code> - USENET news subsystem</p> </li> <li><p><code>LOG_NTP</code> - NTP subsystem (FreeBSD, NetBSD); falls back to <code>LOG_DAEMON</code></p> </li> <li><p><code>LOG_RAS</code> - Remote Access Service (VPN / PPP) (Mac OS X); falls back to <code>LOG_AUTH</code></p> </li> <li><p><code>LOG_REMOTEAUTH</code> - remote authentication/authorization (Mac OS X); falls back to <code>LOG_AUTH</code></p> </li> <li><p><code>LOG_SECURITY</code> - security subsystems (firewalling, etc.) (FreeBSD); falls back to <code>LOG_AUTH</code></p> </li> <li><p><code>LOG_SYSLOG</code> - messages generated internally by <b>syslogd</b></p> </li> <li><p><code>LOG_USER</code> (default) - generic user-level messages</p> </li> <li><p><code>LOG_UUCP</code> - UUCP subsystem</p> </li> </ul> <h2 id="Levels"><a class="permalink" href="#Levels">#</a>Levels</h2> <ul> <li><p><code>LOG_EMERG</code> - system is unusable</p> </li> <li><p><code>LOG_ALERT</code> - action must be taken immediately</p> </li> <li><p><code>LOG_CRIT</code> - critical conditions</p> </li> <li><p><code>LOG_ERR</code> - error conditions</p> </li> <li><p><code>LOG_WARNING</code> - warning conditions</p> </li> <li><p><code>LOG_NOTICE</code> - normal, but significant, condition</p> </li> <li><p><code>LOG_INFO</code> - informational message</p> </li> <li><p><code>LOG_DEBUG</code> - debug-level message</p> </li> </ul> <h1 id="DIAGNOSTICS"><a class="permalink" href="#DIAGNOSTICS">#</a>DIAGNOSTICS</h1> <dl> <dt id="Invalid-argument-passed-to-setlogsock"><a class="permalink" href="#Invalid-argument-passed-to-setlogsock">#</a><a id="Invalid"></a><code>Invalid argument passed to setlogsock</code></dt> <dd> <p><b>(F)</b> You gave <code>setlogsock()</code> an invalid value for <code>$sock_type</code>.</p> </dd> <dt id="eventlog-passed-to-setlogsock,-but-no-Win32-API-available"><a class="permalink" href="#eventlog-passed-to-setlogsock,-but-no-Win32-API-available">#</a><a id="eventlog"></a><a id="eventlog-passed-to-setlogsock-but-no-Win32-API-available"></a><code>eventlog passed to setlogsock, but no Win32 API available</code></dt> <dd> <p><b>(W)</b> You asked <code>setlogsock()</code> to use the Win32 event logger but the operating system running the program isn't Win32 or does not provides Win32 compatible facilities.</p> </dd> <dt id="no-connection-to-syslog-available"><a class="permalink" href="#no-connection-to-syslog-available">#</a><a id="no"></a><code>no connection to syslog available</code></dt> <dd> <p><b>(F)</b> <code>syslog()</code> failed to connect to the specified socket.</p> </dd> <dt id="stream-passed-to-setlogsock,-but-%s-is-not-writable"><a class="permalink" href="#stream-passed-to-setlogsock,-but-%25s-is-not-writable">#</a><a id="stream"></a><a id="stream-passed-to-setlogsock-but-s-is-not-writable"></a><code>stream passed to setlogsock, but %s is not writable</code></dt> <dd> <p><b>(W)</b> You asked <code>setlogsock()</code> to use a stream socket, but the given path is not writable.</p> </dd> <dt id="stream-passed-to-setlogsock,-but-could-not-find-any-device"><a class="permalink" href="#stream-passed-to-setlogsock,-but-could-not-find-any-device">#</a><a id="stream1"></a><a id="stream-passed-to-setlogsock-but-could-not-find-any-device"></a><code>stream passed to setlogsock, but could not find any device</code></dt> <dd> <p><b>(W)</b> You asked <code>setlogsock()</code> to use a stream socket, but didn't provide a path, and <code>Sys::Syslog</code> was unable to find an appropriate one.</p> </dd> <dt id="tcp-passed-to-setlogsock,-but-tcp-service-unavailable"><a class="permalink" href="#tcp-passed-to-setlogsock,-but-tcp-service-unavailable">#</a><a id="tcp"></a><a id="tcp-passed-to-setlogsock-but-tcp-service-unavailable"></a><code>tcp passed to setlogsock, but tcp service unavailable</code></dt> <dd> <p><b>(W)</b> You asked <code>setlogsock()</code> to use a TCP socket, but the service is not available on the system.</p> </dd> <dt id="syslog:-expecting-argument-%s"><a class="permalink" href="#syslog:-expecting-argument-%25s">#</a><a id="syslog2"></a><a id="syslog:-expecting-argument-s"></a><code>syslog: expecting argument %s</code></dt> <dd> <p><b>(F)</b> You forgot to give <code>syslog()</code> the indicated argument.</p> </dd> <dt id="syslog:-invalid-level/facility:-%s"><a class="permalink" href="#syslog:-invalid-level/facility:-%25s">#</a><a id="syslog3"></a><a id="syslog:-invalid-level-facility:-s"></a><code>syslog: invalid level/facility: %s</code></dt> <dd> <p><b>(F)</b> You specified an invalid level or facility.</p> </dd> <dt id="syslog:-too-many-levels-given:-%s"><a class="permalink" href="#syslog:-too-many-levels-given:-%25s">#</a><a id="syslog4"></a><a id="syslog:-too-many-levels-given:-s"></a><code>syslog: too many levels given: %s</code></dt> <dd> <p><b>(F)</b> You specified too many levels.</p> </dd> <dt id="syslog:-too-many-facilities-given:-%s"><a class="permalink" href="#syslog:-too-many-facilities-given:-%25s">#</a><a id="syslog5"></a><a id="syslog:-too-many-facilities-given:-s"></a><code>syslog: too many facilities given: %s</code></dt> <dd> <p><b>(F)</b> You specified too many facilities.</p> </dd> <dt id="syslog:-level-must-be-given"><a class="permalink" href="#syslog:-level-must-be-given">#</a><a id="syslog6"></a><code>syslog: level must be given</code></dt> <dd> <p><b>(F)</b> You forgot to specify a level.</p> </dd> <dt id="udp-passed-to-setlogsock,-but-udp-service-unavailable"><a class="permalink" href="#udp-passed-to-setlogsock,-but-udp-service-unavailable">#</a><a id="udp"></a><a id="udp-passed-to-setlogsock-but-udp-service-unavailable"></a><code>udp passed to setlogsock, but udp service unavailable</code></dt> <dd> <p><b>(W)</b> You asked <code>setlogsock()</code> to use a UDP socket, but the service is not available on the system.</p> </dd> <dt id="unix-passed-to-setlogsock,-but-path-not-available"><a class="permalink" href="#unix-passed-to-setlogsock,-but-path-not-available">#</a><a id="unix"></a><a id="unix-passed-to-setlogsock-but-path-not-available"></a><code>unix passed to setlogsock, but path not available</code></dt> <dd> <p><b>(W)</b> You asked <code>setlogsock()</code> to use a UNIX socket, but <code>Sys::Syslog</code> was unable to find an appropriate an appropriate device.</p> </dd> </dl> <h1 id="HISTORY"><a class="permalink" href="#HISTORY">#</a>HISTORY</h1> <p><code>Sys::Syslog</code> is a core module, part of the standard Perl distribution since 1990. At this time, modules as we know them didn't exist, the Perl library was a collection of <i>.pl</i> files, and the one for sending syslog messages with was simply <i>lib/syslog.pl</i>, included with Perl 3.0. It was converted as a module with Perl 5.0, but had a version number only starting with Perl 5.6. Here is a small table with the matching Perl and <code>Sys::Syslog</code> versions.</p> <pre><code class="plaintext">Sys::Syslog Perl ----------- ---- undef 5.0.0 ~ 5.5.4 0.01 5.6.* 0.03 5.8.0 0.04 5.8.1, 5.8.2, 5.8.3 0.05 5.8.4, 5.8.5, 5.8.6 0.06 5.8.7 0.13 5.8.8 0.22 5.10.0 0.27 5.8.9, 5.10.1 ~ 5.14.* 0.29 5.16.* 0.32 5.18.* 0.33 5.20.* 0.33 5.22.*</code></pre> <h1 id="SEE-ALSO"><a class="permalink" href="#SEE-ALSO">#</a><a id="SEE"></a>SEE ALSO</h1> <h2 id="Other-modules"><a class="permalink" href="#Other-modules">#</a><a id="Other"></a>Other modules</h2> <p><a href="/5.39.7/Log::Log4perl">Log::Log4perl</a> - Perl implementation of the Log4j API</p> <p><a href="/5.39.7/Log::Dispatch">Log::Dispatch</a> - Dispatches messages to one or more outputs</p> <p><a href="/5.39.7/Log::Report">Log::Report</a> - Report a problem, with exceptions and language support</p> <h2 id="Manual-Pages"><a class="permalink" href="#Manual-Pages">#</a><a id="Manual"></a>Manual Pages</h2> <p><a href="http://man.he.net/man3/syslog">syslog(3)</a></p> <p>SUSv3 issue 6, IEEE Std 1003.1, 2004 edition, <a href="http://www.opengroup.org/onlinepubs/000095399/basedefs/syslog.h.html">http://www.opengroup.org/onlinepubs/000095399/basedefs/syslog.h.html</a></p> <p>GNU C Library documentation on syslog, <a href="http://www.gnu.org/software/libc/manual/html_node/Syslog.html">http://www.gnu.org/software/libc/manual/html_node/Syslog.html</a></p> <p>FreeBSD documentation on syslog, <a href="https://www.freebsd.org/cgi/man.cgi?query=syslog">https://www.freebsd.org/cgi/man.cgi?query=syslog</a></p> <p>Solaris 11 documentation on syslog, <a href="https://docs.oracle.com/cd/E53394_01/html/E54766/syslog-3c.html">https://docs.oracle.com/cd/E53394_01/html/E54766/syslog-3c.html</a></p> <p>Mac OS X documentation on syslog, <a href="http://developer.apple.com/documentation/Darwin/Reference/ManPages/man3/syslog.3.html">http://developer.apple.com/documentation/Darwin/Reference/ManPages/man3/syslog.3.html</a></p> <p>IRIX documentation on syslog, <a href="http://nixdoc.net/man-pages/IRIX/man3/syslog.3c.html">http://nixdoc.net/man-pages/IRIX/man3/syslog.3c.html</a></p> <p>AIX 5L 5.3 documentation on syslog, <a href="http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp?topic=/com.ibm.aix.basetechref/doc/basetrf2/syslog.htm">http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp?topic=/com.ibm.aix.basetechref/doc/basetrf2/syslog.htm</a></p> <p>HP-UX 11i documentation on syslog, <a href="http://docs.hp.com/en/B2355-60130/syslog.3C.html">http://docs.hp.com/en/B2355-60130/syslog.3C.html</a></p> <p>Tru64 documentation on syslog, <a href="http://nixdoc.net/man-pages/Tru64/man3/syslog.3.html">http://nixdoc.net/man-pages/Tru64/man3/syslog.3.html</a></p> <p>Stratus VOS 15.1, <a href="http://stratadoc.stratus.com/vos/15.1.1/r502-01/wwhelp/wwhimpl/js/html/wwhelp.htm?context=r502-01&file=ch5r502-01bi.html">http://stratadoc.stratus.com/vos/15.1.1/r502-01/wwhelp/wwhimpl/js/html/wwhelp.htm?context=r502-01&file=ch5r502-01bi.html</a></p> <h2 id="RFCs"><a class="permalink" href="#RFCs">#</a>RFCs</h2> <p><i>RFC 3164 - The BSD syslog Protocol</i>, <a href="http://www.faqs.org/rfcs/rfc3164.html">http://www.faqs.org/rfcs/rfc3164.html</a> -- Please note that this is an informational RFC, and therefore does not specify a standard of any kind.</p> <p><i>RFC 3195 - Reliable Delivery for syslog</i>, <a href="http://www.faqs.org/rfcs/rfc3195.html">http://www.faqs.org/rfcs/rfc3195.html</a></p> <h2 id="Articles"><a class="permalink" href="#Articles">#</a>Articles</h2> <p><i>Syslogging with Perl</i>, <a href="http://lexington.pm.org/meetings/022001.html">http://lexington.pm.org/meetings/022001.html</a></p> <h2 id="Event-Log"><a class="permalink" href="#Event-Log">#</a><a id="Event"></a>Event Log</h2> <p>Windows Event Log, <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wes/wes/windows_event_log.asp">http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wes/wes/windows_event_log.asp</a></p> <h1 id="AUTHORS-&-ACKNOWLEDGEMENTS"><a class="permalink" href="#AUTHORS-&-ACKNOWLEDGEMENTS">#</a><a id="AUTHORS"></a><a id="AUTHORS-ACKNOWLEDGEMENTS"></a>AUTHORS & ACKNOWLEDGEMENTS</h1> <p>Tom Christiansen <<i>tchrist (at) perl.com</i>> and Larry Wall <<i>larry (at) wall.org</i>>.</p> <p>UNIX domain sockets added by Sean Robinson <<i>robinson_s (at) sc.maricopa.edu</i>> with support from Tim Bunce <<i>Tim.Bunce (at) ig.co.uk</i>> and the <code>perl5-porters</code> mailing list.</p> <p>Dependency on <i>syslog.ph</i> replaced with XS code by Tom Hughes <<i>tom (at) compton.nu</i>>.</p> <p>Code for <code>constant()</code>s regenerated by Nicholas Clark <<i>nick (at) ccl4.org</i>>.</p> <p>Failover to different communication modes by Nick Williams <<i>Nick.Williams (at) morganstanley.com</i>>.</p> <p>Extracted from core distribution for publishing on the CPAN by S茅bastien Aperghis-Tramoni <sebastien (at) aperghis.net>.</p> <p>XS code for using native C functions borrowed from <code><a href="/5.39.7/Unix::Syslog">Unix::Syslog</a></code>, written by Marcus Harnisch <<i>marcus.harnisch (at) gmx.net</i>>.</p> <p>Yves Orton suggested and helped for making <code>Sys::Syslog</code> use the native event logger under Win32 systems.</p> <p>Jerry D. Hedden and Reini Urban provided greatly appreciated help to debug and polish <code>Sys::Syslog</code> under Cygwin.</p> <h1 id="BUGS"><a class="permalink" href="#BUGS">#</a>BUGS</h1> <p>Please report any bugs or feature requests to <code>bug-sys-syslog (at) rt.cpan.org</code>, or through the web interface at <a href="http://rt.cpan.org/Public/Dist/Display.html?Name=Sys-Syslog">http://rt.cpan.org/Public/Dist/Display.html?Name=Sys-Syslog</a>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.</p> <h1 id="SUPPORT"><a class="permalink" href="#SUPPORT">#</a>SUPPORT</h1> <p>You can find documentation for this module with the perldoc command.</p> <pre><code class="plaintext">perldoc Sys::Syslog</code></pre> <p>You can also look for information at:</p> <ul> <li><p>Perl Documentation</p> <p><a href="http://perldoc.perl.org/Sys/Syslog.html">http://perldoc.perl.org/Sys/Syslog.html</a></p> </li> <li><p>MetaCPAN</p> <p><a href="https://metacpan.org/module/Sys::Syslog">https://metacpan.org/module/Sys::Syslog</a></p> </li> <li><p>Search CPAN</p> <p><a href="http://search.cpan.org/dist/Sys-Syslog/">http://search.cpan.org/dist/Sys-Syslog/</a></p> </li> <li><p>AnnoCPAN: Annotated CPAN documentation</p> <p><a href="http://annocpan.org/dist/Sys-Syslog">http://annocpan.org/dist/Sys-Syslog</a></p> </li> <li><p>CPAN Ratings</p> <p><a href="http://cpanratings.perl.org/d/Sys-Syslog">http://cpanratings.perl.org/d/Sys-Syslog</a></p> </li> <li><p>RT: CPAN's request tracker</p> <p><a href="http://rt.cpan.org/Dist/Display.html?Queue=Sys-Syslog">http://rt.cpan.org/Dist/Display.html?Queue=Sys-Syslog</a></p> </li> </ul> <p>The source code is available on Git Hub: <a href="https://github.com/maddingue/Sys-Syslog/">https://github.com/maddingue/Sys-Syslog/</a></p> <h1 id="COPYRIGHT"><a class="permalink" href="#COPYRIGHT">#</a>COPYRIGHT</h1> <p>Copyright (C) 1990-2012 by Larry Wall and others.</p> <h1 id="LICENSE"><a class="permalink" href="#LICENSE">#</a>LICENSE</h1> <p>This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.</p> </div> <div id="footer"> <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p> <p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p> </div> </div> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script> <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script> <script src="/js/highlight.pack.js"></script> <script>hljs.highlightAll();</script> </body> </html>

CINXE.COM

Sys::Syslog - Perl interface to the UNIX syslog(3) calls - Perldoc Browser