New module 'tmpdir'.
[gnulib.git] / lib / tmpdir.h
1 /* Determine a temporary directory.
2    Copyright (C) 2001-2002 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program; if not, write to the Free Software Foundation,
16    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
17
18 #include <stdbool.h>
19 #include <stddef.h>
20
21 /* Path search algorithm, for tmpnam, tmpfile, etc.  If DIR is
22    non-null and exists, uses it; otherwise uses the first of $TMPDIR,
23    P_tmpdir, /tmp that exists.  Copies into TMPL a template suitable
24    for use with mk[s]temp.  Will fail (-1) if DIR is non-null and
25    doesn't exist, none of the searched dirs exists, or there's not
26    enough space in TMPL. */
27 extern int path_search (char *tmpl, size_t tmpl_len, const char *dir, const char *pfx, bool try_tmpdir);