libtmpfile(3) [centos man page]

Netpbm subroutine library: pm_tmpfile() function(3)	     Library Functions Manual	       Netpbm subroutine library: pm_tmpfile() function(3)

NAME

       pm_tmpfile() - create a temporary unnamed file

SYNOPSIS

       #include <netpbm/pm.h>

       FILE *
       pm_tmpfile(void);

EXAMPLE

       This simple example creates a temporary file, writes 'hello world' to it, then reads back and prints those contents.

       #include <netpbm/pm.h>

       FILE * myfileP;

       myfile = pm_tmpfile();

       fprintf(myfile, 'hello world
');

       fseek(myfileP, 0, SEEK_SET);

       fread(buffer, sizeof(buffer), 1, myfileP);

       fprintf(STDOUT, 'temp file contains '%s'
', buffer);

       fclose(myfileP);

DESCRIPTION

       This library function is part of Netpbm(1)

       pm_tmpfile()  creates  and  opens  an unnamed temporary file.  It is basically the same thing as the standard C library tmpfile() function,
       except that it uses the TMPFILE environment variable to decide where to create the temporary file.  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, just like tmpfile().

       Unlike  tmpfile(),  pm_tmpfile()  never returns NULL.  If it fails, it issues a message to Standard Error and aborts the program, like most
       libnetpbm routines do.

       If you need to refer to the temporary file by name, use pm_make_tmpfile() instead.

HISTORY

       pm_tmpfile() was introduced in Netpbm 10.20 (January 2004).

netpbm documentation						   22 July 2004 	       Netpbm subroutine library: pm_tmpfile() function(3)

Netpbm subroutine library: pm_make_tmpfile() function(3)     Library Functions Manual	  Netpbm subroutine library: pm_make_tmpfile() function(3)

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.*
');
       fprintf(myfile, '^name:\s.*
');

       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 arbi-
       trary 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).

netpbm documentation						 10 November 2007	  Netpbm subroutine library: pm_make_tmpfile() function(3)