---
name: "rfio_mkdir"
section: "3"
platform: "linux"
package: "libdpm-dev"
version: "1.10.0-2+b3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/rfio_mkdir"
---

# rfio\_mkdir(3)

create a new directory

## NAME

rfio\_mkdir - create a new directory

## SYNOPSIS

**#include \<sys/types.h\>**\
 **#include "rfio\_api.h"**

**int rfio\_mkdir (const char \****path***, mode\_t** *mode***);**

## DESCRIPTION

**rfio\_mkdir** creates a new directory.

An entry is created and the directory's owner ID is set to the effective user ID of the requestor. The group ID of the directory is set to the effective group ID of the requestor.

- *path*

  specifies the logical pathname relative to the current directory or the full pathname.

## RETURN VALUE

This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, **serrno** is set appropriately.

## ERRORS

- **ENOENT**

  A component of *path* prefix does not exist or *path* is a null pathname.

- **EACCES**

  Search permission is denied on a component of the *path* prefix or write permission on the parent directory is denied.

- **EFAULT**

  *path* is a NULL pointer.

- **EEXIST**

  *path* exists already.

- **ENOTDIR**

  A component of *path* prefix is not a directory.

- **ENOSPC**

  No space to store the new directory.

- **ENAMETOOLONG**

  The length of *path* exceeds **CA\_MAXPATHLEN** or the length of a *path* component exceeds **CA\_MAXNAMELEN**.

- **SENOSHOST**

  Host unknown.

- **SENOSSERV**

  Service unknown.

- **SECOMERR**

  Communication error.

## SEE ALSO

**[Castor\_limits(4)](/Castor_limits/4.md)**, **[rfio\_chmod(3)](/rfio_chmod/3.md)**

## AUTHOR

**LCG Grid Deployment** Team