34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz/***********************************************************************
34f9b3eef6fdadbda0a846aa4d68691ac40eace5Roland Mainz* This software is part of the ast package *
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner* Copyright (c) 1992-2010 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***********************************************************************/
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner"[-?\n@(#)$Id: mktemp (AT&T Research) 2010-03-05 $\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.]"
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner "[+*?Default pseudo-random part (no specific \bX...\b template) "
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner "formatted to accomodate 8.3 filesystems.]"
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner"[+?A consecutive trailing sequence of \bX\b's in \aprefix\a is replaced "
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner "by the pseudo-random part. If there are no \bX\b's then the "
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner "pseudo-random part 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.]"
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner"[R:regress?The pseudo random generator is seeded with \aseed\a instead "
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner "of process/system specific transient data. Use for testing "
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner "only. A seed of \b0\b is silently changed to \b1\b.]#[seed]"
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. "
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner "Use this for testing only.]"
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);
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner if (!pathtemp(NiL, 0, opt_info.arg, "/seed", NiL))
3e14f97f673e8a630f076077de35afdd43dc1587Roger A. Faulkner error(2, "%s: regression test initializtion failed", opt_info.arg);
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");