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 fonctionalité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 nul 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, s'il est accessible en écriture,

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

c)  le répertoire défini par P_tmpdir (dans <stdio.h>)

d)  finalement, 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 engendré.

ERREURS

EEXIST
    Impossible de créer un nom de fichier unique.

ENOMEM
    Pas assez de mémoire libre.

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

NOTES
Bien que tempnam(3) génère des noms qui soient dificiles à deviner, il est néanmoins possible qu'entre le moment où tempnam(3) 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). SVID2 précise que la chaîne renvoyée par

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 pas 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 23 décembre 2007.

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.