1 /* Declarations for temporary file handling.
2 Copyright (C) 2016-2023 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <https://www.gnu.org/licenses/>. */
19 #ifndef SUPPORT_TEMP_FILE_H
20 #define SUPPORT_TEMP_FILE_H
22 #include <sys/cdefs.h>
26 /* Schedule a temporary file for deletion on exit. */
27 void add_temp_file (const char *name);
29 /* Create a temporary file. Return the opened file descriptor on
30 success, or -1 on failure. Write the file name to *FILENAME if
31 FILENAME is not NULL. In this case, the caller is expected to free
33 int create_temp_file (const char *base, char **filename);
35 /* Create a temporary file in directory DIR. Return the opened file
36 descriptor on success, or -1 on failure. Write the file name to
37 *FILENAME if FILENAME is not NULL. In this case, the caller is
38 expected to free *FILENAME. */
39 int create_temp_file_in_dir (const char *base, const char *dir,
42 /* Create a temporary directory and schedule it for deletion. BASE is
43 used as a prefix for the unique directory name, which the function
44 returns. The caller should free this string. */
45 char *support_create_temp_directory (const char *base);
47 /* Create a temporary directory tree that is longer than PATH_MAX and schedule
48 it for deletion. BASENAME is used as a prefix for the unique directory
49 name, which the function returns. The caller should free this string. */
50 char *support_create_and_chdir_toolong_temp_directory (const char *basename);
52 /* Change into the innermost directory of the directory tree BASE, which was
53 created using support_create_and_chdir_toolong_temp_directory. */
54 void support_chdir_toolong_temp_directory (const char *base);
58 #endif /* SUPPORT_TEMP_FILE_H */