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`