TEMPNAM(3)

NOM
tempnam - Créer un nom de fichier temporaire

SYNOPSIS
#include <stdio.h>

char *tempnam(const char *rep, const char *préfixe);

Exigences de macros de test de fonctionnalités pour la glibc (voir feature_test_macros(7)) :

tempnam() : _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION
La fonction tempnam() renvoie un pointeur sur un nom de fichier valide, en s'assurant qu'aucun fichier de ce nom n'existe au moment de son invocation. Le nom du fichier commencera par le préfixe si celui-ci n'est pas NULL et contient jusqu'à cinq caractères. Le chemin d'accès devant le nom du fichier sera obligatoirement « approprié » (ce qui implique au minimum qu'on puisse y écrire). L'ordre de recherche du répertoire pour placer le fichier est le suivant :

a)  le répertoire indiqué par la variable d'environnement TMPDIR, si elle existe et si elle contient le nom d'un répertoire approprié,

b)  sinon, le répertoire indiqué par l'argument rep, s'il n'est pas NULL et est approprié,

c)  sinon, le répertoire défini par P_tmpdir (dans <stdio.h>) s'il est approprié,

d)  enfin, un répertoire dépendant de l'implémentation (/tmp par exemple).

La chaîne renvoyée par tempnam() est allouée avec malloc(3) et doit donc être libérée avec free(3).

VALEUR RENVOYÉE
La fonction tempnam() renvoie un pointeur sur un nom de fichier unique, ou NULL si ce nom n'a pas pu être généré.

ERREURS

ENOMEM
    Échec de l'allocation mémoire.

CONFORMITÉ
SVr4, BSD 4.3, POSIX.1-2001.

NOTES
Bien que tempnam() génère des noms qui soient dificiles à deviner, il est néanmoins possible qu'entre le moment où tempnam() renvoie le nom du chemin et le moment où le programme l'ouvre, un autre programme a pu créer ce même nom de chemin avec open(2), ou l'avoir créer sous forme de lien symbolique. Cela peut conduire à des trous de sécurité. Pour éviter de telles possibilités, utilisez l'attribut O_EXCL de open(2) pour ouvrir le nom du chemin. Ou encore mieux, utilisez mkstemp(3) ou tmpfile(3). SUSv2 ne mentionne pas l'utilisation de TMPDIR, la glibc ne l'emploiera que si le programme n'est pas Set-UID. SVr4 indique que le répertoire pour le cas d) est /tmp (et c'est ce que fait la glibc).

Parce qu'elle alloue dynamiquement la mémoire utilisée pour renvoyer le nom du chemin, tempnam() est réentrante, et donc sûre du point de vue des threads, contrairement à tmpnam(3).

La fonction tempnam() crée une chaîne différente à chaque fois qu'elle est appelée, jusqu'à TMP_MAX (définie dans <stdio.h>) fois. Si on l'appelle plus de TMP_MAX fois, le comportement dépend de l'implémentation.

tempnam() utilise au plus les cinq premiers octets de préfixe. L'implémentation glibc de tempnam() échouera avec l'erreur EEXIST en cas d'échec pour trouver un nom unique.

BOGUES
La signification précise de « approprié » est indéfinie, la détermination des conditions d'accessibilité à un répertoire n'est pas spécifiée. N'utilisez jamais cette fonction, utilisez mkstemp(3) ou tmpfile(3) à la place.

VOIR AUSSI
mkstemp(3), mktemp(3), tmpfile(3), tmpnam(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 10 novembre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 tempnam ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.