TEMPNAM
Section : Manuel du programmeur Linux (
3)
Mise à jour de la version anglaise : 26 juillet 2007
Index
Menu principal
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.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- NOTES
-
- BOGUES
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008