Skip to content

Commit cd7e054

Browse files
committed
Add warnings to Tar extract to directory
1 parent d0b8939 commit cd7e054

1 file changed

Lines changed: 24 additions & 2 deletions

File tree

xml/System.Formats.Tar/TarFile.xml

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -492,6 +492,11 @@
492492
<para>Files of type <see cref="F:System.Formats.Tar.TarEntryType.BlockDevice" />, <see cref="F:System.Formats.Tar.TarEntryType.CharacterDevice" />, or <see cref="F:System.Formats.Tar.TarEntryType.Fifo" /> can only be extracted in Unix platforms.</para>
493493
<para>Elevation is required to extract a <see cref="F:System.Formats.Tar.TarEntryType.BlockDevice" /> or <see cref="F:System.Formats.Tar.TarEntryType.CharacterDevice" /> to disk.</para>
494494
<para>This method doesn't limit the total extracted size or the number of entries extracted from the archive. When processing archives from untrusted sources, iterate over the entries manually using <see cref="T:System.Formats.Tar.TarReader" />, and validate that the size and the number of entries are within acceptable limits for your scenario.</para>
495+
<format type="text/markdown"><![CDATA[
496+
497+
[!INCLUDE[tar-zip-extracttodirectory](~/includes/tar-zip-extracttodirectory.md)]
498+
499+
]]></format>
495500
</remarks>
496501
<exception cref="T:System.ArgumentNullException">
497502
<paramref name="source" /> or <paramref name="destinationDirectoryName" /> is <see langword="null" />.</exception>
@@ -536,7 +541,13 @@ Extracting one of the tar entries would have resulted in a file outside the spec
536541
<param name="destinationDirectoryName">To be added.</param>
537542
<param name="options">To be added.</param>
538543
<summary>To be added.</summary>
539-
<remarks>To be added.</remarks>
544+
<remarks>
545+
<format type="text/markdown"><![CDATA[
546+
547+
[!INCLUDE[tar-zip-extracttodirectory](~/includes/tar-zip-extracttodirectory.md)]
548+
549+
]]></format>
550+
</remarks>
540551
</Docs>
541552
</Member>
542553
<Member MemberName="ExtractToDirectory">
@@ -574,6 +585,11 @@ Extracting one of the tar entries would have resulted in a file outside the spec
574585
<para>Files of type <see cref="F:System.Formats.Tar.TarEntryType.BlockDevice" />, <see cref="F:System.Formats.Tar.TarEntryType.CharacterDevice" />, or <see cref="F:System.Formats.Tar.TarEntryType.Fifo" /> can only be extracted in Unix platforms.</para>
575586
<para>Elevation is required to extract a <see cref="F:System.Formats.Tar.TarEntryType.BlockDevice" /> or <see cref="F:System.Formats.Tar.TarEntryType.CharacterDevice" /> to disk.</para>
576587
<para>This method doesn't limit the total extracted size or the number of entries extracted from the archive. When processing archives from untrusted sources, iterate over the entries manually using <see cref="T:System.Formats.Tar.TarReader" />, and validate that the size and the number of entries are within acceptable limits for your scenario.</para>
588+
<format type="text/markdown"><![CDATA[
589+
590+
[!INCLUDE[tar-zip-extracttodirectory](~/includes/tar-zip-extracttodirectory.md)]
591+
592+
]]></format>
577593
</remarks>
578594
<exception cref="T:System.ArgumentNullException">
579595
<paramref name="sourceFileName" /> or <paramref name="destinationDirectoryName" /> is <see langword="null" />.</exception>
@@ -615,7 +631,13 @@ Extracting one of the tar entries would have resulted in a file outside the spec
615631
<param name="destinationDirectoryName">To be added.</param>
616632
<param name="options">To be added.</param>
617633
<summary>To be added.</summary>
618-
<remarks>To be added.</remarks>
634+
<remarks>
635+
<format type="text/markdown"><![CDATA[
636+
637+
[!INCLUDE[tar-zip-extracttodirectory](~/includes/tar-zip-extracttodirectory.md)]
638+
639+
]]></format>
640+
</remarks>
619641
</Docs>
620642
</Member>
621643
<MemberGroup MemberName="ExtractToDirectoryAsync">

0 commit comments

Comments
 (0)