Vxworks Dosfs文件系统

  转载自：http://aabbc1122.blog.163.com/blog/static/57043257201441593144707/

如有侵权，请联系我删除

VxWorks为块设备（磁盘）的实时使用提供了两种本地文件系统：一种与MS-DOS文件系统相兼容，另一种与RT-11文件系统相兼容。这些文件系统的支持库分别为dosFsLib和rt11FsLib。VxWorks还提供了一种简单的raw文件系统，这个文件系统把整个磁盘作为一个单独的大文件。这个文件系统的支持库是rawFsLib。

VxWorks还为不使用标准文件或目录结构的磁带设备提供了一个文件系统。磁带卷被看作一个raw设备，整个卷就是一个大文件。这个文件系统的支持库是tapeFsLib。另外，VxWorks提供了一个文件系统支持库cdromFsLib，它允许应用程序从依照ISO9660标准文件系统格式化的CD-ROMs中读取数据。

在VxWorks中，文件系统不受块设备种类型或它的驱动程序的约束。VxWorks块设备都使用一个标准接口，以便文件系统可以与设备驱动程序自由的混合。做为选择，你可以写自己的能被驱动程序以相同方式使用的文件系统，只要在文件系统、驱动程序和I/O系统间遵循同样的标准接口。VxWorks的I/O体系结构使得在一个VxWorks系统中可以有多样的文件系统，甚至其类型也可以不同。块设备界面在3.9.4块设备中讨论。

1 与MS-DOS兼容的文件系统：dosFs

使用dosFs文件系统格式化的磁盘与MS-DOS（直至6.2版本）磁盘是相兼容的。由两个文件系统初始化的硬盘之间在格式上有细微区别。然而，数据自身是兼容的，而且dosFs可被配置成使用MS-DOS格式化的磁盘。

DosFs文件系统向不同要求的实时应用程序提供了良好的适应性。主要特点包括：

l 文件和目录分等级排序，允许有效地组织，在一卷上可以创建任意数量的文件。

l 每个文件可以是连续存储或非连续存储的。非连续存储的文件可使硬盘空间利用率更高，连续存储的文件可以增强系统性能。

l 具有与广泛可用的存储器和可恢复介质的兼容性。应用VxWorks（不使用dosFs文件扩展名）、MS-DOS PCs和其它系统创建的磁盘可以自由的交换。如果分区表被说明，那么硬盘也是兼容的。

l 具有从有dosFs文件系统的本地SCSI设备引导VxWorks的能力。

l 可以使用比通常MS-DOS允许的8个字符的文件名加3个字符的扩展名更长的文件名。

l NFS（网络文件系统）的支持。

1.1磁盘组织

MSDOS/ dosFs文件系统提供了一种以灵活方式组织磁盘数据的方法。它维护指定目录、每个包含文件或其它的目录的等级设置。文件可以被设置其搜索路径；文件扩展时，新的磁盘空间被自动分配。分配给一个文件的磁盘空间不必一定是连续的，这样可以使磁盘空间浪费最小。然而，为了提高它的实时性，dosFs文件系统允许连续空间被预先个别地分配给文件，从而使查找操作最块，行为更加确定。MS-DOS/dosFs文件系统的通常组织结构如图1，其中的多个单元在下面的部分论述。

图1 MS-DOS磁盘组织

-------------------------------

引导扇区 扇区0

-----------------------------

文件分配表（FAT)

-----------------------------

根目录

------------------------

文件和子目录

----------------------------

簇

在MS-DOS/dosFs文件系统中，分配给文件的磁盘空间由一个或多个磁盘簇组成。一个簇为一组连续的磁盘扇区 。软盘通常由两个扇区组成一簇；固定硬盘由更多的扇区组成一簇。文件系统可以一次分配的最小的磁盘空间为一簇。虽然每簇有巨大数量的扇区允许在固定大小的文件分配表（ FAT；见 文件分配表）中描述一个巨大的磁盘，但是这可能会导致磁盘空间的浪费。

引导扇区

MS-DOS/dosFs硬盘或磁盘的第一个扇区称为引导扇区。其中包含有多种配置数据。其中一些数据域描述硬盘的物理性质（例如总扇区数），另外一些域描述文件系统变量（例如根目录的大小）。

