man Config::Find::Unix (3): 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})

AUTHOR

Salvador Fandin~o Garcia, <[email protected]>

CONTRIBUTORS

Barbie, <[email protected]> (some bug fixes and documentation)

COPYRIGHT AND LICENSE