File::Util::Tempdir - Cross-platform way to get system-wide & user private temporary directory
This document describes version 0.034 of File::Util::Tempdir (from Perl distribution File-Util-Tempdir), released on 2018-09-22.
use File::Util::Tempdir qw(get_tempdir get_user_tempdir); my $tmpdir = get_tempdir(); # => e.g. "/tmp" my $mytmpdir = get_user_tempdir(); # => e.g. "/run/user/1000", or "/tmp/1000"
None are exported by default, but they are exportable.
Usage:
my $dir = get_tempdir();
A cross-platform way to get system-wide temporary directory.
On Windows: it first looks for one of these environment variables in this order and return the first value that is set: TMP, TEMP, TMPDIR, TEMPDIR. If none are set, will look at these directories in this order and return the first value that is set: C:\TMP, C:\TEMP. If none are set, will die.
TMP
TEMP
TMPDIR
TEMPDIR
C:\TMP
C:\TEMP
On Unix: it first looks for one of these environment variables in this order and return the first value that is set: TMPDIR, TEMPDIR, TMP, TEMP. If none are set, will look at these directories in this order and return the first value that is set: /tmp, /var/tmp. If none are set, will die.
/tmp
/var/tmp
my $dir = get_user_tempdir();
Get user's private temporary directory.
When you use world-writable temporary directory like /tmp, you usually need to create randomly named temporary files, such as those created by File::Temp. If you try to create a temporary file with guessable name, other users can intercept this and you can either: 1) fail to create/write your temporary file; 2) be tricked to read malicious data; 3) be tricked to write to other location (e.g. via symlink).
This routine is like "get_tempdir" except: on Unix, it will look for XDG_RUNTIME_DIR first (which on a Linux system with systemd will have value like /run/user/1000 which points to a RAM-based tmpfs). Also, get_user_tempdir will first check that the temporary directory is: 1) owned by the running user; 2) not group- and world-writable. If not, it will create a subdirectory named $EUID ($>) with permission mode 0700 and return that. If that subdirectory already exists and is not owned by the user or is group-/world-writable, will try $EUID.1 and so on.
XDG_RUNTIME_DIR
/run/user/1000
get_user_tempdir
$EUID
$>
$EUID.1
It will die on failure.
Please visit the project's homepage at https://metacpan.org/release/File-Util-Tempdir.
Source repository is at https://github.com/perlancar/perl-File-Util-Tempdir.
Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=File-Util-Tempdir
When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.
File::Spec has tmpdir function. It also tries to look at environment variables, e.g. on Unix it will look at TMPDIR (but not TEMPDIR) and then falls back to /tmp (but not /var/tmp).
tmpdir
File::HomeDir, a cross-platform way to get user's home directory and a few other related directories.
File::Temp to create a temporary directory.
https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html for the specification of XDG_RUNTIME_DIR.
perlancar <perlancar@cpan.org>
This software is copyright (c) 2018, 2016 by perlancar@cpan.org.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install File::Util::Tempdir, copy and paste the appropriate command in to your terminal.
cpanm
cpanm File::Util::Tempdir
CPAN shell
perl -MCPAN -e shell install File::Util::Tempdir
For more information on module installation, please visit the detailed CPAN module installation guide.