引导扇区信息在初始化时写入磁盘。dosFs文件系统可以使用在另一个系统上初始化过的磁盘（例如，在MS-DOS PC上使用FORMAT），或者VxWorks可以使用ioctl()调用中的FIODISKINIT函数初始化磁盘。

随着MS-DOS标准的发展，多样的域被加入到引导扇区的定义中。VxWorks 下的磁盘初始化使用MS-DOS 5.0版本定义的引导扇区域。

MS-DOS 初始化硬盘时，在引导扇区中加入一个分区表。而VxWorks不创建这样一个表。所以两个系统初始化的硬盘是不同的。如果设备的块补偿参数创建程序将超出分区表范围的数据指向数据区的第一个字节，那么VxWorks可以读取被 MS-DOS 格式化的磁盘文件。

文件分配表

每个MS-DOS/dosFs卷包含一个文件分配表（FAT）。对每一个分配给文件或目录的磁盘上的簇，FAT中都有一个条目。当簇没有使用过时（可分配），它的条目值为零。如果簇分配给一个文件，它的条目值是文件下一部分的簇号。如果簇位于文件的最后，它的条目值是-1。所以，文件或目录的表述由一个FAT条目链表组成。如2例所示，一个文件由簇2、300和500组成。簇3是没有使用过。

注意：dosFs不映射坏的磁盘扇区到FAT中

图2：FAT条目

此主题相关图片如下：

FAT的每个条目占12或16位。最多包含4085簇的磁盘卷用12位条目；多于4085簇的磁盘用16位条目。条目（特别是12位条目）最初利用英特尔8088体系配置的优点，编码为特殊形式。然而，因为所有的FAT操作都通过dosFs文件系统执行；所以编码和译码与 VxWorks应用程序无关。

一个卷通常包括多个FAT拷贝。这种冗余允许数据在第一份FAT中发生介质错误事件时得到恢复。

警告：如果是指定配置，dosFs 文件系统维护多个FAT拷贝；然而，在错误事件中，拷贝不是自动使用的。

FAT的大小和FAT拷贝的数量是由引导扇区中的域决定的。对于使用dosFs文件系统初始化的磁盘，这些参数是在dosFsDevInit( )调用（通过设置卷配置结构DOS_VOL_CONFIG中域）期间被指定的。

根目录

每个MS-DOS/dosFs卷包含一个根目录。根目录总是占有紧接着FAT拷贝的一组连续的磁盘扇区。根目录占领的磁盘区域不在FAT中被条目描述。

根目录的大小是固定的，它的大小被引导扇区中的一个域指定，作为允许的目录项的最大数值。对于使用dosFs文件系统初始化的磁盘，这个大小是在dosFsDevInit( )调用（通过设置卷配置结构DOS_VOL_CONFIG中域）期间被指定的。

因为根目录有一个固定的大小，所以目录为满时再向其中加入项将返回一个错误。

子目录

除了根目录外，MS-DOS/dosFs卷有时包含一个子目录层。和根目录一样，子目录也包含文件和其它子目录项; 不过，在有些方面它们不同与根目录，而是类似于文件。

l 第一、象文件一样，每个子目录都被另一个目录中的项描述。这样的一个目录项通过在文件属性字节中一个位设置来说明它描述了一个子目录。同时，子目录与根目录不同，它有用户指定名。

l 第二、分配给子目录的磁盘空间由FAT条目连接而成的一组磁盘组成。这意味着子目录可以随着条目的加入而增大，并且子目录不一定要由连续的簇组成。根目录与子目录不同，能由任意数量的扇区组成，并且不必等于簇的整数倍数。

l 第三，子目录通常包含两个专用的项。“.”项指向子目录本身，“..”项指向子目录的父目录。而根目录不包含这些专用项。

文件

在MO-DOS/dosFs文件系统中分配给文件的磁盘空间是由FAT中的条目链在一起的一组簇。一个文件不一定由连续的簇组成；可以以任意顺序分配磁盘任意位置的不同的簇。

