mkdtemp

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 de-
       clared 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 ap-
       propriately.

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 at-
       tributes(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 5.05 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)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2024 Hurricane Electric. All Rights Reserved.