IFSHandler.h

Go to the documentation of this file.

//===- IFSHandler.h ---------------------------------------------*- C++ -*-===//
//
// 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
//
//===-----------------------------------------------------------------------===/
///
/// \file
/// This file declares an interface for reading and writing .ifs (text-based
/// InterFace Stub) files.
///
//===-----------------------------------------------------------------------===/
 
#ifndef LLVM_INTERFACESTUB_IFSHANDLER_H
#define LLVM_INTERFACESTUB_IFSHANDLER_H
 
#include "IFSStub.h"
#include "llvm/Support/Compiler.h"
#include "llvm/Support/Error.h"
#include "llvm/Support/VersionTuple.h"
#include <memory>
#include <optional>
#include <string>
#include <vector>
 
namespace llvm {
 
class raw_ostream;
class Error;
class StringRef;
 
namespace ifs {
 
struct IFSStub;
 
const VersionTuple IFSVersionCurrent(3, 0);
 
/// Attempts to read an IFS interface file from a StringRef buffer.
LLVM_ABI Expected<std::unique_ptr<IFSStub>> readIFSFromBuffer(StringRef Buf);
 
/// Attempts to write an IFS interface file to a raw_ostream.
LLVM_ABI Error writeIFSToOutputStream(raw_ostream &OS, const IFSStub &Stub);
 
/// Override the target platform inforation in the text stub.
LLVM_ABI Error
overrideIFSTarget(IFSStub &Stub, std::optional<IFSArch> OverrideArch,
                  std::optional<IFSEndiannessType> OverrideEndianness,
                  std::optional<IFSBitWidthType> OverrideBitWidth,
                  std::optional<std::string> OverrideTriple);
 
/// Validate the target platform inforation in the text stub.
LLVM_ABI Error validateIFSTarget(IFSStub &Stub, bool ParseTriple);
 
/// Strips target platform information from the text stub.
LLVM_ABI void stripIFSTarget(IFSStub &Stub, bool StripTriple, bool StripArch,
                             bool StripEndianness, bool StripBitWidth);
 
LLVM_ABI Error filterIFSSyms(IFSStub &Stub, bool StripUndefined,
                             const std::vector<std::string> &Exclude = {});
 
/// Parse llvm triple string into a IFSTarget struct.
LLVM_ABI IFSTarget parseTriple(StringRef TripleStr);
 
} // end namespace ifs
} // end namespace llvm
 
#endif // LLVM_INTERFACESTUB_IFSHANDLER_H