fformat

#include <rtl.h>

int fformat  (
    const char* drive);    /* drive to format */

The function fformat formats an EFS or FAT storage media for using a file system. The parameter drive is a pointer specifying the drive letter. Optionally, a drive label (for FAT) and options can be include in the parameter. The function closes all open files on the drive. Existing file handles become invalid.

The function is included in the RL-FlashFS library. The prototype is defined in the file rtl.h.

The general form for drive is:

drive := "[driveLetter][driveLabel] [/options]"

The following values are allowed for driveLetter:

The driveLabel characteristics are:

The options are:

• 0 - on success.
• non-zero value - on failure.

fcheck, fdelete

#include <rtl.h>

void tst_fformat (void)  {

  if (fformat ("F:") != 0) {                                 /* Format a Flash Drive. */
    printf ("Formatting failure.\n");
  }
  else  {
    printf ("File System initialized.\n");
  }


  if (fformat ("M:SD_CARD") != 0)  {                         /* Format with Volume Label. */
    printf ("Formatting failure.\n");
  }
  else  {
    printf ("SD Memory Card formatted.\n");
  }


  if (fformat ("M:SD_CARD /FAT32 /WIPE") != 0)  {            /* Use FAT32; clear data. */
    printf ("Formatting failure.\n");
  }
  else  {
    printf ("Formatted for FAT32.\n");
  }
}