| Dir : /opt/puppetlabs/puppet/lib/ruby/vendor_ruby/puppet/parser/functions/ |
| Server: Linux server1.ngambekcore.com 4.18.0-553.51.1.el8_10.x86_64 #1 SMP Wed Apr 30 04:00:07 EDT 2025 x86_64 IP: 159.198.77.92 |
| Dir : //opt/puppetlabs/puppet/lib/ruby/vendor_ruby/puppet/parser/functions/find_file.rb |
Puppet::Parser::Functions::newfunction(
:find_file,
:type => :rvalue,
:arity => -2,
:doc => <<-DOC
Finds an existing file from a module and returns its path.
The argument to this function should be a String as a `<MODULE NAME>/<FILE>`
reference, which will search for `<FILE>` relative to a module's `files`
directory. (For example, the reference `mysql/mysqltuner.pl` will search for the
file `<MODULES DIRECTORY>/mysql/files/mysqltuner.pl`.)
This function can also accept:
* An absolute String path, which will check for the existence of a file from anywhere on disk.
* Multiple String arguments, which will return the path of the **first** file
found, skipping non existing files.
* An array of string paths, which will return the path of the **first** file
found from the given paths in the array, skipping non existing files.
The function returns `undef` if none of the given paths were found
- since 4.8.0
DOC
) do |args|
Puppet::Parser::Functions::Error.is4x('find_file')
end