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:
- :ref:`00400`. Read by owner.
- :ref:`00200`. Write by owner.
- :ref:`00100`. Search by owner.
- :ref:`00040`. Read by group.
- :ref:`00020`. Write by group.
- :ref:`00010`. Search by group.
- :ref:`00004`. Read by others.
- :ref:`00002`. Write by others.
- :ref:`00001`. 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`