1 /* $Id: vfat.h,v 1.58 2003/06/07 11:34:36 chorns Exp $ */
5 #define ROUND_UP(N, S) ((((N) + (S) - 1) / (S)) * (S))
6 #define ROUND_DOWN(N, S) ((N) - ((N) % (S)))
10 unsigned char magic0
, res0
, magic1
;
11 unsigned char OEMName
[8];
12 unsigned short BytesPerSector
;
13 unsigned char SectorsPerCluster
;
14 unsigned short ReservedSectors
;
15 unsigned char FATCount
;
16 unsigned short RootEntries
, Sectors
;
18 unsigned short FATSectors
, SectorsPerTrack
, Heads
;
19 unsigned long HiddenSectors
, SectorsHuge
;
20 unsigned char Drive
, Res1
, Sig
;
21 unsigned long VolumeID
;
22 unsigned char VolumeLabel
[11], SysType
[8];
23 unsigned char Res2
[446];
24 unsigned long Signatur1
;
25 } __attribute__((packed
));
29 unsigned char magic0
, res0
, magic1
; // 0
30 unsigned char OEMName
[8]; // 3
31 unsigned short BytesPerSector
; // 11
32 unsigned char SectorsPerCluster
; // 13
33 unsigned short ReservedSectors
; // 14
34 unsigned char FATCount
; // 16
35 unsigned short RootEntries
, Sectors
; // 17
36 unsigned char Media
; // 21
37 unsigned short FATSectors
, SectorsPerTrack
, Heads
; // 22
38 unsigned long HiddenSectors
, SectorsHuge
; // 28
39 unsigned long FATSectors32
; // 36
40 unsigned short ExtFlag
; // 40
41 unsigned short FSVersion
; // 42
42 unsigned long RootCluster
; // 44
43 unsigned short FSInfoSector
; // 48
44 unsigned short BootBackup
; // 50
45 unsigned char Res3
[12]; // 52
46 unsigned char Drive
; // 64
47 unsigned char Res4
; // 65
48 unsigned char ExtBootSignature
; // 66
49 unsigned long VolumeID
; // 67
50 unsigned char VolumeLabel
[11], SysType
[8]; // 71
51 unsigned char Res2
[418]; // 90
52 unsigned long Signature1
; // 508
53 } __attribute__((packed
));
57 unsigned long ExtBootSignature2
; // 0
58 unsigned char Res6
[480]; // 4
59 unsigned long FSINFOSignature
; // 484
60 unsigned long FreeCluster
; // 488
61 unsigned long NextCluster
; // 492
62 unsigned char Res7
[12]; // 496
63 unsigned long Signatur2
; // 508
64 } __attribute__((packed
));
66 typedef struct _BootSector BootSector
;
68 #define VFAT_CASE_LOWER_BASE 8 // base is lower case
69 #define VFAT_CASE_LOWER_EXT 16 // extension is lower case
73 unsigned char Filename
[8], Ext
[3];
76 unsigned char CreationTimeMs
;
77 unsigned short CreationTime
,CreationDate
,AccessDate
;
78 unsigned short FirstClusterHigh
; // higher
79 unsigned short UpdateTime
; //time create/update
80 unsigned short UpdateDate
; //date create/update
81 unsigned short FirstCluster
;
82 unsigned long FileSize
;
83 } __attribute__((packed
));
85 typedef struct _FATDirEntry FATDirEntry
, FAT_DIR_ENTRY
, *PFAT_DIR_ENTRY
;
89 unsigned char id
; // sequence number for slot
90 WCHAR name0_4
[5]; // first 5 characters in name
91 unsigned char attr
; // attribute byte
92 unsigned char reserved
; // always 0
93 unsigned char alias_checksum
; // checksum for 8.3 alias
94 WCHAR name5_10
[6]; // 6 more characters in name
95 unsigned char start
[2]; // starting cluster number
96 WCHAR name11_12
[2]; // last 2 characters in name
97 } __attribute__((packed
));
100 typedef struct _slot slot
;
102 #define BLOCKSIZE 512
108 #define VCB_VOLUME_LOCKED 0x0001
109 #define VCB_DISMOUNT_PENDING 0x0002
117 ULONG rootDirectorySectors
;
121 ULONG SectorsPerCluster
;
122 ULONG BytesPerSector
;
123 ULONG BytesPerCluster
;
124 ULONG NumberOfClusters
;
127 } FATINFO
, *PFATINFO
;
131 typedef struct _HASHENTRY
134 struct _VFATFCB
* self
;
135 struct _HASHENTRY
* next
;
139 #define FCB_HASH_TABLE_SIZE 1024
143 ERESOURCE DirResource
;
144 ERESOURCE FatResource
;
146 KSPIN_LOCK FcbListLock
;
147 LIST_ENTRY FcbListHead
;
149 PDEVICE_OBJECT StorageDevice
;
150 PFILE_OBJECT FATFileObject
;
152 ULONG LastAvailableCluster
;
153 ULONG AvailableClusters
;
154 BOOLEAN AvailableClustersValid
;
156 struct _VFATFCB
* VolumeFcb
;
157 struct _HASHENTRY
* FcbHashTable
[FCB_HASH_TABLE_SIZE
];
159 LIST_ENTRY VolumeListEntry
;
160 } DEVICE_EXTENSION
, *PDEVICE_EXTENSION
, VCB
, *PVCB
;
164 PDRIVER_OBJECT DriverObject
;
165 PDEVICE_OBJECT DeviceObject
;
167 ERESOURCE VolumeListLock
;
168 LIST_ENTRY VolumeListHead
;
169 NPAGED_LOOKASIDE_LIST FcbLookasideList
;
170 NPAGED_LOOKASIDE_LIST CcbLookasideList
;
171 NPAGED_LOOKASIDE_LIST IrpContextLookasideList
;
172 } VFAT_GLOBAL_DATA
, *PVFAT_GLOBAL_DATA
;
174 extern PVFAT_GLOBAL_DATA VfatGlobalData
;
176 #define FCB_CACHE_INITIALIZED 0x0001
177 #define FCB_DELETE_PENDING 0x0002
178 #define FCB_IS_FAT 0x0004
179 #define FCB_IS_PAGE_FILE 0x0008
180 #define FCB_IS_VOLUME 0x0010
182 typedef struct _VFATFCB
184 /* FCB header required by ROS/NT */
185 FSRTL_COMMON_FCB_HEADER RFCB
;
186 SECTION_OBJECT_POINTERS SectionObjectPointers
;
187 ERESOURCE MainResource
;
188 ERESOURCE PagingIoResource
;
189 /* end FCB header required by ROS/NT */
194 /* point on filename (250 chars max) in PathName */
197 /* path+filename 260 max */
198 WCHAR PathName
[MAX_PATH
];
200 /* short file name */
206 /* List of FCB's for this volume */
207 LIST_ENTRY FcbListEntry
;
209 /* pointer to the parent fcb */
210 struct _VFATFCB
* parentFcb
;
212 /* Flags for the fcb */
215 /* pointer to the file object which has initialized the fcb */
216 PFILE_OBJECT FileObject
;
218 /* Directory index for the short name entry */
221 /* Directory index where the long name starts */
224 /* Share access for the file object */
225 SHARE_ACCESS FCBShareAccess
;
227 /* Entry into the hash table for the path + long name */
230 /* Entry into the hash table for the path + short name */
233 /* List of byte-range locks for this file */
236 } VFATFCB
, *PVFATFCB
;
238 typedef struct _VFATCCB
240 LARGE_INTEGER CurrentByteOffset
;
241 /* for DirectoryControl */
243 /* for DirectoryControl */
244 PWCHAR DirectorySearchPattern
;
248 } VFATCCB
, *PVFATCCB
;
251 #define TAG(A, B, C, D) (ULONG)(((A)<<0) + ((B)<<8) + ((C)<<16) + ((D)<<24))
254 #define TAG_CCB TAG('V', 'C', 'C', 'B')
255 #define TAG_FCB TAG('V', 'F', 'C', 'B')
256 #define TAG_IRP TAG('V', 'I', 'R', 'P')
258 #define ENTRIES_PER_SECTOR (BLOCKSIZE / sizeof(FATDirEntry))
260 typedef struct __DOSTIME
268 typedef struct __DOSDATE
276 #define IRPCONTEXT_CANWAIT 0x0001
281 PDEVICE_OBJECT DeviceObject
;
282 PDEVICE_EXTENSION DeviceExt
;
284 WORK_QUEUE_ITEM WorkQueueItem
;
285 PIO_STACK_LOCATION Stack
;
288 PFILE_OBJECT FileObject
;
289 } VFAT_IRP_CONTEXT
, *PVFAT_IRP_CONTEXT
;
291 /* ------------------------------------------------------ shutdown.c */
293 NTSTATUS STDCALL
VfatShutdown (PDEVICE_OBJECT DeviceObject
,
296 /* -------------------------------------------------------- volume.c */
298 NTSTATUS
VfatQueryVolumeInformation (PVFAT_IRP_CONTEXT IrpContext
);
300 NTSTATUS
VfatSetVolumeInformation (PVFAT_IRP_CONTEXT IrpContext
);
302 /* ------------------------------------------------------ blockdev.c */
304 NTSTATUS
VfatReadDisk(IN PDEVICE_OBJECT pDeviceObject
,
305 IN PLARGE_INTEGER ReadOffset
,
309 NTSTATUS
VfatWriteDisk(IN PDEVICE_OBJECT pDeviceObject
,
310 IN PLARGE_INTEGER WriteOffset
,
311 IN ULONG WriteLength
,
314 NTSTATUS
VfatBlockDeviceIoControl (IN PDEVICE_OBJECT DeviceObject
,
316 IN PVOID InputBuffer
,
317 IN ULONG InputBufferSize
,
318 IN OUT PVOID OutputBuffer
,
319 IN OUT PULONG pOutputBufferSize
);
321 /* ----------------------------------------------------------- dir.c */
323 NTSTATUS
VfatDirectoryControl (PVFAT_IRP_CONTEXT
);
325 BOOL
FsdDosDateTimeToFileTime (WORD wDosDate
,
329 BOOL
FsdFileTimeToDosDateTime (TIME
*FileTime
,
333 /* -------------------------------------------------------- create.c */
335 NTSTATUS
VfatCreate (PVFAT_IRP_CONTEXT IrpContext
);
337 NTSTATUS
VfatOpenFile (PDEVICE_EXTENSION DeviceExt
,
338 PFILE_OBJECT FileObject
,
341 NTSTATUS
FindFile (PDEVICE_EXTENSION DeviceExt
,
348 VOID
vfat8Dot3ToString (PFAT_DIR_ENTRY pEntry
,
351 NTSTATUS
ReadVolumeLabel(PDEVICE_EXTENSION DeviceExt
,
354 BOOLEAN
IsDeletedEntry (PVOID Block
,
357 BOOLEAN
IsLastEntry (PVOID Block
,
360 /* --------------------------------------------------------- close.c */
362 NTSTATUS
VfatClose (PVFAT_IRP_CONTEXT IrpContext
);
364 NTSTATUS
VfatCloseFile(PDEVICE_EXTENSION DeviceExt
,
365 PFILE_OBJECT FileObject
);
367 /* ------------------------------------------------------- cleanup.c */
369 NTSTATUS
VfatCleanup (PVFAT_IRP_CONTEXT IrpContext
);
371 /* --------------------------------------------------------- fsctl.c */
373 NTSTATUS
VfatFileSystemControl (PVFAT_IRP_CONTEXT IrpContext
);
375 /* --------------------------------------------------------- finfo.c */
377 NTSTATUS
VfatQueryInformation (PVFAT_IRP_CONTEXT IrpContext
);
379 NTSTATUS
VfatSetInformation (PVFAT_IRP_CONTEXT IrpContext
);
382 VfatSetAllocationSizeInformation(PFILE_OBJECT FileObject
,
384 PDEVICE_EXTENSION DeviceExt
,
385 PLARGE_INTEGER AllocationSize
);
387 /* --------------------------------------------------------- iface.c */
389 NTSTATUS STDCALL
DriverEntry (PDRIVER_OBJECT DriverObject
,
390 PUNICODE_STRING RegistryPath
);
392 /* --------------------------------------------------------- dirwr.c */
394 NTSTATUS
VfatAddEntry (PDEVICE_EXTENSION DeviceExt
,
395 PFILE_OBJECT pFileObject
,
396 ULONG RequestedOptions
,UCHAR ReqAttr
);
398 NTSTATUS
VfatUpdateEntry (PDEVICE_EXTENSION DeviceExt
,
399 PFILE_OBJECT pFileObject
);
401 NTSTATUS
delEntry(PDEVICE_EXTENSION
,
404 /* -------------------------------------------------------- string.c */
406 BOOLEAN
wstrcmpjoki (PWSTR s1
,
409 PWCHAR
vfatGetNextPathElement (PWCHAR pFileName
);
411 VOID
vfatWSubString (PWCHAR pTarget
,
412 const PWCHAR pSource
,
415 BOOL
vfatIsFileNameValid (PWCHAR pFileName
);
417 /* ----------------------------------------------------------- fat.c */
419 NTSTATUS
OffsetToCluster (PDEVICE_EXTENSION DeviceExt
,
425 ULONGLONG
ClusterToSector (PDEVICE_EXTENSION DeviceExt
,
428 NTSTATUS
GetNextCluster (PDEVICE_EXTENSION DeviceExt
,
429 ULONG CurrentCluster
,
433 NTSTATUS
CountAvailableClusters (PDEVICE_EXTENSION DeviceExt
,
434 PLARGE_INTEGER Clusters
);
436 /* ------------------------------------------------------ direntry.c */
438 ULONG
vfatDirEntryGetFirstCluster (PDEVICE_EXTENSION pDeviceExt
,
439 PFAT_DIR_ENTRY pDirEntry
);
441 BOOL
vfatIsDirEntryDeleted (FATDirEntry
* pFatDirEntry
);
443 BOOL
vfatIsDirEntryVolume (FATDirEntry
* pFatDirEntry
);
445 BOOL
vfatIsDirEntryEndMarker (FATDirEntry
* pFatDirEntry
);
447 VOID
vfatGetDirEntryName (PFAT_DIR_ENTRY pDirEntry
,
450 NTSTATUS
vfatGetNextDirEntry(PVOID
* pContext
,
453 IN OUT PULONG pDirIndex
,
455 OUT PFAT_DIR_ENTRY pDirEntry
,
456 OUT PULONG pStartIndex
);
458 /* ----------------------------------------------------------- fcb.c */
460 PVFATFCB
vfatNewFCB (PWCHAR pFileName
);
462 VOID
vfatDestroyFCB (PVFATFCB pFCB
);
464 VOID
vfatGrabFCB (PDEVICE_EXTENSION pVCB
,
467 VOID
vfatReleaseFCB (PDEVICE_EXTENSION pVCB
,
470 VOID
vfatAddFCBToTable (PDEVICE_EXTENSION pVCB
,
473 PVFATFCB
vfatGrabFCBFromTable (PDEVICE_EXTENSION pDeviceExt
,
476 PVFATFCB
vfatMakeRootFCB (PDEVICE_EXTENSION pVCB
);
478 PVFATFCB
vfatOpenRootFCB (PDEVICE_EXTENSION pVCB
);
480 BOOL
vfatFCBIsDirectory (PVFATFCB FCB
);
482 NTSTATUS
vfatAttachFCBToFileObject (PDEVICE_EXTENSION vcb
,
484 PFILE_OBJECT fileObject
);
486 NTSTATUS
vfatDirFindFile (PDEVICE_EXTENSION pVCB
,
491 NTSTATUS
vfatGetFCBForFile (PDEVICE_EXTENSION pVCB
,
492 PVFATFCB
*pParentFCB
,
494 const PWSTR pFileName
);
496 NTSTATUS
vfatMakeFCBFromDirEntry (PVCB vcb
,
497 PVFATFCB directoryFCB
,
499 PFAT_DIR_ENTRY dirEntry
,
504 /* ------------------------------------------------------------ rw.c */
506 NTSTATUS
VfatRead (PVFAT_IRP_CONTEXT IrpContext
);
508 NTSTATUS
VfatWrite (PVFAT_IRP_CONTEXT IrpContext
);
510 NTSTATUS
NextCluster(PDEVICE_EXTENSION DeviceExt
,
512 PULONG CurrentCluster
,
515 /* ----------------------------------------------------------- misc.c */
517 NTSTATUS
VfatQueueRequest(PVFAT_IRP_CONTEXT IrpContext
);
519 PVFAT_IRP_CONTEXT
VfatAllocateIrpContext(PDEVICE_OBJECT DeviceObject
,
522 VOID
VfatFreeIrpContext(PVFAT_IRP_CONTEXT IrpContext
);
524 NTSTATUS STDCALL
VfatBuildRequest (PDEVICE_OBJECT DeviceObject
,
527 PVOID
VfatGetUserBuffer(IN PIRP
);
529 NTSTATUS
VfatLockUserBuffer(IN PIRP
, IN ULONG
,
533 VfatSetExtendedAttributes(PFILE_OBJECT FileObject
,
536 /* ------------------------------------------------------------- flush.c */
538 NTSTATUS
VfatFlush(PVFAT_IRP_CONTEXT IrpContext
);
540 NTSTATUS
VfatFlushVolume(PDEVICE_EXTENSION DeviceExt
, PVFATFCB VolumeFcb
);