每个文件在其目录中有一个描述项。这个项包含文件名、大小、最后一次修改的时间和日期，还有文件的几个重要属性（只读文件，系统文件，隐藏文件，存档文件）。这个条目也包含文件的起始簇数；剩下的簇用FAT定位。

卷标

一个MS-DOS/dosFs磁盘可以有一个相关的卷标。卷标在根目录中是一个特殊项。它不包含文件名和子目录，而是包含一个识别卷的字符串。这个字符串可以包含最多11个字符。卷标项是通过在目录项中的一个特殊的文件属性字节的值来识别的。

注意虽然卷标条目没有用ls（）报告出来。不过它占了根目录固定数目的条目中的一个。

卷标可以通过使用带有FIOLABELSET函数参数的ioctl（）调用加入到dosFs卷。如果卷标不存在，就在卷的根目录加一个卷标项，否则，改变卷标字符串的值。这个卷标条目占据一个固定的根目录条目数；当根目录满时增加一个条目将导致一个错误。

当前的卷标字符串可以通过调用带有FIOLABELGET函数参数的ioctl（）来获得。如果没有卷标，这个调用将返回一个错误，并设置errno为S_dosFsLib_NO_LABEL。

在VxWork或MS-DOS5.0（或更高版本）下初始化的磁盘，其引导扇区也包含卷标字符串。

1.2 初始化dosFs文件系统

注意在任何其它操作能被执行之前，dosFs文件系统库（dosFsLib）必须通过dosFsInit（）调用进行初始化。这个程序带有一个参数――可以在同一时间打开的dosFs文件描述符的最大数。文件描述符的数目是在初始化时被分配，而且应用程序打开一个文件、目录或文件系统设备时，就使用了一个文件描述符。

dosFsInit（）程序在I/O系统驱动器表中也为文件系统创建了一个条目（用isoDrvInstall（））。这个条目为dosFs文件操作指定条目指针，并且可以用于dosFs文件系统中所有的设备。分配给dosFs文件系统的驱动器数记录在全局变量dosFsDrvNum中。

DosFsInit（）通常在VxWorks系统启动之后被usrRoot（）任务调用。使用这种初始化，在项目工具VxWorks view中选择INCLUDE_DOSFS，在Params属性标记中设置NUM_DOSFS_FILES为想打开文件的最大数。

1.3 使用dosFs初始化设备

dosFs文件系统初始化后，下一步是创建一个或更多的设备。设备通过设备驱动器的设备创建程序（xxDevCreate（））来创建。驱动程序向块设备描述符结构（BLK_DEV）返回一个指针。BLK_DEV结构描述了设备的物理形式,同时也指定设备驱动程序提供给文件系统的程序。更多块设备的信息参见3.9.4块设备。

设备刚创建之后，块设备没有与其相关联的名字和文件系统。为了初始化一个块设备用于dosFs文件系统，已经创建好的块设备必须与dosFs相关联，并指派一个名字。这由dosFsDevInit（）完成。它的参数有：用来标识设备的名字、块设备描述符结构和卷配置结构DOS_VOL_CONFIG（见4.2.4卷结构）。例子：

DOS_VOL_DESC *pVolDesc;

DOS_VOL_CONFIG configStruct;

pVolDesc = dosFsDevInit ("DEV1:", pBlkDev, &configStruct);

dosFsDevInit（）调用执行下列任务：

l 为设备命名，把设备加入I/O系统设备表（用iosDevAdd（））。

l 为设备分配并初始化文件系统卷描述符

l 返回指向卷描述符的一个指针。这个指针用来在一些文件系统调用时识别磁卷

用dosFs初始化设备并不格式化磁盘，也不用MS_DOS结构（根目录，FAT，等等）初始化磁盘。可以在有数据存在于MS_DOS文件系统中的磁盘上使用dosFsDevInit（）调用；可以使用ioctl（）函数中FIODISKFORMAT和FIODISKINIT分别实现磁盘格式化和DOS磁盘初始化。

DosFsMkfs（）调用提供了一种简易的dosFs设备初始化的方法。如下

l 提供了一组缺省的配置值。

l 调用dosFsDevInit（）。

