---
name: "Config::Find::Unix"
section: "3pm"
platform: "linux"
package: "libconfig-find-perl"
version: "0.31-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Config::Find::Unix"
---

# Config::Find::Unix(3pm)

Config::Find plugin for Unixen

## NAME

Config::Find::Unix - Config::Find plugin for Unixen

## SYNOPSIS

```
  # don't use Config::Find::Unix directly
  use Config::Find;
```

## ABSTRACT

Config::Find plugin for Unixen

## DESCRIPTION

This module implements Config::Find for Unix

The order for searching the config files is:

```
  1  ~/.$name                             [user]
  1b ~/.$name.conf                        [user]
  2  /$path_to_script/../etc/$name.conf   [global]
  3  /$path_to_script/../conf/$name.conf  [global]
  4  /etc/$name.conf                      [global]
```

although if the environment variable `$ENV{${name}_HOME}` is defined it does

```
  1  ~/.$name                             [user]
  1b ~/.$name.conf                        [user]
  2  $ENV{${name}_HOME}/etc/$name.conf    [global]
  3  $ENV{${name}_HOME}/conf/$name.conf   [global]
  4  /etc/$name.conf                      [global]
```

instead.

When the "several configuration files in one directory" approach is used, the order is somewhat different:

```
  1  ~/.$dir/$name.conf                        [user]
  2  /$path_to_script/../etc/$dir/$name.conf   [global]
  3  /$path_to_script/../conf/$dir/$name.conf  [global]
  4  /etc/$dir/$name.conf                      [global]
```

(also affected by `$ENV{${name}_HOME}`)

## SEE ALSO

Config::Find, Config::Find::Any.

## AUTHOR

Salvador Fandiño García, \<sfandino@yahoo.com\>

## CONTRIBUTORS

Barbie, \<barbie@missbarbell.co.uk\> (some bug fixes and documentation)

## COPYRIGHT AND LICENSE

Copyright 2003-2015 by Salvador Fandiño García (sfandino@yahoo.com) Copyright 2015 by Barbie (barbie@missbarbell.co.uk)

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