GENWiki

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)