l 使用带有FIODISKINIT的ioctl（）函数初始化磁盘。

默认的dosFsMkfs()不能使任何dosFs-specific卷选项

（DOS_OPT_CHANGENOWARN,DOS_OPT-AUTOSYNC,DOS_OPT-LONGNAMES,DOS_OPT_LOWERCASE,或DOS_OPT_EXPORT）可用。在调用dosFsMkfs（）初始化磁盘之前使用dosFsMkfsOptionsSet（），可以使这些选项中的所有组合有效。有关默认配置值的更多信息，见dosFsMkfs()手册。

1.4 卷配置

卷的配置结构(DOS_VOL_CONFIG)在调用dosFsDevInit（）时使用。这个结构包含多种描述磁盘上数据分布的dosFs文件系统变量。结构中的大多数域与引导扇区中的相符。表1列出在DOS_VOL_CONFIG结构中的域。

表1：DOS_VOL_CONFIG域。

域 描述

dosvc_mediaByte 媒体描述符字节

dosvc_secPerClust 每簇的扇区数

dosvc_nResrvd 第一个FAT拷贝之前的保留扇区数，最小值为1（引导扇区）

dosvc_nFats FAT拷贝数

dosvc_secPerFat 每个FAT拷贝的扇区数

dosvc_maxRootEnts 根目录中条目的最大值

dosvc_nHidden 隐藏扇区数，通常为0

dosvc_options VxWorks特殊文件系统选项

dosvc_reserved 风河公司为将来使用保留

调用dosFsConfigInit（）是初始化DOS_VOL_CONFIG的简便方法。它把配置变量作为参数并装入结构。这对从Tornado shell中交互地初始化设备很有用（见Tornado 用户手册：shell）。DOS_VOL_CONFIG结构必须在dosFsConfigInit( )调用前被分配。

DOS_VOL_CONFIG 域

在表1中除了最后两个DOS_VOL_CONFIG域，都描述了标准MS_DOS的特征。

域dosvc_options对于dosFs文件系统很特殊。这个域可能的选项见表2

表2：dosFs卷选项

选项 16进制值 描述

DOS_OPT_CHANGENOWARN 0x1 磁盘可能在没有警告的情况下被改动.

DOS_OPT_AUTOSYNC 0x2 I/O期间使磁盘同步

DOS_OPT_LONGNAMES 0x4 使用不受8.3规格的限制的大小写敏感文件名

DOS_OPT_EXPORT 0x8 允许使用NFS输出

DOS_OPT_LOWERCASE 0x40 在磁盘上使用小写文件名

前两个选项说明同步磁盘缓存块与物理设备的动作。剩下的选项用于扩展dosFs的性能。

DOS_OPT_CHANGENOWARN

如果磁盘没有被卸载就可被替换，或在状态就绪检查中发生变化，则设置这个选项。在这种情形中，有规则的检查磁盘来确定否发生改变。这将引起系统重大的开支；那么，我们推荐使用一种总是在移除前同步和卸载磁盘的机制，或至少声明状态就绪改变的机制。如果这样的机制适当，或磁盘是不可移动的，则不设置这个属性。自动同步模式在DOS_OPT_CHANGENOWARN被设置时自动允许（见下面有关DOS_OPT_AUTOSYNC的描述）。

DOS_OPT_AUTOSYNC

设置这个属性可确保磁盘缓存器中的目录和FAT数据被修改后尽快写入物理设备，而不仅仅是在文件关闭时被写入物理设备。数据尽可能存储到物理介质上，从而避免在系统紧急事件中丢失数据。因为使用自同步模式时将降低性能，所以 。

然而，DOS_OPT_AUTOSYNC设置不能使dosFs在每个write（）后自动向磁盘中写数据。这将意味着极大地降低了性能。如果你的应用程序要求dosFs在每个write（）后自动向磁盘中写数据，每次调用write（）后使用带有FIOFLUSH的ioctl（）函数

注不论什么时候设置DOS_OPT_CHANGENOWARN，自动同步模式都可以自动允许。

DOS_OPT_LONGNAMES

设置这个属性使系统允许使用大小写敏感文件名，文件名长度不受MS-DOS8.3版本的限制。

