µC/FS Error Codes

This section provides a brief explanation of µC/FS error codes defined in fs_err.h. Any error codes not listed here may be searched in fs_err.h for both their numerical value and usage.

System Error Codes

Error Code	Meaning
`FS_ERR_NONE`	No error.
`FS_ERR_INVALID_ARG`	Invalid argument.
`FS_ERR_INVALID_CFG`	Invalid configuration.
`FS_ERR_INVALID_CHKSUM`	Invalid checksum.
`FS_ERR_INVALID_LEN`	Invalid length.
`FS_ERR_INVALID_TIME`	Invalid date/time.
`FS_ERR_INVALID_TIMESTAMP`	Invalid timestamp.
`FS_ERR_INVALID_TYPE`	Invalid object type.
`FS_ERR_MEM_ALLOC`	Mem could not be alloc'd.
`FS_ERR_NULL_ARG`	Arg(s) passed NULL val(s).
`FS_ERR_NULL_PTR`	Ptr arg(s) passed NULL ptr(s).
`FS_ERR_OS`	OS err.
`FS_ERR_OVF`	Value too large to be stored in type.
`FS_ERR_EOF`	EOF reached.
`FS_ERR_WORKING_DIR_NONE_AVAIL`	No working dir avail.
`FS_ERR_WORKING_DIR_INVALID`	Working dir invalid.

Buffer Error Codes

Error Code	Meaning
`FS_ERR_BUF_NONE_AVAIL`	No buffer available.

Cache Error Codes

Error Code	Meaning
`FS_ERR_CACHE_INVALID_MODE`	Mode specified invalid.
`FS_ERR_CACHE_INVALID_SEC_TYPE`	Device already open.
`FS_ERR_CACHE_TOO_SMALL`	Device has changed.

Device Error Codes

Error Code	Meaning
`FS_ERR_DEV`	Device access error.
`FS_ERR_DEV_ALREADY_OPEN`	Device already open.
`FS_ERR_DEV_CHNGD`	Device has changed.
`FS_ERR_DEV_FIXED`	Device is fixed (cannot be closed).
`FS_ERR_DEV_FULL`	Device is full (no space could be allocated).
`FS_ERR_DEV_INVALID`	Invalid device.
`FS_ERR_DEV_INVALID_CFG`	Invalid dev cfg.
`FS_ERR_DEV_INVALID_ECC`	Invalid ECC.
`FS_ERR_DEV_INVALID_IO_CTRL`	I/O control invalid.
`FS_ERR_DEV_INVALID_LOW_FMT`	Low format invalid.
`FS_ERR_DEV_INVALID_LOW_PARAMS`	Invalid low-level device parameters.
`FS_ERR_DEV_INVALID_MARK`	Invalid mark.
`FS_ERR_DEV_INVALID_NAME`	Invalid device name.
`FS_ERR_DEV_INVALID_OP`	Invalid operation.
`FS_ERR_DEV_INVALID_SEC_NBR`	Invalid device sec nbr.
`FS_ERR_DEV_INVALID_SEC_SIZE`	Invalid device sec size.
`FS_ERR_DEV_INVALID_SIZE`	Invalid device size.
`FS_ERR_DEV_INVALID_UNIT_NBR`	Invalid device unit nbr.
`FS_ERR_DEV_IO`	Device I/O error.
`FS_ERR_DEV_NONE_AVAIL`	No device avail.
`FS_ERR_DEV_NOT_OPEN`	Device not open.
`FS_ERR_DEV_NOT_PRESENT`	Device not present.
`FS_ERR_DEV_TIMEOUT`	Device timeout.
`FS_ERR_DEV_UNIT_NONE_AVAIL`	No unit avail.
`FS_ERR_DEV_UNIT_ALREADY_EXIST`	Unit already exists.
`FS_ERR_DEV_UNKNOWN`	Unknown.
`FS_ERR_DEV_VOL_OPEN`	Vol open on dev.
`FS_ERR_DEV_INCOMPATIBLE_LOW_PARAMS`	Incompatible low-level device parameters.
`FS_ERR_DEV_INVALID_METADATA`	Device driver metadata is invalid.
`FS_ERR_DEV_OP_ABORTED`	Operation aborted.
`FS_ERR_DEV_CORRUPT_LOW_FMT`	Corrupted low-level fmt.
`FS_ERR_DEV_INVALID_SEC_DATA`	Retrieved sec data is invalid.
`FS_ERR_DEV_WR_PROT`	Device is write protected.
`FS_ERR_DEV_OP_FAILED`	Operation failed.
`FS_ERR_DEV_NAND_NO_AVAIL_BLK`	No blk avail.
`FS_ERR_DEV_NAND_NO_SUCH_SEC`	This sector is not available.
`FS_ERR_DEV_NAND_ECC_NOT_SUPPORTED`	The needed ECC scheme is not supported.
`FS_ERR_DEV_NAND_ONFI_EXT_PARAM_PAGE`	NAND device extended parameter page must be read.

