projects / reactos.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
history | raw | HEAD
[NTOSKRNL] Implement IoQueryFileDosDeviceName()
[reactos.git] / ntoskrnl / io / iomgr / file.c
1 /*
2 * PROJECT: ReactOS Kernel
3 * LICENSE: GPL - See COPYING in the top level directory
4 * FILE: ntoskrnl/io/iomgr/file.c
5 * PURPOSE: Functions that deal with managing the FILE_OBJECT itself.
6 * PROGRAMMERS: Alex Ionescu (alex.ionescu@reactos.org)
7 * Gunnar Dalsnes
8 * Eric Kohl
9 * Filip Navara (navaraf@reactos.org)
10 * Pierre Schweitzer
11 */
12
13 /* INCLUDES *****************************************************************/
14
15 #include <ntoskrnl.h>
16 #define NDEBUG
17 #include <debug.h>
18
19 extern ERESOURCE IopSecurityResource;
20
21 /* PRIVATE FUNCTIONS *********************************************************/
22
23 VOID
24 NTAPI
25 IopCheckBackupRestorePrivilege(IN PACCESS_STATE AccessState,
26 IN OUT PULONG CreateOptions,
27 IN KPROCESSOR_MODE PreviousMode,
28 IN ULONG Disposition)
29 {
30 ACCESS_MASK DesiredAccess, ReadAccess, WriteAccess;
31 PRIVILEGE_SET Privileges;
32 BOOLEAN AccessGranted, HaveBackupPriv = FALSE, CheckRestore = FALSE;
33 PAGED_CODE();
34
35 /* Don't do anything if privileges were checked already */
36 if (AccessState->Flags & SE_BACKUP_PRIVILEGES_CHECKED) return;
37
38 /* Check if the file was actually opened for backup purposes */
39 if (*CreateOptions & FILE_OPEN_FOR_BACKUP_INTENT)
40 {
41 /* Set the check flag since were doing it now */
42 AccessState->Flags |= SE_BACKUP_PRIVILEGES_CHECKED;
43
44 /* Set the access masks required */
45 ReadAccess = READ_CONTROL |
46 ACCESS_SYSTEM_SECURITY |
47 FILE_GENERIC_READ |
48 FILE_TRAVERSE;
49 WriteAccess = WRITE_DAC |
50 WRITE_OWNER |
51 ACCESS_SYSTEM_SECURITY |
52 FILE_GENERIC_WRITE |
53 FILE_ADD_FILE |
54 FILE_ADD_SUBDIRECTORY |
55 DELETE;
56 DesiredAccess = AccessState->RemainingDesiredAccess;
57
58 /* Check if desired access was the maximum */
59 if (DesiredAccess & MAXIMUM_ALLOWED)
60 {
61 /* Then add all the access masks required */
62 DesiredAccess |= (ReadAccess | WriteAccess);
63 }
64
65 /* Check if the file already exists */
66 if (Disposition & FILE_OPEN)
67 {
68 /* Check if desired access has the read mask */
69 if (ReadAccess & DesiredAccess)
70 {
71 /* Setup the privilege check lookup */
72 Privileges.PrivilegeCount = 1;
73 Privileges.Control = PRIVILEGE_SET_ALL_NECESSARY;
74 Privileges.Privilege[0].Luid = SeBackupPrivilege;
75 Privileges.Privilege[0].Attributes = 0;
76 AccessGranted = SePrivilegeCheck(&Privileges,
77 &AccessState->
78 SubjectSecurityContext,
79 PreviousMode);
80 if (AccessGranted)
81 {
82 /* Remember that backup was allowed */
83 HaveBackupPriv = TRUE;
84
85 /* Append the privileges and update the access state */
86 SeAppendPrivileges(AccessState, &Privileges);
87 AccessState->PreviouslyGrantedAccess |= (DesiredAccess & ReadAccess);
88 AccessState->RemainingDesiredAccess &= ~ReadAccess;
89 DesiredAccess &= ~ReadAccess;
90
91 /* Set backup privilege for the token */
92 AccessState->Flags |= TOKEN_HAS_BACKUP_PRIVILEGE;
93 }
94 }
95 }
96 else
97 {
98 /* Caller is creating the file, check restore privileges later */
99 CheckRestore = TRUE;
100 }
101
102 /* Check if caller wants write access or if it's creating a file */
103 if ((WriteAccess & DesiredAccess) || (CheckRestore))
104 {
105 /* Setup the privilege lookup and do it */
106 Privileges.PrivilegeCount = 1;
107 Privileges.Control = PRIVILEGE_SET_ALL_NECESSARY;
108 Privileges.Privilege[0].Luid = SeRestorePrivilege;
109 Privileges.Privilege[0].Attributes = 0;
110 AccessGranted = SePrivilegeCheck(&Privileges,
111 &AccessState->SubjectSecurityContext,
112 PreviousMode);
113 if (AccessGranted)
114 {
115 /* Remember that privilege was given */
116 HaveBackupPriv = TRUE;
117
118 /* Append the privileges and update the access state */
119 SeAppendPrivileges(AccessState, &Privileges);
120 AccessState->PreviouslyGrantedAccess |= (DesiredAccess & WriteAccess);
121 AccessState->RemainingDesiredAccess &= ~WriteAccess;
122
123 /* Set restore privilege for the token */
124 AccessState->Flags |= TOKEN_HAS_RESTORE_PRIVILEGE;
125 }
126 }
127
128 /* If we don't have the privilege, remove the option */
129 if (!HaveBackupPriv) *CreateOptions &= ~FILE_OPEN_FOR_BACKUP_INTENT;
130 }
131 }
132
133 NTSTATUS
134 NTAPI
135 IopCheckDeviceAndDriver(IN POPEN_PACKET OpenPacket,
136 IN PDEVICE_OBJECT DeviceObject)
137 {
138 /* Make sure the object is valid */
139 if ((IoGetDevObjExtension(DeviceObject)->ExtensionFlags &
140 (DOE_UNLOAD_PENDING |
141 DOE_DELETE_PENDING |
142 DOE_REMOVE_PENDING |
143 DOE_REMOVE_PROCESSED)) ||
144 (DeviceObject->Flags & DO_DEVICE_INITIALIZING))
145 {
146 /* It's unloading or initializing, so fail */
147 DPRINT1("You are seeing this because the following ROS driver: %wZ\n"
148 " sucks. Please fix it's AddDevice Routine\n",
149 &DeviceObject->DriverObject->DriverName);
150 return STATUS_NO_SUCH_DEVICE;
151 }
152 else if ((DeviceObject->Flags & DO_EXCLUSIVE) &&
153 (DeviceObject->ReferenceCount) &&
154 !(OpenPacket->RelatedFileObject) &&
155 !(OpenPacket->Options & IO_ATTACH_DEVICE))
156 {
157 return STATUS_ACCESS_DENIED;
158 }
159
160 else
161 {
162 /* Increase reference count */
163 InterlockedIncrement(&DeviceObject->ReferenceCount);
164 return STATUS_SUCCESS;
165 }
166 }
167
168 VOID
169 NTAPI
170 IopDoNameTransmogrify(IN PIRP Irp,
171 IN PFILE_OBJECT FileObject,
172 IN PREPARSE_DATA_BUFFER DataBuffer)
173 {
174 PWSTR Buffer;
175 USHORT Length;
176 USHORT RequiredLength;
177 PWSTR NewBuffer;
178
179 PAGED_CODE();
180
181 ASSERT(Irp->IoStatus.Status == STATUS_REPARSE);
182 ASSERT(Irp->IoStatus.Information == IO_REPARSE_TAG_MOUNT_POINT);
183 ASSERT(Irp->Tail.Overlay.AuxiliaryBuffer != NULL);
184 ASSERT(DataBuffer != NULL);
185 ASSERT(DataBuffer->ReparseTag == IO_REPARSE_TAG_MOUNT_POINT);
186 ASSERT(DataBuffer->ReparseDataLength < MAXIMUM_REPARSE_DATA_BUFFER_SIZE);
187 ASSERT(DataBuffer->Reserved < MAXIMUM_REPARSE_DATA_BUFFER_SIZE);
188
189 /* First of all, validate data */
190 if (DataBuffer->ReparseDataLength < REPARSE_DATA_BUFFER_HEADER_SIZE ||
191 (DataBuffer->SymbolicLinkReparseBuffer.PrintNameLength +
192 DataBuffer->SymbolicLinkReparseBuffer.SubstituteNameLength +
193 FIELD_OFFSET(REPARSE_DATA_BUFFER, MountPointReparseBuffer.PathBuffer[0])) > MAXIMUM_REPARSE_DATA_BUFFER_SIZE)
194 {
195 Irp->IoStatus.Status = STATUS_IO_REPARSE_DATA_INVALID;
196 }
197
198 /* Everything went right */
199 if (NT_SUCCESS(Irp->IoStatus.Status))
200 {
201 /* Compute buffer & length */
202 Buffer = (PWSTR)((ULONG_PTR)DataBuffer->MountPointReparseBuffer.PathBuffer +
203 DataBuffer->MountPointReparseBuffer.SubstituteNameOffset);
204 Length = DataBuffer->MountPointReparseBuffer.SubstituteNameLength;
205
206 /* Check we don't overflow */
207 if (((ULONG)MAXUSHORT - DataBuffer->Reserved) <= (Length + sizeof(UNICODE_NULL)))
208 {
209 Irp->IoStatus.Status = STATUS_IO_REPARSE_DATA_INVALID;
210 }
211 else
212 {
213 /* Compute how much mem we'll need */
214 RequiredLength = DataBuffer->Reserved + Length + sizeof(UNICODE_NULL);
215
216 /* Check if FileObject can already hold what we need */
217 if (FileObject->FileName.MaximumLength >= RequiredLength)
218 {
219 NewBuffer = FileObject->FileName.Buffer;
220 }
221 else
222 {
223 /* Allocate otherwise */
224 NewBuffer = ExAllocatePoolWithTag(PagedPool, RequiredLength, TAG_IO_NAME);
225 if (NewBuffer == NULL)
226 {
227 Irp->IoStatus.Status = STATUS_INSUFFICIENT_RESOURCES;
228 }
229 }
230 }
231 }
232
233 /* Everything went right */
234 if (NT_SUCCESS(Irp->IoStatus.Status))
235 {
236 /* Copy reserved */
237 if (DataBuffer->Reserved)
238 {
239 RtlMoveMemory((PWSTR)((ULONG_PTR)NewBuffer + Length),
240 (PWSTR)((ULONG_PTR)FileObject->FileName.Buffer + FileObject->FileName.Length - DataBuffer->Reserved),
241 DataBuffer->Reserved);
242 }
243
244 /* Then, buffer */
245 if (Length)
246 {
247 RtlCopyMemory(NewBuffer, Buffer, Length);
248 }
249
250 /* And finally replace buffer if new one was allocated */
251 FileObject->FileName.Length = RequiredLength - sizeof(UNICODE_NULL);
252 if (NewBuffer != FileObject->FileName.Buffer)
253 {
254 if (FileObject->FileName.Buffer)
255 {
256 ExFreePoolWithTag(FileObject->FileName.Buffer, TAG_IO_NAME);
257 }
258
259 FileObject->FileName.Buffer = NewBuffer;
260 FileObject->FileName.MaximumLength = RequiredLength;
261 FileObject->FileName.Buffer[RequiredLength / sizeof(WCHAR) - 1] = UNICODE_NULL;
262 }
263 }
264
265 /* We don't need them anymore - it was allocated by the driver */
266 ExFreePool(DataBuffer);
267 }
268
269 NTSTATUS
270 NTAPI
271 IopParseDevice(IN PVOID ParseObject,
272 IN PVOID ObjectType,
273 IN OUT PACCESS_STATE AccessState,
274 IN KPROCESSOR_MODE AccessMode,
275 IN ULONG Attributes,
276 IN OUT PUNICODE_STRING CompleteName,
277 IN OUT PUNICODE_STRING RemainingName,
278 IN OUT PVOID Context,
279 IN PSECURITY_QUALITY_OF_SERVICE SecurityQos OPTIONAL,
280 OUT PVOID *Object)
281 {
282 POPEN_PACKET OpenPacket = (POPEN_PACKET)Context;
283 PDEVICE_OBJECT OriginalDeviceObject = (PDEVICE_OBJECT)ParseObject;
284 PDEVICE_OBJECT DeviceObject, OwnerDevice;
285 NTSTATUS Status;
286 PFILE_OBJECT FileObject;
287 PVPB Vpb = NULL;
288 PIRP Irp;
289 PIO_STACK_LOCATION StackLoc;
290 IO_SECURITY_CONTEXT SecurityContext;
291 IO_STATUS_BLOCK IoStatusBlock;
292 BOOLEAN DirectOpen = FALSE, OpenCancelled, UseDummyFile;
293 OBJECT_ATTRIBUTES ObjectAttributes;
294 KIRQL OldIrql;
295 PDUMMY_FILE_OBJECT LocalFileObject;
296 PFILE_BASIC_INFORMATION FileBasicInfo;
297 ULONG ReturnLength;
298 KPROCESSOR_MODE CheckMode;
299 BOOLEAN VolumeOpen = FALSE;
300 ACCESS_MASK DesiredAccess, GrantedAccess;
301 BOOLEAN AccessGranted, LockHeld = FALSE;
302 PPRIVILEGE_SET Privileges = NULL;
303 UNICODE_STRING FileString;
304 USHORT Attempt;
305 IOTRACE(IO_FILE_DEBUG, "ParseObject: %p. RemainingName: %wZ\n",
306 ParseObject, RemainingName);
307
308 for (Attempt = 0; Attempt < IOP_MAX_REPARSE_TRAVERSAL; ++Attempt)
309 {
310 /* Assume failure */
311 *Object = NULL;
312
313 /* Validate the open packet */
314 if (!IopValidateOpenPacket(OpenPacket)) return STATUS_OBJECT_TYPE_MISMATCH;
315
316 /* Valide reparse point in case we traversed a mountpoint */
317 if (OpenPacket->TraversedMountPoint)
318 {
319 /* This is a reparse point we understand */
320 ASSERT(OpenPacket->Information == IO_REPARSE_TAG_MOUNT_POINT);
321
322 /* Make sure we're dealing with correct DO */
323 if (OriginalDeviceObject->DeviceType != FILE_DEVICE_DISK &&
324 OriginalDeviceObject->DeviceType != FILE_DEVICE_CD_ROM &&
325 OriginalDeviceObject->DeviceType != FILE_DEVICE_VIRTUAL_DISK &&
326 OriginalDeviceObject->DeviceType != FILE_DEVICE_TAPE)
327 {
328 OpenPacket->FinalStatus = STATUS_IO_REPARSE_DATA_INVALID;
329 return STATUS_IO_REPARSE_DATA_INVALID;
330 }
331 }
332
333 /* Check if we have a related file object */
334 if (OpenPacket->RelatedFileObject)
335 {
336 /* Use the related file object's device object */
337 OriginalDeviceObject = OpenPacket->RelatedFileObject->DeviceObject;
338 }
339
340 /* Validate device status */
341 Status = IopCheckDeviceAndDriver(OpenPacket, OriginalDeviceObject);
342 if (!NT_SUCCESS(Status))
343 {
344 /* We failed, return status */
345 OpenPacket->FinalStatus = Status;
346 return Status;
347 }
348
349 /* Map the generic mask and set the new mapping in the access state */
350 RtlMapGenericMask(&AccessState->RemainingDesiredAccess,
351 &IoFileObjectType->TypeInfo.GenericMapping);
352 RtlMapGenericMask(&AccessState->OriginalDesiredAccess,
353 &IoFileObjectType->TypeInfo.GenericMapping);
354 SeSetAccessStateGenericMapping(AccessState,
355 &IoFileObjectType->TypeInfo.GenericMapping);
356 DesiredAccess = AccessState->RemainingDesiredAccess;
357
358 /* Check what kind of access checks to do */
359 if ((AccessMode != KernelMode) ||
360 (OpenPacket->Options & IO_FORCE_ACCESS_CHECK))
361 {
362 /* Call is from user-mode or kernel is forcing checks */
363 CheckMode = UserMode;
364 }
365 else
366 {
367 /* Call is from the kernel */
368 CheckMode = KernelMode;
369 }
370
371 /* Check privilege for backup or restore operation */
372 IopCheckBackupRestorePrivilege(AccessState,
373 &OpenPacket->CreateOptions,
374 CheckMode,
375 OpenPacket->Disposition);
376
377 /* Check if we are re-parsing */
378 if (((OpenPacket->Override) && !(RemainingName->Length)) ||
379 (AccessState->Flags & SE_BACKUP_PRIVILEGES_CHECKED))
380 {
381 /* Get granted access from the last call */
382 DesiredAccess |= AccessState->PreviouslyGrantedAccess;
383 }
384
385 /* Check if this is a volume open */
386 if ((OpenPacket->RelatedFileObject) &&
387 (OpenPacket->RelatedFileObject->Flags & FO_VOLUME_OPEN) &&
388 !(RemainingName->Length))
389 {
390 /* It is */
391 VolumeOpen = TRUE;
392 }
393
394 /* Now check if we need access checks */
395 if (((AccessMode != KernelMode) ||
396 (OpenPacket->Options & IO_FORCE_ACCESS_CHECK)) &&
397 (!(OpenPacket->RelatedFileObject) || (VolumeOpen)) &&
398 !(OpenPacket->Override))
399 {
400 KeEnterCriticalRegion();
401 ExAcquireResourceSharedLite(&IopSecurityResource, TRUE);
402
403 /* Check if a device object is being parsed */
404 if (!RemainingName->Length)
405 {
406 /* Lock the subject context */
407 SeLockSubjectContext(&AccessState->SubjectSecurityContext);
408 LockHeld = TRUE;
409
410 /* Do access check */
411 AccessGranted = SeAccessCheck(OriginalDeviceObject->
412 SecurityDescriptor,
413 &AccessState->SubjectSecurityContext,
414 LockHeld,
415 DesiredAccess,
416 0,
417 &Privileges,
418 &IoFileObjectType->
419 TypeInfo.GenericMapping,
420 UserMode,
421 &GrantedAccess,
422 &Status);
423 if (Privileges)
424 {
425 /* Append and free the privileges */
426 SeAppendPrivileges(AccessState, Privileges);
427 SeFreePrivileges(Privileges);
428 }
429
430 /* Check if we got access */
431 if (AccessGranted)
432 {
433 /* Update access state */
434 AccessState->PreviouslyGrantedAccess |= GrantedAccess;
435 AccessState->RemainingDesiredAccess &= ~(GrantedAccess |
436 MAXIMUM_ALLOWED);
437 OpenPacket->Override= TRUE;
438 }
439
440 FileString.Length = 8;
441 FileString.MaximumLength = 8;
442 FileString.Buffer = L"File";
443
444 /* Do Audit/Alarm for open operation */
445 SeOpenObjectAuditAlarm(&FileString,
446 OriginalDeviceObject,
447 CompleteName,
448 OriginalDeviceObject->SecurityDescriptor,
449 AccessState,
450 FALSE,
451 AccessGranted,
452 UserMode,
453 &AccessState->GenerateOnClose);
454 }
455 else
456 {
457 /* Check if we need to do traverse validation */
458 if (!(AccessState->Flags & TOKEN_HAS_TRAVERSE_PRIVILEGE) ||
459 ((OriginalDeviceObject->DeviceType == FILE_DEVICE_DISK) ||
460 (OriginalDeviceObject->DeviceType == FILE_DEVICE_CD_ROM)))
461 {
462 /* Check if this is a restricted token */
463 if (!(AccessState->Flags & TOKEN_IS_RESTRICTED))
464 {
465 /* Do the FAST traverse check */
466 AccessGranted = SeFastTraverseCheck(OriginalDeviceObject->SecurityDescriptor,
467 AccessState,
468 FILE_TRAVERSE,
469 UserMode);
470 }
471 else
472 {
473 /* Fail */
474 AccessGranted = FALSE;
475 }
476
477 /* Check if we failed to get access */
478 if (!AccessGranted)
479 {
480 /* Lock the subject context */
481 SeLockSubjectContext(&AccessState->SubjectSecurityContext);
482 LockHeld = TRUE;
483
484 /* Do access check */
485 AccessGranted = SeAccessCheck(OriginalDeviceObject->
486 SecurityDescriptor,
487 &AccessState->SubjectSecurityContext,
488 LockHeld,
489 FILE_TRAVERSE,
490 0,
491 &Privileges,
492 &IoFileObjectType->
493 TypeInfo.GenericMapping,
494 UserMode,
495 &GrantedAccess,
496 &Status);
497 if (Privileges)
498 {
499 /* Append and free the privileges */
500 SeAppendPrivileges(AccessState, Privileges);
501 SeFreePrivileges(Privileges);
502 }
503 }
504
505 /* FIXME: Do Audit/Alarm for traverse check */
506 }
507 else
508 {
509 /* Access automatically granted */
510 AccessGranted = TRUE;
511 }
512 }
513
514 ExReleaseResourceLite(&IopSecurityResource);
515 KeLeaveCriticalRegion();
516
517 /* Check if we hold the lock */
518 if (LockHeld)
519 {
520 /* Release it */
521 SeUnlockSubjectContext(&AccessState->SubjectSecurityContext);
522 }
523
524 /* Check if access failed */
525 if (!AccessGranted)
526 {
527 /* Dereference the device and fail */
528 DPRINT1("Traverse access failed!\n");
529 IopDereferenceDeviceObject(OriginalDeviceObject, FALSE);
530 return STATUS_ACCESS_DENIED;
531 }
532 }
533
534 /* Check if we can simply use a dummy file */
535 UseDummyFile = ((OpenPacket->QueryOnly) || (OpenPacket->DeleteOnly));
536
537 #if 1
538 /* FIXME: Small hack still exists, have to check why...
539 * This is triggered multiple times by usetup and then once per boot.
540 */
541 if (ExpInTextModeSetup &&
542 !(DirectOpen) &&
543 !(RemainingName->Length) &&
544 !(OpenPacket->RelatedFileObject) &&
545 ((wcsstr(CompleteName->Buffer, L"Harddisk")) ||
546 (wcsstr(CompleteName->Buffer, L"Floppy"))) &&
547 !(UseDummyFile))
548 {
549 DPRINT1("Using IopParseDevice() hack. Requested invalid attributes: %lx\n",
550 DesiredAccess & ~(SYNCHRONIZE |
551 FILE_READ_ATTRIBUTES |
552 READ_CONTROL |
553 ACCESS_SYSTEM_SECURITY |
554 WRITE_OWNER |
555 WRITE_DAC));
556 DirectOpen = TRUE;
557 }
558 #endif
559
560 /* Check if this is a direct open */
561 if (!(RemainingName->Length) &&
562 !(OpenPacket->RelatedFileObject) &&
563 ((DesiredAccess & ~(SYNCHRONIZE |
564 FILE_READ_ATTRIBUTES |
565 READ_CONTROL |
566 ACCESS_SYSTEM_SECURITY |
567 WRITE_OWNER |
568 WRITE_DAC)) == 0) &&
569 !(UseDummyFile))
570 {
571 /* Remember this for later */
572 DirectOpen = TRUE;
573 }
574
575 /* Check if we have a related FO that wasn't a direct open */
576 if ((OpenPacket->RelatedFileObject) &&
577 !(OpenPacket->RelatedFileObject->Flags & FO_DIRECT_DEVICE_OPEN))
578 {
579 /* The device object is the one we were given */
580 DeviceObject = ParseObject;
581
582 /* Check if the related FO had a VPB */
583 if (OpenPacket->RelatedFileObject->Vpb)
584 {
585 /* Yes, remember it */
586 Vpb = OpenPacket->RelatedFileObject->Vpb;
587
588 /* Reference it */
589 InterlockedIncrement((PLONG)&Vpb->ReferenceCount);
590
591 /* Check if we were given a specific top level device to use */
592 if (OpenPacket->InternalFlags & IOP_USE_TOP_LEVEL_DEVICE_HINT)
593 {
594 DeviceObject = Vpb->DeviceObject;
595 }
596 }
597 }
598 else
599 {
600 /* Check if it has a VPB */
601 if ((OriginalDeviceObject->Vpb) && !(DirectOpen))
602 {
603 /* Check if the VPB is mounted, and mount it */
604 Vpb = IopCheckVpbMounted(OpenPacket,
605 OriginalDeviceObject,
606 RemainingName,
607 &Status);
608 if (!Vpb) return Status;
609
610 /* Get the VPB's device object */
611 DeviceObject = Vpb->DeviceObject;
612 }
613 else
614 {
615 /* The device object is the one we were given */
616 DeviceObject = OriginalDeviceObject;
617 }
618
619 /* If we weren't given a specific top level device, look for an attached device */
620 if (!(OpenPacket->InternalFlags & IOP_USE_TOP_LEVEL_DEVICE_HINT) &&
621 DeviceObject->AttachedDevice)
622 {
623 /* Get the attached device */
624 DeviceObject = IoGetAttachedDevice(DeviceObject);
625 }
626 }
627
628 if (OpenPacket->InternalFlags & IOP_USE_TOP_LEVEL_DEVICE_HINT)
629 {
630 // FIXME: Verify our device object is good to use
631 ASSERT(DirectOpen == FALSE);
632 }
633
634 /* If we traversed a mount point, reset the information */
635 if (OpenPacket->TraversedMountPoint)
636 {
637 OpenPacket->TraversedMountPoint = FALSE;
638 }
639
640 /* Check if this is a secure FSD */
641 if ((DeviceObject->Characteristics & FILE_DEVICE_SECURE_OPEN) &&
642 ((OpenPacket->RelatedFileObject) || (RemainingName->Length)) &&
643 (!VolumeOpen))
644 {
645 Privileges = NULL;
646 GrantedAccess = 0;
647
648 KeEnterCriticalRegion();
649 ExAcquireResourceSharedLite(&IopSecurityResource, TRUE);
650
651 /* Lock the subject context */
652 SeLockSubjectContext(&AccessState->SubjectSecurityContext);
653
654 /* Do access check */
655 AccessGranted = SeAccessCheck(OriginalDeviceObject->SecurityDescriptor,
656 &AccessState->SubjectSecurityContext,
657 TRUE,
658 DesiredAccess,
659 0,
660 &Privileges,
661 &IoFileObjectType->TypeInfo.GenericMapping,
662 UserMode,
663 &GrantedAccess,
664 &Status);
665 if (Privileges != NULL)
666 {
667 /* Append and free the privileges */
668 SeAppendPrivileges(AccessState, Privileges);
669 SeFreePrivileges(Privileges);
670 }
671
672 /* Check if we got access */
673 if (GrantedAccess)
674 {
675 AccessState->PreviouslyGrantedAccess |= GrantedAccess;
676 AccessState->RemainingDesiredAccess &= ~(GrantedAccess | MAXIMUM_ALLOWED);
677 }
678
679 FileString.Length = 8;
680 FileString.MaximumLength = 8;
681 FileString.Buffer = L"File";
682
683 /* Do Audit/Alarm for open operation
684 * NOTA: we audit target device object
685 */
686 SeOpenObjectAuditAlarm(&FileString,
687 DeviceObject,
688 CompleteName,
689 OriginalDeviceObject->SecurityDescriptor,
690 AccessState,
691 FALSE,
692 AccessGranted,
693 UserMode,
694 &AccessState->GenerateOnClose);
695
696 SeUnlockSubjectContext(&AccessState->SubjectSecurityContext);
697
698 ExReleaseResourceLite(&IopSecurityResource);
699 KeLeaveCriticalRegion();
700
701 /* Check if access failed */
702 if (!AccessGranted)
703 {
704 /* Dereference the device and fail */
705 IopDereferenceDeviceObject(OriginalDeviceObject, FALSE);
706 if (Vpb) IopDereferenceVpbAndFree(Vpb);
707 return STATUS_ACCESS_DENIED;
708 }
709 }
710
711 /* Allocate the IRP */
712 Irp = IoAllocateIrp(DeviceObject->StackSize, TRUE);
713 if (!Irp)
714 {
715 /* Dereference the device and VPB, then fail */
716 IopDereferenceDeviceObject(OriginalDeviceObject, FALSE);
717 if (Vpb) IopDereferenceVpbAndFree(Vpb);
718 return STATUS_INSUFFICIENT_RESOURCES;
719 }
720
721 /* Now set the IRP data */
722 Irp->RequestorMode = AccessMode;
723 Irp->Flags = IRP_CREATE_OPERATION | IRP_SYNCHRONOUS_API | IRP_DEFER_IO_COMPLETION;
724 Irp->Tail.Overlay.Thread = PsGetCurrentThread();
725 Irp->UserIosb = &IoStatusBlock;
726 Irp->MdlAddress = NULL;
727 Irp->PendingReturned = FALSE;
728 Irp->UserEvent = NULL;
729 Irp->Cancel = FALSE;
730 Irp->CancelRoutine = NULL;
731 Irp->Tail.Overlay.AuxiliaryBuffer = NULL;
732
733 /* Setup the security context */
734 SecurityContext.SecurityQos = SecurityQos;
735 SecurityContext.AccessState = AccessState;
736 SecurityContext.DesiredAccess = AccessState->RemainingDesiredAccess;
737 SecurityContext.FullCreateOptions = OpenPacket->CreateOptions;
738
739 /* Get the I/O Stack location */
740 StackLoc = IoGetNextIrpStackLocation(Irp);
741 StackLoc->Control = 0;
742
743 /* Check what kind of file this is */
744 switch (OpenPacket->CreateFileType)
745 {
746 /* Normal file */
747 case CreateFileTypeNone:
748
749 /* Set the major function and EA Length */
750 StackLoc->MajorFunction = IRP_MJ_CREATE;
751 StackLoc->Parameters.Create.EaLength = OpenPacket->EaLength;
752
753 /* Set the flags */
754 StackLoc->Flags = (UCHAR)OpenPacket->Options;
755 StackLoc->Flags |= !(Attributes & OBJ_CASE_INSENSITIVE) ? SL_CASE_SENSITIVE: 0;
756 break;
757
758 /* Named pipe */
759 case CreateFileTypeNamedPipe:
760
761 /* Set the named pipe MJ and set the parameters */
762 StackLoc->MajorFunction = IRP_MJ_CREATE_NAMED_PIPE;
763 StackLoc->Parameters.CreatePipe.Parameters = OpenPacket->ExtraCreateParameters;
764 break;
765
766 /* Mailslot */
767 case CreateFileTypeMailslot:
768
769 /* Set the mailslot MJ and set the parameters */
770 StackLoc->MajorFunction = IRP_MJ_CREATE_MAILSLOT;
771 StackLoc->Parameters.CreateMailslot.Parameters = OpenPacket->ExtraCreateParameters;
772 break;
773 }
774
775 /* Set the common data */
776 Irp->Overlay.AllocationSize = OpenPacket->AllocationSize;
777 Irp->AssociatedIrp.SystemBuffer = OpenPacket->EaBuffer;
778 StackLoc->Parameters.Create.Options = (OpenPacket->Disposition << 24) |
779 (OpenPacket->CreateOptions &
780 0xFFFFFF);
781 StackLoc->Parameters.Create.FileAttributes = OpenPacket->FileAttributes;
782 StackLoc->Parameters.Create.ShareAccess = OpenPacket->ShareAccess;
783 StackLoc->Parameters.Create.SecurityContext = &SecurityContext;
784
785 /* Check if we really need to create an object */
786 if (!UseDummyFile)
787 {
788 ULONG ObjectSize = sizeof(FILE_OBJECT);
789
790 /* Tag on space for a file object extension */
791 if (OpenPacket->InternalFlags & IOP_CREATE_FILE_OBJECT_EXTENSION)
792 ObjectSize += sizeof(FILE_OBJECT_EXTENSION);
793
794 /* Create the actual file object */
795 InitializeObjectAttributes(&ObjectAttributes,
796 NULL,
797 Attributes,
798 NULL,
799 NULL);
800 Status = ObCreateObject(KernelMode,
801 IoFileObjectType,
802 &ObjectAttributes,
803 AccessMode,
804 NULL,
805 ObjectSize,
806 0,
807 0,
808 (PVOID*)&FileObject);
809 if (!NT_SUCCESS(Status))
810 {
811 /* Create failed, free the IRP */
812 IoFreeIrp(Irp);
813
814 /* Dereference the device and VPB */
815 IopDereferenceDeviceObject(OriginalDeviceObject, FALSE);
816 if (Vpb) IopDereferenceVpbAndFree(Vpb);
817
818 /* We failed, return status */
819 OpenPacket->FinalStatus = Status;
820 return Status;
821 }
822
823 /* Clear the file object */
824 RtlZeroMemory(FileObject, sizeof(FILE_OBJECT));
825
826 /* Check if this is Synch I/O */
827 if (OpenPacket->CreateOptions &
828 (FILE_SYNCHRONOUS_IO_ALERT | FILE_SYNCHRONOUS_IO_NONALERT))
829 {
830 /* Set the synch flag */
831 FileObject->Flags |= FO_SYNCHRONOUS_IO;
832
833 /* Check if it's also alertable */
834 if (OpenPacket->CreateOptions & FILE_SYNCHRONOUS_IO_ALERT)
835 {
836 /* It is, set the alertable flag */
837 FileObject->Flags |= FO_ALERTABLE_IO;
838 }
839 }
840
841 /* Check if this is synch I/O */
842 if (FileObject->Flags & FO_SYNCHRONOUS_IO)
843 {
844 /* Initialize the event */
845 KeInitializeEvent(&FileObject->Lock, SynchronizationEvent, FALSE);
846 }
847
848 /* Check if the caller requested no intermediate buffering */
849 if (OpenPacket->CreateOptions & FILE_NO_INTERMEDIATE_BUFFERING)
850 {
851 /* Set the correct flag for the FSD to read */
852 FileObject->Flags |= FO_NO_INTERMEDIATE_BUFFERING;
853 }
854
855 /* Check if the caller requested write through support */
856 if (OpenPacket->CreateOptions & FILE_WRITE_THROUGH)
857 {
858 /* Set the correct flag for the FSD to read */
859 FileObject->Flags |= FO_WRITE_THROUGH;
860 }
861
862 /* Check if the caller says the file will be only read sequentially */
863 if (OpenPacket->CreateOptions & FILE_SEQUENTIAL_ONLY)
864 {
865 /* Set the correct flag for the FSD to read */
866 FileObject->Flags |= FO_SEQUENTIAL_ONLY;
867 }
868
869 /* Check if the caller believes the file will be only read randomly */
870 if (OpenPacket->CreateOptions & FILE_RANDOM_ACCESS)
871 {
872 /* Set the correct flag for the FSD to read */
873 FileObject->Flags |= FO_RANDOM_ACCESS;
874 }
875
876 /* Check if we were asked to setup a file object extension */
877 if (OpenPacket->InternalFlags & IOP_CREATE_FILE_OBJECT_EXTENSION)
878 {
879 PFILE_OBJECT_EXTENSION FileObjectExtension;
880
881 /* Make sure the file object knows it has an extension */
882 FileObject->Flags |= FO_FILE_OBJECT_HAS_EXTENSION;
883
884 FileObjectExtension = (PFILE_OBJECT_EXTENSION)(FileObject + 1);
885 FileObject->FileObjectExtension = FileObjectExtension;
886
887 /* Add the top level device which we'll send the request to */
888 if (OpenPacket->InternalFlags & IOP_USE_TOP_LEVEL_DEVICE_HINT)
889 {
890 FileObjectExtension->TopDeviceObjectHint = DeviceObject;
891 }
892 }
893 }
894 else
895 {
896 /* Use the dummy object instead */
897 LocalFileObject = OpenPacket->LocalFileObject;
898 RtlZeroMemory(LocalFileObject, sizeof(DUMMY_FILE_OBJECT));
899
900 /* Set it up */
901 FileObject = (PFILE_OBJECT)&LocalFileObject->ObjectHeader.Body;
902 LocalFileObject->ObjectHeader.Type = IoFileObjectType;
903 LocalFileObject->ObjectHeader.PointerCount = 1;
904 }
905
906 /* Setup the file header */
907 FileObject->Type = IO_TYPE_FILE;
908 FileObject->Size = sizeof(FILE_OBJECT);
909 FileObject->RelatedFileObject = OpenPacket->RelatedFileObject;
910 FileObject->DeviceObject = OriginalDeviceObject;
911
912 /* Check if this is a direct device open */
913 if (DirectOpen) FileObject->Flags |= FO_DIRECT_DEVICE_OPEN;
914
915 /* Check if the caller wants case sensitivity */
916 if (!(Attributes & OBJ_CASE_INSENSITIVE))
917 {
918 /* Tell the driver about it */
919 FileObject->Flags |= FO_OPENED_CASE_SENSITIVE;
920 }
921
922 /* Now set the file object */
923 Irp->Tail.Overlay.OriginalFileObject = FileObject;
924 StackLoc->FileObject = FileObject;
925
926 /* Check if the file object has a name */
927 if (RemainingName->Length)
928 {
929 /* Setup the unicode string */
930 FileObject->FileName.MaximumLength = RemainingName->Length +
931 sizeof(WCHAR);
932 FileObject->FileName.Buffer = ExAllocatePoolWithTag(PagedPool,
933 FileObject->
934 FileName.
935 MaximumLength,
936 TAG_IO_NAME);
937 if (!FileObject->FileName.Buffer)
938 {
939 /* Failed to allocate the name, free the IRP */
940 IoFreeIrp(Irp);
941
942 /* Dereference the device object and VPB */
943 IopDereferenceDeviceObject(OriginalDeviceObject, FALSE);
944 if (Vpb) IopDereferenceVpbAndFree(Vpb);
945
946 /* Clear the FO and dereference it */
947 FileObject->DeviceObject = NULL;
948 if (!UseDummyFile) ObDereferenceObject(FileObject);
949
950 /* Fail */
951 return STATUS_INSUFFICIENT_RESOURCES;
952 }
953 }
954
955 /* Copy the name */
956 RtlCopyUnicodeString(&FileObject->FileName, RemainingName);
957
958 /* Initialize the File Object event and set the FO */
959 KeInitializeEvent(&FileObject->Event, NotificationEvent, FALSE);
960 OpenPacket->FileObject = FileObject;
961
962 /* Queue the IRP and call the driver */
963 IopQueueIrpToThread(Irp);
964 Status = IoCallDriver(DeviceObject, Irp);
965 if (Status == STATUS_PENDING)
966 {
967 /* Wait for the driver to complete the create */
968 KeWaitForSingleObject(&FileObject->Event,
969 Executive,
970 KernelMode,
971 FALSE,
972 NULL);
973
974 /* Get the new status */
975 Status = IoStatusBlock.Status;
976 }
977 else
978 {
979 /* We'll have to complete it ourselves */
980 ASSERT(!Irp->PendingReturned);
981 ASSERT(!Irp->MdlAddress);
982
983 /* Handle name change if required */
984 if (Status == STATUS_REPARSE)
985 {
986 /* Check this is a mount point */
987 if (Irp->IoStatus.Information == IO_REPARSE_TAG_MOUNT_POINT)
988 {
989 PREPARSE_DATA_BUFFER ReparseData;
990
991 /* Reparse point attributes were passed by the driver in the auxiliary buffer */
992 ASSERT(Irp->Tail.Overlay.AuxiliaryBuffer != NULL);
993 ReparseData = (PREPARSE_DATA_BUFFER)Irp->Tail.Overlay.AuxiliaryBuffer;
994
995 ASSERT(ReparseData->ReparseTag == IO_REPARSE_TAG_MOUNT_POINT);
996 ASSERT(ReparseData->ReparseDataLength < MAXIMUM_REPARSE_DATA_BUFFER_SIZE);
997 ASSERT(ReparseData->Reserved < MAXIMUM_REPARSE_DATA_BUFFER_SIZE);
998
999 IopDoNameTransmogrify(Irp, FileObject, ReparseData);
1000 }
1001 }
1002
1003 /* Completion happens at APC_LEVEL */
1004 KeRaiseIrql(APC_LEVEL, &OldIrql);
1005
1006 /* Get the new I/O Status block ourselves */
1007 IoStatusBlock = Irp->IoStatus;
1008 Status = IoStatusBlock.Status;
1009
1010 /* Manually signal the even, we can't have any waiters */
1011 FileObject->Event.Header.SignalState = 1;
1012
1013 /* Now that we've signaled the events, de-associate the IRP */
1014 IopUnQueueIrpFromThread(Irp);
1015
1016 /* Check if the IRP had an input buffer */
1017 if ((Irp->Flags & IRP_BUFFERED_IO) &&
1018 (Irp->Flags & IRP_DEALLOCATE_BUFFER))
1019 {
1020 /* Free it. A driver might've tacked one on */
1021 ExFreePool(Irp->AssociatedIrp.SystemBuffer);
1022 }
1023
1024 /* Free the IRP and bring the IRQL back down */
1025 IoFreeIrp(Irp);
1026 KeLowerIrql(OldIrql);
1027 }
1028
1029 /* Copy the I/O Status */
1030 OpenPacket->Information = IoStatusBlock.Information;
1031
1032 /* The driver failed to create the file */
1033 if (!NT_SUCCESS(Status))
1034 {
1035 /* Check if we have a name */
1036 if (FileObject->FileName.Length)
1037 {
1038 /* Free it */
1039 ExFreePoolWithTag(FileObject->FileName.Buffer, TAG_IO_NAME);
1040 FileObject->FileName.Length = 0;
1041 }
1042
1043 /* Clear its device object */
1044 FileObject->DeviceObject = NULL;
1045
1046 /* Save this now because the FO might go away */
1047 OpenCancelled = FileObject->Flags & FO_FILE_OPEN_CANCELLED ?
1048 TRUE : FALSE;
1049
1050 /* Clear the file object in the open packet */
1051 OpenPacket->FileObject = NULL;
1052
1053 /* Dereference the file object */
1054 if (!UseDummyFile) ObDereferenceObject(FileObject);
1055
1056 /* Dereference the device object */
1057 IopDereferenceDeviceObject(OriginalDeviceObject, FALSE);
1058
1059 /* Unless the driver cancelled the open, dereference the VPB */
1060 if (!(OpenCancelled) && (Vpb)) IopDereferenceVpbAndFree(Vpb);
1061
1062 /* Set the status and return */
1063 OpenPacket->FinalStatus = Status;
1064 return Status;
1065 }
1066 else if (Status == STATUS_REPARSE)
1067 {
1068 if (OpenPacket->Information == IO_REPARSE ||
1069 OpenPacket->Information == IO_REPARSE_TAG_MOUNT_POINT)
1070 {
1071 /* Update CompleteName with reparse info which got updated in IopDoNameTransmogrify() */
1072 if (CompleteName->MaximumLength < FileObject->FileName.Length)
1073 {
1074 PWSTR NewCompleteName;
1075
1076 /* Allocate a new buffer for the string */
1077 NewCompleteName = ExAllocatePoolWithTag(PagedPool, FileObject->FileName.Length, TAG_IO_NAME);
1078 if (NewCompleteName == NULL)
1079 {
1080 OpenPacket->FinalStatus = STATUS_INSUFFICIENT_RESOURCES;
1081 return STATUS_INSUFFICIENT_RESOURCES;
1082 }
1083
1084 /* Release the old one */
1085 if (CompleteName->Buffer != NULL)
1086 {
1087 ExFreePoolWithTag(CompleteName->Buffer, 0);
1088 }
1089
1090 /* And setup the new one */
1091 CompleteName->Buffer = NewCompleteName;
1092 CompleteName->MaximumLength = FileObject->FileName.Length;
1093 }
1094
1095 /* Copy our new complete name */
1096 RtlCopyUnicodeString(CompleteName, &FileObject->FileName);
1097
1098 if (OpenPacket->Information == IO_REPARSE_TAG_MOUNT_POINT)
1099 {
1100 OpenPacket->RelatedFileObject = NULL;
1101 }
1102 }
1103
1104 /* Check if we have a name */
1105 if (FileObject->FileName.Length)
1106 {
1107 /* Free it */
1108 ExFreePoolWithTag(FileObject->FileName.Buffer, 0);
1109 FileObject->FileName.Length = 0;
1110 }
1111
1112 /* Clear its device object */
1113 FileObject->DeviceObject = NULL;
1114
1115 /* Clear the file object in the open packet */
1116 OpenPacket->FileObject = NULL;
1117
1118 /* Dereference the file object */
1119 if (!UseDummyFile) ObDereferenceObject(FileObject);
1120
1121 /* Dereference the device object */
1122 IopDereferenceDeviceObject(OriginalDeviceObject, FALSE);
1123
1124 /* Unless the driver cancelled the open, dereference the VPB */
1125 if (Vpb != NULL) IopDereferenceVpbAndFree(Vpb);
1126
1127 if (OpenPacket->Information != IO_REMOUNT)
1128 {
1129 OpenPacket->RelatedFileObject = NULL;
1130
1131 /* Inform we traversed a mount point for later attempt */
1132 if (OpenPacket->Information == IO_REPARSE_TAG_MOUNT_POINT)
1133 {
1134 OpenPacket->TraversedMountPoint = 1;
1135 }
1136
1137 /* In case we override checks, but got this on volume open, fail hard */
1138 if (OpenPacket->Override)
1139 {
1140 KeBugCheckEx(DRIVER_RETURNED_STATUS_REPARSE_FOR_VOLUME_OPEN,
1141 (ULONG_PTR)OriginalDeviceObject,
1142 (ULONG_PTR)DeviceObject,
1143 (ULONG_PTR)CompleteName,
1144 OpenPacket->Information);
1145 }
1146
1147 /* Return to IO/OB so that information can be upgraded */
1148 return STATUS_REPARSE;
1149 }
1150
1151 /* Loop again and reattempt an opening */
1152 continue;
1153 }
1154
1155 break;
1156 }
1157
1158 if (Attempt == IOP_MAX_REPARSE_TRAVERSAL)
1159 return STATUS_UNSUCCESSFUL;
1160
1161 /* Get the owner of the File Object */
1162 OwnerDevice = IoGetRelatedDeviceObject(FileObject);
1163
1164 /*
1165 * It's possible that the device to whom we sent the IRP to
1166 * isn't actually the device that ended opening the file object
1167 * internally.
1168 */
1169 if (OwnerDevice != DeviceObject)
1170 {
1171 /* We have to de-reference the VPB we had associated */
1172 if (Vpb) IopDereferenceVpbAndFree(Vpb);
1173
1174 /* And re-associate with the actual one */
1175 Vpb = FileObject->Vpb;
1176 if (Vpb) InterlockedIncrement((PLONG)&Vpb->ReferenceCount);
1177 }
1178
1179 /* Make sure we are not using a dummy */
1180 if (!UseDummyFile)
1181 {
1182 /* Check if this was a volume open */
1183 if ((!(FileObject->RelatedFileObject) ||
1184 (FileObject->RelatedFileObject->Flags & FO_VOLUME_OPEN)) &&
1185 !(FileObject->FileName.Length))
1186 {
1187 /* All signs point to it, but make sure it was actually an FSD */
1188 if ((OwnerDevice->DeviceType == FILE_DEVICE_DISK_FILE_SYSTEM) ||
1189 (OwnerDevice->DeviceType == FILE_DEVICE_CD_ROM_FILE_SYSTEM) ||
1190 (OwnerDevice->DeviceType == FILE_DEVICE_TAPE_FILE_SYSTEM) ||
1191 (OwnerDevice->DeviceType == FILE_DEVICE_FILE_SYSTEM))
1192 {
1193 /* The owner device is an FSD, so this is a volume open for real */
1194 FileObject->Flags |= FO_VOLUME_OPEN;
1195 }
1196 }
1197
1198 /* Reference the object and set the parse check */
1199 ObReferenceObject(FileObject);
1200 *Object = FileObject;
1201 OpenPacket->FinalStatus = IoStatusBlock.Status;
1202 OpenPacket->ParseCheck = TRUE;
1203 return OpenPacket->FinalStatus;
1204 }
1205 else
1206 {
1207 /* Check if this was a query */
1208 if (OpenPacket->QueryOnly)
1209 {
1210 /* Check if the caller wants basic info only */
1211 if (!OpenPacket->FullAttributes)
1212 {
1213 /* Allocate the buffer */
1214 FileBasicInfo = ExAllocatePoolWithTag(NonPagedPool,
1215 sizeof(*FileBasicInfo),
1216 TAG_IO);
1217 if (FileBasicInfo)
1218 {
1219 /* Do the query */
1220 Status = IoQueryFileInformation(FileObject,
1221 FileBasicInformation,
1222 sizeof(*FileBasicInfo),
1223 FileBasicInfo,
1224 &ReturnLength);
1225 if (NT_SUCCESS(Status))
1226 {
1227 /* Copy the data */
1228 RtlCopyMemory(OpenPacket->BasicInformation,
1229 FileBasicInfo,
1230 ReturnLength);
1231 }
1232
1233 /* Free our buffer */
1234 ExFreePoolWithTag(FileBasicInfo, TAG_IO);
1235 }
1236 else
1237 {
1238 /* Fail */
1239 Status = STATUS_INSUFFICIENT_RESOURCES;
1240 }
1241 }
1242 else
1243 {
1244 /* This is a full query */
1245 Status = IoQueryFileInformation(
1246 FileObject,
1247 FileNetworkOpenInformation,
1248 sizeof(FILE_NETWORK_OPEN_INFORMATION),
1249 OpenPacket->NetworkInformation,
1250 &ReturnLength);
1251 if (!NT_SUCCESS(Status)) ASSERT(Status != STATUS_NOT_IMPLEMENTED);
1252 }
1253 }
1254
1255 /* Delete the file object */
1256 IopDeleteFile(FileObject);
1257
1258 /* Clear out the file */
1259 OpenPacket->FileObject = NULL;
1260
1261 /* Set and return status */
1262 OpenPacket->FinalStatus = Status;
1263 OpenPacket->ParseCheck = TRUE;
1264 return Status;
1265 }
1266 }
1267
1268 NTSTATUS
1269 NTAPI
1270 IopParseFile(IN PVOID ParseObject,
1271 IN PVOID ObjectType,
1272 IN OUT PACCESS_STATE AccessState,
1273 IN KPROCESSOR_MODE AccessMode,
1274 IN ULONG Attributes,
1275 IN OUT PUNICODE_STRING CompleteName,
1276 IN OUT PUNICODE_STRING RemainingName,
1277 IN OUT PVOID Context OPTIONAL,
1278 IN PSECURITY_QUALITY_OF_SERVICE SecurityQos OPTIONAL,
1279 OUT PVOID *Object)
1280 {
1281 PVOID DeviceObject;
1282 POPEN_PACKET OpenPacket = (POPEN_PACKET)Context;
1283
1284 /* Validate the open packet */
1285 if (!IopValidateOpenPacket(OpenPacket)) return STATUS_OBJECT_TYPE_MISMATCH;
1286
1287 /* Get the device object */
1288 DeviceObject = IoGetRelatedDeviceObject(ParseObject);
1289 OpenPacket->RelatedFileObject = ParseObject;
1290
1291 /* Call the main routine */
1292 return IopParseDevice(DeviceObject,
1293 ObjectType,
1294 AccessState,
1295 AccessMode,
1296 Attributes,
1297 CompleteName,
1298 RemainingName,
1299 OpenPacket,
1300 SecurityQos,
1301 Object);
1302 }
1303
1304 VOID
1305 NTAPI
1306 IopDeleteFile(IN PVOID ObjectBody)
1307 {
1308 PFILE_OBJECT FileObject = (PFILE_OBJECT)ObjectBody;
1309 PIRP Irp;
1310 PIO_STACK_LOCATION StackPtr;
1311 NTSTATUS Status;
1312 KEVENT Event;
1313 PDEVICE_OBJECT DeviceObject;
1314 BOOLEAN DereferenceDone = FALSE;
1315 PVPB Vpb;
1316 KIRQL OldIrql;
1317 IOTRACE(IO_FILE_DEBUG, "ObjectBody: %p\n", ObjectBody);
1318
1319 /* Check if the file has a device object */
1320 if (FileObject->DeviceObject)
1321 {
1322 /* Check if this is a direct open or not */
1323 if (FileObject->Flags & FO_DIRECT_DEVICE_OPEN)
1324 {
1325 /* Get the attached device */
1326 DeviceObject = IoGetAttachedDevice(FileObject->DeviceObject);
1327 }
1328 else
1329 {
1330 /* Use the file object's device object */
1331 DeviceObject = IoGetRelatedDeviceObject(FileObject);
1332 }
1333
1334 /* Sanity check */
1335 ASSERT(!(FileObject->Flags & FO_SYNCHRONOUS_IO) ||
1336 (InterlockedExchange((PLONG)&FileObject->Busy, TRUE) == FALSE));
1337
1338 /* Check if the handle wasn't created yet */
1339 if (!(FileObject->Flags & FO_HANDLE_CREATED))
1340 {
1341 /* Send the cleanup IRP */
1342 IopCloseFile(NULL, ObjectBody, 0, 1, 1);
1343 }
1344
1345 /* Clear and set up Events */
1346 KeClearEvent(&FileObject->Event);
1347 KeInitializeEvent(&Event, SynchronizationEvent, FALSE);
1348
1349 /* Allocate an IRP */
1350 Irp = IopAllocateIrpMustSucceed(DeviceObject->StackSize);
1351
1352 /* Set it up */
1353 Irp->UserEvent = &Event;
1354 Irp->UserIosb = &Irp->IoStatus;
1355 Irp->Tail.Overlay.Thread = PsGetCurrentThread();
1356 Irp->Tail.Overlay.OriginalFileObject = FileObject;
1357 Irp->Flags = IRP_CLOSE_OPERATION | IRP_SYNCHRONOUS_API;
1358
1359 /* Set up Stack Pointer Data */
1360 StackPtr = IoGetNextIrpStackLocation(Irp);
1361 StackPtr->MajorFunction = IRP_MJ_CLOSE;
1362 StackPtr->FileObject = FileObject;
1363
1364 /* Queue the IRP */
1365 IopQueueIrpToThread(Irp);
1366
1367 /* Get the VPB and check if this isn't a direct open */
1368 Vpb = FileObject->Vpb;
1369 if ((Vpb) && !(FileObject->Flags & FO_DIRECT_DEVICE_OPEN))
1370 {
1371 /* Dereference the VPB before the close */
1372 InterlockedDecrement((PLONG)&Vpb->ReferenceCount);
1373 }
1374
1375 /* Check if the FS will never disappear by itself */
1376 if (FileObject->DeviceObject->Flags & DO_NEVER_LAST_DEVICE)
1377 {
1378 /* Dereference it */
1379 InterlockedDecrement(&FileObject->DeviceObject->ReferenceCount);
1380 DereferenceDone = TRUE;
1381 }
1382
1383 /* Call the FS Driver */
1384 Status = IoCallDriver(DeviceObject, Irp);
1385 if (Status == STATUS_PENDING)
1386 {
1387 /* Wait for completion */
1388 KeWaitForSingleObject(&Event, Executive, KernelMode, FALSE, NULL);
1389 }
1390
1391 /* De-queue the IRP */
1392 KeRaiseIrql(APC_LEVEL, &OldIrql);
1393 IopUnQueueIrpFromThread(Irp);
1394 KeLowerIrql(OldIrql);
1395
1396 /* Free the IRP */
1397 IoFreeIrp(Irp);
1398
1399 /* Clear the file name */
1400 if (FileObject->FileName.Buffer)
1401 {
1402 ExFreePoolWithTag(FileObject->FileName.Buffer, TAG_IO_NAME);
1403 FileObject->FileName.Buffer = NULL;
1404 }
1405
1406 /* Check if the FO had a completion port */
1407 if (FileObject->CompletionContext)
1408 {
1409 /* Free it */
1410 ObDereferenceObject(FileObject->CompletionContext->Port);
1411 ExFreePool(FileObject->CompletionContext);
1412 }
1413
1414 /* Check if the FO had extension */
1415 if (FileObject->Flags & FO_FILE_OBJECT_HAS_EXTENSION)
1416 {
1417 /* Release filter context structure if any */
1418 FsRtlPTeardownPerFileObjectContexts(FileObject);
1419 }
1420
1421 /* Check if dereference has been done yet */
1422 if (!DereferenceDone)
1423 {
1424 /* Dereference device object */
1425 IopDereferenceDeviceObject(FileObject->DeviceObject, FALSE);
1426 }
1427 }
1428 }
1429
1430 PDEVICE_OBJECT
1431 NTAPI
1432 IopGetDeviceAttachmentBase(IN PDEVICE_OBJECT DeviceObject)
1433 {
1434 PDEVICE_OBJECT PDO = DeviceObject;
1435
1436 /* Go down the stack to attempt to get the PDO */
1437 for (; ((PEXTENDED_DEVOBJ_EXTENSION)PDO->DeviceObjectExtension)->AttachedTo != NULL;
1438 PDO = ((PEXTENDED_DEVOBJ_EXTENSION)PDO->DeviceObjectExtension)->AttachedTo);
1439
1440 return PDO;
1441 }
1442
1443 PDEVICE_OBJECT
1444 NTAPI
1445 IopGetDevicePDO(IN PDEVICE_OBJECT DeviceObject)
1446 {
1447 KIRQL OldIrql;
1448 PDEVICE_OBJECT PDO;
1449
1450 ASSERT(DeviceObject != NULL);
1451
1452 OldIrql = KeAcquireQueuedSpinLock(LockQueueIoDatabaseLock);
1453 /* Get the base DO */
1454 PDO = IopGetDeviceAttachmentBase(DeviceObject);
1455 /* Check whether that's really a PDO and if so, keep it */
1456 if ((PDO->Flags & DO_BUS_ENUMERATED_DEVICE) != DO_BUS_ENUMERATED_DEVICE)
1457 {
1458 PDO = NULL;
1459 }
1460 else
1461 {
1462 ObReferenceObject(PDO);
1463 }
1464 KeReleaseQueuedSpinLock(LockQueueIoDatabaseLock, OldIrql);
1465
1466 return PDO;
1467 }
1468
1469 NTSTATUS
1470 NTAPI
1471 IopSetDeviceSecurityDescriptor(IN PDEVICE_OBJECT DeviceObject,
1472 IN PSECURITY_INFORMATION SecurityInformation,
1473 IN PSECURITY_DESCRIPTOR SecurityDescriptor,
1474 IN POOL_TYPE PoolType,
1475 IN PGENERIC_MAPPING GenericMapping)
1476 {
1477 NTSTATUS Status;
1478 PSECURITY_DESCRIPTOR OldSecurityDescriptor, CachedSecurityDescriptor, NewSecurityDescriptor;
1479
1480 PAGED_CODE();
1481
1482 /* Keep attempting till we find our old SD or fail */
1483 while (TRUE)
1484 {
1485 KeEnterCriticalRegion();
1486 ExAcquireResourceSharedLite(&IopSecurityResource, TRUE);
1487
1488 /* Get our old SD and reference it */
1489 OldSecurityDescriptor = DeviceObject->SecurityDescriptor;
1490 if (OldSecurityDescriptor != NULL)
1491 {
1492 ObReferenceSecurityDescriptor(OldSecurityDescriptor, 1);
1493 }
1494
1495 ExReleaseResourceLite(&IopSecurityResource);
1496 KeLeaveCriticalRegion();
1497
1498 /* Set the SD information */
1499 NewSecurityDescriptor = OldSecurityDescriptor;
1500 Status = SeSetSecurityDescriptorInfo(NULL, SecurityInformation,
1501 SecurityDescriptor, &NewSecurityDescriptor,
1502 PoolType, GenericMapping);
1503
1504 if (!NT_SUCCESS(Status))
1505 {
1506 if (OldSecurityDescriptor != NULL)
1507 {
1508 ObDereferenceSecurityDescriptor(OldSecurityDescriptor, 1);
1509 }
1510
1511 break;
1512 }
1513
1514 /* Add the new DS to the internal cache */
1515 Status = ObLogSecurityDescriptor(NewSecurityDescriptor,
1516 &CachedSecurityDescriptor, 1);
1517 ExFreePool(NewSecurityDescriptor);
1518 if (!NT_SUCCESS(Status))
1519 {
1520 ObDereferenceSecurityDescriptor(OldSecurityDescriptor, 1);
1521 break;
1522 }
1523
1524 KeEnterCriticalRegion();
1525 ExAcquireResourceExclusiveLite(&IopSecurityResource, TRUE);
1526 /* Check if someone changed it in our back */
1527 if (DeviceObject->SecurityDescriptor == OldSecurityDescriptor)
1528 {
1529 /* We're clear, do the swap */
1530 DeviceObject->SecurityDescriptor = CachedSecurityDescriptor;
1531 ExReleaseResourceLite(&IopSecurityResource);
1532 KeLeaveCriticalRegion();
1533
1534 /* And dereference old SD (twice - us + not in use) */
1535 ObDereferenceSecurityDescriptor(OldSecurityDescriptor, 2);
1536
1537 break;
1538 }
1539 ExReleaseResourceLite(&IopSecurityResource);
1540 KeLeaveCriticalRegion();
1541
1542 /* If so, try again */
1543 ObDereferenceSecurityDescriptor(OldSecurityDescriptor, 1);
1544 ObDereferenceSecurityDescriptor(CachedSecurityDescriptor, 1);
1545 }
1546
1547 return Status;
1548 }
1549
1550 NTSTATUS
1551 NTAPI
1552 IopSetDeviceSecurityDescriptors(IN PDEVICE_OBJECT UpperDeviceObject,
1553 IN PDEVICE_OBJECT PhysicalDeviceObject,
1554 IN PSECURITY_INFORMATION SecurityInformation,
1555 IN PSECURITY_DESCRIPTOR SecurityDescriptor,
1556 IN POOL_TYPE PoolType,
1557 IN PGENERIC_MAPPING GenericMapping)
1558 {
1559 PDEVICE_OBJECT CurrentDO = PhysicalDeviceObject, NextDevice;
1560 NTSTATUS Status = STATUS_SUCCESS, TmpStatus;
1561
1562 PAGED_CODE();
1563
1564 ASSERT(PhysicalDeviceObject != NULL);
1565
1566 /* We always reference the DO we're working on */
1567 ObReferenceObject(CurrentDO);
1568
1569 /* Go up from PDO to latest DO */
1570 do
1571 {
1572 /* Attempt to set the new SD on it */
1573 TmpStatus = IopSetDeviceSecurityDescriptor(CurrentDO, SecurityInformation,
1574 SecurityDescriptor, PoolType,
1575 GenericMapping);
1576 /* Was our last one? Remember that status then */
1577 if (CurrentDO == UpperDeviceObject)
1578 {
1579 Status = TmpStatus;
1580 }
1581
1582 /* Try to move to the next DO (and thus, reference it) */
1583 NextDevice = CurrentDO->AttachedDevice;
1584 if (NextDevice)
1585 {
1586 ObReferenceObject(NextDevice);
1587 }
1588
1589 /* Dereference current DO and move to the next one */
1590 ObDereferenceObject(CurrentDO);
1591 CurrentDO = NextDevice;
1592 }
1593 while (CurrentDO != NULL);
1594
1595 return Status;
1596 }
1597
1598 NTSTATUS
1599 NTAPI
1600 IopGetSetSecurityObject(IN PVOID ObjectBody,
1601 IN SECURITY_OPERATION_CODE OperationCode,
1602 IN PSECURITY_INFORMATION SecurityInformation,
1603 IN PSECURITY_DESCRIPTOR SecurityDescriptor,
1604 IN OUT PULONG BufferLength,
1605 IN OUT PSECURITY_DESCRIPTOR *OldSecurityDescriptor,
1606 IN POOL_TYPE PoolType,
1607 IN OUT PGENERIC_MAPPING GenericMapping)
1608 {
1609 IO_STATUS_BLOCK IoStatusBlock;
1610 PIO_STACK_LOCATION StackPtr;
1611 PFILE_OBJECT FileObject;
1612 PDEVICE_OBJECT DeviceObject;
1613 PIRP Irp;
1614 BOOLEAN LocalEvent = FALSE;
1615 KEVENT Event;
1616 NTSTATUS Status = STATUS_SUCCESS;
1617 PAGED_CODE();
1618 IOTRACE(IO_FILE_DEBUG, "ObjectBody: %p\n", ObjectBody);
1619
1620 /* Check if this is a device or file */
1621 if (((PFILE_OBJECT)ObjectBody)->Type == IO_TYPE_DEVICE)
1622 {
1623 /* It's a device */
1624 DeviceObject = (PDEVICE_OBJECT)ObjectBody;
1625 FileObject = NULL;
1626 }
1627 else
1628 {
1629 /* It's a file */
1630 FileObject = (PFILE_OBJECT)ObjectBody;
1631
1632 /* Check if this is a direct open */
1633 if (FileObject->Flags & FO_DIRECT_DEVICE_OPEN)
1634 {
1635 /* Get the Device Object */
1636 DeviceObject = IoGetAttachedDevice(FileObject->DeviceObject);
1637 }
1638 else
1639 {
1640 /* Otherwise, use the direct device*/
1641 DeviceObject = FileObject->DeviceObject;
1642 }
1643 }
1644
1645 /* Check if the request was for a device object */
1646 if (!(FileObject) ||
1647 (!(FileObject->FileName.Length) && !(FileObject->RelatedFileObject)) ||
1648 (FileObject->Flags & FO_DIRECT_DEVICE_OPEN))
1649 {
1650 /* Check what kind of request this was */
1651 if (OperationCode == QuerySecurityDescriptor)
1652 {
1653 return SeQuerySecurityDescriptorInfo(SecurityInformation,
1654 SecurityDescriptor,
1655 BufferLength,
1656 &DeviceObject->SecurityDescriptor);
1657 }
1658 else if (OperationCode == DeleteSecurityDescriptor)
1659 {
1660 /* Simply return success */
1661 return STATUS_SUCCESS;
1662 }
1663 else if (OperationCode == AssignSecurityDescriptor)
1664 {
1665 Status = STATUS_SUCCESS;
1666
1667 /* Make absolutely sure this is a device object */
1668 if (!(FileObject) || !(FileObject->Flags & FO_STREAM_FILE))
1669 {
1670 PSECURITY_DESCRIPTOR CachedSecurityDescriptor;
1671
1672 /* Add the security descriptor in cache */
1673 Status = ObLogSecurityDescriptor(SecurityDescriptor, &CachedSecurityDescriptor, 1);
1674 if (NT_SUCCESS(Status))
1675 {
1676 KeEnterCriticalRegion();
1677 ExAcquireResourceExclusiveLite(&IopSecurityResource, TRUE);
1678
1679 /* Assign the Security Descriptor */
1680 DeviceObject->SecurityDescriptor = CachedSecurityDescriptor;
1681
1682 ExReleaseResourceLite(&IopSecurityResource);
1683 KeLeaveCriticalRegion();
1684 }
1685 }
1686
1687 /* Return status */
1688 return Status;
1689 }
1690 else if (OperationCode == SetSecurityDescriptor)
1691 {
1692 /* Get the Physical Device Object if any */
1693 PDEVICE_OBJECT PDO = IopGetDevicePDO(DeviceObject);
1694
1695 if (PDO != NULL)
1696 {
1697 /* Apply the new SD to any DO in the path from PDO to current DO */
1698 Status = IopSetDeviceSecurityDescriptors(DeviceObject, PDO,
1699 SecurityInformation,
1700 SecurityDescriptor,
1701 PoolType, GenericMapping);
1702 ObDereferenceObject(PDO);
1703 }
1704 else
1705 {
1706 /* Otherwise, just set for ourselves */
1707 Status = IopSetDeviceSecurityDescriptor(DeviceObject,
1708 SecurityInformation,
1709 SecurityDescriptor,
1710 PoolType, GenericMapping);
1711 }
1712
1713 return STATUS_SUCCESS;
1714 }
1715
1716 /* Shouldn't happen */
1717 return STATUS_SUCCESS;
1718 }
1719 else if (OperationCode == DeleteSecurityDescriptor)
1720 {
1721 /* Same as for devices, do nothing */
1722 return STATUS_SUCCESS;
1723 }
1724
1725 /* At this point, we know we're a file. Reference it */
1726 ObReferenceObject(FileObject);
1727
1728 /* Check if we should use Sync IO or not */
1729 if (FileObject->Flags & FO_SYNCHRONOUS_IO)
1730 {
1731 /* Lock the file object */
1732 Status = IopLockFileObject(FileObject, ExGetPreviousMode());
1733 if (Status != STATUS_SUCCESS)
1734 {
1735 ObDereferenceObject(FileObject);
1736 return Status;
1737 }
1738 }
1739 else
1740 {
1741 /* Use local event */
1742 KeInitializeEvent(&Event, SynchronizationEvent, FALSE);
1743 LocalEvent = TRUE;
1744 }
1745
1746 /* Clear the File Object event */
1747 KeClearEvent(&FileObject->Event);
1748
1749 /* Get the device object */
1750 DeviceObject = IoGetRelatedDeviceObject(FileObject);
1751
1752 /* Allocate the IRP */
1753 Irp = IoAllocateIrp(DeviceObject->StackSize, FALSE);
1754 if (!Irp) return IopCleanupFailedIrp(FileObject, NULL, NULL);
1755
1756 /* Set the IRP */
1757 Irp->Tail.Overlay.OriginalFileObject = FileObject;
1758 Irp->Tail.Overlay.Thread = PsGetCurrentThread();
1759 Irp->RequestorMode = ExGetPreviousMode();
1760 Irp->UserIosb = &IoStatusBlock;
1761 Irp->UserEvent = (LocalEvent) ? &Event : NULL;
1762 Irp->Flags = (LocalEvent) ? IRP_SYNCHRONOUS_API : 0;
1763 Irp->Overlay.AsynchronousParameters.UserApcRoutine = NULL;
1764
1765 /* Set Stack Parameters */
1766 StackPtr = IoGetNextIrpStackLocation(Irp);
1767 StackPtr->FileObject = FileObject;
1768
1769 /* Check if this is a query or set */
1770 if (OperationCode == QuerySecurityDescriptor)
1771 {
1772 /* Set the major function and parameters */
1773 StackPtr->MajorFunction = IRP_MJ_QUERY_SECURITY;
1774 StackPtr->Parameters.QuerySecurity.SecurityInformation =
1775 *SecurityInformation;
1776 StackPtr->Parameters.QuerySecurity.Length = *BufferLength;
1777 Irp->UserBuffer = SecurityDescriptor;
1778 }
1779 else
1780 {
1781 /* Set the major function and parameters for a set */
1782 StackPtr->MajorFunction = IRP_MJ_SET_SECURITY;
1783 StackPtr->Parameters.SetSecurity.SecurityInformation =
1784 *SecurityInformation;
1785 StackPtr->Parameters.SetSecurity.SecurityDescriptor =
1786 SecurityDescriptor;
1787 }
1788
1789 /* Queue the IRP */
1790 IopQueueIrpToThread(Irp);
1791
1792 /* Update operation counts */
1793 IopUpdateOperationCount(IopOtherTransfer);
1794
1795 /* Call the Driver */
1796 Status = IoCallDriver(DeviceObject, Irp);
1797
1798 /* Check if this was async I/O */
1799 if (LocalEvent)
1800 {
1801 /* Check if the IRP is pending completion */
1802 if (Status == STATUS_PENDING)
1803 {
1804 /* Wait on the local event */
1805 KeWaitForSingleObject(&Event,
1806 Executive,
1807 KernelMode,
1808 FALSE,
1809 NULL);
1810 Status = IoStatusBlock.Status;
1811 }
1812 }
1813 else
1814 {
1815 /* Check if the IRP is pending completion */
1816 if (Status == STATUS_PENDING)
1817 {
1818 /* Wait on the file object */
1819 KeWaitForSingleObject(&FileObject->Event,
1820 Executive,
1821 KernelMode,
1822 FALSE,
1823 NULL);
1824 Status = FileObject->FinalStatus;
1825 }
1826
1827 /* Release the lock */
1828 IopUnlockFileObject(FileObject);
1829 }
1830
1831 /* This Driver doesn't implement Security, so try to give it a default */
1832 if (Status == STATUS_INVALID_DEVICE_REQUEST)
1833 {
1834 /* Was this a query? */
1835 if (OperationCode == QuerySecurityDescriptor)
1836 {
1837 /* Set a World Security Descriptor */
1838 Status = SeSetWorldSecurityDescriptor(*SecurityInformation,
1839 SecurityDescriptor,
1840 BufferLength);
1841 }
1842 else
1843 {
1844 /* It wasn't a query, so just fake success */
1845 Status = STATUS_SUCCESS;
1846 }
1847 }
1848 else if (OperationCode == QuerySecurityDescriptor)
1849 {
1850 /* Callers usually expect the normalized form */
1851 if (Status == STATUS_BUFFER_OVERFLOW) Status = STATUS_BUFFER_TOO_SMALL;
1852
1853 _SEH2_TRY
1854 {
1855 /* Return length */
1856 *BufferLength = (ULONG)IoStatusBlock.Information;
1857 }
1858 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
1859 {
1860 /* Get the exception code */
1861 Status = _SEH2_GetExceptionCode();
1862 }
1863 _SEH2_END;
1864 }
1865
1866 /* Return Status */
1867 return Status;
1868 }
1869
1870 NTSTATUS
1871 NTAPI
1872 IopQueryName(IN PVOID ObjectBody,
1873 IN BOOLEAN HasName,
1874 OUT POBJECT_NAME_INFORMATION ObjectNameInfo,
1875 IN ULONG Length,
1876 OUT PULONG ReturnLength,
1877 IN KPROCESSOR_MODE PreviousMode)
1878 {
1879 return IopQueryNameInternal(ObjectBody,
1880 HasName,
1881 FALSE,
1882 ObjectNameInfo,
1883 Length,
1884 ReturnLength,
1885 PreviousMode);
1886 }
1887
1888 NTSTATUS
1889 NTAPI
1890 IopQueryNameInternal(IN PVOID ObjectBody,
1891 IN BOOLEAN HasName,
1892 IN BOOLEAN QueryDosName,
1893 OUT POBJECT_NAME_INFORMATION ObjectNameInfo,
1894 IN ULONG Length,
1895 OUT PULONG ReturnLength,
1896 IN KPROCESSOR_MODE PreviousMode)
1897 {
1898 POBJECT_NAME_INFORMATION LocalInfo;
1899 PFILE_NAME_INFORMATION LocalFileInfo;
1900 PFILE_OBJECT FileObject = (PFILE_OBJECT)ObjectBody;
1901 ULONG LocalReturnLength, FileLength;
1902 BOOLEAN LengthMismatch = FALSE;
1903 NTSTATUS Status;
1904 PWCHAR p;
1905 IOTRACE(IO_FILE_DEBUG, "ObjectBody: %p\n", ObjectBody);
1906
1907 /* Validate length */
1908 if (Length < sizeof(OBJECT_NAME_INFORMATION))
1909 {
1910 /* Wrong length, fail */
1911 *ReturnLength = sizeof(OBJECT_NAME_INFORMATION);
1912 return STATUS_INFO_LENGTH_MISMATCH;
1913 }
1914
1915 if (QueryDosName) return STATUS_NOT_IMPLEMENTED;
1916
1917 /* Allocate Buffer */
1918 LocalInfo = ExAllocatePoolWithTag(PagedPool, Length, TAG_IO);
1919 if (!LocalInfo) return STATUS_INSUFFICIENT_RESOURCES;
1920
1921 /* Query the name */
1922 Status = ObQueryNameString(FileObject->DeviceObject,
1923 LocalInfo,
1924 Length,
1925 &LocalReturnLength);
1926 if (!NT_SUCCESS(Status) && (Status != STATUS_INFO_LENGTH_MISMATCH))
1927 {
1928 /* Free the buffer and fail */
1929 ExFreePoolWithTag(LocalInfo, TAG_IO);
1930 return Status;
1931 }
1932
1933 /* Copy the information */
1934 RtlCopyMemory(ObjectNameInfo,
1935 LocalInfo,
1936 (LocalReturnLength > Length) ?
1937 Length : LocalReturnLength);
1938
1939 /* Set buffer pointer */
1940 p = (PWCHAR)(ObjectNameInfo + 1);
1941 ObjectNameInfo->Name.Buffer = p;
1942
1943 /* Advance in buffer */
1944 p += (LocalInfo->Name.Length / sizeof(WCHAR));
1945
1946 /* Check if this already filled our buffer */
1947 if (LocalReturnLength > Length)
1948 {
1949 /* Set the length mismatch to true, so that we can return
1950 * the proper buffer size to the caller later
1951 */
1952 LengthMismatch = TRUE;
1953
1954 /* Save the initial buffer length value */
1955 *ReturnLength = LocalReturnLength;
1956 }
1957
1958 /* Now get the file name buffer and check the length needed */
1959 LocalFileInfo = (PFILE_NAME_INFORMATION)LocalInfo;
1960 FileLength = Length -
1961 LocalReturnLength +
1962 FIELD_OFFSET(FILE_NAME_INFORMATION, FileName);
1963
1964 /* Query the File name */
1965 if (PreviousMode == KernelMode &&
1966 BooleanFlagOn(FileObject->Flags, FO_SYNCHRONOUS_IO))
1967 {
1968 Status = IopGetFileInformation(FileObject,
1969 LengthMismatch ? Length : FileLength,
1970 FileNameInformation,
1971 LocalFileInfo,
1972 &LocalReturnLength);
1973 }
1974 else
1975 {
1976 Status = IoQueryFileInformation(FileObject,
1977 FileNameInformation,
1978 LengthMismatch ? Length : FileLength,
1979 LocalFileInfo,
1980 &LocalReturnLength);
1981 }
1982 if (NT_ERROR(Status))
1983 {
1984 /* Fail on errors only, allow warnings */
1985 ExFreePoolWithTag(LocalInfo, TAG_IO);
1986 return Status;
1987 }
1988
1989 /* If the provided buffer is too small, return the required size */
1990 if (LengthMismatch)
1991 {
1992 /* Add the required length */
1993 *ReturnLength += LocalFileInfo->FileNameLength;
1994
1995 /* Free the allocated buffer and return failure */
1996 ExFreePoolWithTag(LocalInfo, TAG_IO);
1997 return STATUS_BUFFER_OVERFLOW;
1998 }
1999
2000 /* Now calculate the new lengths left */
2001 FileLength = LocalReturnLength -
2002 FIELD_OFFSET(FILE_NAME_INFORMATION, FileName);
2003 LocalReturnLength = (ULONG)((ULONG_PTR)p -
2004 (ULONG_PTR)ObjectNameInfo +
2005 LocalFileInfo->FileNameLength);
2006
2007 /* Write the Name and null-terminate it */
2008 RtlCopyMemory(p, LocalFileInfo->FileName, FileLength);
2009 p += (FileLength / sizeof(WCHAR));
2010 *p = UNICODE_NULL;
2011 LocalReturnLength += sizeof(UNICODE_NULL);
2012
2013 /* Return the length needed */
2014 *ReturnLength = LocalReturnLength;
2015
2016 /* Setup the length and maximum length */
2017 FileLength = (ULONG)((ULONG_PTR)p - (ULONG_PTR)ObjectNameInfo);
2018 ObjectNameInfo->Name.Length = (USHORT)FileLength -
2019 sizeof(OBJECT_NAME_INFORMATION);
2020 ObjectNameInfo->Name.MaximumLength = (USHORT)ObjectNameInfo->Name.Length +
2021 sizeof(UNICODE_NULL);
2022
2023 /* Free buffer and return */
2024 ExFreePoolWithTag(LocalInfo, TAG_IO);
2025 return Status;
2026 }
2027
2028 VOID
2029 NTAPI
2030 IopCloseFile(IN PEPROCESS Process OPTIONAL,
2031 IN PVOID ObjectBody,
2032 IN ACCESS_MASK GrantedAccess,
2033 IN ULONG HandleCount,
2034 IN ULONG SystemHandleCount)
2035 {
2036 PFILE_OBJECT FileObject = (PFILE_OBJECT)ObjectBody;
2037 KEVENT Event;
2038 PIRP Irp;
2039 PIO_STACK_LOCATION StackPtr;
2040 NTSTATUS Status;
2041 PDEVICE_OBJECT DeviceObject;
2042 KIRQL OldIrql;
2043 IO_STATUS_BLOCK IoStatusBlock;
2044 IOTRACE(IO_FILE_DEBUG, "ObjectBody: %p\n", ObjectBody);
2045
2046 /* If this isn't the last handle for the current process, quit */
2047 if (HandleCount != 1) return;
2048
2049 /* Check if the file is locked and has more then one handle opened */
2050 if ((FileObject->LockOperation) && (SystemHandleCount != 1))
2051 {
2052 /* Check if this is a direct open or not */
2053 if (BooleanFlagOn(FileObject->Flags, FO_DIRECT_DEVICE_OPEN))
2054 {
2055 /* Get the attached device */
2056 DeviceObject = IoGetAttachedDevice(FileObject->DeviceObject);
2057 }
2058 else
2059 {
2060 /* Get the FO's device */
2061 DeviceObject = IoGetRelatedDeviceObject(FileObject);
2062 }
2063
2064 /* Check if this is a sync FO and lock it */
2065 if (BooleanFlagOn(FileObject->Flags, FO_SYNCHRONOUS_IO))
2066 {
2067 (VOID)IopLockFileObject(FileObject, KernelMode);
2068 }
2069
2070 /* Go the FastIO path if possible, otherwise fall back to IRP */
2071 if (DeviceObject->DriverObject->FastIoDispatch == NULL ||
2072 DeviceObject->DriverObject->FastIoDispatch->FastIoUnlockAll == NULL ||
2073 !DeviceObject->DriverObject->FastIoDispatch->FastIoUnlockAll(FileObject, PsGetCurrentProcess(), &IoStatusBlock, DeviceObject))
2074 {
2075 /* Clear and set up Events */
2076 KeClearEvent(&FileObject->Event);
2077 KeInitializeEvent(&Event, SynchronizationEvent, FALSE);
2078
2079 /* Allocate an IRP */
2080 Irp = IopAllocateIrpMustSucceed(DeviceObject->StackSize);
2081
2082 /* Set it up */
2083 Irp->UserEvent = &Event;
2084 Irp->UserIosb = &Irp->IoStatus;
2085 Irp->Tail.Overlay.Thread = PsGetCurrentThread();
2086 Irp->Tail.Overlay.OriginalFileObject = FileObject;
2087 Irp->RequestorMode = KernelMode;
2088 Irp->Flags = IRP_SYNCHRONOUS_API;
2089 Irp->Overlay.AsynchronousParameters.UserApcRoutine = NULL;
2090 ObReferenceObject(FileObject);
2091
2092 /* Set up Stack Pointer Data */
2093 StackPtr = IoGetNextIrpStackLocation(Irp);
2094 StackPtr->MajorFunction = IRP_MJ_LOCK_CONTROL;
2095 StackPtr->MinorFunction = IRP_MN_UNLOCK_ALL;
2096 StackPtr->FileObject = FileObject;
2097
2098 /* Queue the IRP */
2099 IopQueueIrpToThread(Irp);
2100
2101 /* Call the FS Driver */
2102 Status = IoCallDriver(DeviceObject, Irp);
2103 if (Status == STATUS_PENDING)
2104 {
2105 /* Wait for completion */
2106 KeWaitForSingleObject(&Event, UserRequest, KernelMode, FALSE, NULL);
2107 }
2108
2109 /* IO will unqueue & free for us */
2110 }
2111
2112 /* Release the lock if we were holding it */
2113 if (BooleanFlagOn(FileObject->Flags, FO_SYNCHRONOUS_IO))
2114 {
2115 IopUnlockFileObject(FileObject);
2116 }
2117 }
2118
2119 /* Make sure this is the last handle */
2120 if (SystemHandleCount != 1) return;
2121
2122 /* Check if this is a direct open or not */
2123 if (FileObject->Flags & FO_DIRECT_DEVICE_OPEN)
2124 {
2125 /* Get the attached device */
2126 DeviceObject = IoGetAttachedDevice(FileObject->DeviceObject);
2127 }
2128 else
2129 {
2130 /* Get the FO's device */
2131 DeviceObject = IoGetRelatedDeviceObject(FileObject);
2132 }
2133
2134 /* Set the handle created flag */
2135 FileObject->Flags |= FO_HANDLE_CREATED;
2136
2137 /* Check if this is a sync FO and lock it */
2138 if (Process != NULL &&
2139 BooleanFlagOn(FileObject->Flags, FO_SYNCHRONOUS_IO))
2140 {
2141 (VOID)IopLockFileObject(FileObject, KernelMode);
2142 }
2143
2144 /* Clear and set up Events */
2145 KeClearEvent(&FileObject->Event);
2146 KeInitializeEvent(&Event, SynchronizationEvent, FALSE);
2147
2148 /* Allocate an IRP */
2149 Irp = IopAllocateIrpMustSucceed(DeviceObject->StackSize);
2150
2151 /* Set it up */
2152 Irp->UserEvent = &Event;
2153 Irp->UserIosb = &Irp->IoStatus;
2154 Irp->Tail.Overlay.Thread = PsGetCurrentThread();
2155 Irp->Tail.Overlay.OriginalFileObject = FileObject;
2156 Irp->Overlay.AsynchronousParameters.UserApcRoutine = NULL;
2157 Irp->Flags = IRP_CLOSE_OPERATION | IRP_SYNCHRONOUS_API;
2158
2159 /* Set up Stack Pointer Data */
2160 StackPtr = IoGetNextIrpStackLocation(Irp);
2161 StackPtr->MajorFunction = IRP_MJ_CLEANUP;
2162 StackPtr->FileObject = FileObject;
2163
2164 /* Queue the IRP */
2165 IopQueueIrpToThread(Irp);
2166
2167 /* Update operation counts */
2168 IopUpdateOperationCount(IopOtherTransfer);
2169
2170 /* Call the FS Driver */
2171 Status = IoCallDriver(DeviceObject, Irp);
2172 if (Status == STATUS_PENDING)
2173 {
2174 /* Wait for completion */
2175 KeWaitForSingleObject(&Event, UserRequest, KernelMode, FALSE, NULL);
2176 }
2177
2178 /* Unqueue the IRP */
2179 KeRaiseIrql(APC_LEVEL, &OldIrql);
2180 IopUnQueueIrpFromThread(Irp);
2181 KeLowerIrql(OldIrql);
2182
2183 /* Free the IRP */
2184 IoFreeIrp(Irp);
2185
2186 /* Release the lock if we were holding it */
2187 if (Process != NULL &&
2188 BooleanFlagOn(FileObject->Flags, FO_SYNCHRONOUS_IO))
2189 {
2190 IopUnlockFileObject(FileObject);
2191 }
2192 }
2193
2194 NTSTATUS
2195 NTAPI
2196 IopQueryAttributesFile(IN POBJECT_ATTRIBUTES ObjectAttributes,
2197 IN FILE_INFORMATION_CLASS FileInformationClass,
2198 IN ULONG FileInformationSize,
2199 OUT PVOID FileInformation)
2200 {
2201 NTSTATUS Status;
2202 KPROCESSOR_MODE AccessMode = ExGetPreviousMode();
2203 DUMMY_FILE_OBJECT LocalFileObject;
2204 FILE_NETWORK_OPEN_INFORMATION NetworkOpenInfo;
2205 HANDLE Handle;
2206 OPEN_PACKET OpenPacket;
2207 BOOLEAN IsBasic;
2208 PAGED_CODE();
2209 IOTRACE(IO_FILE_DEBUG, "Class: %lx\n", FileInformationClass);
2210
2211 /* Check if the caller was user mode */
2212 if (AccessMode != KernelMode)
2213 {
2214 /* Protect probe in SEH */
2215 _SEH2_TRY
2216 {
2217 /* Probe the buffer */
2218 ProbeForWrite(FileInformation, FileInformationSize, sizeof(ULONG));
2219 }
2220 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
2221 {
2222 /* Return the exception code */
2223 _SEH2_YIELD(return _SEH2_GetExceptionCode());
2224 }
2225 _SEH2_END;
2226 }
2227
2228 /* Check if this is a basic or full request */
2229 IsBasic = (FileInformationSize == sizeof(FILE_BASIC_INFORMATION));
2230
2231 /* Setup the Open Packet */
2232 RtlZeroMemory(&OpenPacket, sizeof(OPEN_PACKET));
2233 OpenPacket.Type = IO_TYPE_OPEN_PACKET;
2234 OpenPacket.Size = sizeof(OPEN_PACKET);
2235 OpenPacket.CreateOptions = FILE_OPEN_REPARSE_POINT;
2236 OpenPacket.ShareAccess = FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE;
2237 OpenPacket.Disposition = FILE_OPEN;
2238 OpenPacket.BasicInformation = IsBasic ? FileInformation : NULL;
2239 OpenPacket.NetworkInformation = IsBasic ? &NetworkOpenInfo :
2240 (AccessMode != KernelMode) ?
2241 &NetworkOpenInfo : FileInformation;
2242 OpenPacket.QueryOnly = TRUE;
2243 OpenPacket.FullAttributes = IsBasic ? FALSE : TRUE;
2244 OpenPacket.LocalFileObject = &LocalFileObject;
2245
2246 /* Update the operation count */
2247 IopUpdateOperationCount(IopOtherTransfer);
2248
2249 /*
2250 * Attempt opening the file. This will call the I/O Parse Routine for
2251 * the File Object (IopParseDevice) which will use the dummy file obejct
2252 * send the IRP to its device object. Note that we have two statuses
2253 * to worry about: the Object Manager's status (in Status) and the I/O
2254 * status, which is in the Open Packet's Final Status, and determined
2255 * by the Parse Check member.
2256 */
2257 Status = ObOpenObjectByName(ObjectAttributes,
2258 NULL,
2259 AccessMode,
2260 NULL,
2261 FILE_READ_ATTRIBUTES,
2262 &OpenPacket,
2263 &Handle);
2264 if (OpenPacket.ParseCheck == FALSE)
2265 {
2266 /* Parse failed */
2267 DPRINT("IopQueryAttributesFile failed for '%wZ' with 0x%lx\n",
2268 ObjectAttributes->ObjectName, Status);
2269 return Status;
2270 }
2271 else
2272 {
2273 /* Use the Io status */
2274 Status = OpenPacket.FinalStatus;
2275 }
2276
2277 /* Check if we were succesful and this was user mode and a full query */
2278 if ((NT_SUCCESS(Status)) && (AccessMode != KernelMode) && !(IsBasic))
2279 {
2280 /* Enter SEH for copy */
2281 _SEH2_TRY
2282 {
2283 /* Copy the buffer back */
2284 RtlCopyMemory(FileInformation,
2285 &NetworkOpenInfo,
2286 FileInformationSize);
2287 }
2288 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
2289 {
2290 /* Get exception code */
2291 Status = _SEH2_GetExceptionCode();
2292 }
2293 _SEH2_END;
2294 }
2295
2296 /* Return status */
2297 return Status;
2298 }
2299
2300 NTSTATUS
2301 NTAPI
2302 IopAcquireFileObjectLock(
2303 _In_ PFILE_OBJECT FileObject,
2304 _In_ KPROCESSOR_MODE WaitMode,
2305 _In_ BOOLEAN Alertable,
2306 _Out_ PBOOLEAN LockFailed)
2307 {
2308 NTSTATUS Status;
2309
2310 PAGED_CODE();
2311
2312 InterlockedIncrement((PLONG)&FileObject->Waiters);
2313
2314 Status = STATUS_SUCCESS;
2315 do
2316 {
2317 if (!InterlockedExchange((PLONG)&FileObject->Busy, TRUE))
2318 {
2319 break;
2320 }
2321 Status = KeWaitForSingleObject(&FileObject->Lock,
2322 Executive,
2323 WaitMode,
2324 Alertable,
2325 NULL);
2326 } while (Status == STATUS_SUCCESS);
2327
2328 InterlockedDecrement((PLONG)&FileObject->Waiters);
2329 if (Status == STATUS_SUCCESS)
2330 {
2331 ObReferenceObject(FileObject);
2332 *LockFailed = FALSE;
2333 }
2334 else
2335 {
2336 if (!FileObject->Busy && FileObject->Waiters)
2337 {
2338 KeSetEvent(&FileObject->Lock, IO_NO_INCREMENT, FALSE);
2339 }
2340 *LockFailed = TRUE;
2341 }
2342
2343 return Status;
2344 }
2345
2346 PVOID
2347 NTAPI
2348 IoGetFileObjectFilterContext(IN PFILE_OBJECT FileObject)
2349 {
2350 if (FileObject->Flags & FO_FILE_OBJECT_HAS_EXTENSION)
2351 {
2352 UNIMPLEMENTED;
2353 /* FIXME: return NULL for the moment ~ */
2354 return NULL;
2355 }
2356
2357 return NULL;
2358 }
2359
2360 NTSTATUS
2361 NTAPI
2362 IoChangeFileObjectFilterContext(IN PFILE_OBJECT FileObject,
2363 IN PVOID FilterContext,
2364 IN BOOLEAN Define)
2365 {
2366 if (!(FileObject->Flags & FO_FILE_OBJECT_HAS_EXTENSION))
2367 {
2368 return STATUS_INVALID_PARAMETER;
2369 }
2370
2371 UNIMPLEMENTED;
2372
2373 return STATUS_NOT_IMPLEMENTED;
2374 }
2375
2376 NTSTATUS
2377 NTAPI
2378 IopCreateFile(OUT PHANDLE FileHandle,
2379 IN ACCESS_MASK DesiredAccess,
2380 IN POBJECT_ATTRIBUTES ObjectAttributes,
2381 OUT PIO_STATUS_BLOCK IoStatusBlock,
2382 IN PLARGE_INTEGER AllocationSize OPTIONAL,
2383 IN ULONG FileAttributes,
2384 IN ULONG ShareAccess,
2385 IN ULONG Disposition,
2386 IN ULONG CreateOptions,
2387 IN PVOID EaBuffer OPTIONAL,
2388 IN ULONG EaLength,
2389 IN CREATE_FILE_TYPE CreateFileType,
2390 IN PVOID ExtraCreateParameters OPTIONAL,
2391 IN ULONG Options,
2392 IN ULONG Flags,
2393 IN PDEVICE_OBJECT DeviceObject OPTIONAL)
2394 {
2395 KPROCESSOR_MODE AccessMode;
2396 HANDLE LocalHandle = 0;
2397 LARGE_INTEGER SafeAllocationSize;
2398 NTSTATUS Status = STATUS_SUCCESS;
2399 PNAMED_PIPE_CREATE_PARAMETERS NamedPipeCreateParameters;
2400 POPEN_PACKET OpenPacket;
2401 ULONG EaErrorOffset;
2402 PAGED_CODE();
2403
2404 IOTRACE(IO_FILE_DEBUG, "FileName: %wZ\n", ObjectAttributes->ObjectName);
2405
2406
2407 /* Check if we have no parameter checking to do */
2408 if (Options & IO_NO_PARAMETER_CHECKING)
2409 {
2410 /* Then force kernel-mode access to avoid checks */
2411 AccessMode = KernelMode;
2412 }
2413 else
2414 {
2415 /* Otherwise, use the actual mode */
2416 AccessMode = ExGetPreviousMode();
2417 }
2418
2419 /* Check if we need to do parameter checking */
2420 if ((AccessMode != KernelMode) || (Options & IO_CHECK_CREATE_PARAMETERS))
2421 {
2422 /* Validate parameters */
2423 if (FileAttributes & ~FILE_ATTRIBUTE_VALID_FLAGS)
2424 {
2425 DPRINT1("File Create 'FileAttributes' Parameter contains invalid flags!\n");
2426 return STATUS_INVALID_PARAMETER;
2427 }
2428
2429 if (ShareAccess & ~FILE_SHARE_VALID_FLAGS)
2430 {
2431 DPRINT1("File Create 'ShareAccess' Parameter contains invalid flags!\n");
2432 return STATUS_INVALID_PARAMETER;
2433 }
2434
2435 if (Disposition > FILE_MAXIMUM_DISPOSITION)
2436 {
2437 DPRINT1("File Create 'Disposition' Parameter is out of range!\n");
2438 return STATUS_INVALID_PARAMETER;
2439 }
2440
2441 if (CreateOptions & ~FILE_VALID_OPTION_FLAGS)
2442 {
2443 DPRINT1("File Create 'CreateOptions' parameter contains invalid flags!\n");
2444 return STATUS_INVALID_PARAMETER;
2445 }
2446
2447 if ((CreateOptions & (FILE_SYNCHRONOUS_IO_ALERT | FILE_SYNCHRONOUS_IO_NONALERT)) &&
2448 (!(DesiredAccess & SYNCHRONIZE)))
2449 {
2450 DPRINT1("File Create 'CreateOptions' parameter FILE_SYNCHRONOUS_IO_* requested, but 'DesiredAccess' does not have SYNCHRONIZE!\n");
2451 return STATUS_INVALID_PARAMETER;
2452 }
2453
2454 if ((CreateOptions & FILE_DELETE_ON_CLOSE) && (!(DesiredAccess & DELETE)))
2455 {
2456 DPRINT1("File Create 'CreateOptions' parameter FILE_DELETE_ON_CLOSE requested, but 'DesiredAccess' does not have DELETE!\n");
2457 return STATUS_INVALID_PARAMETER;
2458 }
2459
2460 if ((CreateOptions & (FILE_SYNCHRONOUS_IO_NONALERT | FILE_SYNCHRONOUS_IO_ALERT)) ==
2461 (FILE_SYNCHRONOUS_IO_NONALERT | FILE_SYNCHRONOUS_IO_ALERT))
2462 {
2463 DPRINT1("File Create 'FileAttributes' parameter both FILE_SYNCHRONOUS_IO_NONALERT and FILE_SYNCHRONOUS_IO_ALERT specified!\n");
2464 return STATUS_INVALID_PARAMETER;
2465 }
2466
2467 if ((CreateOptions & FILE_DIRECTORY_FILE) && !(CreateOptions & FILE_NON_DIRECTORY_FILE) &&
2468 (CreateOptions & ~(FILE_DIRECTORY_FILE |
2469 FILE_SYNCHRONOUS_IO_ALERT |
2470 FILE_SYNCHRONOUS_IO_NONALERT |
2471 FILE_WRITE_THROUGH |
2472 FILE_COMPLETE_IF_OPLOCKED |
2473 FILE_OPEN_FOR_BACKUP_INTENT |
2474 FILE_DELETE_ON_CLOSE |
2475 FILE_OPEN_FOR_FREE_SPACE_QUERY |
2476 FILE_OPEN_BY_FILE_ID |
2477 FILE_NO_COMPRESSION |
2478 FILE_OPEN_REPARSE_POINT)))
2479 {
2480 DPRINT1("File Create 'CreateOptions' Parameter has flags incompatible with FILE_DIRECTORY_FILE!\n");
2481 return STATUS_INVALID_PARAMETER;
2482 }
2483
2484 if ((CreateOptions & FILE_DIRECTORY_FILE) && !(CreateOptions & FILE_NON_DIRECTORY_FILE) &&
2485 (Disposition != FILE_CREATE) && (Disposition != FILE_OPEN) && (Disposition != FILE_OPEN_IF))
2486 {
2487 DPRINT1("File Create 'CreateOptions' Parameter FILE_DIRECTORY_FILE requested, but 'Disposition' is not FILE_CREATE/FILE_OPEN/FILE_OPEN_IF!\n");
2488 return STATUS_INVALID_PARAMETER;
2489 }
2490
2491 if ((CreateOptions & FILE_COMPLETE_IF_OPLOCKED) && (CreateOptions & FILE_RESERVE_OPFILTER))
2492 {
2493 DPRINT1("File Create 'CreateOptions' Parameter both FILE_COMPLETE_IF_OPLOCKED and FILE_RESERVE_OPFILTER specified!\n");
2494 return STATUS_INVALID_PARAMETER;
2495 }
2496
2497 if ((CreateOptions & FILE_NO_INTERMEDIATE_BUFFERING) && (DesiredAccess & FILE_APPEND_DATA))
2498 {
2499 DPRINT1("File Create 'CreateOptions' parameter FILE_NO_INTERMEDIATE_BUFFERING requested, but 'DesiredAccess' FILE_APPEND_DATA requires it!\n");
2500 return STATUS_INVALID_PARAMETER;
2501 }
2502
2503 /* Now check if this is a named pipe */
2504 if (CreateFileType == CreateFileTypeNamedPipe)
2505 {
2506 /* Make sure we have extra parameters */
2507 if (!ExtraCreateParameters)
2508 {
2509 DPRINT1("Invalid parameter: ExtraCreateParameters == 0!\n");
2510 return STATUS_INVALID_PARAMETER;
2511 }
2512
2513 /* Get the parameters and validate them */
2514 NamedPipeCreateParameters = ExtraCreateParameters;
2515 if ((NamedPipeCreateParameters->NamedPipeType > FILE_PIPE_MESSAGE_TYPE) ||
2516 (NamedPipeCreateParameters->ReadMode > FILE_PIPE_MESSAGE_MODE) ||
2517 (NamedPipeCreateParameters->CompletionMode > FILE_PIPE_COMPLETE_OPERATION) ||
2518 (ShareAccess & FILE_SHARE_DELETE) ||
2519 ((Disposition < FILE_OPEN) || (Disposition > FILE_OPEN_IF)) ||
2520 (CreateOptions & ~FILE_VALID_PIPE_OPTION_FLAGS))
2521 {
2522 /* Invalid named pipe create */
2523 DPRINT1("Invalid named pipe create\n");
2524 return STATUS_INVALID_PARAMETER;
2525 }
2526 }
2527 else if (CreateFileType == CreateFileTypeMailslot)
2528 {
2529 /* Make sure we have extra parameters */
2530 if (!ExtraCreateParameters)
2531 {
2532 DPRINT1("Invalid parameter: ExtraCreateParameters == 0!\n");
2533 return STATUS_INVALID_PARAMETER;
2534 }
2535
2536 /* Get the parameters and validate them */
2537 if ((ShareAccess & FILE_SHARE_DELETE) ||
2538 !(ShareAccess & ~FILE_SHARE_WRITE) ||
2539 (Disposition != FILE_CREATE) ||
2540 (CreateOptions & ~FILE_VALID_MAILSLOT_OPTION_FLAGS))
2541 {
2542 /* Invalid mailslot create */
2543 DPRINT1("Invalid mailslot create\n");
2544 return STATUS_INVALID_PARAMETER;
2545 }
2546 }
2547 }
2548
2549 /* Allocate the open packet */
2550 OpenPacket = ExAllocatePoolWithTag(NonPagedPool, sizeof(*OpenPacket), 'pOoI');
2551 if (!OpenPacket) return STATUS_INSUFFICIENT_RESOURCES;
2552 RtlZeroMemory(OpenPacket, sizeof(*OpenPacket));
2553
2554 /* Check if the call came from user mode */
2555 if (AccessMode != KernelMode)
2556 {
2557 _SEH2_TRY
2558 {
2559 /* Probe the output parameters */
2560 ProbeForWriteHandle(FileHandle);
2561 ProbeForWriteIoStatusBlock(IoStatusBlock);
2562
2563 /* Probe the allocation size if one was passed in */
2564 if (AllocationSize)
2565 {
2566 SafeAllocationSize = ProbeForReadLargeInteger(AllocationSize);
2567 }
2568 else
2569 {
2570 SafeAllocationSize.QuadPart = 0;
2571 }
2572
2573 /* Make sure it's valid */
2574 if (SafeAllocationSize.QuadPart < 0)
2575 {
2576 RtlRaiseStatus(STATUS_INVALID_PARAMETER);
2577 }
2578
2579 /* Check if EA was passed in */
2580 if ((EaBuffer) && (EaLength))
2581 {
2582 /* Probe it */
2583 ProbeForRead(EaBuffer, EaLength, sizeof(ULONG));
2584
2585 /* And marshall it */
2586 OpenPacket->EaBuffer = ExAllocatePoolWithTag(NonPagedPool,
2587 EaLength,
2588 TAG_EA);
2589 OpenPacket->EaLength = EaLength;
2590 RtlCopyMemory(OpenPacket->EaBuffer, EaBuffer, EaLength);
2591
2592 /* Validate the buffer */
2593 Status = IoCheckEaBufferValidity(OpenPacket->EaBuffer,
2594 EaLength,
2595 &EaErrorOffset);
2596 if (!NT_SUCCESS(Status))
2597 {
2598 /* Undo everything if it's invalid */
2599 DPRINT1("Invalid EA buffer\n");
2600 IoStatusBlock->Status = Status;
2601 IoStatusBlock->Information = EaErrorOffset;
2602 RtlRaiseStatus(Status);
2603 }
2604 }
2605 }
2606 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
2607 {
2608 /* Return the exception code */
2609 if (OpenPacket->EaBuffer != NULL) ExFreePool(OpenPacket->EaBuffer);
2610 ExFreePool(OpenPacket);
2611 _SEH2_YIELD(return _SEH2_GetExceptionCode());
2612 }
2613 _SEH2_END;
2614 }
2615 else
2616 {
2617 /* Check if this is a device attach */
2618 if (CreateOptions & IO_ATTACH_DEVICE_API)
2619 {
2620 /* Set the flag properly */
2621 Options |= IO_ATTACH_DEVICE;
2622 CreateOptions &= ~IO_ATTACH_DEVICE_API;
2623 }
2624
2625 /* Check if we have allocation size */
2626 if (AllocationSize)
2627 {
2628 /* Capture it */
2629 SafeAllocationSize = *AllocationSize;
2630 }
2631 else
2632 {
2633 /* Otherwise, no size */
2634 SafeAllocationSize.QuadPart = 0;
2635 }
2636
2637 /* Check if we have an EA packet */
2638 if ((EaBuffer) && (EaLength))
2639 {
2640 /* Allocate the kernel copy */
2641 OpenPacket->EaBuffer = ExAllocatePoolWithTag(NonPagedPool,
2642 EaLength,
2643 TAG_EA);
2644 if (!OpenPacket->EaBuffer)
2645 {
2646 ExFreePool(OpenPacket);
2647 DPRINT1("Failed to allocate open packet EA buffer\n");
2648 return STATUS_INSUFFICIENT_RESOURCES;
2649 }
2650
2651 /* Copy the data */
2652 OpenPacket->EaLength = EaLength;
2653 RtlCopyMemory(OpenPacket->EaBuffer, EaBuffer, EaLength);
2654
2655 /* Validate the buffer */
2656 Status = IoCheckEaBufferValidity(OpenPacket->EaBuffer,
2657 EaLength,
2658 &EaErrorOffset);
2659 if (!NT_SUCCESS(Status))
2660 {
2661 /* Undo everything if it's invalid */
2662 DPRINT1("Invalid EA buffer\n");
2663 ExFreePool(OpenPacket->EaBuffer);
2664 IoStatusBlock->Status = Status;
2665 IoStatusBlock->Information = EaErrorOffset;
2666 ExFreePool(OpenPacket);
2667 return Status;
2668 }
2669 }
2670 }
2671
2672 /* Setup the Open Packet */
2673 OpenPacket->Type = IO_TYPE_OPEN_PACKET;
2674 OpenPacket->Size = sizeof(*OpenPacket);
2675 OpenPacket->AllocationSize = SafeAllocationSize;
2676 OpenPacket->CreateOptions = CreateOptions;
2677 OpenPacket->FileAttributes = (USHORT)FileAttributes;
2678 OpenPacket->ShareAccess = (USHORT)ShareAccess;
2679 OpenPacket->Options = Options;
2680 OpenPacket->Disposition = Disposition;
2681 OpenPacket->CreateFileType = CreateFileType;
2682 OpenPacket->ExtraCreateParameters = ExtraCreateParameters;
2683 OpenPacket->InternalFlags = Flags;
2684 OpenPacket->TopDeviceObjectHint = DeviceObject;
2685
2686 /* Update the operation count */
2687 IopUpdateOperationCount(IopOtherTransfer);
2688
2689 /*
2690 * Attempt opening the file. This will call the I/O Parse Routine for
2691 * the File Object (IopParseDevice) which will create the object and
2692 * send the IRP to its device object. Note that we have two statuses
2693 * to worry about: the Object Manager's status (in Status) and the I/O
2694 * status, which is in the Open Packet's Final Status, and determined
2695 * by the Parse Check member.
2696 */
2697 Status = ObOpenObjectByName(ObjectAttributes,
2698 NULL,
2699 AccessMode,
2700 NULL,
2701 DesiredAccess,
2702 OpenPacket,
2703 &LocalHandle);
2704
2705 /* Free the EA Buffer */
2706 if (OpenPacket->EaBuffer) ExFreePool(OpenPacket->EaBuffer);
2707
2708 /* Now check for Ob or Io failure */
2709 if (!(NT_SUCCESS(Status)) || (OpenPacket->ParseCheck == FALSE))
2710 {
2711 /* Check if Ob thinks well went well */
2712 if (NT_SUCCESS(Status))
2713 {
2714 /*
2715 * Tell it otherwise. Because we didn't use an ObjectType,
2716 * it incorrectly returned us a handle to God knows what.
2717 */
2718 ZwClose(LocalHandle);
2719 Status = STATUS_OBJECT_TYPE_MISMATCH;
2720 }
2721
2722 /* Now check the Io status */
2723 if (!NT_SUCCESS(OpenPacket->FinalStatus))
2724 {
2725 /* Use this status instead of Ob's */
2726 Status = OpenPacket->FinalStatus;
2727
2728 /* Check if it was only a warning */
2729 if (NT_WARNING(Status))
2730 {
2731 /* Protect write with SEH */
2732 _SEH2_TRY
2733 {
2734 /* In this case, we copy the I/O Status back */
2735 IoStatusBlock->Information = OpenPacket->Information;
2736 IoStatusBlock->Status = OpenPacket->FinalStatus;
2737 }
2738 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
2739 {
2740 /* Get exception code */
2741 Status = _SEH2_GetExceptionCode();
2742 }
2743 _SEH2_END;
2744 }
2745 }
2746 else if ((OpenPacket->FileObject) && (OpenPacket->ParseCheck == FALSE))
2747 {
2748 /*
2749 * This can happen in the very bizarre case where the parse routine
2750 * actually executed more then once (due to a reparse) and ended
2751 * up failing after already having created the File Object.
2752 */
2753 if (OpenPacket->FileObject->FileName.Length)
2754 {
2755 /* It had a name, free it */
2756 ExFreePoolWithTag(OpenPacket->FileObject->FileName.Buffer, TAG_IO_NAME);
2757 }
2758
2759 /* Clear the device object to invalidate the FO, and dereference */
2760 OpenPacket->FileObject->DeviceObject = NULL;
2761 ObDereferenceObject(OpenPacket->FileObject);
2762 }
2763 }
2764 else
2765 {
2766 /* We reached success and have a valid file handle */
2767 OpenPacket->FileObject->Flags |= FO_HANDLE_CREATED;
2768 ASSERT(OpenPacket->FileObject->Type == IO_TYPE_FILE);
2769
2770 /* Enter SEH for write back */
2771 _SEH2_TRY
2772 {
2773 /* Write back the handle and I/O Status */
2774 *FileHandle = LocalHandle;
2775 IoStatusBlock->Information = OpenPacket->Information;
2776 IoStatusBlock->Status = OpenPacket->FinalStatus;
2777
2778 /* Get the Io status */
2779 Status = OpenPacket->FinalStatus;
2780 }
2781 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
2782 {
2783 /* Get the exception status */
2784 Status = _SEH2_GetExceptionCode();
2785 }
2786 _SEH2_END;
2787 }
2788
2789 /* Check if we were 100% successful */
2790 if ((OpenPacket->ParseCheck != FALSE) && (OpenPacket->FileObject))
2791 {
2792 /* Dereference the File Object */
2793 ObDereferenceObject(OpenPacket->FileObject);
2794 }
2795
2796 /* Return status */
2797 ExFreePool(OpenPacket);
2798 return Status;
2799 }
2800
2801 /* FUNCTIONS *****************************************************************/
2802
2803 /*
2804 * @unimplemented
2805 */
2806 NTSTATUS
2807 NTAPI
2808 IoCheckQuerySetFileInformation(IN FILE_INFORMATION_CLASS FileInformationClass,
2809 IN ULONG Length,
2810 IN BOOLEAN SetOperation)
2811 {
2812 UNIMPLEMENTED;
2813 return STATUS_NOT_IMPLEMENTED;
2814 }
2815
2816 /*
2817 * @unimplemented
2818 */
2819 NTSTATUS
2820 NTAPI
2821 IoCheckQuotaBufferValidity(IN PFILE_QUOTA_INFORMATION QuotaBuffer,
2822 IN ULONG QuotaLength,
2823 OUT PULONG ErrorOffset)
2824 {
2825 UNIMPLEMENTED;
2826 return STATUS_NOT_IMPLEMENTED;
2827 }
2828
2829 /*
2830 * @implemented
2831 */
2832 NTSTATUS
2833 NTAPI
2834 IoCreateFile(OUT PHANDLE FileHandle,
2835 IN ACCESS_MASK DesiredAccess,
2836 IN POBJECT_ATTRIBUTES ObjectAttributes,
2837 OUT PIO_STATUS_BLOCK IoStatusBlock,
2838 IN PLARGE_INTEGER AllocationSize OPTIONAL,
2839 IN ULONG FileAttributes,
2840 IN ULONG ShareAccess,
2841 IN ULONG Disposition,
2842 IN ULONG CreateOptions,
2843 IN PVOID EaBuffer OPTIONAL,
2844 IN ULONG EaLength,
2845 IN CREATE_FILE_TYPE CreateFileType,
2846 IN PVOID ExtraCreateParameters OPTIONAL,
2847 IN ULONG Options)
2848 {
2849 PAGED_CODE();
2850
2851 return IopCreateFile(FileHandle,
2852 DesiredAccess,
2853 ObjectAttributes,
2854 IoStatusBlock,
2855 AllocationSize,
2856 FileAttributes,
2857 ShareAccess,
2858 Disposition,
2859 CreateOptions,
2860 EaBuffer,
2861 EaLength,
2862 CreateFileType,
2863 ExtraCreateParameters,
2864 Options,
2865 0,
2866 NULL);
2867 }
2868
2869 /*
2870 * @unimplemented
2871 */
2872 NTSTATUS
2873 NTAPI
2874 IoCreateFileSpecifyDeviceObjectHint(OUT PHANDLE FileHandle,
2875 IN ACCESS_MASK DesiredAccess,
2876 IN POBJECT_ATTRIBUTES ObjectAttributes,
2877 OUT PIO_STATUS_BLOCK IoStatusBlock,
2878 IN PLARGE_INTEGER AllocationSize OPTIONAL,
2879 IN ULONG FileAttributes,
2880 IN ULONG ShareAccess,
2881 IN ULONG Disposition,
2882 IN ULONG CreateOptions,
2883 IN PVOID EaBuffer OPTIONAL,
2884 IN ULONG EaLength,
2885 IN CREATE_FILE_TYPE CreateFileType,
2886 IN PVOID ExtraCreateParameters OPTIONAL,
2887 IN ULONG Options,
2888 IN PVOID DeviceObject)
2889 {
2890 ULONG Flags = 0;
2891
2892 PAGED_CODE();
2893
2894 /* Check if we were passed a device to send the create request to*/
2895 if (DeviceObject)
2896 {
2897 /* We'll tag this request into a file object extension */
2898 Flags = (IOP_CREATE_FILE_OBJECT_EXTENSION | IOP_USE_TOP_LEVEL_DEVICE_HINT);
2899 }
2900
2901 return IopCreateFile(FileHandle,
2902 DesiredAccess,
2903 ObjectAttributes,
2904 IoStatusBlock,
2905 AllocationSize,
2906 FileAttributes,
2907 ShareAccess,
2908 Disposition,
2909 CreateOptions,
2910 EaBuffer,
2911 EaLength,
2912 CreateFileType,
2913 ExtraCreateParameters,
2914 Options | IO_NO_PARAMETER_CHECKING,
2915 Flags,
2916 DeviceObject);
2917 }
2918
2919 /*
2920 * @implemented
2921 */
2922 PFILE_OBJECT
2923 NTAPI
2924 IoCreateStreamFileObjectEx(IN PFILE_OBJECT FileObject OPTIONAL,
2925 IN PDEVICE_OBJECT DeviceObject OPTIONAL,
2926 OUT PHANDLE FileObjectHandle OPTIONAL)
2927 {
2928 PFILE_OBJECT CreatedFileObject;
2929 NTSTATUS Status;
2930 HANDLE FileHandle;
2931 OBJECT_ATTRIBUTES ObjectAttributes;
2932 PAGED_CODE();
2933 IOTRACE(IO_FILE_DEBUG, "FileObject: %p\n", FileObject);
2934
2935 /* Choose Device Object */
2936 if (FileObject) DeviceObject = FileObject->DeviceObject;
2937
2938 /* Reference the device object and initialize attributes */
2939 InterlockedIncrement(&DeviceObject->ReferenceCount);
2940 InitializeObjectAttributes(&ObjectAttributes, NULL, 0, NULL, NULL);
2941
2942 /* Create the File Object */
2943 Status = ObCreateObject(KernelMode,
2944 IoFileObjectType,
2945 &ObjectAttributes,
2946 KernelMode,
2947 NULL,
2948 sizeof(FILE_OBJECT),
2949 sizeof(FILE_OBJECT),
2950 0,
2951 (PVOID*)&CreatedFileObject);
2952 if (!NT_SUCCESS(Status))
2953 {
2954 /* Fail */
2955 IopDereferenceDeviceObject(DeviceObject, FALSE);
2956 ExRaiseStatus(Status);
2957 }
2958
2959 /* Set File Object Data */
2960 RtlZeroMemory(CreatedFileObject, sizeof(FILE_OBJECT));
2961 CreatedFileObject->DeviceObject = DeviceObject;
2962 CreatedFileObject->Type = IO_TYPE_FILE;
2963 CreatedFileObject->Size = sizeof(FILE_OBJECT);
2964 CreatedFileObject->Flags = FO_STREAM_FILE;
2965
2966 /* Initialize the wait event */
2967 KeInitializeEvent(&CreatedFileObject->Event, SynchronizationEvent, FALSE);
2968
2969 /* Insert it to create a handle for it */
2970 Status = ObInsertObject(CreatedFileObject,
2971 NULL,
2972 FILE_READ_DATA,
2973 1,
2974 (PVOID*)&CreatedFileObject,
2975 &FileHandle);
2976 if (!NT_SUCCESS(Status)) ExRaiseStatus(Status);
2977
2978 /* Set the handle created flag */
2979 CreatedFileObject->Flags |= FO_HANDLE_CREATED;
2980 ASSERT(CreatedFileObject->Type == IO_TYPE_FILE);
2981
2982 /* Check if we have a VPB */
2983 if (DeviceObject->Vpb)
2984 {
2985 /* Reference it */
2986 InterlockedIncrement((PLONG)&DeviceObject->Vpb->ReferenceCount);
2987 }
2988
2989 /* Check if the caller wants the handle */
2990 if (FileObjectHandle)
2991 {
2992 /* Return it */
2993 *FileObjectHandle = FileHandle;
2994 ObDereferenceObject(CreatedFileObject);
2995 }
2996 else
2997 {
2998 /* Otherwise, close it */
2999 ObCloseHandle(FileHandle, KernelMode);
3000 }
3001
3002 /* Return the file object */
3003 return CreatedFileObject;
3004 }
3005
3006 /*
3007 * @implemented
3008 */
3009 PFILE_OBJECT
3010 NTAPI
3011 IoCreateStreamFileObject(IN PFILE_OBJECT FileObject,
3012 IN PDEVICE_OBJECT DeviceObject)
3013 {
3014 /* Call the newer function */
3015 return IoCreateStreamFileObjectEx(FileObject, DeviceObject, NULL);
3016 }
3017
3018 /*
3019 * @implemented
3020 */
3021 PFILE_OBJECT
3022 NTAPI
3023 IoCreateStreamFileObjectLite(IN PFILE_OBJECT FileObject OPTIONAL,
3024 IN PDEVICE_OBJECT DeviceObject OPTIONAL)
3025 {
3026 PFILE_OBJECT CreatedFileObject;
3027 NTSTATUS Status;
3028 OBJECT_ATTRIBUTES ObjectAttributes;
3029 PAGED_CODE();
3030 IOTRACE(IO_FILE_DEBUG, "FileObject: %p\n", FileObject);
3031
3032 /* Choose Device Object */
3033 if (FileObject) DeviceObject = FileObject->DeviceObject;
3034
3035 /* Reference the device object and initialize attributes */
3036 InterlockedIncrement(&DeviceObject->ReferenceCount);
3037 InitializeObjectAttributes(&ObjectAttributes, NULL, 0, NULL, NULL);
3038
3039 /* Create the File Object */
3040 Status = ObCreateObject(KernelMode,
3041 IoFileObjectType,
3042 &ObjectAttributes,
3043 KernelMode,
3044 NULL,
3045 sizeof(FILE_OBJECT),
3046 sizeof(FILE_OBJECT),
3047 0,
3048 (PVOID*)&CreatedFileObject);
3049 if (!NT_SUCCESS(Status))
3050 {
3051 /* Fail */
3052 IopDereferenceDeviceObject(DeviceObject, FALSE);
3053 ExRaiseStatus(Status);
3054 }
3055
3056 /* Set File Object Data */
3057 RtlZeroMemory(CreatedFileObject, sizeof(FILE_OBJECT));
3058 CreatedFileObject->DeviceObject = DeviceObject;
3059 CreatedFileObject->Type = IO_TYPE_FILE;
3060 CreatedFileObject->Size = sizeof(FILE_OBJECT);
3061 CreatedFileObject->Flags = FO_STREAM_FILE;
3062
3063 /* Initialize the wait event */
3064 KeInitializeEvent(&CreatedFileObject->Event, SynchronizationEvent, FALSE);
3065
3066 /* Destroy create information */
3067 ObFreeObjectCreateInfoBuffer(OBJECT_TO_OBJECT_HEADER(CreatedFileObject)->
3068 ObjectCreateInfo);
3069 OBJECT_TO_OBJECT_HEADER(CreatedFileObject)->ObjectCreateInfo = NULL;
3070
3071 /* Set the handle created flag */
3072 CreatedFileObject->Flags |= FO_HANDLE_CREATED;
3073 ASSERT(CreatedFileObject->Type == IO_TYPE_FILE);
3074
3075 /* Check if we have a VPB */
3076 if (DeviceObject->Vpb)
3077 {
3078 /* Reference it */
3079 InterlockedIncrement((PLONG)&DeviceObject->Vpb->ReferenceCount);
3080 }
3081
3082 /* Return the file object */
3083 return CreatedFileObject;
3084 }
3085
3086 /*
3087 * @implemented
3088 */
3089 PGENERIC_MAPPING
3090 NTAPI
3091 IoGetFileObjectGenericMapping(VOID)
3092 {
3093 /* Return the mapping */
3094 return &IopFileMapping;
3095 }
3096
3097 /*
3098 * @implemented
3099 */
3100 BOOLEAN
3101 NTAPI
3102 IoIsFileOriginRemote(IN PFILE_OBJECT FileObject)
3103 {
3104 /* Return the flag status */
3105 return FileObject->Flags & FO_REMOTE_ORIGIN ? TRUE : FALSE;
3106 }
3107
3108 /*
3109 * @implemented
3110 */
3111 BOOLEAN
3112 NTAPI
3113 IoFastQueryNetworkAttributes(IN POBJECT_ATTRIBUTES ObjectAttributes,
3114 IN ACCESS_MASK DesiredAccess,
3115 IN ULONG OpenOptions,
3116 OUT PIO_STATUS_BLOCK IoStatus,
3117 OUT PFILE_NETWORK_OPEN_INFORMATION Buffer)
3118 {
3119 NTSTATUS Status;
3120 DUMMY_FILE_OBJECT LocalFileObject;
3121 HANDLE Handle;
3122 OPEN_PACKET OpenPacket;
3123 PAGED_CODE();
3124 IOTRACE(IO_FILE_DEBUG, "FileName: %wZ\n", ObjectAttributes->ObjectName);
3125
3126 /* Setup the Open Packet */
3127 RtlZeroMemory(&OpenPacket, sizeof(OPEN_PACKET));
3128 OpenPacket.Type = IO_TYPE_OPEN_PACKET;
3129 OpenPacket.Size = sizeof(OPEN_PACKET);
3130 OpenPacket.CreateOptions = OpenOptions | FILE_OPEN_REPARSE_POINT;
3131 OpenPacket.ShareAccess = FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE;
3132 OpenPacket.Options = IO_FORCE_ACCESS_CHECK;
3133 OpenPacket.Disposition = FILE_OPEN;
3134 OpenPacket.NetworkInformation = Buffer;
3135 OpenPacket.QueryOnly = TRUE;
3136 OpenPacket.FullAttributes = TRUE;
3137 OpenPacket.LocalFileObject = &LocalFileObject;
3138
3139 /*
3140 * Attempt opening the file. This will call the I/O Parse Routine for
3141 * the File Object (IopParseDevice) which will use the dummy file obejct
3142 * send the IRP to its device object. Note that we have two statuses
3143 * to worry about: the Object Manager's status (in Status) and the I/O
3144 * status, which is in the Open Packet's Final Status, and determined
3145 * by the Parse Check member.
3146 */
3147 Status = ObOpenObjectByName(ObjectAttributes,
3148 NULL,
3149 KernelMode,
3150 NULL,
3151 DesiredAccess,
3152 &OpenPacket,
3153 &Handle);
3154 if (OpenPacket.ParseCheck == FALSE)
3155 {
3156 /* Parse failed */
3157 IoStatus->Status = Status;
3158 }
3159 else
3160 {
3161 /* Use the Io status */
3162 IoStatus->Status = OpenPacket.FinalStatus;
3163 IoStatus->Information = OpenPacket.Information;
3164 }
3165
3166 /* Return success */
3167 return TRUE;
3168 }
3169
3170 /*
3171 * @implemented
3172 */
3173 VOID
3174 NTAPI
3175 IoUpdateShareAccess(IN PFILE_OBJECT FileObject,
3176 OUT PSHARE_ACCESS ShareAccess)
3177 {
3178 PAGED_CODE();
3179
3180 /* Check if the file has an extension */
3181 if (FileObject->Flags & FO_FILE_OBJECT_HAS_EXTENSION)
3182 {
3183 /* Check if caller specified to ignore access checks */
3184 //if (FileObject->FoExtFlags & IO_IGNORE_SHARE_ACCESS_CHECK)
3185 {
3186 /* Don't update share access */
3187 return;
3188 }
3189 }
3190
3191 /* Otherwise, check if there's any access present */
3192 if ((FileObject->ReadAccess) ||
3193 (FileObject->WriteAccess) ||
3194 (FileObject->DeleteAccess))
3195 {
3196 /* Increase the open count */
3197 ShareAccess->OpenCount++;
3198
3199 /* Add new share access */
3200 ShareAccess->Readers += FileObject->ReadAccess;
3201 ShareAccess->Writers += FileObject->WriteAccess;
3202 ShareAccess->Deleters += FileObject->DeleteAccess;
3203 ShareAccess->SharedRead += FileObject->SharedRead;
3204 ShareAccess->SharedWrite += FileObject->SharedWrite;
3205 ShareAccess->SharedDelete += FileObject->SharedDelete;
3206 }
3207 }
3208
3209 /*
3210 * @implemented
3211 */
3212 NTSTATUS
3213 NTAPI
3214 IoCheckShareAccess(IN ACCESS_MASK DesiredAccess,
3215 IN ULONG DesiredShareAccess,
3216 IN PFILE_OBJECT FileObject,
3217 IN PSHARE_ACCESS ShareAccess,
3218 IN BOOLEAN Update)
3219 {
3220 BOOLEAN ReadAccess;
3221 BOOLEAN WriteAccess;
3222 BOOLEAN DeleteAccess;
3223 BOOLEAN SharedRead;
3224 BOOLEAN SharedWrite;
3225 BOOLEAN SharedDelete;
3226 PAGED_CODE();
3227
3228 /* Get access masks */
3229 ReadAccess = (DesiredAccess & (FILE_READ_DATA | FILE_EXECUTE)) != 0;
3230 WriteAccess = (DesiredAccess & (FILE_WRITE_DATA | FILE_APPEND_DATA)) != 0;
3231 DeleteAccess = (DesiredAccess & DELETE) != 0;
3232
3233 /* Set them in the file object */
3234 FileObject->ReadAccess = ReadAccess;
3235 FileObject->WriteAccess = WriteAccess;
3236 FileObject->DeleteAccess = DeleteAccess;
3237
3238 /* Check if the file has an extension */
3239 if (FileObject->Flags & FO_FILE_OBJECT_HAS_EXTENSION)
3240 {
3241 /* Check if caller specified to ignore access checks */
3242 //if (FileObject->FoExtFlags & IO_IGNORE_SHARE_ACCESS_CHECK)
3243 {
3244 /* Don't check share access */
3245 return STATUS_SUCCESS;
3246 }
3247 }
3248
3249 /* Check if we have any access */
3250 if ((ReadAccess) || (WriteAccess) || (DeleteAccess))
3251 {
3252 /* Get shared access masks */
3253 SharedRead = (DesiredShareAccess & FILE_SHARE_READ) != 0;
3254 SharedWrite = (DesiredShareAccess & FILE_SHARE_WRITE) != 0;
3255 SharedDelete = (DesiredShareAccess & FILE_SHARE_DELETE) != 0;
3256
3257 /* Set them */
3258 FileObject->SharedRead = SharedRead;
3259 FileObject->SharedWrite = SharedWrite;
3260 FileObject->SharedDelete = SharedDelete;
3261
3262 /* Check if the shared access is violated */
3263 if ((ReadAccess &&
3264 (ShareAccess->SharedRead < ShareAccess->OpenCount)) ||
3265 (WriteAccess &&
3266 (ShareAccess->SharedWrite < ShareAccess->OpenCount)) ||
3267 (DeleteAccess &&
3268 (ShareAccess->SharedDelete < ShareAccess->OpenCount)) ||
3269 ((ShareAccess->Readers != 0) && !SharedRead) ||
3270 ((ShareAccess->Writers != 0) && !SharedWrite) ||
3271 ((ShareAccess->Deleters != 0) && !SharedDelete))
3272 {
3273 /* Sharing violation, fail */
3274 return STATUS_SHARING_VIOLATION;
3275 }
3276
3277 /* It's not, check if caller wants us to update it */
3278 if (Update)
3279 {
3280 /* Increase open count */
3281 ShareAccess->OpenCount++;
3282
3283 /* Update shared access */
3284 ShareAccess->Readers += ReadAccess;
3285 ShareAccess->Writers += WriteAccess;
3286 ShareAccess->Deleters += DeleteAccess;
3287 ShareAccess->SharedRead += SharedRead;
3288 ShareAccess->SharedWrite += SharedWrite;
3289 ShareAccess->SharedDelete += SharedDelete;
3290 }
3291 }
3292
3293 /* Validation successful */
3294 return STATUS_SUCCESS;
3295 }
3296
3297 /*
3298 * @implemented
3299 */
3300 VOID
3301 NTAPI
3302 IoRemoveShareAccess(IN PFILE_OBJECT FileObject,
3303 IN PSHARE_ACCESS ShareAccess)
3304 {
3305 PAGED_CODE();
3306
3307 /* Check if the file has an extension */
3308 if (FileObject->Flags & FO_FILE_OBJECT_HAS_EXTENSION)
3309 {
3310 /* Check if caller specified to ignore access checks */
3311 //if (FileObject->FoExtFlags & IO_IGNORE_SHARE_ACCESS_CHECK)
3312 {
3313 /* Don't update share access */
3314 return;
3315 }
3316 }
3317
3318 /* Otherwise, check if there's any access present */
3319 if ((FileObject->ReadAccess) ||
3320 (FileObject->WriteAccess) ||
3321 (FileObject->DeleteAccess))
3322 {
3323 /* Decrement the open count */
3324 ShareAccess->OpenCount--;
3325
3326 /* Remove share access */
3327 ShareAccess->Readers -= FileObject->ReadAccess;
3328 ShareAccess->Writers -= FileObject->WriteAccess;
3329 ShareAccess->Deleters -= FileObject->DeleteAccess;
3330 ShareAccess->SharedRead -= FileObject->SharedRead;
3331 ShareAccess->SharedWrite -= FileObject->SharedWrite;
3332 ShareAccess->SharedDelete -= FileObject->SharedDelete;
3333 }
3334 }
3335
3336 /*
3337 * @implemented
3338 */
3339 VOID
3340 NTAPI
3341 IoSetShareAccess(IN ACCESS_MASK DesiredAccess,
3342 IN ULONG DesiredShareAccess,
3343 IN PFILE_OBJECT FileObject,
3344 OUT PSHARE_ACCESS ShareAccess)
3345 {
3346 BOOLEAN ReadAccess;
3347 BOOLEAN WriteAccess;
3348 BOOLEAN DeleteAccess;
3349 BOOLEAN SharedRead;
3350 BOOLEAN SharedWrite;
3351 BOOLEAN SharedDelete;
3352 BOOLEAN Update = TRUE;
3353 PAGED_CODE();
3354
3355 ReadAccess = (DesiredAccess & (FILE_READ_DATA | FILE_EXECUTE)) != 0;
3356 WriteAccess = (DesiredAccess & (FILE_WRITE_DATA | FILE_APPEND_DATA)) != 0;
3357 DeleteAccess = (DesiredAccess & DELETE) != 0;
3358
3359 /* Check if the file has an extension */
3360 if (FileObject->Flags & FO_FILE_OBJECT_HAS_EXTENSION)
3361 {
3362 /* Check if caller specified to ignore access checks */
3363 //if (FileObject->FoExtFlags & IO_IGNORE_SHARE_ACCESS_CHECK)
3364 {
3365 /* Don't update share access */
3366 Update = FALSE;
3367 }
3368 }
3369
3370 /* Update basic access */
3371 FileObject->ReadAccess = ReadAccess;
3372 FileObject->WriteAccess = WriteAccess;
3373 FileObject->DeleteAccess = DeleteAccess;
3374
3375 /* Check if we have no access as all */
3376 if (!(ReadAccess) && !(WriteAccess) && !(DeleteAccess))
3377 {
3378 /* Check if we need to update the structure */
3379 if (!Update) return;
3380
3381 /* Otherwise, clear data */
3382 ShareAccess->OpenCount = 0;
3383 ShareAccess->Readers = 0;
3384 ShareAccess->Writers = 0;
3385 ShareAccess->Deleters = 0;
3386 ShareAccess->SharedRead = 0;
3387 ShareAccess->SharedWrite = 0;
3388 ShareAccess->SharedDelete = 0;
3389 }
3390 else
3391 {
3392 /* Calculate shared access */
3393 SharedRead = (DesiredShareAccess & FILE_SHARE_READ) != 0;
3394 SharedWrite = (DesiredShareAccess & FILE_SHARE_WRITE) != 0;
3395 SharedDelete = (DesiredShareAccess & FILE_SHARE_DELETE) != 0;
3396
3397 /* Set it in the FO */
3398 FileObject->SharedRead = SharedRead;
3399 FileObject->SharedWrite = SharedWrite;
3400 FileObject->SharedDelete = SharedDelete;
3401
3402 /* Check if we need to update the structure */
3403 if (!Update) return;
3404
3405 /* Otherwise, set data */
3406 ShareAccess->OpenCount = 1;
3407 ShareAccess->Readers = ReadAccess;
3408 ShareAccess->Writers = WriteAccess;
3409 ShareAccess->Deleters = DeleteAccess;
3410 ShareAccess->SharedRead = SharedRead;
3411 ShareAccess->SharedWrite = SharedWrite;
3412 ShareAccess->SharedDelete = SharedDelete;
3413 }
3414 }
3415
3416 /*
3417 * @implemented
3418 */
3419 VOID
3420 NTAPI
3421 IoCancelFileOpen(IN PDEVICE_OBJECT DeviceObject,
3422 IN PFILE_OBJECT FileObject)
3423 {
3424 PIRP Irp;
3425 KEVENT Event;
3426 KIRQL OldIrql;
3427 NTSTATUS Status;
3428 PIO_STACK_LOCATION Stack;
3429
3430 /* Check if handles were already created for the
3431 * open file. If so, that's over.
3432 */
3433 if (FileObject->Flags & FO_HANDLE_CREATED)
3434 KeBugCheckEx(INVALID_CANCEL_OF_FILE_OPEN,
3435 (ULONG_PTR)FileObject,
3436 (ULONG_PTR)DeviceObject, 0, 0);
3437
3438 /* Reset the events */
3439 KeInitializeEvent(&Event, SynchronizationEvent, FALSE);
3440 KeClearEvent(&FileObject->Event);
3441
3442 /* Allocate the IRP we'll use */
3443 Irp = IopAllocateIrpMustSucceed(DeviceObject->StackSize);
3444 /* Properly set it */
3445 Irp->Tail.Overlay.Thread = PsGetCurrentThread();
3446 Irp->UserEvent = &Event;
3447 Irp->UserIosb = &Irp->IoStatus;
3448 Irp->Overlay.AsynchronousParameters.UserApcRoutine = NULL;
3449 Irp->Tail.Overlay.OriginalFileObject = FileObject;
3450 Irp->RequestorMode = KernelMode;
3451 Irp->Flags = IRP_CLOSE_OPERATION | IRP_SYNCHRONOUS_API;
3452
3453 Stack = IoGetNextIrpStackLocation(Irp);
3454 Stack->MajorFunction = IRP_MJ_CLEANUP;
3455 Stack->FileObject = FileObject;
3456
3457 /* Put on top of IRPs list of the thread */
3458 IopQueueIrpToThread(Irp);
3459
3460 /* Call the driver */
3461 Status = IoCallDriver(DeviceObject, Irp);
3462 if (Status == STATUS_PENDING)
3463 {
3464 KeWaitForSingleObject(&Event, UserRequest,
3465 KernelMode, FALSE, NULL);
3466 }
3467
3468 /* Remove from IRPs list */
3469 KeRaiseIrql(APC_LEVEL, &OldIrql);
3470 IopUnQueueIrpFromThread(Irp);
3471 KeLowerIrql(OldIrql);
3472
3473 /* Free the IRP */
3474 IoFreeIrp(Irp);
3475
3476 /* Clear the event */
3477 KeClearEvent(&FileObject->Event);
3478 /* And finally, mark the open operation as canceled */
3479 FileObject->Flags |= FO_FILE_OPEN_CANCELLED;
3480 }
3481
3482 /*
3483 * @implemented
3484 */
3485 NTSTATUS
3486 NTAPI
3487 IoQueryFileDosDeviceName(IN PFILE_OBJECT FileObject,
3488 OUT POBJECT_NAME_INFORMATION *ObjectNameInformation)
3489 {
3490 NTSTATUS Status;
3491 ULONG Length, ReturnLength;
3492 POBJECT_NAME_INFORMATION LocalInfo;
3493
3494 /* Start with a buffer length of 200 */
3495 ReturnLength = 200;
3496 /*
3497 * We'll loop until query works.
3498 * We will use returned length for next loop
3499 * iteration, trying to have a big enough buffer.
3500 */
3501 for (Length = 200; ; Length = ReturnLength)
3502 {
3503 /* Allocate our work buffer */
3504 LocalInfo = ExAllocatePoolWithTag(PagedPool, Length, 'nDoI');
3505 if (LocalInfo == NULL)
3506 {
3507 return STATUS_INSUFFICIENT_RESOURCES;
3508 }
3509
3510 /* Query the DOS name */
3511 Status = IopQueryNameInternal(FileObject,
3512 TRUE,
3513 TRUE,
3514 LocalInfo,
3515 Length,
3516 &ReturnLength,
3517 KernelMode);
3518 /* If it succeed, nothing more to do */
3519 if (Status == STATUS_SUCCESS)
3520 {
3521 break;
3522 }
3523
3524 /* Otherwise, prepare for re-allocation */
3525 ExFreePoolWithTag(LocalInfo, 'nDoI');
3526
3527 /*
3528 * If we failed because of something else
3529 * than memory, simply stop and fail here
3530 */
3531 if (Status != STATUS_BUFFER_OVERFLOW)
3532 {
3533 return STATUS_BUFFER_OVERFLOW;
3534 }
3535 }
3536
3537 /* Success case here: return our buffer */
3538 *ObjectNameInformation = LocalInfo;
3539 return STATUS_SUCCESS;
3540 }
3541
3542 /*
3543 * @implemented
3544 */
3545 NTSTATUS
3546 NTAPI
3547 IoSetFileOrigin(IN PFILE_OBJECT FileObject,
3548 IN BOOLEAN Remote)
3549 {
3550 NTSTATUS Status = STATUS_SUCCESS;
3551 BOOLEAN FlagSet;
3552
3553 /* Get the flag status */
3554 FlagSet = FileObject->Flags & FO_REMOTE_ORIGIN ? TRUE : FALSE;
3555
3556 /* Don't set the flag if it was set already, and don't remove it if it wasn't set */
3557 if (Remote && !FlagSet)
3558 {
3559 /* Set the flag */
3560 FileObject->Flags |= FO_REMOTE_ORIGIN;
3561 }
3562 else if (!Remote && FlagSet)
3563 {
3564 /* Remove the flag */
3565 FileObject->Flags &= ~FO_REMOTE_ORIGIN;
3566 }
3567 else
3568 {
3569 /* Fail */
3570 Status = STATUS_INVALID_PARAMETER_MIX;
3571 }
3572
3573 /* Return status */
3574 return Status;
3575 }
3576
3577 /*
3578 * @implemented
3579 */
3580 NTSTATUS
3581 NTAPI
3582 NtCreateFile(PHANDLE FileHandle,
3583 ACCESS_MASK DesiredAccess,
3584 POBJECT_ATTRIBUTES ObjectAttributes,
3585 PIO_STATUS_BLOCK IoStatusBlock,
3586 PLARGE_INTEGER AllocateSize,
3587 ULONG FileAttributes,
3588 ULONG ShareAccess,
3589 ULONG CreateDisposition,
3590 ULONG CreateOptions,
3591 PVOID EaBuffer,
3592 ULONG EaLength)
3593 {
3594 /* Call the I/O Function */
3595 return IoCreateFile(FileHandle,
3596 DesiredAccess,
3597 ObjectAttributes,
3598 IoStatusBlock,
3599 AllocateSize,
3600 FileAttributes,
3601 ShareAccess,
3602 CreateDisposition,
3603 CreateOptions,
3604 EaBuffer,
3605 EaLength,
3606 CreateFileTypeNone,
3607 NULL,
3608 0);
3609 }
3610
3611 NTSTATUS
3612 NTAPI
3613 NtCreateMailslotFile(OUT PHANDLE FileHandle,
3614 IN ACCESS_MASK DesiredAccess,
3615 IN POBJECT_ATTRIBUTES ObjectAttributes,
3616 OUT PIO_STATUS_BLOCK IoStatusBlock,
3617 IN ULONG CreateOptions,
3618 IN ULONG MailslotQuota,
3619 IN ULONG MaxMessageSize,
3620 IN PLARGE_INTEGER TimeOut)
3621 {
3622 MAILSLOT_CREATE_PARAMETERS Buffer;
3623 PAGED_CODE();
3624
3625 /* Check for Timeout */
3626 if (TimeOut)
3627 {
3628 /* check if the call came from user mode */
3629 if (KeGetPreviousMode() != KernelMode)
3630 {
3631 /* Enter SEH for Probe */
3632 _SEH2_TRY
3633 {
3634 /* Probe the timeout */
3635 Buffer.ReadTimeout = ProbeForReadLargeInteger(TimeOut);
3636 }
3637 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
3638 {
3639 /* Return the exception code */
3640 _SEH2_YIELD(return _SEH2_GetExceptionCode());
3641 }
3642 _SEH2_END;
3643 }
3644 else
3645 {
3646 /* Otherwise, capture directly */
3647 Buffer.ReadTimeout = *TimeOut;
3648 }
3649
3650 /* Set the correct setting */
3651 Buffer.TimeoutSpecified = TRUE;
3652 }
3653 else
3654 {
3655 /* Tell the FSD we don't have a timeout */
3656 Buffer.TimeoutSpecified = FALSE;
3657 }
3658
3659 /* Set Settings */
3660 Buffer.MailslotQuota = MailslotQuota;
3661 Buffer.MaximumMessageSize = MaxMessageSize;
3662
3663 /* Call I/O */
3664 return IoCreateFile(FileHandle,
3665 DesiredAccess,
3666 ObjectAttributes,
3667 IoStatusBlock,
3668 NULL,
3669 0,
3670 FILE_SHARE_READ | FILE_SHARE_WRITE,
3671 FILE_CREATE,
3672 CreateOptions,
3673 NULL,
3674 0,
3675 CreateFileTypeMailslot,
3676 (PVOID)&Buffer,
3677 0);
3678 }
3679
3680 NTSTATUS
3681 NTAPI
3682 NtCreateNamedPipeFile(OUT PHANDLE FileHandle,
3683 IN ACCESS_MASK DesiredAccess,
3684 IN POBJECT_ATTRIBUTES ObjectAttributes,
3685 OUT PIO_STATUS_BLOCK IoStatusBlock,
3686 IN ULONG ShareAccess,
3687 IN ULONG CreateDisposition,
3688 IN ULONG CreateOptions,
3689 IN ULONG NamedPipeType,
3690 IN ULONG ReadMode,
3691 IN ULONG CompletionMode,
3692 IN ULONG MaximumInstances,
3693 IN ULONG InboundQuota,
3694 IN ULONG OutboundQuota,
3695 IN PLARGE_INTEGER DefaultTimeout)
3696 {
3697 NAMED_PIPE_CREATE_PARAMETERS Buffer;
3698 PAGED_CODE();
3699
3700 /* Check for Timeout */
3701 if (DefaultTimeout)
3702 {
3703 /* check if the call came from user mode */
3704 if (KeGetPreviousMode() != KernelMode)
3705 {
3706 /* Enter SEH for Probe */
3707 _SEH2_TRY
3708 {
3709 /* Probe the timeout */
3710 Buffer.DefaultTimeout =
3711 ProbeForReadLargeInteger(DefaultTimeout);
3712 }
3713 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
3714 {
3715 /* Return the exception code */
3716 _SEH2_YIELD(return _SEH2_GetExceptionCode());
3717 }
3718 _SEH2_END;
3719 }
3720 else
3721 {
3722 /* Otherwise, capture directly */
3723 Buffer.DefaultTimeout = *DefaultTimeout;
3724 }
3725
3726 /* Set the correct setting */
3727 Buffer.TimeoutSpecified = TRUE;
3728 }
3729 else
3730 {
3731 /* Tell the FSD we don't have a timeout */
3732 Buffer.TimeoutSpecified = FALSE;
3733 }
3734
3735 /* Set Settings */
3736 Buffer.NamedPipeType = NamedPipeType;
3737 Buffer.ReadMode = ReadMode;
3738 Buffer.CompletionMode = CompletionMode;
3739 Buffer.MaximumInstances = MaximumInstances;
3740 Buffer.InboundQuota = InboundQuota;
3741 Buffer.OutboundQuota = OutboundQuota;
3742
3743 /* Call I/O */
3744 return IoCreateFile(FileHandle,
3745 DesiredAccess,
3746 ObjectAttributes,
3747 IoStatusBlock,
3748 NULL,
3749 0,
3750 ShareAccess,
3751 CreateDisposition,
3752 CreateOptions,
3753 NULL,
3754 0,
3755 CreateFileTypeNamedPipe,
3756 (PVOID)&Buffer,
3757 0);
3758 }
3759
3760 NTSTATUS
3761 NTAPI
3762 NtFlushWriteBuffer(VOID)
3763 {
3764 PAGED_CODE();
3765
3766 /* Call the kernel */
3767 KeFlushWriteBuffer();
3768 return STATUS_SUCCESS;
3769 }
3770
3771 /*
3772 * @implemented
3773 */
3774 NTSTATUS
3775 NTAPI
3776 NtOpenFile(OUT PHANDLE FileHandle,
3777 IN ACCESS_MASK DesiredAccess,
3778 IN POBJECT_ATTRIBUTES ObjectAttributes,
3779 OUT PIO_STATUS_BLOCK IoStatusBlock,
3780 IN ULONG ShareAccess,
3781 IN ULONG OpenOptions)
3782 {
3783 /* Call the I/O Function */
3784 return IoCreateFile(FileHandle,
3785 DesiredAccess,
3786 ObjectAttributes,
3787 IoStatusBlock,
3788 NULL,
3789 0,
3790 ShareAccess,
3791 FILE_OPEN,
3792 OpenOptions,
3793 NULL,
3794 0,
3795 CreateFileTypeNone,
3796 NULL,
3797 0);
3798 }
3799
3800 NTSTATUS
3801 NTAPI
3802 NtQueryAttributesFile(IN POBJECT_ATTRIBUTES ObjectAttributes,
3803 OUT PFILE_BASIC_INFORMATION FileInformation)
3804 {
3805 /* Call the internal helper API */
3806 return IopQueryAttributesFile(ObjectAttributes,
3807 FileBasicInformation,
3808 sizeof(FILE_BASIC_INFORMATION),
3809 FileInformation);
3810 }
3811
3812 NTSTATUS
3813 NTAPI
3814 NtQueryFullAttributesFile(IN POBJECT_ATTRIBUTES ObjectAttributes,
3815 OUT PFILE_NETWORK_OPEN_INFORMATION FileInformation)
3816 {
3817 /* Call the internal helper API */
3818 return IopQueryAttributesFile(ObjectAttributes,
3819 FileNetworkOpenInformation,
3820 sizeof(FILE_NETWORK_OPEN_INFORMATION),
3821 FileInformation);
3822 }
3823
3824 /**
3825 * @name NtCancelIoFile
3826 *
3827 * Cancel all pending I/O operations in the current thread for specified
3828 * file object.
3829 *
3830 * @param FileHandle
3831 * Handle to file object to cancel requests for. No specific
3832 * access rights are needed.
3833 * @param IoStatusBlock
3834 * Pointer to status block which is filled with final completition
3835 * status on successful return.
3836 *
3837 * @return Status.
3838 *
3839 * @implemented
3840 */
3841 NTSTATUS
3842 NTAPI
3843 NtCancelIoFile(IN HANDLE FileHandle,
3844 OUT PIO_STATUS_BLOCK IoStatusBlock)
3845 {
3846 PFILE_OBJECT FileObject;
3847 PETHREAD Thread;
3848 PIRP Irp;
3849 KIRQL OldIrql;
3850 BOOLEAN OurIrpsInList = FALSE;
3851 LARGE_INTEGER Interval;
3852 KPROCESSOR_MODE PreviousMode = KeGetPreviousMode();
3853 NTSTATUS Status;
3854 PLIST_ENTRY ListHead, NextEntry;
3855 PAGED_CODE();
3856 IOTRACE(IO_API_DEBUG, "FileHandle: %p\n", FileHandle);
3857
3858 /* Check the previous mode */
3859 if (PreviousMode != KernelMode)
3860 {
3861 /* Enter SEH for probing */
3862 _SEH2_TRY
3863 {
3864 /* Probe the I/O Status Block */
3865 ProbeForWriteIoStatusBlock(IoStatusBlock);
3866 }
3867 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
3868 {
3869 /* Return the exception code */
3870 _SEH2_YIELD(return _SEH2_GetExceptionCode());
3871 }
3872 _SEH2_END;
3873 }
3874
3875 /* Reference the file object */
3876 Status = ObReferenceObjectByHandle(FileHandle,
3877 0,
3878 IoFileObjectType,
3879 PreviousMode,
3880 (PVOID*)&FileObject,
3881 NULL);
3882 if (!NT_SUCCESS(Status)) return Status;
3883
3884 /* IRP cancellations are synchronized at APC_LEVEL. */
3885 KeRaiseIrql(APC_LEVEL, &OldIrql);
3886
3887 /* Get the current thread */
3888 Thread = PsGetCurrentThread();
3889
3890 /* Update the operation counts */
3891 IopUpdateOperationCount(IopOtherTransfer);
3892
3893 /* Loop the list */
3894 ListHead = &Thread->IrpList;
3895 NextEntry = ListHead->Flink;
3896 while (ListHead != NextEntry)
3897 {
3898 /* Get the IRP and check if the File Object matches */
3899 Irp = CONTAINING_RECORD(NextEntry, IRP, ThreadListEntry);
3900 if (Irp->Tail.Overlay.OriginalFileObject == FileObject)
3901 {
3902 /* Cancel this IRP and keep looping */
3903 IoCancelIrp(Irp);
3904 OurIrpsInList = TRUE;
3905 }
3906
3907 /* Go to the next entry */
3908 NextEntry = NextEntry->Flink;
3909 }
3910
3911 /* Lower the IRQL */
3912 KeLowerIrql(OldIrql);
3913
3914 /* Check if we had found an IRP */
3915 if (OurIrpsInList)
3916 {
3917 /* Setup a 10ms wait */
3918 Interval.QuadPart = -100000;
3919
3920 /* Start looping */
3921 while (OurIrpsInList)
3922 {
3923 /* Do the wait */
3924 KeDelayExecutionThread(KernelMode, FALSE, &Interval);
3925 OurIrpsInList = FALSE;
3926
3927 /* Raise IRQL */
3928 KeRaiseIrql(APC_LEVEL, &OldIrql);
3929
3930 /* Now loop the list again */
3931 NextEntry = ListHead->Flink;
3932 while (NextEntry != ListHead)
3933 {
3934 /* Get the IRP and check if the File Object matches */
3935 Irp = CONTAINING_RECORD(NextEntry, IRP, ThreadListEntry);
3936 if (Irp->Tail.Overlay.OriginalFileObject == FileObject)
3937 {
3938 /* Keep looping */
3939 OurIrpsInList = TRUE;
3940 break;
3941 }
3942
3943 /* Go to the next entry */
3944 NextEntry = NextEntry->Flink;
3945 }
3946
3947 /* Lower the IRQL */
3948 KeLowerIrql(OldIrql);
3949 }
3950 }
3951
3952 /* Enter SEH for writing back the I/O Status */
3953 _SEH2_TRY
3954 {
3955 /* Write success */
3956 IoStatusBlock->Status = STATUS_SUCCESS;
3957 IoStatusBlock->Information = 0;
3958 }
3959 _SEH2_EXCEPT(EXCEPTION_EXECUTE_HANDLER)
3960 {
3961 /* Ignore exception */
3962 }
3963 _SEH2_END;
3964
3965 /* Dereference the file object and return success */
3966 ObDereferenceObject(FileObject);
3967 return STATUS_SUCCESS;
3968 }
3969
3970 /*
3971 * @implemented
3972 */
3973 NTSTATUS
3974 NTAPI
3975 NtDeleteFile(IN POBJECT_ATTRIBUTES ObjectAttributes)
3976 {
3977 NTSTATUS Status;
3978 DUMMY_FILE_OBJECT LocalFileObject;
3979 HANDLE Handle;
3980 KPROCESSOR_MODE AccessMode = KeGetPreviousMode();
3981 OPEN_PACKET OpenPacket;
3982 PAGED_CODE();
3983 IOTRACE(IO_API_DEBUG, "FileMame: %wZ\n", ObjectAttributes->ObjectName);
3984
3985 /* Setup the Open Packet */
3986 RtlZeroMemory(&OpenPacket, sizeof(OPEN_PACKET));
3987 OpenPacket.Type = IO_TYPE_OPEN_PACKET;
3988 OpenPacket.Size = sizeof(OPEN_PACKET);
3989 OpenPacket.CreateOptions = FILE_DELETE_ON_CLOSE;
3990 OpenPacket.ShareAccess = FILE_SHARE_READ |
3991 FILE_SHARE_WRITE |
3992 FILE_SHARE_DELETE;
3993 OpenPacket.Disposition = FILE_OPEN;
3994 OpenPacket.DeleteOnly = TRUE;
3995 OpenPacket.LocalFileObject = &LocalFileObject;
3996
3997 /* Update the operation counts */
3998 IopUpdateOperationCount(IopOtherTransfer);
3999
4000 /*
4001 * Attempt opening the file. This will call the I/O Parse Routine for
4002 * the File Object (IopParseDevice) which will use the dummy file obejct
4003 * send the IRP to its device object. Note that we have two statuses
4004 * to worry about: the Object Manager's status (in Status) and the I/O
4005 * status, which is in the Open Packet's Final Status, and determined
4006 * by the Parse Check member.
4007 */
4008 Status = ObOpenObjectByName(ObjectAttributes,
4009 NULL,
4010 AccessMode,
4011 NULL,
4012 DELETE,
4013 &OpenPacket,
4014 &Handle);
4015 if (OpenPacket.ParseCheck == FALSE) return Status;
4016
4017 /* Retrn the Io status */
4018 return OpenPacket.FinalStatus;
4019 }
4020
4021 /* EOF */
A free Windows-compatible Operating System