1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177 |
- //===- Archive.cpp - ar File Format implementation ------------------------===//
- //
- // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
- // See https://llvm.org/LICENSE.txt for license information.
- // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
- //
- //===----------------------------------------------------------------------===//
- //
- // This file defines the ArchiveObjectFile class.
- //
- //===----------------------------------------------------------------------===//
- #include "llvm/Object/Archive.h"
- #include "llvm/ADT/Optional.h"
- #include "llvm/ADT/SmallString.h"
- #include "llvm/ADT/StringRef.h"
- #include "llvm/ADT/Twine.h"
- #include "llvm/Object/Binary.h"
- #include "llvm/Object/Error.h"
- #include "llvm/Support/Chrono.h"
- #include "llvm/Support/Endian.h"
- #include "llvm/Support/Error.h"
- #include "llvm/Support/ErrorOr.h"
- #include "llvm/Support/FileSystem.h"
- #include "llvm/Support/MathExtras.h"
- #include "llvm/Support/MemoryBuffer.h"
- #include "llvm/Support/Path.h"
- #include "llvm/Support/raw_ostream.h"
- #include <algorithm>
- #include <cassert>
- #include <cstddef>
- #include <cstdint>
- #include <cstring>
- #include <memory>
- #include <string>
- #include <system_error>
- using namespace llvm;
- using namespace object;
- using namespace llvm::support::endian;
- void Archive::anchor() {}
- static Error malformedError(Twine Msg) {
- std::string StringMsg = "truncated or malformed archive (" + Msg.str() + ")";
- return make_error<GenericBinaryError>(std::move(StringMsg),
- object_error::parse_failed);
- }
- static Error
- createMemberHeaderParseError(const AbstractArchiveMemberHeader *ArMemHeader,
- const char *RawHeaderPtr, uint64_t Size) {
- StringRef Msg("remaining size of archive too small for next archive "
- "member header ");
- Expected<StringRef> NameOrErr = ArMemHeader->getName(Size);
- if (NameOrErr)
- return malformedError(Msg + "for " + *NameOrErr);
- consumeError(NameOrErr.takeError());
- uint64_t Offset = RawHeaderPtr - ArMemHeader->Parent->getData().data();
- return malformedError(Msg + "at offset " + Twine(Offset));
- }
- template <class T, std::size_t N>
- StringRef getFieldRawString(const T (&Field)[N]) {
- return StringRef(Field, N).rtrim(" ");
- }
- template <class T>
- StringRef CommonArchiveMemberHeader<T>::getRawAccessMode() const {
- return getFieldRawString(ArMemHdr->AccessMode);
- }
- template <class T>
- StringRef CommonArchiveMemberHeader<T>::getRawLastModified() const {
- return getFieldRawString(ArMemHdr->LastModified);
- }
- template <class T> StringRef CommonArchiveMemberHeader<T>::getRawUID() const {
- return getFieldRawString(ArMemHdr->UID);
- }
- template <class T> StringRef CommonArchiveMemberHeader<T>::getRawGID() const {
- return getFieldRawString(ArMemHdr->GID);
- }
- template <class T> uint64_t CommonArchiveMemberHeader<T>::getOffset() const {
- return reinterpret_cast<const char *>(ArMemHdr) - Parent->getData().data();
- }
- template class object::CommonArchiveMemberHeader<UnixArMemHdrType>;
- template class object::CommonArchiveMemberHeader<BigArMemHdrType>;
- ArchiveMemberHeader::ArchiveMemberHeader(const Archive *Parent,
- const char *RawHeaderPtr,
- uint64_t Size, Error *Err)
- : CommonArchiveMemberHeader<UnixArMemHdrType>(
- Parent, reinterpret_cast<const UnixArMemHdrType *>(RawHeaderPtr)) {
- if (RawHeaderPtr == nullptr)
- return;
- ErrorAsOutParameter ErrAsOutParam(Err);
- if (Size < getSizeOf()) {
- *Err = createMemberHeaderParseError(this, RawHeaderPtr, Size);
- return;
- }
- if (ArMemHdr->Terminator[0] != '`' || ArMemHdr->Terminator[1] != '\n') {
- if (Err) {
- std::string Buf;
- raw_string_ostream OS(Buf);
- OS.write_escaped(
- StringRef(ArMemHdr->Terminator, sizeof(ArMemHdr->Terminator)));
- OS.flush();
- std::string Msg("terminator characters in archive member \"" + Buf +
- "\" not the correct \"`\\n\" values for the archive "
- "member header ");
- Expected<StringRef> NameOrErr = getName(Size);
- if (!NameOrErr) {
- consumeError(NameOrErr.takeError());
- uint64_t Offset = RawHeaderPtr - Parent->getData().data();
- *Err = malformedError(Msg + "at offset " + Twine(Offset));
- } else
- *Err = malformedError(Msg + "for " + NameOrErr.get());
- }
- return;
- }
- }
- BigArchiveMemberHeader::BigArchiveMemberHeader(const Archive *Parent,
- const char *RawHeaderPtr,
- uint64_t Size, Error *Err)
- : CommonArchiveMemberHeader<BigArMemHdrType>(
- Parent, reinterpret_cast<const BigArMemHdrType *>(RawHeaderPtr)) {
- if (RawHeaderPtr == nullptr)
- return;
- ErrorAsOutParameter ErrAsOutParam(Err);
- if (Size < getSizeOf())
- *Err = createMemberHeaderParseError(this, RawHeaderPtr, Size);
- }
- // This gets the raw name from the ArMemHdr->Name field and checks that it is
- // valid for the kind of archive. If it is not valid it returns an Error.
- Expected<StringRef> ArchiveMemberHeader::getRawName() const {
- char EndCond;
- auto Kind = Parent->kind();
- if (Kind == Archive::K_BSD || Kind == Archive::K_DARWIN64) {
- if (ArMemHdr->Name[0] == ' ') {
- uint64_t Offset =
- reinterpret_cast<const char *>(ArMemHdr) - Parent->getData().data();
- return malformedError("name contains a leading space for archive member "
- "header at offset " +
- Twine(Offset));
- }
- EndCond = ' ';
- } else if (ArMemHdr->Name[0] == '/' || ArMemHdr->Name[0] == '#')
- EndCond = ' ';
- else
- EndCond = '/';
- StringRef::size_type end =
- StringRef(ArMemHdr->Name, sizeof(ArMemHdr->Name)).find(EndCond);
- if (end == StringRef::npos)
- end = sizeof(ArMemHdr->Name);
- assert(end <= sizeof(ArMemHdr->Name) && end > 0);
- // Don't include the EndCond if there is one.
- return StringRef(ArMemHdr->Name, end);
- }
- Expected<uint64_t>
- getArchiveMemberDecField(Twine FieldName, const StringRef RawField,
- const Archive *Parent,
- const AbstractArchiveMemberHeader *MemHeader) {
- uint64_t Value;
- if (RawField.getAsInteger(10, Value)) {
- uint64_t Offset = MemHeader->getOffset();
- return malformedError("characters in " + FieldName +
- " field in archive member header are not "
- "all decimal numbers: '" +
- RawField +
- "' for the archive "
- "member header at offset " +
- Twine(Offset));
- }
- return Value;
- }
- Expected<uint64_t>
- getArchiveMemberOctField(Twine FieldName, const StringRef RawField,
- const Archive *Parent,
- const AbstractArchiveMemberHeader *MemHeader) {
- uint64_t Value;
- if (RawField.getAsInteger(8, Value)) {
- uint64_t Offset = MemHeader->getOffset();
- return malformedError("characters in " + FieldName +
- " field in archive member header are not "
- "all octal numbers: '" +
- RawField +
- "' for the archive "
- "member header at offset " +
- Twine(Offset));
- }
- return Value;
- }
- Expected<StringRef> BigArchiveMemberHeader::getRawName() const {
- Expected<uint64_t> NameLenOrErr = getArchiveMemberDecField(
- "NameLen", getFieldRawString(ArMemHdr->NameLen), Parent, this);
- if (!NameLenOrErr)
- // TODO: Out-of-line.
- return NameLenOrErr.takeError();
- uint64_t NameLen = NameLenOrErr.get();
- // If the name length is odd, pad with '\0' to get an even length. After
- // padding, there is the name terminator "`\n".
- uint64_t NameLenWithPadding = alignTo(NameLen, 2);
- StringRef NameTerminator = "`\n";
- StringRef NameStringWithNameTerminator =
- StringRef(ArMemHdr->Name, NameLenWithPadding + NameTerminator.size());
- if (!NameStringWithNameTerminator.endswith(NameTerminator)) {
- uint64_t Offset =
- reinterpret_cast<const char *>(ArMemHdr->Name + NameLenWithPadding) -
- Parent->getData().data();
- // TODO: Out-of-line.
- return malformedError(
- "name does not have name terminator \"`\\n\" for archive member"
- "header at offset " +
- Twine(Offset));
- }
- return StringRef(ArMemHdr->Name, NameLen);
- }
- // member including the header, so the size of any name following the header
- // is checked to make sure it does not overflow.
- Expected<StringRef> ArchiveMemberHeader::getName(uint64_t Size) const {
- // This can be called from the ArchiveMemberHeader constructor when the
- // archive header is truncated to produce an error message with the name.
- // Make sure the name field is not truncated.
- if (Size < offsetof(UnixArMemHdrType, Name) + sizeof(ArMemHdr->Name)) {
- uint64_t ArchiveOffset =
- reinterpret_cast<const char *>(ArMemHdr) - Parent->getData().data();
- return malformedError("archive header truncated before the name field "
- "for archive member header at offset " +
- Twine(ArchiveOffset));
- }
- // The raw name itself can be invalid.
- Expected<StringRef> NameOrErr = getRawName();
- if (!NameOrErr)
- return NameOrErr.takeError();
- StringRef Name = NameOrErr.get();
- // Check if it's a special name.
- if (Name[0] == '/') {
- if (Name.size() == 1) // Linker member.
- return Name;
- if (Name.size() == 2 && Name[1] == '/') // String table.
- return Name;
- // It's a long name.
- // Get the string table offset.
- std::size_t StringOffset;
- if (Name.substr(1).rtrim(' ').getAsInteger(10, StringOffset)) {
- std::string Buf;
- raw_string_ostream OS(Buf);
- OS.write_escaped(Name.substr(1).rtrim(' '));
- OS.flush();
- uint64_t ArchiveOffset =
- reinterpret_cast<const char *>(ArMemHdr) - Parent->getData().data();
- return malformedError("long name offset characters after the '/' are "
- "not all decimal numbers: '" +
- Buf + "' for archive member header at offset " +
- Twine(ArchiveOffset));
- }
- // Verify it.
- if (StringOffset >= Parent->getStringTable().size()) {
- uint64_t ArchiveOffset =
- reinterpret_cast<const char *>(ArMemHdr) - Parent->getData().data();
- return malformedError("long name offset " + Twine(StringOffset) +
- " past the end of the string table for archive "
- "member header at offset " +
- Twine(ArchiveOffset));
- }
- // GNU long file names end with a "/\n".
- if (Parent->kind() == Archive::K_GNU ||
- Parent->kind() == Archive::K_GNU64) {
- size_t End = Parent->getStringTable().find('\n', /*From=*/StringOffset);
- if (End == StringRef::npos || End < 1 ||
- Parent->getStringTable()[End - 1] != '/') {
- return malformedError("string table at long name offset " +
- Twine(StringOffset) + "not terminated");
- }
- return Parent->getStringTable().slice(StringOffset, End - 1);
- }
- return Parent->getStringTable().begin() + StringOffset;
- }
- if (Name.startswith("#1/")) {
- uint64_t NameLength;
- if (Name.substr(3).rtrim(' ').getAsInteger(10, NameLength)) {
- std::string Buf;
- raw_string_ostream OS(Buf);
- OS.write_escaped(Name.substr(3).rtrim(' '));
- OS.flush();
- uint64_t ArchiveOffset =
- reinterpret_cast<const char *>(ArMemHdr) - Parent->getData().data();
- return malformedError("long name length characters after the #1/ are "
- "not all decimal numbers: '" +
- Buf + "' for archive member header at offset " +
- Twine(ArchiveOffset));
- }
- if (getSizeOf() + NameLength > Size) {
- uint64_t ArchiveOffset =
- reinterpret_cast<const char *>(ArMemHdr) - Parent->getData().data();
- return malformedError("long name length: " + Twine(NameLength) +
- " extends past the end of the member or archive "
- "for archive member header at offset " +
- Twine(ArchiveOffset));
- }
- return StringRef(reinterpret_cast<const char *>(ArMemHdr) + getSizeOf(),
- NameLength)
- .rtrim('\0');
- }
- // It is not a long name so trim the blanks at the end of the name.
- if (Name[Name.size() - 1] != '/')
- return Name.rtrim(' ');
- // It's a simple name.
- return Name.drop_back(1);
- }
- Expected<StringRef> BigArchiveMemberHeader::getName(uint64_t Size) const {
- return getRawName();
- }
- Expected<uint64_t> ArchiveMemberHeader::getSize() const {
- return getArchiveMemberDecField("size", getFieldRawString(ArMemHdr->Size),
- Parent, this);
- }
- Expected<uint64_t> BigArchiveMemberHeader::getSize() const {
- Expected<uint64_t> SizeOrErr = getArchiveMemberDecField(
- "size", getFieldRawString(ArMemHdr->Size), Parent, this);
- if (!SizeOrErr)
- return SizeOrErr.takeError();
- Expected<uint64_t> NameLenOrErr = getRawNameSize();
- if (!NameLenOrErr)
- return NameLenOrErr.takeError();
- return *SizeOrErr + alignTo(*NameLenOrErr, 2);
- }
- Expected<uint64_t> BigArchiveMemberHeader::getRawNameSize() const {
- return getArchiveMemberDecField(
- "NameLen", getFieldRawString(ArMemHdr->NameLen), Parent, this);
- }
- Expected<uint64_t> BigArchiveMemberHeader::getNextOffset() const {
- return getArchiveMemberDecField(
- "NextOffset", getFieldRawString(ArMemHdr->NextOffset), Parent, this);
- }
- Expected<sys::fs::perms> AbstractArchiveMemberHeader::getAccessMode() const {
- Expected<uint64_t> AccessModeOrErr =
- getArchiveMemberOctField("AccessMode", getRawAccessMode(), Parent, this);
- if (!AccessModeOrErr)
- return AccessModeOrErr.takeError();
- return static_cast<sys::fs::perms>(*AccessModeOrErr);
- }
- Expected<sys::TimePoint<std::chrono::seconds>>
- AbstractArchiveMemberHeader::getLastModified() const {
- Expected<uint64_t> SecondsOrErr = getArchiveMemberDecField(
- "LastModified", getRawLastModified(), Parent, this);
- if (!SecondsOrErr)
- return SecondsOrErr.takeError();
- return sys::toTimePoint(*SecondsOrErr);
- }
- Expected<unsigned> AbstractArchiveMemberHeader::getUID() const {
- StringRef User = getRawUID();
- if (User.empty())
- return 0;
- return getArchiveMemberDecField("UID", User, Parent, this);
- }
- Expected<unsigned> AbstractArchiveMemberHeader::getGID() const {
- StringRef Group = getRawGID();
- if (Group.empty())
- return 0;
- return getArchiveMemberDecField("GID", Group, Parent, this);
- }
- Expected<bool> ArchiveMemberHeader::isThin() const {
- Expected<StringRef> NameOrErr = getRawName();
- if (!NameOrErr)
- return NameOrErr.takeError();
- StringRef Name = NameOrErr.get();
- return Parent->isThin() && Name != "/" && Name != "//" && Name != "/SYM64/";
- }
- Expected<const char *> ArchiveMemberHeader::getNextChildLoc() const {
- uint64_t Size = getSizeOf();
- Expected<bool> isThinOrErr = isThin();
- if (!isThinOrErr)
- return isThinOrErr.takeError();
- bool isThin = isThinOrErr.get();
- if (!isThin) {
- Expected<uint64_t> MemberSize = getSize();
- if (!MemberSize)
- return MemberSize.takeError();
- Size += MemberSize.get();
- }
- // If Size is odd, add 1 to make it even.
- const char *NextLoc =
- reinterpret_cast<const char *>(ArMemHdr) + alignTo(Size, 2);
- if (NextLoc == Parent->getMemoryBufferRef().getBufferEnd())
- return nullptr;
- return NextLoc;
- }
- Expected<const char *> BigArchiveMemberHeader::getNextChildLoc() const {
- if (getOffset() ==
- static_cast<const BigArchive *>(Parent)->getLastChildOffset())
- return nullptr;
- Expected<uint64_t> NextOffsetOrErr = getNextOffset();
- if (!NextOffsetOrErr)
- return NextOffsetOrErr.takeError();
- return Parent->getData().data() + NextOffsetOrErr.get();
- }
- Archive::Child::Child(const Archive *Parent, StringRef Data,
- uint16_t StartOfFile)
- : Parent(Parent), Data(Data), StartOfFile(StartOfFile) {
- Header = Parent->createArchiveMemberHeader(Data.data(), Data.size(), nullptr);
- }
- Archive::Child::Child(const Archive *Parent, const char *Start, Error *Err)
- : Parent(Parent) {
- if (!Start) {
- Header = nullptr;
- return;
- }
- Header = Parent->createArchiveMemberHeader(
- Start,
- Parent ? Parent->getData().size() - (Start - Parent->getData().data())
- : 0,
- Err);
- // If we are pointed to real data, Start is not a nullptr, then there must be
- // a non-null Err pointer available to report malformed data on. Only in
- // the case sentinel value is being constructed is Err is permitted to be a
- // nullptr.
- assert(Err && "Err can't be nullptr if Start is not a nullptr");
- ErrorAsOutParameter ErrAsOutParam(Err);
- // If there was an error in the construction of the Header
- // then just return with the error now set.
- if (*Err)
- return;
- uint64_t Size = Header->getSizeOf();
- Data = StringRef(Start, Size);
- Expected<bool> isThinOrErr = isThinMember();
- if (!isThinOrErr) {
- *Err = isThinOrErr.takeError();
- return;
- }
- bool isThin = isThinOrErr.get();
- if (!isThin) {
- Expected<uint64_t> MemberSize = getRawSize();
- if (!MemberSize) {
- *Err = MemberSize.takeError();
- return;
- }
- Size += MemberSize.get();
- Data = StringRef(Start, Size);
- }
- // Setup StartOfFile and PaddingBytes.
- StartOfFile = Header->getSizeOf();
- // Don't include attached name.
- Expected<StringRef> NameOrErr = getRawName();
- if (!NameOrErr) {
- *Err = NameOrErr.takeError();
- return;
- }
- StringRef Name = NameOrErr.get();
- if (Parent->kind() == Archive::K_AIXBIG) {
- // The actual start of the file is after the name and any necessary
- // even-alignment padding.
- StartOfFile += ((Name.size() + 1) >> 1) << 1;
- } else if (Name.startswith("#1/")) {
- uint64_t NameSize;
- StringRef RawNameSize = Name.substr(3).rtrim(' ');
- if (RawNameSize.getAsInteger(10, NameSize)) {
- uint64_t Offset = Start - Parent->getData().data();
- *Err = malformedError("long name length characters after the #1/ are "
- "not all decimal numbers: '" +
- RawNameSize +
- "' for archive member header at offset " +
- Twine(Offset));
- return;
- }
- StartOfFile += NameSize;
- }
- }
- Expected<uint64_t> Archive::Child::getSize() const {
- if (Parent->IsThin)
- return Header->getSize();
- return Data.size() - StartOfFile;
- }
- Expected<uint64_t> Archive::Child::getRawSize() const {
- return Header->getSize();
- }
- Expected<bool> Archive::Child::isThinMember() const { return Header->isThin(); }
- Expected<std::string> Archive::Child::getFullName() const {
- Expected<bool> isThin = isThinMember();
- if (!isThin)
- return isThin.takeError();
- assert(isThin.get());
- Expected<StringRef> NameOrErr = getName();
- if (!NameOrErr)
- return NameOrErr.takeError();
- StringRef Name = *NameOrErr;
- if (sys::path::is_absolute(Name))
- return std::string(Name);
- SmallString<128> FullName = sys::path::parent_path(
- Parent->getMemoryBufferRef().getBufferIdentifier());
- sys::path::append(FullName, Name);
- return std::string(FullName.str());
- }
- Expected<StringRef> Archive::Child::getBuffer() const {
- Expected<bool> isThinOrErr = isThinMember();
- if (!isThinOrErr)
- return isThinOrErr.takeError();
- bool isThin = isThinOrErr.get();
- if (!isThin) {
- Expected<uint64_t> Size = getSize();
- if (!Size)
- return Size.takeError();
- return StringRef(Data.data() + StartOfFile, Size.get());
- }
- Expected<std::string> FullNameOrErr = getFullName();
- if (!FullNameOrErr)
- return FullNameOrErr.takeError();
- const std::string &FullName = *FullNameOrErr;
- ErrorOr<std::unique_ptr<MemoryBuffer>> Buf = MemoryBuffer::getFile(FullName);
- if (std::error_code EC = Buf.getError())
- return errorCodeToError(EC);
- Parent->ThinBuffers.push_back(std::move(*Buf));
- return Parent->ThinBuffers.back()->getBuffer();
- }
- Expected<Archive::Child> Archive::Child::getNext() const {
- Expected<const char *> NextLocOrErr = Header->getNextChildLoc();
- if (!NextLocOrErr)
- return NextLocOrErr.takeError();
- const char *NextLoc = *NextLocOrErr;
- // Check to see if this is at the end of the archive.
- if (NextLoc == nullptr)
- return Child(nullptr, nullptr, nullptr);
- // Check to see if this is past the end of the archive.
- if (NextLoc > Parent->Data.getBufferEnd()) {
- std::string Msg("offset to next archive member past the end of the archive "
- "after member ");
- Expected<StringRef> NameOrErr = getName();
- if (!NameOrErr) {
- consumeError(NameOrErr.takeError());
- uint64_t Offset = Data.data() - Parent->getData().data();
- return malformedError(Msg + "at offset " + Twine(Offset));
- } else
- return malformedError(Msg + NameOrErr.get());
- }
- Error Err = Error::success();
- Child Ret(Parent, NextLoc, &Err);
- if (Err)
- return std::move(Err);
- return Ret;
- }
- uint64_t Archive::Child::getChildOffset() const {
- const char *a = Parent->Data.getBuffer().data();
- const char *c = Data.data();
- uint64_t offset = c - a;
- return offset;
- }
- Expected<StringRef> Archive::Child::getName() const {
- Expected<uint64_t> RawSizeOrErr = getRawSize();
- if (!RawSizeOrErr)
- return RawSizeOrErr.takeError();
- uint64_t RawSize = RawSizeOrErr.get();
- Expected<StringRef> NameOrErr =
- Header->getName(Header->getSizeOf() + RawSize);
- if (!NameOrErr)
- return NameOrErr.takeError();
- StringRef Name = NameOrErr.get();
- return Name;
- }
- Expected<MemoryBufferRef> Archive::Child::getMemoryBufferRef() const {
- Expected<StringRef> NameOrErr = getName();
- if (!NameOrErr)
- return NameOrErr.takeError();
- StringRef Name = NameOrErr.get();
- Expected<StringRef> Buf = getBuffer();
- if (!Buf)
- return createFileError(Name, Buf.takeError());
- return MemoryBufferRef(*Buf, Name);
- }
- Expected<std::unique_ptr<Binary>>
- Archive::Child::getAsBinary(LLVMContext *Context) const {
- Expected<MemoryBufferRef> BuffOrErr = getMemoryBufferRef();
- if (!BuffOrErr)
- return BuffOrErr.takeError();
- auto BinaryOrErr = createBinary(BuffOrErr.get(), Context);
- if (BinaryOrErr)
- return std::move(*BinaryOrErr);
- return BinaryOrErr.takeError();
- }
- Expected<std::unique_ptr<Archive>> Archive::create(MemoryBufferRef Source) {
- Error Err = Error::success();
- std::unique_ptr<Archive> Ret;
- StringRef Buffer = Source.getBuffer();
- if (Buffer.startswith(BigArchiveMagic))
- Ret = std::make_unique<BigArchive>(Source, Err);
- else
- Ret = std::make_unique<Archive>(Source, Err);
- if (Err)
- return std::move(Err);
- return std::move(Ret);
- }
- std::unique_ptr<AbstractArchiveMemberHeader>
- Archive::createArchiveMemberHeader(const char *RawHeaderPtr, uint64_t Size,
- Error *Err) const {
- ErrorAsOutParameter ErrAsOutParam(Err);
- if (kind() != K_AIXBIG)
- return std::make_unique<ArchiveMemberHeader>(this, RawHeaderPtr, Size, Err);
- return std::make_unique<BigArchiveMemberHeader>(this, RawHeaderPtr, Size,
- Err);
- }
- uint64_t Archive::getArchiveMagicLen() const {
- if (isThin())
- return sizeof(ThinArchiveMagic) - 1;
- if (Kind() == K_AIXBIG)
- return sizeof(BigArchiveMagic) - 1;
- return sizeof(ArchiveMagic) - 1;
- }
- void Archive::setFirstRegular(const Child &C) {
- FirstRegularData = C.Data;
- FirstRegularStartOfFile = C.StartOfFile;
- }
- Archive::Archive(MemoryBufferRef Source, Error &Err)
- : Binary(Binary::ID_Archive, Source) {
- ErrorAsOutParameter ErrAsOutParam(&Err);
- StringRef Buffer = Data.getBuffer();
- // Check for sufficient magic.
- if (Buffer.startswith(ThinArchiveMagic)) {
- IsThin = true;
- } else if (Buffer.startswith(ArchiveMagic)) {
- IsThin = false;
- } else if (Buffer.startswith(BigArchiveMagic)) {
- Format = K_AIXBIG;
- IsThin = false;
- return;
- } else {
- Err = make_error<GenericBinaryError>("file too small to be an archive",
- object_error::invalid_file_type);
- return;
- }
- // Make sure Format is initialized before any call to
- // ArchiveMemberHeader::getName() is made. This could be a valid empty
- // archive which is the same in all formats. So claiming it to be gnu to is
- // fine if not totally correct before we look for a string table or table of
- // contents.
- Format = K_GNU;
- // Get the special members.
- child_iterator I = child_begin(Err, false);
- if (Err)
- return;
- child_iterator E = child_end();
- // See if this is a valid empty archive and if so return.
- if (I == E) {
- Err = Error::success();
- return;
- }
- const Child *C = &*I;
- auto Increment = [&]() {
- ++I;
- if (Err)
- return true;
- C = &*I;
- return false;
- };
- Expected<StringRef> NameOrErr = C->getRawName();
- if (!NameOrErr) {
- Err = NameOrErr.takeError();
- return;
- }
- StringRef Name = NameOrErr.get();
- // Below is the pattern that is used to figure out the archive format
- // GNU archive format
- // First member : / (may exist, if it exists, points to the symbol table )
- // Second member : // (may exist, if it exists, points to the string table)
- // Note : The string table is used if the filename exceeds 15 characters
- // BSD archive format
- // First member : __.SYMDEF or "__.SYMDEF SORTED" (the symbol table)
- // There is no string table, if the filename exceeds 15 characters or has a
- // embedded space, the filename has #1/<size>, The size represents the size
- // of the filename that needs to be read after the archive header
- // COFF archive format
- // First member : /
- // Second member : / (provides a directory of symbols)
- // Third member : // (may exist, if it exists, contains the string table)
- // Note: Microsoft PE/COFF Spec 8.3 says that the third member is present
- // even if the string table is empty. However, lib.exe does not in fact
- // seem to create the third member if there's no member whose filename
- // exceeds 15 characters. So the third member is optional.
- if (Name == "__.SYMDEF" || Name == "__.SYMDEF_64") {
- if (Name == "__.SYMDEF")
- Format = K_BSD;
- else // Name == "__.SYMDEF_64"
- Format = K_DARWIN64;
- // We know that the symbol table is not an external file, but we still must
- // check any Expected<> return value.
- Expected<StringRef> BufOrErr = C->getBuffer();
- if (!BufOrErr) {
- Err = BufOrErr.takeError();
- return;
- }
- SymbolTable = BufOrErr.get();
- if (Increment())
- return;
- setFirstRegular(*C);
- Err = Error::success();
- return;
- }
- if (Name.startswith("#1/")) {
- Format = K_BSD;
- // We know this is BSD, so getName will work since there is no string table.
- Expected<StringRef> NameOrErr = C->getName();
- if (!NameOrErr) {
- Err = NameOrErr.takeError();
- return;
- }
- Name = NameOrErr.get();
- if (Name == "__.SYMDEF SORTED" || Name == "__.SYMDEF") {
- // We know that the symbol table is not an external file, but we still
- // must check any Expected<> return value.
- Expected<StringRef> BufOrErr = C->getBuffer();
- if (!BufOrErr) {
- Err = BufOrErr.takeError();
- return;
- }
- SymbolTable = BufOrErr.get();
- if (Increment())
- return;
- } else if (Name == "__.SYMDEF_64 SORTED" || Name == "__.SYMDEF_64") {
- Format = K_DARWIN64;
- // We know that the symbol table is not an external file, but we still
- // must check any Expected<> return value.
- Expected<StringRef> BufOrErr = C->getBuffer();
- if (!BufOrErr) {
- Err = BufOrErr.takeError();
- return;
- }
- SymbolTable = BufOrErr.get();
- if (Increment())
- return;
- }
- setFirstRegular(*C);
- return;
- }
- // MIPS 64-bit ELF archives use a special format of a symbol table.
- // This format is marked by `ar_name` field equals to "/SYM64/".
- // For detailed description see page 96 in the following document:
- // http://techpubs.sgi.com/library/manuals/4000/007-4658-001/pdf/007-4658-001.pdf
- bool has64SymTable = false;
- if (Name == "/" || Name == "/SYM64/") {
- // We know that the symbol table is not an external file, but we still
- // must check any Expected<> return value.
- Expected<StringRef> BufOrErr = C->getBuffer();
- if (!BufOrErr) {
- Err = BufOrErr.takeError();
- return;
- }
- SymbolTable = BufOrErr.get();
- if (Name == "/SYM64/")
- has64SymTable = true;
- if (Increment())
- return;
- if (I == E) {
- Err = Error::success();
- return;
- }
- Expected<StringRef> NameOrErr = C->getRawName();
- if (!NameOrErr) {
- Err = NameOrErr.takeError();
- return;
- }
- Name = NameOrErr.get();
- }
- if (Name == "//") {
- Format = has64SymTable ? K_GNU64 : K_GNU;
- // The string table is never an external member, but we still
- // must check any Expected<> return value.
- Expected<StringRef> BufOrErr = C->getBuffer();
- if (!BufOrErr) {
- Err = BufOrErr.takeError();
- return;
- }
- StringTable = BufOrErr.get();
- if (Increment())
- return;
- setFirstRegular(*C);
- Err = Error::success();
- return;
- }
- if (Name[0] != '/') {
- Format = has64SymTable ? K_GNU64 : K_GNU;
- setFirstRegular(*C);
- Err = Error::success();
- return;
- }
- if (Name != "/") {
- Err = errorCodeToError(object_error::parse_failed);
- return;
- }
- Format = K_COFF;
- // We know that the symbol table is not an external file, but we still
- // must check any Expected<> return value.
- Expected<StringRef> BufOrErr = C->getBuffer();
- if (!BufOrErr) {
- Err = BufOrErr.takeError();
- return;
- }
- SymbolTable = BufOrErr.get();
- if (Increment())
- return;
- if (I == E) {
- setFirstRegular(*C);
- Err = Error::success();
- return;
- }
- NameOrErr = C->getRawName();
- if (!NameOrErr) {
- Err = NameOrErr.takeError();
- return;
- }
- Name = NameOrErr.get();
- if (Name == "//") {
- // The string table is never an external member, but we still
- // must check any Expected<> return value.
- Expected<StringRef> BufOrErr = C->getBuffer();
- if (!BufOrErr) {
- Err = BufOrErr.takeError();
- return;
- }
- StringTable = BufOrErr.get();
- if (Increment())
- return;
- }
- setFirstRegular(*C);
- Err = Error::success();
- }
- Archive::child_iterator Archive::child_begin(Error &Err,
- bool SkipInternal) const {
- if (isEmpty())
- return child_end();
- if (SkipInternal)
- return child_iterator::itr(
- Child(this, FirstRegularData, FirstRegularStartOfFile), Err);
- const char *Loc = Data.getBufferStart() + getFirstChildOffset();
- Child C(this, Loc, &Err);
- if (Err)
- return child_end();
- return child_iterator::itr(C, Err);
- }
- Archive::child_iterator Archive::child_end() const {
- return child_iterator::end(Child(nullptr, nullptr, nullptr));
- }
- StringRef Archive::Symbol::getName() const {
- return Parent->getSymbolTable().begin() + StringIndex;
- }
- Expected<Archive::Child> Archive::Symbol::getMember() const {
- const char *Buf = Parent->getSymbolTable().begin();
- const char *Offsets = Buf;
- if (Parent->kind() == K_GNU64 || Parent->kind() == K_DARWIN64)
- Offsets += sizeof(uint64_t);
- else
- Offsets += sizeof(uint32_t);
- uint64_t Offset = 0;
- if (Parent->kind() == K_GNU) {
- Offset = read32be(Offsets + SymbolIndex * 4);
- } else if (Parent->kind() == K_GNU64) {
- Offset = read64be(Offsets + SymbolIndex * 8);
- } else if (Parent->kind() == K_BSD) {
- // The SymbolIndex is an index into the ranlib structs that start at
- // Offsets (the first uint32_t is the number of bytes of the ranlib
- // structs). The ranlib structs are a pair of uint32_t's the first
- // being a string table offset and the second being the offset into
- // the archive of the member that defines the symbol. Which is what
- // is needed here.
- Offset = read32le(Offsets + SymbolIndex * 8 + 4);
- } else if (Parent->kind() == K_DARWIN64) {
- // The SymbolIndex is an index into the ranlib_64 structs that start at
- // Offsets (the first uint64_t is the number of bytes of the ranlib_64
- // structs). The ranlib_64 structs are a pair of uint64_t's the first
- // being a string table offset and the second being the offset into
- // the archive of the member that defines the symbol. Which is what
- // is needed here.
- Offset = read64le(Offsets + SymbolIndex * 16 + 8);
- } else {
- // Skip offsets.
- uint32_t MemberCount = read32le(Buf);
- Buf += MemberCount * 4 + 4;
- uint32_t SymbolCount = read32le(Buf);
- if (SymbolIndex >= SymbolCount)
- return errorCodeToError(object_error::parse_failed);
- // Skip SymbolCount to get to the indices table.
- const char *Indices = Buf + 4;
- // Get the index of the offset in the file member offset table for this
- // symbol.
- uint16_t OffsetIndex = read16le(Indices + SymbolIndex * 2);
- // Subtract 1 since OffsetIndex is 1 based.
- --OffsetIndex;
- if (OffsetIndex >= MemberCount)
- return errorCodeToError(object_error::parse_failed);
- Offset = read32le(Offsets + OffsetIndex * 4);
- }
- const char *Loc = Parent->getData().begin() + Offset;
- Error Err = Error::success();
- Child C(Parent, Loc, &Err);
- if (Err)
- return std::move(Err);
- return C;
- }
- Archive::Symbol Archive::Symbol::getNext() const {
- Symbol t(*this);
- if (Parent->kind() == K_BSD) {
- // t.StringIndex is an offset from the start of the __.SYMDEF or
- // "__.SYMDEF SORTED" member into the string table for the ranlib
- // struct indexed by t.SymbolIndex . To change t.StringIndex to the
- // offset in the string table for t.SymbolIndex+1 we subtract the
- // its offset from the start of the string table for t.SymbolIndex
- // and add the offset of the string table for t.SymbolIndex+1.
- // The __.SYMDEF or "__.SYMDEF SORTED" member starts with a uint32_t
- // which is the number of bytes of ranlib structs that follow. The ranlib
- // structs are a pair of uint32_t's the first being a string table offset
- // and the second being the offset into the archive of the member that
- // define the symbol. After that the next uint32_t is the byte count of
- // the string table followed by the string table.
- const char *Buf = Parent->getSymbolTable().begin();
- uint32_t RanlibCount = 0;
- RanlibCount = read32le(Buf) / 8;
- // If t.SymbolIndex + 1 will be past the count of symbols (the RanlibCount)
- // don't change the t.StringIndex as we don't want to reference a ranlib
- // past RanlibCount.
- if (t.SymbolIndex + 1 < RanlibCount) {
- const char *Ranlibs = Buf + 4;
- uint32_t CurRanStrx = 0;
- uint32_t NextRanStrx = 0;
- CurRanStrx = read32le(Ranlibs + t.SymbolIndex * 8);
- NextRanStrx = read32le(Ranlibs + (t.SymbolIndex + 1) * 8);
- t.StringIndex -= CurRanStrx;
- t.StringIndex += NextRanStrx;
- }
- } else {
- // Go to one past next null.
- t.StringIndex = Parent->getSymbolTable().find('\0', t.StringIndex) + 1;
- }
- ++t.SymbolIndex;
- return t;
- }
- Archive::symbol_iterator Archive::symbol_begin() const {
- if (!hasSymbolTable())
- return symbol_iterator(Symbol(this, 0, 0));
- const char *buf = getSymbolTable().begin();
- if (kind() == K_GNU) {
- uint32_t symbol_count = 0;
- symbol_count = read32be(buf);
- buf += sizeof(uint32_t) + (symbol_count * (sizeof(uint32_t)));
- } else if (kind() == K_GNU64) {
- uint64_t symbol_count = read64be(buf);
- buf += sizeof(uint64_t) + (symbol_count * (sizeof(uint64_t)));
- } else if (kind() == K_BSD) {
- // The __.SYMDEF or "__.SYMDEF SORTED" member starts with a uint32_t
- // which is the number of bytes of ranlib structs that follow. The ranlib
- // structs are a pair of uint32_t's the first being a string table offset
- // and the second being the offset into the archive of the member that
- // define the symbol. After that the next uint32_t is the byte count of
- // the string table followed by the string table.
- uint32_t ranlib_count = 0;
- ranlib_count = read32le(buf) / 8;
- const char *ranlibs = buf + 4;
- uint32_t ran_strx = 0;
- ran_strx = read32le(ranlibs);
- buf += sizeof(uint32_t) + (ranlib_count * (2 * (sizeof(uint32_t))));
- // Skip the byte count of the string table.
- buf += sizeof(uint32_t);
- buf += ran_strx;
- } else if (kind() == K_DARWIN64) {
- // The __.SYMDEF_64 or "__.SYMDEF_64 SORTED" member starts with a uint64_t
- // which is the number of bytes of ranlib_64 structs that follow. The
- // ranlib_64 structs are a pair of uint64_t's the first being a string
- // table offset and the second being the offset into the archive of the
- // member that define the symbol. After that the next uint64_t is the byte
- // count of the string table followed by the string table.
- uint64_t ranlib_count = 0;
- ranlib_count = read64le(buf) / 16;
- const char *ranlibs = buf + 8;
- uint64_t ran_strx = 0;
- ran_strx = read64le(ranlibs);
- buf += sizeof(uint64_t) + (ranlib_count * (2 * (sizeof(uint64_t))));
- // Skip the byte count of the string table.
- buf += sizeof(uint64_t);
- buf += ran_strx;
- } else {
- uint32_t member_count = 0;
- uint32_t symbol_count = 0;
- member_count = read32le(buf);
- buf += 4 + (member_count * 4); // Skip offsets.
- symbol_count = read32le(buf);
- buf += 4 + (symbol_count * 2); // Skip indices.
- }
- uint32_t string_start_offset = buf - getSymbolTable().begin();
- return symbol_iterator(Symbol(this, 0, string_start_offset));
- }
- Archive::symbol_iterator Archive::symbol_end() const {
- return symbol_iterator(Symbol(this, getNumberOfSymbols(), 0));
- }
- uint32_t Archive::getNumberOfSymbols() const {
- if (!hasSymbolTable())
- return 0;
- const char *buf = getSymbolTable().begin();
- if (kind() == K_GNU)
- return read32be(buf);
- if (kind() == K_GNU64)
- return read64be(buf);
- if (kind() == K_BSD)
- return read32le(buf) / 8;
- if (kind() == K_DARWIN64)
- return read64le(buf) / 16;
- uint32_t member_count = 0;
- member_count = read32le(buf);
- buf += 4 + (member_count * 4); // Skip offsets.
- return read32le(buf);
- }
- Expected<Optional<Archive::Child>> Archive::findSym(StringRef name) const {
- Archive::symbol_iterator bs = symbol_begin();
- Archive::symbol_iterator es = symbol_end();
- for (; bs != es; ++bs) {
- StringRef SymName = bs->getName();
- if (SymName == name) {
- if (auto MemberOrErr = bs->getMember())
- return Child(*MemberOrErr);
- else
- return MemberOrErr.takeError();
- }
- }
- return Optional<Child>();
- }
- // Returns true if archive file contains no member file.
- bool Archive::isEmpty() const {
- return Data.getBufferSize() == getArchiveMagicLen();
- }
- bool Archive::hasSymbolTable() const { return !SymbolTable.empty(); }
- BigArchive::BigArchive(MemoryBufferRef Source, Error &Err)
- : Archive(Source, Err) {
- ErrorAsOutParameter ErrAsOutParam(&Err);
- StringRef Buffer = Data.getBuffer();
- ArFixLenHdr = reinterpret_cast<const FixLenHdr *>(Buffer.data());
- StringRef RawOffset = getFieldRawString(ArFixLenHdr->FirstChildOffset);
- if (RawOffset.getAsInteger(10, FirstChildOffset))
- // TODO: Out-of-line.
- Err = malformedError("malformed AIX big archive: first member offset \"" +
- RawOffset + "\" is not a number");
- RawOffset = getFieldRawString(ArFixLenHdr->LastChildOffset);
- if (RawOffset.getAsInteger(10, LastChildOffset))
- // TODO: Out-of-line.
- Err = malformedError("malformed AIX big archive: last member offset \"" +
- RawOffset + "\" is not a number");
- child_iterator I = child_begin(Err, false);
- if (Err)
- return;
- child_iterator E = child_end();
- if (I == E) {
- Err = Error::success();
- return;
- }
- setFirstRegular(*I);
- Err = Error::success();
- }
|