/ 
perl-5.40.2
River stage five • 12504 direct dependents • 35161 total dependents
⭐ Starred 2013 GitHub stars
/ File::Spec::Functions
Security Advisories (1)
CVE-2025-40909 (2025-05-30)

Perl threads have a working directory race condition where file operations may target unintended paths. If a directory handle is open at thread creation, the process-wide current working directory is temporarily changed in order to clone that handle for the new thread, which is visible from any third (or more) thread already running. This may lead to unintended operations such as loading code or accessing files from unexpected locations, which a local attacker may be able to exploit. The bug was introduced in commit 11a11ecf4bea72b17d250cfb43c897be1341861e and released in Perl version 5.13.6

NAME

File::Spec::Functions - portably perform operations on file names

SYNOPSIS

use File::Spec::Functions;
my $x = catfile('a', 'b');

DESCRIPTION

This module exports convenience functions for all of the class methods provided by File::Spec.

For a reference of available functions, please consult File::Spec::Unix, which contains the entire set, and which is inherited by the modules for other platforms. For further information, please see File::Spec::Mac, File::Spec::OS2, File::Spec::Win32, or File::Spec::VMS.

Exports

The following functions are exported by default.

canonpath
catdir
catfile
curdir
rootdir
updir
no_upwards
file_name_is_absolute
path

The following functions are exported only by request.

devnull
tmpdir
splitpath
splitdir
catpath
abs2rel
rel2abs
case_tolerant

All the functions may be imported using the :ALL tag.

COPYRIGHT

Copyright (c) 2004 by the Perl 5 Porters. All rights reserved.

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

SEE ALSO

File::Spec, File::Spec::Unix, File::Spec::Mac, File::Spec::OS2, File::Spec::Win32, File::Spec::VMS, ExtUtils::MakeMaker