Source code
Revision control
Copy as Markdown
Other Tools
PR_MkDir
========
Creates a directory with a specified name and access mode.
Syntax
------
.. code::
#include <prio.h>
PRStatus PR_MkDir(
const char *name,
PRIntn mode);
Parameters
~~~~~~~~~~
The function has the following parameters:
``name``
The name of the directory to be created. All the path components up
to but not including the leaf component must already exist.
``mode``
The access permission bits of the file mode of the new directory if
the file is created when ``PR_CREATE_FILE`` is on.
Caveat: The mode parameter is currently applicable only on Unix
platforms. It may be applicable to other platforms in the future.
Possible values include the following:
- ``0x00400``. Read by owner.
- ``0x00200``. Write by owner.
- ``0x00100``. Search by owner.
- ``0x00040``. Read by group.
- ``0x00020``. Write by group.
- ``0x00010``. Search by group.
- ``0x00004``. Read by others.
- ``0x00002``. Write by others.
- ``0x00001``. Search by others.
Returns
~~~~~~~
- If successful, ``PR_SUCCESS``.
- If unsuccessful, ``PR_FAILURE``. The actual reason can be retrieved
via :ref:`PR_GetError`.
Description
-----------
:ref:`PR_MkDir` creates a new directory with the pathname ``name``. All the
path components up to but not including the leaf component must already
exist. For example, if the pathname of the directory to be created is
``a/b/c/d``, the directory ``a/b/c`` must already exist.
See Also
--------
:ref:`PR_RmDir`