1 /* Declarations for temporary file handling. 2 Copyright (C) 2016-2022 Free Software Foundation, Inc. 3 This file is part of the GNU C Library. 4 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. 9 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. 14 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/>. */ 18 19 #ifndef SUPPORT_TEMP_FILE_H 20 #define SUPPORT_TEMP_FILE_H 21 22 #include <sys/cdefs.h> 23 24 __BEGIN_DECLS 25 26 /* Schedule a temporary file for deletion on exit. */ 27 void add_temp_file (const char *name); 28 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 32 *FILENAME. */ 33 int create_temp_file (const char *base, char **filename); 34 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, 40 char **filename); 41 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); 46 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); 51 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); 55 56 __END_DECLS 57 58 #endif /* SUPPORT_TEMP_FILE_H */ 59