発行番号: Cente101-0125
Rev: 第1版
発行日: 2025/2/3

【題名】
独自ディレクトリ操作API実行時、ディレクトリエントリ情報の排他が行われない問題について

【適用製品】
Cente FileSystem Ver6.42 ～ Ver6.51

【影響API】
rmdir_all, rmdir_all_uni, dinfo, dinfo_uni, readdir_wc, readdir_wc_uni

【現象】
他のタスクと処理がぶつかった場合に、
独自ディレクトリ操作APIでディレクトリエントリ情報が壊れる可能性があります。
また、誤ったディレクトリエントリ情報を読み出す可能性があります。

《発生条件について》
以下の条件を全て満たした場合に発生します。
①OSを使用(複数タスク使用時)
②ディレクトリキャッシュを使用
③独自ディレクトリ操作API使用

【原因】
内部関数のfs_get_direntry()及びfs_get_direntry_uni()は、Cente FileSystem Ver6.42にて独自ディレクトリ操作API用に追加しております。
Centeの設計上、ディレクトリエントリ領域へアクセスする関数に関しては、上位でディレクトリエントリのセマフォロックをする必要がありますが、
Ver6.42で追加したfs_get_direntry()及びfs_get_direntry_uni()ではディレクトリエントリのセマフォロックが抜けておりました。
その為、fs_get_direntry()及びfs_get_direntry_uni()をコールする独自ディレクトリ操作APIを実行した場合に、
セマフォの資源を獲得せずディレクトリエントリ情報更新が行われ、誤動作する可能性があります。

【回避方法】
複数タスクから影響APIを同時に実行しない。

■プログラムによる回避方法
修正ソースにつきましては、弊社サポートまでお問い合わせ下さい。

・物理フォーマット時にアロケーションビットマップのサイズが正しく算出できない不具合を修正（Cente障害情報：110-0002）
sdphy_format実行時において、アロケーションビットマップのサイズ算出に失敗する不具合を修正

・社名変更
社名をNXTech株式会社に統一しました。

・エラーコードが正しく更新されない問題について(Cente障害情報：101-0122)
FileSystemエラーコードを更新しない不具合を修正しました。

・メタデータ保護機能の管理用バッファがオーバーフローしてしまう問題について(Cente障害情報：101-0123)
複数のFATセクタにクラスタチェーンが跨がるようなファイル/ディレクトリにアクセスした場合にバッファのオーバーフローが発生してしまう不具合を修正しました。

・アンマウント中にfclose()を実行するとファイルクローズができなくなる問題について(Cente障害情報：101-0124)
アンマウント中にfclose()を実行してもファイルクローズができない不具合を修正しました。

・社名変更
社名をNXTech株式会社に統一しました。

発行番号: Cente101-0124
Rev: 第1版
発行日: 2024/9/2

【題名】
アンマウント中にfclose()を実行するとファイルクローズができなくなる問題について

【適用製品】
Cente FileSystem Ver6.11 ～ Ver6.50

【影響API】
fclose

【現象】
ファイルオープン中にメディアをアンマウントしfclose()を実行すると、エラーになり
ファイルをクローズすることができません。
その後、再マウントしても、対象のファイルを削除しようとするとCT_OPENDエラーが発生し、
またfclose()を繰り返し実行してもファイルをクローズすることが出来ない状態になります。

《発生条件について》
以下の順番で処理を実行した場合に発生します
①ファイルをオープン(モードは問いません)
②ファイルクローズせずにアンマウントを実行
③fclose()を実行

【原因】
fclose()ではエラーが起きた場合、ファイル構造体のメンバ”stat”と”name”をクリアします。
“stat”はファイルオープン状態のステータス(主にファイルポインタを引数として渡す関数で使用します)
“name”はファイル名(主にファイルポインタを引数として渡さない関数で使用します)
抜去中にfclose()を実行した場合、本来ファイル構造体のメンバの”stat”と”name”をクリアする必要がありますが、
抜去中は”stat”のみクリアを行っておりました。
それにより、”name”を確認するremove()やmove()を実行するとCT_OPENDエラーが
発生し、”stat”を確認するfclose()を実行した場合、CT_NOT_OPENエラーが発生します。

【回避方法】
reset_fsys()の実行後、FileSystemの初期化シーケンスを実行することにより解消されます。

■プログラムによる回避方法
修正ソースにつきましては、弊社サポートまでお問い合わせ下さい。

発行番号: Cente101-0123
Rev: 第1版
発行日: 2024/06/03

【題名】
メタデータ保護機能の管理用バッファがオーバフローしてしまう問題について

【適用製品】
Cente FileSystem Ver6.10 ～ Ver6.50

【影響API】
chg_filelen, rmdir, fopen, remove, rmdir_all, fwrite, rmdir_uni, fopen_uni
※ fopen(), fopen_uni()は”w”モード且つ既存ファイルを指定した場合に問題が生じます。