DOS_OPT_EXPORT

设置这个选项来初始化想使用NFS输出的文件系统。dosFs初始化生成附加的支持NFS协议所需的内存数据结构。这个选项对初始化文件系统（可以被输出的）是必不可少的，但它不真正输出文件系统。

DOS_OPT_LOWERCASE

设置这个选项来迫使dosFs创建的文件名使用小写字母字符。

（除了DOS_OPT_LONGNAMES选项是激活的,通常文件名用大写字母字符）如果dosFs卷是通过基于PC的NFS的客户机装载的,则需要设置这个选项。如果DOS_OPT_LONGNAMES选项也被指定,则这个选项无效。

计算配置值

在DOS_VOL_CONFIG结构中，dosvc_secPerClust和dosvc_secPerFat的值必须基于被使用的特殊的设备进行计算。

dosvc_secPerClust

这个域用来说明组成一个单独的簇的连续扇区数。因为一簇是每次可以被分配的最小磁盘空间，簇的大小决定了磁盘分配控制的细微程度。每簇中扇区数越多，每次分配的扇区数越多，从而降低了磁盘空间使用的整个效率。因此，通常每簇使用尽可能少的扇区，不过每簇少于两个扇区通常是不必要的。

FAT条目最大为16位；那么，可以被描述的簇的最大值为65536（64KB，或0x1000），这就是一个设备的簇的最大值。为了确定一簇中适当的扇区数，以0x1000（64k）划分磁盘上的所有扇区（BLK_DEV结构中的bd_nBlocks域），进位舍入到下一个整数，最终结果就是每簇中的扇区数；把这个值赋予DOS_VOL_CONFIG结构中的dosvc_secPerClust域。

dosvc_secPerFat

这个域指定磁盘上每个FAT拷贝必需的扇区数。要计算出这个值，首先确定磁盘的总簇数。总簇数等于总扇区数（BLK_DEV结构中的bd_nBlocks）除以每簇的扇区数。如前面提到的，磁盘的簇的最大数为64KB。

簇数随每个FAT条目的位数增加：如果总簇数小于等于4085，FAT条目为12位；如果簇数大于4085，FAT条目为16位。增加的结果是每个FAT拷贝所需的总字节数。这个字节数除以每个扇区的大小（BLK_DEV结构中的bd_bytesPerBlk域），决定了每个FAT拷贝的扇区数（按扇区的大小划分）；如果有一些残余，结果再加一。把最终的值赋予dosvc_secPerFat域。

假定512字节扇区，每个拷贝最大可能的FAT占用256个扇区，计算如下

标准磁盘配置

对于软盘，许多标准磁盘配置用于MS-DOS系统。通常，配置通过媒体描述符字节的值唯一识别（至少针对一种给定大小的软盘），虽然一些制造商对不同的格式使用完全相同的值。一些广泛使用的配置参见表3。

固定磁盘不使用标准磁盘配置，因为它们很少附属于外部的系统，。通常固定磁盘使用0xF8的介质格式字节。

表3：MS_DOS 软盘配置

容量 160KB 180KB 320KB 360KB 1.2MB 720KB 1.44MB

尺寸 5.25" 5.25" 5.25" 5.25" 5.25" 3.5" 3.5"

面 1 1 2 2 2 2 2

磁道 40 40 40 40 80 80 80

扇区/磁道 8 9 8 9 15 9 18

字节/扇区 512 512 512 512 512 512 512

secPerClust 1 1 2 2 1 2 1

nResrvd 1 1 1 1 1 1 1

NFats 2 2 2 2 2 2 2

如前所述，在dosfs文件系统设备应用dosfsdevinit（）首次初始化时,多种磁盘配置参数被指定。这些参数保存在卷描述符dos_vol_desc中。而带有不同参数值的磁盘可能被放置在初始化过的设备驱动器中。如果用另一个磁盘取代磁盘（带有最后输入到卷描述符的配置参数），那么新磁盘的配置参数必须在使用之前获得。

