---
name: "Log::Dispatch::File::Locked"
section: "3pm"
platform: "linux"
package: "liblog-dispatch-perl"
version: "2.71-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Log::Dispatch::File::Locked"
---

# Log::Dispatch::File::Locked(3pm)

Subclass of Log::Dispatch::File to facilitate locking

## NAME

Log::Dispatch::File::Locked - Subclass of Log::Dispatch::File to facilitate locking

## VERSION

version 2.71

## SYNOPSIS

```
  use Log::Dispatch;
  my $log = Log::Dispatch->new(
      outputs => [
          [
              'File::Locked',
              min_level => 'info',
              filename  => 'Somefile.log',
              mode      => '>>',
              newline   => 1
          ]
      ],
  );
  $log->emerg("I've fallen and I can't get up");
```

## DESCRIPTION

This module acts exactly like Log::Dispatch::File except that it obtains an exclusive lock on the file while opening it.

Note that if you are using this output because you want to write to a file from multiple processes, you should open the file with the append `"mode"` (`">>"`), or else it's quite likely that one process will overwrite another.

## SEE ALSO

"flock" in perlfunc

## SUPPORT

Bugs may be submitted at \<https://github.com/houseabsolute/Log-Dispatch/issues\>.

## SOURCE

The source code repository for Log-Dispatch can be found at \<https://github.com/houseabsolute/Log-Dispatch\>.

## AUTHOR

Dave Rolsky \<autarch@urth.org\>

## COPYRIGHT AND LICENSE

This software is Copyright (c) 2023 by Dave Rolsky.

This is free software, licensed under:

```
  The Artistic License 2.0 (GPL Compatible)
```

The full text of the license can be found in the *LICENSE* file included with this distribution.