---
name: "Log::Agent::Driver::Mail"
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::Mail"
---

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

email driver for Log::Agent

## NAME

Log::Agent::Driver::Mail - email driver for Log::Agent

## SYNOPSIS

```
 use Log::Agent;
 require Log::Agent::Driver::Mail;
 my $driver = Log::Agent::Driver::Mail->make(
     -to      => 'oncall@example.org',
     -cc      => [ qw( noc@example.org admin@example,net ) ],
     -subject => "ALERT! ALERT!",
     -mailer  => [ 'smtp', Server => 'mail.example.net' ]
 );
 logconfig(-driver => $driver);
```

## DESCRIPTION

This driver maps the **logxxx()** calls to email messages.  Each call generates a separate email message.  The Mail::Mailer module is required.

## CONSTRUCTOR

### make OPTIONS

The OPTIONS argument is a hash with the following keys:

- **-prefix**

  An optional prefix for the message body.

- **-to**

  The destination addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

- **-reply\_to**

  The reply-to addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

- **-from**

  The source address, must be a scalar containing a valid email address.

- **-subject**

  The subject line of the email message.

- **-cc**

  The carbon copy addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

- **-bcc**

  The blind carbon copy addresses, may be a scalar containing a valid email address or a reference to an array of addresses.

- **-priority**

  The priority level for the email message.  This is NOT related to the logging priority.

- **-mailer**

  A reference to an array containing the optional arguments to Mail::Mailer-\>**new()**.  Generally, this can be omitted.

## NOTES

Thanks to Shirley Wang for the idea for this module.

## AUTHOR

Mark Rogaski \<mrogaski@pobox.com\>

## LICENSE

Copyright (C) 2002 Mark Rogaski; all rights reserved.

See **Log::Agent**(3) or the README file included with the distribution for license information.

## SEE ALSO

Mail::Mailer, **Log::Agent::Driver**(3), **Log::Agent**(3).