NAME

       pm_make_tmpfile() - create a temporary named file

SYNOPSIS

       #include <netpbm/pm.h>

       pm_make_tmpfile(FILE **       fileP,
                       const char ** filenameP);

EXAMPLE

       This  simple  example  creates  a  temporary  file,  writes  "hello world" to it, then writes some search
       patterns to it, then uses it as input to grep:

       #include <netpbm/pm.h>

       FILE * myfileP;
       const char * myfilename;

       pm_make_tmpfile(&myfileP, &myfilename);

       fprintf(myfile, "^account:\\s.*\n");
       fprintf(myfile, "^name:\\s.*\n");

       fclose(myFileP);

       asprintfN(&grepCommand, "grep --file='%s' /tmp/infile >/tmp/outfile");

       system(grepCommand);

       strfree(grepCommand);

       unlink(myfilename);

       strfree(myfilename);

DESCRIPTION

       This library function is part of Netpbm(1).

       pm_make_tmpfile() creates and opens a temporary file, returning to you a stream file handle  for  it  and
       its name.

       pm_make_tmpfile()  chooses  a file name that is not already in use, with proper interlocking to make sure
       that it actually creates a file and opens the new file, as opposed to merely opening an existing file.

       If you don't need to access the file by name, use  pm_tmpfile()  instead,  because  it's  cleaner.   With
       pm_tmpfile(),  the  operating  system  always  deletes the temporary file when your program exits, if the
       program failed to clean up after itself.

       The temporary file goes in the directory named by the TMPFILE environment variable.  If  TMPFILE  is  not
       set  or  is  set  to  something  unusable  (e.g.   too long), pm_tmpfile() falls back to the value of the
       standard C library symbol P_tmpdir (like the standard C library's tmpfile()).

       The name of the file within that directory is like myprog_blrfx, where myprog is the name of your program
       (arg 0) and the rest is an arbitrary discriminator.

       If pm_make_tmpfile() is unable to create a temporary file, it issues a  message  to  Standard  Error  and
       aborts the program.

HISTORY

       pm_tmpfile() was introduced in Netpbm 10.27 (March 2005).

DOCUMENT SOURCE

       This  manual  page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation
       is at

              http://netpbm.sourceforge.net/doc/libmaketmpfile.html

netpbm documentation                            10 November 2007     Netpbm subroutine ..._tmpfile() function(3)