Device Driver Error Codes

Error Code	Meaning
`FS_ERR_DEV_DRV_ALREADY_ADDED`	Device driver already added.
`FS_ERR_DEV_DRV_INVALID_NAME`	Invalid device driver name.
`FS_ERR_DEV_DRV_NONE_AVAIL`	No driver available.

Directory Error Codes

Error Code	Meaning
`FS_ERR_DIR_ALREADY_OPEN`	Directory already open.
`FS_ERR_DIR_DIS`	Directory module disabled.
`FS_ERR_DIR_FULL`	Directory is full.
`FS_ERR_DIR_NONE_AVAIL`	No directory avail.
`FS_ERR_DIR_NOT_OPEN`	Directory not open.

ECC Error Codes

Error Code	Meaning
`FS_ERR_ECC_CORRECTABLE`	Correctable ECC error.
`FS_ERR_ECC_UNCORRECTABLE`	Uncorrectable ECC error.

Entry Error Codes

Error Code	Meaning
`FS_ERR_ENTRIES_SAME`	Paths specify same file system entry.
`FS_ERR_ENTRIES_TYPE_DIFF`	Paths do not both specify files OR directories.
`FS_ERR_ENTRIES_VOLS_DIFF`	Paths specify file system entries on different vols.
`FS_ERR_ENTRY_CORRUPT`	File system entry is corrupt.
`FS_ERR_ENTRY_EXISTS`	File system entry exists.
`FS_ERR_ENTRY_INVALID`	File system entry invalid.
`FS_ERR_ENTRY_NOT_DIR`	File system entry not a directory.
`FS_ERR_ENTRY_NOT_EMPTY`	File system entry not empty.
`FS_ERR_ENTRY_NOT_FILE`	File system entry not a file.
`FS_ERR_ENTRY_NOT_FOUND`	File system entry not found.
`FS_ERR_ENTRY_PARENT_NOT_FOUND`	Entry parent not found.
`FS_ERR_ENTRY_PARENT_NOT_DIR`	Entry parent not a directory.
`FS_ERR_ENTRY_RD_ONLY`	File system entry marked read-only.
`FS_ERR_ENTRY_ROOT_DIR`	File system entry is a root directory.
`FS_ERR_ENTRY_TYPE_INVALID`	File system entry type is invalid.
`FS_ERR_ENTRY_OPEN`	Operation not allowed on entry corresponding to an open file/dir.

File Error Codes

