mkdir

OS/161 Reference Manual

Name

mkdir - create directory

Library

Standard C Library (libc, -lc)

Synopsis

#include <sys/stat.h>

int
mkdir(const char *pathname, int mode);

Description

mkdir creates a directory named name, where name is the last filename component in pathname. All the directories named in the prefix portion of pathname must exist and must in fact be directories, not ordinary files. The name name must not already exist. The new directory must be created atomically.

The mode argument can be ignored in OS/161.

Return Values

On success, mkdir returns 0. On error, -1 is returned, and errno is set according to the error encountered.

Errors

The following error codes should be returned under the conditions given. Other error codes may be returned for other errors not mentioned here.
  
ENODEV The device prefix of pathname did not exist.
ENOTDIR A non-final component of pathname was not a directory.
ENOENT A non-final component of pathname did not exist.
EEXIST An object by the name pathname already exists.
ENOSPC The filesystem the directory was to be created on is full.
EIO A hard I/O error occurred.
EFAULT pathname was an invalid pointer.