当磁盘被装载时，引导扇区信息从磁盘上读取出来。此数据用来更新在卷描述符中的配置数据。注意这个操作发生在磁盘存取的开始。而且在卷被卸载（使用dosfsvolunmount（））或一个准备好的替换操作被执行之后，又再次执行这个操作。

配置数据的自动重新初始化有重要的含义。卷描述符数据在初始化磁盘（使用fiodiskinit）时使用；这样，磁盘使用最近装载的磁盘的配置初始化，而不考虑在dosfdevinit（）期间的初始规格，因此我们推荐在磁盘装载之前，在dosfsdevinit（）之后紧接着使用fiodiskinit。（设备以raw模式打开，fiodiskinit ioctl（）函数执行后，关闭设备。）

已初始化过磁盘的使用

如果你使用一块已经初始化过的有ms-dos引导扇区、fat、根目录的磁盘（例如，使用统一的ms-dos格式），则不需要在dosfsdevinit（）中提供卷配置数据。

可以忽略ms-dos配置数据（通过指定一个null指针代替在dosfsdevinit( )期间dos_vol_config结构的地址），不过仅仅在你确信卷的首次使用伴随完全格式化和初始化过的磁盘时才使用这种方法。

当装载一个已经初始化过的磁盘时，所有标准的ms-dos配置值都从磁盘引导扇区获取。而指向dosfs的选项必须被指明。 。

dos_opt_longnames（不受8.3版本限制的大小写敏感文件名），使用这个选项初始化过的磁盘可以通过引导扇区中一个特殊的卷id字符串自动识别。

dos_opt_changenowarn, dos_opt_autosync, dos_opt_lowercase, 和 dos_opt_export选项只记录在内存中，不放在磁盘上。因此当用null代替dos_vol_config结构指针初始化磁盘时，不能删除这些选项。另外可以使用dosfsdevinitoptionsset（）程序设置这些选项为默认值；除非支持明了的dos_vol_config信息，不然默认值将应用于后面所有使用dosfsdevinit（）初始化的dosfs文件系统。

卷配置信息访问

可以通过在tornado shell中使用dosfsconfigshow（）2和dosfsconfigget（）获得磁盘信息。这里参考tornado（shell）。

使用dosfsconfigshow（）显示象最大连续区域和设备名这样的配置信息。例如：

-> dosfsconfigshow "/ram1/"

value = 0 = 0x0

输出到标准输出设备，如下

device name: /ram1/

total number of sectors: 400

bytes per sector: 512

media byte: 0xf0

# of sectors per cluster: 2

# of reserved sectors: 1

# of fat tables: 2

# of sectors per fat: 1

max # of root dir entries: 112

# of hidden sectors: 0

removable medium: false

disk change w/out warning: not enabled

auto-sync mode: not enabled

long file names: not enabled

exportable file system: not enabled

volume mode: o_rdwr (read/write)

available space: 199680 bytes

max avail. contig space: 199680 bytes

dosfsconfigget程序把磁盘信息存储到dos_vol_config结构中。这对于初始化一个新磁盘（与已有磁盘相同配置）很有用，另外对于用dosfsmkfs（）在磁盘上初始化dosfs文件系统，并需要获取被计算的目前配置值也很有用。

装载卷

通常磁盘卷在对磁盘上文件或目录的第一个open（）或creat（）操作时自动装载。（某些ioctl（）调用也可以引起磁盘装载）。 如果在dosfsdevinit（）调用期间，一个null指针被指定代替dos_vol_config结构的地址，那么磁盘被立即装载以获得配置值。

磁盘装载时，从磁盘上读取引导扇区、fat和目录数据。卷描述符dos_vol_desc被更新以反映新装载磁盘的配置。

自动装载发生在dosfsvolumount（）或替换就绪操作之后的第一个文件存取时。如果磁盘在带有dos_opt_changenowarn选项设置的dosfsdevinit（）调用期间被定义，磁盘会被周期性地自动装载。当磁盘以raw模式打开时自动装载不会发生；见

打开整个设备（raw模式）。

警告：因为设备名是被使用简单子链匹配的i/o系统识别的，所以文件系统不使用单独的斜杠（/）作为文件名。如果使用斜杠可能发生意外的结果。