Error Code	Meaning
`FS_ERR_FILE_ALREADY_OPEN`	File already open.
`FS_ERR_FILE_BUF_ALREADY_ASSIGNED`	Buf already assigned.
`FS_ERR_FILE_ERR`	Error indicator set on file.
`FS_ERR_FILE_INVALID_ACCESS_MODE`	Access mode is specified invalid.
`FS_ERR_FILE_INVALID_ATTRIB`	Attributes are specified invalid.
`FS_ERR_FILE_INVALID_BUF_MODE`	Buf mode is specified invalid or unknown.
`FS_ERR_FILE_INVALID_BUF_SIZE`	Buf size is specified invalid.
`FS_ERR_FILE_INVALID_DATE_TIME`	Date/time is specified invalid.
`FS_ERR_FILE_INVALID_DATE_TIME_FLAG`	Date/time flag is specified invalid.
`FS_ERR_FILE_INVALID_NAME`	Name is specified invalid.
`FS_ERR_FILE_INVALID_ORIGIN`	Origin is specified invalid or unknown.
`FS_ERR_FILE_INVALID_OFFSET`	Offset is specified invalid.
`FS_ERR_FILE_INVALID_FILES`	Invalid file arguments.
`FS_ERR_FILE_INVALID_OP`	File operation invalid.
`FS_ERR_FILE_INVALID_OP_SEQ`	File operation sequence invalid.
`FS_ERR_FILE_INVALID_POS`	File position invalid.
`FS_ERR_FILE_LOCKED`	File locked.
`FS_ERR_FILE_NONE_AVAIL`	No file available.
`FS_ERR_FILE_NOT_OPEN`	File not open.
`FS_ERR_FILE_NOT_LOCKED`	File not locked.
`FS_ERR_FILE_OVF`	File size overflowed max file size.
`FS_ERR_FILE_OVF_OFFSET`	File offset overflowed max file offset.

Name Error Codes

Error Code	Meaning
`FS_ERR_NAME_BASE_TOO_LONG`	Base name too long.
`FS_ERR_NAME_EMPTY`	Name empty.
`FS_ERR_NAME_EXT_TOO_LONG`	Extension too long.
`FS_ERR_NAME_INVALID`	Invalid file name or path.
`FS_ERR_NAME_MIXED_CASE`	Name is mixed case.
`FS_ERR_NAME_NULL`	Name ptr arg(s) passed NULL ptr(s).
`FS_ERR_NAME_PATH_TOO_LONG`	Entry path is too long.
`FS_ERR_NAME_BUF_TOO_SHORT`	Buffer for name is too short.
`FS_ERR_NAME_TOO_LONG`	Full name is too long.

Partition Error Codes

Error Code	Meaning
`FS_ERR_PARTITION_INVALID`	Partition invalid.
`FS_ERR_PARTITION_INVALID_NBR`	Partition nbr specified invalid.
`FS_ERR_PARTITION_INVALID_SIG`	Partition sig invalid.
`FS_ERR_PARTITION_INVALID_SIZE`	Partition size invalid.
`FS_ERR_PARTITION_MAX`	Max nbr partitions have been created in MBR.
`FS_ERR_PARTITION_NOT_FINAL`	Prev partition is not final partition.
`FS_ERR_PARTITION_NOT_FOUND`	Partition not found.
`FS_ERR_PARTITION_ZERO`	Partition zero.

Pools Error Codes

Error Code	Meaning
`FS_ERR_POOL_EMPTY`	Pool is empty.
`FS_ERR_POOL_FULL`	Pool is full.
`FS_ERR_POOL_INVALID_BLK_ADDR`	Block not found in used pool pointers.
`FS_ERR_POOL_INVALID_BLK_IN_POOL`	Block found in free pool pointers.
`FS_ERR_POOL_INVALID_BLK_IX`	Block index invalid.
`FS_ERR_POOL_INVALID_BLK_NBR`	Number blocks specified invalid.
`FS_ERR_POOL_INVALID_BLK_SIZE`	Block size specified invalid.

File System Error Codes

