Go to main content

man pages section 2: System Calls

Exit Print View

Updated: Thursday, June 13, 2019
 
 

creat(2)

Name

creat - create a new file or rewrite an existing one

Synopsis

#include <sys/stat.h>
#include <fcntl.h>

int creat(const char *path, mode_t mode);

Description

The function call

creat(path, mode)

is equivalent to:

open(path, O_WRONLY | O_CREAT | O_TRUNC, mode)

Return Values

Refer to open(2).

Errors

Refer to open(2).

Examples

Example 1 Creating a File

The following example creates the file /tmp/file with read and write permissions for the file owner and read permission for group and others. The resulting file descriptor is assigned to the fd variable.

#include <fcntl.h>
...
int fd;
mode_t mode = S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH;
char *filename = "/tmp/file";
...
fd = creat(filename, mode);
...

Usage

The creat() function has a transitional interface for 64-bit file offsets. See lf64(7).

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Async-Signal-Safe
Standard

See Also

open(2), attributes(7), lf64(7), standards(7)