NAME
    Log::Any::Adapter::Syslog - Send Log::Any logs to syslog

VERSION
    version 1.4

SYNOPSIS
        use Log::Any::Adapter;
        Log::Any::Adapter->set('Syslog');

        # You can override defaults:
        use Unix::Syslog qw{:macros};
        Log::Any::Adapter->set(
            'Syslog',
            # name defaults to basename($0)
            name     => 'my-name',
            # options default to LOG_PID
            options  => LOG_PID|LOG_PERROR,
            # facility defaults to LOG_LOCAL7
            facility => LOG_LOCAL7
        );

DESCRIPTION
    Log::Any is a generic adapter for writing logging into Perl modules;
    this adapter use the Unix::Syslog module to direct that output into the
    standard Unix syslog system.

CONFIGURATION
    "Log::Any::Adapter::Syslog" is designed to work out of the box with no
    configuration required; the defaults should be reasonably sensible.

    You can override the default configuration by passing extra arguments to
    the "Log::Any::Adapter" method:

    name
        The *name* argument defaults to the basename of $0 if not supplied,
        and is inserted into each line sent to syslog to identify the
        source.

    options
        The *options* configure the behaviour of syslog; see Unix::Syslog
        for details.

        The default is "LOG_PID", which includes the PID of the current
        process after the process name:

            example-process[2345]: something amazing!

        The most likely addition to that is "LOG_PERROR" which causes syslog
        to also send a copy of all log messages to the controlling terminal
        of the process.

        WARNING: If you pass a defined value you are setting, not
        augmenting, the options. So, if you want "LOG_PID" as well as other
        flags, pass them all.

    facility
        The *facility* determines where syslog sends your messages. The
        default is "LOCAL7", which is not the most useful value ever, but is
        less bad than assuming the fixed facilities.

        See Unix::Syslog and syslog(3) for details on the available
        facilities.

AUTHORS
    *   Daniel Pittman <daniel@rimspace.net>

    *   Stephen Thirlwall <sdt@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2013 by Stephen Thirlwall.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

