Man pages sections > man3 > Config::Find::Unix

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

Config::Find::Unix(3pm) User Contributed Perl Documentation Config::Find::Unix(3pm)

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 Fandin~o Garcia, <sfandino@yahoo.com>

CONTRIBUTORS

Barbie, <barbie@missbarbell.co.uk> (some bug fixes and documentation) Copyright 2003-2015 by Salvador Fandin~o Garcia (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.
2015-05-26 perl v5.20.2