tmp.h File Reference

Create Temporary Files. More...

#include <stdio.h>

Include dependency graph for tmp.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	buf_mktemp(buf)
#define	buf_mktemp_draft(buf)
#define	mutt_file_mkstemp()

Functions
void	buf_mktemp_full (struct Buffer *buf, const char *prefix, const char *suffix, const char *src, int line, const char *cfg)
	Create a temporary file.
FILE *	mutt_file_mkstemp_full (const char *file, int line, const char *func)
	Create temporary file safely.

Detailed Description

Create Temporary Files.

Authors

• Richard Russon

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file tmp.h.

Macro Definition Documentation

buf_mktemp

#define buf_mktemp

(

buf

)

Value:

buf_mktemp_full(buf, "neomutt", NULL, __FILE__, __LINE__, "tmp_dir")

Definition at line 33 of file tmp.h.

buf_mktemp_draft

#define buf_mktemp_draft

(

buf

)

Value:

buf_mktemp_full(buf, "neomutt", NULL, __FILE__, __LINE__, "tmp_draft_dir")

Definition at line 34 of file tmp.h.

mutt_file_mkstemp

#define mutt_file_mkstemp

(

)

Value:

mutt_file_mkstemp_full(__FILE__, __LINE__, __func__)

Definition at line 36 of file tmp.h.

Function Documentation

buf_mktemp_full()

void buf_mktemp_full	(	struct Buffer *	buf,
		const char *	prefix,
		const char *	suffix,
		const char *	src,
		int	line,
		const char *	cfg )

Create a temporary file.

Parameters

buf	Buffer for result
prefix	Prefix for filename
suffix	Suffix for filename
src	Source file of caller
line	Source line number of caller
cfg	Config option for the temp directory

Definition at line 52 of file tmp.c.

{
  const char *const c_tmp_dir = cs_subset_path(NeoMutt->sub, cfg);
  buf_printf(buf, "%s/%s-%s-%d-%d-%" PRIu64 "%s%s", NONULL(c_tmp_dir),
             NONULL(prefix), NONULL(ShortHostname), (int) getuid(),
             (int) getpid(), mutt_rand64(), suffix ? "." : "", NONULL(suffix));
 
  mutt_debug(LL_DEBUG3, "%s:%d: buf_mktemp returns \"%s\"\n", src, line, buf_string(buf));
  if (unlink(buf_string(buf)) && (errno != ENOENT))
  {
    mutt_debug(LL_DEBUG1, "%s:%d: ERROR: unlink(\"%s\"): %s (errno %d)\n", src,
               line, buf_string(buf), strerror(errno), errno);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_file_mkstemp_full()

FILE * mutt_file_mkstemp_full	(	const char *	file,
		int	line,
		const char *	func )

Create temporary file safely.

Parameters

file	Source file of caller
line	Source line number of caller
func	Function name of caller

Return values

ptr	FILE handle
NULL	Error, see errno

Create and immediately unlink a temp file using mkstemp().

Definition at line 78 of file tmp.c.

{
  char name[PATH_MAX] = { 0 };
 
  const char *const c_tmp_dir = cs_subset_path(NeoMutt->sub, "tmp_dir");
  int n = snprintf(name, sizeof(name), "%s/neomutt-XXXXXX", NONULL(c_tmp_dir));
  if ((n < 0) || ((size_t) n >= sizeof(name)))
    return NULL;
 
  int fd = mkstemp(name);
  if (fd == -1)
    return NULL;
 
  FILE *fp = fdopen(fd, "w+");
  if (!fp)
  {
    close(fd);
    return NULL;
  }
 
  if ((unlink(name) != 0) && (errno != ENOENT))
  {
    mutt_file_fclose(&fp);
    return NULL;
  }
 
  MuttLogger(0, file, line, func, 1, "created temp file '%s'\n", name);
  return fp;
}

Here is the call graph for this function: