[release/7.0-preview4] Backport new Tar APIs (#68337)

* Implement Tar APIs (#67883)

API proposal: #65951

* Add assembly to NetCoreAppLibrary.props

* Remove <PackageDescription> from src csproj since it is not OOB.

* Add NetCoreAppCurrent to src csproj TargetFrameworks

* Additional src csproj changes.

* Allow sharing of input tar file for read

Co-authored-by: carlossanlop <carlossanlop@users.noreply.github.com>
Co-authored-by: Dan Moseley <danmose@microsoft.com>

Author: carlossanlop

eng/Version.Details.xml

@@ -138,6 +138,10 @@
       <Uri>https://github.com/dotnet/runtime-assets</Uri>
       <Sha>78cb33dbb0fb5156f049b9e1778f47b508f1be9f</Sha>
     </Dependency>
+    <Dependency Name="System.Formats.Tar.TestData" Version="7.0.0-beta.22214.1">
+      <Uri>https://github.com/dotnet/runtime-assets</Uri>
+      <Sha>78cb33dbb0fb5156f049b9e1778f47b508f1be9f</Sha>
+    </Dependency>
     <Dependency Name="System.IO.Compression.TestData" Version="7.0.0-beta.22214.1">
       <Uri>https://github.com/dotnet/runtime-assets</Uri>
       <Sha>78cb33dbb0fb5156f049b9e1778f47b508f1be9f</Sha>

eng/Versions.props

@@ -130,6 +130,7 @@
     <SystemRuntimeNumericsTestDataVersion>7.0.0-beta.22214.1</SystemRuntimeNumericsTestDataVersion>
     <SystemComponentModelTypeConverterTestDataVersion>7.0.0-beta.22214.1</SystemComponentModelTypeConverterTestDataVersion>
     <SystemDrawingCommonTestDataVersion>7.0.0-beta.22214.1</SystemDrawingCommonTestDataVersion>
+    <SystemFormatsTarTestDataVersion>7.0.0-beta.22214.1</SystemFormatsTarTestDataVersion>
     <SystemIOCompressionTestDataVersion>7.0.0-beta.22214.1</SystemIOCompressionTestDataVersion>
     <SystemIOPackagingTestDataVersion>7.0.0-beta.22214.1</SystemIOPackagingTestDataVersion>
     <SystemNetTestDataVersion>7.0.0-beta.22214.1</SystemNetTestDataVersion>

src/libraries/Common/src/Interop/Unix/System.Native/Interop.DeviceFiles.cs

@@ -0,0 +1,28 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.Runtime.InteropServices;
+
+internal static partial class Interop
+{
+    // mknod: https://man7.org/linux/man-pages/man2/mknod.2.html
+    // makedev, major and minor: https://man7.org/linux/man-pages/man3/makedev.3.html
+    internal static partial class Sys
+    {
+        internal static int CreateBlockDevice(string pathName, uint mode, uint major, uint minor)
+        {
+            return MkNod(pathName, mode | FileTypes.S_IFBLK, major, minor);
+        }
+
+        internal static int CreateCharacterDevice(string pathName, uint mode, uint major, uint minor)
+        {
+            return MkNod(pathName, mode | FileTypes.S_IFCHR, major, minor);
+        }
+
+        [LibraryImport(Libraries.SystemNative, EntryPoint = "SystemNative_MkNod", StringMarshalling = StringMarshalling.Utf8, SetLastError = true)]
+        private static partial int MkNod(string pathName, uint mode, uint major, uint minor);
+
+        [LibraryImport(Libraries.SystemNative, EntryPoint = "SystemNative_GetDeviceIdentifiers", SetLastError = true)]
+        internal static unsafe partial int GetDeviceIdentifiers(ulong dev, uint* majorNumber, uint* minorNumber);
+    }
+}

src/libraries/Common/src/Interop/Unix/System.Native/Interop.MkFifo.cs

@@ -0,0 +1,14 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.Runtime.InteropServices;
+
+internal static partial class Interop
+{
+    // mkfifo: https://man7.org/linux/man-pages/man3/mkfifo.3.html
+    internal static partial class Sys
+    {
+        [LibraryImport(Libraries.SystemNative, EntryPoint = "SystemNative_MkFifo", StringMarshalling = StringMarshalling.Utf8, SetLastError = true)]
+        internal static partial int MkFifo(string pathName, uint mode);
+    }
+}

src/libraries/Common/src/Interop/Unix/System.Native/Interop.Stat.cs

@@ -41,6 +41,7 @@ internal static class FileTypes
             internal const int S_IFIFO = 0x1000;
             internal const int S_IFCHR = 0x2000;
             internal const int S_IFDIR = 0x4000;
+            internal const int S_IFBLK = 0x6000;
             internal const int S_IFREG = 0x8000;
             internal const int S_IFLNK = 0xA000;
             internal const int S_IFSOCK = 0xC000;

src/libraries/Common/src/Interop/Windows/Kernel32/Interop.CreateHardLink.cs

@@ -0,0 +1,28 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.IO;
+using System.Runtime.InteropServices;
+
+internal static partial class Interop
+{
+    internal static partial class Kernel32
+    {
+        internal static void CreateHardLink(string hardLinkFilePath, string targetFilePath)
+        {
+            string originalPath = hardLinkFilePath;
+            hardLinkFilePath = PathInternal.EnsureExtendedPrefix(hardLinkFilePath);
+            targetFilePath = PathInternal.EnsureExtendedPrefix(targetFilePath);
+
+            if (!CreateHardLinkPrivate(hardLinkFilePath, targetFilePath, IntPtr.Zero))
+            {
+                throw Win32Marshal.GetExceptionForLastWin32Error(originalPath);
+            }
+        }
+
+        [LibraryImport(Libraries.Kernel32, EntryPoint = "CreateHardLinkW", SetLastError = true, StringMarshalling = StringMarshalling.Utf16)]
+        [return: MarshalAs(UnmanagedType.Bool)]
+        private static partial bool CreateHardLinkPrivate(string lpFileName, string lpExistingFileName, IntPtr lpSecurityAttributes);
+    }
+}

src/libraries/Common/src/System/IO/Archiving.Utils.Unix.cs

@@ -0,0 +1,10 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.IO
+{
+    internal static partial class ArchivingUtils
+    {
+        internal static string SanitizeEntryFilePath(string entryPath) => entryPath.Replace('\0', '_');
+    }
+}

src/libraries/System.IO.Compression.ZipFile/src/System/IO/Compression/ZipFileValidName_Windows.cs renamed to src/libraries/Common/src/System/IO/Archiving.Utils.Windows.cs

@@ -1,17 +1,16 @@
-// Licensed to the .NET Foundation under one or more agreements.
+// Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
-
 using System.Text;
 
-namespace System.IO.Compression
+namespace System.IO
 {
-    public static partial class ZipFileExtensions
+    internal static partial class ArchivingUtils
     {
-        internal static string SanitizeZipFilePath(string zipPath)
+        internal static string SanitizeEntryFilePath(string entryPath)
         {
-            StringBuilder builder = new StringBuilder(zipPath);
-            for (int i = 0; i < zipPath.Length; i++)
+            StringBuilder builder = new StringBuilder(entryPath);
+            for (int i = 0; i < entryPath.Length; i++)
             {
                 if (((int)builder[i] >= 0 && (int)builder[i] < 32) ||
                    builder[i] == '?' || builder[i] == ':' ||

src/libraries/System.IO.Compression.ZipFile/src/System/IO/Compression/ZipFile.Utils.cs renamed to src/libraries/Common/src/System/IO/Archiving.Utils.cs

@@ -5,11 +5,13 @@
 using System.Collections.Generic;
 using System.Diagnostics;
 
-namespace System.IO.Compression
+namespace System.IO
 {
-    internal static partial class ZipFileUtils
+    internal static partial class ArchivingUtils
     {
-        // Per the .ZIP File Format Specification 4.4.17.1 all slashes should be forward slashes
+        // To ensure tar files remain compatible with Unix,
+        // and per the ZIP File Format Specification 4.4.17.1,
+        // all slashes should be forward slashes.
         private const char PathSeparatorChar = '/';
         private const string PathSeparatorString = "/";
 
@@ -74,5 +76,17 @@ public static bool IsDirEmpty(DirectoryInfo possiblyEmptyDir)
             using (IEnumerator<string> enumerator = Directory.EnumerateFileSystemEntries(possiblyEmptyDir.FullName).GetEnumerator())
                 return !enumerator.MoveNext();
         }
+
+        public static void AttemptSetLastWriteTime(string destinationFileName, DateTimeOffset lastWriteTime)
+        {
+            try
+            {
+                File.SetLastWriteTime(destinationFileName, lastWriteTime.DateTime);
+            }
+            catch (UnauthorizedAccessException)
+            {
+                // Some OSes like Android (#35374) might not support setting the last write time, the extraction should not fail because of that
+            }
+        }
     }
 }

src/libraries/Common/tests/Resources/Strings.resx

@@ -120,6 +120,9 @@
   <data name="Argument_InvalidPathChars" xml:space="preserve">
     <value>Argument_InvalidPathChars {0}</value>
   </data>
+  <data name="ArgumentOutOfRange_FileLengthTooBig" xml:space="preserve">
+    <value>Specified file length was too large for the file system.</value>
+  </data>
   <data name="IO_FileNotFound" xml:space="preserve">
     <value>IO_FileNotFound</value>
   </data>
@@ -201,4 +204,4 @@
   <data name="net_quic_streamaborted" xml:space="preserve">
     <value>Stream aborted by peer ({0}).</value>
   </data>
-</root>
+</root>