CertC-FIO03

Do not make assumptions about fopen() and file creation

Required inputs: IR

The C fopen() function is used to open an existing file or create a new one. The C11 version of the fopen() function provides a mode flag, x , that provides the mechanism needed to determine if the file that is to be opened exists. Not using this mode flag can lead to a program overwriting or accessing an unintended file.

Noncompliant Code Example ( fopen() )

In this noncompliant code example, the file referenced by file_name is opened for writing. This example is noncompliant if the programmer's intent was to create a new file, but the referenced file already exists.

char *file_name;
FILE *fp;

/* Initialize file_name */

fp = fopen(file_name, "w");
if (!fp) {
  /* Handle error */
}
Compliant Solution (fopen("x"), C11)

Starting in C11 a new mode suffix ("x") was added to the fopen() function which causes fopen() to return NULL if the file already exists or cannot be created [ ISO/IEC 9899:2011 ].

char *file_name;
FILE *fp;

/* Initialize file_name */

fp = fopen(file_name, "wx");
if (!fp) {
  /* Handle error */
}
Compliant Solution ( open() , POSIX)

The open() function, as defined in the Standard for Information Technology—Portable Operating System Interface (POSIX®), Base Specifications, Issue 7 [ IEEE Std 1003.1:2013 ], is available on many platforms and provides finer control than fopen() . In particular, open() accepts the O_CREAT and O_EXCL flags. When used together, these flags instruct the open() function to fail if the file specified by file_name already exists.

char *file_name;
int new_file_mode;

/* Initialize file_name and new_file_mode */

int fd = open(file_name, O_CREAT | O_EXCL | O_WRONLY, new_file_mode);
if (fd == -1) {
  /* Handle error */
}

Care should be taken when using O_EXCL with remote file systems because it does not work with NFS version 2. NFS version 3 added support for O_EXCL mode in open() . IETF RFC 1813 [ Callaghan 1995 ] defines the EXCLUSIVE value to the mode argument of CREATE :

EXCLUSIVE specifies that the server is to follow exclusive creation semantics, using the verifier to ensure exclusive creation of the target. No attributes may be provided in this case, since the server may use the target file metadata to store the createverf3 verifier.

For examples of how to check for the existence of a file without opening it, see recommendation FIO10-C. Take care when using the rename() function .

Compliant Solution ( fdopen() , POSIX)

For code that operates on FILE pointers and not file descriptors, the POSIX fdopen() function can be used to associate an open stream with the file descriptor returned by open() , as shown in this compliant solution [ IEEE Std 1003.1:2013 ]:

char *file_name;
int new_file_mode;
FILE *fp;
int fd;

/* Initialize file_name and new_file_mode */

fd = open(file_name, O_CREAT | O_EXCL | O_WRONLY, new_file_mode);
if (fd == -1) {
  /* Handle error */
}

fp = fdopen(fd, "w");
if (fp == NULL) {
  /* Handle error */
}
Compliant Solution (Windows)

The Win32 API CreateFile() allows a programmer to create or open a file depending on the flags passed in. Passing in the CREATE_NEW flag ensures the call fails if the file already exists. This compliant solution demonstrates how to open a file for reading and writing without sharing access to the file such that the call fails if the file already exists.

TCHAR *file_name;
HANDLE hFile = CreateFile(file_name, GENERIC_READ | GENERIC_WRITE, 0, 0,
                          CREATE_NEW, FILE_ATTRIBUTE_NORMAL, 0);
if (INVALID_HANDLE_VALUE == hFile) {
  DWORD err = GetLastError();
  if (ERROR_FILE_EXISTS == err) {
    /* Handle file exists error */
  } else {
    /* Handle other error */
  }
}
Risk Assessment

The ability to determine whether an existing file has been opened or a new file has been created provides greater assurance that a file other than the intended file is not acted upon.

Recommendation Severity Likelihood Detectable Repairable Priority Level
FIO03-C Medium Probable No No P4 L3
Related Guidelines
SEI CERT C++ Coding Standard VOID FIO03-CPP. Do not make assumptions about fopen() and file creation
Bibliography
[ Callaghan 1995 ] IETF RFC 1813 NFS Version 3 Protocol Specification
[ IEEE Std 1003.1:2013 ] System Interfaces: open
[ ISO/IEC 9899:2011 ] Subclause 7.21.5.3, "The fopen Function"
[ Loosemore 2007 ] Section 12.3, "Opening Streams"
[ Seacord 2013 ] Chapter 8, "File I/O"
Excerpt from SEI CERT C Coding Standard: Rules for Developing Safe, Reliable, and Secure Systems (2016 Edition) and SEI CERT C Coding Standard [https://cmu-sei.github.io/secure-coding-standards/sei-cert-c-coding-standard/recommendations/input-output-fio/fio03-c], Copyright (C) 1995-2026 Carnegie Mellon University. See 9.4 3rd-Party Licenses in the documentation for full details.

Possible Messages

Key

Text

Severity

Disabled

nonexclusive_file_creation

Do not make assumptions about fopen() and file creation.

None

False

Options

fopen_functions

fopen_functions

Type: dict[str, int]

Default:

{
   'fopen': 1,
   'fopen_s': 2
}
fopen()-family functions to check, mapped to the zero-based index of their mode argument.
 

open_functions

open_functions : set[str] = {'_open', '_wopen', 'open'}

open()-family functions to check for O_CREAT without O_EXCL in their flags.