# FS_CreateDirectory

## Syntax

    #include <nitro/fs.h>

    BOOL FS_CreateDirectory(const char *path, u32 permit);

## Arguments

`path` | Path name of the directory to create.
`permit` | Specifies the combination of `FS_PERMIT_*` flags that specify the access rights to the directory. (This is reserved for future implementation. Access rights are currently ignored.)

## Return Values

Returns TRUE if the directory was created properly; returns FALSE otherwise. In case of failure, the error details can be obtained using `FS_GetArchiveResultCode()`.

## Description

Creates the new directory specified by the arguments. The function returns FALSE in the following situations:

- If the target archive does not support the creation of new directories
- If a directory of the same name already exists.

## Note

- This function cannot be called from the interrupt handler (IRQ mode). Also note that in some cases processing may not end if interrupts are left prohibited.

## See Also

`FS_PERMIT_*
FS_DeleteDirectory
FS_RenameDirectory
FS_GetResultCode`

## Revision History

2009/02/05 Explained that access rights are currently ignored.
2007/09/18 Initial version.

CONFIDENTIAL