Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
mkstemp(3C)		 Standard C Library Functions		   mkstemp(3C)

NAME
       mkstemp - make a	unique file name from a	template and open the file

SYNOPSIS
       #include	<stdlib.h>

       int mkstemp(char	*template);

DESCRIPTION
       The  mkstemp()  function	replaces the contents of the string pointed to
       by template by a	unique file name, and returns a	 file  descriptor  for
       the  file open for reading and writing.	The function thus prevents any
       possible	race condition between testing whether	the  file  exists  and
       opening	it  for	 use.	The string in template should look like	a file
       name with six trailing 'X's; mkstemp() replaces each 'X'	with a charac-
       ter  from the portable file name	character set. The characters are cho-
       sen such	that the resulting name	does not duplicate the name of an  ex-
       isting file.

RETURN VALUES
       Upon  successful	completion, mkstemp() returns an open file descriptor.
       Otherwise -1 is returned	if no suitable file could be created.

ERRORS
       No errors are defined.

USAGE
       It is possible to run out of letters.

       The mkstemp() function does not check to	 determine  whether  the  file
       name part of template exceeds the maximum allowable file	name length.

       The tmpfile(3C) function	is preferred over this function.

       The  mkstemp()  function	 is frequently used to create a	temporary file
       that will be removed by the application before the  application	termi-
       nates.

       The  mkstemp()  function	 has  a	transitional interface for 64-bit file
       offsets.	 See lf64(5).

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       getpid(2), open(2), tmpfile(3C),	 tmpnam(3C),  attributes(5),  lf64(5),
       standards(5)

SunOS 5.10			  15 Sep 2004			   mkstemp(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mkstemp&sektion=3c&manpath=SunOS+5.10>

home | help