reactos/drivers/fs/vfat/vfat.h

   1 /* $Id: vfat.h,v 1.56 2003/02/13 22:24:17 hbirr Exp $ */
   2
   3 #include <ddk/ntifs.h>
   4
   5 #define ROUND_UP(N, S) ((((N) + (S) - 1) / (S)) * (S))
   6 #define ROUND_DOWN(N, S) ((N) - ((N) % (S)))
   7
   8 struct _BootSector
   9 {
  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;
  17   unsigned char  Media;
  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));
  26
  27 struct _BootSector32
  28 {
  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));
  54
  55 struct _FsInfoSector
  56 {
  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));
  65
  66 typedef struct _BootSector BootSector;
  67
  68 #define VFAT_CASE_LOWER_BASE    8                       // base is lower case
  69 #define VFAT_CASE_LOWER_EXT     16                      // extension is lower case
  70
  71 struct _FATDirEntry
  72 {
  73   unsigned char  Filename[8], Ext[3];
  74   unsigned char  Attrib;
  75   unsigned char  lCase;
  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));
  84
  85 typedef struct _FATDirEntry FATDirEntry, FAT_DIR_ENTRY, *PFAT_DIR_ENTRY;
  86
  87 struct _slot
  88 {
  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));
  98
  99
 100 typedef struct _slot slot;
 101
 102 #define BLOCKSIZE 512
 103
 104 #define FAT16 (1)
 105 #define FAT12 (2)
 106 #define FAT32 (3)
 107
 108 #define VCB_VOLUME_LOCKED       0x0001
 109 #define VCB_DISMOUNT_PENDING    0x0002
 110
 111 typedef struct
 112 {
 113   ULONG VolumeID;
 114   ULONG FATStart;
 115   ULONG FATCount;
 116   ULONG FATSectors;
 117   ULONG rootDirectorySectors;
 118   ULONG rootStart;
 119   ULONG dataStart;
 120   ULONG RootCluster;
 121   ULONG SectorsPerCluster;
 122   ULONG BytesPerSector;
 123   ULONG BytesPerCluster;
 124   ULONG NumberOfClusters;
 125   ULONG FatType;
 126   ULONG Sectors;
 127 } FATINFO, *PFATINFO;
 128
 129 struct _VFATFCB;
 130
 131 typedef struct _HASHENTRY
 132 {
 133   ULONG Hash;
 134   struct _VFATFCB* self;
 135   struct _HASHENTRY* next;
 136 }
 137 HASHENTRY;
 138
 139 #define FCB_HASH_TABLE_SIZE 1024
 140
 141 typedef struct
 142 {
 143   ERESOURCE DirResource;
 144   ERESOURCE FatResource;
 145
 146   KSPIN_LOCK FcbListLock;
 147   LIST_ENTRY FcbListHead;
 148
 149   PDEVICE_OBJECT StorageDevice;
 150   PFILE_OBJECT FATFileObject;
 151   FATINFO FatInfo;
 152   ULONG LastAvailableCluster;
 153   ULONG AvailableClusters;
 154   BOOLEAN AvailableClustersValid;
 155   ULONG Flags;
 156   struct _VFATFCB * VolumeFcb;
 157   struct _HASHENTRY* FcbHashTable[FCB_HASH_TABLE_SIZE];
 158
 159   LIST_ENTRY VolumeListEntry;
 160 } DEVICE_EXTENSION, *PDEVICE_EXTENSION, VCB, *PVCB;
 161
 162 typedef struct
 163 {
 164   PDRIVER_OBJECT DriverObject;
 165   PDEVICE_OBJECT DeviceObject;
 166   ULONG Flags;
 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;
 173
 174 extern PVFAT_GLOBAL_DATA VfatGlobalData;
 175
 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
 181
 182 typedef struct _VFATFCB
 183 {
 184   /* FCB header required by ROS/NT */
 185   REACTOS_COMMON_FCB_HEADER RFCB;
 186   SECTION_OBJECT_POINTERS SectionObjectPointers;
 187   ERESOURCE MainResource;
 188   ERESOURCE PagingIoResource;
 189   /* end FCB header required by ROS/NT */
 190
 191   /* */
 192   FATDirEntry entry;
 193
 194   /* point on filename (250 chars max) in PathName */
 195   WCHAR *ObjectName;
 196
 197   /* path+filename 260 max */
 198   WCHAR PathName[MAX_PATH];
 199
 200   /* short file name */
 201   WCHAR ShortName[14];
 202
 203   /* */
 204   LONG RefCount;
 205
 206   /* List of FCB's for this volume */
 207   LIST_ENTRY FcbListEntry;
 208
 209   /* pointer to the parent fcb */
 210   struct _VFATFCB* parentFcb;
 211
 212   /* Flags for the fcb */
 213   ULONG Flags;
 214
 215   /* pointer to the file object which has initialized the fcb */
 216   PFILE_OBJECT FileObject;
 217
 218   /* Directory index for the short name entry */
 219   ULONG dirIndex;
 220
 221   /* Directory index where the long name starts */
 222   ULONG startIndex;
 223
 224   /* Share access for the file object */
 225   SHARE_ACCESS FCBShareAccess;
 226
 227   /* Entry into the hash table for the path + long name */
 228   HASHENTRY Hash;
 229
 230   /* Entry into the hash table for the path + short name */
 231   HASHENTRY ShortHash;
 232
 233   /* List of byte-range locks for this file */
 234   FILE_LOCK FileLock;
 235
 236   /* Structure members used only for paging files. */
 237   ULONG FatChainSize;
 238   PULONG FatChain;
 239 } VFATFCB, *PVFATFCB;
 240
 241 typedef struct _VFATCCB
 242 {
 243   LARGE_INTEGER  CurrentByteOffset;
 244   /* for DirectoryControl */
 245   ULONG Entry;
 246   /* for DirectoryControl */
 247   PWCHAR DirectorySearchPattern;
 248   ULONG LastCluster;
 249   ULONG LastOffset;
 250
 251 } VFATCCB, *PVFATCCB;
 252
 253 #ifndef TAG
 254 #define TAG(A, B, C, D) (ULONG)(((A)<<0) + ((B)<<8) + ((C)<<16) + ((D)<<24))
 255 #endif
 256
 257 #define TAG_CCB TAG('V', 'C', 'C', 'B')
 258 #define TAG_FCB TAG('V', 'F', 'C', 'B')
 259 #define TAG_IRP TAG('V', 'I', 'R', 'P')
 260
 261 #define ENTRIES_PER_SECTOR (BLOCKSIZE / sizeof(FATDirEntry))
 262
 263 typedef struct __DOSTIME
 264 {
 265    WORD Second:5;
 266    WORD Minute:6;
 267    WORD Hour:5;
 268 }
 269 DOSTIME, *PDOSTIME;
 270
 271 typedef struct __DOSDATE
 272 {
 273    WORD Day:5;
 274    WORD Month:4;
 275    WORD Year:5;
 276 }
 277 DOSDATE, *PDOSDATE;
 278
 279 #define IRPCONTEXT_CANWAIT  0x0001
 280
 281 typedef struct
 282 {
 283    PIRP Irp;
 284    PDEVICE_OBJECT DeviceObject;
 285    PDEVICE_EXTENSION DeviceExt;
 286    ULONG Flags;
 287    WORK_QUEUE_ITEM WorkQueueItem;
 288    PIO_STACK_LOCATION Stack;
 289    UCHAR MajorFunction;
 290    UCHAR MinorFunction;
 291    PFILE_OBJECT FileObject;
 292 } VFAT_IRP_CONTEXT, *PVFAT_IRP_CONTEXT;
 293
 294 /*  ------------------------------------------------------  shutdown.c  */
 295
 296 NTSTATUS STDCALL VfatShutdown (PDEVICE_OBJECT DeviceObject,
 297                                PIRP Irp);
 298
 299 /*  --------------------------------------------------------  volume.c  */
 300
 301 NTSTATUS VfatQueryVolumeInformation (PVFAT_IRP_CONTEXT IrpContext);
 302
 303 NTSTATUS VfatSetVolumeInformation (PVFAT_IRP_CONTEXT IrpContext);
 304
 305 /*  ------------------------------------------------------  blockdev.c  */
 306
 307 NTSTATUS VfatReadDisk(IN PDEVICE_OBJECT pDeviceObject,
 308                       IN PLARGE_INTEGER ReadOffset,
 309                       IN ULONG ReadLength,
 310                       IN PUCHAR Buffer);
 311
 312 NTSTATUS VfatWriteDisk(IN PDEVICE_OBJECT pDeviceObject,
 313                        IN PLARGE_INTEGER WriteOffset,
 314                        IN ULONG WriteLength,
 315                        IN PUCHAR Buffer);
 316
 317 NTSTATUS VfatBlockDeviceIoControl (IN PDEVICE_OBJECT DeviceObject,
 318                                    IN ULONG CtlCode,
 319                                    IN PVOID InputBuffer,
 320                                    IN ULONG InputBufferSize,
 321                                    IN OUT PVOID OutputBuffer,
 322                                    IN OUT PULONG pOutputBufferSize);
 323
 324 /*  -----------------------------------------------------------  dir.c  */
 325
 326 NTSTATUS VfatDirectoryControl (PVFAT_IRP_CONTEXT);
 327
 328 BOOL FsdDosDateTimeToFileTime (WORD wDosDate,
 329                                WORD wDosTime,
 330                                TIME *FileTime);
 331
 332 BOOL FsdFileTimeToDosDateTime (TIME *FileTime,
 333                                WORD *pwDosDate,
 334                                WORD *pwDosTime);
 335
 336 /*  --------------------------------------------------------  create.c  */
 337
 338 NTSTATUS VfatCreate (PVFAT_IRP_CONTEXT IrpContext);
 339
 340 NTSTATUS VfatOpenFile (PDEVICE_EXTENSION DeviceExt,
 341                        PFILE_OBJECT FileObject,
 342                        PWSTR FileName);
 343
 344 NTSTATUS FindFile (PDEVICE_EXTENSION DeviceExt,
 345                    PVFATFCB Fcb,
 346                    PVFATFCB Parent,
 347                    PWSTR FileToFind,
 348                    PULONG pDirIndex,
 349                    PULONG pDirIndex2);
 350
 351 VOID vfat8Dot3ToString (PFAT_DIR_ENTRY pEntry,
 352                         PWSTR pName);
 353
 354 NTSTATUS ReadVolumeLabel(PDEVICE_EXTENSION DeviceExt,
 355                          PVPB Vpb);
 356
 357 BOOLEAN IsDeletedEntry (PVOID Block,
 358                         ULONG Offset);
 359
 360 BOOLEAN IsLastEntry (PVOID Block,
 361                      ULONG Offset);
 362
 363 /*  ---------------------------------------------------------  close.c  */
 364
 365 NTSTATUS VfatClose (PVFAT_IRP_CONTEXT IrpContext);
 366
 367 NTSTATUS VfatCloseFile(PDEVICE_EXTENSION DeviceExt,
 368                        PFILE_OBJECT FileObject);
 369
 370 /*  -------------------------------------------------------  cleanup.c  */
 371
 372 NTSTATUS VfatCleanup (PVFAT_IRP_CONTEXT IrpContext);
 373
 374 /*  ---------------------------------------------------------  fsctl.c  */
 375
 376 NTSTATUS VfatFileSystemControl (PVFAT_IRP_CONTEXT IrpContext);
 377
 378 /*  ---------------------------------------------------------  finfo.c  */
 379
 380 NTSTATUS VfatQueryInformation (PVFAT_IRP_CONTEXT IrpContext);
 381
 382 NTSTATUS VfatSetInformation (PVFAT_IRP_CONTEXT IrpContext);
 383
 384 NTSTATUS
 385 VfatSetAllocationSizeInformation(PFILE_OBJECT FileObject,
 386                                  PVFATFCB Fcb,
 387                                  PDEVICE_EXTENSION DeviceExt,
 388                                  PLARGE_INTEGER AllocationSize);
 389
 390 /*  ---------------------------------------------------------  iface.c  */
 391
 392 NTSTATUS STDCALL DriverEntry (PDRIVER_OBJECT DriverObject,
 393                               PUNICODE_STRING RegistryPath);
 394
 395 /*  ---------------------------------------------------------  dirwr.c  */
 396
 397 NTSTATUS VfatAddEntry (PDEVICE_EXTENSION DeviceExt,
 398                        PFILE_OBJECT pFileObject,
 399                        ULONG RequestedOptions,UCHAR ReqAttr);
 400
 401 NTSTATUS VfatUpdateEntry (PDEVICE_EXTENSION DeviceExt,
 402                           PFILE_OBJECT pFileObject);
 403
 404 NTSTATUS delEntry(PDEVICE_EXTENSION,
 405                   PFILE_OBJECT);
 406
 407 /*  --------------------------------------------------------  string.c  */
 408
 409 BOOLEAN wstrcmpjoki (PWSTR s1,
 410                      PWSTR s2);
 411
 412 PWCHAR vfatGetNextPathElement (PWCHAR  pFileName);
 413
 414 VOID vfatWSubString (PWCHAR pTarget,
 415                      const PWCHAR pSource,
 416                      size_t pLength);
 417
 418 BOOL  vfatIsFileNameValid (PWCHAR pFileName);
 419
 420 /*  -----------------------------------------------------------  fat.c  */
 421
 422 NTSTATUS OffsetToCluster (PDEVICE_EXTENSION DeviceExt,
 423                           PVFATFCB Fcb,
 424                           ULONG FirstCluster,
 425                           ULONG FileOffset,
 426                           PULONG Cluster,
 427                           BOOLEAN Extend);
 428
 429 ULONGLONG ClusterToSector (PDEVICE_EXTENSION DeviceExt,
 430                            ULONG Cluster);
 431
 432 NTSTATUS GetNextCluster (PDEVICE_EXTENSION DeviceExt,
 433                          ULONG CurrentCluster,
 434                          PULONG NextCluster,
 435                          BOOLEAN Extend);
 436
 437 NTSTATUS CountAvailableClusters (PDEVICE_EXTENSION DeviceExt,
 438                                  PLARGE_INTEGER Clusters);
 439
 440 /*  ------------------------------------------------------  direntry.c  */
 441
 442 ULONG  vfatDirEntryGetFirstCluster (PDEVICE_EXTENSION  pDeviceExt,
 443                                     PFAT_DIR_ENTRY  pDirEntry);
 444
 445 BOOL  vfatIsDirEntryDeleted (FATDirEntry * pFatDirEntry);
 446
 447 BOOL  vfatIsDirEntryVolume (FATDirEntry * pFatDirEntry);
 448
 449 BOOL  vfatIsDirEntryEndMarker (FATDirEntry * pFatDirEntry);
 450
 451 VOID vfatGetDirEntryName (PFAT_DIR_ENTRY pDirEntry,
 452                           PWSTR  pEntryName);
 453
 454 NTSTATUS vfatGetNextDirEntry(PVOID * pContext,
 455                              PVOID * pPage,
 456                              IN PVFATFCB pDirFcb,
 457                              IN OUT PULONG pDirIndex,
 458                              OUT PWSTR pFileName,
 459                              OUT PFAT_DIR_ENTRY pDirEntry,
 460                              OUT PULONG pStartIndex);
 461
 462 /*  -----------------------------------------------------------  fcb.c  */
 463
 464 PVFATFCB vfatNewFCB (PWCHAR pFileName);
 465
 466 VOID vfatDestroyFCB (PVFATFCB  pFCB);
 467
 468 VOID vfatGrabFCB (PDEVICE_EXTENSION  pVCB,
 469                   PVFATFCB  pFCB);
 470
 471 VOID vfatReleaseFCB (PDEVICE_EXTENSION  pVCB,
 472                      PVFATFCB  pFCB);
 473
 474 VOID vfatAddFCBToTable (PDEVICE_EXTENSION  pVCB,
 475                         PVFATFCB  pFCB);
 476
 477 PVFATFCB vfatGrabFCBFromTable (PDEVICE_EXTENSION  pDeviceExt,
 478                                PWSTR  pFileName);
 479
 480 PVFATFCB vfatMakeRootFCB (PDEVICE_EXTENSION  pVCB);
 481
 482 PVFATFCB vfatOpenRootFCB (PDEVICE_EXTENSION  pVCB);
 483
 484 BOOL vfatFCBIsDirectory (PVFATFCB FCB);
 485
 486 NTSTATUS vfatAttachFCBToFileObject (PDEVICE_EXTENSION  vcb,
 487                                     PVFATFCB  fcb,
 488                                     PFILE_OBJECT  fileObject);
 489
 490 NTSTATUS vfatDirFindFile (PDEVICE_EXTENSION  pVCB,
 491                           PVFATFCB  parentFCB,
 492                           PWSTR  elementName,
 493                           PVFATFCB * fileFCB);
 494
 495 NTSTATUS vfatGetFCBForFile (PDEVICE_EXTENSION  pVCB,
 496                             PVFATFCB  *pParentFCB,
 497                             PVFATFCB  *pFCB,
 498                             const PWSTR  pFileName);
 499
 500 NTSTATUS vfatMakeFCBFromDirEntry (PVCB  vcb,
 501                                   PVFATFCB  directoryFCB,
 502                                   PWSTR  longName,
 503                                   PFAT_DIR_ENTRY  dirEntry,
 504                                   ULONG startIndex,
 505                                   ULONG dirIndex,
 506                                   PVFATFCB * fileFCB);
 507
 508 /*  ------------------------------------------------------------  rw.c  */
 509
 510 NTSTATUS VfatRead (PVFAT_IRP_CONTEXT IrpContext);
 511
 512 NTSTATUS VfatWrite (PVFAT_IRP_CONTEXT IrpContext);
 513
 514 NTSTATUS NextCluster(PDEVICE_EXTENSION DeviceExt,
 515                      PVFATFCB Fcb,
 516                      ULONG FirstCluster,
 517                      PULONG CurrentCluster,
 518                      BOOLEAN Extend);
 519
 520 /*  -----------------------------------------------------------  misc.c  */
 521
 522 NTSTATUS VfatQueueRequest(PVFAT_IRP_CONTEXT IrpContext);
 523
 524 PVFAT_IRP_CONTEXT VfatAllocateIrpContext(PDEVICE_OBJECT DeviceObject,
 525                                          PIRP Irp);
 526
 527 VOID VfatFreeIrpContext(PVFAT_IRP_CONTEXT IrpContext);
 528
 529 NTSTATUS STDCALL VfatBuildRequest (PDEVICE_OBJECT DeviceObject,
 530                                    PIRP Irp);
 531
 532 PVOID VfatGetUserBuffer(IN PIRP);
 533
 534 NTSTATUS VfatLockUserBuffer(IN PIRP, IN ULONG,
 535                             IN LOCK_OPERATION);
 536
 537 NTSTATUS
 538 VfatSetExtendedAttributes(PFILE_OBJECT FileObject,
 539                           PVOID Ea,
 540                           ULONG EaLength);
 541 /*  ------------------------------------------------------------- flush.c  */
 542
 543 NTSTATUS VfatFlush(PVFAT_IRP_CONTEXT IrpContext);
 544
 545 NTSTATUS VfatFlushVolume(PDEVICE_EXTENSION DeviceExt, PVFATFCB VolumeFcb);
 546
 547 /* EOF */