Skip to content

Commit 952922e

Browse files
authored
Add InvalidDataException documentation for TAR checksum validation in .NET 11 (#12222)
1 parent cc8ab85 commit 952922e

2 files changed

Lines changed: 14 additions & 2 deletions

File tree

xml/System.Formats.Tar/TarFile.xml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -242,6 +242,7 @@ Extracting one of the tar entries would have resulted in a file outside the spec
242242
-or-
243243

244244
<paramref name="source" /> does not support reading.</exception>
245+
<exception cref="T:System.IO.InvalidDataException">.NET 11 and later versions only: An entry's checksum is invalid.</exception>
245246
<exception cref="T:System.IO.IOException">An I/O exception occurred.</exception>
246247
</Docs>
247248
</Member>
@@ -291,6 +292,7 @@ Extracting one of the tar entries would have resulted in a file outside the spec
291292
-or-
292293

293294
<paramref name="sourceFileName" /> or <paramref name="destinationDirectoryName" /> is empty.</exception>
295+
<exception cref="T:System.IO.InvalidDataException">.NET 11 and later versions only: An entry's checksum is invalid.</exception>
294296
<exception cref="T:System.IO.IOException">An I/O exception occurred.</exception>
295297
</Docs>
296298
</Member>
@@ -346,6 +348,7 @@ Extracting one of the tar entries would have resulted in a file outside the spec
346348
-or-
347349

348350
<paramref name="source" /> does not support reading.</exception>
351+
<exception cref="T:System.IO.InvalidDataException">.NET 11 and later versions only: An entry's checksum is invalid.</exception>
349352
<exception cref="T:System.IO.IOException">An I/O exception occurred.</exception>
350353
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
351354
</Docs>
@@ -399,6 +402,7 @@ Extracting one of the tar entries would have resulted in a file outside the spec
399402
-or-
400403

401404
<paramref name="sourceFileName" /> or <paramref name="destinationDirectoryName" /> is empty.</exception>
405+
<exception cref="T:System.IO.InvalidDataException">.NET 11 and later versions only: An entry's checksum is invalid.</exception>
402406
<exception cref="T:System.IO.IOException">An I/O exception occurred.</exception>
403407
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
404408
</Docs>

xml/System.Formats.Tar/TarReader.xml

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,11 @@ More than one global extended attributes entry was found in the current <see cre
157157

158158
-or-
159159

160-
Two or more extended attributes entries were found consecutively in the current <see cref="F:System.Formats.Tar.TarEntryFormat.Pax" /> archive.</exception>
160+
Two or more extended attributes entries were found consecutively in the current <see cref="F:System.Formats.Tar.TarEntryFormat.Pax" /> archive.
161+
162+
-or-
163+
164+
.NET 11 and later versions only: An entry's checksum is invalid.</exception>
161165
<exception cref="T:System.IO.IOException">An I/O problem occurred.</exception>
162166
</Docs>
163167
</Member>
@@ -213,7 +217,11 @@ More than one Global Extended Attributes Entry was found in the current <see cre
213217

214218
-or-
215219

216-
Two or more Extended Attributes entries were found consecutively in the current <see cref="F:System.Formats.Tar.TarEntryFormat.Pax" /> archive.</exception>
220+
Two or more Extended Attributes entries were found consecutively in the current <see cref="F:System.Formats.Tar.TarEntryFormat.Pax" /> archive.
221+
222+
-or-
223+
224+
.NET 11 and later versions only: An entry's checksum is invalid.</exception>
217225
<exception cref="T:System.IO.IOException">An I/O problem occurred.</exception>
218226
<exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
219227
</Docs>

0 commit comments

Comments
 (0)