tempnam   Début   Suivant   Sommaire   Préc.page.lue   Accueil
Section: Manuel du programmeur Linux (3)
Updated: 26 juillet 2007
Sommaire  



NOM   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
tempnam - Créer un nom de fichier temporaire  



SYNOPSIS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
#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   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
La fonction tempnam() renvoie un pointeur sur un nom de fichier unique, ou NULL si ce nom n'a pas pu être engendré.  



ERREURS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
EEXIST
Impossible de créer un nom de fichier unique.
ENOMEM
Pas assez de mémoire libre.
 



CONFORMITÉ   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
SVr4, BSD 4.3, POSIX.1-2001.  



NOTES   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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). 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   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
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   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
mkstemp(3), mktemp(3), tmpfile(3), tmpnam(3)  



TRADUCTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil

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 6 juin 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.


 



Sommaire   Début   Suivant   Sommaire   Préc.page.lue   Accueil
NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
NOTES
BOGUES
VOIR AUSSI
TRADUCTION

Table des mots clés   Début   Suivant   Sommaire   Préc.page.lue   Accueil
EEXISTERREURS
ENOMEMERREURS



Ce document a été créé par man2html suivi de man2html.pl, le 17/10/2008 17:51:40, en utilisant les pages de 'man'.
 

Valid HTML 4.01 Transitional