NAME File::Util::Tempdir - Cross-platform way to get system-wide & user private temporary directory VERSION This document describes version 0.034 of File::Util::Tempdir (from Perl distribution File-Util-Tempdir), released on 2018-09-22. SYNOPSIS 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" DESCRIPTION FUNCTIONS None are exported by default, but they are exportable. get_tempdir 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. 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. get_user_tempdir Usage: 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. It will die on failure. HOMEPAGE Please visit the project's homepage at . SOURCE Source repository is at . BUGS Please report any bugs or feature requests on the bugtracker website 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. SEE ALSO 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"). 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. for the specification of "XDG_RUNTIME_DIR". AUTHOR perlancar COPYRIGHT AND LICENSE 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.