可以使用usrfdconfig（）装载卷，但是这个程序不返回dos_vol_desc结构。用usrfdconfig（）装载的卷不能使用许多dosfs命令，包括dosfsvolunmount（）。不过dofs的ioctl（）命令（包括fiounmount）通过fd存取卷信息，所以可以和usrfdconfig（）一起使用。

文件i/o

dosfs文件系统设备上的文件创建、删除、读写都使用标准vxworks i/o程序: creat( )、 remove( )、 write( )和read( )。

整个设备的打开（raw模式）

可以打开整个的dosfs卷。这是在open（）和creat（）调用期间通过只指定设备名来实现。当一个合法文件被打开时返回一个文件描述符；然而，在文件操作符上的操作影响整个设备。以这种方式打开整个卷叫作raw模式。

打开整个设备的通常原因是为ioctl（）函数获得一个不属于某个文件的文件描述符。如fionfree函数，它返回在卷上的有效字节数。然而，对于许多此类函数，文件描述符可以是任何打开的此卷的，甚至一个特定文件的文件描述符。

当一个磁盘用ms-dos数据结构初始化（引导扇区、空的根目录、fat）时,以raw模式打开此设备。ioctl（）函数fiodiskinit执行初始化。

可以以raw模式读写磁盘上的数据。在这种模式下，整个的磁盘数据区被看作一个单独的大文件。没有目录条目用来描述用raw模式写的任何数据。

有关对整个设备（包括使用ms-dos的数据结构的区域）低级i/o，，见4.4 raw文件系统：rawfs和有关“vxworks 参考手册>库”下的rawfslib的在线参考。

子目录创建

当子目录达到最大条目数时，子目录可以在根目录以外的任何目录下创建。子目录有两种创建方式：

1． 使用带有fiomkdir函数的ioctl（）：目录名传递给ioctl（）。ioctl（）调用使用的文件描述符可以通过以下方式获得：打开整个卷（raw模式）、一个正规文件或卷上的另一个目录。

2． 使用open（）：创建一个目录，o_creat选项必须设置在标记参量中打开，fstat_dir选项必须设置在模式参量中。open（）调用返回一个文件描述符(描述新目录)。这个文件描述符用于只读，当不再需要时关闭这个描述符。

使用以上两种方法的任意一种方法创建目录，新目录名必须被指明。这个名字可以是一个全称路径名，或是一个相对于当前工作目录的路径名。

子目录删除

被删除的目录必须是空的（除了“.”和“..”条目）。删除目录有两种方法：

1． 使用带有fiormdir函数的ioctl（）调用，指定目录名。另外，文件描述符可以指向卷上的任何文件、目录、或卷自己。

2． 使用remove（）函数，指定目录名。

目录条目

每个dosfs目录包含一组条目描述它的文件和子目录。每个条目包含有关文件或子目录的信息：

文件名

一个8字节字符串（如果需要，空格填补）指定文件名。（命名可以长至40个字符；详情见4.2.18长文件名支持）

文件扩展名

一个3字节的字符串（空格填补）指定文件名或子目录名的一个延长部分。（如果选择了不受8.3版本限制的高级文件名，扩展概念是不适用的。）

文件属性

一个字节域指定文件的特征；

时间

文件编码创建修改的时间

日期

文件编码的创建修改的日期

簇号

文件内开始簇的数目。通过搜索fat找后来的簇

文件大小

文件的大小，对描述子目录的条目来说这个域通常为零。

读目录条目

在dosfs卷上的目录可以使用opendir（），readdir（），rewinddir（），和closedir（）程序来搜索。这些调用可以用来确定文件名和子目录。

使用fstat（）或stat（）函数可以获得有关指定文件更详细的信息。连同标准文件信息，被这些程序使用的结构还从目录条目返回文件属性字节。

文件属性

在dosfs目录条目中的文件属性字节由一组标记位组成，每位标志一个特殊的文件特征。文件属性字节描述的特征见下表。

表：文件属性字节中的标记

vxworks 标记名 十六进制值 描述

dos_attr_rdonly 0x01 只读

dos_attr_hidden 0x02 隐藏文件

dos_attr_system 0x04 系统文件

