1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210
|
/*
* Copyright (c) 1987 Regents of the University of California.
* All rights reserved.
*
* Redistribution and use in source and binary forms are permitted
* provided that: (1) source distributions retain this entire copyright
* notice and comment, and (2) distributions including binaries display
* the following acknowledgement: ``This product includes software
* developed by the University of California, Berkeley and its contributors''
* in the documentation or other materials provided with the distribution.
* Neither the name of the University nor the names of its
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*/
/* This is file MKTEMP.C */
/* This file may have been modified by DJ Delorie (Jan 1991). If so,
** these modifications are Copyright (C) 1991 DJ Delorie.
*/
/*
FUNCTION
<<mktemp>>, <<mkstemp>>, <<mkstemps>>,
<<mkostemps>>---generate unused file name
INDEX
mktemp
INDEX
mkstemp
INDEX
mkstemps
INDEX
mkostemps
SYNOPSIS
#include <stdlib.h>
char *mktemp(char *<[path]>);
int mkstemp(char *<[path]>);
int mkstemps(char *<[path]>, int suffixlen);
int mkostemps(char *<[path]>, int suffixlen, int flags);
DESCRIPTION
<<mktemp>>, <<mkstemp>>, <<mkstemps>>, and <<mkostemps>> attempt to
generate a file name that is not yet in use for any existing file.
<<mkstemp>>, <<mkstemps>> and <mkostemps>> create the file and open it
for reading and writing; <<mktemp>> simply generates the file name
(making <<mktemp>> a security risk). <<mkostemps>> allow the addition
of other <<open>> flags, such as <<O_CLOEXEC>>, <<O_APPEND>>, or
<<O_SYNC>>. On platforms with a separate text mode, <<mkstemp>>
forces <<O_BINARY>>, while <<mkostemp>> allows the choice between
<<O_BINARY>>, <<O_TEXT>>, or 0 for default.
You supply a simple pattern for the generated file name, as the string
at <[path]>. The pattern should be a valid filename (including path
information if you wish) ending with at least six `<<X>>' characters.
The generated filename will match the leading part of the name you
supply, with the trailing `<<X>>' characters replaced by some
combination of digits and letters. With <<mkstemps>> and
<mkostemps>>, the `<<X>>' characters end <[suffixlen]> bytes before
the end of the string.
RETURNS
<<mktemp>> returns the pointer <[path]> to the modified string
representing an unused filename, unless it could not generate one, or
the pattern you provided is not suitable for a filename; in that case,
it returns <<NULL>>. Be aware that there is an inherent race between
generating the name and attempting to create a file by that name;
you are advised to use <<O_EXCL|O_CREAT>>.
<<mkstemp>>, <<mkstemps>> and <<mkostemps>> return a file descriptor
to the newly created file, unless it could not generate an unused
filename, or the pattern you provided is not suitable for a filename;
in that case, it returns <<-1>>.
NOTES
Never use <<mktemp>>. The generated filenames are easy to guess and
there's a race between the test if the file exists and the creation
of the file. In combination this makes <<mktemp>> prone to attacks
and using it is a security risk. Whenever possible use <<mkstemp>>
instead. It doesn't suffer the race condition.
PORTABILITY
ANSI C does not require either <<mktemp>> or <<mkstemp>>; the System V
Interface Definition requires <<mktemp>> as of Issue 2. POSIX 2001
requires <<mkstemp>> while deprecating <<mktemp>>. <<mkstemps>>, and
<<mkostemps>> are not standardized.
Supporting OS subroutines required: <<open>>
*/
#define _DEFAULT_SOURCE
#include <_ansi.h>
#include <stdlib.h>
#include <sys/types.h>
#include <fcntl.h>
#include <errno.h>
#include <stdio.h>
#include <unistd.h>
#include <string.h>
static int
_gettemp (char *path,
int suffixlen,
int *doopen,
int flags)
{
char *start, *trv;
char *end;
end = path + strlen(path) - suffixlen;
trv = end;
/* Replace 'X' with 'a' */
while (path < trv && *--trv == 'X')
*trv = 'a';
/* Make sure we got six Xs */
if (end - trv < 6)
{
errno = EINVAL;
return 0;
}
start = trv + 1;
for (;;)
{
/*
* Use open to check if the file exists to avoid depending on
* stat or access. Don't rely on O_EXCL working, although if it
* doesn't, this introduces a race condition
*/
int fd = open(path, O_RDONLY);
if (fd < 0) {
if (errno != EACCES) {
if (errno != ENOENT)
return 0;
if (doopen)
{
fd = open (path, flags | O_CREAT | O_EXCL | O_RDWR,
0600);
if (fd >= 0) {
*doopen = fd;
return 1;
}
if (errno != EEXIST)
return 0;
} else {
return 1;
}
}
} else
close(fd);
/* Increment the string of letters to generate another name */
trv = start;
for(;;)
{
if (trv == end)
return 0;
if (*trv == 'z')
*trv++ = 'a';
else {
++ * trv;
break;
}
}
}
/*NOTREACHED*/
}
int
mkstemp (char *template)
{
int fd;
return (_gettemp (template, 0, &fd, 0) ? fd : -1);
}
char *
mktemp (char *template)
{
return (_gettemp (template, 0, (int *) NULL, 0) ? template : (char *) NULL);
}
#ifndef O_BINARY
#define O_BINARY 0
#endif
#ifndef O_TEXT
#define O_TEXT 0
#endif
int
mkstemps(char *template, int suffixlen)
{
int fd;
return (_gettemp (template, suffixlen, &fd, O_BINARY) ? fd : -1);
}
int
mkostemps(char *template, int suffixlen, int flags)
{
int fd;
flags &= (O_APPEND | O_CLOEXEC | O_SYNC | O_BINARY | O_TEXT);
return (_gettemp (template, suffixlen, &fd, flags) ? fd : -1);
}
|