【現象】
FS_FAT_BLK_NUMを4で割り切れない値を設定した場合で且つ、複数のFATセクタにクラスタチェーンが跨がるようなファイル/ディレクトリにアクセスした場合にバッファのオーバーフローが発生する可能性があります。(CT_DISK_FULLエラーが発生する可能性があります)。

《発生条件について》
以下の条件を満たした場合に発生します。
①FS_FAT_BLK_NUMを4で割り切れない値を設定した場合。
②jfsectnoで確保している要素以上にFATチェーンの作成/消去を行った場合。
　 ※ フラグメンテーションが発生して複数のFATセクタにクラスタチェーンが跨ると、要素以上になる可能性があります。
③影響APIを実行した場合。

【原因】
メタデータ保護機能のバックアップを行う際、FAT1の情報をFAT2にコピーをします。
コピーを行う際、以下の情報を使用します。
・J_FSECT_SZ バックアップ対象のセクタの最大数を管理
・jfsectno バックアップ対象のセクタを記憶する配列テーブル
コピーを行う際、バックアップの範囲は最大J_FSECT_SZのセクタ数までバックアップを行いますが、
設定値によってjfsectnoの要素数がJ_FSECT_SZよりも小さくなる場合がありました。
その結果、バッファのオーバーフローが発生してしまう可能性があります。

以下、J_FSECT_SZ及びjfsectnoの計算式になります。
■fs_journal.c
static ct_uint32_t jfsectno[FS_JNL_DV_MAX][SECT_SZ / sizeof(ct_uint32_t) * J_FSECT_SCT];

■fs_journal.h
#define J_FSECT_SZ    (FS_DATA_SZ / FS_AUS_SZ * FS_FAT_BLK_NUM)
#define J_FSECT_SCT   (J_FSECT_SZ * 4 / SECT_SZ)

■fs_cfg.h
#define FS_DATA_SZ 131072
#define FS_AUS_SZ 4096
#define FS_FAT_BLK_NUM 5
#define FS_DIR_BLK_NUM 8
#define SECT_SZ 512

異常 正常
J_FSECT_SZのサイズ 160 160 → OK
J_FSECT_SCTのサイズ 1 2 → NG
jfsectnoの要素数 128 256

本来、jfsectnoはJ_FSECT_SZよりも大きい配列の要素を確保する必要がありますが、
J_FSECT_SCTのサイズが小数点を考慮できておりませんでした。
その結果、jfsectnoよりもJ_FSECT_SZが大きくなってしまい、現象の発生条件を満たすことによりオーバーフローしてしまう場合がありました。

【回避方法】
ありません。

■プログラムによる回避方法
修正ソースにつきましては、弊社サポートまでお問い合わせ下さい。

発行番号: Cente101-0122
Rev: 第1版
発行日: 2024/03/21

【題名】
エラーコードが正しく更新されない問題について

【適用製品】
Cente FileSystem Ver6.41 ～ Ver6.50

【影響API】
fopen, fopen_uni, rename, rename_uni, move, move_uni, mkdir, mkdir_uni, ct_vdivide, ct_vdivide_uni

【現象】
FileSystemエラーコードにエラーコード(0未満)が格納されている状態で、
影響APIを実行すると、エラーコードを更新せずそのまま返却してしまう可能性があります。

《発生条件について》
以下の全ての条件を満たした場合に発生します。
①「2.影響API」を実行した時に、その直前で他のAPIで異常のエラーコードが戻されていた場合
②「2.影響API」を実行した時に、対象ファイルの情報がディレクトリエントリ領域に新規で書き込まれる場合
③「2.影響API」を実行した時に、対象のディレクトリエントリ領域が複数のクラスタ領域に跨る場合
“(FAT12/16の場合はサブディレクトリ領域のみ、FAT32の場合はルート/サブの両方)”

[例] ①remove()を実行し、存在しないファイルを指定する。
CT_NO_FILE(-3)。
②fopen()をアペンドモードで実行し、存在しないファイルを指定する。
アペンドモードの為、ファイルを作成しようとするが、
①のエラーコードを更新せずそのまま返却してしまい、ファイルの作成が行われない。

【原因】
Cente FileSystemに実装されている関数について、エラーコード返却処理は以下の2パターンがあります。

①returnでエラーコードを上位の関数に戻す。
　[例] return CT_DISK_FULL,

②FSYSER変数にセットし、上位の関数はその変数からエラーコードをゲットする。
　[例] セット： fs_er(CT_DISK_FULL, NULL) ※fs_erp 関数を使用する場合もあります。
　　　ゲット： er = ct_get_api_fsyser()