dos_attr_vol_label 0x08 卷标

dos_attr_directory 0x10 子目录

dos_attr_archive 0x20 存档文件

当一个文件被打开为o_wronly或o_rdwr时，dos_attr_rdonly被选中。如果标记设置了，open（）返回error，并且设置errnos为_dosfslib_read_only。

警告：ms-dos隐藏文件和系统文件标记（dos_attr_hidden和dos_attr_system）被dosfslib忽略。虽然他们保持完整，但他们不产生特殊的处理（例如，带有这些标记的条目当搜索目录时被公布）。

卷标标记dos_attr_vol_label用来说明一个包含磁盘的dosfs卷标的目录条目。标签不是必须的，如果使用了，每卷只有一个卷标条目，在根目录中。当读一个目录的内容时，卷标条目不被报告（用readdir（））。只有使用ioctl（）函数fiolabelget时，卷标条目才被确定。使用ioctl（）函数fiolabelset，卷标可以被设置成任何11个字符或更少字符的字符串。在这些ioctl（）调用期间任何打开到此卷的文件描述符都可以使用。

目录标记dos_attr_directory用来指出这个条目不是一个正规的文件而是一个子目录。

存档标记dos_attr_archive在文件被创建或修改时被设置。这个标记被其他搜索卷的程序（寻找修改过的文件并选择存档）使用。这样的程序必须清除存档标记，因为vxworks不做这个工作 。

属性字节中的所有标记（除了目录和卷标标记）可以使用ioctl（）函数filoattribset设置或清除。这个函数调用在指定文件打开后改变其属性。在filattribset调用中指定的属性字节值被直接复制；为了保护存在的标记设置，使用stat（）或fstat（）确定当前的属性，然后使用and和or操作改变他们。

例：设置dosfs文件属性

这个例子使一个dosfs文件只读，并保持其他属性不变

#include "vxworks.h"

#include "iolib.h"

#include "dosfslib.h"

#include "sys/stat.h"

#include "fcntl.h"

status changeattributes (void)

{

int fd;

struct stat statstruct;

/* open file */

if ((fd = open ("file", o_rdonly, 0)) == error)

return (error);

/* get directory entry data */

if (fstat (fd, &statstruct) == error)

return (error);

/* set read-only flag on file */

if (ioctl (fd, fioattribset, (statstruct.st_attrib | dos_attr_rdonly))

== error)

return (error);

/* close file */

close (fd);

}

文件日期和时间

目录条目包含一个文件和目录的时间和日期。这个时间在文件创建时被设置，并在文件被修改后关闭时被更新。描述子目录的条目不被更新——它们总是包含目录的创建日期和时间。

dosfslib库在内在结构中维持日期和时间。然而通常没有一个装置来自动更新时间和日期，这提供了两种不同的设置日期和时间的方法。

第一种方法应用两个程序dosfsdateset（）和dosfstimeset（）。使用如下：

dosfsdateset（1990,12,25）/*设置日期为1990年12月25日*/

dosfstimeset（14,30,22）/*设置时间为14：30：22*/

必须按时调用这些程序来更新日期和时间的值。

第二种方法要求一个用户支持的钩子程序。如果使用dosfsdatetimeinstall（）安装了时间和日期的钩子程序，只要dosfslib要求获取当前日期和时间，程序就被调用。这样可以利用可被读取硬件日历时钟来获取当前时间。也可以用于其它的维持当前时间日期的应用软件。

定义日期/时间钩子程序如下（datetimehook是一个例子名，真正的程序名可以是任何名）

void datetimehook

(

dos_date_time * pdatetime /* ptr to dosfs date & time struct */

)

在钩子程序的入口，包含最近的时间和日期的dos_date_time结构设置在dosfslib中。接下来，钩子程序用当前正确的时间和日期填充结构。结构中没有发生改变的区域保持先前的值。

ms-dos规格在文件时间标记上仅提供了2秒间隔的时间戳。如果在dosfstimeset（）或日期/时间钩子程序里指定的秒数是带零头的，那么它四舍五入到下一个偶数。

dosfslib使用的日期和时间被初始为1998年1月1日，00：00：