Error Code	Meaning
`FS_ERR_SYS_TYPE_NOT_SUPPORTED`	File sys type not supported.
`FS_ERR_SYS_INVALID_SIG`	Sec has invalid OR illegal sig.
`FS_ERR_SYS_DIR_ENTRY_PLACE`	Dir entry could not be placed.
`FS_ERR_SYS_DIR_ENTRY_NOT_FOUND`	Dir entry not found.
`FS_ERR_SYS_DIR_ENTRY_NOT_FOUND_YET`	Dir entry not found (yet).
`FS_ERR_SYS_SEC_NOT_FOUND`	Sec not found.
`FS_ERR_SYS_CLUS_CHAIN_END`	Cluster chain ended.
`FS_ERR_SYS_CLUS_CHAIN_END_EARLY`	Cluster chain ended before number clusters traversed.
`FS_ERR_SYS_CLUS_INVALID`	Cluster invalid.
`FS_ERR_SYS_CLUS_NOT_AVAIL`	Cluster not avail.
`FS_ERR_SYS_SFN_NOT_AVAIL`	SFN is not avail.
`FS_ERR_SYS_LFN_ORPHANED`	LFN entry orphaned.

Volume Error Codes

Error Code	Meaning
`FS_ERR_VOL_INVALID_NAME`	Invalid volume name.
`FS_ERR_VOL_INVALID_SIZE`	Invalid volume size.
`FS_ERR_VOL_INVALID_SEC_SIZE`	Invalid volume sector size.
`FS_ERR_VOL_INVALID_CLUS_SIZE`	Invalid volume cluster size.
`FS_ERR_VOL_INVALID_OP`	Volume operation invalid.
`FS_ERR_VOL_INVALID_SEC_NBR`	Invalid volume sector number.
`FS_ERR_VOL_INVALID_SYS`	Invalid file system on volume.
`FS_ERR_VOL_NO_CACHE`	No cache assigned to volume.
`FS_ERR_VOL_NONE_AVAIL`	No vol avail.
`FS_ERR_VOL_NONE_EXIST`	No vols exist.
`FS_ERR_VOL_NOT_OPEN`	Vol not open.
`FS_ERR_VOL_NOT_MOUNTED`	Vol not mounted.
`FS_ERR_VOL_ALREADY_OPEN`	Vol already open.
`FS_ERR_VOL_FILES_OPEN`	Files open on vol.
`FS_ERR_VOL_DIRS_OPEN`	Dirs open on vol.
`FS_ERR_JOURNAL_ALREADY_OPEN`	Journal already open.
`FS_ERR_JOURNAL_CFG_CHANGED`	File system suite cfg changed since log created.
`FS_ERR_JOURNAL_FILE_INVALID`	Journal file invalid.
`FS_ERR_JOURNAL_FULL`	Journal full.
`FS_ERR_JOURNAL_LOG_INVALID_ARG`	Invalid arg read from journal log.
`FS_ERR_JOURNAL_LOG_INCOMPLETE`	Log not completely entered in journal.
`FS_ERR_JOURNAL_LOG_NOT_PRESENT`	Log not present in journal.
`FS_ERR_JOURNAL_NOT_OPEN`	Journal not open
`FS_ERR_JOURNAL_NOT_REPLAYING`	Journal not being replayed.
`FS_ERR_JOURNAL_NOT_STARTED`	Journaling not started.
`FS_ERR_JOURNAL_NOT_STOPPED`	Journaling not stopped.
`FS_ERR_VOL_LABEL_INVALID`	Volume label is invalid.
`FS_ERR_VOL_LABEL_NOT_FOUND`	Volume label was not found.
`FS_ERR_VOL_LABEL_TOO_LONG`	Volume label is too long.

OS Layer Error Codes

Error Code	Meaning
`FS_ERR_OS_LOCK`	Lock not acquired.
`FS_ERR_OS_INIT`	OS not initialized.
`FS_ERR_OS_INIT_LOCK`	Lock signal not successfully initialized.
`FS_ERR_OS_INIT_LOCK_NAME`	Lock signal name not successfully initialized.