home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | VERSIONS | CONFORMING TO | SEE ALSO | COLOPHONThe Linux Programming Interface


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

NAME         top

       mkdtemp - create a unique temporary directory

SYNOPSIS         top

       #include <stdlib.h>

       char *mkdtemp(char *template);

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

       mkdtemp():
           _BSD_SOURCE
           || /* Since glibc 2.10: */
               (_POSIX_C_SOURCE >= 200809L || _XOPEN_SOURCE >= 700)

DESCRIPTION         top

       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         top

       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         top

       EINVAL The last six characters of template were not XXXXXX.  Now template is
              unchanged.

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

VERSIONS         top

       Available since glibc 2.1.91.

CONFORMING TO         top

       POSIX.1-2008.  This function is present on the BSDs.

SEE ALSO         top

       mkdir(2), mkstemp(3), mktemp(3), tempnam(3), tmpfile(3), tmpnam(3)

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

GNU                                   2010-09-26                           MKDTEMP(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable
counter