mkstemp(3c) [hpux man page]

mktemp(3C)																mktemp(3C)

NAME

       mktemp(), mkstemp() - make a unique file name

SYNOPSIS

   Remarks
       These  functions are provided solely for backward compatibility and importability of applications, and are not recommended for new applica-
       tions where portability is important.  For portable applications, use instead (see tmpfile(3S)).

DESCRIPTION

       replaces the contents of the string pointed to by template by a unique file name, and returns the address of template.  The string in  tem-
       plate  should  look like a file name with six trailing replaces each with a single byte character from the portable filename character set.
       The letter is chosen such that the resulting name does not duplicate the name of an existing file.

       makes the same replacement to the template, but also returns a file descriptor for the template file after opening the file for reading and
       writing.  thus prevents any possible race condition between testing whether the file exists and opening it for use.

RETURN VALUE

       returns	its  argument except when it runs out of letters or an underlying service fails, in which case the result is a pointer to an empty
       string

       returns an open file descriptor upon successful completion, or -1 if no suitable file could be created.

WARNINGS

       It is possible to run out of letters.

       and do not check to determine whether the file name part of template exceeds the maximum allowable file name length.

       Setting kernel tunable to values greater than 99999 can have an effect on formation of temporary filenames in and

       Formation of temporary filenames using process ids may not be supported in future versions of and

SEE ALSO

       getpid(2), open(2), tmpfile(3S), tmpnam(3S), thread_safety(5).

STANDARDS CONFORMANCE

																	mktemp(3C)

mktemp(3)						     Library Functions Manual							 mktemp(3)

NAME

       mktemp, mkstemp - Construct a unique file name

LIBRARY

       Standard C Library (libc.so, libc.a),

       System V Compatibility Library (libsys5.a)

SYNOPSIS

       Standard C Library

       #include <stdlib.h>

       int mkstemp(	 char *template);

       char *mktemp(	  char *template);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       mktemp(), mkstemp():  XPG4-UNIX

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Points to a string to be replaced with a unique file name.  The string in the template parameter must be a file name with six trailing Xs.

DESCRIPTION

       The  mktemp()  function	replaces the contents of the string pointed to by the template parameter with a unique file name.  The application
       must initialize template to be a file name with six trailing Xs; mktemp() replaces the Xs in the template string with a unique  file  name.
       Under  libc.a, the file name is a unique combination of the thread name and process ID.	Under libsys5.a, the file name is created with the
       getpid function.

       The mkstemp() function performs the same substitution to the template name and also returns a file descriptor for the file  and	opens  the
       file with "owner" reading and writing privileges (0600). The function thus prevents any possible race condition between testing whether the
       file exists and opening it for use.  The mkstemp() function is not available under libsys5.a.

RETURN VALUES

       Upon successful completion, the mktemp() function returns the address of the string pointed to by the template parameter.

       If the string pointed to by the template parameter contains no Xs, or if the mktemp() function is unable to construct a unique  file  name,
       the first character of the template parameter string is replaced with a null character, and a null pointer is returned.

       Upon  successful completion, the mkstemp() function returns an open file descriptor. If the mkstemp() function fails, it returns a value of
       -1.

ERRORS

       No errors are defined for this routine.

RELATED INFORMATION

       Functions: tmpfile(3), tmpnam(3), getpid(2)

       Standards: standards(5) delim off

																	 mktemp(3)