NOMBRE

       tempnam - crea un nombre para un fichero temporal

SINOPSIS

       #include <stdio.h>

       char *tempnam(const char *dir, const char *pfj);

DESCRIPCIÓN

       La  función  tempnam() devuelve un puntero a una cadena que es un nombre válido de fichero
       tal que no existe un fichero con este nombre cuando tempnam() lo comprueba.  El sufijo del
       nombre  de  fichero  de  la  ruta generada comenzará con pfj en el caso de que pfj sea una
       cadena distinta de NULL con al menos 5 bytes.  La parte de directorios del prefijo  de  la
       ruta  generada  necesita  ser  `adecuada' (normalmente, esto implica que al menos se pueda
       escribir).  Los pasos que se siguen para intentar encontrar un directorio adecuado son los
       siguientes:  (i)  En  el  caso  de  que la variable de entorno TMPDIR exista y contenga el
       nombre de un directorio apropiado,  se  utiliza  ese.   (ii)  En  caso  contrario,  si  el
       argumento  dir es distinto de NULL y apropiado, se usa.  (iii) En caso contrario, P_tmpdir
       (tal y como se define en <stdio.h>) se usa cuando sea conveniente.   (iv)  Finalmente,  se
       puede usar un directorio definido por la implementación.

VALOR DEVUELTO

       La  función  tempnam() devuelve un puntero al nombre de fichero único en el sistema o NULL
       si no se puede generar el nombre.

ERRORES

       ENOMEM Ha fallado la reserva de memoria.

OBSERVACIONES

       SUSv2 no menciona el uso de TMPDIR. glibc lo usará sólo cuando el programa  no  sea  suid.
       SVID2 especifica que el directorio usado en el caso (iv) es /tmp.  SVID2 especifica que la
       cadena que devuelve tempnam() se reservó usando malloc(3) y  que,  por  tanto,  puede  ser
       liberada con free(3).

       La  función  tempnam()  genera  una  cadena diferente cada vez que se llama, hasta TMP_MAX
       veces (definida en <stdio.h>).  Si se  llama  más  de  TMP_MAX  veces,  el  comportamiento
       depende de la implementación.

       En el caso de que el argumento pfj tenga una longitud mayor de 5, glibc usará los primeros
       5 bytes. En el caso de que la búsqueda de un nombre único falle, glibc devolverá EEXIST.

FALLOS

       El significado preciso de `adecuado' no  está  definido.  Está  sin  especificar  cómo  se
       determina  la  accesibilidad  de  un directorio.  Nunca use esta función. En su lugar, use
       mkstemp(3).

CONFORME A

       SVID 2, BSD 4.3

VÉASE TAMBIÉN

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

                                          14 junio 1999                                TEMPNAM(3)