MKDTEMP(3)                 Linux Programmer's Manual                MKDTEMP(3)



NAME
       mkdtemp - create a unique temporary directory

SYNOPSIS
       #include <stdlib.h>

       char *mkdtemp(char *template);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       mkdtemp():
           /* Since glibc 2.19: */ _DEFAULT_SOURCE
           || /* Glibc 2.19 and earlier: */ _BSD_SOURCE
           || /* Since glibc 2.10: */ _POSIX_C_SOURCE >= 200809L

DESCRIPTION
       The  mkdtemp()  function generates a uniquely named temporary directory
       from template.  The last six characters of template must be XXXXXX  and
       these  are replaced with a string that makes the directory name unique.
       The directory is then created with permissions 0700.  Since it will  be
       modified,  template  must  not  be  a  string  constant,  but should be
       declared as a character array.

RETURN VALUE
       The mkdtemp() function returns  a  pointer  to  the  modified  template
       string  on  success,  and  NULL  on failure, in which case errno is set
       appropriately.

ERRORS
       EINVAL The last six characters of template were not XXXXXX.   Now  tem-
              plate is unchanged.

       Also see mkdir(2) for other possible values for errno.

VERSIONS
       Available since glibc 2.1.91.

ATTRIBUTES
       For   an   explanation   of   the  terms  used  in  this  section,  see
       attributes(7).

       +----------+---------------+---------+
       |Interface | Attribute     | Value   |
       +----------+---------------+---------+
       |mkdtemp() | Thread safety | MT-Safe |
       +----------+---------------+---------+
CONFORMING TO
       POSIX.1-2008.  This function is present on the BSDs.

SEE ALSO
       mktemp(1), mkdir(2),  mkstemp(3),  mktemp(3),  tempnam(3),  tmpfile(3),
       tmpnam(3)

COLOPHON
       This  page  is  part of release 4.16 of the Linux man-pages project.  A
       description of the project, information about reporting bugs,  and  the
       latest     version     of     this    page,    can    be    found    at
       https://www.kernel.org/doc/man-pages/.



GNU                               2016-07-17                        MKDTEMP(3)