60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
# 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`
|