Add FileType enum and SafeFileHandle.GetFileType() method

[Copilot]

Description

Adds System.IO.FileType enum and SafeFileHandle.GetFileType() method to enable runtime detection of file handle types without additional syscalls.

Changes

API Surface

FileType enum in System.IO:

• Unknown, RegularFile, Pipe, Socket, CharacterDevice, Directory, SymbolicLink
• BlockDevice (Unix only, marked [UnsupportedOSPlatform("windows")])

SafeFileHandle.GetFileType() public method:

• Returns cached FileType for the handle
• Throws ObjectDisposedException on closed handles

Implementation

Shared (SafeFileHandle.cs):

• Public GetFileType() method validates handle state and calls GetFileTypeCore()
• Adds _cachedFileType field (-1 = uncached) shared across all platforms

Windows (SafeFileHandle.Windows.cs):

• Implements GetFileTypeCore() using Win32 APIs
• FILE_TYPE_CHAR → CharacterDevice
• FILE_TYPE_PIPE → Calls GetNamedPipeInfo (using SafeHandle parameter); failure indicates Socket, success indicates Pipe
• FILE_TYPE_DISK → Checks FILE_ATTRIBUTE_DIRECTORY via GetFileInformationByHandle, then FILE_ATTRIBUTE_REPARSE_POINT via GetFileInformationByHandleEx for symlinks
• Consolidated caching using shared _cachedFileType field (removed duplicate _fileType field)
• Updated CanSeek property to use new GetFileType() API, checking for FileType.RegularFile for more precise semantics

Unix (SafeFileHandle.Unix.cs):

• Implements GetFileTypeCore() using fstat syscall
• Caches file type during Init() from existing fstat result
• Maps S_IFMT modes: S_IFIFO → Pipe, S_IFSOCK → Socket, etc.
• Throws exception on FStat failure

Interop (Interop.GetNamedPipeInfo.cs):

• Changed to accept SafeHandle instead of SafePipeHandle to avoid CoreLib build issues and enable use with SafeFileHandle
• Added to System.Private.CoreLib.Shared.projitems for Windows builds

Example Usage

using SafeFileHandle handle = File.OpenHandle("file.txt", FileMode.Open);
FileType type = handle.GetFileType(); // Returns FileType.RegularFile

using SafeFileHandle pipe = new SafeFileHandle(pipeSafeHandle.DangerousGetHandle(), false);
FileType pipeType = pipe.GetFileType(); // Returns FileType.Pipe

Testing

Comprehensive test coverage split across three platform-organized files:

• GetFileType.cs: OS-agnostic tests (regular files, null device via File.OpenNullHandle(), anonymous pipes, sockets, error handling, caching)
• GetFileType.Windows.cs: Windows-specific tests (directories, named pipes, console handles, symlinks)
• GetFileType.Unix.cs: Unix-specific tests (directories, named pipes, symlinks, block devices)

Test files are properly organized in the project file by platform using conditional ItemGroups with all required Interop dependencies:

• Unix: Interop.Open.cs, Interop.OpenFlags.cs, Interop.MkFifo.cs
• Windows: Interop.FileOperations.cs

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-system-io
See info in area-owners.md if you want to be subscribed.

[adamsitnik]

@copilot please address my feedback

[Copilot]

@copilot please address my feedback

All feedback has been addressed in commit 9edcc96.

[adamsitnik]

@copilot address my feedback

[Copilot]

@copilot address my feedback

All feedback addressed in commit 1f0655f.

[adamsitnik]

@copilot please address my feedback

[Copilot]

@copilot please address my feedback

All feedback addressed in commit 8994464.

[adamsitnik]

To whom it may concern: I wanted to implement new API to ensure it's possible before proposing it (#122806)

[adamsitnik]

@copilot address my feedback to fix the build errors

[Copilot]

@copilot address my feedback to fix the build errors

Build errors fixed. Commit 9834798.

[adamsitnik]

@copilot fix following build failures:

##[error]src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(19,25): error CS0029: (NETCORE_ENGINEERING_TELEMETRY=Build) Cannot implicitly convert type 'Microsoft.Win32.SafeHandles.SafeFileHandle' to 'nint'
/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(19,25): error CS0029: Cannot implicitly convert type 'Microsoft.Win32.SafeHandles.SafeFileHandle' to 'nint' [/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/System.IO.FileSystem.Tests.csproj::TargetFramework=net11.0-unix]
##[error]src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(29,41): error CS0117: (NETCORE_ENGINEERING_TELEMETRY=Build) 'Interop.Sys' does not contain a definition for 'MkFifo'
/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(29,41): error CS0117: 'Interop.Sys' does not contain a definition for 'MkFifo' [/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/System.IO.FileSystem.Tests.csproj::TargetFramework=net11.0-unix]
##[error]src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(31,13): error CS0246: (NETCORE_ENGINEERING_TELEMETRY=Build) The type or namespace name 'Task' could not be found (are you missing a using directive or an assembly reference?)
/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(31,13): error CS0246: The type or namespace name 'Task' could not be found (are you missing a using directive or an assembly reference?) [/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/System.IO.FileSystem.Tests.csproj::TargetFramework=net11.0-unix]
##[error]src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(31,31): error CS0103: (NETCORE_ENGINEERING_TELEMETRY=Build) The name 'Task' does not exist in the current context
/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(31,31): error CS0103: The name 'Task' does not exist in the current context [/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/System.IO.FileSystem.Tests.csproj::TargetFramework=net11.0-unix]
##[error]src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(51,25): error CS0029: (NETCORE_ENGINEERING_TELEMETRY=Build) Cannot implicitly convert type 'Microsoft.Win32.SafeHandles.SafeFileHandle' to 'nint'
/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(51,25): error CS0029: Cannot implicitly convert type 'Microsoft.Win32.SafeHandles.SafeFileHandle' to 'nint' [/__w/1/s/src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/System.IO.FileSystem.Tests.csproj::TargetFramework=net11.0-unix]
##[error]src/libraries/System.Runtime/tests/System.IO.FileSystem.Tests/SafeFileHandle/GetFileType.Unix.cs(83,29): error CS0029: (NETCORE_ENGINEERING_TELEMETRY=Build) Cannot implicitly convert type 'Microsoft.Win32.SafeHandles.SafeFileHandle' to 'nint'

Make sure you can build the repo locally before pushing the fix

[Copilot]

@copilot fix following build failures:

Fixed all Unix test build errors. Corrected Interop.Sys.Open usage (returns SafeFileHandle, not IntPtr), added Task using statement, and added MkFifo interop reference. Commit ef2da05.