---
name: "Log::Agent::Driver::Syslog"
section: "3pm"
platform: "linux"
package: "liblog-agent-perl"
version: "1.005-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Log::Agent::Driver::Syslog"
---

# Log::Agent::Driver::Syslog(3pm)

syslog logging driver for Log::Agent

## NAME

Log::Agent::Driver::Syslog - syslog logging driver for Log::Agent

## SYNOPSIS

```
 use Log::Agent;
 require Log::Agent::Driver::Syslog;
 my $driver = Log::Agent::Driver::Syslog->make(
     -prefix     => prefix,
     -facility   => "user",
     -showpid    => 1,
     -socktype   => { port => 514, proto => "udp" },
     -logopt     => "ndelay",
 );
 logconfig(-driver => $driver);
```

## DESCRIPTION

The syslog logging driver delegates **logxxx()** operations to **syslog()** via the **Sys::Syslog**(3) interface.

The creation routine **make()** takes the following switches:

- "-facility" =\> *facility*

  Tell **syslog()** which facility to use (e.g. "user", "auth", "daemon"). Unlike the **Sys::Syslog**(3) interface, the facility is set once and for all: every logging message will use the same facility.

  If you wish to log something to "auth" for instance, then do so via Sys::Syslog directly: there is no guarantee that the application will configure its Log::Agent to use syslog anyway!

- "-logopt" =\> *syslog options*

  Specifies logging options, under the form of a string containing zero or more of the words *ndelay*, *cons* or *nowait*.

- "-prefix" =\> *prefix*

  The *prefix* here is syslog's identification string.

- "-showpid" =\> *flag*

  Set to true to have the PID of the process logged. It is false by default.

- "-socktype" =\> *options*

  Specifies the logging socket to use (protocol, destination, etc.). The value given is not interpreted and passed as-is to the `"setlogsock()"` routine in **Sys::Syslog**(3).

  Please refer to **Log::Agent::Channel::Syslog**(3) for more information.

## CHANNELS

All the channels go to **syslog()**, of course.

## AUTHOR

Raphael Manfredi *\<Raphael\_Manfredi@pobox.com\>*

## SEE ALSO

**Log::Agent::Driver**(3), **Log::Agent::Channel::Syslog**(3), **Sys::Syslog**(3).