NAME

     tempnam - create a name for a temporary file


SYNOPSIS

     #include <stdio.h>

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


DESCRIPTION

     The tempnam() function generates a unique temporary filename
     using  up to five characters of pfx, if it is not NULL.  The
     directory to place the file is searched for in the following
     order:-


          a)   The directory specified by the  environment  vari-
               able TMPDIR, if it is writable.

          b)   The directory specified by the argument dir, if it
               is not NULL.

          c)   The directory specified by P_tmpdir.

          d)   The directory /tmp.

     The storage for the filename is allocated by  malloc(),  and
     so can be free'd by the function free().


RETURN VALUE

     The tempnam() function returns a pointer to the unique  tem-
     porary filename, or NULL if a unique filename cannot be gen-
     erated.


ERRORS

     EEXIST
          Unable to generate a unique filename.


CONFORMING TO

     SVID 3, BSD 4.3


SEE ALSO

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