ct_get_api_fsyser()を使用する場合は、事前にFSYSER変数にセットする処理が呼ばれている必要がありますが、
ディレクトリエントリにアクセスする関数において、セットする処理を通らずゲットが実行される場合がありました。その結果、以前FSYSERにセットされているエラーコードを上位の関数に戻してしまいます。

【回避方法】
ありません。

■プログラムによる回避方法
修正ソースにつきましては、弊社サポートまでお問い合わせ下さい。

・8ビットバスモードに対応
速度改善を目的とした8ビットバスモードへの対応を行いました。
(コントローラが8ビットバスに対応している場合に使用可能)

・Background Operationに対応
フラッシュメモリの性質上必要なメンテナンスを、デバイスの待機時間に実行するようにする
「Background Operation」機能に対応いたしました。

・Power Off Notificationに対応
電源断時に安全に処理を終了させるための「Power Off Notification」機能に対応いたしました。
(JESD84-B45対応環境で使用可能)

・軽微な修正
ワーニング抑制など軽微なコード修正を行いました。

・RX71M用のBSPの追加
RX71MのeMMC BSPを作成しました。

発行番号: Cente101-0121
Rev: 第1版
発行日: 2023/03/31

【題名】
FAT領域が1面の場合にフォーマットを行うと、キャッシュ領域を初期化できない不具合について

【適用製品】
Cente FileSystem Ver4.02 ～ Ver6.42

【影響API】
q_format, q_format_uni

【現象】
FAT領域が1面で、キャッシュ機能を有効にした状態で、
フォーマットを行うと、キャッシュ領域の初期化が出来ず、
古い情報を読み出してしまいます。(FAT領域、ディレクトリエントリ領域)

※FAT領域が2面以上ある場合は該当しません。

【原因】
クイックフォーマットでは、FAT領域、ディレクトリエントリ領域、キャッシュ領域の初期化を行います。
本来ならFAT領域の面数に関わらず、キャッシュ領域を初期化するのが正しいですが、
FAT領域が2面以上の場合に、キャッシュ領域を初期化する形になっておりました。
FAT領域の面数に関わらず、キャッシュ領域を初期化するように修正いたしました。

※FAT領域は通常2面でフォーマットされるため、キャッシュ領域の初期化は行われます。

【回避方法】
ありません。

■プログラムによる回避方法
修正ソースにつきましては、弊社サポートまでお問い合わせ下さい。

発行番号: Cente101-0120
Rev: 第1版
発行日: 2023/03/31

【題名】
メタデータ保護機能使用時 ディスクフル直前の書き込みでの無限ループが発生する不具合について

【適用製品】
Cente FileSystem Ver6.42

【影響API】
fwrite, chg_filelen

【現象】
FAT32かつメタデータ保護機能有効時、
空き容量が160KByteの時に256KByteまとめてfwriteすると、fwriteから返って来なくなる。

【原因】
メタデータ保護機能有効時のFATチェーン更新処理は、FAT領域書き込み前に以下の処理を実行します。
①FAT「全領域」から空きクラスタ位置を検索
②空きクラスタ番号を取得
③保護管理テーブルをチェックし、以前登録済みのクラスタか確認
→ 以前登録済みの場合は、再度①の空きクラスタ検索を実施（※処理を繰り返す）
→ 登録済みで無い場合は、テーブルにクラスタ番号をセット

上記の処理では実際にFAT領域の書き込み処理までは実施しないため、
以下2つの条件を満たした場合に同じ位置のクラスタを繰り返し検索してしまい、
CT_DISK_FULL(-11)を戻さずに無限ループの状態になってしまいます。
・空きクラスタがある状態から書き込みを実施
・空きクラスタ以上のクラスタを書き込み

【回避方法】
1クラスタずつ書込みをおこなう。

■プログラムによる回避方法
修正ソースにつきましては、弊社サポートまでお問い合わせ下さい。

発行番号: Cente101-0119
Rev: 第1版
発行日: 2023/03/31

【題名】
メタデータ保護機能使用時 残容量が必要以上に消費されてしまう不具合について

【適用製品】
Cente FileSystem Ver6.10 ～ Ver6.42

【影響API】
fopen_uni, fputc, fputs, fwrite, rename_uni, move_uni, chg_filelen, mkdir_uni

【現象】
FAT32かつメタデータ保護機能が有効なメディアに対して、
2クラスタ分以上の長さのファイルを書き込むとファイルシステムの空き容量が化ける。
get_dev_free_uni()が返す残容量が renew_fsinfo_uni() の前後で変化する。

【原因】
FAT32の場合は、FAT領域を消費した場合にFSINFO領域内の「free cluster count」情報を更新しますが、
実際の消費より余計にカウンタ値を更新していました。

【回避方法】
FAT32またはメタデータ保護機能を使用しない

■プログラムによる回避方法
修正ソースにつきましては、弊社サポートまでお問い合わせ下さい。