Quality RTOS & Embedded Software

LIBRARIES

ff_mkdir()

[FreeRTOS+FAT Standard API Reference]

ff_stdio.h
int ff_mkdir( const char *pcDirectory );
		

Create a new directory in the embedded FAT file system.

Parameters:

pcDirectory   A pointer to a standard null terminated C string that holds the name of the directory being created. The string can include a relative path.

Returns:

If the directory was created successfully then zero is returned.

If the directory could not be created then -1 is returned and the task’s errno is set to indicate the reason. A task can obtain its errno value using the ff_errno() API function.

Example usage:


void vExampleFunction( void )
{
/* Create a sub directory called subfolder. */
ff_mkdir( “subfolder” );

/* Create three subdirectories called sub1, sub2 and sub three respectively
inside the subfolder directory. */

ff_mkdir( “subfolder/sub1” );
ff_mkdir( “subfolder/sub2” );
ff_mkdir( “subfolder/sub3” );

/* Move into the subfolder/sub1 directory. */
ff_chdir( “subfolder/sub1” );

/* Create another directory called sub4 inside the subfolder/sub1 directory. */
ff_mkdir( “sub4” );
}

Example use of the ff_mkdir() API function to create a directory


Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.