From 1b6a04ca5504955c571d1c97504fb45ea0befee4 Mon Sep 17 00:00:00 2001
From: Valentin Popov <valentin@popov.link>
Date: Mon, 8 Jan 2024 01:21:28 +0400
Subject: Initial vendor packages

Signed-off-by: Valentin Popov <valentin@popov.link>
---
 vendor/object/src/read/coff/mod.rs | 66 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 vendor/object/src/read/coff/mod.rs

(limited to 'vendor/object/src/read/coff/mod.rs')

diff --git a/vendor/object/src/read/coff/mod.rs b/vendor/object/src/read/coff/mod.rs
new file mode 100644
index 0000000..de397da
--- /dev/null
+++ b/vendor/object/src/read/coff/mod.rs
@@ -0,0 +1,66 @@
+//! Support for reading Windows COFF files.
+//!
+//! Traits are used to abstract over the difference between COFF object files
+//! and COFF bigobj files. The primary trait for this is [`CoffHeader`].
+//!
+//! ## High level API
+//!
+//! [`CoffFile`] implements the [`Object`](crate::read::Object) trait for
+//! COFF files. [`CoffFile`] is parameterised by [`CoffHeader`].
+//! The default parameter allows reading regular COFF object files,
+//! while the type alias [`CoffBigFile`] allows reading COFF bigobj files.
+//!
+//! [`ImportFile`] allows reading COFF short imports that are used in import
+//! libraries. Currently these are not integrated with the unified read API.
+//!
+//! ## Low level API
+//!
+//! The [`CoffHeader`] trait can be directly used to parse both COFF
+//! object files (which start with [`pe::ImageFileHeader`]) and COFF bigobj
+//! files (which start with [`pe::AnonObjectHeaderBigobj`]).
+//!
+//! ### Example for low level API
+//!  ```no_run
+//! use object::pe;
+//! use object::read::coff::{CoffHeader, ImageSymbol as _};
+//! use std::error::Error;
+//! use std::fs;
+//!
+//! /// Reads a file and displays the name of each section and symbol.
+//! fn main() -> Result<(), Box<dyn Error>> {
+//! #   #[cfg(feature = "std")] {
+//!     let data = fs::read("path/to/binary")?;
+//!     let mut offset = 0;
+//!     let header = pe::ImageFileHeader::parse(&*data, &mut offset)?;
+//!     let sections = header.sections(&*data, offset)?;
+//!     let symbols = header.symbols(&*data)?;
+//!     for section in sections.iter() {
+//!         println!("{}", String::from_utf8_lossy(section.name(symbols.strings())?));
+//!     }
+//!     for (_index, symbol) in symbols.iter() {
+//!         println!("{}", String::from_utf8_lossy(symbol.name(symbols.strings())?));
+//!     }
+//! #   }
+//!     Ok(())
+//! }
+//! ```
+#[cfg(doc)]
+use crate::pe;
+
+mod file;
+pub use file::*;
+
+mod section;
+pub use section::*;
+
+mod symbol;
+pub use symbol::*;
+
+mod relocation;
+pub use relocation::*;
+
+mod comdat;
+pub use comdat::*;
+
+mod import;
+pub use import::*;
-- 
cgit v1.2.3