mktemp.c revision 34f9b3eef6fdadbda0a846aa4d68691ac40eace5
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz/***********************************************************************
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* This software is part of the ast package *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* Copyright (c) 1992-2009 AT&T Intellectual Property *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* and is licensed under the *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* Common Public License, Version 1.0 *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* by AT&T Intellectual Property *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* A copy of the License is available at *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* http://www.opensource.org/licenses/cpl1.0.txt *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* (with md5 checksum 059e8cd6165cb4c31e351f2b69388fd9) *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* Information and Software Systems Research *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* AT&T Research *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* Florham Park NJ *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* Glenn Fowler <gsf@research.att.com> *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* David Korn <dgk@research.att.com> *
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz***********************************************************************/
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainzstatic const char usage[] =
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[-?\n@(#)$Id: mktemp (AT&T Research) 2009-06-19 $\n]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[+NAME?mktemp - make temporary file or directory]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[+DESCRIPTION?\bmktemp\b creates a temporary file with optional base "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "name prefix \aprefix\a. If \aprefix\a is omitted then \btmp_\b is used "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "and \b--tmp\b is implied. If \aprefix\a contains a directory prefix "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "then that directory overrides any of the directories described below. A "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "temporary file will have mode \brw-------\b and a temporary directory "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "will have mode \brwx------\b, subject to \bumask\b(1). Generated paths "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "have these attributes:]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "[+*?Lower case to avoid clashes on case ignorant filesystems.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "[+*?Pseudo-random part to deter denial of service attacks.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "[+*?Pseudo-random part is \a3-chars\a.\a3-chars\a to accomodate "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "8.3 filesystems.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[+?A consecutive sequence of \bX\b's in \aprefix\a is replaced by the "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "pseudo-random part. If there are no \bX\b's then the pseudo-random part "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "is appended to the prefix.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[d:directory?Create a directory instead of a regular file.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[m:mode]:[mode?Set the mode of the created temporary to \amode\a. "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "\amode\a is symbolic or octal mode as in \bchmod\b(1). Relative modes "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "assume an initial mode of \bu=rwx\b.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[p:default?Use \adirectory\a if the \bTMPDIR\b environment variable is "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "not defined. Implies \b--tmp\b.]:[directory]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[q:quiet?Suppress file and directory error diagnostics.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[t:tmp|temporary-directory?Create a path rooted in a temporary "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "directory.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[u:unsafe|dry-run?Check for file/directory existence but do not create. "
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz "Who would want to do that.]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"\n[ prefix ]\n"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz"[+SEE ALSO?\bmkdir\b(1), \bpathtemp\b(3), \bmktemp\b(3)]"
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz cmdinit(argc, argv, context, ERROR_CATALOG, ERROR_NOTIFY);
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz mode = strperm(pfx = opt_info.arg, &opt_info.arg, S_IRWXU);
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz if (error_info.errors || (pfx = *argv++) && *argv)
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz mode = (fdp ? (S_IRUSR|S_IWUSR) : S_IRWXU) & ~mask;
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz if (!pathtemp(path, sizeof(path), dir, pfx, fdp))
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz error(ERROR_SYSTEM|2, "cannot create temporary path");