X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=sbr%2Fm_mktemp.c;h=9b9652bbab4209fd68f324dc6f71484d12a5e4c4;hp=6f2089ba4509495a789920a850de12c596852c77;hb=ced6090a330d3d83d0bce709f756aa3d7d65fea4;hpb=337338b404931f06f0db2119c9e145e8ca5a9860 diff --git a/sbr/m_mktemp.c b/sbr/m_mktemp.c index 6f2089b..9b9652b 100644 --- a/sbr/m_mktemp.c +++ b/sbr/m_mktemp.c @@ -1,10 +1,10 @@ /* - * m_mktemp.c -- Construct a temporary file. - * - * This code is Copyright (c) 2010, by the authors of nmh. See the - * COPYRIGHT file in the root directory of the nmh distribution for - * complete copyright information. - */ +** m_mktemp.c -- Construct a temporary file. +** +** This code is Copyright (c) 2010, by the authors of nmh. See the +** COPYRIGHT file in the root directory of the nmh distribution for +** complete copyright information. +*/ #include #include @@ -12,39 +12,39 @@ static char *get_temp_dir(); /* Create a temporary file. If pfx_in is null, the temporary file - * will be created in the temporary directory (more on that later). - * If pfx_in is not null, then the temporary file location will be - * defined by the value pfx_in. - * - * The file created will be at the pathname specified appended with - * 6 random (we hope :) characters. - * - * The return value will be the pathname to the file created. - * - * CAUTION: The return pointer references static data. If - * you need to modify, or save, the return string, make a copy of it - * first. - * - * When pfx_in is null, the temporary directory is determined as - * follows, in order: - * - * MHTMPDIR envvar - * TMPDIR envvar - * TMP envvar - * User's mail directory. - * - * NOTE: One will probably use m_mktemp2() instead of this function. - * For example, if you want to create a temp file in the defined - * temporary directory, but with a custom basename prefix, do - * something like the following: - * - * char *tmp_pathname = m_mktemp2(NULL, "mypre", ...); - */ +** will be created in the temporary directory (more on that later). +** If pfx_in is not null, then the temporary file location will be +** defined by the value pfx_in. +** +** The file created will be at the pathname specified appended with +** 6 random (we hope :) characters. +** +** The return value will be the pathname to the file created. +** +** CAUTION: The return pointer references static data. If +** you need to modify, or save, the return string, make a copy of it +** first. +** +** When pfx_in is null, the temporary directory is determined as +** follows, in order: +** +** MHTMPDIR envvar +** TMPDIR envvar +** TMP envvar +** User's mail directory. +** +** NOTE: One will probably use m_mktemp2() instead of this function. +** For example, if you want to create a temp file in the defined +** temporary directory, but with a custom basename prefix, do +** something like the following: +** +** char *tmp_pathname = m_mktemp2(NULL, "mypre", ...); +*/ char * m_mktemp ( const char *pfx_in, /* Pathname prefix for temporary file. */ - int *fd_ret, /* (return,optional) File descriptor to temp file. */ - FILE **fp_ret /* (return,optional) FILE pointer to temp file. */ + int *fd_ret, /* (return,opt.) File descriptor to temp file. */ + FILE **fp_ret /* (return,opt.) FILE pointer to temp file. */ ) { static char tmpfil[BUFSIZ]; @@ -53,7 +53,8 @@ m_mktemp ( mode_t oldmode = umask(077); if (pfx_in == NULL) { - snprintf(tmpfil, sizeof(tmpfil), "%s/nmhXXXXXX", get_temp_dir()); + snprintf(tmpfil, sizeof(tmpfil), "%s/nmhXXXXXX", + get_temp_dir()); } else { snprintf(tmpfil, sizeof(tmpfil), "%sXXXXXX", pfx_in); } @@ -87,22 +88,23 @@ m_mktemp ( return tmpfil; } -/* This version allows one to specify the directory the temp file should - * by created based on a given pathname. Although m_mktemp() technically - * supports this, this version is when the directory is defined by - * a separate variable from the prefix, eliminating the caller from having - * to do string manipulation to generate the desired. pathname prefix. - * - * The pfx_in parameter specifies a basename prefix for the file. If dir_in - * is NULL, then the defined temporary directory (see comments to m_mktemp() - * above) is used to create the temp file. - */ +/* +** This version allows one to specify the directory the temp file should +** by created based on a given pathname. Although m_mktemp() technically +** supports this, this version is when the directory is defined by +** a separate variable from the prefix, eliminating the caller from having +** to do string manipulation to generate the desired. pathname prefix. +** +** The pfx_in parameter specifies a basename prefix for the file. If dir_in +** is NULL, then the defined temporary directory (see comments to m_mktemp() +** above) is used to create the temp file. +*/ char * m_mktemp2 ( const char *dir_in, /* Directory to place temp file. */ const char *pfx_in, /* Basename prefix for temp file. */ - int *fd_ret, /* (return,optional) File descriptor to temp file. */ - FILE **fp_ret /* (return,optional) FILE pointer to temp file. */ + int *fd_ret, /* (return,opt.) File descriptor to temp file. */ + FILE **fp_ret /* (return,opt.) FILE pointer to temp file. */ ) { static char buffer[BUFSIZ]; @@ -130,7 +132,7 @@ m_mktemp2 ( static char * get_temp_dir() { - // Ignore envvars if we are setuid + /* Ignore envvars if we are setuid */ if ((getuid()==geteuid()) && (getgid()==getegid())) { char *tmpdir = NULL; tmpdir = getenv("MHTMPDIR");