67 lines
1.5 KiB
ReStructuredText
67 lines
1.5 KiB
ReStructuredText
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`
|