pax_global_header00006660000000000000000000000064144345733710014525gustar00rootroot0000000000000052 comment=b9a5f970b210dbc115c7aaac10e04623bdc08ef8 LIEF-0.13.1/000077500000000000000000000000001443457337100123265ustar00rootroot00000000000000LIEF-0.13.1/.clang-tidy000066400000000000000000000021221443457337100143570ustar00rootroot00000000000000Checks: > -*, bugprone-*, google-*, misc-*, modernize-*, performance-*, portability-*, readability-*, cppcoreguidelines-*, -bugprone-easily-swappable-parameters, -bugprone-narrowing-conversions, -google-readability-namespace-comments, -google-readability-todo, -google-runtime-int, -google-default-arguments -google-runtime-references, -misc-non-private-member-variables-in-classes, -modernize-use-trailing-return-type, -performance-noexcept-move-constructor, -readability-function-cognitive-complexity, -readability-inconsistent-declaration-parameter-name, -readability-magic-numbers, -readability-named-parameter, -readability-redundant-string-cstr -readability-uppercase-literal-suffix, # Turn all the warnings from the checks above into errors. #WarningsAsErrors: "*" UseColor: false CheckOptions: - { key: readability-identifier-naming.PrivateMemberSuffix, value: _ } - { key: readability-identifier-naming.ProtectedMemberSuffix, value: _ } - { key: readability-identifier-naming.MacroDefinitionCase, value: UPPER_CASE } LIEF-0.13.1/.dockerignore000066400000000000000000000000061443457337100147760ustar00rootroot00000000000000build LIEF-0.13.1/.github/000077500000000000000000000000001443457337100136665ustar00rootroot00000000000000LIEF-0.13.1/.github/ISSUE_TEMPLATE/000077500000000000000000000000001443457337100160515ustar00rootroot00000000000000LIEF-0.13.1/.github/ISSUE_TEMPLATE/feature-request.md000066400000000000000000000005011443457337100215100ustar00rootroot00000000000000--- name: Feature Request about: Suggest an idea for this project title: '' labels: '' assignees: '' --- *Please describe what you would like to have in LIEF*. **Note: If the feature is not precise or if you want to have feedback first, you can open a [discussion](https://github.com/lief-project/LIEF/discussions).** LIEF-0.13.1/.github/ISSUE_TEMPLATE/premium-issue.md000066400000000000000000000016061443457337100212020ustar00rootroot00000000000000--- name: Premium Issue about: You need a fix for the issue with a high priority title: '' labels: Premium assignees: romainthomas --- *Premium issues can be used to get a higher priority resolution for users and companies.* *In return, you need to contribute to the project with an action:* - Writing a guest blog post here: https://lief-project.github.io/blog/ - Fixing another issue - Sponsoring the issue *Premium issues will be highlighted in the changelog and the release blog post with your name/logo* ---------------------------------- **Description** *Please describe the issue/request that needs to be addressed* **Context** *Please provide the version of LIEF, the operating system as well as the binaries associated with the issue (it can be sent by email as well)* ---------------------------------- **Reach out to `issue@lief.re` to discuss about the timeline/contribution.** LIEF-0.13.1/.github/ISSUE_TEMPLATE/regular-issue.md000066400000000000000000000012371443457337100211650ustar00rootroot00000000000000--- name: Regular Issue about: You identified a bug or a problem in LIEF title: '' labels: '' assignees: romainthomas --- **Describe the bug** A clear and concise description of what the bug is. **To Reproduce** Steps to reproduce the behavior: **Expected behavior** A clear and concise description of what you expected to happen (if applicable) **Environment (please complete the following information):** - System and Version : [e.g. Ubuntu 16.04] - Target format (PE, ELF, Mach-O) - LIEF commit version: ``python -c "import lief;print(lief.__version__)"`` or the one from ``LIEF/config.h`` **Additional context** Add any other context about the problem here. LIEF-0.13.1/.github/deploy-key.enc000066400000000000000000000062601443457337100164430ustar00rootroot00000000000000p? ij 9?:? }۴rʶ cKtf2kPv# z?&+Vlqlyzju뎨un= 2W +%t*R}5tV#fʈYŀU 5Ziɣ;ldt< uoԂ !8/pM;:.\ ]dGS DڹRߔ1qd5™%frCSm0u=(#Y[cT +rYĠnloT1@)U)v@aw1 CWplN*RG5& /a?g/EgRm{}ug |>R 1_5H6AL.@6bD!ޘ."tC \A&s2ZI^@̛<-*~QN#GU>*`<ޯ/St}׷ߗJCX2\9銄X/~=zs\u`]]LVhW ˯+_dxXC_(rXq|גwV&LgH\!7a\Z#}N8F` #Er7yZkeò\*@7=)=/&Iփz Ć5H V(Zgk)h|b(-53)%]iU ݹ0gΐEr`&sN0|TDMh4,(&)Ixǡ3A: z4-D|z%ʢnS;oĄx‰{2 B2 )bÒ+HFs8u|W:s梋: $$V܏ Φ*w3]4dIPvf ,;iH(hX`ɸ\…e^U]+Kq" I x$3"o:4DzU\+qۉ~0n2$0\z.{dUKmџ G]]/kɏYx*+prG;$C5u|DPo3K-Yu0>IKK1E3L_SiKCb92Zmk}5N]\l8R|&}z 5۵Z9I)[2F9|(Zzv?F7 ë9$4J$I&<݀KN4/CϚ;{?4}3+}I'J^nzY_y8ZP~kA)'Lɩ]{g3\ѷR#ʮF N`Q _;l%t[!𺞕1:r ] ~g:m3i&~Fdi9(9;aqޫ&ڋ.(^'!N4DRcK4RRz "N_.f5:Z(îXmMu QdL LN<>jYfjQO9sp'Ien@w'#b A‡_q.sozY|-dS> zQ^甊H&U?Sh,"tCLd\f K\k2RVQMSjYAlrmCrR"%e8-Ct>aVxzYk+MZX@`p}f>bP4<`v=Ic C bl<ڥ!ǝ-;:?tPәd 5VFFFw@-죙SRahJeڡQ@M`_趽t9ڧ8Ѵ-d\$%xA819ÝU U7dCN7'kLx?G-j2c dm!}0F̾q Ywփ<5+u l}A_1,a;fMThʒ]\ZȢ`.|8TH:}1KMGc+| N·4!L0qM!F-ͣ= B0žC_RG{4- T0<ا6"(0/]tH2l0ETH7c0q^Ј ?̵e3ڢsh OQt`x0Ÿj$0^ǟ&72FPy%'k=@Wޱ$T/A2X1oW6ua, OyܩD7ՈJ?@ϓ4)2`퓌B?-w"h0>՞Li8926QVs bК@nn8-Ae4g Zu]~$)Â)A)(a7ġ&}͸g&akdAGSDqh,8=N')eR0P Cu,c:>SuUi#v?bH+xovACS@$ -Ԋ3|}:cB^ψX 1-7QKxN_o40{ZȠ2ג!ۯƗ$K2sH#^csiNҲ߶pAiDYrGC(S}qYTk%'kM[wakB5*ȮI,qq՚͵d]J`_ك>o"cwj**u@]^Xe{JTndLEtCnhLmC0P%~O&3ޚ+8xZrxF<#`=U&ޱqvv1H7Dcl|aC3ҾbɻCfZV=Vqz?TܕF Gӫ`OjKR ՙ/GBjt?oV6夽D<:+.X1%" 4e8q}4VwN|P j,&7cr˼ӽI? Kz[mIL7B"!ءQ/ԊXi }+hH}{̸xoqB$F'i?LIEF-0.13.1/.github/deploy.py000066400000000000000000000214001443457337100155310ustar00rootroot00000000000000#!/usr/bin/env python3 import sys import os import re import logging import pathlib import subprocess import shutil import json import itertools from collections import defaultdict from datetime import datetime from mako.template import Template from enum import Enum, auto import tempfile import boto3 from botocore.exceptions import ClientError class CI(Enum): UNKNOWN = auto() TRAVIS = auto() APPVEYOR = auto() GITLAB_CI = auto() CIRCLE_CI = auto() GITHUB_ACTIONS = auto() AZURE = auto() LOCAL = auto() def pretty_ci_name(ci): return str(ci).split(".")[-1].replace("_", "-").lower() def is_pr(ci): if ci == CI.TRAVIS: cond1 = os.getenv("TRAVIS_EVENT_TYPE", "pull_request") == "pull_request" cond2 = not (os.getenv("TRAVIS_REPO_SLUG", "").startswith("lief-project/") or os.getenv("TRAVIS_REPO_SLUG", "").startswith("romainthomas/LIEF")) return cond1 or cond2 elif ci == CI.APPVEYOR: logger.info("%s - %s", os.getenv("APPVEYOR_PULL_REQUEST_NUMBER", -1), os.getenv("APPVEYOR_REPO_NAME", "")) pr_number = os.getenv("APPVEYOR_PULL_REQUEST_NUMBER", "") cond1 = len(pr_number) != 0 and int(pr_number) >= 0 cond2 = not (os.getenv("APPVEYOR_REPO_NAME", "").startswith("lief-project/") or os.getenv("APPVEYOR_REPO_NAME", "").startswith("romainthomas/")) return cond1 or cond2 elif ci == CI.CIRCLE_CI: cond1 = int(os.getenv("CIRCLE_PR_NUMBER", -1)) >= 0 cond2 = os.getenv("CIRCLE_PROJECT_USERNAME", "") != "lief-project" and os.getenv("CIRCLE_PROJECT_USERNAME", "") != "romainthomas" return cond1 or cond2 elif ci == CI.GITHUB_ACTIONS: cond1 = os.getenv("GITHUB_HEAD_REF", "") != "" cond2 = not (os.getenv("GITHUB_REPOSITORY", "").startswith("lief-project/") or os.getenv("GITHUB_REPOSITORY", "").startswith("romainthomas/LIEF")) return cond1 or cond2 elif ci == CI.LOCAL: return False return True def get_branch(ci): if ci == CI.TRAVIS: return os.getenv("TRAVIS_BRANCH") elif ci == CI.APPVEYOR: return os.getenv("APPVEYOR_REPO_BRANCH") elif ci == CI.CIRCLE_CI: return os.getenv("CIRCLE_BRANCH") elif ci == CI.GITHUB_ACTIONS: return os.getenv("GITHUB_REF").replace("refs/heads/", "") elif ci == CI.LOCAL: return os.getenv("CI_BRANCH") return None def get_ci_workdir(ci): if ci == CI.CIRCLE_CI: return os.getenv("CIRCLE_WORKING_DIRECTORY") elif ci == CI.TRAVIS: return os.getenv("TRAVIS_BUILD_DIR") elif ci == CI.APPVEYOR: return os.getenv("APPVEYOR_BUILD_FOLDER") elif ci == CI.GITHUB_ACTIONS: return os.getenv("GITHUB_WORKSPACE") elif ci == CI.LOCAL: return os.getenv("CI_WORKING_DIR") else: logger.critical("Unsupported CI to resolve working directory") sys.exit(1) def get_tag(ci): if ci == CI.CIRCLE_CI: return os.getenv("CIRCLE_TAG", "") elif ci == CI.TRAVIS: return os.getenv("TRAVIS_TAG", "") elif ci == CI.APPVEYOR: if "APPVEYOR_REPO_TAG_NAME" in os.environ: return os.getenv("APPVEYOR_REPO_TAG_NAME", "") return "" elif ci == CI.GITHUB_ACTIONS: ref = os.getenv("GITHUB_REF", "") logger.info("Github Action tag: {}".format(ref)) if ref.startswith("refs/tags/"): return ref.replace("refs/tags/", "") return "" elif ci == CI.LOCAL: return os.getenv("CI_TAG") else: logger.critical("Unsupported CI to resolve working directory") sys.exit(1) LOG_LEVEL = logging.INFO logging.getLogger().addHandler(logging.StreamHandler(stream=sys.stdout)) logging.getLogger().setLevel(LOG_LEVEL) logger = logging.getLogger(__name__) CURRENT_CI = CI.UNKNOWN # Detect CI # =========================================== if os.getenv("TRAVIS", None) is not None: CURRENT_CI = CI.TRAVIS elif os.getenv("APPVEYOR", None) is not None: CURRENT_CI = CI.APPVEYOR elif os.getenv("GITHUB_ACTIONS", None) is not None: CURRENT_CI = CI.GITHUB_ACTIONS elif os.getenv("GITLAB_CI", None) is not None: CURRENT_CI = CI.GITLAB_CI elif os.getenv("CI_LOCAL", "") == "true": CURRENT_CI = CI.LOCAL else: logger.error("Can't detect CI!") sys.exit(1) CI_PRETTY_NAME = pretty_ci_name(CURRENT_CI) logger.info("CI: %s", CI_PRETTY_NAME) ALLOWED_BRANCHES = {"master", "deploy", "devel"} BRANCH_NAME = get_branch(CURRENT_CI) TAG_NAME = get_tag(CURRENT_CI) IS_TAGGED = TAG_NAME is not None and len(TAG_NAME) > 0 logger.info("Branch: %s", BRANCH_NAME) logger.info("Tag: %s", TAG_NAME) if BRANCH_NAME.startswith("release-"): logger.info("Branch release") elif BRANCH_NAME not in ALLOWED_BRANCHES and not IS_TAGGED: logger.info("Skip deployment for branch '%s'", BRANCH_NAME) sys.exit(0) if is_pr(CURRENT_CI): logger.info("Skip pull request") sys.exit(0) CURRENTDIR = pathlib.Path(__file__).resolve().parent REPODIR = CURRENTDIR.parent # According to Scaleway S3 documentation, the endpoint # should starts with ''.s3..scw.cloud # Nevertheless boto3 uses /{Bucket} endpoints suffix # which create issues (see: https://stackoverflow.com/a/70383653) LIEF_S3_REGION = "fr-par" LIEF_S3_ENDPOINT = "https://s3.{region}.scw.cloud".format(region=LIEF_S3_REGION) LIEF_S3_BUCKET = "lief" LIEF_S3_KEY = os.getenv("LIEF_S3_KEY", None) LIEF_S3_SECRET = os.getenv("LIEF_S3_SECRET", None) if LIEF_S3_KEY is None or len(LIEF_S3_KEY) == 0: logger.error("LIEF_S3_KEY is not set!") sys.exit(1) if LIEF_S3_SECRET is None or len(LIEF_S3_SECRET) == 0: logger.error("LIEF_S3_SECRET is not set!") sys.exit(1) CI_CWD = pathlib.Path(get_ci_workdir(CURRENT_CI)) if CI_CWD is None: logger.error("Can't resolve CI working dir") sys.exit(1) DIST_DIR = REPODIR / "dist" BUILD_DIR = REPODIR / "build" logger.info("Working directory: %s", CI_CWD) INDEX_TEMPLATE = r""" Links for lief

Links for lief

% for path, filename in files: ${filename}
% endfor """ SKIP_LIST = ["index.html"] s3 = boto3.resource( 's3', region_name=LIEF_S3_REGION, use_ssl=True, endpoint_url=LIEF_S3_ENDPOINT, aws_access_key_id=LIEF_S3_KEY, aws_secret_access_key=LIEF_S3_SECRET ) def push_wheel(file: str, dir_name: str): wheel_file = pathlib.Path(file) dst = f"{dir_name}/lief/{wheel_file.name}" logger.info("Uploading %s to %s", file, dst) try: obj = s3.Object(LIEF_S3_BUCKET, dst) obj.put(Body=wheel_file.read_bytes()) return 0 except ClientError as e: logger.error("S3 push failed: %s", e) return 1 def push_sdk(file: str, dir_name: str): sdk_file = pathlib.Path(file) dst = f"{dir_name}/sdk/{sdk_file.name}" logger.info("Uploading %s to %s", file, dst) try: obj = s3.Object(LIEF_S3_BUCKET, dst) obj.put(Body=sdk_file.read_bytes()) return 0 except ClientError as e: logger.error("S3 push failed: %s", e) return 1 def filename(object): return pathlib.Path(object.key).name def generate_sdk_index(dir_name: str): files = s3.Bucket(LIEF_S3_BUCKET).objects.filter(Prefix=f'{dir_name}/sdk') tmpl_info = [(object.key, filename(object)) for object in files if filename(object) not in SKIP_LIST] html = Template(INDEX_TEMPLATE).render(files=tmpl_info) return html def generate_pypi_index(dir_name: str): files = s3.Bucket(LIEF_S3_BUCKET).objects.filter(Prefix=f'{dir_name}/lief') tmpl_info = [(object.key, filename(object)) for object in files if filename(object) not in SKIP_LIST] html = Template(INDEX_TEMPLATE).render(files=tmpl_info) return html dir_name = "latest" if BRANCH_NAME != "master": dir_name = "{}".format(BRANCH_NAME.replace("/", "-").replace("_", "-")) if BRANCH_NAME.startswith("release-"): _, dir_name = BRANCH_NAME.split("release-") if IS_TAGGED: dir_name = str(TAG_NAME) logger.info("Destination directory: %s", dir_name) for file in DIST_DIR.glob("*.whl"): logger.info("[WHEEL] Uploading '%s'", file.as_posix()) push_wheel(file.as_posix(), dir_name) for file in itertools.chain(BUILD_DIR.glob("*.zip"), BUILD_DIR.glob("*.tar.gz")): logger.info("[SDK ] Uploading '%s'", file.as_posix()) push_sdk(file.as_posix(), dir_name) sdk_index = generate_sdk_index(dir_name) with tempfile.TemporaryDirectory() as tmp: tmp = pathlib.Path(tmp) index = (tmp / "index.html") index.write_text(sdk_index) push_sdk(index.as_posix(), dir_name) pypi_index = generate_pypi_index(dir_name) with tempfile.TemporaryDirectory() as tmp: tmp = pathlib.Path(tmp) index = (tmp / "index.html") index.write_text(pypi_index) push_wheel(index.as_posix(), dir_name) logger.info("Done!") LIEF-0.13.1/.github/images/000077500000000000000000000000001443457337100151335ustar00rootroot00000000000000LIEF-0.13.1/.github/images/architecture.png000066400000000000000000002214151443457337100203300ustar00rootroot00000000000000PNG  IHDR| IDATx^tTբ/ !@ (z ^Q,X+WEED wBH!5LLzg8Kp7nuպMۣO@@@%нs.['2 ?%?N   8kI?q лs*@@@\E κk7oܲ+U:E?@@@ұuWF   +u.#:   ,@@@ )@@@5}@@@@gNɩ@@@%J\   pi@@@%J\   pi@@@%J\   pi@@@%J\   pi@@@%J\   pi@@@%J\   pi@@@%J\   pi@@@%J\   pi@@@%J\   pip-,zs3۱ֈ^Jlڶ[?E]Kշgg=򢪪j]u*-++f~OzBr \VᑻWv*K!@ XoL  K |,)7kܘ3,U.5q3ug3SXt۰K**&\}pycFA9C5 -$ %g۟~ܿrO_v@EM L hv8 OX X]mF `++! X-B@3V+3ƨ@00 @`%X BQ@VR9 V+ Xu7 ?+J`? X]uf k|\R4Ö73f0]Z{۶Ңd+n$ 7` F:H{ k*@{ !{pjd 0RXm-J} }X?8UJ`5He >@gZ@*@`%Yn$mV[R `s3V- N X,@s7FuYE@ X F #uۺ,֢ԇ_ s@  SV# ܍m]jkQC/`{j9@VhFHݶ.K`(!0=C` Ttݸs:AA٥>=;kҍ goHEp'@G XXǞo.홻QnڅJ@0=C`%@ X F ѥ, +kp+7w#A`5KY@s3V V%nFjD g@V#K܍Ո.e@}XY# X F ]"!F@ X,qs7V#E0=C`e .@`%Yn$Ft) `{A<\J`5HXR@ 5xjd ѥ, +kp+7w#A`5KY@s3V V%nFjD g@V#K܍Ո.e@}XY# X F ]"!F@ X,qs7V#E0=C`e .@`%Yn$Ft) `{A<\J`5HXR@ 5xjd ѥ, +kp+7w#A`5KY@s3V V%nFjD g@V#K܍Ո.e@}XY# X F ]"!F@ X,qs7V#E0=C`e .@`%Yn$Ft) `{A<\J`5HXR@ 5xjd ѥ, +kp+7w#A`5KY@s3V V%nFjD g@V#K܍Ո.e@}XY# 4$hh+SVTdQkg,g #/-PaXT[6>E:=:jp,n܍bJ.D8+pVWսs[ hא[Es7V)@@8R*$7@ Q65@ X _F'! X SF  X !V+C03 @8 hJ`mȟEpՑڴJ`u?t @^B@J`m` X]xr +?i `5   ]jwb@@@Fje@@@.@`;1   X#@`F2   v ڝ@Z~ښ Zkr`C@ X@eZ9͎IZ*8Ǒݣ-@\JRAg@: ^@$ ^>4Q7' N覜#8JaWoYgQݦ@\F2SAG@¿>3V45@@\KZAo@l,PX^ǭE.>\{)n\"ª6M4&:Wy:@ XY! )1L?l.ԺԲF[6UII1aZT=Z5$# pk( 5ҊEn}28}ZZZBX50ׄ/LCF˴y@!@`*u"8T{ dSkٶ7֭RYiѯR@T y8XbtNԨ>q vw@ %@LAu-X:vlۢc^ pp"C|u)_+k@6V8R  *}PUlznc^kzҢqQ}Cpe  4 L!uciٳ{8f߰xE5J=@pzs;'@ ZMGA@G lI/ri+UVv߮Jn%o_TɵtncZ]"gZ% GXY .-`:;uO9ڐi_~ZzJ^lSKF&+"b\ ,@le)I~]Tuٗ)0dJV|&裉gй}#xճ !SRFRfkWc?n)oe Ci^n0@F&@`mdp@WXo)5 ;y e|C̦K B5pqpn9FՀ"E@ z3B@-Rxoxyy֮2ks$/SV/^ vz6\\FGɜ`_=6pRh@4hUzlSVWWk5V6Ifx' -@QVGI UoUXt Shݲa_It@q X3j@IuM_Ch5`h~zNjd令@.8)t 4e9.9кqJ?:}ނu99}  :֛@F'0UX㮩k .҅{I@l-@`(! ?U]-DLu˦u*.*O6 ˪-TK%X;2J` o]O )4vZ=,p׀5uuڶi秖bջc\횅ڗ7+5˾azWj{zfhBY$z𓗶k? qVR8NNOPZg?%&0[Cz$h`T=ZX6j-ސ qĐ+u) X]pR U5uznAvdn6 Pva2Xijm`8TjѺ-\sH[בC$]Zs X]| uuum֥5XG=[ۅhXp5lRZmX-TsзksTQUhj7V}bA  :ƙV@LƎHWhu`skɊL}J*L> ?#s|4.bq! X]oN \v,2GgԐaiu AZpe"S}.WwD]4*A@F-@`m@22m䮟 mߠw[֎I!zobWhֲziL!]?m #twŠ  Xp2 hZ=I癞!:gvߨ6>rsk1=e}{q鶛33V\ҦS . @`uI  L6g="ؠj'CcLr}CN퇵O-N9@' XO |:_.=p_]?>d5kg>[3ѧǚ 'wPT- @V;R% e52;]eUfTn-^#[C`m,i ȫhXA\=KZ @K(q  s~բ .7f~|n}gVk×Q2]>}J*\uov! %@l.@`9)"/WR;?LsF12ӝ>UUjvyߪqcY~^T5~bxmGB1:cFF/Zإ|;G%(IK˒Τ?#R]ժE3oZW_vC'~k^p@$]T{>,ofܠ fyrպڣמG#G tjm7jܫu^!Q@FVAR  .hfڡu@P]9$][NbS?x #N탵+#׵6azb7uH vXCTiIUWą1;閝>]ʪ*~3Eui~XӁm%ō2*Sqm];hF9 Wk 4oe K(SC:R[[1ܭ_WojH1]4N?PvL=^4bөJ'TH]uC X]uf `;OSA#2vPVKKuSϾLY_eϮԻo}%N,i5ش{|N-#[Jw n04V]fs\?vF[i3>Tn?88P'^K?CuDPf~ΟVծjppKAs.k@w ,G@O|v@\cSq_L~6UlٹW_/ZMv+H~~j;]iڃձMK^y~fq"÷jB[m6h%M;Ap洈8\9Z"GD艋c|Wle7?˂͈t߭Wu$?Ҍ?i%wxke*߲'[wwKh6f5D{"]=562 ۺMm [E V յ4Uq!VMְnTaqIyg 7Ur,ui_zfwMcz|bcvu4M9G.Xv(ӗo\ڦe[\cW'kydP' X]h2  `띥R(?=xA3 ǟX]i3jyCyڱ7M?PVwʁ[6OШNo ԢjzrrG a*7L[~ld O@, Z*u <࠶DT eOkM '4ކxoYEOkSآ*@Pj!!(PRQ[KS 9)H0cMMN>:M;`.* .ӓl#Jz|Ks3[P@q9 NL. o+oL}p=T`G^W^Ct)q_Xg]buQL紮X"ÍmUR^^*8懍v򡉺d Af1"@~\OtOEꇻcch 3C~[vէ_.ч,t lq̍/b|trjimm,@ X QpUO~uur%I5.4K׍WE+(0И--\VV9i[UF!K9:[sw6?^ ;O@7 dU@RehJK/uuM .\qYr Gһ]`ޅmqJ|tjG.nO5{  4 rUuT:竺bpNjoMW?ToӀ>] ZUhզ=ڼ}2su(P{2_X?_EY|:4U)ܻBbM2M ^☛kflҺEE߿>Er V(rMҹ_񒞿zu=lҫCEzm7Rp$[TtDb/ku-&e%>{M)-6jCjmQpuԷ-’:@c XY Lx'U z^\a>V˚^g? ۣ>wujcwf?hź3ƞ_ ^r~Y[Y=;qΚ tUwʹG9iLţOzo.J׫ߤY]?-I >tۢԁxg!@)ݳ{G˸;:~G{P.mRmzV{}YLY-c̺MOMә_-[?oלq`ӫզW]3喫t[ݥ-i% VEa]c4:@!@`ei $vof|+RzE+|Gw:Λ.54? B囟.+3wGvWPj2~2s 4&\ё!SJ5^ߣ5#oo/z{B>_qQayK酙sl2[Tr-W+jă+PF 'ꓻlz~Pd'.cCF'|}{S}稦jV%?[ KxH^]vlyN^ ՖfkUzq K&jOjS]MW[BC ezۼ=$[! #@&!"@2'] NM>W-W8fWզUs-vgƫcJr JԻꟶW/V++ZUWaaU[SUX}|АPEEG+ @UU(/Qlt$lؠIc:hh~gqnvɚ{t5EQfb]F`):;;i @c 6Yf (Ls~fS:k.o L?Yy|*,vKǜ'l@$=VǯVZf2 ԯ[6k4ky~^:úh,E z3Bh$܂N4SB^ih7mߣ)OlnhQqY>'D~~>VYi^vIUAQdfop*__ulhxOWݮͻնyEk/tS~]MْOzwm1[*."D 1OYJj4gERs*kj毗TZVCy*͐CBXZݮ)3|g_eQC ԧ^ynD;kvd⼝;&轉]  X-2@~R9oTf?/]\/]zMW >8FK׮s }|\Uh~:k EGEhJMu!(82QUqS5^jfE*ڡ|G6UX\#&!XD}B‚||LJiJq2P~VJTժLR+6P͛7WQa:.ϧpUZZnON%ۯ9lv>t]궤҈`_-z%r  V+(NZJ97Ѯ헕U7w?Ue}62 j:#ȏw% W =kڶcO7^9{߯f)u}hvާʹP~۴O^ڷ6dx)6J~!*.VXl"돦jxF-$[ 1%L>-%ˮ뢍E:TX@rOKo3$/o観;h[әiHAAh u7^ZH |@l+@`'!Nx}! L>mOE?fV|9S-qUU6oߥUk=ջ{'|={1#մ}grx蛬WV`bUTT(?[!UtfrA; sqS_OMgfUֿ2WWoVlW/:Q_uݗF߭ȊG GD_RnuА g]q$@ XmIm YpP[˜ٽ"5WC_: ڗivtH7_nyg^~t&fB VeQjߺԘ浰DLw> N ow¶LNԓެAۢ:xϯvN\Q @ z3<h<J !ػګcWg~yuVJ|*UU۫TFJONԴz)g>/U3?TmRJʋ"MjT; Rnث}UXTi*ISp ՄtcFqƽy߱.4lz5ۮD׎;W5iqmuJ?7JY@*@>3R?rZ6OPCz㽏Wի{gM IIۊ5;ĬUCUR[omV=k`V Copce MO++4[歄m##XMlޱW#.ɒ*y͜}V5<&Eg#}, Vw9n%Pvf@n2r˕[*רFy%@ȭ v&oZLgnY>p UU*Kz`ڛ:G|fe^}ueWjۺM։ewji*PmY6k6mڪؘH yz M:cc*vKs PPzL} IDAT[N.?Od@T_!> ?ҨYt11|@&@`ml3x@!eqs~ّw*3ث鴛7RGZj(FמprȯoJdJ]|쬋C%:mI6qa}^>Wi{[NqɊ #/ޮO.Nm[U`b]mSgkoF|=OmZ6ӇSNo!}1}xv+<>X),,&PSկ}uR?̐@^ f ؙY9hlWڲj2#a27Ztm%˛PߨM ԭezM]o4g4[ך>?xjυg/貋F(8,RUYw+)Uc:Nӓ][R5]MlWn7>S]u)p1:#O* ;7\ .JAu[^U9KSAɢU3bBz_D?\Y=͐opN$ rYYUNwf.Ӭ9?+<&=Aw~}D7Of_DZ+`z Ԟl 8.F 4IpEӹ-;yd)ߠ:{VlլսSUP *=Y"|߫.Yunibitń(:)׼(h]tz/UڢGAc2mzo)62TKVnӓo-RxRWtv{]8q*_i{Kžq?@Dh*X> 'X=a8TNkf|OemƎ-pUSQd5/_{U9zC -٪ 賯kW?4PvZ4O<|/Җ6Iu^-(QyEƄI_Vkoiem6E}5e Ӗ]zpxd?ծ[=)(93vL7=D=\JiGݓQuεh GG'[_v0}g&!vm@{XJ 15mZc\j˭ޑ]~>5w~N+(5ԩ}k%%X~U۴ڑ' ZmLUxxiys?Ԛ%G%Ro~\~RԸQzx9wqI}smVLDD%ƅ+$3<!wXmOAv~n嘖i^j%@ +u[`3wptՔ[ tie_Q̼Jοl"4 5c3Ov)#U7 *ȻZΘw̗_|$0SVjm+48Pi9*)TdD5}7#_(>ޚ:_uiXNmnMPq\Qv5RP `:OgJBEy@ k)Nxc *ː~>f]wdVI{Zzuuh۪kނ簎:bZ-\^붦?_5%$oEﺪ2\G+>.^;SԿ{[NnzQRVv[d饏~л*I IZ56ݸ]g1y!XM甂;ɴ0@>C.[+^بq8 []KO3.]PͥkTSelX^){ϼBM ͜a:Q^^)OKW)?7[U j(/o?U:˫N7p;F }1WhHB`.o"R$h!B{O,;j;$t@rl޼"CקEh!Z\/p0BW'n8ӹ>Sy{~u._Z^Źjۇy{R}2u.ц;tϭZ[Eߠ?:pj:ô,O ɭT^Y+@PuejUW[-/ƨY4]p|׿8TA5 ɝ"tŽS6Myԗ 3g[mUQ] ldu4"6!Xoؙ׃ R.@`;1 6X7}Ҳ߸],w-zhg ?IONӋuPQ(V>[8u~᧪w>:KF!P547h4_}dF ujMPJUWSښ*z_QMtKunj(UJWv [^YY ~ӳlRbr:rPg _oOg`VۅV.OA lo2 `FA'p{۵dC.n*Pz`7γj/ezL}{3 ZI)/@<2IQppe饙29Q.8[~~nkpmej{ڟq@qMui)V~XQahNyWVq Be)·X[~Hh>NNA>A>j<k:w9(4>EAA! ԅC*!_C;ȇ^"঄\Stu.< pXb@$}:[b99D[cR8'3ZOꑢduye.j} ao7RNiސZiZZ u fu'tUC @C z8EϮSYEvv8]6$Q-Ԟv\mh}]f_YU7>LϾLwUbOzaaNj6>iMW_iUhWzIUUUziW{Â5'،ڗUȘmTPd3EN@?oUTV飹cT\V;~~ڪ2E5Sd3啫 9E'uT0o(J۵Uv2X]kl}-#lOo];\u\JPxjg['jdϮezt-\mLۻ+y#  6K@3eVch̉M4nHCiN$+6ȡ/u|KϴI:׳:M_?(=uaO_uZ~:oW^(#fM/TXRlmشEU6:<2Z5O`CvZu̓&nDa!j%酏i_0GA!i3PM:{0ui. ҇ 7jkVCcL Ud*XuB; ڸuMLD?yԯM곴)7-mz67J,Igf6vPnas Ci\Uu9vT/Tc'*,qO^lk Ԭ)mjyOVڼ_Tb=3?Si:GzOj+7_>wA'&qWAa>|jWzo@ N]1$N*旨IL󀎪f2{IwAE:QA "1TGU|m+Vǯ̻&5D'W⅌|"@,!@ZԖ"r wZ\ݘ擭_=|&3O#d,yynF,Wtz!]zs@L䝢E:#80"\з ,YބVE`?ݠtrR[11]crOp6qRք{kWMNB-@ J)yfFd䀹5rTQW.>hX2Ӝ>M|$.J9͓ l q֨M۫"\{0h8ri5VτbLV9Wq/U8^;VOh`PD` Da o=,`sZh'ncޚÂ<Q>\Ll>I",żyjO,@MӰD F]t@>N,@bmoB +t/F šʯ: z=4j'6Ue~aN_C|OJ7/_h'Wx>-p6Nx7B50Pq_+{#OXpf*.Ζٿ$`҂=bœ{zYM.LnW_ljm7&43;nj@֠L}" 9jOO#HFvø6gN#i ;Ю7 Fpkw;c_.˙Xq0IqwBpWk &颀I[W S(tjHJt~>h4 \2 bå>n: upRY(a]#f`V pQIU⛥Y3۰MdW _W<69'OKj`;O sWjmmqvK#"xH:^iD)d=|gq!-R$OK5pl6Ĉ+[<U5 Ǯ` K+21B˃R󛑗]a.ܔXPji۱S+sZIgdp7)[7ok6nyZ"P*pu2bH>Ĵݹþ&VӘn[@_A˦Jm4%cmwpq[zEͪybzJ"@ `b D> \?ެ[K[]7'smѵOg%!_,Ŋl,L]؏NJnjr 0_؍ gNĩ34h N" w d|`14 <󠉸ekE7CȲWKBr3U,ņޯg0w n触77kg@ |8ߜ|^3ps("@ V;84!V ]FPK2uϖًDžygQס((S.U-;} Wg.{!FaH{f 3Oƹk Hs_Z5+^_X:dddbKPN\ƞ(,JG9"*xzۈiSW ቾo$ax4s޲A=O! K$vR)B\JҥžFu Dۚە4cl^>2ѩ5V|3t`Oƒ$tvm8?pu_!rr3ТYkٴxU2sMQQ܃7o#=#?O56dBχƈ1`P`h>`ǼS;d s=io%D%@-)jG]X(_o[; k&6$=,aR\خFv jn[j,!'&oO31R9a[A”fC71CQ ^dZu}XV\z6 3WJjaްpy߯w7rFMm3a5oC[ES1{ޝppPPds #߻+G([9H&DVHDx\N5Ckk#^>4S mR ggY,_ 'ĸ9%1tJлf:6@\\<@Bb*p}gd"<,ݻtF՚uxV7]}!Ei j}wu߇{s,;}x>|v k{:L? =V[=~a[uoߥ{a_׫2Fv 75 DEXd/ $a sa~. *} `w??nض\ Ҩغ 4_$&C!$(jEZｎ a@`DBT EtQWwRkY~t00^0Lx:T0sn(j-[L_OG.m8w LZqp%\-yV:|1 D|- "p=>C+}"0S/b3.1/4~{hB}bW9 IDATewt:!.>ծ":_]E0hsAtR!BhsS oBy+m<<ѵi8wGP sFMWRR޵y[bh"g{! '>!Cp%?9++gdH_$X${"@dC`$|6x~^eߛ˱ݶ=x)"@C}O HFW̶ޯ>u!sQbr:'HtyЩ7 PA A^7<Ф7^j_ ]޵ܳg`0n{xy^kðvx[0Rz.~v6^_$M7BTEN B *IC =5a'V'qq6s˕]߈CA$){w¼ioYue\g\#* Iy^ANZj 8yhU #еa]I3Ɵ ˪hYU.ݙJ ;Tm #:L;Bw}珨+/ؚcp,$X+4Z"YuptX0݇aBJH̴SݘOմ9?_vZ EfY!15ޞtsAvW2p~J%*NJT u<\cwMSև_A2-±bd~۽n6\e\i#Uc#;"@OsD" 8޾Y rSpz5|p_5fwhFVZ|\^|&|W9 Vaʩ {k3O\>9 oX77r?e ٞ  |`Cl.3N";_9͓#2Ѕ5 ̾>|.U/|,`V[5/f5᚟_E+7Y藞5׬:ko!1ѺńSɆ[l?ю'3^z  @ԩO"@lB੩'P~/[$n.0Aﱶ偑 F7s!n/?2fV zwBQt{V,666R=md8, Q,aDm. EFu¶P*\$7W*`bn%r ډap{R_K%q*cd~5  [?ǖ#D@HJ;? p ۵jc8ojH.Tv#56 '٦hI21*ckQɘ"D@<$XcKGFL\}̡+~"4> wre@klt 2ru6'Q3&5yrDH Vi慢"D@`+}~\Αl:&D@0$XCI2GMxRȐѩ'r{?O0Y9bЧ3&yբ*kѳv'\"̉hմ^ca-b4pǾ-? 4(b`iݲ7Vlѿl$D@8$XcI0G$!7g%xJs{lZcQ Ւ~ 0ZoV `-ڨTJ1yhjV!\u#ni 0+G``˶+VYZ#GZ>("@,#@2^Ԛp [N~Lz7FijkQ7;gfuhP*>/^ǹK78ڨy:;-ԩ)WnbKqrjsCHa|_vndrWh#?5vLhVVM" `%DHM؀{q2ڲbQf<p? ]0ۂ}/v=n 8S1lPoH~{}wI`sU &Dm5egQCTC.mQz$+l}>ɦUڌq#җT' "@Z"@lJ&l_b!*Pi_scXN|O+vczo  V`9=9zU#O %@c < F.smf >˹x6z4HɿtiyJ6Fzb[_#'LQDE+ A&lyLz<]RyoS;J*&Ky8t%&}UyLȗT_9ږ?[ҧK+_dO,Є4ڻ$r6?:E==6fcۦ6kR{oGlҘ$eGJCHZ" O4a{圾E!D@ $XŠJ>="#&|td"rUa0x$WCTXEՖ4ؓۡV;4K;W]LC\]a=X HԄ *P`DI&lOҔ⻬LB,1FnMČB "2tС]}D/ `.&D@:hd.wX?XYz$#iV cI."jY"b ,3B:ܱzB+d.z'"@'@Ux  [I9x5kJ0c@>x$c+ V4~UiZ/{W_|_eODHr%GvDȊ ֲe01s}$dh%aѡ Vv۴oK^`dԊd, '` D!Є4__;HFw @ 0>?Ϥol*>h_Rm}#D" e$XЄbI}GQ5- Vb8f pm֧d-N$2 ) ol||?>Ȗ[ j PDXM*Ɯ_pPJk]i6pފ 5צE6\̍4WV}ܝ&puJ?ؒvDH V)fb"D@p4a3t4쾐eZ0܌,]:뛕Xӯ6ȁ6qMS9U&OWG'T@'IC-`u yZ36#%Kzb~h{tAL1wMZQ(8JJikobDXz|`Lmk}ՑSDH0 %@6vP/LFtC/ lfUJ|jHC3[Osek|7\S~Qb4;? "@$ Yj2̙ $$9~>ƨW^uX4p"@6^}0K[h0iV ;B$w;r:2X-5j e\J&,{=2-tOhOnHW1u$`@h7ĥ޽qAS; tֈ!#OF-C|x{|#rskQQ f wwWQ9w/((2Xbfxbٛlҷ;?kDtu!`ezC{ΗSDM,)YKFvh[KZ''$=?'pmdujD[xGZT[j rk,L\;;WˢDy'ɛXB51+5i+@N ޡ5E Ĝ.Cup @6ˡm8{jp5VZ>X-bq7E[yKѧ \D%&M-s8fUQtv| `%]!\Y[KWB7eaĬ{jZ4MWEex{[JUT\hfyV:#>>rַpk]Q5XZ+gZ%`q`jE.O:>z} LU.(8WEJ۹]+Z%K V՝t Vrf'##" @Xƥj1xӬo3uIE~}Ѭߛ/5G5cDYo-#kc=_Q)7R?tx ;[VTt?V^i&jD!@6A0;1XW2HС':wNғb# 8p):E;z~-hD"7"1D+ Vq*+RY*,Q'DWp=P60-y 3K!Ivd0!lTc>KB`^YZKW 8cVXYaFD@4aNvq)N':a2w6슆niՖw1.'of)`"Q G x;b#71E+ Vqʗ+RY*,Q'Dg4Ѐ\{Ou+j "4U/@rq=>ogl8@,`]al:\k՟Á-X)ZIS*NXyVVMX\=>ߞI;[_HgT Q"2p#!7sqn'!!>gK{Xjss1aa:!X%ZIS$X%ZCȽs drS`>^P#5HIcVoL|D-+ jk .D E3p%@!؄ V` _wxJ/0""*Trɚ V֨ p++&%Xٷ?='.ix"*DPV'@0O IDATYu0[!jٕHJ?G!{j-+ 1גk Bw~} LP):]e>'*Q *H(@h;}<-v`˴fP$Xe* %УCl!XIWL&f$XK@ۻȍ{wXmtBy5!*|Q *KnvJUgQ`:@澬 B`VHzg$^T/\ F@mTPT(Uj (n8#ʜ Vy%E`o8ɻ$XU- V{(!{τa JUjX5"ZSaZ b~Z/Uۼ&MeFzmbNnŽzҏB6~!*&]-e$XcS*sG/1 V٧P *QP;)0JB`VHzYMʬ|m7(?gMH>GDfi@=3sp /xjd;M]N.H(E@gL+)[8f\ +j-tR[Dh0̯ 6v-^&}XҐ+jdcH?>wZ )x`u;ˆ% a*k)F׾T|RZ *'vk sq|{Hq1JgOxV ȶp1!*LQ"PQ6 fJlEU6@IeZ~POD>8bK0 V1ۈk Ζ7`ڤt߻ӛ?Af<+h ڵ f$X͖)5  `PJTJ%%h$Xm5 J`}&vJ2IW>0̉=?h>"F`:=?toNJRb}H=X{ a=?Gd'z"ʿ`K+[RjD;\#ՇT3q`u<;(GvlKIulH~IpoR8QV ⹅pZ= VNXɈp"@6T[ऒp%*R@IeZvP!N+j m-Xd^$XͰ#"d]laM=-O;\qRC" VeyAޮ:,n$ju1bupXv+,J+KnW~~rbP[:· ӡJD@8$Xc)O>.WO7v9.b%`5G>bT#Ύ+,73up $rSNP{%. I4ҲBtԜؔ Vi ^ru V[P> J w|Īkߦ Kl/':q5!.-޼<\㮁++r`i,$X.LX`2/rl/:K8zrEKuyK7B/7 |<]sM V1osH#DKbxٽ{[ZAv^HS9 VfDl̎" *[{fī$`=ݝaw%&j -j+4B% X%*^HlxmYnȀ_{e:e#-`E++LΫ3<\psј7߇+_dχ V>$X VTbD-VZE9 VڻgF2•j-2 VH \N@hJUl#-lINn+%=q8q3K2OL##\NpuQU*8W#WN9C`eǞK+ʥnڈQXbq).dnJ>ՙk jMڎ줂Z*mghw291hUʮOgdhHw~etbUUhiU,VD@b [xEuּq P9n0r?)dA~10?MYw*)VIB*JuYD h&@!9A<6`[`+hUL+fQ"  q @FO0bxeKVXE.k(S"Mx#Sx#$<Pb VkUtCi,"j@#@6P#8@#P ҡ)X)VIW$XiUVa<9%<Є<2M7Brxl*`X%*^[KWbիVO}FjJP{۠/BAUhmv"UvWTCSHcOnEܙ}f9$R$@6)fqbs\KqTR̊cCB+=k YVᰖID`l n8 ߝ'j8'*Dr! 4aE6H?M,F'4I.Hji**h% ٿ ^3|QK) VdM&L+"@GaKT/? tRZUW(X`D!??(H9LRqJU*8&@6 TR%@R͌~w"RxjkjmJWi, 󮩐OaMM.V7I#Xyiqtޟ2t?G;td e;jFI&l̋DE(89Dl^ji(bT( ;6ǟ& lnw4S{א [x#p a݇YcvfVK3ω@&l`CI8LL2|}p,ZZ:XҺ)^,j%v*r+C@ʎأZGT5牄fG@ӊۄBē` %9"f Є,"j "?k"t, 's-b$%j *E]V^LDV[f~j4.7$XK*`"7P1|ff(Lu/{Ѱ$`+jLU0%@6DK3T@@oMDLwYC}z`i逺`}[a^RZ5- V 0 Sone'"f'ںWƳR  `E&l0Q#Pܲ"@ 5sRS8u]b[huU`ݰUݧԏkY*,Af/ :SJj D$_ԓ?乩e kD!G&l±$OYGO8)6d| F'{k( Ղ%u:5̻tœM_ ԯMZh4"? t]y͆(}a6uҠ{Vv,+%j -jK ?~d͏?~d͏?~d-bV 6ofiK[Cp{/0ZW SJ9)'VqAɿ3WIGD"4a5՟@ɝE,E퐀U꺂kB?S jq /,5 z \.n&e9[:@ %jC!@6a8nq#+aP Ñȗ#ꊒ5H1qe^4 ª/Fn-RgV./G=awP[}nH3:2$ @@T$W!\tEIz4d&@578z~M )D/clRzqc@62"Є62՟@ 'TREW%W%KSNU @^ܱb (Z^ROE7= {4$X9a##"M8a##P p"@ t ,wXUѢ+-9 :DyDК.NHrFFDqFF$D62#B V9 2wA_a=G Ѥ#vfmq3# ?k##"M8#CP \p&@ t V ֬{w6^Ӹb?ƮDXN%j122  Є3:2՟gTёJIW``5 Ⱦ8ڀ hzEb?E6o`eK92"-?HFfv  ?oZvMl?v?#sBV +s%NVw']%^[{}M֪~~=1jua_##!`0L#ݾnގï;Ժ 7;AVCR%C6DK39At3mSu<OF]\-$X ͬ뻋_m8&O;yjhb$X-FF@HCbr*V[<,TR `5{ IP>^URUH&lP<"՟Q9@iBMW?a&FZ5U̟s1=vx*C$X¨7u mvH<0ؼۄbw$X-FFvNh4AR\[w^ǔFfʨW*T*^qXWj|x}T R(Mx$>$X-%F#Xg/Xek!*"S'B6Mylz+7B0<ޮMz=>?iޣ JIW)kI -X9Iȏ?S ֿ~Ҝxҋی#>v#pG62cŧ_-0w zum[hw;g-^ｆu+=Mpd04?$ɎCXJIW Xf+1kV!krb}-XvCB̪K6bVwNAN>Vmn/ƀ+'ldd ~z9ƍׇ?/'O+9|p??1S&!idXT2IIga&Bj0$СK hm?W\@m.}xhRo>cXdcё`?+cѧHT4OÇ- 3aeE6;, OFɲP04$%X+H(s;-*,,ܻ'K-^] Bd6$A0"N5e<"ڗ׀+gtdhg,0EX T BQ!J04=?}1C<|&lvV42՟fgRYBi8pD]AUը/BNu+5m0BDsנ(- t u:XSҀ+/|dlg.\7EfV.}>: oO1wмQ2ӄ FfáY,\?;K( bB V9 V*W_8[\ E9e?(ӏ7ա EqOtO Ȧ}xS.lj4xoȑsG_,šg匷ѿw'VøpFMAI]=++rȚH0X6UՄ()XEW A]o/QS8)RҊ׋_xu«VOcE=[cK(#SL d5̶scѴAm̟6"C*?=3[8+6c&wFL6:*- Pْ>-%Nz#''^YH:Ti0w޸}?]̬ {uB٧ju:}tL2zui WD - Pْ>MG5QWX;HH[ɮZ sf \NIJ1+5 $c鷿偁}k R,%5-8&Z7iFr9'34af&&GAj`?kP>Lu5>ƨW^[ VQFKN]0l`/TJ0f9IXPRh0BMX|C;͒ޡCX(7 X" A$X% 8"Fv8"|>Mo.ApЄM6wIT 7]y!O.8N9UQ{4 "H:riD@"JB|HkEHA06s4{*qfX1՟ĤޜXePH?ED{$XٳD$''VMmKVo{om[4DXH7 8X`N^2o yZ Dg/Xo7,ܼ|܊}ONHV:K%O} P!)5 CzftE^P*ti|l1\2i&b3%Q!KeȜZ鈻Z6Ɔ}XCF^Wl…k0><=$3h?ɤ!D  OXv<^zw{ =:,&Ju=TW\sS?b:WWVթFQ=*z%"`oH[Fi銚ϵ[G\rX6W>8{"GlG #E+Kl'_-3鋏c=K٣m!R9Uܪh5hhѨ.^Yc-G?vT?$X/4""`S[~EBvz"DkʘXԨz&uiúX4=nc:u˟ᎏ}ԁawCp>~w B,J,QWZ{uml IDAT_M ?Q:RYN, `iD@rقY_0ՠN5|ۦ.k&#Z.\" ~i:}ymӓ{q9Y'@sL#$6!PR5Uer/! 9CSiR?CO%zv>zEh}eH_`/T`fV.%$ ֱ%TeC몼n:U"WZR#ns D,$X.E9DY9΅^íSR?n^y<ʛҝ] It=fܨ~-l^6$m?HFZZ&rr/wh()Z| WZ fdڭ|h- 1WM[٬R] WR+#:~f~ .>7:n %Zf|;՟Q "@HR "~b wg/^G^^=5(SN0t升;7D:Ω*ac滣w {7jd^G>&Z2sPZ>4Cy߯E^~>;#UQ]Ll]W;u8|*c }8V^X@r?փD `uЉ̵"oǡQаNMS]9߮`4]y3zp_h,ޒI]jXlxբ%85-8>\zlT)vDpٶB7ݏuh #1% ԭY1)o { b^пWGV1Q]Ϫ_ө̻ oı-9y WƝxuH_thӌTeg~ԂGHR-"`1f 8y2Z6^]ۚDsCYϣ+o ggZcXr, V?ZBԃ٦Cv%YxjR.xK7V]5DkɃJiUK*Օ婔z] Nr McFO8`+#Vي[a ѬAm,_ݴѿW'}ޣ4@;2x~#tw଱l՛+buLT*L q~"&yhݬ1 \dV6`K*=b]ѣc޽߲ lߏl޹8mtQ&k3G\FND1 `u̼Ө/%|#|25/_zf6|Kl͍o%g*ؒIε M"܀+WtOtȦ6mVPXTF tL'^;/)nSRzh *UYR]=MKʪ?6Xݺ\I%ZRJ1wq7>qpwVӣjTbɱ<9"F%K p~"1 \;zT%d#nQXcwpVlCƶ`#'coPTs:㞈)/.]%?%_|=hpB-TWUT؈G*eUL˩롖܀{4iX&}k446ɭx&@ՁOC'\ Y qF fO~ef9T= 4Suw@`5m6lѤ>g$Љs.fKfm·fM~Z6z[1wσv- ~R釐.2WՊDkp8|%WVيU9}}3.%;0w;x?0 R|HD$X k7ۥLvhҠVN }#뷟Zͪ:9 <{ VnJ8rķ)8tlwqV ^4>~oL15BwKwHu%*/JsbUכ;}%\i 3,P&6t[`r6# NCǧZrPJkMm VxQk"WFM_>z?/bг]ѱm3ԭQZi{ c%Ql_PV"HX_)od d.K2q]ȈX=S'BG!bR2<|Xe3fc2G=URfdfzTeUks^!Lr}sXHɵNgldKHR5"P&fBRrST`W*y-+ ֪4hW6-1/ <$,e;Xf"ڨsFnU.)Z:=4mFxs]Օ)b]=7pe | &6U"Š0bʍ|b_W# #ZXٹyhٴ()kw:1`@'"@H:PiD-"9yŖMn.prrB t``C'pE>p 9w CLGVT2!D ֊+Չ]Iњ`|&ڣFMu/{;3\,XsFNLX=s֨&F:ʅq/! fuϪo+z똕}VyUG'7p4$X-4^"`zZ_',ddǡRa=Mp37:ibU9 \jRGUh5յڱXo]13?,\{=U,Z۵jdzǞYY}$VNFj<6<ӏpRPF\]M?ҕ2\!~y{:No׳?@mU%D@2HJ&fٷ+tU_RH$. H"#JQQAQDD" M"J!Fzl̚ݙwϏ߽澙}'Jf}릦Wۆ6=lI:$Sڝ: cd+[oPԴW;qUttfՒYMLJًWhzq{]L~QThzadXHQx=3Jte#OU܄ $Q?<Iѩ9ޑ9{GXiɚo4G{sқ:VcV)Mk{:amue.bV!KlV̙>ęBϑ (0@aHbtut$&(1ma찁8w9V|Ŧ>eHQٖHHlsե}ge`*z?M^^elćFzF&|z㣅3,g :V֛MkVM#а-B?ԕ&Edz?F=ү؃n6zuMiEqCRаA=j<ʔAǁq-<ʜb[-KqRԭ[~YG:+m(?{v$@4 #'Na‹o^{ؠ%`gXqzws^rC6o1*0}·hP6}*(1R"5M7vFS6vRƜNFӕDʒi.qM@ez8ZXUgaȸbgS _lf٤1c=t@os"^RB_}o@?`cpa4.\\N,2]|nxzxX4ɩojhYӞB~>izbfvN.ƽեBPyK64U7vԕQuUԴfgg89BOfOM?g.t56.Y;n"1ҕ6aHIM+!O6-&RO5 \ "Klq?ѱVMߎaY[V]HӃF?f"4?g0\qc l@]9@{Zbq[ں3ߤ_PBm\q]S ;&a5p: Cܥ4tƴIؾP3&`?1 C Ah۲1&zujȦ,S썝uj;J3$Ӻt7fw܆u3 w^>lSb~~h٬߄d9<"zw(okg|OJ]+y-㯰qzm/>y~Hm7Fe:sSGZz9\icG]9-t%ݗ[W߼+aJ,noP֩_AㇸdIH-;9 Rw=y6$7"@FTI0iøya53+LzMzxj`w~>װw>\u1>xFXDN}*cяa{WY$&hXݤМ& ~GY>Z8s 6ogմJOM ֟D0>Xm4 a_Eyxx 9Q%½{t¢U;O5 @Eb$ J@: r6IK7.}sDtluZӪզյ +u% 87] oђfծ* ??v7RMy{ywѯۿ:{mrEap%4TMŭ |Oiԯ[ 4EUqKjKM*zHF=t?&}̦Uz2ԉ\Ѱa7eb: *wA^^>Nka3E[۳{MwП*)  tI!/{>>ަw vE;[[jBp z{}梩M@}q<ԫe6[v_.`cкy#޳ZEy/;S VucY\!"fѓhؠqZELwiSGSۦﳲѰpCn>jר-_.W?"Eb̍1$@aHE>_x 1]X5WOYo] wk__C}n/z۷0lT+zS'%XZMf#JҕP ,01o{]ljYSƠW~_~`7xES&E/@p4nPdN}>w7ֲe1/:w)iiEn^.zun:`Cֱ OUڴ|)%zIyk ksb8Sm+ Qt%GFOAhD іO[u2~ ]:4G"LNMC.Ñn1f7ѶUYW՟R| VW$A(jZ[5ky/GHX$E?}Zz:*W FrKwlMC 6q|p6Q+b icG]GnFҕ(UwӟTñ_3] ,Gc8c,]Űʕ?[Xp4Riӭ5wmy/O0] lqE ZիW6WC/g ]5tK<yJQ6vԕg]RuGI^gSx,E<>(bq h}a~YշF?#p14.VPN X25VoY%;8EFcq -<w ly`?US,ԕ\; >n:rs ^[r+,=,94FƮ?ŀ#pA4.XTNLd^|o9zz\0W^,W5x2H#+Qf̬, 6K)[Ceo _O`ȘX,_N }{uqh<ϡɳ1 V7*6̦52{?fM{R^7u͛4߀%“v@=n+L>k!>`FUB.ZozG|R vz9V ,V:tigAB]*y`ߣgֱmZM.W~(kfJ;/!1=UO<7'7b|lپG߇S g)Ȩ{lHnJM i/)iɗ// A"Y*>^<ujא icG]*+QuWqIgU\[TE(緓0P7@mD c @14 Ez=ѲYc|+U[ueK]Ǟu6Gߞa٫mkmJm#*ja43G!hX x􀥱f ueGtDEDQpwnܰZ6hSܔ9+elrRK6#ɱ +@$P6uύUЪ;ʁ鸩ֺECӯ/ڶl=b9n۾xtۑĴIOܿQg؀HV HL@Mwώ}k)Tˍuh^K]R HIήEFѭZ4s2!!9*[jU+Mkdn0l @JQ -75CPPy3-7vԕADbGZJ4]ꯀߏb9fl8|}ʊ+#1l]עj劲qE?&` 2.V%pr 4MUc[ˍueL͈dDbR&'Ϙl],V}ĕk?Yڴl"Gj"K[iX]̜ [hV81JKcA]Q䤥Dg@s#O/lH^Xо󊲗: ~(dɂڱl ML.A@nau2s$ F@nAؿu_'#RQ-:,5/t)ŒJWVêu!H|Ӣk{8\|MEйCٸ?'$@%ȭ4 A.CMU3aԕbSZJ4QxuزmO1dhwmGl\lWM 0lI,[iX)p#r  Šՙغ^+]U=,Z~%B_Q>C A6w!7" аW Zn+F.s-u%֫±m8|$BE ;3F䛰mCwf={3}W.HHLڧd yTZIx|#Ox2 $aH X32j;ʨ[K]gW;*n>Zmނ;nbB#ً%0+OFQ⮄ƠUQʔ)3jvTX{1}~B4m|FПdH$@J p<׌rcG]Yi+Q%>ڄ$|$fʈ6棬locy\Q_G4֧{} "b̟yyy]m|gS# IhX yF )σ<ʔJy)TR 녦(;JZ՟tYexd4"(DxŇRWqIfU2!?o!<陹wO6-A& )tB0Qޝk ::<=\S7v=l٧lY̟=%4'4 J@n= A㳯6T J>=#iYԿFyh3YJťP\| ^pj(3JJ_-u%0u I;nGxxx|#DW+} S4i 폻.YkyxOnm34lP? @ r8 +ECnD@nAPck/^~巸p2<==Ʃrrrq9$>>xxp_OW-7vFҕSae0鉪13aQ] ĥ+ iߞC_-u%t] 7!U7*e僭?4BP __gg/ŗn70׳s>H_R`yTVj{#Oh "(:NJ[ڋwч#:&暵!Ga;#)w\ ŕa3Y/)\RC_-u%'N}7!)x"p-Q<8^H?]Č>":Þc'OA:֚¹H9x$n{u2A*L$qV׬;gE -jlxm-t_蜷#]G[uft?aDuӐ'V,RQ۟x*.i<5~~ԕ(7w_0!֩v{8qq >Z6m_ _R1KgU?۴ Fw A!5&\j(BB#lrb|A:e ur8 +CnD@nAPck+-G||ʨGNn.9wEzĪi cF?Ӟyk3aZF#JluDF"2&QQE 0d@Sa:2mRW@\]W罏-<з;2Esrc3}֫˝XTTLE 4"!q ƅˡ8x+zwFnZKIK-#^3c0Jgs!؀Hu!7" ҏ!Z-Mt{rFG?57j$N-]ri2Q 鿣c gL{Vĸt0|]Yr O<).7n̰0 \b4>&<(zt ۿlr P:NêjvD' hiX1s"xzKrվdsX |||lxȉErcg]2.ƙMhQC*?253V4tOlEANp=>ԍthF HKˀG|/_Uvr4s}";Cbq3)_.ӞyeDXr]ɏ1$@[iX^H- 뒏ᚋ]ItYV-7vz)yаҰ*f]|pwV(,OƏ?T,c is3O/O Gp`yr])Q 8D@nA^6&c[4Ͽ\쪤Hޯ*+⋏"-7vzUGºSVVUvSһX79銔Ҏ a[ 5JґsX;OT8RĬ>2>#R]cjٕ0 E@nAjV6"c[2=Z+#19ծKDNdX^(>W-7vz 2RWU'=KHODn^.._ ?g/ѓP^n6jPU+WDhx.]ˡEkԪYujUwJ&W|^j{%$ =o~p8۷D*pc˖w={Z77  ȭ4 A+:O[5ƣBUmv+CzĩW,WZn+V%lnD׫DW*N:zq|e'zvTVᇏ{'ONz7%oBp}sxH ^7v/|bP^^x~hӼoڇ"#3h x5rcW]Ѱ:.3-u%^'q;sg/\.f^[5o^׵k褤xt)^{YoVE0ugX WR&L[::u\xzcq7nsZU; H)|]ԩYeGϥ7XUW4LK]fIh6FJl{pQvv6_<ԫSMIMg_}?mBP z>=:S'A6 HJ[iX)p#r Vu+d_ǠFzvjqË>6>ϼ]O:999V wO{NaGIh+ߙoQ|qÇ>'$5_ 1)7TSk܉:NNj\ݞ܂a>Mz劍Gpx$'jhs{Ńv}f6*ҥM1Zn+V$d1XK]f{4U/wWtVS::[+As  ȭ4ZW㓀 -dX6MU-"## YYĤBξP-AZn+V[d9VK]fRӱu3qfjŦ ]r- " O/_+P$]VqӭY]gƐJ+F\Q<3 ɓNȭ4:) g[\Ű#==7RӐLdeeC<~@LyagS} kx2h$/DÅUW4D׃ODxD)mL3A_8{"\ tC:5qGѡm+$`fz7f,FПԂ$5 ȭ4jg$3r t)nT$HÍTJ zؼRtciӫhX^/ªϾՐ0i1MδFFF-k=f2tATΕ" ӰE -F4Y/vInu0q`4jp jU}{=\*c@N|gsnz;Lgc]3CI:]a$$ۻIquhӫhX^O!,$uUpLЈ܂`$*CddʗǜicpϻÑqR(4-&[C0e|ͱM4dNalMObg!ܳ_?pIS,S 2mZ6E2qFПDH@Cr8 $lr FJd>%X:cS1Y5^BJ"C^L]I7{j3hX(ޘUH#k݂'q텮:ֿ;6ȍ9ȭ4F(%-z7`g ]ޫq=!N³RjprcW]Ѱ-WsC-u%iєwoOtl ;iC#O :Njr2Yp܂X tHxcSxw쎙`'$ 33^ Zn+VJjH|E/.mOD[jېqC\׌K#hXWSfLv[0R"VɺWE 7/Dw"lڶ/R4DԂ(Ұڍ46#+Au-7' ?X =ȭbmq[z1xE Ep5{Iʙ>y<4jgT̛D@naS L@nAУaꥐpg/=M9!Iҽ7Ut  W;ꊆUTԕhZOz]{K64sKCdTREL{v,wJ/~ö%츷W7I?AFgI@qV=T9-j)Y;ÚWBK}УckapͷX}Դ(=NaKi+ҟy "33D4ttQJ/ࣵ_h닙/>1jI ȭ4 A.C@nAPHdXRػԨZIdb:sަ[KUW46b^+McÃLgJ%AdT*Urحvcߡ /ˎ]0\?F" Ӱ:t@@nAPHLےa'w}޲qt,"c 5EzZ32֛Yˍ^uw cѻG'۫w死Y?/Oxyxi2.{{yߑBp ϑ.hXmOqZVիUEF!4<.-"';z;D1ɑ6fmp-5cb$`lrVcחٓM5H7ք iw}*GL7C{󑗗oT9/?ٹH,^ҒW;JH@ *-.~m޻)7kֿAZ3$ qVW2@5HjE kNn\`CK~=7gf!;;JrU.o58kӫ h+ "W/EST-npG{eUH?pXp)r8 K! -j)5_\4o\_dboޅ/-FjprcW]yg /+n15?{2|NCmi"Ȱh=potjkݱ5#O@@nA UH@܂IаfVٲג7&wW6lY;k"SQ;ʙ]zo٧X}O@J`ʦ-ux썓$=|U-5Wey ȭ4zs"-jlxERhX#s=A9fC}165X2=zSmO Zn+V[Y2^K]fΜUYHӚ'W ӰB9$ aDR k~^>>wwZAZiaaxvGjg-7vz R5]вˠR; ?As`Jl/#"p:N8c@! aDH5)9WBoGjEr(4fӀ g-7vz Cr75RWU3:##p:N8c@! aDH5$, I"%b&(K<<~v=bWNauHnkX牿Mv[y5\8`{FK籓HHJ2}ޮUsTH4r]fܓ>=uY)A #%W៳'*\16-I@p%hajprcW]Ѱ:$S4\ \Y{c/`֫ c?""Qzݳ zhorDp_rVg5槧ą+a"VcPrKzQ.L{58kӫhXe(d7@):}hqXɴNyz ⥫cqMbE PL N@na5x> B@nAPH7j4DF_ S!voX?X8zx2}NauXnu՟kV5|zY\UW4h+ (qAΣHu ȭ4[{ΌJ[0R"eS Y:o N(V.(":}1kWjprcW]Ѱ:҂ZJ4{G*JyqFПhp$p]r8 ֞3#\l^t+hۢQ _/ܥk;nN훡wKW1䩙v֚iXI8g# zQ#O9?pGr8 ;sv[r Niyt&Gɣ|9̚?yw[w뉦bM;ahh׼b'mGdZNau\ZJ4{G*JyqFПhp$p]r8 ֞3#5HԴtPEcbe}l~eʔ_6NaUE%ԕhJ鏆U⌠?H$qV׭=gF1c&Ј(W,z"Ydez=(Z;_4Z!ERW+?VQ΋3G#[iX] ưN{u>N>]OHFvr{@@ۺN$Ԧ-7vrhhXm*jpRW  (qAΣHu ȭ4[{Ό cXWKNIEZZSm۪ .yK1QHVJh+ (qAΣHu ȭ4[{Ό cXϜ^~F| ;g1_/rc'Ur[P Z/ IDATJRa%8#y48 .uT*=$K3#7# E=:aQˍ^u qJSTa~o.: S-kܤ8󫥮D答hXE;/s DK@nausf$`(ÚQ#>1ɩC${$<<-7vFѕE8u6nىаH\ DTtY[_-u% P)Ѱw^<\:N꺵HA eWmnwt)wƊwg۝- IW0u$63+ aѦdE"$4_3XUVWK]WJ4ĝg9G"% Ӱn930a߽7X^^BK-eMNITxxzK=tjVrc'F #4* hk(DDBz=ԕ(G*JyqFПhp$p]r8 ֞3#ViYر ~;"bVռ|g --7zWG* NFʩp8XNvi£L6$,"L)̪YK]bWJ4ĝg9G"% Ӱn93p Ztg/\Ʈ}p'$μJ^}H>IBvv򑗛SujcCc=NjZn~Ѩa495XHdfd(Ra%8#y48 .uukϙV:-7vrhhX\-u%JM)Ѱw^<\:N꺵HՍ4N qD)KWzÃ]vُ]2<ߑa=u<>]jwԧm?C$qV,:D-4Վ;ʸ\K]VRy~lń̞n t["#z=bE PL N@na5x> B@nAabQW҂h+y(?J =걡hڤs=aβnC Z-?f(RADHqVV['^ˍu(Iyi;QfbհJI&$$_L'Mh.ۋU+`L J@na5ha6 C@nAa>h5RWBz1>WRg|K$`:NJ吀[hX+-7vԕqu#˭{-wBEEsw4n1Y_GS{#OO :Nj2o܂@jT4rcG]D*D""qa'\z+Wj֨Z"&"2FJO.<*K.mVA:e ur8 +CnD@nAa5QWՍ\ZJ.?w} M-_N.;CA.! ȭ4C -4ήrizRW,?VѪAb3a @iqV܈܂@j\1h̵ԕ\n<*JȸqFПq2s} ~jLH@ur  %Pm-7vԕjeռc-u%:y=gXE&g̈́Q$@!1 o-Zj݀zKH\&s؜ hH@naհ8M@nAauvEOˍu\֓e7Y;jj;V@l\DYoorĠJ={؃}gl\u%ɀ!ZJ'JXqFџ2['V}օY&vUVL+Xd >R^ӥ*TyZJ'JXqFџ2['V}օY&2в0HM+u/>z͛ȿAIpbN<_*J9|ʖUu VM;ՃDPg$*3%aom hBٙv:tIOèC<9hMXv=sJ Vr+Pt%J%8OT k IF ʲz„Z4kaz}uTީr'rH._-?g."*[E*dc m[=J 'JJq?QeF$`,4ƪ%h >^S xj̞SY8SWDI?N3>U΀#@ê{L%O_mLq-6·ބ @] @rgJ'Jqz՟2{Ж 9: @\|"<ct#-r`;%ue45JW?QRƌӻIYhX3 x9&FXDnsdbUZ>ղ-+ u%%e8XT- >,H@3'ñu#'Ъyc|kT!H ԕ P5R/E@2Fg ̒CU?`&$k WDz_#33Ky290vLQW*UWDI3'UfE#@ê0#-Xd~ع͓GtūGrEmϪZ ue<AWT?QRs%*3!aom @Zz&v;vĕkHHLFBR2Ͼj\1 [Яw'~>g&6 g 2hX^HHHE˿+, HHHH@ $ =hX6$@$@$VHHT"@êXvK$@$6hXݦԜ( а:8# p54VQ·H"x5~}ZcPJ#а '!$@'@ê1A %L>[v(}`}E4iIc (EU)H@vԴb9ǩ_:o&gl4Ʈѳg 2  +u@$-v'9ImаjÝG% VW"@$ K7YD P P٥0{¨H$c4:.S#P7nʱdOhXY1Ry\gIO9" q: +E%{Z$@JaU$!5nt]MeKkq3D$ VJH-pe$iXuWJ[%%@겥HƍzЂ 9f!{ +au*r$@qEа] '$@:&@ê05 pK$NU#'uOyHhXϜ# h@7 sH>%Д=Msp а*ݐ 7nf3ZYc̋1,IJ'@J nܢ̺$ JV qsrs$hX] @QܸQZaՂ:,$uZ p4PE΁H@7nVKa\Q1H@hXu\F$nܔcɞ аb)ϔ= 8 sD  ptɧSວ)~N$V@ }MqS09)L>_0ˎZ`|+Ns{:*S! ؐHHq3R랃`ʬňhq2ժV9ϣ]?Y@4LH46b( q pf-_~=O&%ѳs{XJ$@z$@êǪ0'  p8Rvh@BR $!>*U,˃1&\l` aia qS'{L`0/"@kl,Y$昹/ RP=őC  аjC 87ng#N>[v0O=hߴm1i"i'튥_tG\ ݓ 8 S0s  puc6}F :&{2p)oÿ\J 8sg :=3$@aU){$!ntXLiװQD. ,=- (MD hX1IN7#w-^el4]K>^4-yqວ._N$4QH4&p#cx 8|vo\* 3l!uZ%+VVy (J7EqRl}ON'hѳS;XJ$@z$@êǪ0'  p8RvX =Y=hxg!ݿʃ"uO-HhXIc hF7л)X&<}:O//4km7ؑQ>mp!u99 hXItB7i 8=@$@*aU.&nS {2IMOHӜmT"Qwv({d{ =aC qSj,kjc'Em눭'uOqH@4@$@'+1`嗛}H kޙ*8 =[1H@hXXD$8nGǼ8a1N8F`0넭%uOQH@#4$@%sy+1ZFf|%c*֡5f<ʣ{[pݳcIJUa^$@MQN,+;Lzp:7C|fs!N Ȩ9UL^I ;-Σ?/`Aêe,uO5aF$@a[ n@.,gX3f0d>o{Y!Tm;PwlLkeϴ>#h߼ g Va_IiXWfD$`;Vۙ  صms_Mo7\7e9Ll<{Y#G>-(RmPe >VfBw hآ{;lL+ Jê0#  аΌ-H H@n4_xn4Wd^rQh]2u}aM5Қu/?{wx:.7,ߞ3a@H. ^ӧa_UiXWfD$`;=\F}ʔ)?>*[ }-l쨾>eaB7eX-ԉВ`r԰CTG޶w|i ՜Y9 hXդ˾ItC &6s[C|Bl^5V+S` I<@ΰ>!ͱ:g=0cC?:H\JgL޵⃗|7g Vf AΉ(׫]o0N䭧;+q5xUea_M hXmg$@&7~E0 UArUmL^@cVzw#];;f;u67]nl*2Gt"ʲ5 HMvXUJU2, jŒHl'@j;3 pW/ F@8Z73fsc@$x6EaՆ=ҰCM64e$@!@HEVչz괥aU+{%p.Vh$@.B:7;n뜁9,3Cа"sz ӑs@ а] ߪ~V//O[r!GN{dѡ IDAT6Ұ asj Sqs0 аݒ ߪ^iXch4T= 9 hXgH܄oU43UGVH zl3 а:5G"pUBӰ*RhX&|43e$@'@|H VeLê G5zaU}Ұ*˓ hCUHMV M?5[ӰIWiX^H%@ê-N$&x}a3ZѰ:ccа:ƏIAUu`$@nBVhVx93ՙ>nlE$/4!pU4⬜IlⶏGj;3 VՄ *_hVyFZEkXSp8}^hڰ>ڶh#|VSrqiX] %V,;'M$'z52?I7RMWZ 6Ğߎ">X߲eѬQ}ԫ]v:)iZr dasLq-NZՊX:qIش}pukU1RD\7#ѫc[5mt@fPxycmaUo1LH@14dG$@$.wUIzͦ"bٜH37_"j+X,֜\L|]H-xau{X-^el43C_nr`t ^Xѷ$@$ OU#HH@rkbr >^NMG1v`x͠2 ?^7u6؀bCl>wY.wb2[vvg_}ժT4ֈ82)B?KA{2ԨVY(A$@$@Kuk˙ osL}EWZNm[5wiUc)+Q:LÝ -5`, аR$@$L݈ko% )xs񳧛K狽VÚg缏dujTA9?%$@Tl)nj?}U*8Ӱ*BE$@$hX] !sE6b\2 ϫ_hoT:jU#?ѿMq|b->Hh"0et~v45"ZѰ$@$@$ﾡURQ lԷ෶C ,dI$@$` _cu8ϰ^*,͆Uz] a}i ~=}|o78r)};iX-;r [a 1f VQR# #҉"B`)ӂE{ kMCxzxYQ!ȐW]e0+T~TW9úp7.CjşkU(7 hz!ާJ4G$@$VG- >'"n٩PD*J8pߑ B;[Ұ c hXɾHHM 9Z(jU+bkBՖZbf>Va(  а:ƏIH%mשsBF Цy#9eށj $ pdkҰ*_H$@$P +UA$@$[4ʖW Gt+ ao$@$@ аR$@$@%@êlilptKҰ*[F$@$@J  kA$qLx|'V֐(9pg.ح;nߊvnŰF^?G.wOv$@$@GgXݯ1  kY-TߡuGnk/7*f ߏ̿ #_tlޱԧӴ $@$hXݸ: 蝀VkJqhעqJw?22/o>|A \ܰ:z˿1q%iU4H\ T  $ΆU~S2]2a_lw?sZZqfM4'^,U4.) hXU.IH!ஆUĬ*ZŪoޣ=?psK`@`P\TnV =c bE0@H*rv@PQ%UGA1Ă17BVZH7$$3?xޟg=BX Z(B ~[j%ڻ{z#9Q*@`5pijdDiִ4iP6 )$E_p|˗cUYX#JQ'@`5pi515<^.#grK} /G%PZ=Vsd4)r@  l8Mv03ԶՍrW^#*RThj#uo=?/KJa5v>N {zJ@ XUW}UVoLV/| pT< >x+Ye|qh1j`=j  pD~1Ur[z:t`24h[p;SPI}>^B^z@C4e"N01>ٗ!IK޲Բ e{vm-CYp*9m͈/u4b@f"05&YـMcJ 묿y翕_~]sNj́(B  WSN$נyiun¾6Z%Ŀ#(+ mL]9rwYo!LfM'AaQqL|M9,TU4 6 ڸ9L 0]k`-UV׼nSgB݁m6&Rj˶0)@%`j`U?x%]"#l{r)YOUv! ڣ@uъ5ggrպgNG$+oRT'AҶҭsi۪Eަmc`2պ@-@`uwY hzwuBBק d oE%1m}>{&ݣSB'[TrA&>P <^K=e]6? Vs{@ Xo%lڛG"tܻeH6uypKաi{,y{q1wf @0CjFY% Hkl;' J-sʵ{-TݳkYpr\tI&Jor=?U;/h"$@`5,pi5;dfK޷tƙ)Kpf1Z_@YfKD떖I1 V3*@G X+M,9IltzZzV<1}\(8u>qQ@#0-&&=;IؑڽS[vIo֔exΑԧNz@4%"N0%>-ꉨC;lj7นU`IFmĔ<=N{_mx]v|U!X i4D(ZPJefyd>q5iU iZ)9(Z_gKlj7ITMXZ  ǬpzPnZ',g|gU^ ծ gi7[$9Nk׫r '@`5pqU|Kd_j-I\; kB1Xs$Dj6.K8!8[1{@+{2jZOςW|e:*X @VǷ  ^?3V^ySSL T(ީLM7W2B`@ XBWz7D)KpfVmMulFǎ:զuZUbc x[@ X6NZs`iH`j?E k) B#@`K ? vkVX Z@6WyZ `'\@ ^SƌuwyeliQWA o! @+@`ۨ$>!F;SWÙZ VA k) B#h9-y-5)i#}D1 r&v}U exO&̗ܼ|zUZا<:8@!@`uGY J&='e/_;.'M\[? 9(Z_kNϞ >kjTNC {-+C/Z16uZ=ypDӂ@/hWH=]Mh IGP$)B oV8JZޔĔ$#uA&v>ۗ!󖼥]oJΝ꛲g!/M}G0@j@Y" Tiˢ&I`v.^V>tvnO{D -"ybZ|w1 #> X5+E'`Z`9)s^ڧ a9sҘʊ۴l.;m!+1fKD떖I1 V3*@G XULXuᦍʂgcϯ~ԓVOV$KK/Js \~9MVO@ kV8N_ q eVi#&,Z>Me72, fX3D) _vܫ:e/K=~ $'%I#˗PoH%ij}UUE I=/O*E ϔ@ka V3*@G |+]_ԑsޤUlXy9R&Z:qRϐ' 6ZHΑҶUj]cޫog3c`2պ@-@`uwY xȪ6KVIǯEw/_]V˪{ݚUueI <<&/˹@\&@`uYCY ;XbHq{7nǿF_"JK΍OخmLՖmaR  >c-szh(D~%͛چԙo -nFxݭ1#%@`5߬@ǟ-ߜjeKڱwpzYYj|qXIpy,T]VߒLSksq@;rπ>@wv]iEyovY>M{Bv 6!'@\-@`uu{Y t7Z]SXFI,~~ü֩lO? lLܼjlTcpu-eA Nђ5ڭSK|_ڶj=iB6`@ XcV >-IٶkJ~Ʋw]6 )(,Q~ׯhVNeQrGr-. ,l@\.PU;t9  ڷ7 @P5<,TNVmW$:jMs.@VwU!8\@'v)GKppYv}Z;|mRXX$s_Y.3U:j # :]L@$oU=|bHݭ5jek>Sayx5SsXb'.FV@7 T O2C.X.Yau #_䗰ƻ5!Ozl93 5"BG,o'.pxسWf|gK8*%[5 Vv$G1 {@CtދDSQCnPjæ0%@z9frS/KJdE +  8{} b v ک@,0eӶO2ohz @IkMjr.@l.`=V_yC2nhIDAT r@Z{ Pֺ ԁ{Z X!@0L@=V_5` 6l SB@@!r   Rj˶0)@@@+   -l B@@ r   Rj˶0)@@@+   -l B@@ r   Rj˶0)@@@jV@@@+z: \W   x ro   R^[_ؖcR   f 4 z׹56U#  QSLj&<2m~0ӎdN   f 멥s_v2U#  I}?Vu<ރ_i@@@ ?۩C7E5+^xIENDB`LIEF-0.13.1/.github/make_index.py000066400000000000000000000020341443457337100163430ustar00rootroot00000000000000""" Build index from directory listing From: https://stackoverflow.com/questions/39048654/how-to-enable-directory-indexing-on-github-pages make_index.py """ INDEX_TEMPLATE = r""" Links for lief

Links for lief

% for name in names: ${name}
% endfor """ EXCLUDED = ['index.html', '.gitkeep'] BASE_URL = "https://lief-project.github.io" import os import argparse # May need to do "pip install mako" from mako.template import Template def main(): parser = argparse.ArgumentParser() parser.add_argument("directory") parser.add_argument("--base") parser.add_argument("--output") args = parser.parse_args() fnames = [fname for fname in sorted(os.listdir(args.directory)) if fname not in EXCLUDED] html = Template(INDEX_TEMPLATE).render(names=fnames, base_url=BASE_URL, base=args.base) with open(args.output, "w") as f: f.write(html) if __name__ == '__main__': main() LIEF-0.13.1/.github/trigger_docker.py000066400000000000000000000073561443457337100172450ustar00rootroot00000000000000# Launch Docker CI when committing # Inspired from https://medium.com/@zypherman/my-experiences-with-travis-ci-7f5ea26a87c0 import requests import json import time import sys import logging import pprint import os LOG_LEVEL = logging.INFO logging.getLogger().addHandler(logging.StreamHandler()) logging.getLogger().setLevel(LOG_LEVEL) logger = logging.getLogger(__name__) AUTH_TOKEN = os.getenv("TRAVIS_TOKEN", sys.argv[1] if len(sys.argv) > 1 else None) if not AUTH_TOKEN: logger.error("No token found!") sys.exit(1) LIEF_ID = 12579556 DOCKER_ID = 15139981 ENDPOINT = 'https://api.travis-ci.org' LIEF = f"{ENDPOINT}/repo/{LIEF_ID}" DOCKER = f"{ENDPOINT}/repo/{DOCKER_ID}" DOCKER_ENV_VARS_ENDPOINT = f"{DOCKER}/env_vars" headers = { 'Content-Type': 'application/json', 'Accept': 'application/json', 'User-Agent': 'API Explorer', 'Travis-API-Version': '3', 'Authorization': f'token {AUTH_TOKEN}' } def last_docker_build(): response = requests.get(f"{DOCKER}/branch/master", headers=headers) if not response.ok: logging.error("Error while getting last_docker_build") sys.exit(1) href = response.json()["last_build"]["@href"] build_info = requests.get(f"{ENDPOINT}{href}", headers=headers) if not build_info.ok: logging.error("Error while getting build_info") sys.exit(1) return build_info.json() def trigger_build(): response = requests.get(f"{DOCKER}/branch/master", headers=headers) build_info = last_docker_build() pprint.pprint(build_info) # Get last build info last_build_id = build_info["id"] last_build_status = build_info["state"] # Create env variables env_vars = [ { "env_var.name": "TRIGGER_COMMIT", "env_var.value": os.getenv("TRAVIS_COMMIT"), "env_var.public": False, }, { "env_var.name": "TRIGGER_REPO", "env_var.value": os.getenv("TRAVIS_REPO_SLUG"), "env_var.public": False, }, { "env_var.name": "TRIGGER_ACTION", "env_var.value": "build-doc", "env_var.public": False, }, { "env_var.name": "DEPENDENT_BUILD", "env_var.value": "true", "env_var.public": False, }, ] env_vars_results = requests.get(DOCKER_ENV_VARS_ENDPOINT, headers=headers) if not env_vars_results.ok: logger.error("Error while getting Docker env variables") sys.exit(1) env_vars_remote = env_vars_results.json()["env_vars"] # Set env variables for env_var in env_vars: remote_var = next(filter(lambda v : v["name"] == env_var["env_var.name"], env_vars_remote), None) if remote_var: r = requests.patch(f"{DOCKER}/env_var/{remote_var['id']}", data=json.dumps(env_var), headers=headers) if not r.ok: logger.error(f"Error while setting variable: '{remote_var['name']}'") sys.exit(1) else: result = requests.post(DOCKER_ENV_VARS_ENDPOINT, data=json.dumps(env_var), headers=headers) if not result.ok: logger.error(f"Error while setting variable: '{env_var['env_var.name']}'") sys.exit(1) # (Re)Start build result = requests.post(f"{ENDPOINT}/build/{last_build_id}/restart", headers=headers) if not result.ok: logger.error("Error while restarting the build") sys.exit(1) return 0 def main(): is_pull_request = not (os.getenv("TRAVIS_PULL_REQUEST", "false") == "false") if is_pull_request: logger.info("Skipping pull request build...") return 0 return trigger_build() if __name__ == "__main__": sys.exit(main()) LIEF-0.13.1/.github/workflows/000077500000000000000000000000001443457337100157235ustar00rootroot00000000000000LIEF-0.13.1/.github/workflows/android.yml000066400000000000000000000040721443457337100200710ustar00rootroot00000000000000name: 'Android' on: push jobs: build-and-deploy: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: ccache cache files uses: actions/cache@v3 with: path: ~/.ccache key: android-${{ runner.os }}-${{ steps.get-date.outputs.date }} restore-keys: | android-${{ runner.os }}- - name: Build ARM SDK shell: bash run: | docker run \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -v $GITHUB_WORKSPACE:/work \ -v $HOME/.ccache:/ccache \ --rm liefproject/android-arm bash /work/scripts/docker/android-arm.sh - name: Build AArch64 SDK shell: bash run: | docker run \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -v $GITHUB_WORKSPACE:/work \ -v $HOME/.ccache:/ccache \ --rm liefproject/android-arm64 bash /work/scripts/docker/android-aarch64.sh - name: 'Upload Artifact' uses: actions/upload-artifact@v3 with: name: android-sdk path: build/*.tar.gz retention-days: 3 - name: Deploy env: LIEF_S3_KEY: ${{ secrets.LIEF_S3_KEY }} LIEF_S3_SECRET: ${{ secrets.LIEF_S3_SECRET }} shell: bash run: | docker run \ -v $GITHUB_WORKSPACE:/src \ -e GITHUB_ACTIONS="true" \ -e GITHUB_WORKSPACE=$GITHUB_WORKSPACE \ -e GITHUB_REF=$GITHUB_REF \ -e GITHUB_REPOSITORY=$GITHUB_REPOSITORY \ -e LIEF_S3_KEY=$LIEF_S3_KEY \ -e LIEF_S3_SECRET=$LIEF_S3_SECRET \ --rm \ liefproject/deploy python3 /src/.github/deploy.py LIEF-0.13.1/.github/workflows/ios.yml000066400000000000000000000030701443457337100172400ustar00rootroot00000000000000name: 'iOS' on: push jobs: osx-sdk: runs-on: macos-11.0 steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Set up Python 3.9 uses: actions/setup-python@v2 with: python-version: 3.9 - name: Install system dependencies run: | brew install cmake ninja ccache python -m pip install --upgrade pip setuptools wheel - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: Setup cache dir shell: bash run: | mkdir -p ~/.ccache - name: ccache cache files uses: actions/cache@v3 with: path: ~/.ccache key: ios-${{ runner.os }}-${{ steps.get-date.outputs.date }} restore-keys: | ios-${{ runner.os }}- - name: Build iOS SDK shell: bash env: CCACHE_DIR: ~/.ccache CCACHE_MAXSIZE: 10.0G CCACHE_CPP2: 1 CCACHE_COMPRESS: 1 run: | bash scripts/osx/package_ios.sh - name: 'Upload Artifact' uses: actions/upload-artifact@v3 with: name: ios-sdk path: build/*.tar.gz retention-days: 3 - name: Deploy env: LIEF_S3_KEY: ${{ secrets.LIEF_S3_KEY }} LIEF_S3_SECRET: ${{ secrets.LIEF_S3_SECRET }} shell: bash run: | python -m pip install --upgrade requests mako boto3 python .github/deploy.py LIEF-0.13.1/.github/workflows/linux-aarch64.yml000066400000000000000000000077251443457337100210460ustar00rootroot00000000000000name: 'Linux AArch64' on: push jobs: linux-sdk: runs-on: ubuntu-latest strategy: matrix: python-version: [3.8, 3.9, '3.10', '3.11'] steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: ccache cache files uses: actions/cache@v3 with: path: ~/.ccache key: linux-aarch64-${{ runner.os }}-${{ steps.get-date.outputs.date }} restore-keys: | linux-aarch64-${{ runner.os }}- - name: Build SDK if: matrix.python-version == '3.9' shell: bash run: | docker run \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -v $GITHUB_WORKSPACE:/work \ -v $HOME/.ccache:/ccache \ --rm liefproject/manylinux2014-aarch64 bash /work/scripts/docker/linux-aarch64.sh - name: Build Python ${{ matrix.python-version }} wheel shell: bash env: PYTHON_VERSION: ${{ matrix.python-version }} run: | PYTHON_VERSION2=$(echo "${PYTHON_VERSION}" | sed 's/\.//') # Transform 3.8 -> 38 docker run \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -e PYTHON_BINARY=/opt/python/cp${PYTHON_VERSION2}-cp${PYTHON_VERSION2}/bin/python${PYTHON_VERSION} \ -v $GITHUB_WORKSPACE:/work \ -v $HOME/.ccache:/ccache \ --rm liefproject/manylinux2014-aarch64 bash /work/scripts/docker/manylinux2014-aarch64.sh - name: 'Upload SDK Artifact' if: matrix.python-version == '3.9' uses: actions/upload-artifact@v3 with: name: linux-aarch64-sdk path: build/*.tar.gz retention-days: 3 - name: 'Upload Python Wheel Artifact - ${{ matrix.python-version }}' uses: actions/upload-artifact@v3 with: name: linux-aarch64-wheel-${{ matrix.python-version }} path: dist/*.whl retention-days: 3 - name: Deploy env: LIEF_S3_KEY: ${{ secrets.LIEF_S3_KEY }} LIEF_S3_SECRET: ${{ secrets.LIEF_S3_SECRET }} shell: bash run: | docker run \ -v $GITHUB_WORKSPACE:/src \ -e GITHUB_ACTIONS="true" \ -e GITHUB_WORKSPACE=$GITHUB_WORKSPACE \ -e GITHUB_REF=$GITHUB_REF \ -e GITHUB_REPOSITORY=$GITHUB_REPOSITORY \ -e LIEF_S3_KEY=$LIEF_S3_KEY \ -e LIEF_S3_SECRET=$LIEF_S3_SECRET \ --rm \ liefproject/deploy python3 /src/.github/deploy.py LIEF-0.13.1/.github/workflows/linux-x86-64.yml000066400000000000000000000160631443457337100204650ustar00rootroot00000000000000name: 'Linux x86-64' on: push jobs: linux-sdk: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: ccache cache files uses: actions/cache@v3 with: path: ~/.ccache key: linux-x86-64-${{ runner.os }}-${{ steps.get-date.outputs.date }} restore-keys: | linux-x86-64-${{ runner.os }}- - name: Build Python 3.8 wheel & test shell: bash env: PYTHON_VERSION: 38 run: | docker run --rm \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -e PYTHON_VERSION=$PYTHON_VERSION \ -e PYTHON_BINARY=/opt/python/cp38-cp38/bin/python3.8 \ -v $GITHUB_WORKSPACE:/src \ -v $HOME/.ccache:/ccache \ liefproject/manylinux_2_28_x86_64 bash /src/scripts/docker/run_linux_test.sh - name: Build Python 3.9 wheel shell: bash env: PYTHON_VERSION: 39 run: | docker run --rm \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -e PYTHON_VERSION=$PYTHON_VERSION \ -e PYTHON_BINARY=/opt/python/cp39-cp39/bin/python3.9 \ -v $GITHUB_WORKSPACE:/src \ -v $HOME/.ccache:/ccache \ liefproject/manylinux_2_28_x86_64 bash /src/scripts/docker/run_linux.sh - name: Build Python 3.10 wheel shell: bash env: PYTHON_VERSION: 310 run: | docker run --rm \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -e PYTHON_VERSION=$PYTHON_VERSION \ -e PYTHON_BINARY=/opt/python/cp310-cp310/bin/python3.10 \ -v $GITHUB_WORKSPACE:/src \ -v $HOME/.ccache:/ccache \ liefproject/manylinux_2_28_x86_64 bash /src/scripts/docker/run_linux.sh - name: Test LIEF on Archlinux shell: bash env: PYTHON_VERSION: 310 run: | docker run --rm \ -v $GITHUB_WORKSPACE:/src \ liefproject/archlinux bash /src/scripts/docker/run_archlinux.sh - name: Build Python 3.11 wheel shell: bash env: PYTHON_VERSION: 311 run: | docker run --rm \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_CPP2=1 \ -e CCACHE_DIR=/ccache \ -e PYTHON_VERSION=$PYTHON_VERSION \ -e PYTHON_BINARY=/opt/python/cp311-cp311/bin/python3.11 \ -v $GITHUB_WORKSPACE:/src \ -v $HOME/.ccache:/ccache \ liefproject/manylinux_2_28_x86_64 bash /src/scripts/docker/run_linux.sh - name: Build SDK shell: bash run: | docker run --name lief_sdk --rm \ -e PYTHON_BINARY=/opt/python/cp39-cp39/bin/python3.9 \ -e CCACHE_COMPRESS=1 \ -e CCACHE_MAXSIZE=10.0G \ -e CCACHE_DIR=/ccache \ -v $GITHUB_WORKSPACE:/src \ -v $HOME/.ccache:/ccache \ liefproject/manylinux_2_28_x86_64 bash /src/scripts/docker/run_linux_sdk.sh - name: 'Upload SDK Artifact' uses: actions/upload-artifact@v3 with: name: linux-x86-64-sdk path: build/*.tar.gz retention-days: 3 - name: 'Upload SDK Artifact' uses: actions/upload-artifact@v3 with: name: linux-x86-64-python-wheel path: dist/*.whl retention-days: 3 - name: Deploy env: LIEF_S3_KEY: ${{ secrets.LIEF_S3_KEY }} LIEF_S3_SECRET: ${{ secrets.LIEF_S3_SECRET }} shell: bash run: | docker run \ -v $GITHUB_WORKSPACE:/src \ -e GITHUB_ACTIONS="true" \ -e GITHUB_WORKSPACE=$GITHUB_WORKSPACE \ -e GITHUB_REF=$GITHUB_REF \ -e GITHUB_REPOSITORY=$GITHUB_REPOSITORY \ -e LIEF_S3_KEY=$LIEF_S3_KEY \ -e LIEF_S3_SECRET=$LIEF_S3_SECRET \ --rm \ liefproject/deploy python3 /src/.github/deploy.py - name: Trigger documentation if: github.ref == 'refs/heads/master' env: CIRCLE_CI_TOKEN: ${{ secrets.CIRCLE_CI_TOKEN }} shell: bash run: | docker run --rm \ -e CIRCLE_CI_TOKEN=$CIRCLE_CI_TOKEN \ liefproject/manylinux_2_28_x86_64 \ bash -c "curl --request POST --url https://circleci.com/api/v2/project/gh/lief-project/doc/pipeline --header 'Circle-Token: ${CIRCLE_CI_TOKEN}' --header 'content-type: application/json'"; LIEF-0.13.1/.github/workflows/osx.yml000066400000000000000000000105611443457337100172620ustar00rootroot00000000000000name: 'macOS' on: push jobs: osx-sdk: runs-on: macos-11.0 strategy: matrix: python-version: [3.8, 3.9, '3.10', '3.11.0'] steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v4 with: python-version: ${{ matrix.python-version }} - name: Install system dependencies run: | brew install cmake ninja ccache python -m pip install --upgrade pip setuptools wheel - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: Setup cache dir shell: bash run: | mkdir -p ~/.ccache - name: ccache cache files uses: actions/cache@v3 with: path: ~/.ccache key: osx-${{ runner.os }}-${{ steps.get-date.outputs.date }} restore-keys: | osx-${{ runner.os }}- - name: Upgrade pip shell: bash run: | python -m pip install --upgrade pip setuptools # # Run LIEF tests on Python 3.8 (only) # ======================================== - name: Build Python ${{ matrix.python-version }} wheel & test shell: bash if: matrix.python-version == '3.8' env: LIEF_SAMPLES_DIR: "/tmp/samples" MACOSX_DEPLOYMENT_TARGET: "10.14" CCACHE_DIR: ~/.ccache CCACHE_MAXSIZE: 10.0G CCACHE_CPP2: 1 CCACHE_COMPRESS: 1 run: | python -m pip install pytest requests python tests/dl_samples.py ${LIEF_SAMPLES_DIR} python -m pip -vv wheel --wheel-dir=dist/ api/python python -m pip -vv install api/python python ./tests/run_pytest.py cmake -S . -B ./api/python/build/temp.macosx-10.15-x86_64-cpython-38 -DLIEF_TESTS=on ninja -C ./api/python/build/temp.macosx-10.15-x86_64-cpython-38 python ./tests/run_tools_check.py ./api/python/build/temp.macosx-10.15-x86_64-cpython-38 ctest --output-on-failure --test-dir ./api/python/build/temp.macosx-10.15-x86_64-cpython-38 - name: Build Python ${{ matrix.python-version }} wheel (x86-64) shell: bash if: matrix.python-version != '3.8' env: MACOSX_DEPLOYMENT_TARGET: "10.14" CCACHE_DIR: ~/.ccache CCACHE_MAXSIZE: 10.0G CCACHE_CPP2: 1 CCACHE_COMPRESS: 1 run: | python -m pip wheel --wheel-dir=dist/ api/python # # cross-compile for Apple M1 for Python >= 3.9 # ============================================ - name: Build Python ${{ matrix.python-version }} wheel (arm64) shell: bash if: matrix.python-version != '3.8' env: MACOSX_DEPLOYMENT_TARGET: "11.0" CCACHE_DIR: ~/.ccache CCACHE_MAXSIZE: 10.0G CCACHE_CPP2: 1 CCACHE_COMPRESS: 1 run: | PYLIEF_CONF="$(pwd)/scripts/osx/config-xcompile-arm64.toml" \ python -m pip -vv wheel --wheel-dir=dist/ api/python # # Build the SDK while running with Python 3.9 (only once) # ======================================================= - name: Build SDK shell: bash if: matrix.python-version == '3.9' # Build the SDD only with Python 3.9 env: MACOSX_DEPLOYMENT_TARGET: "10.14" CCACHE_DIR: ~/.ccache CCACHE_MAXSIZE: 10.0G CCACHE_CPP2: 1 CCACHE_COMPRESS: 1 run: | bash scripts/osx/package_sdk.sh - name: 'Upload SDK Artifact' if: matrix.python-version == '3.9' # Build the SDk only with Python 3.9 uses: actions/upload-artifact@v3 with: name: osx-sdk path: build/*.tar.gz retention-days: 3 - name: 'Upload Python Wheel Artifact - ${{ matrix.python-version }}' uses: actions/upload-artifact@v3 with: name: osx-wheel-${{ matrix.python-version }} path: dist/*.whl retention-days: 3 - name: Deploy env: LIEF_S3_KEY: ${{ secrets.LIEF_S3_KEY }} LIEF_S3_SECRET: ${{ secrets.LIEF_S3_SECRET }} shell: bash run: | python -m pip install --upgrade requests mako boto3 python .github/deploy.py LIEF-0.13.1/.github/workflows/pr.yml000066400000000000000000000045241443457337100170740ustar00rootroot00000000000000name: LIEF PR on: [pull_request, workflow_dispatch] jobs: osx: runs-on: macos-11.0 strategy: matrix: python-version: ["3.10"] steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v4 with: python-version: ${{ matrix.python-version }} - name: Install system dependencies run: | brew install cmake ninja ccache python -m pip install --upgrade pip setuptools wheel - name: Build with Python ${{ matrix.python-version }} & Test shell: bash env: LIEF_SAMPLES_DIR: "/tmp/samples" run: | python -m pip install pytest requests python tests/dl_samples.py ${LIEF_SAMPLES_DIR} python -m pip -vv install api/python python ./tests/run_pytest.py linux: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Build & Test shell: bash env: PYTHON_VERSION: 39 run: | docker run --rm \ -e PYTHON_VERSION=$PYTHON_VERSION \ -e PYTHON_BINARY=/opt/python/cp39-cp39/bin/python3.9 \ -v $GITHUB_WORKSPACE:/src \ liefproject/manylinux_2_28_x86_64 bash /src/scripts/docker/run_linux_test.sh windows: runs-on: windows-latest strategy: matrix: python-version: [3.9] steps: - uses: actions/checkout@v2 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v4 with: python-version: ${{ matrix.python-version }} architecture: x64 - name: Install system dependencies run: | choco install ninja python -m pip install --upgrade pip setuptools python -m pip install wheel mako - uses: ilammy/msvc-dev-cmd@v1 with: toolset: "14.16" - name: Set env variables run: | chcp 65001 #set code page to utf-8 echo ("LIEF_SAMPLES_DIR=" + $env:RUNNER_TEMP + "/samples") >> $env:GITHUB_ENV - name: Build and Test run: | python -m pip install pytest requests python tests/dl_samples.py %LIEF_SAMPLES_DIR% python -m pip -vv install api/python python ./tests/run_pytest.py shell: cmd LIEF-0.13.1/.github/workflows/sanitize.yml000066400000000000000000000022641443457337100203000ustar00rootroot00000000000000name: 'sanitize' on: push: tags: - '**' schedule: - cron: '0 0 * * 1' workflow_dispatch: jobs: gcc: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: compile shell: bash run: | docker run --rm \ -e BUILD_DIR=/tmp/build_gcc \ -e SRC_DIR=/src \ -v $GITHUB_WORKSPACE:/src \ liefproject/sanity:latest bash /src/scripts/docker/gcc.sh clang: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: compile shell: bash run: | docker run --rm \ -e BUILD_DIR=/tmp/build_clang \ -e SRC_DIR=/src \ -v $GITHUB_WORKSPACE:/src \ liefproject/sanity:latest bash /src/scripts/docker/clang.sh asan: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: compile shell: bash run: | docker run --rm \ -v $GITHUB_WORKSPACE:/src \ liefproject/sanity:latest bash /src/scripts/docker/asan_check.sh LIEF-0.13.1/.github/workflows/windows-x64-all.yml000066400000000000000000000101251443457337100213240ustar00rootroot00000000000000 name: LIEF Windows x64 on: push: branches: - 'master' - 'release-**' tags: - '**' jobs: build: runs-on: windows-2019 strategy: matrix: python-version: [3.8, 3.9, '3.10', '3.11.0'] fail-fast: false env: SCCACHE_CACHE_SIZE: 2G SCCACHE_DIR: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v2 with: python-version: ${{ matrix.python-version }} architecture: x64 - name: Install system dependencies run: | choco install ninja choco install sccache python -m pip install --upgrade pip setuptools python -m pip install wheel mako - uses: ilammy/msvc-dev-cmd@v1 with: toolset: "14.16" - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: Save sccache uses: actions/cache@v3 continue-on-error: false with: path: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" key: ${{ runner.os }}-x64-sccache-${{ steps.get-date.outputs.date }} restore-keys: | ${{ runner.os }}-x64-sccache- - name: Start sccache server run: sccache --start-server - name: Set env variables run: | chcp 65001 #set code page to utf-8 echo ("LIEF_SAMPLES_DIR=" + $env:RUNNER_TEMP + "/samples") >> $env:GITHUB_ENV - name: Upgrade pip run: | python -m pip install --upgrade pip shell: cmd - name: ⛓ Build Python ${{ matrix.python-version }} & Test if: matrix.python-version == 3.8 run: | python -m pip install pytest requests python tests/dl_samples.py %LIEF_SAMPLES_DIR% python -m pip -vv wheel --wheel-dir=dist/ api/python python -m pip -vv install api/python python ./tests/run_pytest.py python ./scripts/windows/run_ctest.py ./api/python/build/temp.win-amd64-cpython-38/Release python ./tests/run_tools_check.py ./api/python/build/temp.win-amd64-cpython-38/Release shell: cmd - name: ❱ Build Python ${{ matrix.python-version }} if: matrix.python-version != 3.8 run: | python -m pip -vv wheel --wheel-dir=dist/ api/python shell: cmd - name: ❱ Build SDK if: matrix.python-version == 3.9 run: | python ./scripts/windows/package_sdk.py - name: 'Upload SDK Artifact' if: matrix.python-version == 3.9 uses: actions/upload-artifact@v3 with: name: windows-x64-sdk path: build/*.zip retention-days: 3 - name: 'Upload Python Wheel Artifact - ${{ matrix.python-version }}' uses: actions/upload-artifact@v3 with: name: windows-x64-wheel-${{ matrix.python-version }} path: dist/*.whl retention-days: 3 - name: 📊 Print sccache stats run: sccache --show-stats - name: 🛑 Stop sccache server run: sccache --stop-server || true - name: Setup WSL uses: Vampire/setup-wsl@v1 with: distribution: Debian use-cache: 'true' wsl-shell-user: root set-as-default: 'true' wsl-conf: | [automount] options = "metadata" additional-packages: ca-certificates curl locales python3 python3-pip git openssl ssh - shell: wsl-bash {0} name: Deploy env: LIEF_S3_KEY: ${{ secrets.LIEF_S3_KEY }} LIEF_S3_SECRET: ${{ secrets.LIEF_S3_SECRET }} GITHUB_ACTIONS: "true" GITHUB_WORKSPACE: ${{ env.GITHUB_WORKSPACE }} GITHUB_REF: ${{ env.GITHUB_REF }} GITHUB_REPOSITORY: ${{ env.GITHUB_REPOSITORY }} WSLENV: LIEF_S3_KEY:LIEF_S3_SECRET:GITHUB_ACTIONS:GITHUB_WORKSPACE:GITHUB_REF:GITHUB_REPOSITORY run: | python3 -m pip install --no-cache-dir --upgrade pip setuptools requests mako wheel boto3 python3 .github/deploy.py LIEF-0.13.1/.github/workflows/windows-x64-quick.yml000066400000000000000000000040701443457337100216720ustar00rootroot00000000000000 name: LIEF Windows x64 Quick on: push: branches: - '**' - '!master' - '!release-**' tags-ignore: - "**" jobs: build: runs-on: windows-2019 strategy: matrix: python-version: [3.9] env: SCCACHE_CACHE_SIZE: 2G SCCACHE_DIR: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v2 with: python-version: ${{ matrix.python-version }} architecture: x64 - name: Install system dependencies run: | choco install ninja choco install sccache python -m pip install --upgrade pip setuptools python -m pip install wheel mako - uses: ilammy/msvc-dev-cmd@v1 with: toolset: "14.16" - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: Save sccache uses: actions/cache@v3 continue-on-error: false with: path: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" key: ${{ runner.os }}-x64-sccache-${{ steps.get-date.outputs.date }} restore-keys: | ${{ runner.os }}-x64-sccache- - name: Start sccache server run: sccache --start-server - name: Set env variables run: | chcp 65001 #set code page to utf-8 echo ("LIEF_SAMPLES_DIR=" + $env:RUNNER_TEMP + "/samples") >> $env:GITHUB_ENV - name: Upgrade pip run: | python -m pip install --upgrade pip shell: cmd - name: ⛓ Build Python ${{ matrix.python-version }} & Test run: | python -m pip install pytest requests python tests/dl_samples.py %LIEF_SAMPLES_DIR% python -m pip -vv install api/python python ./tests/run_pytest.py shell: cmd - name: 📊 Print sccache stats run: sccache --show-stats - name: 🛑 Stop sccache server run: sccache --stop-server || true LIEF-0.13.1/.github/workflows/windows-x86-all.yml000066400000000000000000000101471443457337100213340ustar00rootroot00000000000000name: LIEF Windows x86 on: push: branches: - 'master' - 'release-**' - 'devel' tags: - '**' jobs: build: runs-on: windows-2019 strategy: matrix: python-version: [3.8, 3.9, '3.10', '3.11.0'] fail-fast: false env: SCCACHE_CACHE_SIZE: 2G SCCACHE_DIR: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v4 with: python-version: ${{ matrix.python-version }} architecture: x86 - name: Install system dependencies run: | choco install ninja choco install sccache python -m pip install --upgrade pip setuptools python -m pip install wheel mako - uses: ilammy/msvc-dev-cmd@v1 with: toolset: "14.16" - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: Save sccache uses: actions/cache@v3 continue-on-error: false with: path: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" key: ${{ runner.os }}-x86-sccache-${{ steps.get-date.outputs.date }} restore-keys: | ${{ runner.os }}-x86-sccache- - name: Start sccache server run: sccache --start-server - name: Set env variables run: | chcp 65001 #set code page to utf-8 echo ("LIEF_SAMPLES_DIR=" + $env:RUNNER_TEMP + "/samples") >> $env:GITHUB_ENV - name: Set env variables run: | chcp 65001 #set code page to utf-8 echo ("PYLIEF_CONF=" + $env:GITHUB_WORKSPACE + "/scripts/windows/config-win32.toml") >> $env:GITHUB_ENV - name: Upgrade pip run: | python -m pip install --upgrade pip shell: cmd - name: ⛓ Build Python ${{ matrix.python-version }} & Test if: matrix.python-version == 3.8 run: | python -m pip install pytest requests python tests/dl_samples.py %LIEF_SAMPLES_DIR% python -m pip -vv wheel --wheel-dir=dist/ api/python python -m pip -vv install api/python python ./tests/run_pytest.py shell: cmd - name: ❱ Build Python ${{ matrix.python-version }} if: matrix.python-version != 3.8 run: | python -m pip -vv wheel --wheel-dir=dist/ api/python shell: cmd - name: ❱ Build SDK if: matrix.python-version == 3.9 run: | python ./scripts/windows/package_sdk.py - name: 'Upload SDK Artifact' if: matrix.python-version == 3.9 uses: actions/upload-artifact@v3 with: name: windows-x86-sdk path: build/*.zip retention-days: 3 - name: 'Upload Python Wheel Artifact - ${{ matrix.python-version }}' uses: actions/upload-artifact@v3 with: name: windows-x86-wheel-${{ matrix.python-version }} path: dist/*.whl retention-days: 3 - name: 📊 Print sccache stats run: sccache --show-stats - name: 🛑 Stop sccache server run: sccache --stop-server || true - name: Setup WSL uses: Vampire/setup-wsl@v1 with: distribution: Debian use-cache: 'true' wsl-shell-user: root set-as-default: 'true' wsl-conf: | [automount] options = "metadata" additional-packages: ca-certificates curl locales python3 python3-pip git openssl ssh - shell: wsl-bash {0} name: Deploy env: LIEF_S3_KEY: ${{ secrets.LIEF_S3_KEY }} LIEF_S3_SECRET: ${{ secrets.LIEF_S3_SECRET }} GITHUB_ACTIONS: "true" GITHUB_WORKSPACE: ${{ env.GITHUB_WORKSPACE }} GITHUB_REF: ${{ env.GITHUB_REF }} GITHUB_REPOSITORY: ${{ env.GITHUB_REPOSITORY }} WSLENV: LIEF_S3_KEY:LIEF_S3_SECRET:GITHUB_ACTIONS:GITHUB_WORKSPACE:GITHUB_REF:GITHUB_REPOSITORY run: | python3 -m pip install --no-cache-dir --upgrade pip setuptools requests mako wheel boto3 python3 .github/deploy.py LIEF-0.13.1/.github/workflows/windows-x86-quick.yml000066400000000000000000000040701443457337100216760ustar00rootroot00000000000000 name: LIEF Windows x86 Quick on: push: branches: - '**' - '!master' - '!release-**' tags-ignore: - "**" jobs: build: runs-on: windows-2019 strategy: matrix: python-version: [3.9] env: SCCACHE_CACHE_SIZE: 2G SCCACHE_DIR: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" steps: - uses: actions/checkout@v2 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v2 with: python-version: ${{ matrix.python-version }} architecture: x86 - name: Install system dependencies run: | choco install ninja choco install sccache python -m pip install --upgrade pip setuptools python -m pip install wheel mako - uses: ilammy/msvc-dev-cmd@v1 with: toolset: "14.16" - name: Get Date id: get-date run: | echo "::set-output name=date::$(/bin/date -u "+%Y-%m-%d-%H;%M;%S")" shell: bash - name: Save sccache uses: actions/cache@v3 continue-on-error: false with: path: "C:\\Users\\runner\\AppData\\Local\\Mozilla\\sccache" key: ${{ runner.os }}-x86-sccache-${{ steps.get-date.outputs.date }} restore-keys: | ${{ runner.os }}-x86-sccache- - name: Start sccache server run: sccache --start-server - name: Set env variables run: | chcp 65001 #set code page to utf-8 echo ("LIEF_SAMPLES_DIR=" + $env:RUNNER_TEMP + "/samples") >> $env:GITHUB_ENV - name: Upgrade pip run: | python -m pip install --upgrade pip shell: cmd - name: ⛓ Build Python ${{ matrix.python-version }} & Test run: | python -m pip install pytest requests python tests/dl_samples.py %LIEF_SAMPLES_DIR% python -m pip -vv install api/python python ./tests/run_pytest.py shell: cmd - name: 📊 Print sccache stats run: sccache --show-stats - name: 🛑 Stop sccache server run: sccache --stop-server || true LIEF-0.13.1/.gitignore000066400000000000000000000000471443457337100143170ustar00rootroot00000000000000build/ *.so *.whl lief.egg-info/ dist/ LIEF-0.13.1/AUTHORS000066400000000000000000000000731443457337100133760ustar00rootroot00000000000000Authors: Romain Thomas - Quarkslab LIEF-0.13.1/Acknowledgements000066400000000000000000000013111443457337100155370ustar00rootroot00000000000000Acknowledgements ---------------- LIEF makes use of the following open source projects: - mbedTLS - https://tls.mbed.org/ - pybind11 - https://github.com/pybind/pybind11 - json - https://nlohmann.github.io/json/ - rang - https://agauniyal.github.io/rang/ - easyloggingpp - https://github.com/muflihun/easyloggingpp - Catch - https://github.com/philsquared/Catch - yamlcpp - https://github.com/jbeder/yaml-cpp - filesystem - https://github.com/wjakob/filesystem - utf8-cpp - https://sourceforge.net/projects/utfcpp/ - llvm - http://llvm.org/ - For the formats enums and structures - virtualbox - https://www.virtualbox.org/ - For the PE 'LoadConfiguration' structures The logo is designed by Freepik LIEF-0.13.1/CHANGELOG000066400000000000000000000000631443457337100135370ustar00rootroot00000000000000Changelog ========= see doc/sphinx/changelog.rst LIEF-0.13.1/CMakeLists.txt000066400000000000000000000566041443457337100151010ustar00rootroot00000000000000cmake_minimum_required(VERSION 3.15) # Avoid warning about DOWNLOAD_EXTRACT_TIMESTAMP in CMake 3.24: if (CMAKE_VERSION VERSION_GREATER_EQUAL "3.24.0") cmake_policy(SET CMP0135 NEW) endif() # Enable https://cmake.org/cmake/help/latest/prop_tgt/MSVC_RUNTIME_LIBRARY.html cmake_policy(SET CMP0091 NEW) set_property(GLOBAL PROPERTY USE_FOLDERS ON) # Modules list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake/") include(CheckCXXCompilerFlag) include(CheckCCompilerFlag) include(ExternalProject) include(CMakePackageConfigHelpers) if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/.git" AND IS_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/.git") find_package(Git REQUIRED) # Information from git # ==================== include(LIEFGit) else() set(LIEF_VERSION_MAJOR "0") set(LIEF_VERSION_MINOR "13") set(LIEF_VERSION_PATCH "1") endif() # LIEF Project # ============ project( LIEF VERSION ${LIEF_VERSION_MAJOR}.${LIEF_VERSION_MINOR}.${LIEF_VERSION_PATCH}) message(STATUS "${PROJECT_NAME} ${PROJECT_VERSION}") # Select the MSVC runtime based on the LIEF_USE_CRT_XXX variable if(MSVC) foreach(build_type ${CMAKE_CONFIGURATION_TYPES} ${CMAKE_BUILD_TYPE}) string(TOUPPER "${build_type}" build) if(DEFINED "LIEF_USE_CRT_${build}") set(runtime "${LIEF_USE_CRT_${build}}") if(build_type STREQUAL Debug) set(default_runtime MDd) else() set(default_runtime MD) endif() if(runtime AND NOT "${runtime}" STREQUAL "${default_runtime}") if(runtime STREQUAL "MT") set(runtime_library "MultiThreaded") elseif(runtime STREQUAL "MD") set(runtime_library "MultiThreadedDLL") elseif(runtime STREQUAL "MTd") set(runtime_library "MultiThreadedDebug") elseif(runtime STREQUAL "MDd") set(runtime_library "MultiThreadedDebugDLL") else() message(FATAL_ERROR "Unsupported value LIEF_USE_CRT_${build}=${runtime}") endif() message(STATUS "LIEF_CRT_${build}: ${runtime}") set(CMAKE_MSVC_RUNTIME_LIBRARY "${CMAKE_MSVC_RUNTIME_LIBRARY}$<$:${runtime_library}>") endif() endif() endforeach() endif() # LIEF options # ============= include(LIEFOptions) # Compiler detection (C++14, C++17, ...) include(LIEFCompilerDetection) # CCACHE # ====== message(STATUS "Caching: ${LIEF_USE_CCACHE}") if(LIEF_USE_CCACHE) find_program(CCACHE_FOUND ccache) if(CCACHE_FOUND) set_property(GLOBAL PROPERTY RULE_LAUNCH_COMPILE ccache) set_property(GLOBAL PROPERTY RULE_LAUNCH_LINK ccache) message(STATUS "Found ccache: ${CCACHE_FOUND}") else() find_program(SCCACHE_FOUND sccache) if(SCCACHE_FOUND) set(CMAKE_C_COMPILER_LAUNCHER ${SCCACHE_FOUND}) set(CMAKE_CXX_COMPILER_LAUNCHER ${SCCACHE_FOUND}) message(STATUS "Found sccache: ${SCCACHE_FOUND}") else() set(LIEF_USE_CCACHE OFF) message(WARNING "Can't find cache solution") endif() endif() endif() # Dependencies # ============ set(THIRD_PARTY_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/third-party/") include(LIEFDependencies) # iOS specific config # =================== if(CMAKE_SYSTEM_NAME STREQUAL "iOS") set(CMAKE_XCODE_ATTRIBUTE_CODE_SIGNING_REQUIRED NO) set(CMAKE_XCODE_ATTRIBUTE_CODE_SIGNING_ALLOWED NO) set(CMAKE_XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY "") endif() message(STATUS "CMAKE_CXX_FLAGS_RELEASE: ${CMAKE_CXX_FLAGS_RELEASE}") message(STATUS "CMAKE_CXX_FLAGS: ${CMAKE_CXX_FLAGS}") message(STATUS "CMAKE_CXX_LINK_EXECUTABLE: ${CMAKE_CXX_LINK_EXECUTABLE}") message(STATUS "CMAKE_CXX_LINK_FLAGS: ${CMAKE_CXX_LINK_FLAGS}") message(STATUS "CMAKE_EXE_LINKER_FLAGS: ${CMAKE_EXE_LINKER_FLAGS}") message(STATUS "CMAKE_EXE_LINKER_FLAGS_RELEASE: ${CMAKE_EXE_LINKER_FLAGS_RELEASE}") message(STATUS "CMAKE_SHARED_LINKER_FLAGS: ${CMAKE_SHARED_LINKER_FLAGS}") message(STATUS "CMAKE_SHARED_LINKER_FLAGS_RELEASE: ${CMAKE_SHARED_LINKER_FLAGS_RELEASE}") message(STATUS "CMAKE_CXX_LINK_LIBRARY_FILE_FLAG: ${CMAKE_CXX_LINK_LIBRARY_FILE_FLAG}") message(STATUS "CMAKE_LINK_LIBRARY_FILE_FLAG: ${CMAKE_LINK_LIBRARY_FILE_FLAG}") message(STATUS "CMAKE_LINK_INTERFACE_LIBRARIES: ${CMAKE_LINK_INTERFACE_LIBRARIES}") message(STATUS "CMAKE_CXX_IMPLICIT_LINK_LIBRARIES: ${CMAKE_CXX_IMPLICIT_LINK_LIBRARIES}") message(STATUS "CMAKE_SYSTEM_PROCESSOR: ${CMAKE_SYSTEM_PROCESSOR}") # LIEF Source definition # ====================== set(LIEF_PRIVATE_INCLUDE_DIR) set(LIEF_PUBLIC_INCLUDE_DIR) set(LIEF_PUBLIC_INCLUDE_FILES) set(LIEF_PRIVATE_INCLUDE_FILES) set(LIBLIEF_SOURCE_FILES "${CMAKE_CURRENT_SOURCE_DIR}/src/errors.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/hash_stream.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/logging.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/iostream.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/utils.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/internal_utils.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/Object.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/Object.tcc" "${CMAKE_CURRENT_SOURCE_DIR}/src/Visitor.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/BinaryStream/BinaryStream.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/BinaryStream/VectorStream.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/BinaryStream/FileStream.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/BinaryStream/MemoryStream.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/BinaryStream/SpanStream.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/BinaryStream/Convert.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/visitors/hash.cpp") # Grouping basic headers together # =============================== set(LIEF_INC_FILES "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/errors.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/span.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/ELF.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/Abstract.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/iostream.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/iterators.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/LIEF.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/logging.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/MachO.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/PE.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/types.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/utils.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/visibility.h" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/Object.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/Visitor.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/visitor_macros.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/BinaryStream/BinaryStream.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/BinaryStream/VectorStream.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/BinaryStream/FileStream.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/BinaryStream/MemoryStream.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/BinaryStream/SpanStream.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/BinaryStream/Convert.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/internal_utils.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/hash_stream.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/frozen.hpp" ) set(LIEF_VISITOR_INCLUDE_FILES "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/hash.hpp") set(LIEF_INCLUDE_FILES ${LIEF_INC_FILES} ${LIEF_VISITOR_INCLUDE_FILES}) set(LIEF_JSON_SRC "${CMAKE_CURRENT_SOURCE_DIR}/src/visitors/json.cpp") set(LIEF_JSON_HDR "${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/json.hpp") list(APPEND LIEF_INC_FILES "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/json.hpp") list(APPEND LIBLIEF_SOURCE_FILES "${CMAKE_CURRENT_SOURCE_DIR}/src/json_api.cpp") if(LIEF_ENABLE_JSON) list(APPEND LIBLIEF_SOURCE_FILES "${LIEF_JSON_SRC}") list(APPEND LIEF_INC_FILES "${LIEF_JSON_HDR}") endif() source_group("Header Files" FILES ${LIEF_INC_FILES}) source_group("Source Files" FILES ${LIBLIEF_SOURCE_FILES}) source_group("Header Files\\visitors" FILES ${LIEF_VISITOR_INCLUDE_FILES}) add_library(LIB_LIEF ${LIBLIEF_SOURCE_FILES} ${LIEF_INCLUDE_FILES}) add_library(LIEF::LIEF ALIAS LIB_LIEF) if(NOT LIEF_OPT_MBEDTLS_EXTERNAL) set_source_files_properties(${mbedtls_src_crypto} PROPERTIES GENERATED TRUE) set_source_files_properties(${mbedtls_src_x509} PROPERTIES GENERATED TRUE) set_source_files_properties(${mbedtls_src_tls} PROPERTIES GENERATED TRUE) target_sources(LIB_LIEF PRIVATE "${mbedtls_src_crypto}" "${mbedtls_src_x509}" "${mbedtls_src_tls}") source_group("mbedtls\\crypto" FILES ${mbedtls_src_crypto}) source_group("mbedtls\\x509" FILES ${mbedtls_src_x509}) source_group("mbedtls\\tls" FILES ${mbedtls_src_tls}) target_include_directories( LIB_LIEF SYSTEM PRIVATE "${MBEDTLS_INCLUDE_DIRS}" "${MBEDTLS_SOURCE_DIR}/library" ) add_dependencies(LIB_LIEF lief_mbed_tls) else() find_package(MbedTLS REQUIRED) target_link_libraries(LIB_LIEF PRIVATE MbedTLS::mbedcrypto MbedTLS::mbedx509) endif() if(WINDOWS AND BUILD_SHARED_LIBS) target_link_libraries(LIB_LIEF ws2_32) endif() if(MSVC) add_compile_options(/bigobj) endif() if(CMAKE_BUILD_TYPE MATCHES Debug AND WINDOWS) add_definitions(-D_ITERATOR_DEBUG_LEVEL=0 -D_SECURE_SCL=0 -D_HAS_ITERATOR_DEBUGGING=0) endif() if(CMAKE_BUILD_TYPE MATCHES Debug AND UNIX) target_compile_options(LIB_LIEF PRIVATE -g -O0) endif() if(BUILD_SHARED_LIBS OR LIEF_FORCE_API_EXPORTS) target_compile_definitions(LIB_LIEF PRIVATE -DLIEF_EXPORTS) else() target_compile_definitions(LIB_LIEF PRIVATE -DLIEF_STATIC) endif() if(LIEF_SUPPORT_CXX14) target_compile_features(LIB_LIEF PRIVATE cxx_std_14) endif() # Abstract part include("${CMAKE_CURRENT_SOURCE_DIR}/src/Abstract/CMakeLists.txt") # ELF Part # ======== include("${CMAKE_CURRENT_SOURCE_DIR}/src/ELF/CMakeLists.txt") if(LIEF_ELF) set(ENABLE_ELF_SUPPORT 1) else() set(ENABLE_ELF_SUPPORT 0) endif() # PE Part # ======= include("${CMAKE_CURRENT_SOURCE_DIR}/src/PE/CMakeLists.txt") if(LIEF_PE) set(ENABLE_PE_SUPPORT 1) else() set(ENABLE_PE_SUPPORT 0) endif() # MachO part # ========== include("${CMAKE_CURRENT_SOURCE_DIR}/src/MachO/CMakeLists.txt") if(LIEF_MACHO) set(ENABLE_MACHO_SUPPORT 1) else() set(ENABLE_MACHO_SUPPORT 0) endif() # Logging Configuration # ===================== target_compile_definitions(LIB_LIEF PRIVATE SPDLOG_DISABLE_DEFAULT_LOGGER SPDLOG_NO_EXCEPTIONS SPDLOG_FUNCTION=) if(CMAKE_SYSTEM_NAME STREQUAL "iOS") target_compile_definitions(LIB_LIEF PRIVATE SPDLOG_NO_THREAD_ID) endif() # Frozen Configuration # ==================== if(LIEF_FROZEN_ENABLED) endif() # OAT part # ======== if(LIEF_OAT) include(${CMAKE_CURRENT_SOURCE_DIR}/src/OAT/CMakeLists.txt) set(ENABLE_OAT_SUPPORT 1) else() set(ENABLE_OAT_SUPPORT 0) endif() # DEX part # ======== if(LIEF_DEX) include(${CMAKE_CURRENT_SOURCE_DIR}/src/DEX/CMakeLists.txt) set(ENABLE_DEX_SUPPORT 1) else() set(ENABLE_DEX_SUPPORT 0) endif() # VDEX part # ========= if(LIEF_VDEX) include(${CMAKE_CURRENT_SOURCE_DIR}/src/VDEX/CMakeLists.txt) set(ENABLE_VDEX_SUPPORT 1) else() set(ENABLE_VDEX_SUPPORT 0) endif() # ART part # ======== if(LIEF_ART) include(${CMAKE_CURRENT_SOURCE_DIR}/src/ART/CMakeLists.txt) set(ENABLE_ART_SUPPORT 1) else() set(ENABLE_ART_SUPPORT 0) endif() # Platforms # ========= include(${CMAKE_CURRENT_SOURCE_DIR}/src/platforms/CMakeLists.txt) # LIEF includes # ============= configure_file("${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/version.h.in" "${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/version.h") configure_file("${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF/config.h.in" "${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/config.h" @ONLY) list(APPEND LIEF_PUBLIC_INCLUDE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/include/" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/" "${CMAKE_CURRENT_BINARY_DIR}/include/") list(APPEND LIEF_PRIVATE_INCLUDE_DIR "${LIEF_PUBLIC_INCLUDE_DIR}" "${CMAKE_CURRENT_SOURCE_DIR}/src" "${CMAKE_CURRENT_BINARY_DIR}") configure_file(${CMAKE_CURRENT_SOURCE_DIR}/cmake/LIEF.pc.in ${CMAKE_CURRENT_BINARY_DIR}/LIEF.pc @ONLY) target_include_directories(LIB_LIEF PUBLIC "$" PRIVATE "${LIEF_PRIVATE_INCLUDE_DIR}") if(LIEF_ENABLE_JSON) if(LIEF_OPT_NLOHMANN_JSON_EXTERNAL) find_package(nlohmann_json REQUIRED) target_link_libraries(LIB_LIEF PRIVATE nlohmann_json::nlohmann_json) else() add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/internal/nlohmann/json.hpp COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_BINARY_DIR}/internal/nlohmann COMMAND ${CMAKE_COMMAND} -E copy_directory ${LIBJSON_SOURCE_DIR}/ ${CMAKE_CURRENT_BINARY_DIR}/internal/nlohmann/ DEPENDS lief_libjson) target_sources(LIB_LIEF PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/internal/nlohmann/json.hpp) target_include_directories(LIB_LIEF PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/) endif() endif() if(LIEF_FROZEN_ENABLED) if(LIEF_OPT_FROZEN_EXTERNAL) find_package(frozen REQUIRED) target_link_libraries(LIB_LIEF PRIVATE frozen::frozen) else() add_dependencies(LIB_LIEF lief_frozen) target_include_directories(LIB_LIEF PRIVATE "${FROZEN_INCLUDE_DIR}") endif() endif() # ======================================= # Leaf # ======================================= if(LIEF_EXTERNAL_LEAF) message(STATUS "Using external LEAF version") if(LIEF_EXTERNAL_LEAF_DIR) message(STATUS "External LEAF include dir: ${LIEF_EXTERNAL_LEAF_DIR}") target_include_directories(LIB_LIEF SYSTEM PUBLIC "$") endif() else() add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/leaf.hpp COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/ COMMAND ${CMAKE_COMMAND} -E copy_directory ${LEAF_SRC_DIR}/ ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/ DEPENDS lief_leaf) target_sources(LIB_LIEF PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/leaf.hpp) endif() # ======================================= # utfcpp # ======================================= if(LIEF_OPT_UTFCPP_EXTERNAL) find_package(utf8cpp REQUIRED) target_link_libraries(LIB_LIEF PRIVATE utf8cpp) else() add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/internal/utfcpp/utf8.h COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_BINARY_DIR}/internal/ COMMAND ${CMAKE_COMMAND} -E copy_directory ${UTFCPP_INCLUDE_DIR}/ ${CMAKE_CURRENT_BINARY_DIR}/internal/utfcpp DEPENDS lief_utfcpp) target_sources(LIB_LIEF PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/internal/utfcpp/utf8.h) endif() # ======================================= # tcb/span # ======================================= if(LIEF_EXTERNAL_SPAN) message(STATUS "Using external tcb/span version") if(LIEF_EXTERNAL_SPAN_DIR) message(STATUS "External span include dir: ${LIEF_EXTERNAL_SPAN_DIR}") target_include_directories(LIB_LIEF SYSTEM PUBLIC "$") endif() else() add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/span.hpp COMMAND ${CMAKE_COMMAND} -E make_directory ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/ COMMAND ${CMAKE_COMMAND} -E copy_directory ${TCB_SPAN_SRC_DIR}/ ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/ DEPENDS lief_span) target_sources(LIB_LIEF PRIVATE ${CMAKE_CURRENT_BINARY_DIR}/include/LIEF/third-party/internal/span.hpp) endif() target_link_libraries(LIB_LIEF PRIVATE lief_spdlog) if(ANDROID AND BUILD_SHARED_LIBS AND LIEF_LOGGING) target_link_libraries(LIB_LIEF PUBLIC log) endif() # Flags definition # ---------------- # cmake-format: off set_target_properties( LIB_LIEF PROPERTIES POSITION_INDEPENDENT_CODE ON CXX_STANDARD 11 CXX_STANDARD_REQUIRED ON CXX_VISIBILITY_PRESET hidden C_VISIBILITY_PRESET hidden) # cmake-format: on if(UNIX AND NOT APPLE) set_property( TARGET LIB_LIEF APPEND PROPERTY LINK_FLAGS "-Wl,--gc-sections -Wl,--exclude-libs,ALL") endif() target_compile_definitions(LIB_LIEF PUBLIC -D_GLIBCXX_USE_CXX11_ABI=1) # LIEF Sanitizer options # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ set(SANITIZER_FLAGS -fno-omit-frame-pointer -g -O1) if(LIEF_ASAN) message(STATUS "Address sanitizer enabled") list(APPEND SANITIZER_FLAGS -fsanitize=address) set_property(TARGET LIB_LIEF APPEND PROPERTY LINK_FLAGS -fsanitize=address) target_link_libraries(LIB_LIEF INTERFACE asan) endif() if(LIEF_LSAN) message(STATUS "Leak sanitizer enabled") list(APPEND SANITIZER_FLAGS -fsanitize=leak) set_property(TARGET LIB_LIEF APPEND PROPERTY LINK_FLAGS -fsanitize=leak) target_link_libraries(LIB_LIEF INTERFACE lsan) endif() if(LIEF_TSAN) message(STATUS "Thread sanitizer enabled") list(APPEND SANITIZER_FLAGS -fsanitize=thread) set_property(TARGET LIB_LIEF APPEND PROPERTY LINK_FLAGS -fsanitize=thread) target_link_libraries(LIB_LIEF INTERFACE tsan) endif() if(LIEF_USAN) message(STATUS "Undefined sanitizer enabled") list(APPEND SANITIZER_FLAGS -fsanitize=undefined,null,alignment) set_property(TARGET LIB_LIEF APPEND PROPERTY LINK_FLAGS -fsanitize=undefined,null,alignment) target_link_options(LIB_LIEF PUBLIC -fsanitize=undefined,null,alignment) target_link_libraries(LIB_LIEF PUBLIC ubsan -fsanitize=undefined,null,alignment) endif() set(LIEF_SANITIZER OFF) if(LIEF_ASAN OR LIEF_LSAN OR LIEF_TSAN OR LIEF_USAN) set(LIEF_SANITIZER ON) endif() if(LIEF_SANITIZER) message("LIEF Sanitizer enabled: ${SANITIZER_FLAGS}") target_compile_options(LIB_LIEF PUBLIC ${SANITIZER_FLAGS}) add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/tests/sanitizer") endif() # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ # Fuzzing options # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ if(LIEF_FUZZING) set(FUZZING_FLAGS -fno-omit-frame-pointer -g -O2 -fsanitize=address,fuzzer-no-link) set(FUZZING_LINKER_FLAGS -fsanitize=address,fuzzer-no-link) set_property(TARGET LIB_LIEF APPEND PROPERTY LINK_FLAGS ${FUZZING_LINKER_FLAGS}) target_compile_options(LIB_LIEF PRIVATE ${FUZZING_FLAGS}) target_link_libraries(LIB_LIEF PUBLIC asan pthread) add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/fuzzing") endif() include(LIEFCompilerFlags) # Profiling flags # --------------- if(LIEF_PROFILING) add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/profiling") endif() # Coverage flags # -------------- if(LIEF_COVERAGE) target_compile_options(LIB_LIEF PRIVATE -g -O0 --coverage -fprofile-arcs -ftest-coverage) target_link_libraries(LIB_LIEF gcov) endif() set_target_properties(LIB_LIEF PROPERTIES OUTPUT_NAME LIEF EXPORT_NAME LIEF CLEAN_DIRECT_OUTPUT 1) # Set a default build type if none was specified if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) message(STATUS "Setting build type to 'Release' as none was specified.") set(CMAKE_BUILD_TYPE Release CACHE STRING "Choose the type of build." FORCE) # Set the possible values of build type for cmake-gui set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "MinSizeRel" "RelWithDebInfo") endif() message(STATUS "Configuration Types: ${CMAKE_CONFIGURATION_TYPES}") message(STATUS "Build Types: ${CMAKE_BUILD_TYPE}") if(APPLE) set_target_properties(LIB_LIEF PROPERTIES MACOSX_RPATH ON) endif() # API # ====================== include(LIEFApi) # Examples # ====================== if(LIEF_EXAMPLES) add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/examples") endif() # Tests # ====================== if(LIEF_TESTS) enable_testing() add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/tests") endif() # Documentation # ====================== if(LIEF_DOC) add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/doc) endif() # Post-build operations # ====================== if(BUILD_SHARED_LIBS AND CMAKE_BUILD_TYPE MATCHES "Release") if(UNIX AND NOT APPLE) add_custom_command( TARGET LIB_LIEF COMMENT "Strip LIEF shared library" POST_BUILD COMMAND ${CMAKE_STRIP} --strip-all $ ) endif() if(APPLE) add_custom_command( TARGET LIB_LIEF COMMENT "Strip LIEF shared library" POST_BUILD COMMAND ${CMAKE_STRIP} -x -S $ ) endif() endif() # Generate install target and package # ======================================= if (LIEF_INSTALL) # Find Package Config # ====================== configure_file( ${CMAKE_CURRENT_SOURCE_DIR}/cmake/LIEFConfig.cmake.in ${CMAKE_CURRENT_BINARY_DIR}/LIEFConfig.cmake @ONLY) write_basic_package_version_file( ${CMAKE_CURRENT_BINARY_DIR}/LIEFConfigVersion.cmake VERSION ${PROJECT_VERSION} COMPATIBILITY AnyNewerVersion) # Install Prefix # ====================== if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT AND UNIX) if(UNIX AND NOT APPLE) set(CMAKE_INSTALL_PREFIX "/usr" CACHE PATH "Install path prefix prepended on to install directories." FORCE) elseif(APPLE) set(CMAKE_INSTALL_PREFIX "/usr/local" CACHE PATH "" FORCE) endif() endif() # Installation # ====================== if(UNIX) include(GNUInstallDirs) set(CMAKE_INSTALL_LIBDIR "lib") else() if(WIN32) set(CMAKE_INSTALL_LIBDIR "lib") set(CMAKE_INSTALL_DATADIR "share") set(CMAKE_INSTALL_INCLUDEDIR "include") set(CMAKE_INSTALL_BINDIR "bin") set(CMAKE_INSTALL_DATAROOTDIR "share") message(STATUS "Setting installation destination on Windows to: ${CMAKE_INSTALL_PREFIX}") else() message(FATAL_ERROR "System not UNIX nor WIN32 - not implemented yet") endif() endif() install( TARGETS LIB_LIEF lief_spdlog EXPORT LIEFExport ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR} LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR} RUNTIME DESTINATION ${CMAKE_INSTALL_LIBDIR} COMPONENT libraries INCLUDES DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}) install( DIRECTORY ${LIEF_PUBLIC_INCLUDE_DIR} DESTINATION ${CMAKE_INSTALL_INCLUDEDIR} COMPONENT headers FILES_MATCHING REGEX "(.*).(hpp|h|def|inc)$") install( FILES ${CMAKE_CURRENT_BINARY_DIR}/LIEFConfig.cmake ${CMAKE_CURRENT_BINARY_DIR}/LIEFConfigVersion.cmake DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/LIEF/cmake COMPONENT config) install( FILES ${CMAKE_CURRENT_BINARY_DIR}/LIEF.pc DESTINATION ${CMAKE_INSTALL_LIBDIR}/pkgconfig COMPONENT libraries) if(BUILD_SHARED_LIBS) set(lib_type shared) else() set(lib_type static) endif() install( EXPORT LIEFExport NAMESPACE LIEF:: DESTINATION ${CMAKE_INSTALL_DATAROOTDIR}/LIEF/cmake FILE LIEFExport-${lib_type}.cmake COMPONENT config) export( EXPORT LIEFExport NAMESPACE LIEF:: FILE LIEFExport-${lib_type}.cmake) # Package # ====================== add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/package") endif() LIEF-0.13.1/LICENSE000066400000000000000000000261651443457337100133450ustar00rootroot00000000000000 Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "{}" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright 2017 - 2023 R. Thomas Copyright 2017 - 2023 Quarkslab Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. LIEF-0.13.1/README.md000066400000000000000000000172701443457337100136140ustar00rootroot00000000000000


  Linux x86-64 CI status   Linux AArch64 CI status   Android CI status   macOS CI status   iOS CI status   Windows CI status     Twitter Follow


Blog • Documentation • About


# About The purpose of this project is to provide a cross platform library which can parse, modify and abstract ELF, PE and MachO formats. Main features: * **Parsing**: LIEF can parse ELF, PE, MachO, OAT, DEX, VDEX, ART and provides an user-friendly API to access to format internals. * **Modify**: LIEF enables to modify some parts of these formats * **Abstract**: Three formats have common features like sections, symbols, entry point... LIEF factors them. * **API**: LIEF can be used in C, C++ and Python # Content - [About](#about) - [Download / Install](#downloads--install) - [Getting started](#getting-started) - [Documentation](#documentation) - [Sphinx](https://lief-project.github.io/doc/stable/index.html) - [Doxygen](https://lief-project.github.io/doc/latest/doxygen/index.html) - Tutorials: - [Parse and manipulate formats](https://lief-project.github.io/doc/latest/tutorials/01_play_with_formats.html) - [Create a PE from scratch](https://lief-project.github.io/doc/latest/tutorials/02_pe_from_scratch.html) - [Play with ELF symbols](https://lief-project.github.io/doc/latest/tutorials/03_elf_change_symbols.html) - [ELF Hooking](https://lief-project.github.io/doc/latest/tutorials/04_elf_hooking.html) - [Infecting the plt/got](https://lief-project.github.io/doc/latest/tutorials/05_elf_infect_plt_got.html) - [PE Hooking](https://lief-project.github.io/doc/latest/tutorials/06_pe_hooking.html) - [PE Resources](https://lief-project.github.io/doc/latest/tutorials/07_pe_resource.html) - [Transforming an ELF executable into a library](https://lief-project.github.io/doc/latest/tutorials/08_elf_bin2lib.html) - [How to use frida on a non-rooted device](https://lief-project.github.io/doc/latest/tutorials/09_frida_lief.html) - [Android formats](https://lief-project.github.io/doc/latest/tutorials/10_android_formats.html) - [Mach-O modification](https://lief-project.github.io/doc/latest/tutorials/11_macho_modification.html) - [ELF Coredump](https://lief-project.github.io/doc/latest/tutorials/12_elf_coredump.html) - [PE Authenticode](https://lief-project.github.io/doc/latest/tutorials/13_pe_authenticode.html) - [Contact](#contact) - [About](#about) - [Authors](#authors) - [License](#license) - [Bibtex](#bibtex) ## Downloads / Install First, make sure to have an updated version of setuptools: ```console pip install setuptools --upgrade ``` To install the latest **version** (release): ```console pip install lief ``` To install nightly build: ```console pip install [--user] --index-url https://lief.s3-website.fr-par.scw.cloud/latest lief==0.13.0.dev0 ``` ### Packages - **Nightly**: * SDK: https://lief.s3-website.fr-par.scw.cloud/latest/sdk * Python Wheels: https://lief.s3-website.fr-par.scw.cloud/latest/lief - **v0.12.3**: https://github.com/lief-project/LIEF/releases/tag/0.12.3 Here are guides to install or integrate LIEF: * [Python](https://lief-project.github.io/doc/latest/installation.html#python) * [VisualStudio](https://lief-project.github.io/doc/latest/installation.html#visual-studio-integration) * [XCode](https://lief-project.github.io/doc/latest/installation.html#xcode-integration) * [CMake](https://lief-project.github.io/doc/latest/installation.html#cmake-integration) ## Getting started ### Python ```python import lief # ELF binary = lief.parse("/usr/bin/ls") print(binary) # PE binary = lief.parse("C:\\Windows\\explorer.exe") print(binary) # Mach-O binary = lief.parse("/usr/bin/ls") print(binary) ``` ### C++ ```cpp #include int main(int argc, char** argv) { // ELF if (std::unique_ptr elf = LIEF::ELF::Parser::parse("/bin/ls")) { std::cout << *elf << '\n'; } // PE if (std::unique_ptr pe = LIEF::PE::Parser::parse("C:\\Windows\\explorer.exe")) { std::cout << *pe << '\n'; } // Mach-O if (std::unique_ptr macho = LIEF::MachO::Parser::parse("/bin/ls")) { std::cout << *macho << '\n'; } return 0; } ``` ### C (Limited API) ```cpp #include int main(int argc, char** argv) { Elf_Binary_t* elf = elf_parse("/usr/bin/ls"); Elf_Section_t** sections = elf->sections; for (size_t i = 0; sections[i] != NULL; ++i) { printf("%s\n", sections[i]->name); } elf_binary_destroy(elf); return 0; } ``` ## Documentation * [Main documentation](https://lief-project.github.io/doc/latest/index.html) * [Tutorial](https://lief-project.github.io/doc/latest/tutorials/index.html) * [API](https://lief-project.github.io/doc/latest/api/index.html) * [Doxygen](https://lief-project.github.io/doc/latest/doxygen/index.html) ## Contact * **Mail**: contact at lief re * **Gitter**: [lief-project](https://gitter.im/lief-project) ## About ### Authors Romain Thomas ([@rh0main](https://twitter.com/rh0main)) - [Quarkslab](https://www.quarkslab.com) ### License LIEF is provided under the [Apache 2.0 license](https://github.com/lief-project/LIEF/blob/0.12.3/LICENSE). ### Bibtex ```bibtex @MISC {LIEF, author = "Romain Thomas", title = "LIEF - Library to Instrument Executable Formats", howpublished = "https://lief.quarkslab.com/", month = "apr", year = "2017" } ``` LIEF-0.13.1/api/000077500000000000000000000000001443457337100130775ustar00rootroot00000000000000LIEF-0.13.1/api/c/000077500000000000000000000000001443457337100133215ustar00rootroot00000000000000LIEF-0.13.1/api/c/CMakeLists.txt000066400000000000000000000016431443457337100160650ustar00rootroot00000000000000include_directories( "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF" "${CMAKE_CURRENT_SOURCE_DIR}/include" ) set(LIEF_C_INCLUDE_FILES "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/LIEF.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/logging.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/types.h" ) set(LIEF_C_SRC "${CMAKE_CURRENT_LIST_DIR}/logging.cpp") if (LIEF_ELF) include("${CMAKE_CURRENT_LIST_DIR}/ELF/CMakeLists.txt") endif() if (LIEF_PE) include("${CMAKE_CURRENT_LIST_DIR}/PE/CMakeLists.txt") endif() if (LIEF_MACHO) include("${CMAKE_CURRENT_LIST_DIR}/MachO/CMakeLists.txt") endif() source_group("Header Files\\C API" FILES ${LIEF_C_INCLUDE_FILES}) target_sources(LIB_LIEF PRIVATE "${LIEF_C_SRC}" ${LIEF_C_INCLUDE_FILES}) LIEF-0.13.1/api/c/ELF/000077500000000000000000000000001443457337100137275ustar00rootroot00000000000000LIEF-0.13.1/api/c/ELF/Binary.cpp000066400000000000000000000073251443457337100156660ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Section.h" #include "LIEF/ELF/Segment.h" #include "LIEF/ELF/Header.h" #include "LIEF/ELF/Symbol.h" #include "LIEF/ELF/Parser.hpp" #include "LIEF/ELF/Binary.hpp" #include "Section.hpp" #include "Segment.hpp" #include "DynamicEntry.hpp" #include "Symbol.hpp" #include "Header.hpp" #include "Binary.hpp" using namespace LIEF::ELF; namespace LIEF { namespace ELF { void init_c_binary(Elf_Binary_t* c_binary, Binary* binary) { c_binary->handler = reinterpret_cast(binary); c_binary->name = binary->name().c_str(); c_binary->type = static_cast(binary->type()); c_binary->interpreter = nullptr; if (binary->has_interpreter()) { const std::string& interp = binary->interpreter(); c_binary->interpreter = static_cast(malloc((interp.size() + 1) * sizeof(char))); std::memcpy( reinterpret_cast(const_cast(c_binary->interpreter)), reinterpret_cast(interp.data()), interp.size()); reinterpret_cast(const_cast(c_binary->interpreter))[interp.size()] = '\0'; } init_c_header(c_binary, binary); init_c_sections(c_binary, binary); init_c_segments(c_binary, binary); init_c_dynamic_symbols(c_binary, binary); init_c_static_symbols(c_binary, binary); init_c_dynamic_entries(c_binary, binary); } } } Elf_Binary_t* elf_parse(const char *file) { Binary* binary = Parser::parse(file).release(); if (binary == nullptr) { return nullptr; } auto* c_binary = static_cast(malloc(sizeof(Elf_Binary_t))); memset(c_binary, 0, sizeof(Elf_Binary_t)); init_c_binary(c_binary, binary); return c_binary; } // Binary Methods // ============== int elf_binary_save_header(Elf_Binary_t* binary) { Header& hdr = reinterpret_cast(binary->handler)->header(); hdr.file_type(static_cast(binary->header.file_type)); hdr.machine_type(static_cast(binary->header.machine_type)); hdr.object_file_version(static_cast(binary->header.object_file_version)); hdr.program_headers_offset(binary->header.program_headers_offset); hdr.section_headers_offset(binary->header.section_headers_offset); hdr.processor_flag(binary->header.processor_flags); hdr.header_size(binary->header.header_size); hdr.program_header_size(binary->header.program_header_size); hdr.numberof_segments(binary->header.numberof_segments); hdr.section_header_size(binary->header.section_header_size); hdr.numberof_sections(binary->header.numberof_sections); hdr.section_name_table_idx(binary->header.name_string_table_idx); hdr.entrypoint(binary->header.entrypoint); //TODO: identity return 1; } void elf_binary_destroy(Elf_Binary_t* binary) { destroy_sections(binary); destroy_segments(binary); destroy_dynamic_symbols(binary); destroy_static_symbols(binary); destroy_dynamic_entries(binary); if (binary->interpreter != nullptr) { free(const_cast(binary->interpreter)); } delete reinterpret_cast(binary->handler); free(binary); } //} LIEF-0.13.1/api/c/ELF/Binary.hpp000066400000000000000000000015471443457337100156730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_ELF_BINARY_CPP_C_API_ #define LIEF_ELF_BINARY_CPP_C_API_ #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Binary.hpp" namespace LIEF { namespace ELF { void init_c_binary(Elf_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/ELF/CMakeLists.txt000066400000000000000000000032401443457337100164660ustar00rootroot00000000000000include_directories( "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF" "${CMAKE_CURRENT_SOURCE_DIR}/include" ) set(LIEF_C_ELF_SRC "${CMAKE_CURRENT_LIST_DIR}/Symbol.cpp" "${CMAKE_CURRENT_LIST_DIR}/Section.cpp" "${CMAKE_CURRENT_LIST_DIR}/Segment.cpp" "${CMAKE_CURRENT_LIST_DIR}/DynamicEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/Header.cpp" "${CMAKE_CURRENT_LIST_DIR}/Binary.cpp" "${CMAKE_CURRENT_LIST_DIR}/EnumToString.cpp" "${CMAKE_CURRENT_LIST_DIR}/utils.cpp" ) set(LIEF_API_C_ELF_INCLUDE_FILES_CPP "${CMAKE_CURRENT_LIST_DIR}/Binary.hpp" "${CMAKE_CURRENT_LIST_DIR}/DynamicEntry.hpp" "${CMAKE_CURRENT_LIST_DIR}/Header.hpp" "${CMAKE_CURRENT_LIST_DIR}/Section.hpp" "${CMAKE_CURRENT_LIST_DIR}/Segment.hpp" "${CMAKE_CURRENT_LIST_DIR}/Symbol.hpp" ) set(LIEF_API_C_ELF_INCLUDE_FILES_C "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/Binary.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/DynamicEntry.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/EnumToString.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/Header.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/Section.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/Segment.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/Symbol.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/enums.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/ELF/utils.h" ) set(LIEF_C_ELF_INC "${LIEF_API_C_ELF_INCLUDE_FILES_C}" "${LIEF_API_C_ELF_INCLUDE_FILES_CPP}") source_group("Source Files\\C API\\ELF" FILES ${LIEF_API_C_ELF_SRC}) source_group("Header Files\\C API\\ELF" FILES ${LIEF_C_ELF_INC}) target_sources(LIB_LIEF PRIVATE "${LIEF_C_ELF_SRC}" "${LIEF_C_ELF_INC}") LIEF-0.13.1/api/c/ELF/DynamicEntry.cpp000066400000000000000000000200511443457337100170370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "DynamicEntry.hpp" #include "LIEF/ELF/DynamicEntryFlags.hpp" #include "LIEF/ELF/DynamicSharedObject.hpp" #include "LIEF/ELF/DynamicEntryLibrary.hpp" #include "LIEF/ELF/DynamicEntryRpath.hpp" #include "LIEF/ELF/DynamicEntryRunPath.hpp" #include "LIEF/ELF/DynamicEntryArray.hpp" namespace LIEF { namespace ELF { void init_c_dynamic_entries(Elf_Binary_t* c_binary, Binary* binary) { Binary::it_dynamic_entries dyn_entries = binary->dynamic_entries(); c_binary->dynamic_entries = static_cast( malloc((dyn_entries.size() + 1) * sizeof(Elf_DynamicEntry_t**))); for (size_t i = 0; i < dyn_entries.size(); ++i) { DynamicEntry& entry = dyn_entries[i]; switch(entry.tag()) { case DYNAMIC_TAGS::DT_NEEDED: { auto* e = static_cast( malloc(sizeof(Elf_DynamicEntry_Library_t))); e->tag = static_cast(entry.tag()); e->value = entry.value(); e->name = reinterpret_cast(&entry)->name().c_str(); c_binary->dynamic_entries[i] = reinterpret_cast(e); break; } case DYNAMIC_TAGS::DT_SONAME: { auto* e = static_cast( malloc(sizeof(Elf_DynamicEntry_SharedObject_t))); e->tag = static_cast(entry.tag()); e->value = entry.value(); e->name = reinterpret_cast(&entry)->name().c_str(); c_binary->dynamic_entries[i] = reinterpret_cast(e); break; } case DYNAMIC_TAGS::DT_RPATH: { auto* e = static_cast( malloc(sizeof(Elf_DynamicEntry_Rpath_t))); e->tag = static_cast(entry.tag()); e->value = entry.value(); e->rpath = reinterpret_cast(&entry)->name().c_str(); c_binary->dynamic_entries[i] = reinterpret_cast(e); break; } case DYNAMIC_TAGS::DT_RUNPATH: { auto* e = static_cast( malloc(sizeof(Elf_DynamicEntry_RunPath_t))); e->tag = static_cast(entry.tag()); e->value = entry.value(); e->runpath = reinterpret_cast(&entry)->name().c_str(); c_binary->dynamic_entries[i] = reinterpret_cast(e); break; } case DYNAMIC_TAGS::DT_INIT_ARRAY: case DYNAMIC_TAGS::DT_FINI_ARRAY: case DYNAMIC_TAGS::DT_PREINIT_ARRAY: { auto* e = static_cast( malloc(sizeof(Elf_DynamicEntry_Array_t))); e->tag = static_cast(entry.tag()); e->value = entry.value(); const std::vector& array = reinterpret_cast(&entry)->array(); e->array = static_cast(malloc((array.size() + 1) * sizeof(uint64_t))); for (size_t i = 0; i < array.size(); ++i) { e->array[i] = array[i]; } e->array[array.size()] = 0; c_binary->dynamic_entries[i] = reinterpret_cast(e); break; } case DYNAMIC_TAGS::DT_FLAGS: { auto* e = static_cast( malloc(sizeof(Elf_DynamicEntry_Flags_t))); e->tag = static_cast(entry.tag()); e->value = entry.value(); const DynamicEntryFlags::flags_list_t& flags = reinterpret_cast(&entry)->flags(); e->flags = static_cast(malloc((flags.size() + 1) * sizeof(enum LIEF_ELF_DYNAMIC_FLAGS))); e->flags_1 = nullptr; auto it = std::begin(flags); for (size_t i = 0; it != std::end(flags); ++i, ++it) { e->flags[i] = static_cast(*it); } e->flags[flags.size()] = static_cast(0); c_binary->dynamic_entries[i] = reinterpret_cast(e); break; } case DYNAMIC_TAGS::DT_FLAGS_1: { auto* e = static_cast( malloc(sizeof(Elf_DynamicEntry_Flags_t))); e->tag = static_cast(entry.tag()); e->value = entry.value(); const DynamicEntryFlags::flags_list_t& flags = reinterpret_cast(&entry)->flags(); e->flags_1 = static_cast(malloc((flags.size() + 1) * sizeof(enum LIEF_ELF_DYNAMIC_FLAGS_1))); e->flags = nullptr; auto it = std::begin(flags); for (size_t i = 0; it != std::end(flags); ++i, ++it) { e->flags_1[i] = static_cast(*it); } e->flags_1[flags.size()] = static_cast(0); c_binary->dynamic_entries[i] = reinterpret_cast(e); break; } default: { c_binary->dynamic_entries[i] = static_cast(malloc(sizeof(Elf_DynamicEntry_t))); c_binary->dynamic_entries[i]->tag = static_cast(entry.tag()); c_binary->dynamic_entries[i]->value = entry.value(); break; } } } c_binary->dynamic_entries[dyn_entries.size()] = nullptr; } void destroy_dynamic_entries(Elf_Binary_t* c_binary) { Elf_DynamicEntry_t **dynamic_entries = c_binary->dynamic_entries; for (size_t idx = 0; dynamic_entries[idx] != nullptr; ++idx) { switch(static_cast(dynamic_entries[idx]->tag)) { case DYNAMIC_TAGS::DT_NEEDED: { free(reinterpret_cast(dynamic_entries[idx])); break; } case DYNAMIC_TAGS::DT_SONAME: { free(reinterpret_cast(dynamic_entries[idx])); break; } case DYNAMIC_TAGS::DT_RPATH: { free(reinterpret_cast(dynamic_entries[idx])); break; } case DYNAMIC_TAGS::DT_RUNPATH: { free(reinterpret_cast(dynamic_entries[idx])); break; } case DYNAMIC_TAGS::DT_INIT_ARRAY: case DYNAMIC_TAGS::DT_FINI_ARRAY: case DYNAMIC_TAGS::DT_PREINIT_ARRAY: { Elf_DynamicEntry_Array_t* entry_array=reinterpret_cast(dynamic_entries[idx]); free(entry_array->array); free(entry_array); break; } case DYNAMIC_TAGS::DT_FLAGS: { Elf_DynamicEntry_Flags_t* entry_flags=reinterpret_cast(dynamic_entries[idx]); free(entry_flags->flags); free(entry_flags); break; } case DYNAMIC_TAGS::DT_FLAGS_1: { Elf_DynamicEntry_Flags_t* entry_flags=reinterpret_cast(dynamic_entries[idx]); free(entry_flags->flags_1); free(entry_flags); break; } default: { free(dynamic_entries[idx]); } } } free(c_binary->dynamic_entries); } } } LIEF-0.13.1/api/c/ELF/DynamicEntry.hpp000066400000000000000000000017751443457337100170600ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_ELF_DYNAMIC_ENTRY_CPP_C_API_ #define LIEF_ELF_DYNAMIC_ENTRY_CPP_C_API_ #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Binary.hpp" #include "LIEF/ELF/DynamicEntry.h" #include "LIEF/ELF/DynamicEntry.hpp" namespace LIEF { namespace ELF { void init_c_dynamic_entries(Elf_Binary_t* c_binary, Binary* binary); void destroy_dynamic_entries(Elf_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/ELF/EnumToString.cpp000066400000000000000000000054051443457337100170350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/ELF/EnumToString.h" #include "LIEF/ELF/EnumToString.hpp" #include "LIEF/ELF/enums.h" #include "LIEF/ELF/enums.hpp" extern "C" { const char* E_TYPE_to_string(enum LIEF_ELF_E_TYPE e) { return LIEF::ELF::to_string(static_cast(e)); } const char* SYMBOL_BINDINGS_to_string(enum LIEF_ELF_SYMBOL_BINDINGS e) { return LIEF::ELF::to_string(static_cast(e)); } const char* VERSION_to_string(enum LIEF_ELF_VERSION e) { return LIEF::ELF::to_string(static_cast(e)); } const char* ARCH_to_string(enum LIEF_ELF_ARCH e) { return LIEF::ELF::to_string(static_cast(e)); } const char* SEGMENT_TYPES_to_string(enum LIEF_ELF_SEGMENT_TYPES e) { return LIEF::ELF::to_string(static_cast(e)); } const char* DYNAMIC_TAGS_to_string(enum LIEF_ELF_DYNAMIC_TAGS e) { return LIEF::ELF::to_string(static_cast(e)); } const char* ELF_SECTION_TYPES_to_string(enum LIEF_ELF_ELF_SECTION_TYPES e) { return LIEF::ELF::to_string(static_cast(e)); } const char* ELF_SECTION_FLAGS_to_string(enum LIEF_ELF_ELF_SECTION_FLAGS e) { return LIEF::ELF::to_string(static_cast(e)); } const char* ELF_SYMBOL_TYPES_to_string(enum LIEF_ELF_ELF_SYMBOL_TYPES e) { return LIEF::ELF::to_string(static_cast(e)); } const char* ELF_CLASS_to_string(enum LIEF_ELF_ELF_CLASS e) { return LIEF::ELF::to_string(static_cast(e)); } const char* ELF_DATA_to_string(enum LIEF_ELF_ELF_DATA e) { return LIEF::ELF::to_string(static_cast(e)); } const char* OS_ABI_to_string(enum LIEF_ELF_OS_ABI e) { return LIEF::ELF::to_string(static_cast(e)); } const char* DYNAMIC_FLAGS_to_string(enum LIEF_ELF_DYNAMIC_FLAGS e) { return LIEF::ELF::to_string(static_cast(e)); } const char* DYNAMIC_FLAGS_1_to_string(enum LIEF_ELF_DYNAMIC_FLAGS_1 e) { return LIEF::ELF::to_string(static_cast(e)); } } LIEF-0.13.1/api/c/ELF/Header.cpp000066400000000000000000000036611443457337100156310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Header.hpp" namespace LIEF { namespace ELF { void init_c_header(Elf_Binary_t* c_binary, Binary* binary) { const Header& hdr = binary->header(); c_binary->header.file_type = static_cast(hdr.file_type()); c_binary->header.machine_type = static_cast(hdr.machine_type()); c_binary->header.object_file_version = static_cast(hdr.object_file_version()); c_binary->header.program_headers_offset = hdr.program_headers_offset(); c_binary->header.section_headers_offset = hdr.section_headers_offset(); c_binary->header.processor_flags = hdr.processor_flag(); c_binary->header.header_size = hdr.header_size(); c_binary->header.program_header_size = hdr.program_header_size(); c_binary->header.numberof_segments = hdr.numberof_segments(); c_binary->header.section_header_size = hdr.section_header_size(); c_binary->header.numberof_sections = hdr.numberof_sections(); c_binary->header.name_string_table_idx = hdr.section_name_table_idx(); c_binary->header.entrypoint = hdr.entrypoint(); const Header::identity_t& ident = hdr.identity(); std::copy( std::begin(ident), std::end(ident), c_binary->header.identity); } } } LIEF-0.13.1/api/c/ELF/Header.hpp000066400000000000000000000016441443457337100156350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_ELF_HEADER_CPP_C_API_ #define LIEF_ELF_HEADER_CPP_C_API_ #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Binary.hpp" #include "LIEF/ELF/Header.h" #include "LIEF/ELF/Header.hpp" namespace LIEF { namespace ELF { void init_c_header(Elf_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/ELF/Section.cpp000066400000000000000000000046701443457337100160460ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Section.hpp" namespace LIEF { namespace ELF { void init_c_sections(Elf_Binary_t* c_binary, Binary* binary) { Binary::it_sections sections = binary->sections(); c_binary->sections = static_cast( malloc((sections.size() + 1) * sizeof(Elf_Section_t**))); for (size_t i = 0; i < sections.size(); ++i) { Section& b_section = sections[i]; c_binary->sections[i] = static_cast(malloc(sizeof(Elf_Section_t))); span section_content = b_section.content(); c_binary->sections[i]->name = b_section.fullname().c_str(); c_binary->sections[i]->flags = b_section.flags(); c_binary->sections[i]->type = static_cast(b_section.type()); c_binary->sections[i]->virtual_address = b_section.virtual_address(); c_binary->sections[i]->offset = b_section.file_offset(); c_binary->sections[i]->original_size = b_section.original_size(); c_binary->sections[i]->link = b_section.link(); c_binary->sections[i]->info = b_section.information(); c_binary->sections[i]->alignment = b_section.alignment(); c_binary->sections[i]->entry_size = b_section.entry_size(); c_binary->sections[i]->size = section_content.size(); c_binary->sections[i]->entropy = b_section.entropy(); c_binary->sections[i]->content = !section_content.empty() ? const_cast(section_content.data()) : nullptr; } c_binary->sections[sections.size()] = nullptr; } void destroy_sections(Elf_Binary_t* c_binary) { Elf_Section_t **sections = c_binary->sections; for (size_t idx = 0; sections[idx] != nullptr; ++idx) { free(sections[idx]); } free(c_binary->sections); } } } LIEF-0.13.1/api/c/ELF/Section.hpp000066400000000000000000000017311443457337100160460ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_ELF_SECTION_CPP_C_API_ #define LIEF_ELF_SECTION_CPP_C_API_ #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Binary.hpp" #include "LIEF/ELF/Section.h" #include "LIEF/ELF/Section.hpp" namespace LIEF { namespace ELF { void init_c_sections(Elf_Binary_t* c_binary, Binary* binary); void destroy_sections(Elf_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/ELF/Segment.cpp000066400000000000000000000041441443457337100160400ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Segment.hpp" namespace LIEF { namespace ELF { void init_c_segments(Elf_Binary_t* c_binary, Binary* binary) { Binary::it_segments segments = binary->segments(); c_binary->segments = static_cast( malloc((segments.size() + 1) * sizeof(Elf_Segment_t**))); for (size_t i = 0; i < segments.size(); ++i) { Segment& segment = segments[i]; span segment_content = segment.content(); c_binary->segments[i] = static_cast(malloc(sizeof(Elf_Segment_t))); c_binary->segments[i]->type = static_cast(segment.type()); c_binary->segments[i]->flags = static_cast(segment.flags()); c_binary->segments[i]->virtual_address = segment.virtual_address(); c_binary->segments[i]->virtual_size = segment.virtual_size(); c_binary->segments[i]->offset = segment.file_offset(); c_binary->segments[i]->alignment = segment.alignment(); c_binary->segments[i]->size = segment_content.size(); c_binary->segments[i]->content = !segment_content.empty() ? const_cast(segment_content.data()) : nullptr; } c_binary->segments[segments.size()] = nullptr; } void destroy_segments(Elf_Binary_t* c_binary) { Elf_Segment_t **segments = c_binary->segments; for (size_t idx = 0; segments[idx] != nullptr; ++idx) { free(segments[idx]); } free(c_binary->segments); } } } LIEF-0.13.1/api/c/ELF/Segment.hpp000066400000000000000000000017311443457337100160440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_ELF_SEGMENT_CPP_C_API_ #define LIEF_ELF_SEGMENT_CPP_C_API_ #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Binary.hpp" #include "LIEF/ELF/Segment.h" #include "LIEF/ELF/Segment.hpp" namespace LIEF { namespace ELF { void init_c_segments(Elf_Binary_t* c_binary, Binary* binary); void destroy_segments(Elf_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/ELF/Symbol.cpp000066400000000000000000000071731443457337100157100ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Symbol.hpp" namespace LIEF { namespace ELF { void init_c_dynamic_symbols(Elf_Binary_t* c_binary, Binary* binary) { Binary::it_dynamic_symbols dyn_symb = binary->dynamic_symbols(); c_binary->dynamic_symbols = static_cast( malloc((dyn_symb.size() + 1) * sizeof(Elf_Symbol_t**))); for (size_t i = 0; i < dyn_symb.size(); ++i) { Symbol& b_sym = dyn_symb[i]; c_binary->dynamic_symbols[i] = static_cast(malloc(sizeof(Elf_Symbol_t))); c_binary->dynamic_symbols[i]->name = b_sym.name().c_str(); c_binary->dynamic_symbols[i]->type = static_cast(b_sym.type()); c_binary->dynamic_symbols[i]->binding = static_cast(b_sym.binding()); c_binary->dynamic_symbols[i]->other = b_sym.other(); c_binary->dynamic_symbols[i]->shndx = b_sym.shndx(); c_binary->dynamic_symbols[i]->value = b_sym.value(); c_binary->dynamic_symbols[i]->size = b_sym.size(); c_binary->dynamic_symbols[i]->information = b_sym.information(); c_binary->dynamic_symbols[i]->is_exported = b_sym.is_exported(); c_binary->dynamic_symbols[i]->is_imported = b_sym.is_imported(); } c_binary->dynamic_symbols[dyn_symb.size()] = nullptr; } void init_c_static_symbols(Elf_Binary_t* c_binary, Binary* binary) { Binary::it_static_symbols static_symb = binary->static_symbols(); c_binary->static_symbols = static_cast( malloc((static_symb.size() + 1) * sizeof(Elf_Symbol_t**))); for (size_t i = 0; i < static_symb.size(); ++i) { Symbol& b_sym = static_symb[i]; c_binary->static_symbols[i] = static_cast(malloc(sizeof(Elf_Symbol_t))); c_binary->static_symbols[i]->name = b_sym.name().c_str(); c_binary->static_symbols[i]->type = static_cast(b_sym.type()); c_binary->static_symbols[i]->binding = static_cast(b_sym.binding()); c_binary->static_symbols[i]->other = b_sym.other(); c_binary->static_symbols[i]->shndx = b_sym.shndx(); c_binary->static_symbols[i]->value = b_sym.value(); c_binary->static_symbols[i]->size = b_sym.size(); c_binary->static_symbols[i]->information = b_sym.information(); c_binary->static_symbols[i]->is_exported = b_sym.is_exported(); c_binary->static_symbols[i]->is_imported = b_sym.is_imported(); } c_binary->static_symbols[static_symb.size()] = nullptr; } void destroy_dynamic_symbols(Elf_Binary_t* c_binary) { Elf_Symbol_t **dynamic_symbols = c_binary->dynamic_symbols; for (size_t idx = 0; dynamic_symbols[idx] != nullptr; ++idx) { free(dynamic_symbols[idx]); } free(c_binary->dynamic_symbols); } void destroy_static_symbols(Elf_Binary_t* c_binary) { Elf_Symbol_t **static_symbols = c_binary->static_symbols; for (size_t idx = 0; static_symbols[idx] != nullptr; ++idx) { free(static_symbols[idx]); } free(c_binary->static_symbols); } } } LIEF-0.13.1/api/c/ELF/Symbol.hpp000066400000000000000000000021351443457337100157060ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_ELF_SYMBOL_CPP_C_API_ #define LIEF_ELF_SYMBOL_CPP_C_API_ #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Binary.hpp" #include "LIEF/ELF/Symbol.h" #include "LIEF/ELF/Symbol.hpp" namespace LIEF { namespace ELF { void init_c_dynamic_symbols(Elf_Binary_t* c_binary, Binary* binary); void init_c_static_symbols(Elf_Binary_t* c_binary, Binary* binary); void destroy_dynamic_symbols(Elf_Binary_t* c_binary); void destroy_static_symbols(Elf_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/ELF/utils.cpp000066400000000000000000000013701443457337100155740ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/ELF/utils.hpp" #include "LIEF/ELF/utils.h" bool is_elf(const char* file) { return LIEF::ELF::is_elf(file); } LIEF-0.13.1/api/c/MachO/000077500000000000000000000000001443457337100143105ustar00rootroot00000000000000LIEF-0.13.1/api/c/MachO/Binary.cpp000066400000000000000000000031741443457337100162450ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Binary.hpp" #include "Binary.hpp" #include "Section.hpp" #include "Header.hpp" #include "Symbol.hpp" #include "Segment.hpp" #include "LoadCommand.hpp" using namespace LIEF::MachO; namespace LIEF { namespace MachO { void init_c_binary(Macho_Binary_t* c_binary, Binary* binary) { c_binary->handler = reinterpret_cast(binary); c_binary->name = binary->name().c_str(); c_binary->imagebase = binary->imagebase(); init_c_header(c_binary, binary); init_c_commands(c_binary, binary); init_c_symbols(c_binary, binary); init_c_sections(c_binary, binary); init_c_segments(c_binary, binary); } } } void macho_binaries_destroy(Macho_Binary_t** binaries) { for (size_t i = 0; binaries[i] != nullptr; ++i) { destroy_sections(binaries[i]); destroy_commands(binaries[i]); destroy_symbols(binaries[i]); destroy_segments(binaries[i]); delete reinterpret_cast(binaries[i]->handler); free(binaries[i]); } free(binaries); } LIEF-0.13.1/api/c/MachO/Binary.hpp000066400000000000000000000015631443457337100162520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_MACHO_BINARY_CPP_C_API_ #define LIEF_MACHO_BINARY_CPP_C_API_ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Binary.hpp" namespace LIEF { namespace MachO { void init_c_binary(Macho_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/MachO/CMakeLists.txt000066400000000000000000000032171443457337100170530ustar00rootroot00000000000000include_directories( "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF" "${CMAKE_CURRENT_SOURCE_DIR}/include" ) set(LIEF_API_C_MACHO_SRC "${CMAKE_CURRENT_LIST_DIR}/EnumToString.cpp" "${CMAKE_CURRENT_LIST_DIR}/Parser.cpp" "${CMAKE_CURRENT_LIST_DIR}/LoadCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/Segment.cpp" "${CMAKE_CURRENT_LIST_DIR}/Symbol.cpp" "${CMAKE_CURRENT_LIST_DIR}/Section.cpp" "${CMAKE_CURRENT_LIST_DIR}/Header.cpp" "${CMAKE_CURRENT_LIST_DIR}/Binary.cpp" ) set(LIEF_API_C_MACHO_INCLUDE_FILES_CPP "${CMAKE_CURRENT_LIST_DIR}/Header.hpp" "${CMAKE_CURRENT_LIST_DIR}/Binary.hpp" "${CMAKE_CURRENT_LIST_DIR}/LoadCommand.hpp" "${CMAKE_CURRENT_LIST_DIR}/Section.hpp" "${CMAKE_CURRENT_LIST_DIR}/Segment.hpp" "${CMAKE_CURRENT_LIST_DIR}/Symbol.hpp" ) set(LIEF_API_C_MACHO_INCLUDE_FILES_C "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/enums.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/Binary.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/EnumToString.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/Header.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/LoadCommand.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/Section.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/Segment.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/MachO/Symbol.h" ) set(LIEF_C_MACHO_INC "${LIEF_API_C_MACHO_INCLUDE_FILES_C}" "${LIEF_API_C_MACHO_INCLUDE_FILES_CPP}") source_group("Source Files\\C API\\MachO" FILES ${LIEF_API_C_MACHO_SRC}) source_group("Header Files\\C API\\MachO" FILES ${LIEF_C_MACHO_INC}) target_sources(LIB_LIEF PRIVATE "${LIEF_API_C_MACHO_SRC}" ${LIEF_C_MACHO_INC}) LIEF-0.13.1/api/c/MachO/EnumToString.cpp000066400000000000000000000042231443457337100174130ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/MachO/EnumToString.h" #include "LIEF/MachO/EnumToString.hpp" #include "LIEF/MachO/enums.hpp" #include "LIEF/MachO/enums.h" extern "C" { const char* LOAD_COMMAND_TYPES_to_string(enum LIEF_MACHO_LOAD_COMMAND_TYPES e) { return LIEF::MachO::to_string(static_cast(e)); } const char* MACHO_TYPES_to_string(enum LIEF_MACHO_MACHO_TYPES e) { return LIEF::MachO::to_string(static_cast(e)); } const char* FILE_TYPES_to_string(enum LIEF_MACHO_FILE_TYPES e) { return LIEF::MachO::to_string(static_cast(e)); } const char* CPU_TYPES_to_string(enum LIEF_MACHO_CPU_TYPES e) { return LIEF::MachO::to_string(static_cast(e)); } const char* HEADER_FLAGS_to_string(enum LIEF_MACHO_HEADER_FLAGS e) { return LIEF::MachO::to_string(static_cast(e)); } const char* MACHO_SECTION_TYPES_to_string(enum LIEF_MACHO_MACHO_SECTION_TYPES e) { return LIEF::MachO::to_string(static_cast(e)); } const char* MACHO_SYMBOL_TYPES_to_string(enum LIEF_MACHO_MACHO_SYMBOL_TYPES e) { return LIEF::MachO::to_string(static_cast(e)); } const char* N_LIST_TYPES_to_string(enum LIEF_MACHO_N_LIST_TYPES e) { return LIEF::MachO::to_string(static_cast(e)); } const char* SYMBOL_DESCRIPTIONS_to_string(enum LIEF_MACHO_SYMBOL_DESCRIPTIONS e) { return LIEF::MachO::to_string(static_cast(e)); } } LIEF-0.13.1/api/c/MachO/Header.cpp000066400000000000000000000024451443457337100162110ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Header.hpp" namespace LIEF { namespace MachO { void init_c_header(Macho_Binary_t* c_binary, Binary* binary) { Header& header = binary->header(); c_binary->header.magic = static_cast(header.magic()); c_binary->header.cpu_type = static_cast(header.cpu_type()); c_binary->header.cpu_subtype = header.cpu_subtype(); c_binary->header.file_type = static_cast(header.file_type()); c_binary->header.nb_cmds = header.nb_cmds(); c_binary->header.sizeof_cmds = header.sizeof_cmds(); c_binary->header.flags = header.flags(); c_binary->header.reserved = header.reserved(); } } } LIEF-0.13.1/api/c/MachO/Header.hpp000066400000000000000000000016641443457337100162200ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_MACHO_HEADER_CPP_C_API_ #define LIEF_MACHO_HEADER_CPP_C_API_ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/Header.h" #include "LIEF/MachO/Header.hpp" namespace LIEF { namespace MachO { void init_c_header(Macho_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/MachO/LoadCommand.cpp000066400000000000000000000036131443457337100171750ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LoadCommand.hpp" namespace LIEF { namespace MachO { void init_c_commands(Macho_Binary_t* c_binary, Binary* binary) { Binary::it_commands commands = binary->commands(); c_binary->commands = static_cast( malloc((commands.size() + 1) * sizeof(Macho_Command_t**))); for (size_t i = 0; i < commands.size(); ++i) { LoadCommand& cmd = commands[i]; c_binary->commands[i] = static_cast(malloc(sizeof(Macho_Command_t))); const std::vector& cmd_content = cmd.data(); auto* content = static_cast(malloc(cmd_content.size() * sizeof(uint8_t))); std::copy( std::begin(cmd_content), std::end(cmd_content), content); c_binary->commands[i]->command = static_cast(cmd.command()); c_binary->commands[i]->size = cmd.size(); c_binary->commands[i]->data = content; c_binary->commands[i]->offset = cmd.command_offset(); } c_binary->commands[commands.size()] = nullptr; } void destroy_commands(Macho_Binary_t* c_binary) { Macho_Command_t **commands = c_binary->commands; for (size_t idx = 0; commands[idx] != nullptr; ++idx) { free(commands[idx]->data); free(commands[idx]); } free(c_binary->commands); } } } LIEF-0.13.1/api/c/MachO/LoadCommand.hpp000066400000000000000000000017751443457337100172110ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_MACHO_LOAD_COMMAND_CPP_C_API_ #define LIEF_MACHO_LOAD_COMMAND_CPP_C_API_ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/LoadCommand.h" #include "LIEF/MachO/LoadCommand.hpp" namespace LIEF { namespace MachO { void init_c_commands(Macho_Binary_t* c_binary, Binary* binary); void destroy_commands(Macho_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/MachO/Parser.cpp000066400000000000000000000027031443457337100162520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Parser.hpp" #include "LIEF/MachO/FatBinary.hpp" #include "Binary.hpp" using namespace LIEF::MachO; Macho_Binary_t** macho_parse(const char *file) { FatBinary* fat = Parser::parse(file).release(); if (fat == nullptr) { return nullptr; } size_t nb_bin = fat->size(); auto** c_macho_binaries = static_cast( malloc((fat->size() + 1) * sizeof(Macho_Binary_t**))); for (size_t i = 0; i < nb_bin; ++i) { Binary* binary = fat->at(i); if (binary != nullptr) { c_macho_binaries[i] = static_cast(malloc(sizeof(Macho_Binary_t))); init_c_binary(c_macho_binaries[i], binary); } } fat->release_all_binaries(); c_macho_binaries[nb_bin] = nullptr; delete fat; return c_macho_binaries; } LIEF-0.13.1/api/c/MachO/Section.cpp000066400000000000000000000052621443457337100164250ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Section.hpp" namespace LIEF { namespace MachO { void init_c_sections(Macho_Binary_t* c_binary, Binary* binary) { Binary::it_sections sections = binary->sections(); c_binary->sections = static_cast( malloc((sections.size() + 1) * sizeof(Macho_Section_t**))); for (size_t i = 0; i < sections.size(); ++i) { const Section& section = sections[i]; c_binary->sections[i] = static_cast(malloc(sizeof(Macho_Section_t))); span section_content = section.content(); auto* content = static_cast(malloc(section_content.size() * sizeof(uint8_t))); std::copy(std::begin(section_content), std::end(section_content), content); c_binary->sections[i]->name = section.fullname().c_str(); c_binary->sections[i]->alignment = section.alignment(); c_binary->sections[i]->relocation_offset = section.relocation_offset(); c_binary->sections[i]->numberof_relocations = section.numberof_relocations(); c_binary->sections[i]->flags = section.flags(); c_binary->sections[i]->type = static_cast(section.type()); c_binary->sections[i]->reserved1 = section.reserved1(); c_binary->sections[i]->reserved2 = section.reserved2(); c_binary->sections[i]->reserved3 = section.reserved3(); c_binary->sections[i]->virtual_address = section.virtual_address(); c_binary->sections[i]->offset = section.offset(); c_binary->sections[i]->size = section_content.size(); c_binary->sections[i]->content = content; c_binary->sections[i]->entropy = section.entropy(); } c_binary->sections[sections.size()] = nullptr; } void destroy_sections(Macho_Binary_t* c_binary) { Macho_Section_t **sections = c_binary->sections; for (size_t idx = 0; sections[idx] != nullptr; ++idx) { free(sections[idx]->content); free(sections[idx]); } free(c_binary->sections); } } } LIEF-0.13.1/api/c/MachO/Section.hpp000066400000000000000000000017531443457337100164330ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_MACHO_SECTION_CPP_C_API_ #define LIEF_MACHO_SECTION_CPP_C_API_ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/Section.h" #include "LIEF/MachO/Section.hpp" namespace LIEF { namespace MachO { void init_c_sections(Macho_Binary_t* c_binary, Binary* binary); void destroy_sections(Macho_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/MachO/Segment.cpp000066400000000000000000000047401443457337100164230ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Segment.hpp" namespace LIEF { namespace MachO { void init_c_segments(Macho_Binary_t* c_binary, Binary* binary) { Binary::it_segments segments = binary->segments(); c_binary->segments = static_cast( malloc((segments.size() + 1) * sizeof(Macho_Segment_t**))); for (size_t i = 0; i < segments.size(); ++i) { SegmentCommand& segment = segments[i]; c_binary->segments[i] = static_cast(malloc(sizeof(Macho_Segment_t))); span segment_content = segment.content(); auto* content = static_cast(malloc(segment_content.size() * sizeof(uint8_t))); std::copy( std::begin(segment_content), std::end(segment_content), content); c_binary->segments[i]->name = segment.name().c_str(); c_binary->segments[i]->virtual_address = segment.virtual_address(); c_binary->segments[i]->virtual_size = segment.virtual_size(); c_binary->segments[i]->file_size = segment.file_size(); c_binary->segments[i]->file_offset = segment.file_offset(); c_binary->segments[i]->max_protection = segment.max_protection(); c_binary->segments[i]->init_protection = segment.init_protection(); c_binary->segments[i]->numberof_sections = segment.numberof_sections(); c_binary->segments[i]->flags = segment.flags(); c_binary->segments[i]->content = content; c_binary->segments[i]->size = segment_content.size(); c_binary->segments[i]->sections = nullptr; //TODO } c_binary->segments[segments.size()] = nullptr; } void destroy_segments(Macho_Binary_t* c_binary) { Macho_Segment_t **segments = c_binary->segments; for (size_t idx = 0; segments[idx] != nullptr; ++idx) { free(segments[idx]->content); free(segments[idx]); } free(c_binary->segments); } } } LIEF-0.13.1/api/c/MachO/Segment.hpp000066400000000000000000000017621443457337100164310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_MACHO_SEGMENT_CPP_C_API_ #define LIEF_MACHO_SEGMENT_CPP_C_API_ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/Segment.h" #include "LIEF/MachO/SegmentCommand.hpp" namespace LIEF { namespace MachO { void init_c_segments(Macho_Binary_t* c_binary, Binary* binary); void destroy_segments(Macho_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/MachO/Symbol.cpp000066400000000000000000000032601443457337100162620ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Symbol.hpp" namespace LIEF { namespace MachO { void init_c_symbols(Macho_Binary_t* c_binary, Binary* binary) { Binary::it_symbols symbols = binary->symbols(); c_binary->symbols = static_cast( malloc((symbols.size() + 1) * sizeof(Macho_Symbol_t**))); for (size_t i = 0; i < symbols.size(); ++i) { const Symbol& symbol = symbols[i]; c_binary->symbols[i] = static_cast(malloc(sizeof(Macho_Symbol_t))); c_binary->symbols[i]->name = symbol.name().c_str(); c_binary->symbols[i]->type = symbol.type(); c_binary->symbols[i]->numberof_sections = symbol.numberof_sections(); c_binary->symbols[i]->description = symbol.description(); c_binary->symbols[i]->value = symbol.value(); } c_binary->symbols[symbols.size()] = nullptr; } void destroy_symbols(Macho_Binary_t* c_binary) { Macho_Symbol_t **symbols = c_binary->symbols; for (size_t idx = 0; symbols[idx] != nullptr; ++idx) { free(symbols[idx]); } free(c_binary->symbols); } } } LIEF-0.13.1/api/c/MachO/Symbol.hpp000066400000000000000000000017451443457337100162750ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_MACHO_SYMBOL_CPP_C_API_ #define LIEF_MACHO_SYMBOL_CPP_C_API_ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/Symbol.h" #include "LIEF/MachO/Symbol.hpp" namespace LIEF { namespace MachO { void init_c_symbols(Macho_Binary_t* c_binary, Binary* binary); void destroy_symbols(Macho_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/PE/000077500000000000000000000000001443457337100136255ustar00rootroot00000000000000LIEF-0.13.1/api/c/PE/Binary.cpp000066400000000000000000000035761443457337100155700ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "LIEF/PE/Binary.h" #include "LIEF/PE/Parser.hpp" #include "LIEF/PE/Binary.hpp" #include "Binary.hpp" #include "DosHeader.hpp" #include "Header.hpp" #include "OptionalHeader.hpp" #include "Section.hpp" #include "DataDirectory.hpp" #include "Import.hpp" using namespace LIEF::PE; namespace LIEF { namespace PE { void init_c_binary(Pe_Binary_t* c_binary, Binary* binary) { c_binary->name = binary->name().c_str(); c_binary->handler = reinterpret_cast(binary); init_c_dos_header(c_binary, binary); init_c_header(c_binary, binary); init_c_optional_header(c_binary, binary); init_c_sections(c_binary, binary); init_c_data_directories(c_binary, binary); init_c_imports(c_binary, binary); } } } Pe_Binary_t* pe_parse(const char *file) { Binary* binary = Parser::parse(file).release(); if (binary == nullptr) { return nullptr; } auto* c_binary = static_cast(malloc(sizeof(Pe_Binary_t))); std::memset(c_binary, 0, sizeof(Pe_Binary_t)); init_c_binary(c_binary, binary); return c_binary; } void pe_binary_destroy(Pe_Binary_t* binary) { destroy_sections(binary); destroy_data_directories(binary); destroy_imports(binary); delete reinterpret_cast(binary->handler); free(binary); } LIEF-0.13.1/api/c/PE/Binary.hpp000066400000000000000000000015411443457337100155630ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_BINARY_CPP_C_API_ #define LIEF_PE_BINARY_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" namespace LIEF { namespace PE { void init_c_binary(Pe_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/PE/CMakeLists.txt000066400000000000000000000035771443457337100164010ustar00rootroot00000000000000include_directories( "${CMAKE_CURRENT_SOURCE_DIR}/include/LIEF" "${CMAKE_CURRENT_SOURCE_DIR}/include" ) set(LIEF_API_C_PE_SRC "${CMAKE_CURRENT_LIST_DIR}/Binary.cpp" "${CMAKE_CURRENT_LIST_DIR}/DosHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/Header.cpp" "${CMAKE_CURRENT_LIST_DIR}/OptionalHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/Section.cpp" "${CMAKE_CURRENT_LIST_DIR}/DataDirectory.cpp" "${CMAKE_CURRENT_LIST_DIR}/EnumToString.cpp" "${CMAKE_CURRENT_LIST_DIR}/Import.cpp" "${CMAKE_CURRENT_LIST_DIR}/ImportEntry.cpp" ) set(LIEF_API_C_PE_INCLUDE_FILES_CPP "${CMAKE_CURRENT_LIST_DIR}/Binary.hpp" "${CMAKE_CURRENT_LIST_DIR}/DataDirectory.hpp" "${CMAKE_CURRENT_LIST_DIR}/DosHeader.hpp" "${CMAKE_CURRENT_LIST_DIR}/Header.hpp" "${CMAKE_CURRENT_LIST_DIR}/OptionalHeader.hpp" "${CMAKE_CURRENT_LIST_DIR}/Section.hpp" "${CMAKE_CURRENT_LIST_DIR}/Import.hpp" "${CMAKE_CURRENT_LIST_DIR}/ImportEntry.hpp" ) set(LIEF_API_C_PE_INCLUDE_FILES_C "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/enums.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/Binary.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/DataDirectory.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/DosHeader.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/EnumToString.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/Header.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/OptionalHeader.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/Section.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/Import.h" "${CMAKE_CURRENT_SOURCE_DIR}/api/c/include/LIEF/PE/ImportEntry.h" ) set(LIEF_C_PE_INC "${LIEF_API_C_PE_INCLUDE_FILES_C}" "${LIEF_API_C_PE_INCLUDE_FILES_CPP}") source_group("Source Files\\C API\\PE" FILES ${LIEF_API_C_PE_SRC}) source_group("Header Files\\C API\\PE" FILES ${LIEF_C_PE_INC}) target_sources(LIB_LIEF PRIVATE "${LIEF_API_C_PE_SRC}" "${LIEF_C_PE_INC}") LIEF-0.13.1/api/c/PE/DataDirectory.cpp000066400000000000000000000031521443457337100170700ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "DataDirectory.hpp" namespace LIEF { namespace PE { void init_c_data_directories(Pe_Binary_t* c_binary, Binary* binary) { Binary::it_data_directories data_directories = binary->data_directories(); c_binary->data_directories = static_cast( malloc((data_directories.size() + 1) * sizeof(Pe_DataDirectory_t**))); for (size_t i = 0; i < data_directories.size(); ++i) { c_binary->data_directories[i] = static_cast(malloc(sizeof(Pe_DataDirectory_t))); c_binary->data_directories[i]->rva = data_directories[i].RVA(); c_binary->data_directories[i]->size = data_directories[i].size(); } c_binary->data_directories[data_directories.size()] = nullptr; } void destroy_data_directories(Pe_Binary_t* c_binary) { Pe_DataDirectory_t **data_directories = c_binary->data_directories; for (size_t idx = 0; data_directories[idx] != nullptr; ++idx) { free(data_directories[idx]); } free(c_binary->data_directories); } } } LIEF-0.13.1/api/c/PE/DataDirectory.hpp000066400000000000000000000017721443457337100171030ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_DATA_DIRECTORY_CPP_C_API_ #define LIEF_PE_DATA_DIRECTORY_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" #include "LIEF/PE/DataDirectory.h" #include "LIEF/PE/DataDirectory.hpp" namespace LIEF { namespace PE { void init_c_data_directories(Pe_Binary_t* c_binary, Binary* binary); void destroy_data_directories(Pe_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/PE/DosHeader.cpp000066400000000000000000000051021443457337100161650ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "DosHeader.hpp" namespace LIEF { namespace PE { void init_c_dos_header(Pe_Binary_t* c_binary, Binary* binary) { const DosHeader& dos_header = binary->dos_header(); c_binary->dos_header.magic = dos_header.magic(); c_binary->dos_header.used_bytes_in_the_last_page = dos_header.used_bytes_in_the_last_page(); c_binary->dos_header.file_size_in_pages = dos_header.file_size_in_pages(); c_binary->dos_header.numberof_relocation = dos_header.numberof_relocation(); c_binary->dos_header.header_size_in_paragraphs = dos_header.header_size_in_paragraphs(); c_binary->dos_header.minimum_extra_paragraphs = dos_header.minimum_extra_paragraphs(); c_binary->dos_header.maximum_extra_paragraphs = dos_header.maximum_extra_paragraphs(); c_binary->dos_header.initial_relative_ss = dos_header.initial_relative_ss(); c_binary->dos_header.initial_sp = dos_header.initial_sp(); c_binary->dos_header.checksum = dos_header.checksum(); c_binary->dos_header.initial_ip = dos_header.initial_ip(); c_binary->dos_header.initial_relative_cs = dos_header.initial_relative_cs(); c_binary->dos_header.addressof_relocation_table = dos_header.addressof_relocation_table(); c_binary->dos_header.overlay_number = dos_header.overlay_number(); c_binary->dos_header.oem_id = dos_header.oem_id(); c_binary->dos_header.oem_info = dos_header.oem_info(); c_binary->dos_header.addressof_new_exeheader = dos_header.addressof_new_exeheader(); const DosHeader::reserved_t& reserved = dos_header.reserved(); std::copy( std::begin(reserved), std::end(reserved), c_binary->dos_header.reserved); const DosHeader::reserved2_t& reserved2 = dos_header.reserved2(); std::copy( std::begin(reserved2), std::end(reserved2), c_binary->dos_header.reserved2); } } } LIEF-0.13.1/api/c/PE/DosHeader.hpp000066400000000000000000000016561443457337100162040ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_DOS_HEADER_CPP_C_API_ #define LIEF_PE_DOS_HEADER_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" #include "LIEF/PE/DosHeader.h" #include "LIEF/PE/DosHeader.hpp" namespace LIEF { namespace PE { void init_c_dos_header(Pe_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/PE/EnumToString.cpp000066400000000000000000000022311443457337100167250ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/PE/EnumToString.h" #include "LIEF/PE/EnumToString.hpp" #include "LIEF/PE/enums.hpp" #include "LIEF/PE/enums.h" extern "C" { const char* PE_TYPES_to_string(enum LIEF_PE_PE_TYPES e) { return LIEF::PE::to_string(static_cast(e)); } const char* MACHINE_TYPES_to_string(enum LIEF_PE_MACHINE_TYPES e) { return LIEF::PE::to_string(static_cast(e)); } const char* SUBSYSTEM_to_string(enum LIEF_PE_SUBSYSTEM e) { return LIEF::PE::to_string(static_cast(e)); } } LIEF-0.13.1/api/c/PE/Header.cpp000066400000000000000000000027721443457337100155310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Header.hpp" namespace LIEF { namespace PE { void init_c_header(Pe_Binary_t* c_binary, Binary* binary) { const Header& header = binary->header(); const Header::signature_t& signature = header.signature(); c_binary->header.machine = static_cast(header.machine()); c_binary->header.numberof_sections = header.numberof_sections(); c_binary->header.time_date_stamp = header.time_date_stamp(); c_binary->header.pointerto_symbol_table = header.pointerto_symbol_table(); c_binary->header.numberof_symbols = header.numberof_symbols(); c_binary->header.sizeof_optional_header = header.sizeof_optional_header(); c_binary->header.characteristics = static_cast(header.characteristics()); std::copy( std::begin(signature), std::end(signature), c_binary->header.signature); } } } LIEF-0.13.1/api/c/PE/Header.hpp000066400000000000000000000016341443457337100155320ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_HEADER_CPP_C_API_ #define LIEF_PE_HEADER_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" #include "LIEF/PE/Header.h" #include "LIEF/PE/Header.hpp" namespace LIEF { namespace PE { void init_c_header(Pe_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/PE/Import.cpp000066400000000000000000000037761443457337100156200ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Import.hpp" #include "ImportEntry.hpp" namespace LIEF { namespace PE { void init_c_imports(Pe_Binary_t* c_binary, Binary* binary) { if (!binary->has_imports()) { c_binary->imports = nullptr; } Binary::it_imports imports = binary->imports(); c_binary->imports = static_cast( malloc((imports.size() + 1) * sizeof(Pe_Import_t**))); for (size_t i = 0; i < imports.size(); ++i) { Import& imp = imports[i]; c_binary->imports[i] = static_cast(malloc(sizeof(Pe_Import_t))); c_binary->imports[i]->name = imp.name().c_str(); c_binary->imports[i]->forwarder_chain = imp.forwarder_chain(); c_binary->imports[i]->timedatestamp = imp.forwarder_chain(); c_binary->imports[i]->import_address_table_rva = imp.import_address_table_rva(); c_binary->imports[i]->import_lookup_table_rva = imp.import_lookup_table_rva(); c_binary->imports[i]->entries = nullptr; init_c_import_entries(c_binary->imports[i], imp); } c_binary->imports[imports.size()] = nullptr; } void destroy_imports(Pe_Binary_t* c_binary) { if (c_binary->imports == nullptr) { return; } Pe_Import_t **imports = c_binary->imports; for (size_t idx = 0; imports[idx] != nullptr; ++idx) { destroy_import_entries(imports[idx]); free(imports[idx]); } free(c_binary->imports); } } } LIEF-0.13.1/api/c/PE/Import.hpp000066400000000000000000000017121443457337100156110ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_IMPORT_CPP_C_API_ #define LIEF_PE_IMPORT_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" #include "LIEF/PE/Import.h" #include "LIEF/PE/Import.hpp" namespace LIEF { namespace PE { void init_c_imports(Pe_Binary_t* c_binary, Binary* binary); void destroy_imports(Pe_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/PE/ImportEntry.cpp000066400000000000000000000037261443457337100166350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "ImportEntry.hpp" namespace LIEF { namespace PE { void init_c_import_entries(Pe_Import_t* c_import, Import& imp) { Import::it_entries entries = imp.entries(); c_import->entries = static_cast( malloc((entries.size() + 1) * sizeof(Pe_ImportEntry_t**))); for (size_t i = 0; i < entries.size(); ++i) { ImportEntry& import_entry = entries[i]; c_import->entries[i] = static_cast(malloc(sizeof(Pe_ImportEntry_t))); c_import->entries[i]->is_ordinal = import_entry.is_ordinal(); c_import->entries[i]->name = import_entry.is_ordinal() ? nullptr : import_entry.name().c_str(); c_import->entries[i]->ordinal = import_entry.is_ordinal() ? import_entry.ordinal() : 0; c_import->entries[i]->hint_name_rva = import_entry.hint_name_rva(); c_import->entries[i]->hint = import_entry.hint(); c_import->entries[i]->iat_value = import_entry.iat_value(); c_import->entries[i]->data = import_entry.data(); c_import->entries[i]->iat_address = import_entry.iat_address(); } c_import->entries[entries.size()] = nullptr; } void destroy_import_entries(Pe_Import_t* c_import) { Pe_ImportEntry_t **entries = c_import->entries; for (size_t idx = 0; entries[idx] != nullptr; ++idx) { free(entries[idx]); } free(c_import->entries); } } } LIEF-0.13.1/api/c/PE/ImportEntry.hpp000066400000000000000000000017531443457337100166400ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_IMPORT_ENTRY_CPP_C_API_ #define LIEF_PE_IMPORT_ENTRY_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" #include "LIEF/PE/ImportEntry.h" #include "LIEF/PE/ImportEntry.hpp" namespace LIEF { namespace PE { void init_c_import_entries(Pe_Import_t* c_import, Import& imp); void destroy_import_entries(Pe_Import_t* c_import); } } #endif LIEF-0.13.1/api/c/PE/OptionalHeader.cpp000066400000000000000000000076321443457337100172370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "OptionalHeader.hpp" namespace LIEF { namespace PE { void init_c_optional_header(Pe_Binary_t* c_binary, Binary* binary) { const OptionalHeader& optional_header = binary->optional_header(); c_binary->optional_header.magic = static_cast(optional_header.magic()); c_binary->optional_header.major_linker_version = optional_header.major_linker_version(); c_binary->optional_header.minor_linker_version = optional_header.minor_linker_version(); c_binary->optional_header.sizeof_code = optional_header.sizeof_code(); c_binary->optional_header.sizeof_initialized_data = optional_header.sizeof_initialized_data(); c_binary->optional_header.sizeof_uninitialized_data = optional_header.sizeof_uninitialized_data(); c_binary->optional_header.addressof_entrypoint = optional_header.addressof_entrypoint(); c_binary->optional_header.baseof_code = optional_header.baseof_code(); if (optional_header.magic() == PE_TYPE::PE32) { c_binary->optional_header.baseof_data = optional_header.baseof_data(); } else { c_binary->optional_header.baseof_data = 0; } c_binary->optional_header.imagebase = optional_header.imagebase(); c_binary->optional_header.section_alignment = optional_header.section_alignment(); c_binary->optional_header.file_alignment = optional_header.file_alignment(); c_binary->optional_header.major_operating_system_version = optional_header.major_operating_system_version(); c_binary->optional_header.minor_operating_system_version = optional_header.minor_operating_system_version(); c_binary->optional_header.major_image_version = optional_header.major_image_version(); c_binary->optional_header.minor_image_version = optional_header.minor_image_version(); c_binary->optional_header.major_subsystem_version = optional_header.major_subsystem_version(); c_binary->optional_header.minor_subsystem_version = optional_header.minor_subsystem_version(); c_binary->optional_header.win32_version_value = optional_header.win32_version_value(); c_binary->optional_header.sizeof_image = optional_header.sizeof_image(); c_binary->optional_header.sizeof_headers = optional_header.sizeof_headers(); c_binary->optional_header.checksum = optional_header.checksum(); c_binary->optional_header.subsystem = static_cast(optional_header.subsystem()); c_binary->optional_header.dll_characteristics = optional_header.dll_characteristics(); c_binary->optional_header.sizeof_stack_reserve = optional_header.sizeof_stack_reserve(); c_binary->optional_header.sizeof_stack_commit = optional_header.sizeof_stack_commit(); c_binary->optional_header.sizeof_heap_reserve = optional_header.sizeof_heap_reserve(); c_binary->optional_header.sizeof_heap_commit = optional_header.sizeof_heap_commit(); c_binary->optional_header.loader_flags = optional_header.loader_flags(); c_binary->optional_header.numberof_rva_and_size = optional_header.numberof_rva_and_size(); } } } LIEF-0.13.1/api/c/PE/OptionalHeader.hpp000066400000000000000000000017071443457337100172410ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_OPTIONAL_HEADER_CPP_C_API_ #define LIEF_PE_OPTIONAL_HEADER_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" #include "LIEF/PE/OptionalHeader.h" #include "LIEF/PE/OptionalHeader.hpp" namespace LIEF { namespace PE { void init_c_optional_header(Pe_Binary_t* c_binary, Binary* binary); } } #endif LIEF-0.13.1/api/c/PE/Section.cpp000066400000000000000000000050411443457337100157350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "Section.hpp" namespace LIEF { namespace PE { void init_c_sections(Pe_Binary_t* c_binary, Binary* binary) { Binary::it_sections sections = binary->sections(); c_binary->sections = static_cast( malloc((sections.size() + 1) * sizeof(Pe_Section_t**))); for (size_t i = 0; i < sections.size(); ++i) { Section& b_section = sections[i]; c_binary->sections[i] = static_cast(malloc(sizeof(Pe_Section_t))); span section_content = b_section.content(); uint8_t* content = nullptr; if (!section_content.empty()) { content = static_cast(malloc(section_content.size() * sizeof(uint8_t))); std::copy(std::begin(section_content), std::end(section_content), content); } c_binary->sections[i]->name = b_section.fullname().c_str(); c_binary->sections[i]->virtual_address = b_section.virtual_address(); c_binary->sections[i]->size = b_section.size(); c_binary->sections[i]->offset = b_section.offset(); c_binary->sections[i]->virtual_size = b_section.virtual_size(); c_binary->sections[i]->pointerto_relocation = b_section.pointerto_relocation(); c_binary->sections[i]->pointerto_line_numbers = b_section.pointerto_line_numbers(); c_binary->sections[i]->characteristics = b_section.characteristics(); c_binary->sections[i]->content = content; c_binary->sections[i]->content_size = section_content.size(); c_binary->sections[i]->entropy = b_section.entropy(); } c_binary->sections[sections.size()] = nullptr; } void destroy_sections(Pe_Binary_t* c_binary) { Pe_Section_t **sections = c_binary->sections; for (size_t idx = 0; sections[idx] != nullptr; ++idx) { free(sections[idx]->content); free(sections[idx]); } free(c_binary->sections); } } } LIEF-0.13.1/api/c/PE/Section.hpp000066400000000000000000000017201443457337100157420ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PE_SECTION_CPP_C_API_ #define LIEF_PE_SECTION_CPP_C_API_ #include "LIEF/PE/Binary.h" #include "LIEF/PE/Binary.hpp" #include "LIEF/PE/Section.h" #include "LIEF/PE/Section.hpp" namespace LIEF { namespace PE { void init_c_sections(Pe_Binary_t* c_binary, Binary* binary); void destroy_sections(Pe_Binary_t* c_binary); } } #endif LIEF-0.13.1/api/c/include/000077500000000000000000000000001443457337100147445ustar00rootroot00000000000000LIEF-0.13.1/api/c/include/LIEF/000077500000000000000000000000001443457337100154635ustar00rootroot00000000000000LIEF-0.13.1/api/c/include/LIEF/ELF.h000066400000000000000000000016511443457337100162450ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_H_ #define C_LIEF_ELF_H_ /** @defgroup elf_c_api ELF C API */ #include "LIEF/ELF/Binary.h" #include "LIEF/ELF/Symbol.h" #include "LIEF/ELF/Section.h" #include "LIEF/ELF/Header.h" #include "LIEF/ELF/DynamicEntry.h" #include "LIEF/ELF/EnumToString.h" #include "LIEF/ELF/utils.h" #endif LIEF-0.13.1/api/c/include/LIEF/ELF/000077500000000000000000000000001443457337100160715ustar00rootroot00000000000000LIEF-0.13.1/api/c/include/LIEF/ELF/Binary.h000066400000000000000000000035741443457337100174770ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_BINARY_H_ #define C_LIEF_ELF_BINARY_H_ /** @defgroup elf_binary_c_api Binary * @ingroup elf_c_api * @addtogroup elf_binary_c_api * @brief Binary C API * * @{ */ #include #include "LIEF/visibility.h" #include "LIEF/ELF/enums.h" #include "LIEF/ELF/Section.h" #include "LIEF/ELF/Segment.h" #include "LIEF/ELF/Header.h" #include "LIEF/ELF/DynamicEntry.h" #include "LIEF/ELF/Symbol.h" #ifdef __cplusplus extern "C" { #endif /** @brief LIEF::ELF::Binary C Handler */ struct Elf_Binary_t { void* handler; const char* name; const char* interpreter; enum LIEF_ELF_ELF_CLASS type; Elf_Header_t header; Elf_Section_t **sections; Elf_Segment_t **segments; Elf_DynamicEntry_t **dynamic_entries; Elf_Symbol_t **dynamic_symbols; Elf_Symbol_t **static_symbols; }; typedef struct Elf_Binary_t Elf_Binary_t; /** @brief Wrapper for LIEF::ELF::Parser::parse */ LIEF_API Elf_Binary_t* elf_parse(const char *file); LIEF_API void elf_binary_destroy(Elf_Binary_t* binary); /* ELF::Binary methods * ================== */ /** @brief Update LIEF::ELF::Header object */ LIEF_API int elf_binary_save_header(Elf_Binary_t* binary); #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/ELF/DynamicEntry.h000066400000000000000000000042731443457337100206560ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_DYNAMIC_ENTRY_H_ #define C_LIEF_ELF_DYNAMIC_ENTRY_H_ #include #include "LIEF/ELF/enums.h" /** @defgroup elf_dynamic_entry_c_api Dynamic Entry * @ingroup elf_c_api * @addtogroup elf_dynamic_entry_c_api * @brief Dynamic Entry C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Elf_DynamicEntry_t { uint64_t tag; uint64_t value; }; struct Elf_DynamicEntry_Library_t { uint64_t tag; uint64_t value; const char* name; }; struct Elf_DynamicEntry_SharedObject_t { uint64_t tag; uint64_t value; const char* name; }; struct Elf_DynamicEntry_Array_t { uint64_t tag; uint64_t value; uint64_t* array; }; struct Elf_DynamicEntry_Rpath_t { uint64_t tag; uint64_t value; const char* rpath; }; struct Elf_DynamicEntry_RunPath_t { uint64_t tag; uint64_t value; const char* runpath; }; struct Elf_DynamicEntry_Flags_t { uint64_t tag; uint64_t value; enum LIEF_ELF_DYNAMIC_FLAGS *flags; enum LIEF_ELF_DYNAMIC_FLAGS_1 *flags_1; }; typedef struct Elf_DynamicEntry_t Elf_DynamicEntry_t; typedef struct Elf_DynamicEntry_Library_t Elf_DynamicEntry_Library_t; typedef struct Elf_DynamicEntry_SharedObject_t Elf_DynamicEntry_SharedObject_t; typedef struct Elf_DynamicEntry_Array_t Elf_DynamicEntry_Array_t; typedef struct Elf_DynamicEntry_Rpath_t Elf_DynamicEntry_Rpath_t; typedef struct Elf_DynamicEntry_RunPath_t Elf_DynamicEntry_RunPath_t; typedef struct Elf_DynamicEntry_Flags_t Elf_DynamicEntry_Flags_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/ELF/EnumToString.h000066400000000000000000000035221443457337100206420ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_ENUM_TO_STRING_H_ #define C_LIEF_ELF_ENUM_TO_STRING_H_ #include "LIEF/visibility.h" #include "LIEF/ELF/enums.h" #ifdef __cplusplus extern "C" { #endif LIEF_API const char* SYMBOL_BINDINGS_to_string(enum LIEF_ELF_SYMBOL_BINDINGS e); LIEF_API const char* E_TYPE_to_string(enum LIEF_ELF_E_TYPE e); LIEF_API const char* VERSION_to_string(enum LIEF_ELF_VERSION e); LIEF_API const char* ARCH_to_string(enum LIEF_ELF_ARCH e); LIEF_API const char* SEGMENT_TYPES_to_string(enum LIEF_ELF_SEGMENT_TYPES e); LIEF_API const char* DYNAMIC_TAGS_to_string(enum LIEF_ELF_DYNAMIC_TAGS e); LIEF_API const char* ELF_SECTION_TYPES_to_string(enum LIEF_ELF_ELF_SECTION_TYPES e); LIEF_API const char* ELF_SECTION_FLAGS_to_string(enum LIEF_ELF_ELF_SECTION_FLAGS e); LIEF_API const char* ELF_SYMBOL_TYPES_to_string(enum LIEF_ELF_ELF_SYMBOL_TYPES e); LIEF_API const char* ELF_CLASS_to_string(enum LIEF_ELF_ELF_CLASS e); LIEF_API const char* ELF_DATA_to_string(enum LIEF_ELF_ELF_DATA e); LIEF_API const char* OS_ABI_to_string(enum LIEF_ELF_OS_ABI e); LIEF_API const char* DYNAMIC_FLAGS_to_string(enum LIEF_ELF_DYNAMIC_FLAGS e); LIEF_API const char* DYNAMIC_FLAGS_1_to_string(enum LIEF_ELF_DYNAMIC_FLAGS_1 e); #ifdef __cplusplus } #endif #endif LIEF-0.13.1/api/c/include/LIEF/ELF/Header.h000066400000000000000000000030011443457337100174240ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_HEADER_H_ #define C_LIEF_ELF_HEADER_H_ #include #include "LIEF/ELF/enums.h" /** @defgroup elf_header_c_api Header * @ingroup elf_c_api * @addtogroup elf_header_c_api * @brief Header C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Elf_Header_t { uint8_t identity[LIEF_ELF_EI_NIDENT]; enum LIEF_ELF_E_TYPE file_type; enum LIEF_ELF_ARCH machine_type; enum LIEF_ELF_VERSION object_file_version; uint64_t entrypoint; uint64_t program_headers_offset; uint64_t section_headers_offset; uint32_t processor_flags; uint32_t header_size; uint32_t program_header_size; uint32_t numberof_segments; uint32_t section_header_size; uint32_t numberof_sections; uint32_t name_string_table_idx; }; typedef struct Elf_Header_t Elf_Header_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/ELF/Section.h000066400000000000000000000027221443457337100176510ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_SECTION_H_ #define C_LIEF_ELF_SECTION_H_ #include #include "LIEF/ELF/enums.h" /** @defgroup elf_section_c_api Section * @ingroup elf_c_api * @addtogroup elf_section_c_api * @brief Section C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Elf_Section_t { const char* name; uint32_t flags; enum LIEF_ELF_ELF_SECTION_TYPES type; uint64_t virtual_address; uint64_t offset; uint64_t original_size; uint32_t link; uint32_t info; uint64_t alignment; uint64_t entry_size; uint64_t size; uint8_t* content; double entropy; }; typedef struct Elf_Section_t Elf_Section_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/ELF/Segment.h000066400000000000000000000024151443457337100176460ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_SEGMENT_H_ #define C_LIEF_ELF_SEGMENT_H_ #include #include "LIEF/ELF/enums.h" /** @defgroup elf_segment_c_api Segment * @ingroup elf_c_api * @addtogroup elf_segment_c_api * @brief Segment C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Elf_Segment_t { enum LIEF_ELF_SEGMENT_TYPES type; uint32_t flags; uint64_t virtual_address; uint64_t virtual_size; uint64_t offset; uint64_t alignment; uint64_t size; uint8_t* content; }; typedef struct Elf_Segment_t Elf_Segment_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/ELF/Symbol.h000066400000000000000000000027221443457337100175120ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_SYMBOL_H_ #define C_LIEF_ELF_SYMBOL_H_ #include #include "LIEF/ELF/enums.h" #include "LIEF/types.h" /** @defgroup elf_symbol_c_api Symbol * @ingroup elf_c_api * @addtogroup elf_symbol_c_api * @brief Symbol C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Elf_Symbol_t { const char* name; enum LIEF_ELF_ELF_SYMBOL_TYPES type; enum LIEF_ELF_SYMBOL_BINDINGS binding; uint8_t information; uint8_t other; uint16_t shndx; uint64_t value; uint64_t size; bool is_exported; /**< Whether or not the symbol is exported */ bool is_imported; /**< Whether or not the symbol is imported */ }; typedef struct Elf_Symbol_t Elf_Symbol_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/ELF/enums.h000066400000000000000000000005401443457337100173700ustar00rootroot00000000000000#ifndef LIEF_ELF_C_ENUMS_H_ #define LIEF_ELF_C_ENUMS_H_ #include "LIEF/ELF/undef.h" #ifdef __cplusplus extern "C" { #endif #define _LIEF_EN(N) LIEF_ELF_##N #define _LIEF_EN_2(N, TYPE) LIEF_ELF_##N #define _LIEF_EI(X) LIEF_ELF_##X #include "LIEF/ELF/enums.inc" #undef _LIEF_EN #undef _LIEF_EN_2 #undef _LIEF_EI #ifdef __cplusplus } #endif #endif LIEF-0.13.1/api/c/include/LIEF/ELF/utils.h000066400000000000000000000020631443457337100174030ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_ELF_UTILS_H_ #define C_LIEF_ELF_UTILS_H_ /** @defgroup elf_utils_c_api Utils * @ingroup elf_c_api * @addtogroup elf_utils_c_api * @brief Utils C API * * @{ */ #include #include "LIEF/visibility.h" #include "LIEF/types.h" #ifdef __cplusplus extern "C" { #endif /** @brief Check if the given file is an ELF one. */ LIEF_API bool is_elf(const char* file); #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/LIEF.h000066400000000000000000000014021443457337100163500ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_H_ #define C_LIEF_H_ #include #include #include #include #endif LIEF-0.13.1/api/c/include/LIEF/MachO.h000066400000000000000000000017001443457337100166210ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_H_ #define C_LIEF_MACHO_H_ /** @defgroup macho_c_api MachO C API */ #include "LIEF/MachO/Binary.h" #include "LIEF/MachO/Symbol.h" #include "LIEF/MachO/Segment.h" #include "LIEF/MachO/Section.h" #include "LIEF/MachO/LoadCommand.h" #include "LIEF/MachO/Header.h" #include "LIEF/MachO/EnumToString.h" #endif LIEF-0.13.1/api/c/include/LIEF/MachO/000077500000000000000000000000001443457337100164525ustar00rootroot00000000000000LIEF-0.13.1/api/c/include/LIEF/MachO/Binary.h000066400000000000000000000032201443457337100200440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_BINARY_H_ #define C_LIEF_MACHO_BINARY_H_ /** @defgroup macho_binary_c_api Binary * @ingroup macho_c_api * @addtogroup macho_binary_c_api * @brief Binary C API * * @{ */ #include #include "LIEF/visibility.h" #include "LIEF/MachO/Header.h" #include "LIEF/MachO/LoadCommand.h" #include "LIEF/MachO/Symbol.h" #include "LIEF/MachO/Section.h" #include "LIEF/MachO/Segment.h" #ifdef __cplusplus extern "C" { #endif /** @brief LIEF::MachO::Binary C Handler */ struct Macho_Binary_t { void* handler; const char* name; uint64_t imagebase; Macho_Header_t header; Macho_Command_t** commands; Macho_Symbol_t** symbols; Macho_Section_t** sections; Macho_Segment_t** segments; }; typedef struct Macho_Binary_t Macho_Binary_t; /** @brief Wrapper on LIEF::MachO::Parser::parse */ LIEF_API Macho_Binary_t** macho_parse(const char *file); LIEF_API void macho_binaries_destroy(Macho_Binary_t** binaries); #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/MachO/EnumToString.h000066400000000000000000000030561443457337100212250ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_ENUM_TO_STRING_H_ #define C_LIEF_MACHO_ENUM_TO_STRING_H_ #include "LIEF/visibility.h" #include "LIEF/MachO/enums.h" #ifdef __cplusplus extern "C" { #endif LIEF_API const char* LOAD_COMMAND_TYPES_to_string(enum LIEF_MACHO_LOAD_COMMAND_TYPES e); LIEF_API const char* MACHO_TYPES_to_string(enum LIEF_MACHO_MACHO_TYPES e); LIEF_API const char* FILE_TYPES_to_string(enum LIEF_MACHO_FILE_TYPES e); LIEF_API const char* CPU_TYPES_to_string(enum LIEF_MACHO_CPU_TYPES e); LIEF_API const char* HEADER_FLAGS_to_string(enum LIEF_MACHO_HEADER_FLAGS e); LIEF_API const char* MACHO_SECTION_TYPES_to_string(enum LIEF_MACHO_MACHO_SECTION_TYPES e); LIEF_API const char* MACHO_SYMBOL_TYPES_to_string(enum LIEF_MACHO_MACHO_SYMBOL_TYPES e); LIEF_API const char* N_LIST_TYPES_to_string(enum LIEF_MACHO_N_LIST_TYPES e); LIEF_API const char* SYMBOL_DESCRIPTIONS_to_string(enum LIEF_MACHO_SYMBOL_DESCRIPTIONS e); #ifdef __cplusplus } #endif #endif LIEF-0.13.1/api/c/include/LIEF/MachO/Header.h000066400000000000000000000024171443457337100200170ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_HEADER_H_ #define C_LIEF_MACHO_HEADER_H_ #include #include "LIEF/MachO/enums.h" /** @defgroup macho_header_c_api Header * @ingroup macho_c_api * @addtogroup macho_header_c_api * @brief Header C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Macho_Header_t { uint32_t magic; enum LIEF_MACHO_CPU_TYPES cpu_type; uint32_t cpu_subtype; enum LIEF_MACHO_FILE_TYPES file_type; uint32_t nb_cmds; uint32_t sizeof_cmds; uint32_t flags; uint32_t reserved; }; typedef struct Macho_Header_t Macho_Header_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/MachO/LoadCommand.h000066400000000000000000000023121443457337100207770ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_LOAD_COMMAND_H_ #define C_LIEF_MACHO_LOAD_COMMAND_H_ #include #include "LIEF/MachO/enums.h" /** @defgroup macho_load_command_c_api Header * @ingroup macho_c_api * @addtogroup macho_load_command_c_api * @brief Load Command C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Macho_Command_t { enum LIEF_MACHO_LOAD_COMMAND_TYPES command; uint32_t size; uint8_t* data; uint32_t offset; }; typedef struct Macho_Command_t Macho_Command_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/MachO/Section.h000066400000000000000000000031001443457337100202210ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_SECTION_H_ #define C_LIEF_MACHO_SECTION_H_ #include #include "LIEF/MachO/enums.h" /** @defgroup macho_section_c_api Header * @ingroup macho_c_api * @addtogroup macho_section_c_api * @brief Section C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Macho_Section_t { const char* name; uint32_t alignment; uint32_t relocation_offset; uint32_t numberof_relocations; uint32_t flags; enum LIEF_MACHO_MACHO_SECTION_TYPES type; uint32_t reserved1; uint32_t reserved2; uint32_t reserved3; uint64_t virtual_address; uint64_t offset; uint64_t size; uint8_t* content; double entropy; }; typedef struct Macho_Section_t Macho_Section_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/MachO/Segment.h000066400000000000000000000026421443457337100202310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_SEGMENT_H_ #define C_LIEF_MACHO_SEGMENT_H_ #include #include "LIEF/MachO/enums.h" /** @defgroup macho_segment_c_api Header * @ingroup macho_c_api * @addtogroup macho_segment_c_api * @brief Segment C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Macho_Segment_t { const char* name; uint64_t virtual_address; uint64_t virtual_size; uint64_t file_size; uint64_t file_offset; uint32_t max_protection; uint32_t init_protection; uint32_t numberof_sections; uint32_t flags; uint8_t* content; uint64_t size; Macho_Section_t** sections; }; typedef struct Macho_Segment_t Macho_Segment_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/MachO/Symbol.h000066400000000000000000000022221443457337100200660ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_MACHO_SYMBOL_H_ #define C_LIEF_MACHO_SYMBOL_H_ #include #include "LIEF/MachO/enums.h" /** @defgroup macho_symbol_c_api Header * @ingroup macho_c_api * @addtogroup macho_symbol_c_api * @brief Symbol C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Macho_Symbol_t { const char* name; uint8_t type; uint8_t numberof_sections; uint16_t description; uint64_t value; }; typedef struct Macho_Symbol_t Macho_Symbol_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/MachO/enums.h000066400000000000000000000007601443457337100177550ustar00rootroot00000000000000#ifndef LIEF_MACHO_C_ENUMS_H_ #define LIEF_MACHO_C_ENUMS_H_ #include "LIEF/MachO/undef.h" #ifdef __cplusplus extern "C" { #endif #ifdef _LIEF_EN #undef _LIEF_EN #endif #ifdef _LIEF_EN_2 #undef _LIEF_EN_2 #endif #ifdef _LIEF_EI #undef _LIEF_EI #endif #define _LIEF_EN(N) LIEF_MACHO_##N #define _LIEF_EN_2(N, TYPE) LIEF_MACHO_##N #define _LIEF_EI(X) LIEF_MACHO_##X #include "LIEF/MachO/enums.inc" #undef _LIEF_EN #undef _LIEF_EN_2 #undef _LIEF_EI #ifdef __cplusplus } #endif #endif LIEF-0.13.1/api/c/include/LIEF/PE.h000066400000000000000000000014141443457337100161400ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_H_ #define C_LIEF_PE_H_ /** @defgroup pe_c_api PE C API */ #include "LIEF/PE/Binary.h" #include "LIEF/PE/EnumToString.h" #endif LIEF-0.13.1/api/c/include/LIEF/PE/000077500000000000000000000000001443457337100157675ustar00rootroot00000000000000LIEF-0.13.1/api/c/include/LIEF/PE/Binary.h000066400000000000000000000032451443457337100173700ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_BINARY_H_ #define C_LIEF_PE_BINARY_H_ /** @defgroup pe_binary_c_api Binary * @ingroup pe_c_api * @addtogroup pe_binary_c_api * @brief Binary C API * * @{ */ #include #include "LIEF/visibility.h" #include "LIEF/PE/enums.h" #include "LIEF/PE/DosHeader.h" #include "LIEF/PE/Header.h" #include "LIEF/PE/OptionalHeader.h" #include "LIEF/PE/DataDirectory.h" #include "LIEF/PE/Section.h" #include "LIEF/PE/Import.h" #ifdef __cplusplus extern "C" { #endif /** @brief LIEF::PE::Binary C Handler */ struct Pe_Binary_t { void* handler; const char* name; Pe_DosHeader_t dos_header; Pe_Header_t header; Pe_OptionalHeader_t optional_header; Pe_DataDirectory_t** data_directories; Pe_Section_t** sections; Pe_Import_t** imports; }; typedef struct Pe_Binary_t Pe_Binary_t; /** Wrapper on LIEF::PE::Parser::parse */ LIEF_API Pe_Binary_t* pe_parse(const char *file); LIEF_API void pe_binary_destroy(Pe_Binary_t* binary); #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/DataDirectory.h000066400000000000000000000021361443457337100207000ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_DATA_DIRECTORY_H_ #define C_LIEF_PE_DATA_DIRECTORY_H_ #include #include "LIEF/PE/enums.h" /** @defgroup pe_data_directory_c_api Section * @ingroup pe_c_api * @addtogroup pe_data_directory_c_api * @brief Data directory C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Pe_DataDirectory_t { uint32_t rva; uint32_t size; }; typedef struct Pe_DataDirectory_t Pe_DataDirectory_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/DosHeader.h000066400000000000000000000031141443457337100177750ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_DOS_HEADER_H_ #define C_LIEF_PE_DOS_HEADER_H_ #include #include "LIEF/ELF/enums.h" /** @defgroup pe_dos_header_c_api DosHeader * @ingroup pe_c_api * @addtogroup pe_dos_header_c_api * @brief Dos Header C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Pe_DosHeader_t { uint16_t magic ; uint16_t used_bytes_in_the_last_page; uint16_t file_size_in_pages; uint16_t numberof_relocation; uint16_t header_size_in_paragraphs; uint16_t minimum_extra_paragraphs; uint16_t maximum_extra_paragraphs; uint16_t initial_relative_ss; uint16_t initial_sp; uint16_t checksum; uint16_t initial_ip; uint16_t initial_relative_cs; uint16_t addressof_relocation_table; uint16_t overlay_number; uint16_t reserved[4]; uint16_t oem_id; uint16_t oem_info; uint16_t reserved2[10]; uint32_t addressof_new_exeheader; }; typedef struct Pe_DosHeader_t Pe_DosHeader_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/EnumToString.h000066400000000000000000000020341443457337100205350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_ENUM_TO_STRING_H_ #define C_LIEF_PE_ENUM_TO_STRING_H_ #include "LIEF/visibility.h" #include "LIEF/PE/enums.h" #ifdef __cplusplus extern "C" { #endif LIEF_API const char* PE_TYPES_to_string(enum LIEF_PE_PE_TYPES e); LIEF_API const char* MACHINE_TYPES_to_string(enum LIEF_PE_MACHINE_TYPES e); LIEF_API const char* SUBSYSTEM_to_string(enum LIEF_PE_SUBSYSTEM e); #ifdef __cplusplus } #endif #endif LIEF-0.13.1/api/c/include/LIEF/PE/Header.h000066400000000000000000000024751443457337100173400ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_HEADER_H_ #define C_LIEF_PE_HEADER_H_ #include #include "LIEF/PE/enums.h" /** @defgroup pe_header_c_api Header * @ingroup pe_c_api * @addtogroup pe_header_c_api * @brief Header C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Pe_Header_t { uint8_t signature[4]; enum LIEF_PE_MACHINE_TYPES machine; uint16_t numberof_sections; uint32_t time_date_stamp; uint32_t pointerto_symbol_table; uint32_t numberof_symbols; uint16_t sizeof_optional_header; uint16_t characteristics; }; typedef struct Pe_Header_t Pe_Header_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/Import.h000066400000000000000000000024011443457337100174070ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_IMPORT_H_ #define C_LIEF_PE_IMPORT_H_ #include #include "LIEF/PE/enums.h" #include "LIEF/PE/ImportEntry.h" /** @defgroup pe_import_c_api Import * @ingroup pe_c_api * @addtogroup pe_import_c_api * @brief Import C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Pe_Import_t { const char* name; uint32_t forwarder_chain; uint32_t timedatestamp; Pe_ImportEntry_t** entries; uint32_t import_address_table_rva; uint32_t import_lookup_table_rva; }; typedef struct Pe_Import_t Pe_Import_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/ImportEntry.h000066400000000000000000000024121443457337100204330ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_IMPORT_ENTRY_H_ #define C_LIEF_PE_IMPORT_ENTRY_H_ #include #include "LIEF/types.h" #include "LIEF/PE/enums.h" /** @defgroup pe_import_entry_c_api Import Entry * @ingroup pe_c_api * @addtogroup pe_import_entry_c_api * @brief Import Entry C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Pe_ImportEntry_t { bool is_ordinal; const char* name; uint16_t ordinal; uint64_t hint_name_rva; uint16_t hint; uint64_t iat_value; uint64_t data; uint64_t iat_address; }; typedef struct Pe_ImportEntry_t Pe_ImportEntry_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/OptionalHeader.h000066400000000000000000000042341443457337100210410ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_OPTIONAL_HEADER_H_ #define C_LIEF_PE_OPTIONAL_HEADER_H_ #include #include "LIEF/PE/enums.h" /** @defgroup pe_optional_header_c_api OptionalHeader * @ingroup pe_c_api * @addtogroup pe_optional_header_c_api * @brief OptionalHeader C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Pe_OptionalHeader_t { enum LIEF_PE_PE_TYPES magic; uint8_t major_linker_version; uint8_t minor_linker_version; uint32_t sizeof_code; uint32_t sizeof_initialized_data; uint32_t sizeof_uninitialized_data; uint32_t addressof_entrypoint; uint32_t baseof_code; uint32_t baseof_data; uint64_t imagebase; uint32_t section_alignment; uint32_t file_alignment; uint16_t major_operating_system_version; uint16_t minor_operating_system_version; uint16_t major_image_version; uint16_t minor_image_version; uint16_t major_subsystem_version; uint16_t minor_subsystem_version; uint32_t win32_version_value; uint32_t sizeof_image; uint32_t sizeof_headers; uint32_t checksum; enum LIEF_PE_SUBSYSTEM subsystem; uint32_t dll_characteristics; uint64_t sizeof_stack_reserve; uint64_t sizeof_stack_commit; uint64_t sizeof_heap_reserve; uint64_t sizeof_heap_commit; uint32_t loader_flags; uint32_t numberof_rva_and_size; }; typedef struct Pe_OptionalHeader_t Pe_OptionalHeader_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/Section.h000066400000000000000000000024671443457337100175550ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef C_LIEF_PE_SECTION_H_ #define C_LIEF_PE_SECTION_H_ #include #include "LIEF/PE/enums.h" /** @defgroup pe_section_c_api Section * @ingroup pe_c_api * @addtogroup pe_section_c_api * @brief Section C API * * @{ */ #ifdef __cplusplus extern "C" { #endif struct Pe_Section_t { const char* name; uint64_t virtual_address; uint64_t size; uint64_t offset; uint32_t virtual_size; uint32_t pointerto_relocation; uint32_t pointerto_line_numbers; uint32_t characteristics; uint8_t* content; uint64_t content_size; double entropy; }; typedef struct Pe_Section_t Pe_Section_t; #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/PE/enums.h000066400000000000000000000005311443457337100172660ustar00rootroot00000000000000#ifndef LIEF_PE_C_ENUMS_H_ #define LIEF_PE_C_ENUMS_H_ #include "LIEF/PE/undef.h" #ifdef __cplusplus extern "C" { #endif #define _LIEF_EN(N) LIEF_PE_##N #define _LIEF_EN_2(N, TYPE) LIEF_PE_##N #define _LIEF_EI(X) LIEF_PE_##X #include "LIEF/PE/enums.inc" #undef _LIEF_EN #undef _LIEF_EN_2 #undef _LIEF_EI #ifdef __cplusplus } #endif #endif LIEF-0.13.1/api/c/include/LIEF/logging.h000066400000000000000000000022121443457337100172570ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "LIEF/visibility.h" #ifndef C_LIEF_LOGGING_H_ #define C_LIEF_LOGGING_H_ /** @defgroup logging_c_api Logging * @brief Logging C API * * @{ */ #ifdef __cplusplus extern "C" { #endif /** @brief Disable the logging module */ LIEF_API void lief_logging_disable(void); /** @brief Enable the logging module globally*/ LIEF_API void lief_logging_enable(void); /** @brief Update logging level */ LIEF_API void lief_logging_set_level(uint32_t level); #ifdef __cplusplus } #endif /** @} */ #endif LIEF-0.13.1/api/c/include/LIEF/types.h000066400000000000000000000014041443457337100167770ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_C_TYPES_H_ #define LIEF_C_TYPES_H_ #include #ifndef __cplusplus #ifndef bool typedef int bool; #endif #endif #endif LIEF-0.13.1/api/c/logging.cpp000066400000000000000000000016211443457337100154530ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/logging.hpp" #include "LIEF/logging.h" using namespace LIEF::logging; void lief_logging_disable(void) { disable(); } void lief_logging_enable(void) { enable(); } void lief_logging_set_level(uint32_t level) { set_level(static_cast(level)); } LIEF-0.13.1/api/python/000077500000000000000000000000001443457337100144205ustar00rootroot00000000000000LIEF-0.13.1/api/python/CMakeLists.txt000066400000000000000000000142461443457337100171670ustar00rootroot00000000000000cmake_minimum_required(VERSION 3.1) find_package(Python COMPONENTS Interpreter Development.Module REQUIRED) # Avoid warning about DOWNLOAD_EXTRACT_TIMESTAMP in CMake 3.24: if (CMAKE_VERSION VERSION_GREATER_EQUAL "3.24.0") cmake_policy(SET CMP0135 NEW) endif() include(ExternalProject) include(CheckCXXCompilerFlag) include(CheckCCompilerFlag) macro(ADD_FLAG_IF_SUPPORTED flag name) CHECK_C_COMPILER_FLAG("${flag}" "C_SUPPORTS_${name}") CHECK_CXX_COMPILER_FLAG("${flag}" "CXX_SUPPORTS_${name}") if (C_SUPPORTS_${name}) target_compile_options(pyLIEF PRIVATE ${flag}) endif() if (CXX_SUPPORTS_${name}) target_compile_options(pyLIEF PRIVATE ${flag}) endif() endmacro() add_library(lief_pybind11 INTERFACE) if (LIEF_EXTERNAL_PYBIND11) find_package(pybind11 REQUIRED) find_package(PythonLibsNew MODULE REQUIRED) target_link_libraries(lief_pybind11 INTERFACE pybind11::module) get_target_property(PYBIND_INC_DIR pybind11::module INTERFACE_INCLUDE_DIRECTORIES) target_include_directories(lief_pybind11 SYSTEM INTERFACE ${PYBIND_INC_DIR} ${Python_INCLUDE_DIRS}) else() find_package(PythonLibsNew MODULE REQUIRED) set(PYBIND11_VERSION 2.10.1) set(PYBIND11_SHA256 SHA256=fcf94065efcfd0a7a828bacf118fa11c43f6390d0c805e3e6342ac119f2e9976) set(PYBIND11_URL "${THIRD_PARTY_DIRECTORY}/pybind11-${PYBIND11_VERSION}.zip" CACHE STRING "URL to the Pybind11 repo") ExternalProject_Add(lief_pybind11_project URL ${PYBIND11_URL} URL_HASH ${PYBIND11_SHA256} CONFIGURE_COMMAND "" BUILD_COMMAND "" INSTALL_COMMAND "") add_dependencies(lief_pybind11 lief_pybind11_project) ExternalProject_get_property(lief_pybind11_project SOURCE_DIR) target_include_directories(lief_pybind11 SYSTEM INTERFACE "${SOURCE_DIR}/include") endif() message(STATUS "Python version: ${PYTHON_VERSION}") message(STATUS "Python lib: ${PYTHON_LIBRARY}") message(STATUS "Python include: ${PYTHON_INCLUDE_DIR}") message(STATUS "Python interpreter: ${PYTHON_EXECUTABLE}") # Define source files set(LIEF_PYTHON_BASIC_SRC "${CMAKE_CURRENT_SOURCE_DIR}/src/pyLIEF.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/pyUtils.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/pyLogger.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/pyHash.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/pyObject.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/pyErr.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/encoding.cpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/PyIOStream.cpp" ) list(APPEND LIEF_PYTHON_BASIC_SRC "${CMAKE_CURRENT_SOURCE_DIR}/src/pyJson.cpp") set(LIEF_PYTHON_SRC ${LIEF_PYTHON_BASIC_SRC} ) set(LIEF_PYTHON_BASIC_HDR "${CMAKE_CURRENT_SOURCE_DIR}/src/pyErr.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/pyIterators.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/pyLIEF.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/enums_wrapper.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/encoding.hpp" "${CMAKE_CURRENT_SOURCE_DIR}/src/PyIOStream.hpp" ) set(LIEF_PYTHON_HDR ${LIEF_PYTHON_BASIC_HDR} ) source_group("Header Files" FILES ${LIEF_PYTHON_BASIC_HDR}) add_library(pyLIEF SHARED ${LIEF_PYTHON_SRC} ${LIEF_PYTHON_HDR}) target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_SOURCE_DIR}/src" ) target_include_directories(pyLIEF SYSTEM PRIVATE "${PYTHON_INCLUDE_DIR}" "${PYBIND11_SOURCE_DIR}/include") include("${CMAKE_CURRENT_SOURCE_DIR}/src/Abstract/CMakeLists.txt") if(LIEF_ELF) include("${CMAKE_CURRENT_SOURCE_DIR}/src/ELF/CMakeLists.txt") endif() if(LIEF_PE) include("${CMAKE_CURRENT_SOURCE_DIR}/src/PE/CMakeLists.txt") endif() if(LIEF_MACHO) include("${CMAKE_CURRENT_SOURCE_DIR}/src/MachO/CMakeLists.txt") endif() if(LIEF_OAT) include("${CMAKE_CURRENT_SOURCE_DIR}/src/OAT/CMakeLists.txt") endif() if(LIEF_DEX) include("${CMAKE_CURRENT_SOURCE_DIR}/src/DEX/CMakeLists.txt") endif() if(LIEF_VDEX) include("${CMAKE_CURRENT_SOURCE_DIR}/src/VDEX/CMakeLists.txt") endif() if(LIEF_ART) include("${CMAKE_CURRENT_SOURCE_DIR}/src/ART/CMakeLists.txt") endif() include("${CMAKE_CURRENT_SOURCE_DIR}/src/platforms/CMakeLists.txt") target_compile_features(pyLIEF PRIVATE cxx_attribute_deprecated) set_target_properties(pyLIEF PROPERTIES POSITION_INDEPENDENT_CODE ON CXX_STANDARD 14 CXX_STANDARD_REQUIRED ON CXX_VISIBILITY_PRESET hidden C_VISIBILITY_PRESET hidden ) set_target_properties(pyLIEF PROPERTIES PYTHON_VERSION ${PYTHON_VERSION}) set(PYLIEF_DEPS_LIBRARIES LIB_LIEF) if(LIEF_COVERAGE) target_compile_options(pyLIEF PRIVATE -g -O0 --coverage -fprofile-arcs -ftest-coverage) set(PYLIEF_DEPS_LIBRARIES ${PYLIEF_DEPS_LIBRARIES} gcov) endif() ADD_FLAG_IF_SUPPORTED("-Wno-macro-redefined" NO_MACRO_REDEFINED) ADD_FLAG_IF_SUPPORTED("-Wno-deprecated-declarations" NO_DEPRECATED_DECLARATIONS) set_target_properties(pyLIEF PROPERTIES PREFIX "" OUTPUT_NAME "lief") target_link_libraries(pyLIEF PRIVATE lief_pybind11 lief_spdlog) if(APPLE) set_target_properties(pyLIEF PROPERTIES MACOSX_RPATH ON LINK_FLAGS "-undefined dynamic_lookup " ) endif() set_target_properties(pyLIEF PROPERTIES PREFIX "") if (UNIX) # Even on osx (c.f. EXT_SUFFIX from sysconfig) set_target_properties(pyLIEF PROPERTIES SUFFIX ".so") elseif(WIN32) set_target_properties(pyLIEF PROPERTIES SUFFIX ".pyd") endif() get_target_property(suffix pyLIEF SUFFIX) set(LIEF_LIBRARY_NAME "lief${suffix}") if (WIN32) set(PYLIEF_DEPS_LIBRARIES ${PYLIEF_DEPS_LIBRARIES} ${PYTHON_LIBRARIES}) endif() target_link_libraries(pyLIEF PUBLIC ${PYLIEF_DEPS_LIBRARIES}) if (CMAKE_BUILD_TYPE MATCHES Release AND UNIX AND NOT APPLE) add_custom_command( TARGET pyLIEF COMMENT "Strip LIEF Python bindings" POST_BUILD COMMAND ${CMAKE_STRIP} --strip-all $ ) endif() if (CMAKE_BUILD_TYPE MATCHES Release AND APPLE) add_custom_command( TARGET pyLIEF COMMENT "Strip LIEF Python bindings" POST_BUILD COMMAND ${CMAKE_STRIP} -x -S $ ) endif() add_custom_command(TARGET pyLIEF POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy $ ${PROJECT_BINARY_DIR}/api/python/lief ) if (MSVC) add_custom_command(TARGET pyLIEF POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy $ ${CMAKE_CURRENT_BINARY_DIR} ) endif() LIEF-0.13.1/api/python/config-default.toml000066400000000000000000000006651443457337100202130ustar00rootroot00000000000000[lief.build] type = "Release" cache = true ninja = true parallel-jobs = 0 [lief.formats] elf = true pe = true macho = true android = true art = true vdex = true oat = true dex = true [lief.features] json = true frozen = true [lief.logging] enabled = true debug = false #[lief.cross-compilation] #osx-arch = "arm64" #[lief.third-party] #spdlog = "/path/to/spdlog-install" LIEF-0.13.1/api/python/examples/000077500000000000000000000000001443457337100162365ustar00rootroot00000000000000LIEF-0.13.1/api/python/examples/abstract_json.py000066400000000000000000000010521443457337100214420ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Dump abstract informations in a JSON format # see: abstract_reader.py import argparse import sys import lief import json def main(): parser = argparse.ArgumentParser() parser.add_argument('binary', help = 'A binary') args = parser.parse_args() binary = lief.parse(args.binary) json_data = json.loads(lief.to_json_from_abstract(binary)) print(json.dumps(json_data, sort_keys = True, indent = 4)) if __name__ == "__main__": sys.exit(main()) LIEF-0.13.1/api/python/examples/abstract_reader.py000066400000000000000000000137501443457337100217430ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Universal format reader. # Input can be PE, ELF or Mach-O import lief import sys import argparse import traceback class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_header(binary): header = binary.header print("== Header ==\n") format_str = "{:<15} {:<30}" format_hex = "{:<15} 0x{:<13x}" format_dec = "{:<15} {:<30d}" modes_str = " - ".join([str(m).split(".")[-1] for m in header.modes]) bitness = "" if header.is_32: bitness = "32-bits" if header.is_64: bitness = "64-bits" print(format_str.format("Architecture:", str(header.architecture).split(".")[-1])) print(format_str.format("Modes:", modes_str)) print(format_hex.format("Entrypoint:", header.entrypoint)) print(format_str.format("Object type:", str(header.object_type).split(".")[-1])) print(format_str.format("Endianness:", str(header.endianness).split(".")[-1])) print(format_str.format("Bitness:", bitness)) print("") @exceptions_handler(Exception) def print_sections(binary): print("== Sections ==") f_title = "|{:<30} | {:<18}| {:<18}| {:<18}| {:<9}|" f_value = "|{:<30} | 0x{:<16x}| 0x{:<16x}| 0x{:<16x}| {:<9.2f}|" print(f_title.format("Name", "File offset", "Size", "Virtual Address", "Entropy")) for section in binary.sections: print(f_value.format(\ section.name,\ section.offset,\ section.size,\ section.virtual_address,\ section.entropy)) print("") @exceptions_handler(Exception) def print_relocations(binary): print("== Relocations ==") f_title = "|{:<18} | {:<6}|" f_value = "|0x{:<16x} | {:<6d}|" print(f_title.format("Address", "Size")) for relocation in binary.relocations: print(f_value.format(\ relocation.address,\ relocation.size)) print("") @exceptions_handler(Exception) def print_symbols(binary): print("== Symbols ==") f = "|{:<30} |" print(f.format("Name")) for symbol in binary.symbols: print(f.format(symbol.name)) print("") @exceptions_handler(Exception) def print_exported_functions(binary): print("== Exported functions ==") f = "|{:<30} |" print(f.format("Name")) for func in binary.exported_functions: print(f.format(func)) print("") @exceptions_handler(Exception) def print_imported_functions(binary): print("== Imported functions ==") f = "|{:<30} |" print(f.format("Name")) for func in binary.imported_functions: print(f.format(func)) print("") @exceptions_handler(Exception) def print_imported_libraries(binary): print("== Imported Libraries ==") f = "|{:<30} |" print(f.format("Name")) for library in binary.libraries: print(f.format(library)) print("") def main(): parser = argparse.ArgumentParser(usage='%(prog)s [options] ') parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Show all information') parser.add_argument('-H', '--header', action='store_true', dest='show_header', help='Display header') parser.add_argument('-i', '--imported', action='store_true', dest='show_imported_functions', help='Display imported functions') parser.add_argument('-L', '--libraries', action='store_true', dest='show_libraries', help='Display Imported Libraries') parser.add_argument('-r', '--relocations', action='store_true', dest='show_relocs', help='Display the relocations (if present)') parser.add_argument('-s', '--symbols', action='store_true', dest='show_symbols', help='Display Symbols') parser.add_argument('-S', '--sections', action='store_true', dest='show_sections', help='Display Sections') parser.add_argument('-x', '--exported', action='store_true', dest='show_exported_functions', help='Display exported functions') parser.add_argument("binary", metavar="", help='Target File') args = parser.parse_args() binary = None try: binary = lief.parse(args.binary) except lief.exception as e: print(e) sys.exit(1) binary = binary.abstract if args.show_header or args.show_all: print_header(binary) if (args.show_imported_functions or args.show_all) and len(binary.imported_functions) > 0: print_imported_functions(binary) if (args.show_exported_functions or args.show_all) and len(binary.exported_functions) > 0: print_exported_functions(binary) if (args.show_libraries or args.show_all) and len(binary.libraries) > 0: print_imported_libraries(binary) if (args.show_sections or args.show_all) and len(binary.sections) > 0: print_sections(binary) if (args.show_symbols or args.show_all) and len(binary.symbols) > 0: print_symbols(binary) if (args.show_relocs or args.show_all) and len(binary.relocations) > 0: print_relocations(binary) if __name__ == "__main__": main() LIEF-0.13.1/api/python/examples/authenticode/000077500000000000000000000000001443457337100207125ustar00rootroot00000000000000LIEF-0.13.1/api/python/examples/authenticode/api_example.py000066400000000000000000000042571443457337100235600ustar00rootroot00000000000000#!/usr/bin/env python import lief import sys import os # Parse PE file pe = lief.parse(sys.argv[1]) sep = (":") if sys.version_info.minor > 7 else () # Get authenticode print(pe.authentihash_md5.hex(*sep)) # 1c:a0:91:53:dc:9a:3a:5f:34:1d:7f:9b:b9:56:69:4d print(pe.authentihash(lief.PE.ALGORITHMS.SHA_1).hex(*sep)) # 1e:ad:dc:29:1e:db:41:a2:69:c2:ba:ae:4b:fb:9d:31:e7:bb:ab:59 # Check signature according to PKCS #7 and Microsoft documentation print(pe.verify_signature()) # Return VERIFICATION_FLAGS.OK bin_ca = None # Look for the root CA in the PE file for crt in pe.signatures[0].certificates: if crt.issuer == "C=US, O=DigiCert Inc, OU=www.digicert.com, CN=DigiCert Assured ID Root CA": bin_ca = crt # Verify CA chain bundle_path = os.getenv("LIEF_CA_BUNDLE", None) # Path to CA bundle (one can use those from signify: # signify/certs/authenticode-bundle.pem) if bundle_path is not None: # Parse cert bundle and return a list of lief.PE.x509 objects bundle = lief.PE.x509.parse(bundle_path) print(bin_ca.is_trusted_by(bundle)) # VERIFICATION_FLAGS.OK # Get the certificate used by the signer cert_signer = pe.signatures[0].signers[0].cert print(cert_signer) bin_ca.verify(cert_signer) # Verify that cert_signer is signed the the CA # running with: # LIEF_CA_BUNDLE=signify/signify/certs/authenticode-bundle.pem python ./authenticode.py avast_free_antivirus_setup_online.exe # # 1c:a0:91:53:dc:9a:3a:5f:34:1d:7f:9b:b9:56:69:4d # 1e:ad:dc:29:1e:db:41:a2:69:c2:ba:ae:4b:fb:9d:31:e7:bb:ab:59 # VERIFICATION_FLAGS.OK # cert. version : 3 # serial number : 04:09:18:1B:5F:D5:BB:66:75:53:43:B5:6F:95:50:08 # issuer name : C=US, O=DigiCert Inc, OU=www.digicert.com, CN=DigiCert Assured ID Root CA # subject name : C=US, O=DigiCert Inc, OU=www.digicert.com, CN=DigiCert SHA2 Assured ID Code Signing CA # issued on : 2013-10-22 12:00:00 # expires on : 2028-10-22 12:00:00 # signed using : RSA with SHA-256 # RSA key size : 2048 bits # basic constraints : CA=true, max_pathlen=0 # key usage : Digital Signature, Key Cert Sign, CRL Sign # ext key usage : Code Signing # # VERIFICATION_FLAGS.OK LIEF-0.13.1/api/python/examples/authenticode/authenticode_reader.py000066400000000000000000000311111443457337100252570ustar00rootroot00000000000000#!/usr/bin/env python import lief from lief.PE import oid_to_string import argparse import json import sys import string import argparse import traceback import pathlib try: from prettyprinter import pprint except ImportError: from pprint import pprint HAS_EXCEPTION = False class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: HAS_EXCEPTION = True if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60, file=sys.stderr) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60, file=sys.stderr) @exceptions_handler(Exception) def print_attr(indent: int, auth: lief.PE.Attribute): if auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.CONTENT_TYPE: print_content_type(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.PKCS9_SIGNING_TIME: print_signing_time(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.MS_SPC_STATEMENT_TYPE: print_ms_statement_type(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.PKCS9_MESSAGE_DIGEST: print_pkcs_msg_dg(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.PKCS9_COUNTER_SIGNATURE: print_pkcs_counter_sig(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.GENERIC_TYPE: print_generic_type(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.SPC_SP_OPUS_INFO: print_spc_sp_opus_info(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.MS_SPC_NESTED_SIGN: print_ms_nested_sig(indent, auth) elif auth.type == lief.PE.SIG_ATTRIBUTE_TYPES.PKCS9_AT_SEQUENCE_NUMBER: print_pkcs9_at_seq_number(indent, auth) else: print(" " * indent, type(auth), auth) @exceptions_handler(Exception) def print_pkcs9_at_seq_number(indent: int, auth: lief.PE.PKCS9AtSequenceNumber): print("{} PKCS #9 sequence number: {}".format(" " * indent, auth.number)) @exceptions_handler(Exception) def print_ms_nested_sig(indent: int, auth: lief.PE.MsSpcNestedSignature): print("{} MS Nested Signature:".format(" " * indent)) print_all(auth.signature, indent + 2) @exceptions_handler(Exception) def print_spc_sp_opus_info(indent: int, auth: lief.PE.SpcSpOpusInfo): if len(auth.program_name) > 0 and len(auth.more_info) > 0: print("{} Info: {} {}".format(" " * indent, auth.program_name, auth.more_info)) elif len(auth.program_name) > 0 and len(auth.more_info) == 0: print("{} Info: {}".format(" " * indent, auth.program_name)) elif len(auth.program_name) == 0 and len(auth.more_info) > 0: print("{} Info: {}".format(" " * indent, auth.more_info)) else: print("{} Info: ".format(" " * indent)) @exceptions_handler(Exception) def print_generic_type(indent: int, auth: lief.PE.GenericType): print("{} Generic Type {} ({})".format(" " * indent, auth.oid, lief.PE.oid_to_string(auth.oid))) @exceptions_handler(Exception) def print_content_type(indent: int, auth: lief.PE.ContentType): print("{} Content Type OID: {} ({})".format(" " * indent, auth.oid, lief.PE.oid_to_string(auth.oid))) @exceptions_handler(Exception) def print_signing_time(indent: int, auth: lief.PE.PKCS9SigningTime): print("{} Signing Time: {}/{:02}/{:02} - {:02}:{:02}:{:02}".format(" " * indent, *auth.time)) @exceptions_handler(Exception) def print_ms_statement_type(indent: int, auth: lief.PE.MsSpcStatementType): print("{} MS Statement type OID: {} ({})".format(" " * indent, auth.oid, lief.PE.oid_to_string(auth.oid))) @exceptions_handler(Exception) def print_pkcs_msg_dg(indent: int, auth: lief.PE.PKCS9MessageDigest): print("{} PKCS9 Message Digest: {}".format(" " * indent, auth.digest.hex())) @exceptions_handler(Exception) def print_crt(indent: int, crt: lief.PE.x509): print("{} Version : {:d}".format(" " * indent, crt.version)) print("{} Issuer : {}".format(" " * indent, crt.issuer)) print("{} Subject : {}".format(" " * indent, crt.subject)) print("{} Serial Number : {}".format(" " * indent, crt.serial_number.hex())) print("{} Signature Algorithm: {}".format(" " * indent, lief.PE.oid_to_string(crt.signature_algorithm))) print("{} Valid from : {}/{:02d}/{:02d} - {:02d}:{:02d}:{:02d}".format(" " * indent, *crt.valid_from)) print("{} Valid to : {}/{:02d}/{:02d} - {:02d}:{:02d}:{:02d}".format(" " * indent, *crt.valid_to)) if len(crt.key_usage) > 0: print("{} Key usage : {}".format(" " * indent, " - ".join(str(e).split(".")[-1] for e in crt.key_usage))) if len(crt.ext_key_usage) > 0: print("{} Ext key usage : {}".format(" " * indent, " - ".join(lief.PE.oid_to_string(e) for e in crt.ext_key_usage))) if crt.rsa_info is not None: rsa_info = crt.rsa_info print("{} RSA key size : {}".format(" " * indent, rsa_info.key_size)) print("{} ===========================================".format(" " * indent)) @exceptions_handler(Exception) def print_pkcs_counter_sig(indent: int, auth: lief.PE.PKCS9CounterSignature): print("{} PKCS9 counter signature".format(" " * indent)) signer = auth.signer print("{} Version : {:d}".format(" " * indent, signer.version)) print("{} Serial Number : {}".format(" " * indent, signer.serial_number.hex())) print("{} Issuer : {}".format(" " * indent, signer.issuer)) print("{} Digest Algorithm : {}".format(" " * indent, signer.digest_algorithm)) print("{} Encryption Algorithm: {}".format(" " * indent, signer.encryption_algorithm)) print("{} Encrypted Digest : {} ...".format(" " * indent, signer.encrypted_digest.hex()[:20])) if len(signer.authenticated_attributes) > 0: print("{} Authenticated attributes:".format(" " * indent)) for auth in signer.authenticated_attributes: print_attr(indent + 4, auth) if len(signer.unauthenticated_attributes) > 0: print("{} Un-Authenticated attributes:".format(" " * indent)) for auth in signer.unauthenticated_attributes: print_attr(indent + 4, auth) @exceptions_handler(Exception) def print_all(sig: lief.PE.Signature, indent: int = 2): ci: lief.PE.ContentInfo = sig.content_info print("{}Signature version : {}".format(" " * indent, sig.version)) print("{}Digest Algorithm : {!s}".format(" " * indent, sig.digest_algorithm)) print("{}Content Info:".format(" " * indent)) print("{} Content Type : {!s} ({})".format(" " * indent, ci.content_type, lief.PE.oid_to_string(ci.content_type))) print("{} Digest Algorithm: {!s}".format(" " * indent, ci.digest_algorithm)) print("{} Digest : {!s}".format(" " * indent, ci.digest.hex())) print("{}Certificates".format(" " * indent)) for crt in sig.certificates: print_crt(indent, crt) print("{}Signer(s)".format(" " * indent)) for signer in sig.signers: print("{} Version : {:d}".format(" " * indent, signer.version)) print("{} Serial Number : {}".format(" " * indent, signer.serial_number.hex())) print("{} Issuer : {}".format(" " * indent, signer.issuer)) print("{} Digest Algorithm : {}".format(" " * indent, signer.digest_algorithm)) print("{} Encryption Algorithm: {}".format(" " * indent, signer.encryption_algorithm)) print("{} Encrypted Digest : {} ...".format(" " * indent, signer.encrypted_digest.hex()[:20])) if len(signer.authenticated_attributes) > 0: print("{} Authenticated attributes:".format(" " * indent)) for auth in signer.authenticated_attributes: print_attr(indent + 4, auth) if len(signer.unauthenticated_attributes) > 0: print("{} Un-authenticated attributes:".format(" " * indent)) for auth in signer.unauthenticated_attributes: print_attr(indent + 4, auth) @exceptions_handler(Exception) def show_crts(sig: lief.PE.Signature, args): for crt in sig.certificates: print_crt(0, crt) @exceptions_handler(Exception) def process_signature(sig: lief.PE.Signature, args): if args.show_all: print_all(sig) if args.show_crt: show_crts(sig, args) if args.show_hash: print("Authentihash: {}".format(sig.content_info.digest.hex())) def main(): parser = argparse.ArgumentParser() parser.add_argument("file") parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Show all information') parser.add_argument('-c', '--crt', action='store_true', dest='show_crt', help='Show embedded x509 certificates') parser.add_argument('-H', '--hash', action='store_true', dest='show_hash', help='Show the autentihash value') parser.add_argument('-C', '--check', action='store_true', dest='check_sig', help='Check the signature') parser.add_argument('-D', '--allow-expired', action='store_true', dest='allow_expired', help='Allow expired certificates') parser.add_argument('-s', '--save', dest='ext_file_path', help='Extract and save the PKCS #7') # Logging setup logger_group = parser.add_argument_group('Logger') verbosity = logger_group.add_mutually_exclusive_group() verbosity.add_argument('--debug', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.DEBUG) verbosity.add_argument('--trace', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.TRACE) verbosity.add_argument('--info', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.INFO) verbosity.add_argument('--warn', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.WARNING) verbosity.add_argument('--err', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.ERROR) verbosity.add_argument('--critical', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.CRITICAL) parser.set_defaults(main_verbosity=lief.logging.LOGGING_LEVEL.WARNING) args = parser.parse_args() lief.logging.set_level(args.main_verbosity) if lief.PE.is_pe(args.file): binary = None try: binary: lief.PE.Binary = lief.PE.parse(args.file) if binary is None: print("Error while parsing {}".format(args.file)) sys.exit(1) except lief.exception as e: print(e) sys.exit(1) if args.check_sig: flags = lief.PE.Signature.VERIFICATION_CHECKS.DEFAULT if args.allow_expired: flags = lief.PE.Signature.VERIFICATION_CHECKS.SKIP_CERT_TIME res = binary.verify_signature(flags) print(res) if args.show_hash: print("Binary MD5 authentihash: {}".format(binary.authentihash_md5.hex())) print("Binary SHA-1 authentihash: {}".format(binary.authentihash_sha1.hex())) print("Binary SHA-256 authentihash: {}".format(binary.authentihash_sha256.hex())) for idx, sig in enumerate(binary.signatures): process_signature(sig, args) if args.ext_file_path: path = args.ext_file_path if idx > 0: path += str(idx) if not path.endswith(".p7b"): path += ".p7b" outpath = pathlib.Path(path) outpath.write_bytes(sig.raw_der) print("Signature saved to {}".format(outpath)) else: # Try as a regular p7b signature sig = lief.PE.Signature.parse(args.file) if sig is None: print("Fail to parse the signature") sys.exit(1) process_signature(sig, args) if __name__ == "__main__": main() if HAS_EXCEPTION: sys.exit(1) LIEF-0.13.1/api/python/examples/change_elf_interpreter.py000066400000000000000000000031341443457337100233070ustar00rootroot00000000000000#!/usr/bin/env python import lief import argparse import os import stat import sys def change_interpreter(target, interpreter, output=None): if not os.path.isfile(target) or not lief.is_elf(target): print("Wrong target! ({})".format(target)) return 1 if not os.path.isfile(interpreter) or not lief.is_elf(interpreter): print("Wrong interpreter! ({})".format(interpreter)) return 1 binary = lief.parse(target) if not binary.has_interpreter: print("The given target doesn't have interpreter!") return 1 binary.interpreter = interpreter output_path = output if output_path is None: output_path = os.path.basename(target) output_path += "_updated" if os.path.isfile(output_path): os.remove(output_path) binary.write(output_path) # Set as executable st = os.stat(output_path) os.chmod(output_path, st.st_mode | stat.S_IEXEC) return 0 def main(): parser = argparse.ArgumentParser(description='Change the ELF interpreter of the given binary') parser.add_argument("-o", "--output", help = 'Path to the binary rewritten', action = 'store', default = None) parser.add_argument("target", metavar="", help='Target ELF file') parser.add_argument("interpreter", metavar="", help='Path to the new interpreter') args = parser.parse_args() status = change_interpreter(args.target, args.interpreter, args.output) sys.exit(status) if __name__ == "__main__": main() LIEF-0.13.1/api/python/examples/dex_json.py000066400000000000000000000011741443457337100204240ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about a DEX file in the JSON format import argparse import sys import lief import json def main(): parser = argparse.ArgumentParser() parser.add_argument('file', help='DEX binary') args = parser.parse_args() if not lief.DEX.is_dex(args.file): print("{} is not a DEX file".format(args.file)) return 1 dexfile = lief.DEX.parse(args.file) json_data = json.loads(lief.to_json(dexfile)) print(json.dumps(json_data, sort_keys = True, indent = 4)) if __name__ == "__main__": sys.exit(main()) LIEF-0.13.1/api/python/examples/dex_reader.py000066400000000000000000000151411443457337100207140ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about Android DEX files import sys import os import argparse import traceback import lief from lief import DEX EXIT_STATUS = 0 terminal_rows, terminal_columns = 100, 100 try: terminal_rows, terminal_columns = os.popen('stty size', 'r').read().split() except ValueError: pass class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: global EXIT_STATUS print("{} raised: {}".format(self.func.__name__, e)) EXIT_STATUS = 1 if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_information(dexfile): print("== Information ==") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" version = dexfile.version print("DEX File version: {}".format(version)) print("") @exceptions_handler(Exception) def print_header(dexfile): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" print("== Header ==") header = dexfile.header print(header) @exceptions_handler(Exception) def print_classes(dexfile): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" classes = dexfile.classes print("== Classes ==") for cls in classes: print(cls) @exceptions_handler(Exception) def print_fields(dexfile): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" fields = dexfile.fields print("== Fields ==") for f in fields: print(f) @exceptions_handler(Exception) def print_methods(dexfile): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" methods = dexfile.methods print("== Methods ==") for m in methods: print(m) @exceptions_handler(Exception) def print_strings(dexfile): print("== Strings ==") for s in dexfile.strings: print(s) @exceptions_handler(Exception) def print_types(dexfile): print("== Types ==") for t in dexfile.types: print(t) @exceptions_handler(Exception) def print_prototypes(dexfile): print("== Prototypes ==") for t in dexfile.prototypes: print(t) @exceptions_handler(Exception) def print_map(dexfile): print("== Map ==") print(dexfile.map) def main(): parser = argparse.ArgumentParser(usage='%(prog)s [options] DEX files') parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Show all information') parser.add_argument('-H', '--header', action='store_true', dest='show_header', help='Display header') parser.add_argument('-c', '--classes', action='store_true', dest='show_classes', help='Display classes') parser.add_argument('-f', '--fields', action='store_true', dest='show_fields', help='Display Fields') parser.add_argument('-m', '--methods', action='store_true', dest='show_methods', help='Display Methods') parser.add_argument('-s', '--strings', action='store_true', dest='show_strings', help='Display Strings') parser.add_argument('-t', '--types', action='store_true', dest='show_types', help='Display Types') parser.add_argument('-p', '--prototypes', action='store_true', dest='show_prototypes', help='Display Prototypes') parser.add_argument('-M', '--map', action='store_true', dest='show_map', help='Display Map') parser.add_argument("file", metavar="", help='Target DEX File') logger_group = parser.add_argument_group('Logger') verbosity = logger_group.add_mutually_exclusive_group() verbosity.add_argument('--debug', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.DEBUG) verbosity.add_argument('--trace', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.TRACE) verbosity.add_argument('--info', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.INFO) verbosity.add_argument('--warn', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.WARNING) verbosity.add_argument('--err', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.ERROR) verbosity.add_argument('--critical', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.CRITICAL) parser.set_defaults(main_verbosity=lief.logging.LOGGING_LEVEL.WARNING) args = parser.parse_args() lief.logging.set_level(args.main_verbosity) binary = None try: dexfile = DEX.parse(args.file) except lief.exception as e: print(e) sys.exit(1) print_information(dexfile) if args.show_header or args.show_all: print_header(dexfile) if (args.show_classes or args.show_all) and len(dexfile.classes) > 0: print_classes(dexfile) if (args.show_fields or args.show_all) and len(dexfile.fields) > 0: print_fields(dexfile) if (args.show_methods or args.show_all) and len(dexfile.methods) > 0: print_methods(dexfile) if (args.show_strings or args.show_all) and len(dexfile.strings) > 0: print_strings(dexfile) if (args.show_types or args.show_all) and len(dexfile.types) > 0: print_types(dexfile) if (args.show_prototypes or args.show_all) and len(dexfile.prototypes) > 0: print_prototypes(dexfile) if args.show_map or args.show_all: print_map(dexfile) sys.exit(EXIT_STATUS) if __name__ == "__main__": main() LIEF-0.13.1/api/python/examples/elf_bin2lib.py000066400000000000000000000016241443457337100207620ustar00rootroot00000000000000#!/usr/bin/env python import argparse import lief import sys def bin2lib(binary, address, output, name=""): if not binary.is_pie: print("It only works with PIE binaries") sys.exit(1) function = binary.add_exported_function(address, name) print("Function created:") print(function) binary.write(output) if __name__ == "__main__": parser = argparse.ArgumentParser(description="") parser.add_argument("--name", "-n", default="", help="Name of the function to create") parser.add_argument("--output", "-o", default="libfoo.so", help="Output name. (Default: %(default)") parser.add_argument("binary", help="The target binary") parser.add_argument("address", type=lambda e: int(e, 0), help="Address of the function to export") args = parser.parse_args() binary = lief.parse(args.binary) bin2lib(binary, args.address, args.output, name=args.name) LIEF-0.13.1/api/python/examples/elf_json.py000066400000000000000000000014771443457337100204200ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about a ELF binary in the JSON format # # python elf_json.py /bin/ls #   # { # "dynamic_entries": [ # { # "library": "libcap.so.2", # "tag": "NEEDED", # "value": 1 # }, # { # "library": "libc.so.6", # "tag": "NEEDED", # "value": 74 # }, # ... import argparse import sys import lief import json def main(): parser = argparse.ArgumentParser() parser.add_argument('binary', help='ELF binary') args = parser.parse_args() binary = lief.parse(args.binary) json_data = json.loads(lief.to_json(binary)) print(json.dumps(json_data, sort_keys = True, indent = 4)) if __name__ == "__main__": sys.exit(main()) LIEF-0.13.1/api/python/examples/elf_reader.py000066400000000000000000000546411443457337100207120ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about an ELF binary import os import sys import textwrap import traceback import lief from lief import ELF import argparse terminal_rows, terminal_columns = 100, 110 try: terminal_rows, terminal_columns = os.popen('stty size', 'r').read().split() except ValueError: pass terminal_columns = int(terminal_columns) - 10 terminal_rows = int(terminal_rows) class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_header(binary): header = binary.header identity = header.identity print("== Header ==\n") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<13x}" format_dec = "{:<30} {:<30d}" format_ide = "{:<30} {:<02x} {:<02x} {:<02x} {:<02x}" eflags_str = "" if header.machine_type == lief.ELF.ARCH.ARM: eflags_str = " - ".join([str(s).split(".")[-1] for s in header.arm_flags_list]) if header.machine_type in [lief.ELF.ARCH.MIPS, lief.ELF.ARCH.MIPS_RS3_LE, lief.ELF.ARCH.MIPS_X]: eflags_str = " - ".join([str(s).split(".")[-1] for s in header.mips_flags_list]) if header.machine_type == lief.ELF.ARCH.PPC64: eflags_str = " - ".join([str(s).split(".")[-1] for s in header.ppc64_flags_list]) if header.machine_type == lief.ELF.ARCH.HEXAGON: eflags_str = " - ".join([str(s).split(".")[-1] for s in header.hexagon_flags_list]) print(identity) print(format_ide.format("Magic:", identity[0], identity[1], identity[2], identity[3])) print(format_str.format("Class:", str(header.identity_class).split(".")[-1])) print(format_str.format("Endianness:", str(header.identity_data).split(".")[-1])) print(format_str.format("Version:", str(header.identity_version).split(".")[-1])) print(format_str.format("OS/ABI:", str(header.identity_os_abi).split(".")[-1])) print(format_dec.format("ABI Version:", header.identity_abi_version)) print(format_str.format("File Type:", str(header.file_type).split(".")[-1])) print(format_str.format("Machine Type:", str(header.machine_type).split(".")[-1])) print(format_str.format("Object File Version:", str(header.object_file_version).split(".")[-1])) print(format_hex.format("Entry Point:", header.entrypoint)) print(format_hex.format("Program Header Offset:", header.program_header_offset)) print(format_hex.format("Section Header Offset:", header.section_header_offset)) print(format_hex.format("Processor flags:", header.processor_flag) + eflags_str) print(format_dec.format("Header Size:", header.header_size)) print(format_dec.format("Program Header Size:", header.program_header_size)) print(format_dec.format("Section Header Size:", header.section_header_size)) print(format_dec.format("Number of segments:", header.numberof_segments)) print(format_dec.format("Number of sections:", header.numberof_sections)) print("") @exceptions_handler(Exception) def print_sections(binary): sections = binary.sections if len(sections) > 0: print("== Sections ==\n") f_title = "|{:<30} | {:<12}| {:<17}| {:<12}| {:<10}| {:<8}| {:<8}|" f_value = "|{:<30} | {:<12}| 0x{:<14x} | 0x{:<10x}| 0x{:<8x}| {:<8.2f}| {:<10}" print(f_title.format("Name", "Type", "Virtual address", "File offset", "Size", "Entropy", "Segment(s)")) for section in sections: segments_str = " - ".join([str(s.type).split(".")[-1] for s in section.segments]) print(f_value.format( section.name, str(section.type).split(".")[-1], section.virtual_address, section.file_offset, section.size, abs(section.entropy), segments_str)) print("") else: print("No sections") @exceptions_handler(Exception) def print_segments(binary): segments = binary.segments # Segments if len(segments) > 0: print("== Segments ==\n") f_title = "|{:<30} | {:<10}| {:<18}| {:<17}| {:<17}| {:<17}| {:<19}|" f_value = "|{:<30} | {:<10}| 0x{:<16x}| 0x{:<15x}| 0x{:<15x}| 0x{:<15x}| {}" print(f_title.format("Type", "Flags", "File offset", "Virtual Address", "Virtual Size", "Size", "Sections")) for segment in segments: sections = segment.sections s = ", ".join([section.name for section in sections]) flags_str = ["-"] * 3 if ELF.SEGMENT_FLAGS.R in segment: flags_str[0] = "r" if ELF.SEGMENT_FLAGS.W in segment: flags_str[1] = "w" if ELF.SEGMENT_FLAGS.X in segment: flags_str[2] = "x" flags_str = "".join(flags_str) print(f_value.format( str(segment.type).split(".")[-1], flags_str, segment.file_offset, segment.virtual_address, segment.virtual_size, segment.physical_size, s)) print("") else: print("No segments") @exceptions_handler(Exception) def print_dynamic_entries(binary): dynamic_entries = binary.dynamic_entries # Dynamic entries if len(dynamic_entries) == 0: return print("== Dynamic entries ==\n") f_title = "|{:<16} | {:<10}| {:<20}|" f_value = "|{:<16} | 0x{:<8x}| {:<20}|" print(f_title.format("Tag", "Value", "Info")) for entry in dynamic_entries: if entry.tag == ELF.DYNAMIC_TAGS.NULL: continue if entry.tag in [ELF.DYNAMIC_TAGS.SONAME, ELF.DYNAMIC_TAGS.NEEDED, ELF.DYNAMIC_TAGS.RUNPATH, ELF.DYNAMIC_TAGS.RPATH]: print(f_value.format(str(entry.tag).split(".")[-1], entry.value, entry.name)) elif type(entry) is ELF.DynamicEntryArray: # [ELF.DYNAMIC_TAGS.INIT_ARRAY,ELF.DYNAMIC_TAGS.FINI_ARRAY]: print(f_value.format(str(entry.tag).split(".")[-1], entry.value, ", ".join(map(hex, entry.array)))) elif entry.tag == ELF.DYNAMIC_TAGS.FLAGS: flags_str = " - ".join([str(ELF.DYNAMIC_FLAGS(s)).split(".")[-1] for s in entry.flags]) print(f_value.format(str(entry.tag).split(".")[-1], entry.value, flags_str)) elif entry.tag == ELF.DYNAMIC_TAGS.FLAGS_1: flags_str = " - ".join([str(ELF.DYNAMIC_FLAGS_1(s)).split(".")[-1] for s in entry.flags]) print(f_value.format(str(entry.tag).split(".")[-1], entry.value, flags_str)) else: print(f_value.format(str(entry.tag).split(".")[-1], entry.value, "")) print("") @exceptions_handler(Exception) def print_symbols(symbols, no_trunc): can_demangle = len(symbols) > 0 and len(symbols[0].demangled_name) > 0 if can_demangle: maxsize = max([len(symbol.demangled_name) for symbol in symbols]) else: maxsize = max([len(symbol.name) for symbol in symbols]) SIZE = 70 maxsize = min(maxsize, terminal_columns - SIZE) if terminal_columns > SIZE else terminal_columns f_title = "|{:<" + str(maxsize) + "} | {:<7}| {:<8}| {:<10}| {:<8}| {:<4}| {:<14}|" f_value = "|{:<" + str(maxsize) + "} | {:<7}| {:<8x}| {:<10}| {:<8}| {:<4}| {:<14}|" print(f_title.format("Name", "Type", "Value", "Visibility", "Binding", "I/E", "Version")) for symbol in symbols: symbol_version = symbol.symbol_version if symbol.has_version else "" import_export = "" if symbol.imported: import_export = "I" if symbol.exported: import_export = "E" symbol_name = symbol.demangled_name if len(symbol_name) == 0: symbol_name = symbol.name wrapped = textwrap.wrap(symbol_name, maxsize) if len(wrapped) <= 1 or no_trunc: symbol_name = symbol_name else: symbol_name = wrapped[0][:-3] + "..." print(f_value.format( symbol_name, str(symbol.type).split(".")[-1], symbol.value, str(symbol.visibility).split(".")[-1], str(symbol.binding).split(".")[-1], import_export, str(symbol_version) )) @exceptions_handler(Exception) def print_dynamic_symbols(binary, args): print("== Dynamic symbols ==\n") print_symbols(binary.dynamic_symbols, args.no_trunc) @exceptions_handler(Exception) def print_static_symbols(binary, args): print("== Static symbols ==\n") print_symbols(binary.static_symbols, args.no_trunc) @exceptions_handler(Exception) def print_relocations(binary, relocations): f_title = "|{:<10} | {:<10}| {:<8}| {:<8}| {:<8}| {:<15}| {:<30} |" f_value = "|0x{:<8x} | {:<10}| {:<8d}| {:<8d}| {:<8x}| {:<15}| {:<30} |" print(f_title.format("Address", "Type", "Info", "Size", "Addend", "Purpose", "Symbol")) for relocation in relocations: type = str(relocation.type) if binary.header.machine_type == ELF.ARCH.x86_64: type = str(ELF.RELOCATION_X86_64(relocation.type)) elif binary.header.machine_type == ELF.ARCH.i386: type = str(ELF.RELOCATION_i386(relocation.type)) elif binary.header.machine_type == ELF.ARCH.ARM: type = str(ELF.RELOCATION_ARM(relocation.type)) elif binary.header.machine_type == ELF.ARCH.AARCH64: type = str(ELF.RELOCATION_AARCH64(relocation.type)) symbol_name = "" if relocation.has_symbol: symbol: lief.ELF.Symbol = relocation.symbol if len(symbol.name) > 0: symbol_name = symbol.name elif symbol.type == lief.ELF.SYMBOL_TYPES.SECTION: shndx = symbol.shndx sections = binary.sections if 0 < shndx and shndx < len(sections): symbol_name = sections[shndx].name + " + " + hex(relocation.addend) else: symbol_name = "
".format(shndx) print(f_value.format( relocation.address, type.split(".")[-1], relocation.info, relocation.size, relocation.addend, str(relocation.purpose).split(".")[-1], symbol_name)) @exceptions_handler(Exception) def print_all_relocations(binary): dynamicrelocations = binary.dynamic_relocations pltgot_relocations = binary.pltgot_relocations object_relocations = binary.object_relocations if len(dynamicrelocations) > 0: print("== Dynamic Relocations ==\n") print_relocations(binary, dynamicrelocations) if len(pltgot_relocations) > 0: print("== PLT/GOT Relocations ==\n") print_relocations(binary, pltgot_relocations) if len(object_relocations) > 0: print("== Object Relocations ==\n") print_relocations(binary, object_relocations) @exceptions_handler(Exception) def print_exported_symbols(binary, args): symbols = binary.exported_symbols print("== Exported symbols ==\n") if len(symbols) == 0: print("No exports!") return print_symbols(symbols, args.no_trunc) @exceptions_handler(Exception) def print_imported_symbols(binary, args): symbols = binary.imported_symbols print("== Imported symbols ==\n") if len(symbols) == 0: print("No imports!") return print_symbols(symbols, args.no_trunc) @exceptions_handler(Exception) def print_information(binary): print("== Information ==\n") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" print(format_str.format("Name:", binary.name)) print(format_hex.format("Address base:", binary.imagebase)) print(format_hex.format("Virtual size:", binary.virtual_size)) print(format_str.format("PIE:", str(binary.is_pie))) print(format_str.format("NX:", str(binary.has_nx))) @exceptions_handler(Exception) def print_gnu_hash(binary): print("== GNU Hash ==\n") if not binary.use_gnu_hash: return gnu_hash = binary.gnu_hash format_str = "{:<30} {}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" print(format_dec.format("Number of buckets:", gnu_hash.nb_buckets)) print(format_dec.format("First symbol index:", gnu_hash.symbol_index)) print(format_hex.format("Shift Count:", gnu_hash.shift2)) print(format_str.format("Bloom filters:", gnu_hash.bloom_filters)) print(format_str.format("Buckets:", gnu_hash.buckets)) print(format_str.format("Hash values:", gnu_hash.hash_values)) @exceptions_handler(Exception) def print_sysv_hash(binary): print("== SYSV Hash ==\n") if not binary.use_sysv_hash: return sysv_hash = binary.sysv_hash format_str = "{:<30} {}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" print(format_dec.format("Number of buckets:", sysv_hash.nbucket)) print(format_dec.format("Number of chains:", sysv_hash.nchain)) print(format_str.format("Buckets:", sysv_hash.buckets)) print(format_str.format("Chains:", sysv_hash.chains)) @exceptions_handler(Exception) def print_notes(binary): print("== Notes ==\n") format_str = "{:<19} {}" format_hex = "{:<19} 0x{:<28x}" format_dec = "{:<19} {:<30d}" notes = binary.notes for idx, note in enumerate(notes): description = note.description description_str = " ".join(map(lambda e : "{:02x}".format(e), description[:16])) if len(description) > 16: description_str += " ..." print("Note #{:d}".format(idx)) type_str = note.type_core if note.is_core else note.type type_str = str(type_str).split(".")[-1] print(format_str.format("Name:", note.name)) print(format_str.format("Type:", type_str)) print(format_str.format("Description:", description_str)) note_details = note.details if type(note_details) == lief.ELF.AndroidNote: print(format_dec.format("SDK Version:", note_details.sdk_version)) print(format_str.format("NDK Version:", note_details.ndk_version)) print(format_str.format("NDK build number:", note_details.ndk_build_number)) if type(note_details) == lief.ELF.NoteAbi: version = note_details.version version_str = "{:d}.{:d}.{:d}".format(version[0], version[1], version[2]) print(format_str.format("ABI:", note_details.abi)) print(format_str.format("Version:", version_str)) if ELF.NOTE_TYPES(note.type) == ELF.NOTE_TYPES.GOLD_VERSION: print(format_str.format("Version:", "".join(map(chr, note.description)))) if note.is_core: print(note_details) print("\n") @exceptions_handler(Exception) def print_ctor(binary): print("== Constructors ==\n") print("Functions: ({:d})".format(len(binary.ctor_functions))) for idx, f in enumerate(binary.ctor_functions): print(" [{:d}] {}: 0x{:x}".format(idx, f.name, f.address)) @exceptions_handler(Exception) def print_strings(binary): print("== Strings ==\n") strings = binary.strings print("Strings: ({:d})".format(len(binary.strings))) for s in strings: print(" {}".format(s)) @exceptions_handler(Exception) def print_functions(binary): print("== Functions ==\n") functions = binary.functions print("Functions: ({:d})".format(len(functions))) for idx, f in enumerate(functions): print(" [{:d}] {}: 0x{:x}".format(idx, f.name, f.address)) def main(): parser = argparse.ArgumentParser(add_help=False, prog=sys.argv[0]) parser.add_argument("elf_file") parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Equivalent to: -h -l -S -s -r -d -V') parser.add_argument('-d', '--dynamic', action='store_true', dest='show_dynamic_tags', help='Display the dynamic section') parser.add_argument('-H', '--help', action='help', dest='help', help='Display this information') parser.add_argument('-h', '--file-header', action='store_true', dest='show_file_header', help='Display the ELF file header') parser.add_argument('-i', '--imported', action='store_true', dest='show_imported_symbols', help='Display imported symbols') parser.add_argument('-l', '--program-headers', '--segments', action='store_true', dest='show_program_header', help='Display the program headers') parser.add_argument('-S', '--section-headers', '--sections', action='store_true', dest='show_section_header', help="Display the sections' headers") parser.add_argument('-e', '--headers', action='store_true', dest='show_all_headers', help='Equivalent to: -h -l -S') parser.add_argument('-s', '--symbols', '--syms', action='store_true', dest='show_symbols', help='Display the symbol table') parser.add_argument('--dynamic-symbols', '--dsyms', action='store_true', dest='show_dynamic_symbols', help='Display the dynamic symbols') parser.add_argument('--static-symbols', '--ssyms', action='store_true', dest='show_static_symbols', help='Display the static symbols') parser.add_argument('-r', '--relocs', action='store_true', dest='show_relocs', help='Display the relocations (if present)') parser.add_argument('-V', '--version-info', action='store_true', dest='show_version_info', help='Display the version sections (if present)') parser.add_argument('-x', '--exported', action='store_true', dest='show_exported_symbols', help='Display exported symbols') parser.add_argument('--gnu-hash', action='store_true', dest='show_gnu_hash', help='Display GNU Hash') parser.add_argument('--sysv-hash', action='store_true', dest='show_sysv_hash', help='Display SYSV Hash') parser.add_argument('-n', '--notes', action='store_true', dest='show_notes', help='Display Notes') parser.add_argument('--no-trunc', action='store_true', dest='no_trunc', default=False, help='Do not trunc symbol names ...') parser.add_argument('--ctor', action='store_true', dest='show_ctor', help='Constructor functions') parser.add_argument('--strings', action='store_true', dest='show_strings', help='Strings present in the current ELF') parser.add_argument('--functions', action='store_true', dest='show_functions', help='List all function addresses found') # Logging setup logger_group = parser.add_argument_group('Logger') verbosity = logger_group.add_mutually_exclusive_group() verbosity.add_argument('--debug', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.DEBUG) verbosity.add_argument('--trace', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.TRACE) verbosity.add_argument('--info', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.INFO) verbosity.add_argument('--warn', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.WARNING) verbosity.add_argument('--err', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.ERROR) verbosity.add_argument('--critical', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.CRITICAL) parser.set_defaults(main_verbosity=lief.logging.LOGGING_LEVEL.WARNING) args = parser.parse_args() lief.logging.set_level(args.main_verbosity) binary = ELF.parse(args.elf_file) print_information(binary) if args.show_all: do_file_header = do_section_header = do_program_header = True if args.show_all_headers: do_file_header = do_section_header = do_program_header = True else: do_file_header = args.show_file_header do_section_header = args.show_section_header do_program_header = args.show_program_header if do_file_header or args.show_all: print_header(binary) if do_section_header or args.show_all: print_sections(binary) if do_program_header or args.show_all: print_segments(binary) if args.show_dynamic_tags or args.show_all: print_dynamic_entries(binary) if (args.show_symbols or args.show_all or args.show_dynamic_symbols) and len(binary.dynamic_symbols) > 0: print_dynamic_symbols(binary, args) if (args.show_symbols or args.show_all or args.show_static_symbols) and len(binary.static_symbols) > 0: print_static_symbols(binary, args) if args.show_relocs or args.show_all: print_all_relocations(binary) if args.show_imported_symbols or args.show_all: print_imported_symbols(binary, args) if args.show_exported_symbols or args.show_all: print_exported_symbols(binary, args) if (args.show_gnu_hash or args.show_all) and binary.use_gnu_hash: print_gnu_hash(binary) if (args.show_sysv_hash or args.show_all) and binary.use_sysv_hash: print_sysv_hash(binary) if args.show_notes or args.show_all: print_notes(binary) if args.show_ctor or args.show_all: print_ctor(binary) if args.show_strings or args.show_all: print_strings(binary) if args.show_functions: print_functions(binary) if __name__ == "__main__": main() LIEF-0.13.1/api/python/examples/elf_remove_section_table.py000066400000000000000000000020331443457337100236240ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Remove the section table from an ELF binary # so that some tools are blow minded (e.g. gdb) # # Example: # $ python elf_remove_section_table.py /bin/ls ls_without_sections # $ ls # elf_remove_section_table.py ls_without_sections # $ ls_without_sections # $ elf_remove_section_table.py ls_without_sections # $ readelf -S ls_without_sections # # Il n'y a pas de section dans ce fichier. # $ gdb ls_without_sections # "ls_without_sections": not in executable format: File format not recognized import sys import lief from lief import ELF def remove_section_table(filename, output): binary = lief.parse(filename) # Build an ELF binary header = binary.header header.section_header_offset = 0; header.numberof_sections = 0; binary.write(output); if __name__ == "__main__": if len(sys.argv) != 3: print("Usage: {} ".format(sys.argv[0])) sys.exit(1) remove_section_table(sys.argv[1], sys.argv[2]) LIEF-0.13.1/api/python/examples/elf_symbol_obfuscation.py000066400000000000000000000032411443457337100233370ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # In this example, we replace all statics symbols in the .symtab # with a random name. # # Example: # # >>> readelf -s ./hello_c # # 28: 0600700 0 OBJECT LOCAL DEFAULT 19 __JCR_LIST__ # 29: 0400420 0 FUNC LOCAL DEFAULT 12 deregister_tm_clones # 30: 0400460 0 FUNC LOCAL DEFAULT 12 register_tm_clones # 31: 04004a0 0 FUNC LOCAL DEFAULT 12 __do_global_dtors_aux # 32: 0600920 1 OBJECT LOCAL DEFAULT 24 completed.6940 # 33: 06006f8 0 OBJECT LOCAL DEFAULT 18 __do_global_dtors_aux_fin # ... # # >>> python elf_symbol_obfuscation ./hello_c ./hello_c.obf # # >>> readelf -s ./hello_c.obf # # 28: 0600700 0 OBJECT LOCAL DEFAULT 19 xnsffdfsryna # 29: 0400420 0 FUNC LOCAL DEFAULT 12 wsadqwrubbmdugrxzwiv # 30: 0400460 0 FUNC LOCAL DEFAULT 12 wrgeecrckeskyishte # 31: 04004a0 0 FUNC LOCAL DEFAULT 12 pqhfpptwtqzuiefrwnwdk # 32: 0600920 1 OBJECT LOCAL DEFAULT 24 vwevxfvdmcrjdv # 33: 06006f8 0 OBJECT LOCAL DEFAULT 18 rksefyibghsyhbbnfikknpvzc import lief import sys import random, string def randomword(length): return ''.join(random.choice(string.ascii_lowercase) for i in range(length)) def randomize(binary, output): symbols = binary.static_symbols if len(symbols) == 0: print("No symbols") return for symbol in symbols: symbol.name = randomword(len(symbol.name)) binary.write(output) if __name__ == '__main__': if len(sys.argv) != 3: print("Usage:", sys.argv[0], " ") sys.exit(-1) binary = lief.parse(sys.argv[1]) randomize(binary, sys.argv[2]) LIEF-0.13.1/api/python/examples/elf_unstrip.py000066400000000000000000000027241443457337100211470ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # In this example, we assume that we found # the ``main`` function at address 0x402A00 # and we add a static symbol to the binary # so that we can do: # # (gdb) break main # Breakpoint 1 at 0x402a00 from lief import ELF import sys binary = ELF.parse(sys.argv[1]) symtab_section = ELF.Section() symtab_section.name = "" symtab_section.type = ELF.SECTION_TYPES.SYMTAB symtab_section.entry_size = 0x18 symtab_section.alignment = 8 symtab_section.link = len(binary.sections) + 1 symtab_section.content = [0] * 100 symstr_section = ELF.Section() symstr_section.name = "" symstr_section.type = ELF.SECTION_TYPES.STRTAB symstr_section.entry_size = 1 symstr_section.alignment = 1 symstr_section.content = [0] * 100 symtab_section = binary.add(symtab_section, loaded=False) symstr_section = binary.add(symstr_section, loaded=False) symbol = ELF.Symbol() symbol.name = "" symbol.type = ELF.SYMBOL_TYPES.NOTYPE symbol.value = 0 symbol.binding = ELF.SYMBOL_BINDINGS.LOCAL symbol.size = 0 symbol.shndx = 0 symbol = binary.add_static_symbol(symbol) symbol = ELF.Symbol() symbol.name = "main" symbol.type = ELF.SYMBOL_TYPES.FUNC symbol.value = 0x402A00 symbol.binding = ELF.SYMBOL_BINDINGS.LOCAL symbol.shndx = 14 symbol = binary.add_static_symbol(symbol) print(symbol) binary.write(sys.argv[2]) LIEF-0.13.1/api/python/examples/entropy.py000066400000000000000000000054341443457337100203160ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Inspired from binwalk: https://github.com/devttys0/binwalk/ # # Description: # Show show entropy of the differents binary's section # # Requirement: pyqtgraph import pyqtgraph as pg import sys import math from lief import parse, ELF, PE from pyqtgraph.Qt import QtCore, QtGui class Entropy(object): DEFAULT_BLOCK_SIZE = 512 DEFAULT_DATA_POINTS = 2048 DEFAULT_THRESHOLD = 9 def __init__(self, path): self.binary = parse(path) self.block_size = None self.result = dict((section, []) for section in self.binary.sections) def entropy(self, data): entropy = 0 if data: length = len(data) seen = dict(((x, 0) for x in range(0, 256))) for byte in data: seen[byte] += 1 for x in range(0, 256): p_x = float(seen[x]) / length if p_x > 0: entropy -= p_x * math.log(p_x, 2) return (entropy) def compute_entropy_section(self, section): content = section.content size = len(content) if self.block_size is None: block_size = size / self.DEFAULT_DATA_POINTS # Round up to the nearest DEFAULT_BLOCK_SIZE block_size = int(block_size + ((self.DEFAULT_BLOCK_SIZE - block_size) % self.DEFAULT_BLOCK_SIZE)) else: block_size = self.block_size if block_size <= 0: block_size = self.DEFAULT_BLOCK_SIZE i = 0 while (i + block_size) < size: entropy = self.entropy(content[i:i + block_size]) self.result[section].append((section.offset + i , entropy)) i += block_size def plot(self): plt = pg.plot(title = "Entropy") plt.addLegend() for idx, (section, result) in enumerate(self.result.items()): x = [] y = [] for offset, entropy in result: x.append(offset) y.append(entropy) if len(result) > self.DEFAULT_THRESHOLD: c1 = plt.plot(x, y,\ pen=pg.intColor(idx * 10, 100),\ name=section.name,\ antialias = True,\ fillLevel=0,\ fillBrush=pg.intColor(idx * 10, 100, alpha = 40)) def run(self): for section in self.binary.sections: self.compute_entropy_section(section) self.plot() if (sys.flags.interactive != 1) or not hasattr(QtCore, 'PYQT_VERSION'): QtGui.QApplication.instance().exec_() if __name__ == '__main__': if len(sys.argv) != 2: print("Usage: {} ".format(sys.argv[0])) sys.exit(0); Entropy(sys.argv[1]).run() LIEF-0.13.1/api/python/examples/json_dump.py000066400000000000000000000004041443457337100206040ustar00rootroot00000000000000import lief import json import sys if len(sys.argv) != 2: print("Usage: {} ".format(sys.argv[0])) sys.exit(1) obj = lief.parse(sys.argv[1]) json_data = json.loads(lief.to_json(obj)) print(json.dumps(json_data, sort_keys = True, indent = 4)) LIEF-0.13.1/api/python/examples/keygen/000077500000000000000000000000001443457337100175205ustar00rootroot00000000000000LIEF-0.13.1/api/python/examples/keygen/KeygenMe000066400000000000000000000236341443457337100211570ustar00rootroot00000000000000ELF4<#4 (444 $0 ``(((DDQtd/lib/ld-linux.so.2GNUGNUE]8R a}$A6`%/& %#)-*$ "!'( , + . ( @ (*.|CEK8qXX" $ 8|[]r1ErFi+0$L$$ \,libgtk-x11-2.0.so.0__gmon_start___Jv_RegisterClasseslibgdk-x11-2.0.so.0libatk-1.0.so.0_finilibpangoft2-1.0.so.0libgdk_pixbuf-2.0.so.0libm.so.6libpangocairo-1.0.so.0libcairo.so.2libgio-2.0.so.0libpango-1.0.so.0libfreetype.so.6libfontconfig.so.1libgobject-2.0.so.0libgmodule-2.0.so.0libgthread-2.0.so.0librt.so.1libglib-2.0.so.0gtk_container_get_typeg_type_check_instance_castgtk_container_get_childrengtk_widget_get_typegtk_entry_get_typegtk_entry_get_textg_locale_to_utf8gtk_label_get_typegtk_label_set_markupg_freegtk_window_newgtk_window_get_typegtk_window_set_positiongtk_window_set_titlegtk_window_set_default_sizeg_signal_connect_datagdk_color_parsegtk_widget_modify_bggtk_initgtk_entry_new_with_max_lengthgtk_entry_newgtk_entry_set_textgtk_vbox_newgtk_button_new_with_labelgtk_label_newgtk_container_addgtk_box_get_typegtk_box_pack_startgtk_widget_show_allgtk_maingtk_widget_destroygtk_main_quitlibpthread.so.0libc.so.6_IO_stdin_usedexitstrlenstderrstrtoullfwrite__libc_start_main_edata__bss_start_endGLIBC_2.0ii 0t$+     ġȡ̡Сԡءܡ !"# $%&'US[Àt~ X[5|%%h%h%h%h%h %h(%h0%h8p%h@`%hHP%hP@%hX0%h` %hh%hp%hx%ġh%ȡh%̡h%Сh%ԡh%ءh%ܡh%hp%h`%hP%h@%h0%h %h%h%h%h%h% h%h%h %h(1^PTRhhQVh[US=(u?, 9s,,9r([]Ít&'Utt $ÐUWVSA}jXRQP1-H1+=0sXYZRPQ1 Co:- Kג=1+=0wYXZQPR1@í[1-)MO.1+=0wZXYUEEZќ p1ɅtK1ɉ1UEU؉M܍vMuMu؋Ee9߉E؉UwۋU؋M -4}iUMQRP1 V$31+=0s XZYUD:3EU[^_]Í'UWVSL EK{H|fx<<NRQP1 iH!=~(˱1+=0w5XZYRQP1 ۚ\ a(1+=0s XYZ *pRgT@8'|WPRQ1ڃ 2!O81+=0s YZX ?CуKÎC4E D$E$D$Di BRh2$ D$H<$ÉD$D$ʝ$4T$H\$$D$ϝ$/Y㗃 /bhD$$$֝vD$P$D$@"D$D$\$ D$D$ߝ$QPR1 zO< |KOa1+=0wZXY$7$D$,'D$D$ D$D$$|D$LL$L $D$`t$$4$\lXĴlHWD$D$D$\$$+V$ƉD$L$LD$ D$ D$L$$t$$D$D$ D$|$$t$$L$HD$D$ D$L$$t$$`T$@D$D$ D$T$$ht$$,T$,D$D$ D$T$$4v>~*Ƕ~;}iL$D $T1[^_]Í'UqD$E $$jdU]Ít&'UWVSO3)t$1ED$E D$E$9rރ[^_]Ë$ÐUStfЋu[]ÐUS[@|Y[ Name must be at least 3 characters! Serial len invalid! The serial number is invalid. Try again! The serial number is correct. GG you've p0wned Me :D ################################### ### KeygenMe by int_0x80 © 2011 ### ###### Chall for Root-Me.Org ###### #### Visit my blog : RE-XE.Com #### #### Thanks to Lu33y and other #### ################################### Creat screen fails ! Bye! KeygenMe by int_0x80destroyblackNameSerialValidateclicked8Lbw+?J  ,loĂ : x0ooo.2BRbrŒҌ"2BRbrҍ"2BRbrGCC: (Debian 4.4.5-8) 4.4.5GCC: (Debian 4.4.5-10) 4.4.5.shstrtab.interp.note.ABI-tag.note.gnu.build-id.gnu.hash.dynsym.dynstr.gnu.version.gnu.version_r.rel.dyn.rel.plt.init.text.fini.rodata.eh_frame.ctors.dtors.jcr.dynamic.got.got.plt.data.bss.comment (( !HH$8llX4oĂ@> F:No.. ^[o j  s  0 | 0w p ,,HH    `tt!xx!"$$" 0$"9]"LIEF-0.13.1/api/python/examples/keygen/lief_patch.py000066400000000000000000000025421443457337100221730ustar00rootroot00000000000000#!/usr/bin/env python2 # Description # ----------- # Patch binary to remove anti-debug import sys from lief import ELF import distorm3 def remove_anti_debug(binary): patch = [0x83, 0xf8, 0xff, 0x90, 0x90] # cmp eax, 0xFFFFFFFF ep = binary.header.entrypoint text_section = binary.section_from_virtual_address(ep) code = "".join(map(chr, text_section.content)) iterable = distorm3.DecodeGenerator(text_section.virtual_address, code, distorm3.Decode32Bits) for (offset, size, instruction, hexdump) in iterable: if "CMP EAX, 0x3000" in instruction: # Patch 3d 00 30 00 00 binary.patch_address(offset, patch) print("[PATCH] %.8x: %-32s %s" % (offset, hexdump, instruction)) # Distorm didn't get this one binary.patch_address(0x804936B, patch) def crack_it(binary): # user: what you wants # serial: any NUMBER patch1 = [0x31, 0xD2] # xor edx, edx patch2 = [0x31, 0xC0] # xor eax, eax binary.patch_address(0x8049486, patch1) # xor edx, edi --> xor edx, edx binary.patch_address(0x8049488, patch2) # xor eax, ecx --> xor eax, eax def main(argv): binary = ELF.parse("./KeygenMe") remove_anti_debug(binary) crack_it(binary) binary.write("./KeygenMe.crack") return 0 if __name__ == "__main__": sys.exit(main(sys.argv)) LIEF-0.13.1/api/python/examples/library_symbols_obfuscation/000077500000000000000000000000001443457337100240465ustar00rootroot00000000000000LIEF-0.13.1/api/python/examples/library_symbols_obfuscation/Makefile000066400000000000000000000006701443457337100255110ustar00rootroot00000000000000CC=gcc CXX=g++ all: binadd.bin obfu libadd.so: libadd.c $(CC) -Wl,--hash-style=gnu -fPIC -shared -o $@ $^ binadd.bin: binadd.c libadd.so $(CC) $^ -Wl,--hash-style=gnu -L. -ladd -o $@ chmod a+rx $@ run: libadd.so binadd.bin obfu LD_LIBRARY_PATH=. ./binadd.bin 1 2 LD_LIBRARY_PATH=. ./binadd_obf.bin 1 2 obfu: binadd.bin libadd.so python ./obfu.py chmod a+x *.bin chmod a+x *.so .PHONY: clean clean: rm -rf *.o *~ *.so *.bin LIEF-0.13.1/api/python/examples/library_symbols_obfuscation/README.md000066400000000000000000000003451443457337100253270ustar00rootroot00000000000000Presentation ============ The aim of this example is to show how we can change dynamic symbols in both library and binary. In the example we will change the symbol `add` to `abc` and the library name `libadd.so` to `libabc.so` LIEF-0.13.1/api/python/examples/library_symbols_obfuscation/binadd.c000066400000000000000000000004321443457337100254320ustar00rootroot00000000000000#include #include #include "libadd.h" int main(int argc, char **argv) { if (argc != 3) { printf("Usage: %s \n", argv[0]); exit(-1); } int res = add(atoi(argv[1]), atoi(argv[2])); printf("From myLIb, a + b = %d\n", res); return 0; } LIEF-0.13.1/api/python/examples/library_symbols_obfuscation/libadd.c000066400000000000000000000002161443457337100254300ustar00rootroot00000000000000#include #include #include "libadd.h" int add(int a, int b) { printf("%d + %d = %d\n", a, b, a+b); return a + b; } LIEF-0.13.1/api/python/examples/library_symbols_obfuscation/libadd.h000066400000000000000000000012171443457337100254370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ int add(int a, int b); LIEF-0.13.1/api/python/examples/library_symbols_obfuscation/obfu.py000066400000000000000000000012021443457337100253460ustar00rootroot00000000000000#!/usr/bin/env python import lief libadd = lief.ELF.parse("./libadd.so") binadd = lief.ELF.parse("./binadd.bin") libadd_dynsym = libadd.dynamic_symbols binadd_dynsym = binadd.dynamic_symbols # Change add in the libary for sym in libadd_dynsym: if sym.name == "add": sym.name = "abc" # Change "add" in the binary for sym in binadd_dynsym: if sym.name == "add": sym.name = "abc" # change library name in the binary for entry in binadd.dynamic_entries: if entry.tag == lief.ELF.NEEDED and entry.name == "libadd.so": entry.name = "libabc.so" libadd.write("libabc.so"); binadd.write("binadd_obf.bin") LIEF-0.13.1/api/python/examples/macho_parser_tweak.py000066400000000000000000000007171443457337100224530ustar00rootroot00000000000000import lief import sys import time # Do not parse dyld info config = lief.MachO.ParserConfig() config.parse_dyld_bindings = False config.parse_dyld_exports = False config.parse_dyld_rebases = False t1 = time.time() lief.MachO.parse(sys.argv[1], config) t2 = time.time() print(f"Done in {t2 - t1}s") # Parse the dyld information config.full_dyldinfo(True) t1 = time.time() lief.MachO.parse(sys.argv[1], config) t2 = time.time() print(f"Done in {t2 - t1}s") LIEF-0.13.1/api/python/examples/macho_reader.py000066400000000000000000001016551443457337100212310ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about a Mach-O binary import sys import os import argparse import traceback import lief from lief import MachO terminal_rows, terminal_columns = 100, 100 try: terminal_rows, terminal_columns = os.popen('stty size', 'r').read().split() except ValueError: pass terminal_columns = int(terminal_columns) terminal_rows = int(terminal_rows) EXIT_STATUS = 0 class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: global EXIT_STATUS print("{} raised: {}".format(self.func.__name__, e)) EXIT_STATUS = 1 if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_information(binary): print("== Information ==") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" header: lief.MachO.Header = binary.header cpu = str(header.cpu_type).split('.')[-1] print(format_str.format("Name:", binary.name)) print(format_hex.format("Address base:", binary.imagebase)) print(format_str.format("PIE:", str(binary.is_pie))) print(format_str.format("NX:", str(binary.has_nx))) print(format_str.format("Arch:", cpu)) print("") @exceptions_handler(Exception) def print_header(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" print("== Header ==") header = binary.header flags_str = " - ".join([str(s).split(".")[-1] for s in header.flags_list]) print(format_str.format("Magic:", str(header.magic).split(".")[-1])) print(format_str.format("CPU Type:", str(header.cpu_type).split(".")[-1])) print(format_hex.format("CPU sub-type:", header.cpu_subtype)) print(format_str.format("File Type:", str(header.file_type).split(".")[-1])) print(format_str.format("Flags:", flags_str)) print(format_dec.format("Number of commands:", header.nb_cmds)) print(format_hex.format("Size of commands:", header.sizeof_cmds)) print(format_hex.format("Reserved:", header.reserved)) @exceptions_handler(Exception) def print_commands(binary): f_title = "|{:<20}|{:<11}|{:<11}|" f_value = "|{:<20}|0x{:08x} |0x{:08x} |" print("== Commands ==") print(f_title.format("Command", "Offset", "Size")) for command in binary.commands: print(f_value.format( str(command.command).split(".")[-1], command.command_offset, command.size)) print("") @exceptions_handler(Exception) def print_libraries(binary): f_title = "|{:<30}|{:<10}|{:<16}|{:<22}|" f_value = "|{:<30}|{:<10d}|{:<16}|{:<22}|" print("== Libraries ==") print(f_title.format("Name", "Timestamp", "Current Version", "Compatibility Version")) for library in binary.libraries: current_version_str = "{:d}.{:d}.{:d}".format(*library.current_version) compatibility_version_str = "{:d}.{:d}.{:d}".format(*library.compatibility_version) print(f_value.format( library.name, library.timestamp, current_version_str, compatibility_version_str)) print("") @exceptions_handler(Exception) def print_segments(binary): f_title = "|{:<20}|{:<16}|{:<16}|{:<16}|{:16}|{:16}|{:16}|{}" f_value = "|{:<20}|0x{:<13x} |0x{:<13x} |0x{:<13x} |0x{:<13x} |0x{:<13x} |0x{:<13x} |{}" print("== Segments ==") print(f_title.format( "Name", "Virtual Address", "Virtual Size", "Offset", "Size", "Max Protection", "Init Protection", "Sections")) for segment in binary.segments: sections = ", ".join(map(lambda s : s.name, segment.sections)) print(f_value.format( segment.name, segment.virtual_address, segment.virtual_size, segment.file_offset, segment.file_size, segment.max_protection, segment.init_protection, sections)) print("") @exceptions_handler(Exception) def print_sections(binary): f_title = "|{:<20}|{:<16}|{:<16}|{:<16}|{:16}|{:22}|{:19}|{:25}|{:25}|" f_value = "|{:<20}|0x{:<13x} |0x{:<13x} |0x{:<13x} |0x{:<13x} |0x{:<19x} |0x{:<16x} |{:<25}|{:<25}" print("== Sections ==") print(f_title.format( "Name", "Virtual Address", "Offset", "Size", "Alignement", "Number of Relocations", "Relocation offset", "Type", "Flags")) for section in binary.sections: flags_str = " - ".join([str(s).split(".")[-1] for s in section.flags_list]) print(f_value.format( section.name, section.virtual_address, section.offset, section.size, section.alignment, section.numberof_relocations, section.relocation_offset, str(section.type).split(".")[-1], flags_str)) if len(section.relocations) > 0: for idx, reloc in enumerate(section.relocations): name = reloc.symbol.name if reloc.has_symbol else "" secname = " - " + reloc.section.name if reloc.has_section else "" type = str(reloc.type) if reloc.architecture == MachO.CPU_TYPES.x86: type = str(MachO.X86_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.x86_64: type = str(MachO.X86_64_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.ARM: type = str(MachO.ARM_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.ARM64: type = str(MachO.ARM64_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.POWERPC: type = str(MachO.PPC_RELOCATION(reloc.type)) print(" [Reloc #{:d} {section}] {name:<10} 0x{address:<6x} {type:<20} {size:d} {pcrel} {scat}".format( idx, section=secname, name=name, address=reloc.address, type=type.split(".")[-1], size=reloc.size, pcrel=str(reloc.pc_relative), scat=str(reloc.is_scattered))) print("") print("") @exceptions_handler(Exception) def print_symbols(binary): symbols = binary.symbols if len(symbols) == 0: return try: maxsize = max([len(symbol.demangled_name) for symbol in symbols]) except: maxsize = max([len(symbol.name) for symbol in symbols]) maxsize = min(maxsize, terminal_columns - 90) if terminal_columns > 90 else terminal_columns f_title = "|{:<" + str(maxsize) + "} |{:<6}|{:<19}|{:<16}|{:16}| {:s}" f_value = "|{:<" + str(maxsize) + "} |0x{:<3x} |0x{:<16x} |0x{:<13x} |0x{:<13x} | {:s}" print("== Symbols ==") print(f_title.format( "Name", "Type", "Number of Sections", "Description", "Value", "Library")) for symbol in binary.symbols: libname = "" if symbol.has_binding_info and symbol.binding_info.has_library: libname = symbol.binding_info.library.name symbol_value = 0 if symbol.has_export_info: symbol_value = symbol.export_info.address elif symbol.has_binding_info: symbol_value = symbol.binding_info.address else: symbol_value = symbol.value try: symbol_name = symbol.demangled_name except: symbol_name = symbol.name print(f_value.format( symbol_name, symbol.type, symbol.numberof_sections, symbol.description, symbol_value, libname)) print("") @exceptions_handler(Exception) def print_symbol_command(binary): print("== Symbol Command ==") scmd = binary.symbol_command format_str = "{:<17} {:<30}" format_hex = "{:<17} 0x{:<28x}" format_dec = "{:<17} {:<30d}" print(format_hex.format("Symbol offset", scmd.symbol_offset)) print(format_dec.format("Number of symbols", scmd.numberof_symbols)) print(format_hex.format("String offset", scmd.strings_offset)) print(format_hex.format("String size", scmd.strings_size)) print("") @exceptions_handler(Exception) def print_dynamic_symbol_command(binary): print("== Dynamic Symbol Command ==") dyscmd = binary.dynamic_symbol_command format_str = "{:<36} {:<30}" format_hex = "{:<36} 0x{:<28x}" format_dec = "{:<36} {:<30d}" print(format_dec.format("First local symbol index", dyscmd.idx_local_symbol)) print(format_dec.format("Number of local symbols", dyscmd.nb_local_symbols)) print(format_dec.format("External symbol index", dyscmd.idx_external_define_symbol)) print(format_dec.format("Number of external symbols", dyscmd.nb_external_define_symbols)) print(format_dec.format("Undefined symbol index", dyscmd.idx_undefined_symbol)) print(format_dec.format("Number of undefined symbols", dyscmd.nb_undefined_symbols)) print(format_dec.format("Table of content offset", dyscmd.toc_offset)) print(format_dec.format("Number of entries in TOC", dyscmd.nb_toc)) print(format_hex.format("Module table offset", dyscmd.module_table_offset)) print(format_dec.format("Number of entries in module table", dyscmd.nb_module_table)) print(format_hex.format("External reference table offset", dyscmd.external_reference_symbol_offset)) print(format_dec.format("Number of external reference", dyscmd.nb_external_reference_symbols)) print(format_hex.format("Indirect symbols offset", dyscmd.indirect_symbol_offset)) print(format_dec.format("Number of indirect symbols", dyscmd.nb_indirect_symbols)) print(format_hex.format("External relocation offset", dyscmd.external_relocation_offset)) print(format_dec.format("Number of external relocations", dyscmd.nb_external_relocations)) print(format_hex.format("Local relocation offset", dyscmd.local_relocation_offset)) print(format_dec.format("Number of local relocations", dyscmd.nb_local_relocations)) print("") @exceptions_handler(Exception) def print_uuid(binary): print("== UUID ==") cmd = binary.uuid uuid_str = " ".join(map(lambda e : "{:02x}".format(e), cmd.uuid)) print("UUID: {}".format(uuid_str)) print("") @exceptions_handler(Exception) def print_main_command(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Main Command ==") cmd = binary.main_command print(format_hex.format("Entry point:", cmd.entrypoint)) print(format_hex.format("Stack size:", cmd.stack_size)) print("") @exceptions_handler(Exception) def print_thread_command(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Thread Command ==") cmd = binary.thread_command print(format_hex.format("Flavor:", cmd.flavor)) print(format_hex.format("Count:", cmd.count)) print(format_hex.format("PC:", cmd.pc)) print("") @exceptions_handler(Exception) def print_rpath_command(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Rpath Command ==") cmd = binary.rpath print("Path: {}".format(cmd.path)) print("") @exceptions_handler(Exception) def print_dylinker(binary): print("== Dylinker ==") print("Path: {}".format(binary.dylinker.name)) print("") @exceptions_handler(Exception) def print_function_starts(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Function Starts ==") fstarts = binary.function_starts print(format_hex.format("Offset:", fstarts.data_offset)) print(format_hex.format("Size:", fstarts.data_size)) print("Functions: ({:d})".format(len(fstarts.functions))) for idx, address in enumerate(fstarts.functions): print(" [{:d}] __TEXT + 0x{:x}".format(idx, address)) print("") @exceptions_handler(Exception) def print_data_in_code(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Data In Code ==") datacode = binary.data_in_code print(format_hex.format("Offset:", datacode.data_offset)) print(format_hex.format("Size:", datacode.data_size)) print("") for entry in datacode.entries: type_str = str(entry.type).split(".")[-1] print("- {:<14}: 0x{:x} ({:d} bytes)".format(type_str, entry.offset, entry.length)) print("") @exceptions_handler(Exception) def print_segment_split_info(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Segment Split Info ==") sinfo = binary.segment_split_info print(format_hex.format("Offset:", sinfo.data_offset)) print(format_hex.format("Size:", sinfo.data_size)) print("") @exceptions_handler(Exception) def print_sub_framework(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Sub Framework ==") sinfo = binary.sub_framework print(format_str.format("Umbrella:", sinfo.umbrella)) print("") @exceptions_handler(Exception) def print_dyld_environment(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Dyld Environment ==") env = binary.dyld_environment print(format_str.format("Value:", env.value)) print("") @exceptions_handler(Exception) def print_dyld_info(binary): print("== Dyld Info ==") f_title = "|{:<12}|{:<11}|{:<11}|" f_value = "|{:<12}|0x{:<8x} |0x{:<8x} |" dyld_info = binary.dyld_info print(f_title.format("Type", "Offset", "Size")) print(f_value.format("Rebase", dyld_info.rebase[0], dyld_info.rebase[1])) print(f_value.format("Bind", dyld_info.bind[0], dyld_info.bind[1])) print(f_value.format("Weak Bind", dyld_info.weak_bind[0], dyld_info.weak_bind[1])) print(f_value.format("Lazy Bind", dyld_info.lazy_bind[0], dyld_info.lazy_bind[1])) print(f_value.format("Export", dyld_info.export_info[0], dyld_info.export_info[1])) print("") print("Bindings") print("--------") for idx, binfo in enumerate(dyld_info.bindings): print("{:10}: {}".format("Class", str(binfo.binding_class).split(".")[-1])) print("{:10}: {}".format("Type", str(binfo.binding_type).split(".")[-1])) print("{:10}: {:x}".format("Address", binfo.address)) if binfo.has_symbol: print("{:10}: {}".format("Symbol", binfo.symbol.name)) if binfo.has_segment: print("{:10}: {}".format("Segment", binfo.segment.name)) if binfo.has_library: print("{:10}: {}".format("Library", binfo.library.name)) if binfo.binding_class == lief.MachO.BINDING_CLASS.LAZY: print("{:10}: {}".format("Offset", binfo.original_offset)) print("") print("") print("Exports") print("-------") for idx, einfo in enumerate(dyld_info.exports): output = "0x{:08x} - {}".format(einfo.address, einfo.symbol.name) if einfo.alias: output += " - {}".format(einfo.alias.name) if einfo.alias_library: output += " from {}".format(einfo.alias_library.name) print(output) #print("{:10}: {:<10x}".format("Address", einfo.address)) #print("{:10}: {:<10x}".format("Flags", einfo.flags)) #if binfo.has_symbol: # print("{:10}: {}".format("Symbol", einfo.symbol.name)) print("") print("") @exceptions_handler(Exception) def print_rebase_opcodes(binary): print("== Rebase opcodes ==") print(binary.dyld_info.show_rebases_opcodes) print("") @exceptions_handler(Exception) def print_bind_opcodes(binary): print("== Bind opcodes ==") print(binary.dyld_info.show_bind_opcodes) print("") @exceptions_handler(Exception) def print_weak_bind_opcodes(binary): print("== Weak bind opcodes ==") print(binary.dyld_info.show_weak_bind_opcodes) print("") @exceptions_handler(Exception) def print_lazy_bind_opcodes(binary): print("== Lazy bind opcodes ==") print(binary.dyld_info.show_lazy_bind_opcodes) print("") @exceptions_handler(Exception) def print_export_trie(binary): print("== Export trie ==") if binary.has_dyld_info: print(binary.dyld_info.show_export_trie) if binary.has_dyld_exports_trie: trie: lief.MachO.DyldExportsTrie = binary.dyld_exports_trie print("Linkedit position: 0x{} (0x{:x} bytes)".format(trie.data_offset, trie.data_size)) print(trie.show_export_trie()) print("") @exceptions_handler(Exception) def print_source_version(binary): print("== Source Version ==") version = binary.source_version.version print("Version: {:d}.{:d}.{:d}.{:d}.{:d}".format(*version)) print("") @exceptions_handler(Exception) def print_version_min(binary): print("== Version Min ==") version = binary.version_min.version sdk = binary.version_min.sdk print("Version: {:d}.{:d}.{:d}".format(*version)) print("SDK: {:d}.{:d}.{:d}".format(*sdk)) print("") @exceptions_handler(Exception) def print_relocations(binary): print("== Relocations ==") f_value = "|0x{address:<10x} | {size:<4d} | {type:<15} | {pcrel:<11} | {secseg:<23} | {symbol}" f_title = "|{address:<12} | {size:<4} | {type:<15} | {pcrel:<11} | {secseg:<23} | {symbol}" print(f_title.format( address="Address", size="Size", type="Type", pcrel="PC Relative", secseg="Section/Section", symbol="Symbol")) for reloc in binary.relocations: type_str = "" if reloc.origin == lief.MachO.RELOCATION_ORIGINS.DYLDINFO: type_str = str(lief.MachO.REBASE_TYPES(reloc.type)).split(".")[-1] if reloc.origin == lief.MachO.RELOCATION_ORIGINS.RELOC_TABLE: if reloc.architecture == MachO.CPU_TYPES.x86: type_str = str(MachO.X86_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.x86_64: type_str = str(MachO.X86_64_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.ARM: type_str = str(MachO.ARM_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.ARM64: type_str = str(MachO.ARM64_RELOCATION(reloc.type)) if reloc.architecture == MachO.CPU_TYPES.POWERPC: type_str = str(MachO.PPC_RELOCATION(reloc.type)) type_str = type_str.split(".")[-1] symbol_name = "" if reloc.has_symbol: symbol_name = reloc.symbol.name secseg_name = "" if reloc.has_segment and reloc.has_section: secseg_name = "{}.{}".format(reloc.segment.name, reloc.section.name) else: if reloc.has_segment: secseg_name = reloc.segment.name if reloc.has_section: secseg_name = reloc.section.name print(f_value.format( address=reloc.address, size=reloc.size, type=type_str, pcrel=str(reloc.pc_relative), secseg=secseg_name, symbol=symbol_name)) print("") @exceptions_handler(Exception) def print_encryption_info(binary): format_str = "{:<13} {:<30}" format_hex = "{:<13} 0x{:<28x}" format_dec = "{:<13} {:<30d}" print("== Encryption Info ==") cmd = binary.encryption_info print(format_hex.format("Offset:", cmd.crypt_offset)) print(format_hex.format("Size:", cmd.crypt_size)) print(format_dec.format("ID:", cmd.crypt_id)) print("") @exceptions_handler(Exception) def print_ctor(binary): print("== Constructors ==\n") print("Functions: ({:d})".format(len(binary.ctor_functions))) for idx, f in enumerate(binary.ctor_functions): print(" [{:d}] {}: 0x{:x}".format(idx, f.name, f.address)) @exceptions_handler(Exception) def print_unwind_functions(binary): print("== Unwind functions ==\n") print("Functions: ({:d})".format(len(binary.unwind_functions))) for idx, f in enumerate(binary.unwind_functions): print(" [{:d}] {}: 0x{:x}".format(idx, f.name, f.address)) @exceptions_handler(Exception) def print_functions(binary): print("== Functions ==\n") print("Functions: ({:d})".format(len(binary.functions))) for idx, f in enumerate(binary.functions): print(" [{:d}] {}: 0x{:x}".format(idx, f.name, f.address)) @exceptions_handler(Exception) def print_build_version(binary): print("== Build Version ==\n") build_version = binary.build_version print("Platform: {}".format(str(build_version.platform).split(".")[-1])) print("Min OS: {:d}.{:d}.{:d}".format(*build_version.minos)) print("SDK: {:d}.{:d}.{:d}".format(*build_version.sdk)) tools = build_version.tools if len(tools) > 0: print("~~ Tools ({}) ~~".format(len(tools))) for tool in tools: tool_str = str(tool.tool).split(".")[-1] print(" {} - {}.{}.{}".format(tool_str, *tool.version)) def print_chained_fixups(binary: lief.MachO.Binary): if not binary.has_dyld_chained_fixups: return print("== Dyld Chained Fixups ==") fixups: lief.MachO.DyldChainedFixups = binary.dyld_chained_fixups print(fixups) def main(): parser = argparse.ArgumentParser(usage='%(prog)s [options] ') parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Show all information') parser.add_argument('-c', '--commands', action='store_true', dest='show_commands', help='Display Commands') parser.add_argument('-H', '--header', action='store_true', dest='show_header', help='Display header') parser.add_argument('-L', '--libraries', action='store_true', dest='show_libraries', help='Display Imported Libraries') parser.add_argument('-l', '--segments', action='store_true', dest='show_segments', help='Display Segments') parser.add_argument('-r', '--relocations', action='store_true', dest='show_relocs', help='Display the relocations (if present)') parser.add_argument('-s', '--symbols', action='store_true', dest='show_symbols', help='Display Symbols') parser.add_argument('-S', '--sections', action='store_true', dest='show_sections', help='Display Sections') parser.add_argument('--uuid', action='store_true', dest='show_uuid', help='Display the UUID command') parser.add_argument('--main', action='store_true', dest='show_main', help='Display the Main command') parser.add_argument('--dylinker', action='store_true', dest='show_dylinker', help='Display the Dylinker command') parser.add_argument('--dyldinfo', action='store_true', dest='show_dyldinfo', help='Display the DyldInfo command') parser.add_argument('--function-starts', action='store_true', dest='show_function_starts', help='Display the FunctionStarts command') parser.add_argument('--rebase-opcodes', action='store_true', dest='show_rebase_opcodes', help='Display the "Rebase" opcodes') parser.add_argument('--source-version', action='store_true', dest='show_source_version', help="Display the 'Source Version' command") parser.add_argument('--version-min', action='store_true', dest='show_version_min', help="Display the 'Version Min' command") parser.add_argument('--thread-command', action='store_true', dest='show_thread_command', help="Display the 'Thread Command' command") parser.add_argument('--rpath-command', action='store_true', dest='show_rpath_command', help="Display the 'Rpath Command' command") parser.add_argument('--symbol-command', action='store_true', dest='show_symbol_command', help="Display the 'Symbol Command' command") parser.add_argument('--dynamic-symbol-command', action='store_true', dest='show_dynamic_symbol_command', help="Display the 'Symbol Command' command") parser.add_argument('--data-in-code', action='store_true', dest='show_data_in_code', help="Display the 'Data In Code' command") parser.add_argument('--segment-split-info', action='store_true', dest='show_segment_split_info', help="Display the 'Segment Split Info' command") parser.add_argument('--sub-framework', action='store_true', dest='show_sub_framework', help="Display the 'Sub Framework' command") parser.add_argument('--dyld-environment', action='store_true', dest='show_dyld_env', help="Display the 'Dyld Environment' command") parser.add_argument('--encryption-info', action='store_true', dest='show_encrypt_info', help="Display the 'Encryption Info' command") parser.add_argument('--bind-opcodes', action='store_true', dest='show_bind_opcodes', help='Display the "Bind" opcodes') parser.add_argument('--weak-bind-opcodes', action='store_true', dest='show_weak_bind_opcodes', help='Display the "Weak Bind" opcodes') parser.add_argument('--lazy-bind-opcodes', action='store_true', dest='show_lazy_bind_opcodes', help='Display the "Lazy Bind" opcodes') parser.add_argument('--export-trie', action='store_true', dest='show_export_trie', help='Display the export trie') parser.add_argument('--opcodes', action='store_true', dest='show_opcodes', help='Display the bind and rebase opcodes') parser.add_argument('--ctor', action='store_true', dest='show_ctor', help='Constructor functions') parser.add_argument('--unwind-functions', action='store_true', dest='show_ufunctions', help='Functions from unwind info') parser.add_argument('--functions', action='store_true', dest='show_functions', help='All functions found in the binary') parser.add_argument('--build-version', action='store_true', dest='show_build_version', help='Show build version') parser.add_argument('--chained-fixups', action='store_true', dest='show_chained_fixups', help='Show Dyld Chained Fixups') parser.add_argument('--check-layout', action='store_true', dest='check_layout', help='Check the layout of the binary') parser.add_argument("binary", metavar="", help='Target Mach-O File') # Logging setup logger_group = parser.add_argument_group('Logger') verbosity = logger_group.add_mutually_exclusive_group() verbosity.add_argument('--debug', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.DEBUG) verbosity.add_argument('--trace', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.TRACE) verbosity.add_argument('--info', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.INFO) verbosity.add_argument('--warn', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.WARNING) verbosity.add_argument('--err', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.ERROR) verbosity.add_argument('--critical', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.CRITICAL) parser.set_defaults(main_verbosity=lief.logging.LOGGING_LEVEL.WARNING) args = parser.parse_args() lief.logging.set_level(args.main_verbosity) binaries = MachO.parse(args.binary) if binaries is None: print("Can't parse {}".format(args.binary)) sys.exit(1) if len(binaries) > 1: print("Fat Mach-O: {:d} binaries".format(len(binaries))) if args.check_layout: isok, err = MachO.check_layout(binaries) if not isok: print(err) for binary in binaries: print_information(binary) if args.show_header or args.show_all: print_header(binary) if args.show_commands or args.show_all: print_commands(binary) if args.show_libraries or args.show_all: print_libraries(binary) if args.show_segments or args.show_all: print_segments(binary) if args.show_sections or args.show_all: print_sections(binary) if args.show_symbols or args.show_all: print_symbols(binary) if (args.show_uuid or args.show_all) and binary.has_uuid: print_uuid(binary) if (args.show_main or args.show_all) and binary.has_main_command: print_main_command(binary) if (args.show_dylinker or args.show_all) and binary.has_dylinker: print_dylinker(binary) if (args.show_dyldinfo or args.show_all) and binary.has_dyld_info: print_dyld_info(binary) if (args.show_function_starts or args.show_all) and binary.has_function_starts: print_function_starts(binary) if (args.show_source_version or args.show_all) and binary.has_source_version: print_source_version(binary) if (args.show_version_min or args.show_all) and binary.has_version_min: print_version_min(binary) if (args.show_relocs or args.show_all) and len(binary.relocations) > 0: print_relocations(binary) if (args.show_thread_command or args.show_all) and binary.has_thread_command: print_thread_command(binary) if (args.show_rpath_command or args.show_all) and binary.has_rpath: print_rpath_command(binary) if (args.show_symbol_command or args.show_all) and binary.has_symbol_command: print_symbol_command(binary) if (args.show_dynamic_symbol_command or args.show_all) and binary.has_dynamic_symbol_command: print_dynamic_symbol_command(binary) if (args.show_data_in_code or args.show_all) and binary.has_data_in_code: print_data_in_code(binary) if (args.show_segment_split_info or args.show_all) and binary.has_segment_split_info: print_segment_split_info(binary) if (args.show_sub_framework or args.show_all) and binary.has_sub_framework: print_sub_framework(binary) if (args.show_dyld_env or args.show_all) and binary.has_dyld_environment: print_dyld_environment(binary) if (args.show_encrypt_info or args.show_all) and binary.has_encryption_info: print_encryption_info(binary) if (args.show_rpath_command or args.show_all) and binary.has_rpath: print_rpath_command(binary) if (args.show_rebase_opcodes or args.show_opcodes) and binary.has_dyld_info: print_rebase_opcodes(binary) if (args.show_bind_opcodes or args.show_opcodes) and binary.has_dyld_info: print_bind_opcodes(binary) if (args.show_weak_bind_opcodes or args.show_opcodes) and binary.has_dyld_info: print_weak_bind_opcodes(binary) if (args.show_lazy_bind_opcodes or args.show_opcodes) and binary.has_dyld_info: print_lazy_bind_opcodes(binary) if (args.show_export_trie or args.show_opcodes): print_export_trie(binary) if args.show_ctor or args.show_all: print_ctor(binary) if args.show_ufunctions or args.show_all: print_unwind_functions(binary) if args.show_functions or args.show_all: print_functions(binary) if (args.show_build_version or args.show_all) and binary.has_build_version: print_build_version(binary) if args.show_chained_fixups or args.show_all: print_chained_fixups(binary) sys.exit(EXIT_STATUS) if __name__ == "__main__": main() LIEF-0.13.1/api/python/examples/nm.py000066400000000000000000000015201443457337100172200ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # # This tool is a cross format Linux nm like. It prints all symbols # present in the binary. For `PE` it will print symbols in the *symbol section* # and for `ELF` it will print *static* symbols **AND** *dynamic* symbols. # # Example: # # >>> nm("/usr/bin/ls") # >>> nm("C:\\Windows\\explorer.exe") import sys from lief import parse def nm(filename): """ Return symbols from *filename* binary """ binary = parse(filename) # Build an abstract binary symbols = binary.symbols if len(symbols) > 0: for symbol in symbols: print(symbol) else: print("No symbols found") if __name__ == "__main__": if len(sys.argv) != 2: print("Usage: " + sys.argv[0] + " ") sys.exit(-1) nm(sys.argv[1]) LIEF-0.13.1/api/python/examples/oat_reader.py000066400000000000000000000134021443457337100207150ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about a Android OAT files import argparse import os import sys import traceback import lief from lief import OAT EXIT_STATUS = 0 terminal_rows, terminal_columns = 100, 100 try: terminal_rows, terminal_columns = os.popen('stty size', 'r').read().split() except ValueError: pass class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: global EXIT_STATUS print("{} raised: {}".format(self.func.__name__, e)) EXIT_STATUS = 1 if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_information(binary): print("== Information ==") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" android_version = lief.OAT.android_version(binary.header.version) code_name = lief.Android.code_name(android_version) version = lief.Android.version_string(android_version) print("Version: {} - Android {} {}".format(binary.header.version, version, code_name)) print("Number of dex files: {}".format(len(binary.oat_dex_files))) print("Number of classes: {}".format(len(binary.classes))) print("Number of methods: {}".format(len(binary.methods))) print("") @exceptions_handler(Exception) def print_header(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" print("== Header ==") header = binary.header print(header) @exceptions_handler(Exception) def print_dex_files(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" oat_dex_files = binary.oat_dex_files print("== Dex files ==") for oat_dex in oat_dex_files: print(oat_dex) @exceptions_handler(Exception) def print_classes(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" classes = binary.classes print("== Classes ==") for cls in classes: print(cls) @exceptions_handler(Exception) def print_methods(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" methods = binary.methods print("== Methods ==") for m in methods: print(m) def main(): parser = argparse.ArgumentParser(usage='%(prog)s [options] oat files') parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Show all information') parser.add_argument('-H', '--header', action='store_true', dest='show_header', help='Display header') parser.add_argument('-c', '--classes', action='store_true', dest='show_classes', help='Display classes') parser.add_argument('-d', '--dex', action='store_true', dest='show_dex', help='Display Dex files') parser.add_argument('-m', '--methods', action='store_true', dest='show_methods', help='Display Methods') parser.add_argument('-x', '--extract', action='store_true', dest='extract_dex', help='Extract DEX files') parser.add_argument("binary", metavar="", help='Target OAT File') # Logging setup logger_group = parser.add_argument_group('Logger') verbosity = logger_group.add_mutually_exclusive_group() verbosity.add_argument('--debug', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.DEBUG) verbosity.add_argument('--trace', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.TRACE) verbosity.add_argument('--info', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.INFO) verbosity.add_argument('--warn', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.WARNING) verbosity.add_argument('--err', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.ERROR) verbosity.add_argument('--critical', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.CRITICAL) parser.set_defaults(main_verbosity=lief.logging.LOGGING_LEVEL.WARNING) args = parser.parse_args() lief.logging.set_level(args.main_verbosity) binary = None try: binary = OAT.parse(args.binary) except lief.exception as e: print(e) sys.exit(1) print_information(binary) if args.show_header or args.show_all: print_header(binary) if (args.show_dex or args.show_all) and len(binary.oat_dex_files) > 0: print_dex_files(binary) if args.show_classes and len(binary.classes) > 0: print_classes(binary) if args.show_methods and len(binary.methods) > 0: print_methods(binary) sys.exit(EXIT_STATUS) if __name__ == "__main__": main() LIEF-0.13.1/api/python/examples/pe_authenticode.py000066400000000000000000000027671443457337100217640ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- import sys import lief # Description: # ----------- # Print certificates included in a signed PE # # Example: # python pe_authenticode.py driver.sys # # Version: 3 # Serial Number: 61:04:ca:69:00:00:00:00:00:08 # Signature Algorithm: SHA1_WITH_RSA_ENCRYPTION # Valid from: 2007-6-5 22:3:21 # Valid to: 2012-6-5 22:13:21 # Issuer: C=US, ST=Washington, L=Redmond, O=Microsoft Corporation, CN=Microsoft Time-Stamp PCA # Subject: C=US, ST=Washington, L=Redmond, O=Microsoft Corporation, OU=nCipher DSE ESN:A5B0-CDE0-DC94, CN=Microsoft Time-Stamp Service # # Version: 3 # Serial Number: 61:01:c6:c1:00:00:00:00:00:07 # Signature Algorithm: SHA1_WITH_RSA_ENCRYPTION # Valid from: 2008-10-22 20:39:22 # Valid to: 2010-1-22 20:49:22 # Issuer: C=US, ST=Washington, L=Redmond, O=Microsoft Corporation, CN=Microsoft Windows Verification PCA # Subject: C=US, ST=Washington, L=Redmond, O=Microsoft Corporation, OU=MOPR, CN=Microsoft Windows # .... def print_crt(binary): for crt in binary.signatures[0].certificates: print(crt) if __name__ == '__main__': if len(sys.argv) != 2: print("Usage: {} ".format(sys.argv[0])) sys.exit(1) binary = lief.parse(sys.argv[1]) print_crt(binary) LIEF-0.13.1/api/python/examples/pe_forwardinfo.py000066400000000000000000000003471443457337100216200ustar00rootroot00000000000000import lief import sys pe = lief.parse(sys.argv[1]) exports = pe.get_export() for e in filter(lambda e: e.is_forwarded, exports.entries): fwd = e.forward_information print(f"{e.name:<35} -> {fwd.library}.{fwd.function}") LIEF-0.13.1/api/python/examples/pe_from_scratch.py000066400000000000000000000035241443457337100217520ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description: # Create a PE which pop a MessageBox # with the message "Hello World" from lief import PE title = "LIEF is awesome\0" message = "Hello World\0" data = list(map(ord, title)) data += list(map(ord, message)) code = [ 0x6a, 0x00, # push 0x00 uType 0x68, 0x00, 0x20, 0x40, 0x00, # push VA(title) 0x68, 0x10, 0x20, 0x40, 0x00, # push VA(message) 0x6a, 0x00, # push 0 hWnd 0xFF, 0x15, 0x54, 0x30, 0x40, 0x00, # call MessageBoxA 0x6A, 0x00, # push 0 uExitCode 0xFF, 0x15, 0x4C, 0x30, 0x40, 0x00 # call ExitProcess ] binary32 = PE.Binary("pe_from_scratch", PE.PE_TYPE.PE32) section_text = PE.Section(".text") section_text.content = code section_text.virtual_address = 0x1000 section_data = PE.Section(".data") section_data.content = data section_data.virtual_address = 0x2000 section_text = binary32.add_section(section_text, PE.SECTION_TYPES.TEXT) section_data = binary32.add_section(section_data, PE.SECTION_TYPES.DATA) print(section_text) print(section_data) binary32.optional_header.addressof_entrypoint = section_text.virtual_address kernel32 = binary32.add_library("kernel32.dll") kernel32.add_entry("ExitProcess") user32 = binary32.add_library("user32.dll") user32.add_entry("MessageBoxA") ExitProcess_addr = binary32.predict_function_rva("kernel32.dll", "ExitProcess") MessageBoxA_addr = binary32.predict_function_rva("user32.dll", "MessageBoxA") print("Address of 'ExitProcess': 0x{:06x} ".format(ExitProcess_addr)) print("Address of 'MessageBoxA': 0x{:06x} ".format(MessageBoxA_addr)) builder = PE.Builder(binary32) builder.build_imports(True) builder.build() builder.write("pe_from_scratch.exe") LIEF-0.13.1/api/python/examples/pe_json.py000066400000000000000000000015121443457337100202440ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about a PE binary in the JSON format # # python pe_json.py C:\\windows\\explorer.exe #   # { # "dynamic_entries": [ # { # "library": "libcap.so.2", # "tag": "NEEDED", # "value": 1 # }, # { # "library": "libc.so.6", # "tag": "NEEDED", # "value": 74 # }, # ... import argparse import sys import lief import json def main(): parser = argparse.ArgumentParser() parser.add_argument('binary', help='PE binary') args = parser.parse_args() binary = lief.parse(args.binary) json_data = json.loads(lief.to_json(binary)) print(json.dumps(json_data, sort_keys=True, indent=4)) if __name__ == "__main__": sys.exit(main()) LIEF-0.13.1/api/python/examples/pe_reader.py000066400000000000000000000663031443457337100205460ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # # Description # ----------- # Print information about a PE file import lief from lief import PE from lief.PE import oid_to_string import argparse import sys import traceback class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_information(binary): print("== Information ==\n") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<28x}" print(format_str.format("Name:", binary.name)) print(format_hex.format("Virtual size:", binary.virtual_size)) print(format_str.format("Imphash:", PE.get_imphash(binary))) print(format_str.format("PIE:", str(binary.is_pie))) print(format_str.format("NX:", str(binary.has_nx))) @exceptions_handler(Exception) def print_header(binary): dos_header = binary.dos_header header = binary.header optional_header = binary.optional_header format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" print("== Dos Header ==") print(format_str.format("Magic:", str((dos_header.magic)))) print(format_dec.format("Used bytes in the last page:", dos_header.used_bytes_in_the_last_page)) print(format_dec.format("File size in pages:", dos_header.file_size_in_pages)) print(format_dec.format("Number of relocations:", dos_header.numberof_relocation)) print(format_dec.format("Header size in paragraphs:", dos_header.header_size_in_paragraphs)) print(format_dec.format("Minimum extra paragraphs:", dos_header.minimum_extra_paragraphs)) print(format_dec.format("Maximum extra paragraphs", dos_header.maximum_extra_paragraphs)) print(format_dec.format("Initial relative SS", dos_header.initial_relative_ss)) print(format_hex.format("Initial SP:", dos_header.initial_sp)) print(format_hex.format("Checksum:", dos_header.checksum)) print(format_dec.format("Initial IP:", dos_header.initial_ip)) print(format_dec.format("Initial CS:", dos_header.initial_relative_cs)) print(format_hex.format("Address of relocation table:", dos_header.addressof_relocation_table)) print(format_dec.format("Overlay number:", dos_header.overlay_number)) print(format_dec.format("OEM ID:", dos_header.oem_id)) print(format_dec.format("OEM information", dos_header.oem_info)) print(format_hex.format("Address of optional header:", dos_header.addressof_new_exeheader)) print("") print("== Header ==") char_str = " - ".join([str(chara).split(".")[-1] for chara in header.characteristics_list]) print(format_str.format("Signature:", "".join(map(chr, header.signature)))) print(format_str.format("Machine:", str(header.machine))) print(format_dec.format("Number of sections:", header.numberof_sections)) print(format_dec.format("Time Date stamp:", header.time_date_stamps)) print(format_dec.format("Pointer to symbols:", header.pointerto_symbol_table)) print(format_dec.format("Number of symbols:", header.numberof_symbols)) print(format_dec.format("Size of optional header:", header.sizeof_optional_header)) print(format_str.format("Characteristics:", char_str)) print("") dll_char_str = " - ".join([str(chara).split(".")[-1] for chara in optional_header.dll_characteristics_lists]) subsystem_str = str(optional_header.subsystem).split(".")[-1] print("== Optional Header ==") magic = "PE32" if optional_header.magic == PE.PE_TYPE.PE32 else "PE64" print(format_str.format("Magic:", magic)) print(format_dec.format("Major linker version:", optional_header.major_linker_version)) print(format_dec.format("Minor linker version:", optional_header.minor_linker_version)) print(format_dec.format("Size of code:", optional_header.sizeof_code)) print(format_dec.format("Size of initialized data:", optional_header.sizeof_initialized_data)) print(format_dec.format("Size of uninitialized data:", optional_header.sizeof_uninitialized_data)) print(format_hex.format("Entry point:", optional_header.addressof_entrypoint)) print(format_hex.format("Base of code:", optional_header.baseof_code)) if magic == "PE32": print(format_hex.format("Base of data", optional_header.baseof_data)) print(format_hex.format("Image base:", optional_header.imagebase)) print(format_hex.format("Section alignment:", optional_header.section_alignment)) print(format_hex.format("File alignment:", optional_header.file_alignment)) print(format_dec.format("Major operating system version:", optional_header.major_operating_system_version)) print(format_dec.format("Minor operating system version:", optional_header.minor_operating_system_version)) print(format_dec.format("Major image version:", optional_header.major_image_version)) print(format_dec.format("Minor image version:", optional_header.minor_image_version)) print(format_dec.format("Major subsystem version:", optional_header.major_subsystem_version)) print(format_dec.format("Minor subsystem version:", optional_header.minor_subsystem_version)) print(format_dec.format("WIN32 version value:", optional_header.win32_version_value)) print(format_hex.format("Size of image:", optional_header.sizeof_image)) print(format_hex.format("Size of headers:", optional_header.sizeof_headers)) print(format_hex.format("Checksum:", optional_header.checksum)) print(format_str.format("Subsystem:", subsystem_str)) print(format_str.format("DLL Characteristics:", dll_char_str)) print(format_hex.format("Size of stack reserve:", optional_header.sizeof_stack_reserve)) print(format_hex.format("Size of stack commit:", optional_header.sizeof_stack_commit)) print(format_hex.format("Size of heap reserve:", optional_header.sizeof_heap_reserve)) print(format_hex.format("Size of heap commit:", optional_header.sizeof_heap_commit)) print(format_dec.format("Loader flags:", optional_header.loader_flags)) print(format_dec.format("Number of RVA and size:", optional_header.numberof_rva_and_size)) print("") @exceptions_handler(Exception) def print_data_directories(binary): data_directories = binary.data_directories print("== Data Directories ==") f_title = "|{:<24} | {:<10} | {:<10} | {:<8} |" f_value = "|{:<24} | 0x{:<8x} | 0x{:<8x} | {:<8} |" print(f_title.format("Type", "RVA", "Size", "Section")) for directory in data_directories: section_name = directory.section.name if directory.has_section else "" print(f_value.format(str(directory.type).split('.')[-1], directory.rva, directory.size, section_name)) print("") @exceptions_handler(Exception) def print_sections(binary): sections = binary.sections print("== Sections ==") f_title = "|{:<10} | {:<16} | {:<16} | {:<18} | {:<16} | {:<9} | {:<9}" f_value = "|{:<10} | 0x{:<14x} | 0x{:<14x} | 0x{:<16x} | 0x{:<14x} | {:<9.2f} | {:<9}" print(f_title.format("Name", "Offset", "Size", "Virtual Address", "Virtual size", "Entropy", "Flags")) for section in sections: flags = "" for flag in section.characteristics_lists: flags += str(flag).split(".")[-1] + " " print(f_value.format(section.name, section.offset, section.size, section.virtual_address, section.virtual_size, section.entropy, flags)) print("") @exceptions_handler(Exception) def print_symbols(binary): symbols = binary.symbols if len(symbols) > 0: print("== Symbols ==") f_title = "|{:<20} | {:<10} | {:<8} | {:<8} | {:<8} | {:<13} |" f_value = u"|{:<20} | 0x{:<8x} | {:<14} | {:<10} | {:<12} | {:<13} |" print(f_title.format("Name", "Value", "Section number", "Basic type", "Complex type", "Storage class")) for symbol in symbols: section_nb_str = "" if symbol.section_number <= 0: section_nb_str = str(PE.SYMBOL_SECTION_NUMBER(symbol.section_number)).split(".")[-1] else: try: section_nb_str = symbol.section.name except Exception: section_nb_str = "section<{:d}>".format(symbol.section_number) print(f_value.format( symbol.name[:20], symbol.value, section_nb_str, str(symbol.base_type).split(".")[-1], str(symbol.complex_type).split(".")[-1], str(symbol.storage_class).split(".")[-1])) @exceptions_handler(Exception) def print_imports(binary, resolve=False): print("== Imports ==") imports = binary.imports for import_ in imports: if resolve: import_ = lief.PE.resolve_ordinals(import_) print(import_.name) entries = import_.entries f_value = " {:<33} 0x{:<14x} 0x{:<14x} 0x{:<16x}" for entry in entries: print(f_value.format(entry.name, entry.data, entry.iat_value, entry.hint)) print("") @exceptions_handler(Exception) def print_tls(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" print("== TLS ==") tls = binary.tls callbacks = tls.callbacks print(format_hex.format("Address of callbacks:", tls.addressof_callbacks)) if len(callbacks) > 0: print("Callbacks:") for callback in callbacks: print(" " + hex(callback)) print(format_hex.format("Address of index:", tls.addressof_index)) print(format_hex.format("Size of zero fill:", tls.sizeof_zero_fill)) print("{:<33} 0x{:<10x} 0x{:<10x}".format("Address of raw data:", tls.addressof_raw_data[0], tls.addressof_raw_data[1])) print(format_hex.format("Size of raw data:", len(tls.data_template))) print(format_hex.format("Characteristics:", tls.characteristics)) print(format_str.format("Section:", tls.section.name)) print(format_str.format("Data directory:", str(tls.directory.type))) print("") @exceptions_handler(Exception) def print_relocations(binary): relocations = binary.relocations print("== Relocations ==") for relocation in relocations: entries = relocation.entries print(hex(relocation.virtual_address)) for entry in entries: print(" 0x{:<8x} {:<8}".format(entry.position, str(entry.type).split(".")[-1])) print("") @exceptions_handler(Exception) def print_export(binary): print("== Exports ==") exports = binary.get_export() entries = exports.entries f_value = "{:<20} 0x{:<10x} 0x{:<10x} 0x{:<6x} 0x{:<6x} 0x{:<10x}" print(f_value.format(exports.name, exports.export_flags, exports.timestamp, exports.major_version, exports.minor_version, exports.ordinal_base)) entries = sorted(entries, key=lambda e : e.ordinal) for entry in entries: extern = "[EXTERN]" if entry.is_extern else "" print(" {:<20} {:d} 0x{:<10x} {:<13}".format(entry.name[:20], entry.ordinal, entry.address, extern)) print("") @exceptions_handler(Exception) def print_debug(binary): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" debugs = binary.debug print("== Debug ({}) ==".format(len(debugs))) for debug in debugs: print(format_hex.format("Characteristics:", debug.characteristics)) print(format_hex.format("Timestamp:", debug.timestamp)) print(format_dec.format("Major version:", debug.major_version)) print(format_dec.format("Minor version:", debug.minor_version)) print(format_str.format("type:", str(debug.type).split(".")[-1])) print(format_hex.format("Size of data:", debug.sizeof_data)) print(format_hex.format("Address of raw data:", debug.addressof_rawdata)) print(format_hex.format("Pointer to raw data:", debug.pointerto_rawdata)) if debug.has_code_view: code_view = debug.code_view cv_signature = code_view.cv_signature if cv_signature in (lief.PE.CODE_VIEW_SIGNATURES.PDB_70, lief.PE.CODE_VIEW_SIGNATURES.PDB_70): sig_str = " ".join(map(lambda e : "{:02x}".format(e), code_view.signature)) print(format_str.format("Code View Signature:", str(cv_signature).split(".")[-1])) print(format_str.format("Signature:", sig_str)) print(format_dec.format("Age:", code_view.age)) print(format_str.format("Filename:", code_view.filename)) if debug.has_pogo: pogo = debug.pogo sig_str = str(pogo.signature).split(".")[-1] print(format_str.format("Signature:", sig_str)) print("Entries:") for entry in pogo.entries: print(" {:<20} 0x{:x} ({:d})".format(entry.name, entry.start_rva, entry.size)) print("\n") @exceptions_handler(Exception) def print_signature(binary): format_str = "{:<33} {:<30}" format_dec = "{:<33} {:<30d}" for signature in binary.signatures: print(signature) @exceptions_handler(Exception) def print_rich_header(binary): print("== Rich Header ==") header = binary.rich_header print("Key: 0x{:08x}".format(header.key)) for entry in header.entries: print(" - ID: {:04x} Build ID: {:04x} Count: {:d}".format(entry.id, entry.build_id, entry.count)) print("") @exceptions_handler(Exception) def print_resources(binary): print("== Resources ==") manager = binary.resources_manager print(manager) print("") @exceptions_handler(Exception) def print_load_configuration(binary): format_str = "{:<45} {:<30}" format_hex = "{:<45} 0x{:<28x}" format_dec = "{:<45} {:<30d}" print("== Load Configuration ==") config = binary.load_configuration print(format_str.format("Version:", str(config.version).split(".")[-1])) print(format_dec.format("Characteristics:", config.characteristics)) print(format_dec.format("Timedatestamp:", config.timedatestamp)) print(format_dec.format("Major version:", config.major_version)) print(format_dec.format("Minor version:", config.minor_version)) print(format_hex.format("Global flags clear:", config.global_flags_clear)) print(format_hex.format("Global flags set:", config.global_flags_set)) print(format_dec.format("Critical section default timeout:", config.critical_section_default_timeout)) print(format_hex.format("Decommit free block threshold:", config.decommit_free_block_threshold)) print(format_hex.format("Decommit total free threshold:", config.decommit_total_free_threshold)) print(format_hex.format("Lock prefix table:", config.lock_prefix_table)) print(format_hex.format("Maximum allocation size:", config.maximum_allocation_size)) print(format_hex.format("Virtual memory threshold:", config.virtual_memory_threshold)) print(format_hex.format("Process affinity mask:", config.process_affinity_mask)) print(format_hex.format("Process heap flags:", config.process_heap_flags)) print(format_hex.format("CSD Version:", config.csd_version)) print(format_hex.format("Reserved 1:", config.reserved1)) print(format_hex.format("Edit list:", config.editlist)) print(format_hex.format("Security cookie:", config.security_cookie)) if isinstance(config, lief.PE.LoadConfigurationV0): print(format_hex.format("SE handler table:", config.se_handler_table)) print(format_dec.format("SE handler count:", config.se_handler_count)) if isinstance(config, lief.PE.LoadConfigurationV1): flags_str = " - ".join(map(lambda e : str(e).split(".")[-1], config.guard_cf_flags_list)) print(format_hex.format("GCF check function pointer:", config.guard_cf_check_function_pointer)) print(format_hex.format("GCF dispatch function pointer:", config.guard_cf_dispatch_function_pointer)) print(format_hex.format("GCF function table :", config.guard_cf_function_table)) print(format_dec.format("GCF Function count :", config.guard_cf_function_count)) print("{:<45} {} (0x{:x})".format("Guard flags:", flags_str, int(config.guard_flags))) if isinstance(config, lief.PE.LoadConfigurationV2): code_integrity = config.code_integrity print("Code Integrity:") print(format_dec.format(" " * 3 + "Flags:", code_integrity.flags)) print(format_dec.format(" " * 3 + "Catalog:", code_integrity.catalog)) print(format_hex.format(" " * 3 + "Catalog offset:", code_integrity.catalog_offset)) print(format_dec.format(" " * 3 + "Reserved:", code_integrity.reserved)) if isinstance(config, lief.PE.LoadConfigurationV3): print(format_hex.format("Guard address taken iat entry table:", config.guard_address_taken_iat_entry_table)) print(format_hex.format("Guard address taken iat entry count:", config.guard_address_taken_iat_entry_count)) print(format_hex.format("Guard long jump target table:", config.guard_long_jump_target_table)) print(format_hex.format("Guard long jump target count:", config.guard_long_jump_target_count)) if isinstance(config, lief.PE.LoadConfigurationV4): print(format_hex.format("Dynamic value relocation table:", config.dynamic_value_reloc_table)) print(format_hex.format("Hybrid metadata pointer:", config.hybrid_metadata_pointer)) if isinstance(config, lief.PE.LoadConfigurationV5): print(format_hex.format("GRF failure routine:", config.guard_rf_failure_routine)) print(format_hex.format("GRF failure routine function pointer:", config.guard_rf_failure_routine_function_pointer)) print(format_hex.format("Dynamic value reloctable offset:", config.dynamic_value_reloctable_offset)) print(format_hex.format("Dynamic value reloctable section:", config.dynamic_value_reloctable_section)) if isinstance(config, lief.PE.LoadConfigurationV6): print(format_hex.format("GRF verify stackpointer function pointer:", config.guard_rf_verify_stackpointer_function_pointer)) print(format_hex.format("Hotpatch table offset:", config.hotpatch_table_offset)) if isinstance(config, lief.PE.LoadConfigurationV7): print(format_hex.format("Reserved 3:", config.reserved3)) print("") @exceptions_handler(Exception) def print_ctor(binary): print("== Constructors ==\n") print("Functions: ({:d})".format(len(binary.ctor_functions))) for idx, f in enumerate(binary.ctor_functions): print(" [{:d}] {}: 0x{:x}".format(idx, f.name, f.address)) @exceptions_handler(Exception) def print_exception_functions(binary): print("== Exception functions ==\n") print("Functions: ({:d})".format(len(binary.exception_functions))) for idx, f in enumerate(binary.exception_functions): print(" [{:d}] {}: 0x{:x}".format(idx, f.name, f.address)) @exceptions_handler(Exception) def print_functions(binary): print("== Functions ==\n") print("Functions: ({:d})".format(len(binary.functions))) for idx, f in enumerate(binary.functions): print(" [{:d}] {}: 0x{:x} ({:d} bytes)".format(idx, f.name, f.address, f.size)) @exceptions_handler(Exception) def print_delay_imports(binary): delay_imports = binary.delay_imports if len(delay_imports) == 0: return print("== Delay Imports ==\n") for imp in delay_imports: print(imp.name) print(" Attribute: {}".format(imp.attribute)) print(" Handle: 0x{:x}".format(imp.handle)) print(" IAT: 0x{:x}".format(imp.iat)) print(" Names Table: 0x{:x}".format(imp.names_table)) print(" Bound IAT: 0x{:x}".format(imp.biat)) print(" Unload IAT: 0x{:x}".format(imp.uiat)) print(" Timestamp: 0x{:x}".format(imp.timestamp)) for entry in imp.entries: print(" {:<25} 0x{:08x}: 0x{:010x} - 0x{:x}".format(entry.name, entry.value, entry.iat_value, entry.hint)) def main(): parser = argparse.ArgumentParser() parser.add_argument("pe_file") parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Show all informations') parser.add_argument('-d', '--data-directories', action='store_true', dest='show_data_directories', help='Display data directories') parser.add_argument('--dbg', action='store_true', dest='show_debug', help='Display debug directory') parser.add_argument('-g', '--signature', action='store_true', dest='show_signature', help="Display the binary's signature if any") parser.add_argument('-H', '--header', action='store_true', dest='show_headers', help='Display headers') parser.add_argument('-i', '--import', action='store_true', dest='show_imports', help='Display imported functions and libraries') parser.add_argument('--resolve-ordinals', action='store_true', dest='resolve_ordinals', help="When used with --import, it attempts to resolve names of ordinal imports") parser.add_argument('-r', '--relocs', action='store_true', dest='show_relocs', help='Display the relocations (if present)') parser.add_argument('-R', '--rich-header', action='store_true', dest='show_richheader', help='Display the Rich Header') parser.add_argument('--resources', '--rsrc', action='store_true', dest='show_resources', help='Display the resources (if present)') parser.add_argument('-S', '--section-headers', '--sections', action='store_true', dest='show_section_header', help="Display the sections' headers") parser.add_argument('-s', '--symbols', '--syms', action='store_true', dest='show_symbols', help='Display symbols') parser.add_argument('-t', '--tls', action='store_true', dest='show_tls', help='Display TLS informations') parser.add_argument('-x', '--export', action='store_true', dest='show_export', help='Display exported functions/libraries') parser.add_argument('--load-config', action='store_true', dest='show_loadconfig', help='Display load configuration') parser.add_argument('--ctor', action='store_true', dest='show_ctor', help='Constructor functions') parser.add_argument('-f', '--functions', action='store_true', dest='show_functions', help='Display all functions found in the binary') parser.add_argument('--exception-functions', action='store_true', dest='show_pfunctions', help='Display functions found in the exception directory') parser.add_argument('--delay-imports', action='store_true', dest='show_delay_imports', help='Display delay imports') # Logging setup logger_group = parser.add_argument_group('Logger') verbosity = logger_group.add_mutually_exclusive_group() verbosity.add_argument('--debug', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.DEBUG) verbosity.add_argument('--trace', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.TRACE) verbosity.add_argument('--info', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.INFO) verbosity.add_argument('--warn', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.WARNING) verbosity.add_argument('--err', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.ERROR) verbosity.add_argument('--critical', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.CRITICAL) parser.set_defaults(main_verbosity=lief.logging.LOGGING_LEVEL.WARNING) args = parser.parse_args() lief.logging.set_level(args.main_verbosity) binary = None try: binary = PE.parse(args.pe_file) except lief.exception as e: print(e) sys.exit(1) if binary is None: sys.exit(1) print_information(binary) if args.show_data_directories or args.show_all: print_data_directories(binary) if args.show_headers or args.show_all: print_header(binary) if (args.show_imports or args.show_all) and binary.has_imports: print_imports(binary, resolve=args.resolve_ordinals) if (args.show_relocs or args.show_all) and binary.has_relocations: print_relocations(binary) if args.show_section_header or args.show_all: print_sections(binary) if args.show_symbols or args.show_all: print_symbols(binary) if (args.show_tls or args.show_all) and binary.has_tls: print_tls(binary) if (args.show_export or args.show_all) and binary.has_exports: print_export(binary) if (args.show_debug or args.show_all) and binary.has_debug: print_debug(binary) if (args.show_signature or args.show_all) and binary.has_signatures: print_signature(binary) if (args.show_richheader or args.show_all) and binary.has_rich_header: print_rich_header(binary) if (args.show_resources or args.show_all) and binary.has_resources: print_resources(binary) if (args.show_loadconfig or args.show_all) and binary.has_configuration: print_load_configuration(binary) if args.show_ctor or args.show_all: print_ctor(binary) if args.show_functions or args.show_all: print_functions(binary) if args.show_pfunctions or args.show_all: print_exception_functions(binary) if args.show_delay_imports or args.show_all: print_delay_imports(binary) if __name__ == "__main__": main() LIEF-0.13.1/api/python/examples/pe_resources_manager.py000066400000000000000000000002171443457337100230000ustar00rootroot00000000000000#!/usr/bin/env python import sys import lief b = lief.parse(sys.argv[1]) manager = b.resources_manager print(manager) print(manager.manifest) LIEF-0.13.1/api/python/examples/vdex_json.py000066400000000000000000000011771443457337100206150ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about a DEX file in the JSON format import argparse import sys import lief import json def main(): parser = argparse.ArgumentParser() parser.add_argument('file', help='VDEX file') args = parser.parse_args() if not lief.VDEX.is_vdex(args.file): print("{} is not a VDEX file".format(args.file)) return 1 dexfile = lief.VDEX.parse(args.file) json_data = json.loads(lief.to_json(dexfile)) print(json.dumps(json_data, sort_keys = True, indent = 4)) if __name__ == "__main__": sys.exit(main()) LIEF-0.13.1/api/python/examples/vdex_reader.py000066400000000000000000000074461443457337100211130ustar00rootroot00000000000000#!/usr/bin/env python # -*- coding: utf-8 -*- # Description # ----------- # Print information about Android VDEX files import sys import os import argparse import traceback import lief from lief import VDEX, DEX EXIT_STATUS = 0 terminal_rows, terminal_columns = 100, 100 try: terminal_rows, terminal_columns = os.popen('stty size', 'r').read().split() except ValueError: pass class exceptions_handler(object): func = None def __init__(self, exceptions, on_except_callback=None): self.exceptions = exceptions self.on_except_callback = on_except_callback def __call__(self, *args, **kwargs): if self.func is None: self.func = args[0] return self try: return self.func(*args, **kwargs) except self.exceptions as e: global EXIT_STATUS print("{} raised: {}".format(self.func.__name__, e)) EXIT_STATUS = 1 if self.on_except_callback is not None: self.on_except_callback(e) else: print("-" * 60) print("Exception in {}: {}".format(self.func.__name__, e)) exc_type, exc_value, exc_traceback = sys.exc_info() traceback.print_tb(exc_traceback) print("-" * 60) @exceptions_handler(Exception) def print_information(vdexfile): print("== Information ==") format_str = "{:<30} {:<30}" format_hex = "{:<30} 0x{:<28x}" format_dec = "{:<30} {:<30d}" version = vdexfile.header.version print("VDEX File version: {}".format(version)) print("") @exceptions_handler(Exception) def print_header(vdexfile): format_str = "{:<33} {:<30}" format_hex = "{:<33} 0x{:<28x}" format_dec = "{:<33} {:<30d}" print("== Header ==") header = vdexfile.header print(header) def main(): parser = argparse.ArgumentParser(usage='%(prog)s [options] VDEX files') parser.add_argument('-a', '--all', action='store_true', dest='show_all', help='Show all information') parser.add_argument('-H', '--header', action='store_true', dest='show_header', help='Display header') parser.add_argument("file", metavar="", help='Target DEX File') # Logging setup logger_group = parser.add_argument_group('Logger') verbosity = logger_group.add_mutually_exclusive_group() verbosity.add_argument('--debug', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.DEBUG) verbosity.add_argument('--trace', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.TRACE) verbosity.add_argument('--info', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.INFO) verbosity.add_argument('--warn', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.WARNING) verbosity.add_argument('--err', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.ERROR) verbosity.add_argument('--critical', dest='main_verbosity', action='store_const', const=lief.logging.LOGGING_LEVEL.CRITICAL) parser.set_defaults(main_verbosity=lief.logging.LOGGING_LEVEL.WARNING) args = parser.parse_args() lief.logging.set_level(args.main_verbosity) vdexfile = None try: vdexfile = DEX.parse(args.file) except lief.exception as e: print(e) sys.exit(1) print_information(vdexfile) if args.show_header or args.show_all: print_header(vdexfile) sys.exit(EXIT_STATUS) if __name__ == "__main__": main() LIEF-0.13.1/api/python/lief/000077500000000000000000000000001443457337100153375ustar00rootroot00000000000000LIEF-0.13.1/api/python/lief/ART.pyi000066400000000000000000000043671443457337100165220ustar00rootroot00000000000000from typing import ClassVar, List from typing import overload import lief # type: ignore import lief.ART # type: ignore import lief.Android # type: ignore class File(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def header(self) -> lief.ART.Header: ... class Header(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def boot_image_begin(self) -> int: ... @property def boot_image_size(self) -> int: ... @property def boot_oat_begin(self) -> int: ... @property def boot_oat_size(self) -> int: ... @property def compile_pic(self) -> bool: ... @property def data_size(self) -> int: ... @property def image_begin(self) -> int: ... @property def image_roots(self) -> int: ... @property def image_size(self) -> int: ... @property def magic(self) -> List[int]: ... @property def nb_methods(self) -> int: ... @property def nb_sections(self) -> int: ... @property def oat_checksum(self) -> int: ... @property def oat_data_end(self) -> int: ... @property def oat_file_begin(self) -> int: ... @property def oat_file_end(self) -> int: ... @property def patch_delta(self) -> int: ... @property def pointer_size(self) -> int: ... @property def storage_mode(self) -> lief.ART.STORAGE_MODES: ... @property def version(self) -> int: ... class STORAGE_MODES: __members__: ClassVar[dict] = ... # read-only LZ4: ClassVar[STORAGE_MODES] = ... LZ4HC: ClassVar[STORAGE_MODES] = ... UNCOMPRESSED: ClassVar[STORAGE_MODES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def android_version(art_version: int) -> lief.Android.ANDROID_VERSIONS: ... @overload def is_art(path: str) -> bool: ... @overload def is_art(raw: List[int]) -> bool: ... @overload def parse(filename: str) -> lief.ART.File: ... @overload def parse(raw: List[int], name: str = ...) -> lief.ART.File: ... @overload def parse(io: object, name: str = ...) -> lief.ART.File: ... @overload def version(file: str) -> int: ... @overload def version(raw: List[int]) -> int: ... LIEF-0.13.1/api/python/lief/Android.pyi000066400000000000000000000015211443457337100174410ustar00rootroot00000000000000from typing import ClassVar import lief.Android # type: ignore class ANDROID_VERSIONS: __members__: ClassVar[dict] = ... # read-only UNKNOWN: ClassVar[ANDROID_VERSIONS] = ... VERSION_601: ClassVar[ANDROID_VERSIONS] = ... VERSION_700: ClassVar[ANDROID_VERSIONS] = ... VERSION_710: ClassVar[ANDROID_VERSIONS] = ... VERSION_712: ClassVar[ANDROID_VERSIONS] = ... VERSION_800: ClassVar[ANDROID_VERSIONS] = ... VERSION_810: ClassVar[ANDROID_VERSIONS] = ... VERSION_900: ClassVar[ANDROID_VERSIONS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def code_name(version: lief.Android.ANDROID_VERSIONS) -> str: ... def version_string(version: lief.Android.ANDROID_VERSIONS) -> str: ... LIEF-0.13.1/api/python/lief/DEX.pyi000066400000000000000000000312351443457337100165060ustar00rootroot00000000000000from typing import Any, ClassVar, Iterator, List, Tuple from typing import overload import lief # type: ignore import lief.DEX # type: ignore class ACCESS_FLAGS: __members__: ClassVar[dict] = ... # read-only ABSTRACT: ClassVar[ACCESS_FLAGS] = ... ANNOTATION: ClassVar[ACCESS_FLAGS] = ... BRIDGE: ClassVar[ACCESS_FLAGS] = ... CONSTRUCTOR: ClassVar[ACCESS_FLAGS] = ... DECLARED_SYNCHRONIZED: ClassVar[ACCESS_FLAGS] = ... ENUM: ClassVar[ACCESS_FLAGS] = ... FINAL: ClassVar[ACCESS_FLAGS] = ... INTERFACE: ClassVar[ACCESS_FLAGS] = ... NATIVE: ClassVar[ACCESS_FLAGS] = ... PRIVATE: ClassVar[ACCESS_FLAGS] = ... PROTECTED: ClassVar[ACCESS_FLAGS] = ... PUBLIC: ClassVar[ACCESS_FLAGS] = ... STATIC: ClassVar[ACCESS_FLAGS] = ... STRICT: ClassVar[ACCESS_FLAGS] = ... SYNCHRONIZED: ClassVar[ACCESS_FLAGS] = ... SYNTHETIC: ClassVar[ACCESS_FLAGS] = ... TRANSIENT: ClassVar[ACCESS_FLAGS] = ... UNKNOWN: ClassVar[ACCESS_FLAGS] = ... VARARGS: ClassVar[ACCESS_FLAGS] = ... VOLATILE: ClassVar[ACCESS_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Class(lief.Object): class it_fields: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Field: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Field: ... class it_methods: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Method: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Method: ... class it_named_fields: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Field: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Field: ... class it_named_methods: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Method: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Method: ... def __init__(self, *args, **kwargs) -> None: ... def get_field(self, name: str) -> lief.DEX.Class.it_named_fields: ... def get_method(self, name: str) -> lief.DEX.Class.it_named_methods: ... def has(self, flag: lief.DEX.ACCESS_FLAGS) -> bool: ... @property def access_flags(self) -> List[lief.DEX.ACCESS_FLAGS]: ... @property def dex2dex_info(self) -> Any: ... @property def fields(self) -> lief.DEX.Class.it_fields: ... @property def fullname(self) -> str: ... @property def has_parent(self) -> bool: ... @property def index(self) -> int: ... @property def methods(self) -> lief.DEX.Class.it_methods: ... @property def name(self) -> str: ... @property def package_name(self) -> str: ... @property def parent(self) -> lief.DEX.Class: ... @property def pretty_name(self) -> str: ... @property def source_filename(self) -> str: ... class CodeInfo(lief.Object): def __init__(self, *args, **kwargs) -> None: ... class Field(lief.Object): def __init__(self, *args, **kwargs) -> None: ... def has(self, flag: lief.DEX.ACCESS_FLAGS) -> bool: ... @property def access_flags(self) -> List[lief.DEX.ACCESS_FLAGS]: ... @property def cls(self) -> lief.DEX.Class: ... @property def has_class(self) -> bool: ... @property def index(self) -> int: ... @property def is_static(self) -> bool: ... @property def name(self) -> str: ... @property def type(self) -> lief.DEX.Type: ... class File(lief.Object): class it_classes: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Class: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Class: ... class it_fields: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Field: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Field: ... class it_methods: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Method: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Method: ... class it_prototypes: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Prototype: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Prototype: ... class it_strings: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> str: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> str: ... class it_types: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Type: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Type: ... location: str name: str def __init__(self, *args, **kwargs) -> None: ... @overload def get_class(self, classname: str) -> lief.DEX.Class: ... @overload def get_class(self, classname: int) -> lief.DEX.Class: ... def has_class(self, classname: str) -> bool: ... def raw(self, deoptimize: bool = ...) -> List[int]: ... def save(self, output: str = ..., deoptimize: bool = ...) -> str: ... @property def classes(self) -> lief.DEX.File.it_classes: ... @property def dex2dex_json_info(self) -> str: ... @property def fields(self) -> lief.DEX.File.it_fields: ... @property def header(self) -> lief.DEX.Header: ... @property def map(self) -> lief.DEX.MapList: ... @property def methods(self) -> lief.DEX.File.it_methods: ... @property def prototypes(self) -> lief.DEX.File.it_prototypes: ... @property def strings(self) -> lief.DEX.File.it_strings: ... @property def types(self) -> lief.DEX.File.it_types: ... @property def version(self) -> int: ... class Header(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def checksum(self) -> int: ... @property def classes(self) -> Tuple[int,int]: ... @property def data(self) -> Tuple[int,int]: ... @property def endian_tag(self) -> int: ... @property def fields(self) -> Tuple[int,int]: ... @property def file_size(self) -> int: ... @property def header_size(self) -> int: ... @property def link(self) -> Tuple[int,int]: ... @property def magic(self) -> List[int]: ... @property def map_offset(self) -> int: ... @property def methods(self) -> Tuple[int,int]: ... @property def nb_classes(self) -> int: ... @property def nb_methods(self) -> int: ... @property def prototypes(self) -> Tuple[int,int]: ... @property def signature(self) -> List[int]: ... @property def strings(self) -> Tuple[int,int]: ... @property def types(self) -> Tuple[int,int]: ... class MapItem(lief.Object): class TYPES: __members__: ClassVar[dict] = ... # read-only ANNOTATION: ClassVar[MapItem.TYPES] = ... ANNOTATIONS_DIRECTORY: ClassVar[MapItem.TYPES] = ... ANNOTATION_SET: ClassVar[MapItem.TYPES] = ... ANNOTATION_SET_REF_LIST: ClassVar[MapItem.TYPES] = ... CALL_SITE_ID: ClassVar[MapItem.TYPES] = ... CLASS_DATA: ClassVar[MapItem.TYPES] = ... CLASS_DEF: ClassVar[MapItem.TYPES] = ... CODE: ClassVar[MapItem.TYPES] = ... DEBUG_INFO: ClassVar[MapItem.TYPES] = ... ENCODED_ARRAY: ClassVar[MapItem.TYPES] = ... FIELD_ID: ClassVar[MapItem.TYPES] = ... HEADER: ClassVar[MapItem.TYPES] = ... MAP_LIST: ClassVar[MapItem.TYPES] = ... METHOD_HANDLE: ClassVar[MapItem.TYPES] = ... METHOD_ID: ClassVar[MapItem.TYPES] = ... PROTO_ID: ClassVar[MapItem.TYPES] = ... STRING_DATA: ClassVar[MapItem.TYPES] = ... STRING_ID: ClassVar[MapItem.TYPES] = ... TYPE_ID: ClassVar[MapItem.TYPES] = ... TYPE_LIST: ClassVar[MapItem.TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def __init__(self, *args, **kwargs) -> None: ... @property def offset(self) -> int: ... @property def size(self) -> int: ... @property def type(self) -> lief.DEX.MapItem.TYPES: ... class MapList(lief.Object): class it_items_t: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.MapItem: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.MapItem: ... def __init__(self, *args, **kwargs) -> None: ... def get(self, type: lief.DEX.MapItem.TYPES) -> lief.DEX.MapItem: ... def has(self, type: lief.DEX.MapItem.TYPES) -> bool: ... def __getitem__(self, arg0: lief.DEX.MapItem.TYPES) -> lief.DEX.MapItem: ... @property def items(self) -> lief.DEX.MapList.it_items_t: ... class Method(lief.Object): def __init__(self, *args, **kwargs) -> None: ... def has(self, flag: lief.DEX.ACCESS_FLAGS) -> bool: ... def insert_dex2dex_info(self, pc: int, index: int) -> None: ... @property def access_flags(self) -> List[lief.DEX.ACCESS_FLAGS]: ... @property def bytecode(self) -> List[int]: ... @property def cls(self) -> lief.DEX.Class: ... @property def code_offset(self) -> int: ... @property def has_class(self) -> bool: ... @property def index(self) -> int: ... @property def is_virtual(self) -> bool: ... @property def name(self) -> str: ... @property def prototype(self) -> lief.DEX.Prototype: ... class Prototype(lief.Object): class it_params: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.Type: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.Type: ... def __init__(self, *args, **kwargs) -> None: ... @property def parameters_type(self) -> lief.DEX.Prototype.it_params: ... @property def return_type(self) -> lief.DEX.Type: ... class Type(lief.Object): class PRIMITIVES: __members__: ClassVar[dict] = ... # read-only BOOLEAN: ClassVar[Type.PRIMITIVES] = ... BYTE: ClassVar[Type.PRIMITIVES] = ... CHAR: ClassVar[Type.PRIMITIVES] = ... DOUBLE: ClassVar[Type.PRIMITIVES] = ... FLOAT: ClassVar[Type.PRIMITIVES] = ... INT: ClassVar[Type.PRIMITIVES] = ... LONG: ClassVar[Type.PRIMITIVES] = ... SHORT: ClassVar[Type.PRIMITIVES] = ... VOID_T: ClassVar[Type.PRIMITIVES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class TYPES: __members__: ClassVar[dict] = ... # read-only ARRAY: ClassVar[Type.TYPES] = ... CLASS: ClassVar[Type.TYPES] = ... PRIMITIVE: ClassVar[Type.TYPES] = ... UNKNOWN: ClassVar[Type.TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def __init__(self, *args, **kwargs) -> None: ... def pretty_name(self, *args, **kwargs) -> Any: ... @property def dim(self) -> int: ... @property def type(self) -> lief.DEX.Type.TYPES: ... @property def underlying_array_type(self) -> lief.DEX.Type: ... @property def value(self) -> object: ... @overload def is_dex(path: str) -> bool: ... @overload def is_dex(raw: List[int]) -> bool: ... @overload def parse(filename: str) -> lief.DEX.File: ... @overload def parse(raw: List[int], name: str = ...) -> lief.DEX.File: ... @overload def parse(io: object, name: str = ...) -> lief.DEX.File: ... @overload def version(file: str) -> int: ... @overload def version(raw: List[int]) -> int: ... LIEF-0.13.1/api/python/lief/ELF.pyi000066400000000000000000003004161443457337100164740ustar00rootroot00000000000000from typing import Any, ClassVar, Dict, Iterable, Iterator, List, Set from typing import overload import lief # type: ignore import lief.ELF # type: ignore class ARCH: __members__: ClassVar[dict] = ... # read-only AARCH64: ClassVar[ARCH] = ... ALPHA: ClassVar[ARCH] = ... ALTERA_NIOS2: ClassVar[ARCH] = ... AMDGPU: ClassVar[ARCH] = ... ARC: ClassVar[ARCH] = ... ARCA: ClassVar[ARCH] = ... ARCH_56800EX: ClassVar[ARCH] = ... ARCH_68HC05: ClassVar[ARCH] = ... ARCH_68HC08: ClassVar[ARCH] = ... ARCH_68HC11: ClassVar[ARCH] = ... ARCH_68HC12: ClassVar[ARCH] = ... ARCH_68HC16: ClassVar[ARCH] = ... ARCH_68K: ClassVar[ARCH] = ... ARCH_78KOR: ClassVar[ARCH] = ... ARCH_8051: ClassVar[ARCH] = ... ARCH_860: ClassVar[ARCH] = ... ARCH_88K: ClassVar[ARCH] = ... ARCH_960: ClassVar[ARCH] = ... ARC_COMPACT: ClassVar[ARCH] = ... ARC_COMPACT2: ClassVar[ARCH] = ... ARM: ClassVar[ARCH] = ... AVR: ClassVar[ARCH] = ... AVR32: ClassVar[ARCH] = ... BA1: ClassVar[ARCH] = ... BA2: ClassVar[ARCH] = ... BLACKFIN: ClassVar[ARCH] = ... BPF: ClassVar[ARCH] = ... C166: ClassVar[ARCH] = ... CDP: ClassVar[ARCH] = ... CE: ClassVar[ARCH] = ... CLOUDSHIELD: ClassVar[ARCH] = ... COGE: ClassVar[ARCH] = ... COLDFIRE: ClassVar[ARCH] = ... COOL: ClassVar[ARCH] = ... COREA_1ST: ClassVar[ARCH] = ... COREA_2ND: ClassVar[ARCH] = ... CR: ClassVar[ARCH] = ... CR16: ClassVar[ARCH] = ... CRAYNV2: ClassVar[ARCH] = ... CRIS: ClassVar[ARCH] = ... CRX: ClassVar[ARCH] = ... CSR_KALIMBA: ClassVar[ARCH] = ... CUDA: ClassVar[ARCH] = ... CYPRESS_M8C: ClassVar[ARCH] = ... D10V: ClassVar[ARCH] = ... D30V: ClassVar[ARCH] = ... DSP24: ClassVar[ARCH] = ... DSPIC30F: ClassVar[ARCH] = ... DXP: ClassVar[ARCH] = ... ECOG1: ClassVar[ARCH] = ... ECOG16: ClassVar[ARCH] = ... ECOG1X: ClassVar[ARCH] = ... ECOG2: ClassVar[ARCH] = ... ETPU: ClassVar[ARCH] = ... EXCESS: ClassVar[ARCH] = ... F2MC16: ClassVar[ARCH] = ... FIREPATH: ClassVar[ARCH] = ... FR20: ClassVar[ARCH] = ... FR30: ClassVar[ARCH] = ... FX66: ClassVar[ARCH] = ... H8S: ClassVar[ARCH] = ... H8_300: ClassVar[ARCH] = ... H8_300H: ClassVar[ARCH] = ... H8_500: ClassVar[ARCH] = ... HEXAGON: ClassVar[ARCH] = ... HUANY: ClassVar[ARCH] = ... IAMCU: ClassVar[ARCH] = ... IA_64: ClassVar[ARCH] = ... INTEL205: ClassVar[ARCH] = ... INTEL206: ClassVar[ARCH] = ... INTEL207: ClassVar[ARCH] = ... INTEL208: ClassVar[ARCH] = ... INTEL209: ClassVar[ARCH] = ... IP2K: ClassVar[ARCH] = ... JAVELIN: ClassVar[ARCH] = ... K10M: ClassVar[ARCH] = ... KM32: ClassVar[ARCH] = ... KMX16: ClassVar[ARCH] = ... KMX32: ClassVar[ARCH] = ... KMX8: ClassVar[ARCH] = ... KVARC: ClassVar[ARCH] = ... L10M: ClassVar[ARCH] = ... LATTICEMICO32: ClassVar[ARCH] = ... M16C: ClassVar[ARCH] = ... M32: ClassVar[ARCH] = ... M32C: ClassVar[ARCH] = ... M32R: ClassVar[ARCH] = ... MANIK: ClassVar[ARCH] = ... MAX: ClassVar[ARCH] = ... MAXQ30: ClassVar[ARCH] = ... MCHP_PIC: ClassVar[ARCH] = ... MCST_ELBRUS: ClassVar[ARCH] = ... ME16: ClassVar[ARCH] = ... METAG: ClassVar[ARCH] = ... MIPS: ClassVar[ARCH] = ... MIPS_RS3_LE: ClassVar[ARCH] = ... MIPS_X: ClassVar[ARCH] = ... MMA: ClassVar[ARCH] = ... MMDSP_PLUS: ClassVar[ARCH] = ... MMIX: ClassVar[ARCH] = ... MN10200: ClassVar[ARCH] = ... MN10300: ClassVar[ARCH] = ... MSP430: ClassVar[ARCH] = ... NCPU: ClassVar[ARCH] = ... NDR1: ClassVar[ARCH] = ... NDS32: ClassVar[ARCH] = ... NONE: ClassVar[ARCH] = ... NORC: ClassVar[ARCH] = ... NS32K: ClassVar[ARCH] = ... OPEN8: ClassVar[ARCH] = ... OPENRISC: ClassVar[ARCH] = ... PARISC: ClassVar[ARCH] = ... PCP: ClassVar[ARCH] = ... PDP10: ClassVar[ARCH] = ... PDP11: ClassVar[ARCH] = ... PDSP: ClassVar[ARCH] = ... PJ: ClassVar[ARCH] = ... PPC: ClassVar[ARCH] = ... PPC64: ClassVar[ARCH] = ... PRISM: ClassVar[ARCH] = ... R32C: ClassVar[ARCH] = ... RCE: ClassVar[ARCH] = ... RH32: ClassVar[ARCH] = ... RISCV: ClassVar[ARCH] = ... RL78: ClassVar[ARCH] = ... RS08: ClassVar[ARCH] = ... RX: ClassVar[ARCH] = ... S370: ClassVar[ARCH] = ... S390: ClassVar[ARCH] = ... SCORE7: ClassVar[ARCH] = ... SEP: ClassVar[ARCH] = ... SE_C17: ClassVar[ARCH] = ... SE_C33: ClassVar[ARCH] = ... SH: ClassVar[ARCH] = ... SHARC: ClassVar[ARCH] = ... SLE9X: ClassVar[ARCH] = ... SNP1K: ClassVar[ARCH] = ... SPARC: ClassVar[ARCH] = ... SPARC32PLUS: ClassVar[ARCH] = ... SPARCV9: ClassVar[ARCH] = ... SPU: ClassVar[ARCH] = ... ST100: ClassVar[ARCH] = ... ST19: ClassVar[ARCH] = ... ST200: ClassVar[ARCH] = ... ST7: ClassVar[ARCH] = ... ST9PLUS: ClassVar[ARCH] = ... STARCORE: ClassVar[ARCH] = ... STM8: ClassVar[ARCH] = ... STXP7X: ClassVar[ARCH] = ... SVX: ClassVar[ARCH] = ... TILE64: ClassVar[ARCH] = ... TILEGX: ClassVar[ARCH] = ... TILEPRO: ClassVar[ARCH] = ... TINYJ: ClassVar[ARCH] = ... TI_C2000: ClassVar[ARCH] = ... TI_C5500: ClassVar[ARCH] = ... TI_C6000: ClassVar[ARCH] = ... TMM_GPP: ClassVar[ARCH] = ... TPC: ClassVar[ARCH] = ... TRICORE: ClassVar[ARCH] = ... TRIMEDIA: ClassVar[ARCH] = ... TSK3000: ClassVar[ARCH] = ... UNICORE: ClassVar[ARCH] = ... V800: ClassVar[ARCH] = ... V850: ClassVar[ARCH] = ... VAX: ClassVar[ARCH] = ... VIDEOCORE: ClassVar[ARCH] = ... VIDEOCORE3: ClassVar[ARCH] = ... VIDEOCORE5: ClassVar[ARCH] = ... VPP500: ClassVar[ARCH] = ... XCORE: ClassVar[ARCH] = ... XGATE: ClassVar[ARCH] = ... XIMO16: ClassVar[ARCH] = ... XTENSA: ClassVar[ARCH] = ... ZSP: ClassVar[ARCH] = ... __entries: ClassVar[dict] = ... i386: ClassVar[ARCH] = ... x86_64: ClassVar[ARCH] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ARM_EFLAGS: __members__: ClassVar[dict] = ... # read-only EABI_VER1: ClassVar[ARM_EFLAGS] = ... EABI_VER2: ClassVar[ARM_EFLAGS] = ... EABI_VER3: ClassVar[ARM_EFLAGS] = ... EABI_VER4: ClassVar[ARM_EFLAGS] = ... EABI_VER5: ClassVar[ARM_EFLAGS] = ... SOFT_FLOAT: ClassVar[ARM_EFLAGS] = ... UNKNOWN: ClassVar[ARM_EFLAGS] = ... VFP_FLOAT: ClassVar[ARM_EFLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class AndroidNote(NoteDetails): ndk_build_number: str ndk_version: str sdk_version: int def __init__(self, *args, **kwargs) -> None: ... class Binary(lief.Binary): class PHDR_RELOC: __members__: ClassVar[dict] = ... # read-only AUTO: ClassVar[Binary.PHDR_RELOC] = ... BSS_END: ClassVar[Binary.PHDR_RELOC] = ... FILE_END: ClassVar[Binary.PHDR_RELOC] = ... PIE_SHIFT: ClassVar[Binary.PHDR_RELOC] = ... SEGMENT_GAP: ClassVar[Binary.PHDR_RELOC] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class it_dyn_static_symbols: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Symbol: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Symbol: ... class it_dynamic_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.DynamicEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.DynamicEntry: ... class it_filter_relocation: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Relocation: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Relocation: ... class it_filter_symbols: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Symbol: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Symbol: ... class it_notes: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Note: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Note: ... class it_relocations: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Relocation: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Relocation: ... class it_sections: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Section: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Section: ... class it_segments: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Segment: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Segment: ... class it_symbols: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Symbol: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Symbol: ... class it_symbols_version: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.SymbolVersion: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.SymbolVersion: ... class it_symbols_version_definition: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.SymbolVersionDefinition: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.SymbolVersionDefinition: ... class it_symbols_version_requirement: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.SymbolVersionRequirement: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.SymbolVersionRequirement: ... interpreter: Any overlay: List[int] def __init__(self, *args, **kwargs) -> None: ... @overload def add(self, arg0: lief.ELF.DynamicEntry) -> lief.ELF.DynamicEntry: ... @overload def add(self, section: lief.ELF.Section, loaded: bool = ...) -> lief.ELF.Section: ... @overload def add(self, Addanew, base: int = ...) -> lief.ELF.Segment: ... @overload def add(self, note: lief.ELF.Note) -> lief.ELF.Note: ... def add_dynamic_relocation(self, relocation: lief.ELF.Relocation) -> lief.ELF.Relocation: ... def add_dynamic_symbol(self, symbol: lief.ELF.Symbol, symbol_version: lief.ELF.SymbolVersion = ...) -> lief.ELF.Symbol: ... def add_exported_function(self, address: int, name: str = ...) -> lief.ELF.Symbol: ... def add_library(self, library_name: str) -> lief.ELF.DynamicEntryLibrary: ... def add_object_relocation(self, relocation: lief.ELF.Relocation, section: lief.ELF.Section) -> lief.ELF.Relocation: ... def add_pltgot_relocation(self, relocation: lief.ELF.Relocation) -> lief.ELF.Relocation: ... def add_static_symbol(self, symbol: lief.ELF.Symbol) -> lief.ELF.Symbol: ... @overload def export_symbol(self, symbol: lief.ELF.Symbol) -> lief.ELF.Symbol: ... @overload def export_symbol(self, symbol_name: str, value: int = ...) -> lief.ELF.Symbol: ... @overload def extend(self, segment: lief.ELF.Segment, size: int) -> lief.ELF.Segment: ... @overload def extend(self, segment: lief.ELF.Section, size: int) -> lief.ELF.Section: ... @overload def get(self, tag: lief.ELF.DYNAMIC_TAGS) -> lief.ELF.DynamicEntry: ... @overload def get(self, type: lief.ELF.SEGMENT_TYPES) -> lief.ELF.Segment: ... @overload def get(self, type: lief.ELF.NOTE_TYPES) -> lief.ELF.Note: ... @overload def get(self, type: lief.ELF.SECTION_TYPES) -> lief.ELF.Section: ... def get_dynamic_symbol(self, symbol_name: str) -> lief.ELF.Symbol: ... def get_library(self, library_name: str) -> lief.ELF.DynamicEntryLibrary: ... @overload def get_relocation(self, symbol_name: str) -> lief.ELF.Relocation: ... @overload def get_relocation(self, symbol: lief.ELF.Symbol) -> lief.ELF.Relocation: ... @overload def get_relocation(self, address: int) -> lief.ELF.Relocation: ... def get_section(self, section_name: str) -> lief.ELF.Section: ... def get_static_symbol(self, symbol_name: str) -> lief.ELF.Symbol: ... def get_strings(self, min_size: int = ...) -> List[str]: ... @overload def has(self, tag: lief.ELF.DYNAMIC_TAGS) -> bool: ... @overload def has(self, type: lief.ELF.SEGMENT_TYPES) -> bool: ... @overload def has(self, type: lief.ELF.NOTE_TYPES) -> bool: ... @overload def has(self, type: lief.ELF.SECTION_TYPES) -> bool: ... def has_dynamic_symbol(self, symbol_name: str) -> bool: ... def has_library(self, library_name: str) -> bool: ... def has_section(self, section_name: str) -> bool: ... def has_section_with_offset(self, offset: int) -> bool: ... def has_section_with_va(self, virtual_address: int) -> bool: ... def has_static_symbol(self, symbol_name: str) -> bool: ... @overload def patch_pltgot(self, symbol_name: str, address: int) -> None: ... @overload def patch_pltgot(self, symbol: lief.ELF.Symbol, address: int) -> None: ... def permute_dynamic_symbols(self, permutation: List[int]) -> None: ... def relocate_phdr_table(self, type: lief.ELF.Binary.PHDR_RELOC = ...) -> int: ... @overload def remove(self, dynamic_entry: lief.ELF.DynamicEntry) -> None: ... @overload def remove(self, tag: lief.ELF.DYNAMIC_TAGS) -> None: ... @overload def remove(self, section: lief.ELF.Section, clear: bool = ...) -> None: ... @overload def remove(self, note: lief.ELF.Note) -> None: ... @overload def remove(self, type: lief.ELF.NOTE_TYPES) -> None: ... @overload def remove_dynamic_symbol(self, arg0: lief.ELF.Symbol) -> None: ... @overload def remove_dynamic_symbol(self, arg0: str) -> None: ... def remove_library(self, library_name: str) -> None: ... def remove_static_symbol(self, arg0: lief.ELF.Symbol) -> None: ... def replace(self, new_segment: lief.ELF.Segment, original_segment: lief.ELF.Segment, base: int = ...) -> lief.ELF.Segment: ... def section_from_offset(self, offset: int, skip_nobits: bool = ...) -> lief.ELF.Section: ... def section_from_virtual_address(self, address: int, skip_nobits: bool = ...) -> lief.ELF.Section: ... def segment_from_offset(self, offset: int) -> lief.ELF.Segment: ... def segment_from_virtual_address(self, address: int) -> lief.ELF.Segment: ... def strip(self) -> None: ... def virtual_address_to_offset(self, virtual_address: int) -> object: ... @overload def write(self, output: str) -> None: ... @overload def write(self, output: str, config: lief.ELF.Builder.config_t) -> None: ... @overload def __contains__(self, arg0: lief.ELF.SEGMENT_TYPES) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.DYNAMIC_TAGS) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.NOTE_TYPES) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.SECTION_TYPES) -> bool: ... @overload def __getitem__(self, arg0: lief.ELF.SEGMENT_TYPES) -> lief.ELF.Segment: ... @overload def __getitem__(self, arg0: lief.ELF.NOTE_TYPES) -> lief.ELF.Note: ... @overload def __getitem__(self, arg0: lief.ELF.DYNAMIC_TAGS) -> lief.ELF.DynamicEntry: ... @overload def __getitem__(self, arg0: lief.ELF.SECTION_TYPES) -> lief.ELF.Section: ... @overload def __iadd__(self, arg0: lief.ELF.Segment) -> lief.ELF.Binary: ... @overload def __iadd__(self, arg0: lief.ELF.Section) -> lief.ELF.Binary: ... @overload def __iadd__(self, arg0: lief.ELF.DynamicEntry) -> lief.ELF.Binary: ... @overload def __iadd__(self, arg0: lief.ELF.Note) -> lief.ELF.Binary: ... @overload def __isub__(self, arg0: lief.ELF.DynamicEntry) -> lief.ELF.Binary: ... @overload def __isub__(self, arg0: lief.ELF.DYNAMIC_TAGS) -> lief.ELF.Binary: ... @overload def __isub__(self, arg0: lief.ELF.Note) -> lief.ELF.Binary: ... @overload def __isub__(self, arg0: lief.ELF.NOTE_TYPES) -> lief.ELF.Binary: ... @property def dtor_functions(self) -> List[lief.Function]: ... @property def dynamic_entries(self) -> lief.ELF.Binary.it_dynamic_entries: ... @property def dynamic_relocations(self) -> lief.ELF.Binary.it_filter_relocation: ... @property def dynamic_symbols(self) -> lief.ELF.Binary.it_symbols: ... @property def eof_offset(self) -> int: ... @property def exported_symbols(self) -> lief.ELF.Binary.it_filter_symbols: ... @property def functions(self) -> List[lief.Function]: ... @property def gnu_hash(self) -> lief.ELF.GnuHash: ... @property def has_interpreter(self) -> bool: ... @property def has_notes(self) -> bool: ... @property def has_overlay(self) -> bool: ... @property def header(self) -> lief.ELF.Header: ... @property def imagebase(self) -> int: ... @property def imported_symbols(self) -> lief.ELF.Binary.it_filter_symbols: ... @property def is_pie(self) -> bool: ... @property def last_offset_section(self) -> int: ... @property def last_offset_segment(self) -> int: ... @property def next_virtual_address(self) -> int: ... @property def notes(self) -> lief.ELF.Binary.it_notes: ... @property def object_relocations(self) -> lief.ELF.Binary.it_filter_relocation: ... @property def pltgot_relocations(self) -> lief.ELF.Binary.it_filter_relocation: ... @property def relocations(self) -> lief.ELF.Binary.it_relocations: ... @property def sections(self) -> lief.ELF.Binary.it_sections: ... @property def segments(self) -> lief.ELF.Binary.it_segments: ... @property def static_symbols(self) -> lief.ELF.Binary.it_symbols: ... @property def strings(self) -> List[str]: ... @property def symbols(self) -> lief.ELF.Binary.it_dyn_static_symbols: ... @property def symbols_version(self) -> lief.ELF.Binary.it_symbols_version: ... @property def symbols_version_definition(self) -> lief.ELF.Binary.it_symbols_version_definition: ... @property def symbols_version_requirement(self) -> lief.ELF.Binary.it_symbols_version_requirement: ... @property def sysv_hash(self) -> lief.ELF.SysvHash: ... @property def type(self) -> lief.ELF.ELF_CLASS: ... @property def use_gnu_hash(self) -> bool: ... @property def use_sysv_hash(self) -> bool: ... @property def virtual_size(self) -> int: ... class Builder: class config_t: dt_hash: bool dyn_str: bool dynamic_section: bool fini_array: bool force_relocate: bool init_array: bool interpreter: bool jmprel: bool notes: bool preinit_array: bool rela: bool static_symtab: bool sym_verdef: bool sym_verneed: bool sym_versym: bool symtab: bool def __init__(self) -> None: ... config: lief.ELF.Builder.config_t def __init__(self, elf_binary: lief.ELF.Binary) -> None: ... def build(self) -> None: ... def get_build(self) -> List[int]: ... def write(self, output: str) -> None: ... class CoreAuxv(NoteDetails): class TYPES: __members__: ClassVar[dict] = ... # read-only BASE: ClassVar[CoreAuxv.TYPES] = ... BASE_PLATFORM: ClassVar[CoreAuxv.TYPES] = ... CKLTCK: ClassVar[CoreAuxv.TYPES] = ... DCACHEBSIZE: ClassVar[CoreAuxv.TYPES] = ... EGID: ClassVar[CoreAuxv.TYPES] = ... ENTRY: ClassVar[CoreAuxv.TYPES] = ... EUID: ClassVar[CoreAuxv.TYPES] = ... EXECFD: ClassVar[CoreAuxv.TYPES] = ... EXECFN: ClassVar[CoreAuxv.TYPES] = ... FLAGS: ClassVar[CoreAuxv.TYPES] = ... FPUCW: ClassVar[CoreAuxv.TYPES] = ... GID: ClassVar[CoreAuxv.TYPES] = ... HWCAP: ClassVar[CoreAuxv.TYPES] = ... HWCAP2: ClassVar[CoreAuxv.TYPES] = ... ICACHEBSIZE: ClassVar[CoreAuxv.TYPES] = ... IGNORE: ClassVar[CoreAuxv.TYPES] = ... IGNOREPPC: ClassVar[CoreAuxv.TYPES] = ... L1D_CACHESHAPE: ClassVar[CoreAuxv.TYPES] = ... L1I_CACHESHAPE: ClassVar[CoreAuxv.TYPES] = ... NOTELF: ClassVar[CoreAuxv.TYPES] = ... NULL: ClassVar[CoreAuxv.TYPES] = ... PAGESZ: ClassVar[CoreAuxv.TYPES] = ... PHDR: ClassVar[CoreAuxv.TYPES] = ... PHENT: ClassVar[CoreAuxv.TYPES] = ... PHNUM: ClassVar[CoreAuxv.TYPES] = ... PLATFORM: ClassVar[CoreAuxv.TYPES] = ... RANDOM: ClassVar[CoreAuxv.TYPES] = ... SECURE: ClassVar[CoreAuxv.TYPES] = ... SYSINFO: ClassVar[CoreAuxv.TYPES] = ... SYSINFO_EHDR: ClassVar[CoreAuxv.TYPES] = ... UCACHEBSIZE: ClassVar[CoreAuxv.TYPES] = ... UID: ClassVar[CoreAuxv.TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... values: Dict[lief.ELF.CoreAuxv.TYPES,int] def __init__(self, *args, **kwargs) -> None: ... def get(self, type: lief.ELF.CoreAuxv.TYPES) -> object: ... def has(self, type: lief.ELF.CoreAuxv.TYPES) -> bool: ... def set(self, type: lief.ELF.CoreAuxv.TYPES, value: int) -> bool: ... def __contains__(self, arg0: lief.ELF.CoreAuxv.TYPES) -> bool: ... def __getitem__(self, arg0: lief.ELF.CoreAuxv.TYPES) -> int: ... def __setitem__(self, arg0: lief.ELF.CoreAuxv.TYPES, arg1: int) -> None: ... class CoreFile(NoteDetails): class files_t: @overload def __init__(self) -> None: ... @overload def __init__(self, arg0: lief.ELF.CoreFile.files_t) -> None: ... @overload def __init__(self, arg0: Iterable) -> None: ... def append(self, x: lief.ELF.CoreFileEntry) -> None: ... def clear(self) -> None: ... @overload def extend(self, L: lief.ELF.CoreFile.files_t) -> None: ... @overload def extend(self, L: Iterable) -> None: ... def insert(self, i: int, x: lief.ELF.CoreFileEntry) -> None: ... @overload def pop(self) -> lief.ELF.CoreFileEntry: ... @overload def pop(self, i: int) -> lief.ELF.CoreFileEntry: ... def __bool__(self) -> bool: ... @overload def __delitem__(self, arg0: int) -> None: ... @overload def __delitem__(self, arg0: slice) -> None: ... @overload def __getitem__(self, s: slice) -> lief.ELF.CoreFile.files_t: ... @overload def __getitem__(self, arg0: int) -> lief.ELF.CoreFileEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... @overload def __setitem__(self, arg0: int, arg1: lief.ELF.CoreFileEntry) -> None: ... @overload def __setitem__(self, arg0: slice, arg1: lief.ELF.CoreFile.files_t) -> None: ... files: lief.ELF.CoreFile.files_t def __init__(self, *args, **kwargs) -> None: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... class CoreFileEntry: end: int file_ofs: int path: str start: int def __init__(self, *args, **kwargs) -> None: ... class CorePrPsInfo(NoteDetails): file_name: str flags: int gid: int pgrp: int pid: int ppid: int sid: int uid: int def __init__(self, *args, **kwargs) -> None: ... class CorePrStatus(NoteDetails): class REGISTERS: __members__: ClassVar[dict] = ... # read-only AARCH64_PC: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X0: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X1: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X10: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X11: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X12: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X13: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X14: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X15: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X16: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X17: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X18: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X19: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X2: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X20: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X21: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X22: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X23: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X24: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X25: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X26: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X27: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X28: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X29: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X3: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X30: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X31: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X4: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X5: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X6: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X7: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X8: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64_X9: ClassVar[CorePrStatus.REGISTERS] = ... AARCH64__: ClassVar[CorePrStatus.REGISTERS] = ... ARM_CPSR: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R0: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R1: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R10: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R11: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R12: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R13: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R14: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R15: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R2: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R3: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R4: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R5: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R6: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R7: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R8: ClassVar[CorePrStatus.REGISTERS] = ... ARM_R9: ClassVar[CorePrStatus.REGISTERS] = ... UNKNOWN: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_CS: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_EFLAGS: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R10: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R11: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R12: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R13: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R14: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R15: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R8: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_R9: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RAX: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RBP: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RBX: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RCX: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RDI: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RDX: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RIP: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RSI: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_RSP: ClassVar[CorePrStatus.REGISTERS] = ... X86_64_SS: ClassVar[CorePrStatus.REGISTERS] = ... X86_64__: ClassVar[CorePrStatus.REGISTERS] = ... X86_CS: ClassVar[CorePrStatus.REGISTERS] = ... X86_DS: ClassVar[CorePrStatus.REGISTERS] = ... X86_EAX: ClassVar[CorePrStatus.REGISTERS] = ... X86_EBP: ClassVar[CorePrStatus.REGISTERS] = ... X86_EBX: ClassVar[CorePrStatus.REGISTERS] = ... X86_ECX: ClassVar[CorePrStatus.REGISTERS] = ... X86_EDI: ClassVar[CorePrStatus.REGISTERS] = ... X86_EDX: ClassVar[CorePrStatus.REGISTERS] = ... X86_EFLAGS: ClassVar[CorePrStatus.REGISTERS] = ... X86_EIP: ClassVar[CorePrStatus.REGISTERS] = ... X86_ES: ClassVar[CorePrStatus.REGISTERS] = ... X86_ESI: ClassVar[CorePrStatus.REGISTERS] = ... X86_ESP: ClassVar[CorePrStatus.REGISTERS] = ... X86_FS: ClassVar[CorePrStatus.REGISTERS] = ... X86_GS: ClassVar[CorePrStatus.REGISTERS] = ... X86_SS: ClassVar[CorePrStatus.REGISTERS] = ... X86__: ClassVar[CorePrStatus.REGISTERS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class siginfo_t: errno: int sicode: int signo: int def __init__(self, *args, **kwargs) -> None: ... class timeval: sec: int usec: int def __init__(self, *args, **kwargs) -> None: ... cstime: lief.ELF.CorePrStatus.timeval current_sig: int cutime: lief.ELF.CorePrStatus.timeval pgrp: int pid: int ppid: int register_context: Any sid: int sighold: int siginfo: lief.ELF.CorePrStatus.siginfo_t sigpend: int stime: lief.ELF.CorePrStatus.timeval utime: lief.ELF.CorePrStatus.timeval def __init__(self, *args, **kwargs) -> None: ... def get(self, register: lief.ELF.CorePrStatus.REGISTERS) -> object: ... def has(self, register: lief.ELF.CorePrStatus.REGISTERS) -> bool: ... def set(self, register: lief.ELF.CorePrStatus.REGISTERS, value: int) -> bool: ... def __contains__(self, arg0: lief.ELF.CorePrStatus.REGISTERS) -> bool: ... def __getitem__(self, arg0: lief.ELF.CorePrStatus.REGISTERS) -> int: ... def __setitem__(self, arg0: lief.ELF.CorePrStatus.REGISTERS, arg1: int) -> None: ... class CoreSigInfo(NoteDetails): sigcode: int sigerrno: int signo: int def __init__(self, *args, **kwargs) -> None: ... class DYNAMIC_FLAGS: __members__: ClassVar[dict] = ... # read-only BIND_NOW: ClassVar[DYNAMIC_FLAGS] = ... ORIGIN: ClassVar[DYNAMIC_FLAGS] = ... STATIC_TLS: ClassVar[DYNAMIC_FLAGS] = ... SYMBOLIC: ClassVar[DYNAMIC_FLAGS] = ... TEXTREL: ClassVar[DYNAMIC_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DYNAMIC_FLAGS_1: __members__: ClassVar[dict] = ... # read-only CONFALT: ClassVar[DYNAMIC_FLAGS_1] = ... DIRECT: ClassVar[DYNAMIC_FLAGS_1] = ... DISPRELDNE: ClassVar[DYNAMIC_FLAGS_1] = ... DISPRELPND: ClassVar[DYNAMIC_FLAGS_1] = ... EDITED: ClassVar[DYNAMIC_FLAGS_1] = ... ENDFILTEE: ClassVar[DYNAMIC_FLAGS_1] = ... GLOBAL: ClassVar[DYNAMIC_FLAGS_1] = ... GLOBAUDIT: ClassVar[DYNAMIC_FLAGS_1] = ... GROUP: ClassVar[DYNAMIC_FLAGS_1] = ... IGNMULDEF: ClassVar[DYNAMIC_FLAGS_1] = ... INITFIRST: ClassVar[DYNAMIC_FLAGS_1] = ... INTERPOSE: ClassVar[DYNAMIC_FLAGS_1] = ... LOADFLTR: ClassVar[DYNAMIC_FLAGS_1] = ... NODEFLIB: ClassVar[DYNAMIC_FLAGS_1] = ... NODELETE: ClassVar[DYNAMIC_FLAGS_1] = ... NODIRECT: ClassVar[DYNAMIC_FLAGS_1] = ... NODUMP: ClassVar[DYNAMIC_FLAGS_1] = ... NOHDR: ClassVar[DYNAMIC_FLAGS_1] = ... NOKSYMS: ClassVar[DYNAMIC_FLAGS_1] = ... NOOPEN: ClassVar[DYNAMIC_FLAGS_1] = ... NORELOC: ClassVar[DYNAMIC_FLAGS_1] = ... NOW: ClassVar[DYNAMIC_FLAGS_1] = ... ORIGIN: ClassVar[DYNAMIC_FLAGS_1] = ... PIE: ClassVar[DYNAMIC_FLAGS_1] = ... SINGLETON: ClassVar[DYNAMIC_FLAGS_1] = ... SYMINTPOSE: ClassVar[DYNAMIC_FLAGS_1] = ... TRANS: ClassVar[DYNAMIC_FLAGS_1] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DYNAMIC_TAGS: __members__: ClassVar[dict] = ... # read-only ANDROID_REL: ClassVar[DYNAMIC_TAGS] = ... ANDROID_RELA: ClassVar[DYNAMIC_TAGS] = ... ANDROID_RELASZ: ClassVar[DYNAMIC_TAGS] = ... ANDROID_RELSZ: ClassVar[DYNAMIC_TAGS] = ... ANDROID_REL_OFFSET: ClassVar[DYNAMIC_TAGS] = ... ANDROID_REL_SIZE: ClassVar[DYNAMIC_TAGS] = ... BIND_NOW: ClassVar[DYNAMIC_TAGS] = ... DEBUG: ClassVar[DYNAMIC_TAGS] = ... FINI: ClassVar[DYNAMIC_TAGS] = ... FINI_ARRAY: ClassVar[DYNAMIC_TAGS] = ... FINI_ARRAYSZ: ClassVar[DYNAMIC_TAGS] = ... FLAGS: ClassVar[DYNAMIC_TAGS] = ... FLAGS_1: ClassVar[DYNAMIC_TAGS] = ... GNU_HASH: ClassVar[DYNAMIC_TAGS] = ... HASH: ClassVar[DYNAMIC_TAGS] = ... INIT: ClassVar[DYNAMIC_TAGS] = ... INIT_ARRAY: ClassVar[DYNAMIC_TAGS] = ... INIT_ARRAYSZ: ClassVar[DYNAMIC_TAGS] = ... JMPREL: ClassVar[DYNAMIC_TAGS] = ... MIPS_AUX_DYNAMIC: ClassVar[DYNAMIC_TAGS] = ... MIPS_BASE_ADDRESS: ClassVar[DYNAMIC_TAGS] = ... MIPS_COMPACT_SIZE: ClassVar[DYNAMIC_TAGS] = ... MIPS_CONFLICT: ClassVar[DYNAMIC_TAGS] = ... MIPS_CONFLICTNO: ClassVar[DYNAMIC_TAGS] = ... MIPS_CXX_FLAGS: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_CLASS: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_CLASSSYM: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_CLASSSYM_NO: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_CLASS_NO: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_INSTANCE: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_INSTANCE_NO: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_RELOC: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_RELOC_NO: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_SYM: ClassVar[DYNAMIC_TAGS] = ... MIPS_DELTA_SYM_NO: ClassVar[DYNAMIC_TAGS] = ... MIPS_DYNSTR_ALIGN: ClassVar[DYNAMIC_TAGS] = ... MIPS_FLAGS: ClassVar[DYNAMIC_TAGS] = ... MIPS_GOTSYM: ClassVar[DYNAMIC_TAGS] = ... MIPS_GP_VALUE: ClassVar[DYNAMIC_TAGS] = ... MIPS_HIDDEN_GOTIDX: ClassVar[DYNAMIC_TAGS] = ... MIPS_HIPAGENO: ClassVar[DYNAMIC_TAGS] = ... MIPS_ICHECKSUM: ClassVar[DYNAMIC_TAGS] = ... MIPS_INTERFACE: ClassVar[DYNAMIC_TAGS] = ... MIPS_INTERFACE_SIZE: ClassVar[DYNAMIC_TAGS] = ... MIPS_IVERSION: ClassVar[DYNAMIC_TAGS] = ... MIPS_LIBLIST: ClassVar[DYNAMIC_TAGS] = ... MIPS_LIBLISTNO: ClassVar[DYNAMIC_TAGS] = ... MIPS_LOCALPAGE_GOTIDX: ClassVar[DYNAMIC_TAGS] = ... MIPS_LOCAL_GOTIDX: ClassVar[DYNAMIC_TAGS] = ... MIPS_LOCAL_GOTNO: ClassVar[DYNAMIC_TAGS] = ... MIPS_MSYM: ClassVar[DYNAMIC_TAGS] = ... MIPS_OPTIONS: ClassVar[DYNAMIC_TAGS] = ... MIPS_PERF_SUFFIX: ClassVar[DYNAMIC_TAGS] = ... MIPS_PIXIE_INIT: ClassVar[DYNAMIC_TAGS] = ... MIPS_PLTGOT: ClassVar[DYNAMIC_TAGS] = ... MIPS_PROTECTED_GOTIDX: ClassVar[DYNAMIC_TAGS] = ... MIPS_RLD_MAP: ClassVar[DYNAMIC_TAGS] = ... MIPS_RLD_TEXT_RESOLVE_ADDR: ClassVar[DYNAMIC_TAGS] = ... MIPS_RLD_VERSION: ClassVar[DYNAMIC_TAGS] = ... MIPS_RWPLT: ClassVar[DYNAMIC_TAGS] = ... MIPS_SYMBOL_LIB: ClassVar[DYNAMIC_TAGS] = ... MIPS_SYMTABNO: ClassVar[DYNAMIC_TAGS] = ... MIPS_TIME_STAMP: ClassVar[DYNAMIC_TAGS] = ... MIPS_UNREFEXTNO: ClassVar[DYNAMIC_TAGS] = ... NEEDED: ClassVar[DYNAMIC_TAGS] = ... NULL: ClassVar[DYNAMIC_TAGS] = ... PLTGOT: ClassVar[DYNAMIC_TAGS] = ... PLTREL: ClassVar[DYNAMIC_TAGS] = ... PLTRELSZ: ClassVar[DYNAMIC_TAGS] = ... PREINIT_ARRAY: ClassVar[DYNAMIC_TAGS] = ... PREINIT_ARRAYSZ: ClassVar[DYNAMIC_TAGS] = ... REL: ClassVar[DYNAMIC_TAGS] = ... RELA: ClassVar[DYNAMIC_TAGS] = ... RELACOUNT: ClassVar[DYNAMIC_TAGS] = ... RELAENT: ClassVar[DYNAMIC_TAGS] = ... RELASZ: ClassVar[DYNAMIC_TAGS] = ... RELCOUNT: ClassVar[DYNAMIC_TAGS] = ... RELENT: ClassVar[DYNAMIC_TAGS] = ... RELR: ClassVar[DYNAMIC_TAGS] = ... RELRCOUNT: ClassVar[DYNAMIC_TAGS] = ... RELRENT: ClassVar[DYNAMIC_TAGS] = ... RELRSZ: ClassVar[DYNAMIC_TAGS] = ... RELSZ: ClassVar[DYNAMIC_TAGS] = ... RPATH: ClassVar[DYNAMIC_TAGS] = ... RUNPATH: ClassVar[DYNAMIC_TAGS] = ... SONAME: ClassVar[DYNAMIC_TAGS] = ... STRSZ: ClassVar[DYNAMIC_TAGS] = ... STRTAB: ClassVar[DYNAMIC_TAGS] = ... SYMBOLIC: ClassVar[DYNAMIC_TAGS] = ... SYMENT: ClassVar[DYNAMIC_TAGS] = ... SYMTAB: ClassVar[DYNAMIC_TAGS] = ... TEXTREL: ClassVar[DYNAMIC_TAGS] = ... VERDEF: ClassVar[DYNAMIC_TAGS] = ... VERDEFNUM: ClassVar[DYNAMIC_TAGS] = ... VERNEED: ClassVar[DYNAMIC_TAGS] = ... VERNEEDNUM: ClassVar[DYNAMIC_TAGS] = ... VERSYM: ClassVar[DYNAMIC_TAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DYNSYM_COUNT_METHODS: __members__: ClassVar[dict] = ... # read-only AUTO: ClassVar[DYNSYM_COUNT_METHODS] = ... HASH: ClassVar[DYNSYM_COUNT_METHODS] = ... RELOCATIONS: ClassVar[DYNSYM_COUNT_METHODS] = ... SECTION: ClassVar[DYNSYM_COUNT_METHODS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DynamicEntry(lief.Object): tag: lief.ELF.DYNAMIC_TAGS value: int @overload def __init__(self) -> None: ... @overload def __init__(self, tag: lief.ELF.DYNAMIC_TAGS, value: int) -> None: ... class DynamicEntryArray(DynamicEntry): array: List[int] @overload def __init__(self) -> None: ... @overload def __init__(self, tag: lief.ELF.DYNAMIC_TAGS, value: int) -> None: ... def append(self, function: int) -> lief.ELF.DynamicEntryArray: ... def insert(self, pos: int, function: int) -> lief.ELF.DynamicEntryArray: ... def remove(self, function: int) -> lief.ELF.DynamicEntryArray: ... def __getitem__(self, arg0: int) -> int: ... def __iadd__(self, arg0: int) -> lief.ELF.DynamicEntryArray: ... def __isub__(self, arg0: int) -> lief.ELF.DynamicEntryArray: ... def __len__(self) -> int: ... class DynamicEntryFlags(DynamicEntry): @overload def __init__(self) -> None: ... @overload def __init__(self, tag: lief.ELF.DYNAMIC_TAGS, value: int) -> None: ... @overload def add(self, flag: lief.ELF.DYNAMIC_FLAGS) -> None: ... @overload def add(self, flag: lief.ELF.DYNAMIC_FLAGS_1) -> None: ... @overload def has(self, flag: lief.ELF.DYNAMIC_FLAGS) -> bool: ... @overload def has(self, flag: lief.ELF.DYNAMIC_FLAGS_1) -> bool: ... @overload def remove(self, flag: lief.ELF.DYNAMIC_FLAGS) -> None: ... @overload def remove(self, flag: lief.ELF.DYNAMIC_FLAGS_1) -> None: ... @overload def __contains__(self, arg0: lief.ELF.DYNAMIC_FLAGS) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.DYNAMIC_FLAGS_1) -> bool: ... @overload def __iadd__(self, arg0: lief.ELF.DYNAMIC_FLAGS) -> lief.ELF.DynamicEntryFlags: ... @overload def __iadd__(self, arg0: lief.ELF.DYNAMIC_FLAGS_1) -> lief.ELF.DynamicEntryFlags: ... @overload def __isub__(self, arg0: lief.ELF.DYNAMIC_FLAGS) -> lief.ELF.DynamicEntryFlags: ... @overload def __isub__(self, arg0: lief.ELF.DYNAMIC_FLAGS_1) -> lief.ELF.DynamicEntryFlags: ... @property def flags(self) -> Set[int]: ... class DynamicEntryLibrary(DynamicEntry): name: object def __init__(self, library_name: str) -> None: ... class DynamicEntryRpath(DynamicEntry): name: object paths: List[str] rpath: object @overload def __init__(self, path: str = ...) -> None: ... @overload def __init__(self, paths: List[str]) -> None: ... def append(self, path: str) -> lief.ELF.DynamicEntryRpath: ... def insert(self, position: int, path: str) -> lief.ELF.DynamicEntryRpath: ... def remove(self, path: str) -> lief.ELF.DynamicEntryRpath: ... def __iadd__(self, arg0: str) -> lief.ELF.DynamicEntryRpath: ... def __isub__(self, arg0: str) -> lief.ELF.DynamicEntryRpath: ... class DynamicEntryRunPath(DynamicEntry): name: object paths: List[str] runpath: object @overload def __init__(self, path: str = ...) -> None: ... @overload def __init__(self, paths: List[str]) -> None: ... def append(self, path: str) -> lief.ELF.DynamicEntryRunPath: ... def insert(self, position: int, path: str) -> lief.ELF.DynamicEntryRunPath: ... def remove(self, path: str) -> lief.ELF.DynamicEntryRunPath: ... def __iadd__(self, arg0: str) -> lief.ELF.DynamicEntryRunPath: ... def __isub__(self, arg0: str) -> lief.ELF.DynamicEntryRunPath: ... class DynamicSharedObject(DynamicEntry): name: object def __init__(self, library_name: str) -> None: ... class ELF_CLASS: __members__: ClassVar[dict] = ... # read-only CLASS32: ClassVar[ELF_CLASS] = ... CLASS64: ClassVar[ELF_CLASS] = ... NONE: ClassVar[ELF_CLASS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ELF_DATA: __members__: ClassVar[dict] = ... # read-only LSB: ClassVar[ELF_DATA] = ... MSB: ClassVar[ELF_DATA] = ... NONE: ClassVar[ELF_DATA] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class E_TYPE: __members__: ClassVar[dict] = ... # read-only CORE: ClassVar[E_TYPE] = ... DYNAMIC: ClassVar[E_TYPE] = ... EXECUTABLE: ClassVar[E_TYPE] = ... HIPROC: ClassVar[E_TYPE] = ... LOPROC: ClassVar[E_TYPE] = ... NONE: ClassVar[E_TYPE] = ... RELOCATABLE: ClassVar[E_TYPE] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class GnuHash(lief.Object): def __init__(self) -> None: ... @overload def check(self, symbol_name: str) -> bool: ... @overload def check(self, hash_value: int) -> bool: ... def check_bloom_filter(self, hash: int) -> bool: ... def check_bucket(self, hash: int) -> bool: ... @property def bloom_filters(self) -> List[int]: ... @property def buckets(self) -> List[int]: ... @property def hash_values(self) -> List[int]: ... @property def nb_buckets(self) -> int: ... @property def shift2(self) -> int: ... @property def symbol_index(self) -> int: ... class HEXAGON_EFLAGS: __members__: ClassVar[dict] = ... # read-only ISA_MACH: ClassVar[HEXAGON_EFLAGS] = ... ISA_V2: ClassVar[HEXAGON_EFLAGS] = ... ISA_V3: ClassVar[HEXAGON_EFLAGS] = ... ISA_V4: ClassVar[HEXAGON_EFLAGS] = ... ISA_V5: ClassVar[HEXAGON_EFLAGS] = ... MACH_V2: ClassVar[HEXAGON_EFLAGS] = ... MACH_V3: ClassVar[HEXAGON_EFLAGS] = ... MACH_V4: ClassVar[HEXAGON_EFLAGS] = ... MACH_V5: ClassVar[HEXAGON_EFLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Header(lief.Object): entrypoint: int file_type: lief.ELF.E_TYPE header_size: int identity: List[int] identity_abi_version: int identity_class: lief.ELF.ELF_CLASS identity_data: lief.ELF.ELF_DATA identity_os_abi: lief.ELF.OS_ABI identity_version: lief.ELF.VERSION machine_type: lief.ELF.ARCH numberof_sections: int numberof_segments: int object_file_version: lief.ELF.VERSION processor_flag: int program_header_offset: int program_header_size: int section_header_offset: int section_header_size: int section_name_table_idx: int def __init__(self) -> None: ... @overload def __contains__(self, arg0: lief.ELF.ARM_EFLAGS) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.MIPS_EFLAGS) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.PPC64_EFLAGS) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.HEXAGON_EFLAGS) -> bool: ... @property def arm_flags_list(self) -> Set[lief.ELF.ARM_EFLAGS]: ... @property def hexagon_flags_list(self) -> Set[lief.ELF.HEXAGON_EFLAGS]: ... @property def mips_flags_list(self) -> Set[lief.ELF.MIPS_EFLAGS]: ... @property def ppc64_flags_list(self) -> Set[lief.ELF.PPC64_EFLAGS]: ... class IDENTITY: __members__: ClassVar[dict] = ... # read-only ABIVERSION: ClassVar[IDENTITY] = ... CLASS: ClassVar[IDENTITY] = ... DATA: ClassVar[IDENTITY] = ... MAG0: ClassVar[IDENTITY] = ... MAG1: ClassVar[IDENTITY] = ... MAG2: ClassVar[IDENTITY] = ... MAG3: ClassVar[IDENTITY] = ... NIDENT: ClassVar[IDENTITY] = ... OSABI: ClassVar[IDENTITY] = ... PAD: ClassVar[IDENTITY] = ... VERSION: ClassVar[IDENTITY] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class MIPS_EFLAGS: __members__: ClassVar[dict] = ... # read-only ABI2: ClassVar[MIPS_EFLAGS] = ... ABI_EABI32: ClassVar[MIPS_EFLAGS] = ... ABI_EABI64: ClassVar[MIPS_EFLAGS] = ... ABI_O32: ClassVar[MIPS_EFLAGS] = ... ABI_O64: ClassVar[MIPS_EFLAGS] = ... ARCH_1: ClassVar[MIPS_EFLAGS] = ... ARCH_2: ClassVar[MIPS_EFLAGS] = ... ARCH_3: ClassVar[MIPS_EFLAGS] = ... ARCH_32: ClassVar[MIPS_EFLAGS] = ... ARCH_32R2: ClassVar[MIPS_EFLAGS] = ... ARCH_32R6: ClassVar[MIPS_EFLAGS] = ... ARCH_4: ClassVar[MIPS_EFLAGS] = ... ARCH_5: ClassVar[MIPS_EFLAGS] = ... ARCH_64: ClassVar[MIPS_EFLAGS] = ... ARCH_64R2: ClassVar[MIPS_EFLAGS] = ... ARCH_64R6: ClassVar[MIPS_EFLAGS] = ... ARCH_ASE_M16: ClassVar[MIPS_EFLAGS] = ... ARCH_ASE_MDMX: ClassVar[MIPS_EFLAGS] = ... CPIC: ClassVar[MIPS_EFLAGS] = ... FP64: ClassVar[MIPS_EFLAGS] = ... MACH_3900: ClassVar[MIPS_EFLAGS] = ... MACH_4010: ClassVar[MIPS_EFLAGS] = ... MACH_4100: ClassVar[MIPS_EFLAGS] = ... MACH_4111: ClassVar[MIPS_EFLAGS] = ... MACH_4120: ClassVar[MIPS_EFLAGS] = ... MACH_4650: ClassVar[MIPS_EFLAGS] = ... MACH_5400: ClassVar[MIPS_EFLAGS] = ... MACH_5500: ClassVar[MIPS_EFLAGS] = ... MACH_5900: ClassVar[MIPS_EFLAGS] = ... MACH_9000: ClassVar[MIPS_EFLAGS] = ... MACH_LS2E: ClassVar[MIPS_EFLAGS] = ... MACH_LS2F: ClassVar[MIPS_EFLAGS] = ... MACH_LS3A: ClassVar[MIPS_EFLAGS] = ... MACH_OCTEON: ClassVar[MIPS_EFLAGS] = ... MACH_OCTEON2: ClassVar[MIPS_EFLAGS] = ... MACH_OCTEON3: ClassVar[MIPS_EFLAGS] = ... MACH_SB1: ClassVar[MIPS_EFLAGS] = ... MACH_XLR: ClassVar[MIPS_EFLAGS] = ... MICROMIPS: ClassVar[MIPS_EFLAGS] = ... NAN2008: ClassVar[MIPS_EFLAGS] = ... NOREORDER: ClassVar[MIPS_EFLAGS] = ... PIC: ClassVar[MIPS_EFLAGS] = ... _32BITMODE: ClassVar[MIPS_EFLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class NOTE_ABIS: __members__: ClassVar[dict] = ... # read-only FREEBSD: ClassVar[NOTE_ABIS] = ... GNU: ClassVar[NOTE_ABIS] = ... LINUX: ClassVar[NOTE_ABIS] = ... NETBSD: ClassVar[NOTE_ABIS] = ... SOLARIS2: ClassVar[NOTE_ABIS] = ... SYLLABLE: ClassVar[NOTE_ABIS] = ... UNKNOWN: ClassVar[NOTE_ABIS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class NOTE_TYPES: __members__: ClassVar[dict] = ... # read-only ABI_TAG: ClassVar[NOTE_TYPES] = ... BUILD_ID: ClassVar[NOTE_TYPES] = ... CRASHPAD: ClassVar[NOTE_TYPES] = ... GNU_BUILD_ATTRIBUTE_FUNC: ClassVar[NOTE_TYPES] = ... GNU_BUILD_ATTRIBUTE_OPEN: ClassVar[NOTE_TYPES] = ... GOLD_VERSION: ClassVar[NOTE_TYPES] = ... HWCAP: ClassVar[NOTE_TYPES] = ... PROPERTY_TYPE_0: ClassVar[NOTE_TYPES] = ... UNKNOWN: ClassVar[NOTE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class NOTE_TYPES_CORE: __members__: ClassVar[dict] = ... # read-only ARM_HW_BREAK: ClassVar[NOTE_TYPES_CORE] = ... ARM_HW_WATCH: ClassVar[NOTE_TYPES_CORE] = ... ARM_SVE: ClassVar[NOTE_TYPES_CORE] = ... ARM_SYSTEM_CALL: ClassVar[NOTE_TYPES_CORE] = ... ARM_TLS: ClassVar[NOTE_TYPES_CORE] = ... ARM_VFP: ClassVar[NOTE_TYPES_CORE] = ... AUXV: ClassVar[NOTE_TYPES_CORE] = ... FILE: ClassVar[NOTE_TYPES_CORE] = ... I386_IOPERM: ClassVar[NOTE_TYPES_CORE] = ... I386_TLS: ClassVar[NOTE_TYPES_CORE] = ... I386_XSTATE: ClassVar[NOTE_TYPES_CORE] = ... PRFPREG: ClassVar[NOTE_TYPES_CORE] = ... PRPSINFO: ClassVar[NOTE_TYPES_CORE] = ... PRSTATUS: ClassVar[NOTE_TYPES_CORE] = ... SIGINFO: ClassVar[NOTE_TYPES_CORE] = ... TASKSTRUCT: ClassVar[NOTE_TYPES_CORE] = ... UNKNOWN: ClassVar[NOTE_TYPES_CORE] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Note(lief.Object): description: List[int] name: str type: lief.ELF.NOTE_TYPES type_core: lief.ELF.NOTE_TYPES_CORE @overload def __init__(self) -> None: ... @overload def __init__(self, name: str, type: lief.ELF.NOTE_TYPES, description: List[int]) -> None: ... @property def details(self) -> lief.ELF.NoteDetails: ... @property def is_android(self) -> bool: ... @property def is_core(self) -> bool: ... @property def size(self) -> int: ... class NoteAbi(NoteDetails): def __init__(self, *args, **kwargs) -> None: ... @property def abi(self) -> lief.ELF.NOTE_ABIS: ... @property def version(self) -> List[int]: ... class NoteDetails(lief.Object): def __init__(self) -> None: ... class OS_ABI: __members__: ClassVar[dict] = ... # read-only AIX: ClassVar[OS_ABI] = ... AMDGPU_HSA: ClassVar[OS_ABI] = ... ARM: ClassVar[OS_ABI] = ... AROS: ClassVar[OS_ABI] = ... C6000_ELFABI: ClassVar[OS_ABI] = ... C6000_LINUX: ClassVar[OS_ABI] = ... CLOUDABI: ClassVar[OS_ABI] = ... FENIXOS: ClassVar[OS_ABI] = ... FREEBSD: ClassVar[OS_ABI] = ... GNU: ClassVar[OS_ABI] = ... HPUX: ClassVar[OS_ABI] = ... HURD: ClassVar[OS_ABI] = ... IRIX: ClassVar[OS_ABI] = ... LINUX: ClassVar[OS_ABI] = ... MODESTO: ClassVar[OS_ABI] = ... NETBSD: ClassVar[OS_ABI] = ... NSK: ClassVar[OS_ABI] = ... OPENBSD: ClassVar[OS_ABI] = ... OPENVMS: ClassVar[OS_ABI] = ... SOLARIS: ClassVar[OS_ABI] = ... STANDALONE: ClassVar[OS_ABI] = ... SYSTEMV: ClassVar[OS_ABI] = ... TRU64: ClassVar[OS_ABI] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class PPC64_EFLAGS: __members__: ClassVar[dict] = ... # read-only ABI: ClassVar[PPC64_EFLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_AARCH64: __members__: ClassVar[dict] = ... # read-only ABS16: ClassVar[RELOCATION_AARCH64] = ... ABS32: ClassVar[RELOCATION_AARCH64] = ... ABS64: ClassVar[RELOCATION_AARCH64] = ... ADD_ABS_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... ADR_GOT_PAGE: ClassVar[RELOCATION_AARCH64] = ... ADR_PREL_LO21: ClassVar[RELOCATION_AARCH64] = ... ADR_PREL_PG_HI21: ClassVar[RELOCATION_AARCH64] = ... ADR_PREL_PG_HI21_NC: ClassVar[RELOCATION_AARCH64] = ... CALL26: ClassVar[RELOCATION_AARCH64] = ... CONDBR19: ClassVar[RELOCATION_AARCH64] = ... COPY: ClassVar[RELOCATION_AARCH64] = ... GLOB_DAT: ClassVar[RELOCATION_AARCH64] = ... GOTREL32: ClassVar[RELOCATION_AARCH64] = ... GOTREL64: ClassVar[RELOCATION_AARCH64] = ... GOT_LD_PREL19: ClassVar[RELOCATION_AARCH64] = ... IRELATIVE: ClassVar[RELOCATION_AARCH64] = ... JUMP26: ClassVar[RELOCATION_AARCH64] = ... JUMP_SLOT: ClassVar[RELOCATION_AARCH64] = ... LD64_GOTOFF_LO15: ClassVar[RELOCATION_AARCH64] = ... LD64_GOTPAGE_LO15: ClassVar[RELOCATION_AARCH64] = ... LD64_GOT_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... LDST128_ABS_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... LDST16_ABS_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... LDST32_ABS_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... LDST64_ABS_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... LDST8_ABS_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... LD_PREL_LO19: ClassVar[RELOCATION_AARCH64] = ... MOVW_GOTOFF_G0: ClassVar[RELOCATION_AARCH64] = ... MOVW_GOTOFF_G0_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_GOTOFF_G1: ClassVar[RELOCATION_AARCH64] = ... MOVW_GOTOFF_G1_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_GOTOFF_G2: ClassVar[RELOCATION_AARCH64] = ... MOVW_GOTOFF_G2_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_GOTOFF_G3: ClassVar[RELOCATION_AARCH64] = ... MOVW_PREL_G0: ClassVar[RELOCATION_AARCH64] = ... MOVW_PREL_G0_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_PREL_G1: ClassVar[RELOCATION_AARCH64] = ... MOVW_PREL_G1_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_PREL_G2: ClassVar[RELOCATION_AARCH64] = ... MOVW_PREL_G2_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_PREL_G3: ClassVar[RELOCATION_AARCH64] = ... MOVW_SABS_G0: ClassVar[RELOCATION_AARCH64] = ... MOVW_SABS_G1: ClassVar[RELOCATION_AARCH64] = ... MOVW_SABS_G2: ClassVar[RELOCATION_AARCH64] = ... MOVW_UABS_G0: ClassVar[RELOCATION_AARCH64] = ... MOVW_UABS_G0_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_UABS_G1: ClassVar[RELOCATION_AARCH64] = ... MOVW_UABS_G1_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_UABS_G2: ClassVar[RELOCATION_AARCH64] = ... MOVW_UABS_G2_NC: ClassVar[RELOCATION_AARCH64] = ... MOVW_UABS_G3: ClassVar[RELOCATION_AARCH64] = ... NONE: ClassVar[RELOCATION_AARCH64] = ... PREL16: ClassVar[RELOCATION_AARCH64] = ... PREL32: ClassVar[RELOCATION_AARCH64] = ... PREL64: ClassVar[RELOCATION_AARCH64] = ... RELATIVE: ClassVar[RELOCATION_AARCH64] = ... TLSDESC: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_ADD: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_ADD_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_ADR_PAGE21: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_ADR_PREL21: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_CALL: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_LD64_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_LDR: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_LD_PREL19: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_OFF_G0_NC: ClassVar[RELOCATION_AARCH64] = ... TLSDESC_OFF_G1: ClassVar[RELOCATION_AARCH64] = ... TLSGD_ADD_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSGD_ADR_PAGE21: ClassVar[RELOCATION_AARCH64] = ... TLSGD_ADR_PREL21: ClassVar[RELOCATION_AARCH64] = ... TLSGD_MOVW_G0_NC: ClassVar[RELOCATION_AARCH64] = ... TLSGD_MOVW_G1: ClassVar[RELOCATION_AARCH64] = ... TLSIE_ADR_GOTTPREL_PAGE21: ClassVar[RELOCATION_AARCH64] = ... TLSIE_LD64_GOTTPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSIE_LD_GOTTPREL_PREL19: ClassVar[RELOCATION_AARCH64] = ... TLSIE_MOVW_GOTTPREL_G0_NC: ClassVar[RELOCATION_AARCH64] = ... TLSIE_MOVW_GOTTPREL_G1: ClassVar[RELOCATION_AARCH64] = ... TLSLD_ADD_DTPREL_HI12: ClassVar[RELOCATION_AARCH64] = ... TLSLD_ADD_DTPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLD_ADD_DTPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_ADD_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_ADR_PAGE21: ClassVar[RELOCATION_AARCH64] = ... TLSLD_ADR_PREL21: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST128_DTPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST128_DTPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST16_DTPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST16_DTPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST32_DTPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST32_DTPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST64_DTPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST64_DTPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST8_DTPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LDST8_DTPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_LD_PREL19: ClassVar[RELOCATION_AARCH64] = ... TLSLD_MOVW_DTPREL_G0: ClassVar[RELOCATION_AARCH64] = ... TLSLD_MOVW_DTPREL_G0_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_MOVW_DTPREL_G1: ClassVar[RELOCATION_AARCH64] = ... TLSLD_MOVW_DTPREL_G1_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_MOVW_DTPREL_G2: ClassVar[RELOCATION_AARCH64] = ... TLSLD_MOVW_G0_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLD_MOVW_G1: ClassVar[RELOCATION_AARCH64] = ... TLSLE_ADD_TPREL_HI12: ClassVar[RELOCATION_AARCH64] = ... TLSLE_ADD_TPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLE_ADD_TPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST128_TPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST128_TPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST16_TPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST16_TPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST32_TPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST32_TPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST64_TPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST64_TPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST8_TPREL_LO12: ClassVar[RELOCATION_AARCH64] = ... TLSLE_LDST8_TPREL_LO12_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_MOVW_TPREL_G0: ClassVar[RELOCATION_AARCH64] = ... TLSLE_MOVW_TPREL_G0_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_MOVW_TPREL_G1: ClassVar[RELOCATION_AARCH64] = ... TLSLE_MOVW_TPREL_G1_NC: ClassVar[RELOCATION_AARCH64] = ... TLSLE_MOVW_TPREL_G2: ClassVar[RELOCATION_AARCH64] = ... TLS_DTPMOD64: ClassVar[RELOCATION_AARCH64] = ... TLS_DTPREL64: ClassVar[RELOCATION_AARCH64] = ... TLS_TPREL64: ClassVar[RELOCATION_AARCH64] = ... TSTBR14: ClassVar[RELOCATION_AARCH64] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_ARM: __members__: ClassVar[dict] = ... # read-only ABS12: ClassVar[RELOCATION_ARM] = ... ABS16: ClassVar[RELOCATION_ARM] = ... ABS32: ClassVar[RELOCATION_ARM] = ... ABS32_NOI: ClassVar[RELOCATION_ARM] = ... ABS8: ClassVar[RELOCATION_ARM] = ... ALU_PCREL_15_8: ClassVar[RELOCATION_ARM] = ... ALU_PCREL_23_15: ClassVar[RELOCATION_ARM] = ... ALU_PCREL_7_0: ClassVar[RELOCATION_ARM] = ... ALU_PC_G0: ClassVar[RELOCATION_ARM] = ... ALU_PC_G0_NC: ClassVar[RELOCATION_ARM] = ... ALU_PC_G1: ClassVar[RELOCATION_ARM] = ... ALU_PC_G1_NC: ClassVar[RELOCATION_ARM] = ... ALU_PC_G2: ClassVar[RELOCATION_ARM] = ... ALU_SBREL_19_12_NC: ClassVar[RELOCATION_ARM] = ... ALU_SBREL_27_20_CK: ClassVar[RELOCATION_ARM] = ... ALU_SB_G0: ClassVar[RELOCATION_ARM] = ... ALU_SB_G0_NC: ClassVar[RELOCATION_ARM] = ... ALU_SB_G1: ClassVar[RELOCATION_ARM] = ... ALU_SB_G1_NC: ClassVar[RELOCATION_ARM] = ... ALU_SB_G2: ClassVar[RELOCATION_ARM] = ... BASE_ABS: ClassVar[RELOCATION_ARM] = ... BASE_PREL: ClassVar[RELOCATION_ARM] = ... BREL_ADJ: ClassVar[RELOCATION_ARM] = ... CALL: ClassVar[RELOCATION_ARM] = ... COPY: ClassVar[RELOCATION_ARM] = ... GLOB_DAT: ClassVar[RELOCATION_ARM] = ... GNU_VTENTRY: ClassVar[RELOCATION_ARM] = ... GNU_VTINHERIT: ClassVar[RELOCATION_ARM] = ... GOTOFF12: ClassVar[RELOCATION_ARM] = ... GOTOFF32: ClassVar[RELOCATION_ARM] = ... GOTRELAX: ClassVar[RELOCATION_ARM] = ... GOT_ABS: ClassVar[RELOCATION_ARM] = ... GOT_BREL: ClassVar[RELOCATION_ARM] = ... GOT_BREL12: ClassVar[RELOCATION_ARM] = ... GOT_PREL: ClassVar[RELOCATION_ARM] = ... IRELATIVE: ClassVar[RELOCATION_ARM] = ... JUMP24: ClassVar[RELOCATION_ARM] = ... JUMP_SLOT: ClassVar[RELOCATION_ARM] = ... LDC_PC_G0: ClassVar[RELOCATION_ARM] = ... LDC_PC_G1: ClassVar[RELOCATION_ARM] = ... LDC_PC_G2: ClassVar[RELOCATION_ARM] = ... LDC_SB_G0: ClassVar[RELOCATION_ARM] = ... LDC_SB_G1: ClassVar[RELOCATION_ARM] = ... LDC_SB_G2: ClassVar[RELOCATION_ARM] = ... LDRS_PC_G0: ClassVar[RELOCATION_ARM] = ... LDRS_PC_G1: ClassVar[RELOCATION_ARM] = ... LDRS_PC_G2: ClassVar[RELOCATION_ARM] = ... LDRS_SB_G0: ClassVar[RELOCATION_ARM] = ... LDRS_SB_G1: ClassVar[RELOCATION_ARM] = ... LDRS_SB_G2: ClassVar[RELOCATION_ARM] = ... LDR_PC_G0: ClassVar[RELOCATION_ARM] = ... LDR_PC_G1: ClassVar[RELOCATION_ARM] = ... LDR_PC_G2: ClassVar[RELOCATION_ARM] = ... LDR_SBREL_11_0_NC: ClassVar[RELOCATION_ARM] = ... LDR_SB_G0: ClassVar[RELOCATION_ARM] = ... LDR_SB_G1: ClassVar[RELOCATION_ARM] = ... LDR_SB_G2: ClassVar[RELOCATION_ARM] = ... ME_TOO: ClassVar[RELOCATION_ARM] = ... MOVT_ABS: ClassVar[RELOCATION_ARM] = ... MOVT_BREL: ClassVar[RELOCATION_ARM] = ... MOVT_PREL: ClassVar[RELOCATION_ARM] = ... MOVW_ABS_NC: ClassVar[RELOCATION_ARM] = ... MOVW_BREL: ClassVar[RELOCATION_ARM] = ... MOVW_BREL_NC: ClassVar[RELOCATION_ARM] = ... MOVW_PREL_NC: ClassVar[RELOCATION_ARM] = ... NONE: ClassVar[RELOCATION_ARM] = ... PC24: ClassVar[RELOCATION_ARM] = ... PLT32: ClassVar[RELOCATION_ARM] = ... PLT32_ABS: ClassVar[RELOCATION_ARM] = ... PREL31: ClassVar[RELOCATION_ARM] = ... PRIVATE_0: ClassVar[RELOCATION_ARM] = ... PRIVATE_1: ClassVar[RELOCATION_ARM] = ... PRIVATE_10: ClassVar[RELOCATION_ARM] = ... PRIVATE_11: ClassVar[RELOCATION_ARM] = ... PRIVATE_12: ClassVar[RELOCATION_ARM] = ... PRIVATE_13: ClassVar[RELOCATION_ARM] = ... PRIVATE_14: ClassVar[RELOCATION_ARM] = ... PRIVATE_15: ClassVar[RELOCATION_ARM] = ... PRIVATE_2: ClassVar[RELOCATION_ARM] = ... PRIVATE_3: ClassVar[RELOCATION_ARM] = ... PRIVATE_4: ClassVar[RELOCATION_ARM] = ... PRIVATE_5: ClassVar[RELOCATION_ARM] = ... PRIVATE_6: ClassVar[RELOCATION_ARM] = ... PRIVATE_7: ClassVar[RELOCATION_ARM] = ... PRIVATE_8: ClassVar[RELOCATION_ARM] = ... PRIVATE_9: ClassVar[RELOCATION_ARM] = ... RBASE: ClassVar[RELOCATION_ARM] = ... REL32: ClassVar[RELOCATION_ARM] = ... REL32_NOI: ClassVar[RELOCATION_ARM] = ... RELATIVE: ClassVar[RELOCATION_ARM] = ... RPC24: ClassVar[RELOCATION_ARM] = ... RREL32: ClassVar[RELOCATION_ARM] = ... RSBREL32: ClassVar[RELOCATION_ARM] = ... RXPC25: ClassVar[RELOCATION_ARM] = ... SBREL31: ClassVar[RELOCATION_ARM] = ... SBREL32: ClassVar[RELOCATION_ARM] = ... TARGET1: ClassVar[RELOCATION_ARM] = ... TARGET2: ClassVar[RELOCATION_ARM] = ... THM_ABS5: ClassVar[RELOCATION_ARM] = ... THM_ALU_PREL_11_0: ClassVar[RELOCATION_ARM] = ... THM_CALL: ClassVar[RELOCATION_ARM] = ... THM_JUMP11: ClassVar[RELOCATION_ARM] = ... THM_JUMP19: ClassVar[RELOCATION_ARM] = ... THM_JUMP24: ClassVar[RELOCATION_ARM] = ... THM_JUMP6: ClassVar[RELOCATION_ARM] = ... THM_JUMP8: ClassVar[RELOCATION_ARM] = ... THM_MOVT_ABS: ClassVar[RELOCATION_ARM] = ... THM_MOVT_BREL: ClassVar[RELOCATION_ARM] = ... THM_MOVT_PREL: ClassVar[RELOCATION_ARM] = ... THM_MOVW_ABS_NC: ClassVar[RELOCATION_ARM] = ... THM_MOVW_BREL: ClassVar[RELOCATION_ARM] = ... THM_MOVW_BREL_NC: ClassVar[RELOCATION_ARM] = ... THM_MOVW_PREL_NC: ClassVar[RELOCATION_ARM] = ... THM_PC12: ClassVar[RELOCATION_ARM] = ... THM_PC8: ClassVar[RELOCATION_ARM] = ... THM_RPC22: ClassVar[RELOCATION_ARM] = ... THM_SWI8: ClassVar[RELOCATION_ARM] = ... THM_TLS_CALL: ClassVar[RELOCATION_ARM] = ... THM_TLS_DESCSEQ16: ClassVar[RELOCATION_ARM] = ... THM_TLS_DESCSEQ32: ClassVar[RELOCATION_ARM] = ... THM_XPC22: ClassVar[RELOCATION_ARM] = ... TLS_CALL: ClassVar[RELOCATION_ARM] = ... TLS_DESC: ClassVar[RELOCATION_ARM] = ... TLS_DESCSEQ: ClassVar[RELOCATION_ARM] = ... TLS_DTPMOD32: ClassVar[RELOCATION_ARM] = ... TLS_DTPOFF32: ClassVar[RELOCATION_ARM] = ... TLS_GD32: ClassVar[RELOCATION_ARM] = ... TLS_GOTDESC: ClassVar[RELOCATION_ARM] = ... TLS_IE12GP: ClassVar[RELOCATION_ARM] = ... TLS_IE32: ClassVar[RELOCATION_ARM] = ... TLS_LDM32: ClassVar[RELOCATION_ARM] = ... TLS_LDO12: ClassVar[RELOCATION_ARM] = ... TLS_LDO32: ClassVar[RELOCATION_ARM] = ... TLS_LE12: ClassVar[RELOCATION_ARM] = ... TLS_LE32: ClassVar[RELOCATION_ARM] = ... TLS_TPOFF32: ClassVar[RELOCATION_ARM] = ... V4BX: ClassVar[RELOCATION_ARM] = ... XPC25: ClassVar[RELOCATION_ARM] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_MIPS: __members__: ClassVar[dict] = ... # read-only MIPS16_16: ClassVar[RELOCATION_MIPS] = ... MIPS16_26: ClassVar[RELOCATION_MIPS] = ... MIPS16_CALL16: ClassVar[RELOCATION_MIPS] = ... MIPS16_GOT16: ClassVar[RELOCATION_MIPS] = ... MIPS16_GPREL: ClassVar[RELOCATION_MIPS] = ... MIPS16_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS16_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS16_TLS_DTPREL_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS16_TLS_DTPREL_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS16_TLS_GD: ClassVar[RELOCATION_MIPS] = ... MIPS16_TLS_GOTTPREL: ClassVar[RELOCATION_MIPS] = ... MIPS16_TLS_LDM: ClassVar[RELOCATION_MIPS] = ... MIPS16_TLS_TPREL_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS16_TLS_TPREL_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS_26: ClassVar[RELOCATION_MIPS] = ... MIPS_32: ClassVar[RELOCATION_MIPS] = ... MIPS_64: ClassVar[RELOCATION_MIPS] = ... MIPS_ADD_IMMEDIATE: ClassVar[RELOCATION_MIPS] = ... MIPS_CALL16: ClassVar[RELOCATION_MIPS] = ... MIPS_CALL_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS_CALL_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS_COPY: ClassVar[RELOCATION_MIPS] = ... MIPS_DELETE: ClassVar[RELOCATION_MIPS] = ... MIPS_GLOB_DAT: ClassVar[RELOCATION_MIPS] = ... MIPS_GOT16: ClassVar[RELOCATION_MIPS] = ... MIPS_GOT_DISP: ClassVar[RELOCATION_MIPS] = ... MIPS_GOT_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS_GOT_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS_GOT_OFST: ClassVar[RELOCATION_MIPS] = ... MIPS_GOT_PAGE: ClassVar[RELOCATION_MIPS] = ... MIPS_GPREL16: ClassVar[RELOCATION_MIPS] = ... MIPS_GPREL32: ClassVar[RELOCATION_MIPS] = ... MIPS_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS_HIGHER: ClassVar[RELOCATION_MIPS] = ... MIPS_HIGHEST: ClassVar[RELOCATION_MIPS] = ... MIPS_INSERT_A: ClassVar[RELOCATION_MIPS] = ... MIPS_INSERT_B: ClassVar[RELOCATION_MIPS] = ... MIPS_JALR: ClassVar[RELOCATION_MIPS] = ... MIPS_JUMP_SLOT: ClassVar[RELOCATION_MIPS] = ... MIPS_LITERAL: ClassVar[RELOCATION_MIPS] = ... MIPS_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS_NONE: ClassVar[RELOCATION_MIPS] = ... MIPS_PC16: ClassVar[RELOCATION_MIPS] = ... MIPS_PC18_S3: ClassVar[RELOCATION_MIPS] = ... MIPS_PC19_S2: ClassVar[RELOCATION_MIPS] = ... MIPS_PC21_S2: ClassVar[RELOCATION_MIPS] = ... MIPS_PC26_S2: ClassVar[RELOCATION_MIPS] = ... MIPS_PCHI16: ClassVar[RELOCATION_MIPS] = ... MIPS_PCLO16: ClassVar[RELOCATION_MIPS] = ... MIPS_PJUMP: ClassVar[RELOCATION_MIPS] = ... MIPS_REL16: ClassVar[RELOCATION_MIPS] = ... MIPS_REL32: ClassVar[RELOCATION_MIPS] = ... MIPS_RELGOT: ClassVar[RELOCATION_MIPS] = ... MIPS_SCN_DISP: ClassVar[RELOCATION_MIPS] = ... MIPS_SHIFT5: ClassVar[RELOCATION_MIPS] = ... MIPS_SHIFT6: ClassVar[RELOCATION_MIPS] = ... MIPS_SUB: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_DTPMOD32: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_DTPMOD64: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_DTPREL32: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_DTPREL64: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_DTPREL_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_DTPREL_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_GD: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_GOTTPREL: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_LDM: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_TPREL32: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_TPREL64: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_TPREL_HI16: ClassVar[RELOCATION_MIPS] = ... MIPS_TLS_TPREL_LO16: ClassVar[RELOCATION_MIPS] = ... MIPS_UNUSED1: ClassVar[RELOCATION_MIPS] = ... MIPS_UNUSED2: ClassVar[RELOCATION_MIPS] = ... MIPS_UNUSED3: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_26_S1: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_CALL16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_CALL_HI16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_CALL_LO16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GOT16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GOT_DISP: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GOT_HI16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GOT_LO16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GOT_OFST: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GOT_PAGE: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GPREL16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_GPREL7_S2: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_HI0_LO16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_HI16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_HIGHER: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_HIGHEST: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_JALR: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_LITERAL: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_LO16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC10_S1: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC16_S1: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC18_S3: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC19_S2: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC21_S2: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC23_S2: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC26_S2: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_PC7_S1: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_SCN_DISP: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_SUB: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_TLS_DTPREL_HI16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_TLS_DTPREL_LO16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_TLS_GD: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_TLS_GOTTPREL: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_TLS_LDM: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_TLS_TPREL_HI16: ClassVar[RELOCATION_MIPS] = ... MIRCRO_MIPS_TLS_TPREL_LO16: ClassVar[RELOCATION_MIPS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_PPC: __members__: ClassVar[dict] = ... # read-only ADDR14: ClassVar[RELOCATION_PPC] = ... ADDR14_BRNTAKEN: ClassVar[RELOCATION_PPC] = ... ADDR14_BRTAKEN: ClassVar[RELOCATION_PPC] = ... ADDR16: ClassVar[RELOCATION_PPC] = ... ADDR16_HA: ClassVar[RELOCATION_PPC] = ... ADDR16_HI: ClassVar[RELOCATION_PPC] = ... ADDR16_LO: ClassVar[RELOCATION_PPC] = ... ADDR24: ClassVar[RELOCATION_PPC] = ... ADDR32: ClassVar[RELOCATION_PPC] = ... DTPMOD32: ClassVar[RELOCATION_PPC] = ... DTPREL16: ClassVar[RELOCATION_PPC] = ... DTPREL16_HA: ClassVar[RELOCATION_PPC] = ... DTPREL16_HI: ClassVar[RELOCATION_PPC] = ... DTPREL16_LO: ClassVar[RELOCATION_PPC] = ... DTPREL32: ClassVar[RELOCATION_PPC] = ... GOT16: ClassVar[RELOCATION_PPC] = ... GOT16_HA: ClassVar[RELOCATION_PPC] = ... GOT16_HI: ClassVar[RELOCATION_PPC] = ... GOT16_LO: ClassVar[RELOCATION_PPC] = ... GOT_DTPREL16: ClassVar[RELOCATION_PPC] = ... GOT_DTPREL16_HA: ClassVar[RELOCATION_PPC] = ... GOT_DTPREL16_HI: ClassVar[RELOCATION_PPC] = ... GOT_DTPREL16_LO: ClassVar[RELOCATION_PPC] = ... GOT_TLSGD16: ClassVar[RELOCATION_PPC] = ... GOT_TLSGD16_HA: ClassVar[RELOCATION_PPC] = ... GOT_TLSGD16_HI: ClassVar[RELOCATION_PPC] = ... GOT_TLSGD16_LO: ClassVar[RELOCATION_PPC] = ... GOT_TLSLD16: ClassVar[RELOCATION_PPC] = ... GOT_TLSLD16_HA: ClassVar[RELOCATION_PPC] = ... GOT_TLSLD16_HI: ClassVar[RELOCATION_PPC] = ... GOT_TLSLD16_LO: ClassVar[RELOCATION_PPC] = ... GOT_TPREL16: ClassVar[RELOCATION_PPC] = ... GOT_TPREL16_HA: ClassVar[RELOCATION_PPC] = ... GOT_TPREL16_HI: ClassVar[RELOCATION_PPC] = ... GOT_TPREL16_LO: ClassVar[RELOCATION_PPC] = ... JMP_SLOT: ClassVar[RELOCATION_PPC] = ... LOCAL24PC: ClassVar[RELOCATION_PPC] = ... NONE: ClassVar[RELOCATION_PPC] = ... PLTREL24: ClassVar[RELOCATION_PPC] = ... REL14: ClassVar[RELOCATION_PPC] = ... REL14_BRNTAKEN: ClassVar[RELOCATION_PPC] = ... REL14_BRTAKEN: ClassVar[RELOCATION_PPC] = ... REL16: ClassVar[RELOCATION_PPC] = ... REL16_HA: ClassVar[RELOCATION_PPC] = ... REL16_HI: ClassVar[RELOCATION_PPC] = ... REL16_LO: ClassVar[RELOCATION_PPC] = ... REL24: ClassVar[RELOCATION_PPC] = ... REL32: ClassVar[RELOCATION_PPC] = ... RELATIVE: ClassVar[RELOCATION_PPC] = ... TLS: ClassVar[RELOCATION_PPC] = ... TLSGD: ClassVar[RELOCATION_PPC] = ... TLSLD: ClassVar[RELOCATION_PPC] = ... TPREL16: ClassVar[RELOCATION_PPC] = ... TPREL16_HA: ClassVar[RELOCATION_PPC] = ... TPREL16_HI: ClassVar[RELOCATION_PPC] = ... TPREL16_LO: ClassVar[RELOCATION_PPC] = ... TPREL32: ClassVar[RELOCATION_PPC] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_PPC64: __members__: ClassVar[dict] = ... # read-only ADDR14: ClassVar[RELOCATION_PPC64] = ... ADDR14_BRNTAKEN: ClassVar[RELOCATION_PPC64] = ... ADDR14_BRTAKEN: ClassVar[RELOCATION_PPC64] = ... ADDR16: ClassVar[RELOCATION_PPC64] = ... ADDR16_DS: ClassVar[RELOCATION_PPC64] = ... ADDR16_HA: ClassVar[RELOCATION_PPC64] = ... ADDR16_HI: ClassVar[RELOCATION_PPC64] = ... ADDR16_HIGHER: ClassVar[RELOCATION_PPC64] = ... ADDR16_HIGHERA: ClassVar[RELOCATION_PPC64] = ... ADDR16_HIGHEST: ClassVar[RELOCATION_PPC64] = ... ADDR16_HIGHESTA: ClassVar[RELOCATION_PPC64] = ... ADDR16_LO: ClassVar[RELOCATION_PPC64] = ... ADDR16_LO_DS: ClassVar[RELOCATION_PPC64] = ... ADDR24: ClassVar[RELOCATION_PPC64] = ... ADDR32: ClassVar[RELOCATION_PPC64] = ... ADDR64: ClassVar[RELOCATION_PPC64] = ... DTPMOD64: ClassVar[RELOCATION_PPC64] = ... DTPREL16: ClassVar[RELOCATION_PPC64] = ... DTPREL16_DS: ClassVar[RELOCATION_PPC64] = ... DTPREL16_HA: ClassVar[RELOCATION_PPC64] = ... DTPREL16_HI: ClassVar[RELOCATION_PPC64] = ... DTPREL16_HIGHER: ClassVar[RELOCATION_PPC64] = ... DTPREL16_HIGHERA: ClassVar[RELOCATION_PPC64] = ... DTPREL16_HIGHEST: ClassVar[RELOCATION_PPC64] = ... DTPREL16_HIGHESTA: ClassVar[RELOCATION_PPC64] = ... DTPREL16_LO: ClassVar[RELOCATION_PPC64] = ... DTPREL16_LO_DS: ClassVar[RELOCATION_PPC64] = ... DTPREL64: ClassVar[RELOCATION_PPC64] = ... GOT16: ClassVar[RELOCATION_PPC64] = ... GOT16_DS: ClassVar[RELOCATION_PPC64] = ... GOT16_HA: ClassVar[RELOCATION_PPC64] = ... GOT16_HI: ClassVar[RELOCATION_PPC64] = ... GOT16_LO: ClassVar[RELOCATION_PPC64] = ... GOT16_LO_DS: ClassVar[RELOCATION_PPC64] = ... GOT_DTPREL16_DS: ClassVar[RELOCATION_PPC64] = ... GOT_DTPREL16_HA: ClassVar[RELOCATION_PPC64] = ... GOT_DTPREL16_HI: ClassVar[RELOCATION_PPC64] = ... GOT_DTPREL16_LO_DS: ClassVar[RELOCATION_PPC64] = ... GOT_TLSGD16: ClassVar[RELOCATION_PPC64] = ... GOT_TLSGD16_HA: ClassVar[RELOCATION_PPC64] = ... GOT_TLSGD16_HI: ClassVar[RELOCATION_PPC64] = ... GOT_TLSGD16_LO: ClassVar[RELOCATION_PPC64] = ... GOT_TLSLD16: ClassVar[RELOCATION_PPC64] = ... GOT_TLSLD16_HA: ClassVar[RELOCATION_PPC64] = ... GOT_TLSLD16_HI: ClassVar[RELOCATION_PPC64] = ... GOT_TLSLD16_LO: ClassVar[RELOCATION_PPC64] = ... GOT_TPREL16_DS: ClassVar[RELOCATION_PPC64] = ... GOT_TPREL16_HA: ClassVar[RELOCATION_PPC64] = ... GOT_TPREL16_HI: ClassVar[RELOCATION_PPC64] = ... GOT_TPREL16_LO_DS: ClassVar[RELOCATION_PPC64] = ... JMP_SLOT: ClassVar[RELOCATION_PPC64] = ... NONE: ClassVar[RELOCATION_PPC64] = ... REL14: ClassVar[RELOCATION_PPC64] = ... REL14_BRNTAKEN: ClassVar[RELOCATION_PPC64] = ... REL14_BRTAKEN: ClassVar[RELOCATION_PPC64] = ... REL16: ClassVar[RELOCATION_PPC64] = ... REL16_HA: ClassVar[RELOCATION_PPC64] = ... REL16_HI: ClassVar[RELOCATION_PPC64] = ... REL16_LO: ClassVar[RELOCATION_PPC64] = ... REL24: ClassVar[RELOCATION_PPC64] = ... REL32: ClassVar[RELOCATION_PPC64] = ... REL64: ClassVar[RELOCATION_PPC64] = ... RELATIVE: ClassVar[RELOCATION_PPC64] = ... TLS: ClassVar[RELOCATION_PPC64] = ... TLSGD: ClassVar[RELOCATION_PPC64] = ... TLSLD: ClassVar[RELOCATION_PPC64] = ... TOC: ClassVar[RELOCATION_PPC64] = ... TOC16: ClassVar[RELOCATION_PPC64] = ... TOC16_DS: ClassVar[RELOCATION_PPC64] = ... TOC16_HA: ClassVar[RELOCATION_PPC64] = ... TOC16_HI: ClassVar[RELOCATION_PPC64] = ... TOC16_LO: ClassVar[RELOCATION_PPC64] = ... TOC16_LO_DS: ClassVar[RELOCATION_PPC64] = ... TPREL16: ClassVar[RELOCATION_PPC64] = ... TPREL16_DS: ClassVar[RELOCATION_PPC64] = ... TPREL16_HA: ClassVar[RELOCATION_PPC64] = ... TPREL16_HI: ClassVar[RELOCATION_PPC64] = ... TPREL16_HIGHER: ClassVar[RELOCATION_PPC64] = ... TPREL16_HIGHERA: ClassVar[RELOCATION_PPC64] = ... TPREL16_HIGHEST: ClassVar[RELOCATION_PPC64] = ... TPREL16_HIGHESTA: ClassVar[RELOCATION_PPC64] = ... TPREL16_LO: ClassVar[RELOCATION_PPC64] = ... TPREL16_LO_DS: ClassVar[RELOCATION_PPC64] = ... TPREL64: ClassVar[RELOCATION_PPC64] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_PURPOSES: __members__: ClassVar[dict] = ... # read-only DYNAMIC: ClassVar[RELOCATION_PURPOSES] = ... NONE: ClassVar[RELOCATION_PURPOSES] = ... OBJECT: ClassVar[RELOCATION_PURPOSES] = ... PLTGOT: ClassVar[RELOCATION_PURPOSES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_X86_64: __members__: ClassVar[dict] = ... # read-only COPY: ClassVar[RELOCATION_X86_64] = ... DTPMOD64: ClassVar[RELOCATION_X86_64] = ... DTPOFF32: ClassVar[RELOCATION_X86_64] = ... DTPOFF64: ClassVar[RELOCATION_X86_64] = ... GLOB_DAT: ClassVar[RELOCATION_X86_64] = ... GOT32: ClassVar[RELOCATION_X86_64] = ... GOT64: ClassVar[RELOCATION_X86_64] = ... GOTOFF64: ClassVar[RELOCATION_X86_64] = ... GOTPC32: ClassVar[RELOCATION_X86_64] = ... GOTPC32_TLSDESC: ClassVar[RELOCATION_X86_64] = ... GOTPC64: ClassVar[RELOCATION_X86_64] = ... GOTPCREL: ClassVar[RELOCATION_X86_64] = ... GOTPCREL64: ClassVar[RELOCATION_X86_64] = ... GOTPCRELX: ClassVar[RELOCATION_X86_64] = ... GOTPLT64: ClassVar[RELOCATION_X86_64] = ... GOTTPOFF: ClassVar[RELOCATION_X86_64] = ... IRELATIVE: ClassVar[RELOCATION_X86_64] = ... JUMP_SLOT: ClassVar[RELOCATION_X86_64] = ... NONE: ClassVar[RELOCATION_X86_64] = ... PC16: ClassVar[RELOCATION_X86_64] = ... PC32: ClassVar[RELOCATION_X86_64] = ... PC32_BND: ClassVar[RELOCATION_X86_64] = ... PC64: ClassVar[RELOCATION_X86_64] = ... PC8: ClassVar[RELOCATION_X86_64] = ... PLT32: ClassVar[RELOCATION_X86_64] = ... PLT32_BND: ClassVar[RELOCATION_X86_64] = ... PLTOFF64: ClassVar[RELOCATION_X86_64] = ... R16: ClassVar[RELOCATION_X86_64] = ... R32: ClassVar[RELOCATION_X86_64] = ... R32S: ClassVar[RELOCATION_X86_64] = ... R64: ClassVar[RELOCATION_X86_64] = ... R8: ClassVar[RELOCATION_X86_64] = ... RELATIVE: ClassVar[RELOCATION_X86_64] = ... RELATIVE64: ClassVar[RELOCATION_X86_64] = ... REX_GOTPCRELX: ClassVar[RELOCATION_X86_64] = ... SIZE32: ClassVar[RELOCATION_X86_64] = ... SIZE64: ClassVar[RELOCATION_X86_64] = ... TLSDESC: ClassVar[RELOCATION_X86_64] = ... TLSDESC_CALL: ClassVar[RELOCATION_X86_64] = ... TLSGD: ClassVar[RELOCATION_X86_64] = ... TLSLD: ClassVar[RELOCATION_X86_64] = ... TPOFF32: ClassVar[RELOCATION_X86_64] = ... TPOFF64: ClassVar[RELOCATION_X86_64] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_i386: __members__: ClassVar[dict] = ... # read-only COPY: ClassVar[RELOCATION_i386] = ... GLOB_DAT: ClassVar[RELOCATION_i386] = ... GOT32: ClassVar[RELOCATION_i386] = ... GOTOFF: ClassVar[RELOCATION_i386] = ... GOTPC: ClassVar[RELOCATION_i386] = ... IRELATIVE: ClassVar[RELOCATION_i386] = ... JUMP_SLOT: ClassVar[RELOCATION_i386] = ... NONE: ClassVar[RELOCATION_i386] = ... NUM: ClassVar[RELOCATION_i386] = ... PC16: ClassVar[RELOCATION_i386] = ... PC32: ClassVar[RELOCATION_i386] = ... PC8: ClassVar[RELOCATION_i386] = ... PLT32: ClassVar[RELOCATION_i386] = ... R16: ClassVar[RELOCATION_i386] = ... R32: ClassVar[RELOCATION_i386] = ... R32PLT: ClassVar[RELOCATION_i386] = ... R8: ClassVar[RELOCATION_i386] = ... RELATIVE: ClassVar[RELOCATION_i386] = ... TLS_DESC: ClassVar[RELOCATION_i386] = ... TLS_DESC_CALL: ClassVar[RELOCATION_i386] = ... TLS_DTPMOD32: ClassVar[RELOCATION_i386] = ... TLS_DTPOFF32: ClassVar[RELOCATION_i386] = ... TLS_GD: ClassVar[RELOCATION_i386] = ... TLS_GD_32: ClassVar[RELOCATION_i386] = ... TLS_GD_CALL: ClassVar[RELOCATION_i386] = ... TLS_GD_POP: ClassVar[RELOCATION_i386] = ... TLS_GD_PUSH: ClassVar[RELOCATION_i386] = ... TLS_GOTDESC: ClassVar[RELOCATION_i386] = ... TLS_GOTIE: ClassVar[RELOCATION_i386] = ... TLS_IE: ClassVar[RELOCATION_i386] = ... TLS_IE_32: ClassVar[RELOCATION_i386] = ... TLS_LDM: ClassVar[RELOCATION_i386] = ... TLS_LDM_32: ClassVar[RELOCATION_i386] = ... TLS_LDM_CALL: ClassVar[RELOCATION_i386] = ... TLS_LDM_POP: ClassVar[RELOCATION_i386] = ... TLS_LDM_PUSH: ClassVar[RELOCATION_i386] = ... TLS_LDO_32: ClassVar[RELOCATION_i386] = ... TLS_LE: ClassVar[RELOCATION_i386] = ... TLS_LE_32: ClassVar[RELOCATION_i386] = ... TLS_TPOFF: ClassVar[RELOCATION_i386] = ... TLS_TPOFF32: ClassVar[RELOCATION_i386] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Relocation(lief.Relocation): addend: int info: int purpose: lief.ELF.RELOCATION_PURPOSES symbol: lief.ELF.Symbol type: int @overload def __init__(self) -> None: ... @overload def __init__(self, arch: lief.ELF.ARCH) -> None: ... @overload def __init__(self, address: int, type: int = ..., addend: int = ..., is_rela: bool = ...) -> None: ... @property def has_section(self) -> bool: ... @property def has_symbol(self) -> bool: ... @property def is_rel(self) -> bool: ... @property def is_rela(self) -> bool: ... @property def section(self) -> lief.ELF.Section: ... class SECTION_FLAGS: __members__: ClassVar[dict] = ... # read-only ALLOC: ClassVar[SECTION_FLAGS] = ... EXECINSTR: ClassVar[SECTION_FLAGS] = ... GROUP: ClassVar[SECTION_FLAGS] = ... HEX_GPREL: ClassVar[SECTION_FLAGS] = ... INFO_LINK: ClassVar[SECTION_FLAGS] = ... LINK_ORDER: ClassVar[SECTION_FLAGS] = ... MASKOS: ClassVar[SECTION_FLAGS] = ... MASKPROC: ClassVar[SECTION_FLAGS] = ... MERGE: ClassVar[SECTION_FLAGS] = ... MIPS_STRING: ClassVar[SECTION_FLAGS] = ... NONE: ClassVar[SECTION_FLAGS] = ... OS_NONCONFORMING: ClassVar[SECTION_FLAGS] = ... SHF_CP_SECTION: ClassVar[SECTION_FLAGS] = ... STRINGS: ClassVar[SECTION_FLAGS] = ... TLS: ClassVar[SECTION_FLAGS] = ... WRITE: ClassVar[SECTION_FLAGS] = ... XCORE_SHF_CP_SECTION: ClassVar[SECTION_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SECTION_TYPES: __members__: ClassVar[dict] = ... # read-only ANDROID_REL: ClassVar[SECTION_TYPES] = ... ANDROID_RELA: ClassVar[SECTION_TYPES] = ... ARM_ATTRIBUTES: ClassVar[SECTION_TYPES] = ... ARM_DEBUGOVERLAY: ClassVar[SECTION_TYPES] = ... ARM_EXIDX: ClassVar[SECTION_TYPES] = ... ARM_OVERLAYSECTION: ClassVar[SECTION_TYPES] = ... ARM_PREEMPTMAP: ClassVar[SECTION_TYPES] = ... DYNAMIC: ClassVar[SECTION_TYPES] = ... DYNSYM: ClassVar[SECTION_TYPES] = ... FINI_ARRAY: ClassVar[SECTION_TYPES] = ... GNU_ATTRIBUTES: ClassVar[SECTION_TYPES] = ... GNU_HASH: ClassVar[SECTION_TYPES] = ... GNU_VERDEF: ClassVar[SECTION_TYPES] = ... GNU_VERNEED: ClassVar[SECTION_TYPES] = ... GROUP: ClassVar[SECTION_TYPES] = ... HASH: ClassVar[SECTION_TYPES] = ... HIOS: ClassVar[SECTION_TYPES] = ... HIPROC: ClassVar[SECTION_TYPES] = ... HIUSER: ClassVar[SECTION_TYPES] = ... INIT_ARRAY: ClassVar[SECTION_TYPES] = ... LLVM_ADDRSIG: ClassVar[SECTION_TYPES] = ... LOOS: ClassVar[SECTION_TYPES] = ... LOPROC: ClassVar[SECTION_TYPES] = ... LOUSER: ClassVar[SECTION_TYPES] = ... NOBITS: ClassVar[SECTION_TYPES] = ... NOTE: ClassVar[SECTION_TYPES] = ... NULL: ClassVar[SECTION_TYPES] = ... PREINIT_ARRAY: ClassVar[SECTION_TYPES] = ... PROGBITS: ClassVar[SECTION_TYPES] = ... REL: ClassVar[SECTION_TYPES] = ... RELA: ClassVar[SECTION_TYPES] = ... RELR: ClassVar[SECTION_TYPES] = ... SHLIB: ClassVar[SECTION_TYPES] = ... STRTAB: ClassVar[SECTION_TYPES] = ... SYMTAB: ClassVar[SECTION_TYPES] = ... SYMTAB_SHNDX: ClassVar[SECTION_TYPES] = ... X86_64_UNWIND: ClassVar[SECTION_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SEGMENT_FLAGS: __members__: ClassVar[dict] = ... # read-only NONE: ClassVar[SEGMENT_FLAGS] = ... R: ClassVar[SEGMENT_FLAGS] = ... W: ClassVar[SEGMENT_FLAGS] = ... X: ClassVar[SEGMENT_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SEGMENT_TYPES: __members__: ClassVar[dict] = ... # read-only ARM_ARCHEXT: ClassVar[SEGMENT_TYPES] = ... ARM_UNWIND: ClassVar[SEGMENT_TYPES] = ... DYNAMIC: ClassVar[SEGMENT_TYPES] = ... GNU_EH_FRAME: ClassVar[SEGMENT_TYPES] = ... GNU_PROPERTY: ClassVar[SEGMENT_TYPES] = ... GNU_RELRO: ClassVar[SEGMENT_TYPES] = ... GNU_STACK: ClassVar[SEGMENT_TYPES] = ... INTERP: ClassVar[SEGMENT_TYPES] = ... LOAD: ClassVar[SEGMENT_TYPES] = ... NOTE: ClassVar[SEGMENT_TYPES] = ... NULL: ClassVar[SEGMENT_TYPES] = ... PHDR: ClassVar[SEGMENT_TYPES] = ... SHLIB: ClassVar[SEGMENT_TYPES] = ... TLS: ClassVar[SEGMENT_TYPES] = ... UNWIND: ClassVar[SEGMENT_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_BINDINGS: __members__: ClassVar[dict] = ... # read-only GLOBAL: ClassVar[SYMBOL_BINDINGS] = ... GNU_UNIQUE: ClassVar[SYMBOL_BINDINGS] = ... LOCAL: ClassVar[SYMBOL_BINDINGS] = ... WEAK: ClassVar[SYMBOL_BINDINGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_SECTION_INDEX: __members__: ClassVar[dict] = ... # read-only ABS: ClassVar[SYMBOL_SECTION_INDEX] = ... COMMON: ClassVar[SYMBOL_SECTION_INDEX] = ... UNDEF: ClassVar[SYMBOL_SECTION_INDEX] = ... XINDEX: ClassVar[SYMBOL_SECTION_INDEX] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_TYPES: __members__: ClassVar[dict] = ... # read-only COMMON: ClassVar[SYMBOL_TYPES] = ... FILE: ClassVar[SYMBOL_TYPES] = ... FUNC: ClassVar[SYMBOL_TYPES] = ... GNU_IFUNC: ClassVar[SYMBOL_TYPES] = ... NOTYPE: ClassVar[SYMBOL_TYPES] = ... OBJECT: ClassVar[SYMBOL_TYPES] = ... SECTION: ClassVar[SYMBOL_TYPES] = ... TLS: ClassVar[SYMBOL_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_VISIBILITY: __members__: ClassVar[dict] = ... # read-only DEFAULT: ClassVar[SYMBOL_VISIBILITY] = ... HIDDEN: ClassVar[SYMBOL_VISIBILITY] = ... INTERNAL: ClassVar[SYMBOL_VISIBILITY] = ... PROTECTED: ClassVar[SYMBOL_VISIBILITY] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Section(lief.Section): class it_segments: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Segment: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Segment: ... alignment: int entry_size: int file_offset: int flags: int information: Any link: int type: lief.ELF.SECTION_TYPES @overload def __init__(self) -> None: ... @overload def __init__(self, name: str, type: lief.ELF.SECTION_TYPES = ...) -> None: ... @overload def __init__(self, arg0: lief.ELF.Section, arg1: List[int], arg2: lief.ELF.ELF_CLASS) -> None: ... def add(self, flag: lief.ELF.SECTION_FLAGS) -> None: ... def as_frame(self) -> lief.ELF.Section: ... def clear(self, value: int = ...) -> lief.ELF.Section: ... @overload def has(self, flag: lief.ELF.SECTION_FLAGS) -> bool: ... @overload def has(self, segment: lief.ELF.Segment) -> bool: ... def remove(self, flag: lief.ELF.SECTION_FLAGS) -> None: ... @overload def __contains__(self, arg0: lief.ELF.SECTION_FLAGS) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.Segment) -> bool: ... def __iadd__(self, arg0: lief.ELF.SECTION_FLAGS) -> lief.ELF.Section: ... def __isub__(self, arg0: lief.ELF.SECTION_FLAGS) -> lief.ELF.Section: ... @property def flags_list(self) -> Set[lief.ELF.SECTION_FLAGS]: ... @property def is_frame(self) -> bool: ... @property def original_size(self) -> int: ... @property def segments(self) -> lief.ELF.Section.it_segments: ... class Segment(lief.Object): class it_sections: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.Section: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.Section: ... alignment: int content: memoryview file_offset: int flags: lief.ELF.SEGMENT_FLAGS physical_address: int physical_size: int type: lief.ELF.SEGMENT_TYPES virtual_address: int virtual_size: int def __init__(self) -> None: ... def add(self, flag: lief.ELF.SEGMENT_FLAGS) -> None: ... def from_raw(self, *args, **kwargs) -> Any: ... @overload def has(self, flag: lief.ELF.SEGMENT_FLAGS) -> bool: ... @overload def has(self, section: lief.ELF.Section) -> bool: ... @overload def has(self, section_name: str) -> bool: ... def remove(self, flag: lief.ELF.SEGMENT_FLAGS) -> None: ... @overload def __contains__(self, arg0: lief.ELF.SEGMENT_FLAGS) -> bool: ... @overload def __contains__(self, arg0: lief.ELF.Section) -> bool: ... @overload def __contains__(self, arg0: str) -> bool: ... def __iadd__(self, arg0: lief.ELF.SEGMENT_FLAGS) -> lief.ELF.Segment: ... def __isub__(self, arg0: lief.ELF.SEGMENT_FLAGS) -> lief.ELF.Segment: ... @property def sections(self) -> lief.ELF.Segment.it_sections: ... class Symbol(lief.Symbol): binding: lief.ELF.SYMBOL_BINDINGS exported: bool imported: bool information: int other: int shndx: int size: int type: lief.ELF.SYMBOL_TYPES value: int visibility: lief.ELF.SYMBOL_VISIBILITY def __init__(self) -> None: ... @property def demangled_name(self) -> str: ... @property def has_version(self) -> bool: ... @property def is_function(self) -> bool: ... @property def is_static(self) -> bool: ... @property def is_variable(self) -> bool: ... @property def section(self) -> Any: ... @property def symbol_version(self) -> lief.ELF.SymbolVersion: ... class SymbolVersion(lief.Object): global_: ClassVar[lief.ELF.SymbolVersion] = ... # read-only local: ClassVar[lief.ELF.SymbolVersion] = ... # read-only symbol_version_auxiliary: lief.ELF.SymbolVersionAux value: int @overload def __init__(self) -> None: ... @overload def __init__(self, arg0: int) -> None: ... @property def has_auxiliary_version(self) -> bool: ... class SymbolVersionAux(lief.Object): name: object def __init__(self, *args, **kwargs) -> None: ... class SymbolVersionAuxRequirement(SymbolVersionAux): flags: int hash: int other: int def __init__(self) -> None: ... class SymbolVersionDefinition(lief.Object): class it_version_aux: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.SymbolVersionAux: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.SymbolVersionAux: ... flags: int hash: int version: int def __init__(self, *args, **kwargs) -> None: ... @property def auxiliary_symbols(self) -> lief.ELF.SymbolVersionDefinition.it_version_aux: ... class SymbolVersionRequirement(lief.Object): class it_aux_requirement: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.ELF.SymbolVersionAuxRequirement: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.ELF.SymbolVersionAuxRequirement: ... name: str version: int def __init__(self, *args, **kwargs) -> None: ... def add_auxiliary_requirement(self, arg0: lief.ELF.SymbolVersionAuxRequirement) -> lief.ELF.SymbolVersionAuxRequirement: ... def get_auxiliary_symbols(self) -> lief.ELF.SymbolVersionRequirement.it_aux_requirement: ... class SysvHash(lief.Object): nchain: int def __init__(self) -> None: ... @property def buckets(self) -> List[int]: ... @property def chains(self) -> List[int]: ... @property def nbucket(self) -> int: ... class VERSION: __members__: ClassVar[dict] = ... # read-only CURRENT: ClassVar[VERSION] = ... NONE: ClassVar[VERSION] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... @overload def parse(filename: str, dynsym_count_method: lief.ELF.DYNSYM_COUNT_METHODS = ...) -> lief.ELF.Binary | None: ... @overload def parse(raw: List[int], name: str = ..., dynsym_count_method: lief.ELF.DYNSYM_COUNT_METHODS = ...) -> lief.ELF.Binary | None: ... @overload def parse(io: object, name: str = ..., dynsym_count_method: lief.ELF.DYNSYM_COUNT_METHODS = ...) -> lief.ELF.Binary | None: ... LIEF-0.13.1/api/python/lief/MachO.pyi000066400000000000000000001420741443457337100170610ustar00rootroot00000000000000from typing import Any, ClassVar, Iterator, List, Set, Tuple from typing import overload import lief # type: ignore import lief.MachO # type: ignore class ARM64_RELOCATION: __members__: ClassVar[dict] = ... # read-only ADDEND: ClassVar[ARM64_RELOCATION] = ... BRANCH26: ClassVar[ARM64_RELOCATION] = ... GOT_LOAD_PAGE21: ClassVar[ARM64_RELOCATION] = ... GOT_LOAD_PAGEOFF12: ClassVar[ARM64_RELOCATION] = ... PAGE21: ClassVar[ARM64_RELOCATION] = ... PAGEOFF12: ClassVar[ARM64_RELOCATION] = ... POINTER_TO_GOT: ClassVar[ARM64_RELOCATION] = ... SUBTRACTOR: ClassVar[ARM64_RELOCATION] = ... TLVP_LOAD_PAGE21: ClassVar[ARM64_RELOCATION] = ... TLVP_LOAD_PAGEOFF12: ClassVar[ARM64_RELOCATION] = ... UNSIGNED: ClassVar[ARM64_RELOCATION] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ARM_RELOCATION: __members__: ClassVar[dict] = ... # read-only BR24: ClassVar[ARM_RELOCATION] = ... HALF: ClassVar[ARM_RELOCATION] = ... HALF_SECTDIFF: ClassVar[ARM_RELOCATION] = ... LOCAL_SECTDIFF: ClassVar[ARM_RELOCATION] = ... PAIR: ClassVar[ARM_RELOCATION] = ... PB_LA_PTR: ClassVar[ARM_RELOCATION] = ... SECTDIFF: ClassVar[ARM_RELOCATION] = ... THUMB_32BIT_BRANCH: ClassVar[ARM_RELOCATION] = ... THUMB_RELOC_BR22: ClassVar[ARM_RELOCATION] = ... VANILLA: ClassVar[ARM_RELOCATION] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class BINDING_CLASS: __members__: ClassVar[dict] = ... # read-only LAZY: ClassVar[BINDING_CLASS] = ... STANDARD: ClassVar[BINDING_CLASS] = ... THREADED: ClassVar[BINDING_CLASS] = ... WEAK: ClassVar[BINDING_CLASS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class BIND_OPCODES: __members__: ClassVar[dict] = ... # read-only ADD_ADDR_ULEB: ClassVar[BIND_OPCODES] = ... DONE: ClassVar[BIND_OPCODES] = ... DO_BIND: ClassVar[BIND_OPCODES] = ... DO_BIND_ADD_ADDR_IMM_SCALED: ClassVar[BIND_OPCODES] = ... DO_BIND_ADD_ADDR_ULEB: ClassVar[BIND_OPCODES] = ... DO_BIND_ULEB_TIMES_SKIPPING_ULEB: ClassVar[BIND_OPCODES] = ... SET_ADDEND_SLEB: ClassVar[BIND_OPCODES] = ... SET_DYLIB_ORDINAL_IMM: ClassVar[BIND_OPCODES] = ... SET_DYLIB_ORDINAL_ULEB: ClassVar[BIND_OPCODES] = ... SET_DYLIB_SPECIAL_IMM: ClassVar[BIND_OPCODES] = ... SET_SEGMENT_AND_OFFSET_ULEB: ClassVar[BIND_OPCODES] = ... SET_SYMBOL_TRAILING_FLAGS_IMM: ClassVar[BIND_OPCODES] = ... SET_TYPE_IMM: ClassVar[BIND_OPCODES] = ... THREADED: ClassVar[BIND_OPCODES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class BIND_SPECIAL_DYLIB: __members__: ClassVar[dict] = ... # read-only FLAT_LOOKUP: ClassVar[BIND_SPECIAL_DYLIB] = ... MAIN_EXECUTABLE: ClassVar[BIND_SPECIAL_DYLIB] = ... SELF: ClassVar[BIND_SPECIAL_DYLIB] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class BIND_TYPES: __members__: ClassVar[dict] = ... # read-only POINTER: ClassVar[BIND_TYPES] = ... TEXT_ABSOLUTE32: ClassVar[BIND_TYPES] = ... TEXT_PCREL32: ClassVar[BIND_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Binary(lief.Binary): class it_commands: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.LoadCommand: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.LoadCommand: ... class it_filter_symbols: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Symbol: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.Symbol: ... class it_libraries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.DylibCommand: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.DylibCommand: ... class it_relocations: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Relocation: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.Relocation: ... class it_rpaths: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.RPathCommand: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.RPathCommand: ... class it_sections: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Section: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.Section: ... class it_segments: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.SegmentCommand: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.SegmentCommand: ... class it_symbols: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Symbol: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.Symbol: ... class range_t: end: int start: int def __init__(self, *args, **kwargs) -> None: ... def __init__(self, *args, **kwargs) -> None: ... @overload def add(self, dylib_command: lief.MachO.DylibCommand) -> lief.MachO.LoadCommand: ... @overload def add(self, segment: lief.MachO.SegmentCommand) -> lief.MachO.LoadCommand: ... @overload def add(self, load_command: lief.MachO.LoadCommand) -> lief.MachO.LoadCommand: ... @overload def add(self, load_command: lief.MachO.LoadCommand, index: int) -> lief.MachO.LoadCommand: ... def add_exported_function(self, address: int, name: str) -> lief.MachO.ExportInfo: ... def add_library(self, library_name: str) -> lief.MachO.LoadCommand: ... def add_local_symbol(self, address: int, name: str) -> lief.MachO.Symbol: ... @overload def add_section(self, segment: lief.MachO.SegmentCommand, section: lief.MachO.Section) -> lief.MachO.Section: ... @overload def add_section(self, section: lief.MachO.Section) -> lief.MachO.Section: ... def can_remove(self, symbol: lief.MachO.Symbol) -> bool: ... def can_remove_symbol(self, symbol_name: str) -> bool: ... def extend(self, load_command: lief.MachO.LoadCommand, size: int) -> bool: ... def extend_segment(self, segment_command: lief.MachO.SegmentCommand, size: int) -> bool: ... def get(self, type: lief.MachO.LOAD_COMMAND_TYPES) -> lief.MachO.LoadCommand: ... @overload def get_section(self, name: str) -> lief.MachO.Section: ... @overload def get_section(self, segname: str, secname: str) -> lief.MachO.Section: ... def get_segment(self, name: str) -> lief.MachO.SegmentCommand: ... def get_symbol(self, name: str) -> lief.MachO.Symbol: ... def has(self, type: lief.MachO.LOAD_COMMAND_TYPES) -> bool: ... def has_section(self, name: str) -> bool: ... def has_segment(self, name: str) -> bool: ... def has_symbol(self, name: str) -> bool: ... def is_valid_addr(self, address: int) -> bool: ... @overload def remove(self, load_command: lief.MachO.LoadCommand) -> bool: ... @overload def remove(self, type: lief.MachO.LOAD_COMMAND_TYPES) -> bool: ... @overload def remove(self, symbol: lief.MachO.Symbol) -> bool: ... def remove_command(self, index: int) -> bool: ... @overload def remove_section(self, name: str, clear: bool = ...) -> None: ... @overload def remove_section(self, segname: str, secname: str, clear: bool = ...) -> None: ... def remove_signature(self) -> bool: ... def remove_symbol(self, name: str) -> bool: ... def section_from_offset(self, arg0: int) -> lief.MachO.Section: ... def section_from_virtual_address(self, arg0: int) -> lief.MachO.Section: ... def segment_from_offset(self, arg0: int) -> lief.MachO.SegmentCommand: ... def segment_from_virtual_address(self, arg0: int) -> lief.MachO.SegmentCommand: ... def shift(self, value: int) -> object: ... def shift_linkedit(self, value: int) -> object: ... @overload def unexport(self, name: str) -> bool: ... @overload def unexport(self, symbol: lief.MachO.Symbol) -> bool: ... def virtual_address_to_offset(self, virtual_address: int) -> object: ... def write(self, output: str) -> None: ... def __contains__(self, arg0: lief.MachO.LOAD_COMMAND_TYPES) -> bool: ... def __getitem__(self, arg0: lief.MachO.LOAD_COMMAND_TYPES) -> lief.MachO.LoadCommand: ... @property def build_version(self) -> lief.MachO.BuildVersion: ... @property def code_signature(self) -> lief.MachO.CodeSignature: ... @property def code_signature_dir(self) -> lief.MachO.CodeSignatureDir: ... @property def commands(self) -> lief.MachO.Binary.it_commands: ... @property def data_in_code(self) -> lief.MachO.DataInCode: ... @property def dyld_chained_fixups(self) -> lief.MachO.DyldChainedFixups: ... @property def dyld_environment(self) -> lief.MachO.DyldEnvironment: ... @property def dyld_exports_trie(self) -> lief.MachO.DyldExportsTrie: ... @property def dyld_info(self) -> lief.MachO.DyldInfo: ... @property def dylinker(self) -> lief.MachO.DylinkerCommand: ... @property def dynamic_symbol_command(self) -> lief.MachO.DynamicSymbolCommand: ... @property def encryption_info(self) -> lief.MachO.EncryptionInfo: ... @property def exported_symbols(self) -> lief.MachO.Binary.it_filter_symbols: ... @property def fat_offset(self) -> int: ... @property def filesets(self) -> lief.MachO.FatBinary.it_binaries: ... @property def function_starts(self) -> lief.MachO.FunctionStarts: ... @property def functions(self) -> List[lief.Function]: ... @property def has_build_version(self) -> bool: ... @property def has_code_signature(self) -> bool: ... @property def has_code_signature_dir(self) -> bool: ... @property def has_data_in_code(self) -> bool: ... @property def has_dyld_chained_fixups(self) -> bool: ... @property def has_dyld_environment(self) -> bool: ... @property def has_dyld_exports_trie(self) -> bool: ... @property def has_dyld_info(self) -> bool: ... @property def has_dylinker(self) -> bool: ... @property def has_dynamic_symbol_command(self) -> bool: ... @property def has_encryption_info(self) -> bool: ... @property def has_entrypoint(self) -> bool: ... @property def has_filesets(self) -> bool: ... @property def has_function_starts(self) -> bool: ... @property def has_linker_opt_hint(self) -> bool: ... @property def has_main_command(self) -> bool: ... @property def has_rpath(self) -> bool: ... @property def has_segment_split_info(self) -> bool: ... @property def has_source_version(self) -> bool: ... @property def has_sub_framework(self) -> bool: ... @property def has_symbol_command(self) -> bool: ... @property def has_thread_command(self) -> bool: ... @property def has_two_level_hints(self) -> bool: ... @property def has_uuid(self) -> bool: ... @property def has_version_min(self) -> bool: ... @property def header(self) -> lief.MachO.Header: ... @property def imagebase(self) -> int: ... @property def imported_symbols(self) -> lief.MachO.Binary.it_filter_symbols: ... @property def libraries(self) -> lief.MachO.Binary.it_libraries: ... @property def linker_opt_hint(self) -> lief.MachO.LinkerOptHint: ... @property def main_command(self) -> lief.MachO.MainCommand: ... @property def off_ranges(self) -> lief.MachO.Binary.range_t: ... @property def page_size(self) -> int: ... @property def relocations(self) -> lief.MachO.Binary.it_relocations: ... @property def rpath(self) -> lief.MachO.RPathCommand: ... @property def rpaths(self) -> lief.MachO.Binary.it_rpaths: ... @property def sections(self) -> lief.MachO.Binary.it_sections: ... @property def segment_split_info(self) -> lief.MachO.SegmentSplitInfo: ... @property def segments(self) -> lief.MachO.Binary.it_segments: ... @property def source_version(self) -> lief.MachO.SourceVersion: ... @property def sub_framework(self) -> lief.MachO.SubFramework: ... @property def symbol_command(self) -> lief.MachO.SymbolCommand: ... @property def symbols(self) -> lief.MachO.Binary.it_symbols: ... @property def thread_command(self) -> lief.MachO.ThreadCommand: ... @property def two_level_hints(self) -> lief.MachO.TwoLevelHints: ... @property def unwind_functions(self) -> List[lief.Function]: ... @property def uuid(self) -> lief.MachO.UUIDCommand: ... @property def va_ranges(self) -> lief.MachO.Binary.range_t: ... @property def version_min(self) -> lief.MachO.VersionMin: ... @property def virtual_size(self) -> int: ... class BindingInfo(lief.Object): addend: int address: int library_ordinal: int weak_import: bool def __init__(self, *args, **kwargs) -> None: ... @property def has_library(self) -> bool: ... @property def has_segment(self) -> bool: ... @property def has_symbol(self) -> bool: ... @property def library(self) -> lief.MachO.DylibCommand: ... @property def segment(self) -> lief.MachO.SegmentCommand: ... @property def symbol(self) -> lief.MachO.Symbol: ... class BuildToolVersion(lief.Object): class TOOLS: __members__: ClassVar[dict] = ... # read-only CLANG: ClassVar[BuildToolVersion.TOOLS] = ... LD: ClassVar[BuildToolVersion.TOOLS] = ... SWIFT: ClassVar[BuildToolVersion.TOOLS] = ... UNKNOWN: ClassVar[BuildToolVersion.TOOLS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def __init__(self, *args, **kwargs) -> None: ... @property def tool(self) -> lief.MachO.BuildToolVersion.TOOLS: ... @property def version(self) -> List[int]: ... class BuildVersion(LoadCommand): class PLATFORMS: __members__: ClassVar[dict] = ... # read-only IOS: ClassVar[BuildVersion.PLATFORMS] = ... MACOS: ClassVar[BuildVersion.PLATFORMS] = ... TVOS: ClassVar[BuildVersion.PLATFORMS] = ... UNKNOWN: ClassVar[BuildVersion.PLATFORMS] = ... WATCHOS: ClassVar[BuildVersion.PLATFORMS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... minos: List[int] platform: lief.MachO.BuildVersion.PLATFORMS sdk: List[int] def __init__(self, *args, **kwargs) -> None: ... @property def tools(self) -> List[lief.MachO.BuildToolVersion]: ... class Builder: class config_t: linkedit: bool def __init__(self) -> None: ... def __init__(self, *args, **kwargs) -> None: ... def write(self, *args, **kwargs) -> Any: ... class CPU_TYPES: __members__: ClassVar[dict] = ... # read-only ANY: ClassVar[CPU_TYPES] = ... ARM: ClassVar[CPU_TYPES] = ... ARM64: ClassVar[CPU_TYPES] = ... I386: ClassVar[CPU_TYPES] = ... MC98000: ClassVar[CPU_TYPES] = ... POWERPC: ClassVar[CPU_TYPES] = ... POWERPC64: ClassVar[CPU_TYPES] = ... SPARC: ClassVar[CPU_TYPES] = ... __entries: ClassVar[dict] = ... x86: ClassVar[CPU_TYPES] = ... x86_64: ClassVar[CPU_TYPES] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ChainedBindingInfo(BindingInfo): offset: int def __init__(self, *args, **kwargs) -> None: ... @property def format(self) -> lief.MachO.DYLD_CHAINED_FORMAT: ... @property def ptr_format(self) -> lief.MachO.DYLD_CHAINED_PTR_FORMAT: ... @property def sign_extended_addend(self) -> int: ... class CodeSignature(LoadCommand): data_offset: int data_size: int def __init__(self, *args, **kwargs) -> None: ... @property def content(self) -> memoryview: ... class CodeSignatureDir(LoadCommand): data_offset: int data_size: int def __init__(self, *args, **kwargs) -> None: ... @property def content(self) -> memoryview: ... class DYLD_CHAINED_FORMAT: __members__: ClassVar[dict] = ... # read-only IMPORT: ClassVar[DYLD_CHAINED_FORMAT] = ... IMPORT_ADDEND: ClassVar[DYLD_CHAINED_FORMAT] = ... IMPORT_ADDEND64: ClassVar[DYLD_CHAINED_FORMAT] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DYLD_CHAINED_PTR_FORMAT: __members__: ClassVar[dict] = ... # read-only PTR_32: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_32_CACHE: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_32_FIRMWARE: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_64: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_64_KERNEL_CACHE: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_64_OFFSET: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_ARM64E: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_ARM64E_FIRMWARE: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_ARM64E_KERNEL: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_ARM64E_USERLAND: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_ARM64E_USERLAND24: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... PTR_X86_64_KERNEL_CACHE: ClassVar[DYLD_CHAINED_PTR_FORMAT] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DataCodeEntry(lief.Object): class TYPES: __members__: ClassVar[dict] = ... # read-only ABS_JUMP_TABLE_32: ClassVar[DataCodeEntry.TYPES] = ... DATA: ClassVar[DataCodeEntry.TYPES] = ... JUMP_TABLE_16: ClassVar[DataCodeEntry.TYPES] = ... JUMP_TABLE_32: ClassVar[DataCodeEntry.TYPES] = ... JUMP_TABLE_8: ClassVar[DataCodeEntry.TYPES] = ... UNKNOWN: ClassVar[DataCodeEntry.TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... length: int offset: int type: lief.MachO.DataCodeEntry.TYPES def __init__(self, arg0: int, arg1: int, arg2: lief.MachO.DataCodeEntry.TYPES) -> None: ... class DataInCode(LoadCommand): data_offset: int data_size: int def __init__(self, *args, **kwargs) -> None: ... def add(self, entry: lief.MachO.DataCodeEntry) -> lief.MachO.DataInCode: ... @property def content(self) -> memoryview: ... @property def entries(self) -> lief.MachO.it_data_in_code_entries: ... class DyldBindingInfo(BindingInfo): binding_class: lief.MachO.BINDING_CLASS binding_type: lief.MachO.BIND_TYPES def __init__(self, *args, **kwargs) -> None: ... @property def original_offset(self) -> int: ... class DyldChainedFixups(LoadCommand): class chained_starts_in_segment: def __init__(self, *args, **kwargs) -> None: ... @property def max_valid_pointer(self) -> int: ... @property def offset(self) -> int: ... @property def page_count(self) -> int: ... @property def page_size(self) -> int: ... @property def page_start(self) -> List[int]: ... @property def pointer_format(self) -> lief.MachO.DYLD_CHAINED_PTR_FORMAT: ... @property def segment(self) -> lief.MachO.SegmentCommand: ... @property def segment_offset(self) -> int: ... @property def size(self) -> int: ... class it_binding_info: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.ChainedBindingInfo: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.ChainedBindingInfo: ... class it_chained_starts_in_segments_t: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.DyldChainedFixups.chained_starts_in_segment: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.DyldChainedFixups.chained_starts_in_segment: ... data_offset: int data_size: int fixups_version: int imports_count: int imports_format: lief.MachO.DYLD_CHAINED_FORMAT imports_offset: int starts_offset: int symbols_format: int symbols_offset: int def __init__(self, *args, **kwargs) -> None: ... @property def bindings(self) -> lief.MachO.DyldChainedFixups.it_binding_info: ... @property def chained_starts_in_segments(self) -> lief.MachO.DyldChainedFixups.it_chained_starts_in_segments_t: ... class DyldEnvironment(LoadCommand): value: str def __init__(self, *args, **kwargs) -> None: ... class DyldExportsTrie(LoadCommand): data_offset: int data_size: int def __init__(self, *args, **kwargs) -> None: ... def show_export_trie(self) -> str: ... @property def content(self) -> memoryview: ... @property def exports(self) -> lief.MachO.DyldInfo.it_export_info: ... class DyldInfo(LoadCommand): class it_binding_info: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.DyldBindingInfo: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.DyldBindingInfo: ... class it_export_info: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.ExportInfo: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.ExportInfo: ... bind: Tuple[int,int] bind_opcodes: memoryview export_info: Tuple[int,int] export_trie: memoryview lazy_bind: Tuple[int,int] lazy_bind_opcodes: memoryview rebase: Tuple[int,int] rebase_opcodes: memoryview weak_bind: Tuple[int,int] weak_bind_opcodes: memoryview def __init__(self, *args, **kwargs) -> None: ... def set_bind_offset(self, offset: int) -> None: ... def set_bind_size(self, size: int) -> None: ... def set_export_offset(self, offset: int) -> None: ... def set_export_size(self, size: int) -> None: ... def set_lazy_bind_offset(self, offset: int) -> None: ... def set_lazy_bind_size(self, size: int) -> None: ... def set_rebase_offset(self, offset: int) -> None: ... def set_rebase_size(self, size: int) -> None: ... def set_weak_bind_offset(self, offset: int) -> None: ... def set_weak_bind_size(self, size: int) -> None: ... @property def bindings(self) -> lief.MachO.DyldInfo.it_binding_info: ... @property def exports(self) -> lief.MachO.DyldInfo.it_export_info: ... @property def show_bind_opcodes(self) -> str: ... @property def show_export_trie(self) -> str: ... @property def show_lazy_bind_opcodes(self) -> str: ... @property def show_rebases_opcodes(self) -> str: ... @property def show_weak_bind_opcodes(self) -> str: ... class DylibCommand(LoadCommand): compatibility_version: List[int] current_version: List[int] name: str timestamp: int def __init__(self, *args, **kwargs) -> None: ... def id_dylib(self, *args, **kwargs) -> Any: ... def lazy_load_dylib(self, *args, **kwargs) -> Any: ... def load_dylib(self, *args, **kwargs) -> Any: ... def load_upward_dylib(self, *args, **kwargs) -> Any: ... def reexport_dylib(self, *args, **kwargs) -> Any: ... def weak_lib(self, *args, **kwargs) -> Any: ... class DylinkerCommand(LoadCommand): name: str def __init__(self, *args, **kwargs) -> None: ... class DynamicSymbolCommand(LoadCommand): external_reference_symbol_offset: int external_relocation_offset: int idx_external_define_symbol: int idx_local_symbol: int idx_undefined_symbol: int indirect_symbol_offset: int local_relocation_offset: int module_table_offset: int nb_external_define_symbols: int nb_external_reference_symbols: int nb_external_relocations: int nb_indirect_symbols: int nb_local_relocations: int nb_local_symbols: int nb_module_table: int nb_toc: int nb_undefined_symbols: int toc_offset: int def __init__(self, *args, **kwargs) -> None: ... class EXPORT_SYMBOL_FLAGS: __members__: ClassVar[dict] = ... # read-only REEXPORT: ClassVar[EXPORT_SYMBOL_FLAGS] = ... STUB_AND_RESOLVER: ClassVar[EXPORT_SYMBOL_FLAGS] = ... WEAK_DEFINITION: ClassVar[EXPORT_SYMBOL_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class EXPORT_SYMBOL_KINDS: __members__: ClassVar[dict] = ... # read-only ABSOLUTE: ClassVar[EXPORT_SYMBOL_KINDS] = ... REGULAR: ClassVar[EXPORT_SYMBOL_KINDS] = ... THREAD_LOCAL: ClassVar[EXPORT_SYMBOL_KINDS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class EncryptionInfo(LoadCommand): crypt_id: int crypt_offset: int crypt_size: int def __init__(self, *args, **kwargs) -> None: ... class ExportInfo(lief.Object): address: int flags: int def __init__(self, *args, **kwargs) -> None: ... def has(self, Checkiftheflag) -> bool: ... @property def alias(self) -> lief.MachO.Symbol: ... @property def alias_library(self) -> lief.MachO.DylibCommand: ... @property def flags_list(self) -> List[lief.MachO.EXPORT_SYMBOL_FLAGS]: ... @property def has_symbol(self) -> bool: ... @property def kind(self) -> lief.MachO.EXPORT_SYMBOL_KINDS: ... @property def node_offset(self) -> int: ... @property def symbol(self) -> lief.MachO.Symbol: ... class FILE_TYPES: __members__: ClassVar[dict] = ... # read-only BUNDLE: ClassVar[FILE_TYPES] = ... CORE: ClassVar[FILE_TYPES] = ... DSYM: ClassVar[FILE_TYPES] = ... DYLIB: ClassVar[FILE_TYPES] = ... DYLIB_STUB: ClassVar[FILE_TYPES] = ... DYLINKER: ClassVar[FILE_TYPES] = ... EXECUTE: ClassVar[FILE_TYPES] = ... FVMLIB: ClassVar[FILE_TYPES] = ... KEXT_BUNDLE: ClassVar[FILE_TYPES] = ... OBJECT: ClassVar[FILE_TYPES] = ... PRELOAD: ClassVar[FILE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class FatBinary: class it_binaries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Binary: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.Binary: ... def __init__(self, *args, **kwargs) -> None: ... def at(self, index: int) -> lief.MachO.Binary: ... def raw(self) -> List[int]: ... def take(self, cpu: lief.MachO.CPU_TYPES) -> lief.MachO.Binary: ... def write(self, filename: str) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Binary: ... def __iter__(self) -> lief.MachO.FatBinary.it_binaries: ... def __len__(self) -> int: ... @property def size(self) -> int: ... class FilesetCommand(LoadCommand): file_offset: int name: str virtual_address: int def __init__(self, *args, **kwargs) -> None: ... @property def binary(self) -> lief.MachO.Binary: ... class FunctionStarts(LoadCommand): data_offset: int data_size: int functions: List[int] def __init__(self, *args, **kwargs) -> None: ... def add_function(self, address: int) -> None: ... @property def content(self) -> memoryview: ... class HEADER_FLAGS: __members__: ClassVar[dict] = ... # read-only ALLMODSBOUND: ClassVar[HEADER_FLAGS] = ... ALLOW_STACK_EXECUTION: ClassVar[HEADER_FLAGS] = ... APP_EXTENSION_SAFE: ClassVar[HEADER_FLAGS] = ... BINDATLOAD: ClassVar[HEADER_FLAGS] = ... BINDS_TO_WEAK: ClassVar[HEADER_FLAGS] = ... CANONICAL: ClassVar[HEADER_FLAGS] = ... DEAD_STRIPPABLE_DYLIB: ClassVar[HEADER_FLAGS] = ... DYLDLINK: ClassVar[HEADER_FLAGS] = ... FORCE_FLAT: ClassVar[HEADER_FLAGS] = ... HAS_TLV_DESCRIPTORS: ClassVar[HEADER_FLAGS] = ... INCRLINK: ClassVar[HEADER_FLAGS] = ... LAZY_INIT: ClassVar[HEADER_FLAGS] = ... NOFIXPREBINDING: ClassVar[HEADER_FLAGS] = ... NOMULTIDEFS: ClassVar[HEADER_FLAGS] = ... NOUNDEFS: ClassVar[HEADER_FLAGS] = ... NO_HEAP_EXECUTION: ClassVar[HEADER_FLAGS] = ... NO_REEXPORTED_DYLIBS: ClassVar[HEADER_FLAGS] = ... PIE: ClassVar[HEADER_FLAGS] = ... PREBINDABLE: ClassVar[HEADER_FLAGS] = ... PREBOUND: ClassVar[HEADER_FLAGS] = ... ROOT_SAFE: ClassVar[HEADER_FLAGS] = ... SETUID_SAFE: ClassVar[HEADER_FLAGS] = ... SPLIT_SEGS: ClassVar[HEADER_FLAGS] = ... SUBSECTIONS_VIA_SYMBOLS: ClassVar[HEADER_FLAGS] = ... TWOLEVEL: ClassVar[HEADER_FLAGS] = ... WEAK_DEFINES: ClassVar[HEADER_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Header(lief.Object): cpu_subtype: int cpu_type: lief.MachO.CPU_TYPES file_type: lief.MachO.FILE_TYPES flags: Any magic: lief.MachO.MACHO_TYPES nb_cmds: int reserved: int sizeof_cmds: int def __init__(self) -> None: ... def add(self, flag: lief.MachO.HEADER_FLAGS) -> None: ... def has(self, flag: lief.MachO.HEADER_FLAGS) -> bool: ... def remove(self, flag: lief.MachO.HEADER_FLAGS) -> None: ... def __contains__(self, arg0: lief.MachO.HEADER_FLAGS) -> bool: ... def __iadd__(self, arg0: lief.MachO.HEADER_FLAGS) -> lief.MachO.Header: ... def __isub__(self, arg0: lief.MachO.HEADER_FLAGS) -> lief.MachO.Header: ... @property def flags_list(self) -> Set[lief.MachO.HEADER_FLAGS]: ... class LOAD_COMMAND_TYPES: __members__: ClassVar[dict] = ... # read-only BUILD_VERSION: ClassVar[LOAD_COMMAND_TYPES] = ... CODE_SIGNATURE: ClassVar[LOAD_COMMAND_TYPES] = ... DATA_IN_CODE: ClassVar[LOAD_COMMAND_TYPES] = ... DYLD_CHAINED_FIXUPS: ClassVar[LOAD_COMMAND_TYPES] = ... DYLD_ENVIRONMENT: ClassVar[LOAD_COMMAND_TYPES] = ... DYLD_EXPORTS_TRIE: ClassVar[LOAD_COMMAND_TYPES] = ... DYLD_INFO: ClassVar[LOAD_COMMAND_TYPES] = ... DYLD_INFO_ONLY: ClassVar[LOAD_COMMAND_TYPES] = ... DYLIB_CODE_SIGN_DRS: ClassVar[LOAD_COMMAND_TYPES] = ... DYSYMTAB: ClassVar[LOAD_COMMAND_TYPES] = ... ENCRYPTION_INFO: ClassVar[LOAD_COMMAND_TYPES] = ... ENCRYPTION_INFO_64: ClassVar[LOAD_COMMAND_TYPES] = ... FILESET_ENTRY: ClassVar[LOAD_COMMAND_TYPES] = ... FUNCTION_STARTS: ClassVar[LOAD_COMMAND_TYPES] = ... FVMFILE: ClassVar[LOAD_COMMAND_TYPES] = ... IDENT: ClassVar[LOAD_COMMAND_TYPES] = ... IDFVMLIB: ClassVar[LOAD_COMMAND_TYPES] = ... ID_DYLIB: ClassVar[LOAD_COMMAND_TYPES] = ... ID_DYLINKER: ClassVar[LOAD_COMMAND_TYPES] = ... LAZY_LOAD_DYLIB: ClassVar[LOAD_COMMAND_TYPES] = ... LINKER_OPTIMIZATION_HINT: ClassVar[LOAD_COMMAND_TYPES] = ... LINKER_OPTION: ClassVar[LOAD_COMMAND_TYPES] = ... LOADFVMLIB: ClassVar[LOAD_COMMAND_TYPES] = ... LOAD_DYLIB: ClassVar[LOAD_COMMAND_TYPES] = ... LOAD_DYLINKER: ClassVar[LOAD_COMMAND_TYPES] = ... LOAD_UPWARD_DYLIB: ClassVar[LOAD_COMMAND_TYPES] = ... LOAD_WEAK_DYLIB: ClassVar[LOAD_COMMAND_TYPES] = ... MAIN: ClassVar[LOAD_COMMAND_TYPES] = ... NOTE: ClassVar[LOAD_COMMAND_TYPES] = ... PREBIND_CKSUM: ClassVar[LOAD_COMMAND_TYPES] = ... PREBOUND_DYLIB: ClassVar[LOAD_COMMAND_TYPES] = ... PREPAGE: ClassVar[LOAD_COMMAND_TYPES] = ... REEXPORT_DYLIB: ClassVar[LOAD_COMMAND_TYPES] = ... ROUTINES: ClassVar[LOAD_COMMAND_TYPES] = ... ROUTINES_64: ClassVar[LOAD_COMMAND_TYPES] = ... RPATH: ClassVar[LOAD_COMMAND_TYPES] = ... SEGMENT: ClassVar[LOAD_COMMAND_TYPES] = ... SEGMENT_64: ClassVar[LOAD_COMMAND_TYPES] = ... SEGMENT_SPLIT_INFO: ClassVar[LOAD_COMMAND_TYPES] = ... SOURCE_VERSION: ClassVar[LOAD_COMMAND_TYPES] = ... SUB_CLIENT: ClassVar[LOAD_COMMAND_TYPES] = ... SUB_FRAMEWORK: ClassVar[LOAD_COMMAND_TYPES] = ... SUB_LIBRARY: ClassVar[LOAD_COMMAND_TYPES] = ... SUB_UMBRELLA: ClassVar[LOAD_COMMAND_TYPES] = ... SYMSEG: ClassVar[LOAD_COMMAND_TYPES] = ... SYMTAB: ClassVar[LOAD_COMMAND_TYPES] = ... THREAD: ClassVar[LOAD_COMMAND_TYPES] = ... TWOLEVEL_HINTS: ClassVar[LOAD_COMMAND_TYPES] = ... UNIXTHREAD: ClassVar[LOAD_COMMAND_TYPES] = ... UUID: ClassVar[LOAD_COMMAND_TYPES] = ... VERSION_MIN_IPHONEOS: ClassVar[LOAD_COMMAND_TYPES] = ... VERSION_MIN_MACOSX: ClassVar[LOAD_COMMAND_TYPES] = ... VERSION_MIN_TVOS: ClassVar[LOAD_COMMAND_TYPES] = ... VERSION_MIN_WATCHOS: ClassVar[LOAD_COMMAND_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class LinkerOptHint(LoadCommand): data_offset: int data_size: int def __init__(self, *args, **kwargs) -> None: ... @property def content(self) -> memoryview: ... class LoadCommand(lief.Object): command: lief.MachO.LOAD_COMMAND_TYPES command_offset: int data: List[int] size: int def __init__(self) -> None: ... class MACHO_TYPES: __members__: ClassVar[dict] = ... # read-only CIGAM: ClassVar[MACHO_TYPES] = ... CIGAM_64: ClassVar[MACHO_TYPES] = ... FAT_CIGAM: ClassVar[MACHO_TYPES] = ... FAT_MAGIC: ClassVar[MACHO_TYPES] = ... MAGIC: ClassVar[MACHO_TYPES] = ... MAGIC_64: ClassVar[MACHO_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class MainCommand(LoadCommand): entrypoint: int stack_size: int def __init__(self, *args, **kwargs) -> None: ... class PPC_RELOCATION: __members__: ClassVar[dict] = ... # read-only BR14: ClassVar[PPC_RELOCATION] = ... BR24: ClassVar[PPC_RELOCATION] = ... HA16: ClassVar[PPC_RELOCATION] = ... HA16_SECTDIFF: ClassVar[PPC_RELOCATION] = ... HI16: ClassVar[PPC_RELOCATION] = ... HI16_SECTDIFF: ClassVar[PPC_RELOCATION] = ... JBSR: ClassVar[PPC_RELOCATION] = ... LO14: ClassVar[PPC_RELOCATION] = ... LO14_SECTDIFF: ClassVar[PPC_RELOCATION] = ... LO16: ClassVar[PPC_RELOCATION] = ... LO16_SECTDIFF: ClassVar[PPC_RELOCATION] = ... LOCAL_SECTDIFF: ClassVar[PPC_RELOCATION] = ... PAIR: ClassVar[PPC_RELOCATION] = ... PB_LA_PTR: ClassVar[PPC_RELOCATION] = ... SECTDIFF: ClassVar[PPC_RELOCATION] = ... VANILLA: ClassVar[PPC_RELOCATION] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ParserConfig: deep: ClassVar[lief.MachO.ParserConfig] = ... # read-only quick: ClassVar[lief.MachO.ParserConfig] = ... # read-only fix_from_memory: bool parse_dyld_bindings: bool parse_dyld_exports: bool parse_dyld_rebases: bool def __init__(self) -> None: ... def full_dyldinfo(self, flag: bool) -> lief.MachO.ParserConfig: ... class REBASE_OPCODES: __members__: ClassVar[dict] = ... # read-only ADD_ADDR_IMM_SCALED: ClassVar[REBASE_OPCODES] = ... ADD_ADDR_ULEB: ClassVar[REBASE_OPCODES] = ... DONE: ClassVar[REBASE_OPCODES] = ... DO_REBASE_ADD_ADDR_ULEB: ClassVar[REBASE_OPCODES] = ... DO_REBASE_IMM_TIMES: ClassVar[REBASE_OPCODES] = ... DO_REBASE_ULEB_TIMES: ClassVar[REBASE_OPCODES] = ... DO_REBASE_ULEB_TIMES_SKIPPING_ULEB: ClassVar[REBASE_OPCODES] = ... SET_SEGMENT_AND_OFFSET_ULEB: ClassVar[REBASE_OPCODES] = ... SET_TYPE_IMM: ClassVar[REBASE_OPCODES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class REBASE_TYPES: __members__: ClassVar[dict] = ... # read-only POINTER: ClassVar[REBASE_TYPES] = ... TEXT_ABSOLUTE32: ClassVar[REBASE_TYPES] = ... TEXT_PCREL32: ClassVar[REBASE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RELOCATION_ORIGINS: __members__: ClassVar[dict] = ... # read-only CHAINED_FIXUPS: ClassVar[RELOCATION_ORIGINS] = ... DYLDINFO: ClassVar[RELOCATION_ORIGINS] = ... RELOC_TABLE: ClassVar[RELOCATION_ORIGINS] = ... UNKNOWN: ClassVar[RELOCATION_ORIGINS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RPathCommand(LoadCommand): path: str def __init__(self, *args, **kwargs) -> None: ... class Relocation(lief.Relocation): address: int pc_relative: bool type: int def __init__(self, *args, **kwargs) -> None: ... @property def architecture(self) -> lief.MachO.CPU_TYPES: ... @property def has_section(self) -> bool: ... @property def has_segment(self) -> bool: ... @property def has_symbol(self) -> bool: ... @property def origin(self) -> lief.MachO.RELOCATION_ORIGINS: ... @property def section(self) -> lief.MachO.Section: ... @property def segment(self) -> lief.MachO.SegmentCommand: ... @property def symbol(self) -> lief.MachO.Symbol: ... class RelocationDyld(Relocation): def __init__(self, *args, **kwargs) -> None: ... class RelocationFixup(Relocation): target: int def __init__(self, *args, **kwargs) -> None: ... class RelocationObject(Relocation): value: int def __init__(self, *args, **kwargs) -> None: ... @property def is_scattered(self) -> bool: ... class SECTION_FLAGS: __members__: ClassVar[dict] = ... # read-only DEBUG: ClassVar[SECTION_FLAGS] = ... EXT_RELOC: ClassVar[SECTION_FLAGS] = ... LIVE_SUPPORT: ClassVar[SECTION_FLAGS] = ... LOC_RELOC: ClassVar[SECTION_FLAGS] = ... NO_DEAD_STRIP: ClassVar[SECTION_FLAGS] = ... NO_TOC: ClassVar[SECTION_FLAGS] = ... PURE_INSTRUCTIONS: ClassVar[SECTION_FLAGS] = ... SELF_MODIFYING_CODE: ClassVar[SECTION_FLAGS] = ... SOME_INSTRUCTIONS: ClassVar[SECTION_FLAGS] = ... STRIP_STATIC_SYMS: ClassVar[SECTION_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SECTION_TYPES: __members__: ClassVar[dict] = ... # read-only COALESCED: ClassVar[SECTION_TYPES] = ... CSTRING_LITERALS: ClassVar[SECTION_TYPES] = ... DTRACE_DOF: ClassVar[SECTION_TYPES] = ... GB_ZEROFILL: ClassVar[SECTION_TYPES] = ... INTERPOSING: ClassVar[SECTION_TYPES] = ... LAZY_DYLIB_SYMBOL_POINTERS: ClassVar[SECTION_TYPES] = ... LAZY_SYMBOL_POINTERS: ClassVar[SECTION_TYPES] = ... LITERAL_POINTERS: ClassVar[SECTION_TYPES] = ... MOD_INIT_FUNC_POINTERS: ClassVar[SECTION_TYPES] = ... MOD_TERM_FUNC_POINTERS: ClassVar[SECTION_TYPES] = ... NON_LAZY_SYMBOL_POINTERS: ClassVar[SECTION_TYPES] = ... REGULAR: ClassVar[SECTION_TYPES] = ... SYMBOL_STUBS: ClassVar[SECTION_TYPES] = ... S_16BYTE_LITERALS: ClassVar[SECTION_TYPES] = ... S_4BYTE_LITERALS: ClassVar[SECTION_TYPES] = ... S_8BYTE_LITERALS: ClassVar[SECTION_TYPES] = ... THREAD_LOCAL_INIT_FUNCTION_POINTERS: ClassVar[SECTION_TYPES] = ... THREAD_LOCAL_REGULAR: ClassVar[SECTION_TYPES] = ... THREAD_LOCAL_VARIABLES: ClassVar[SECTION_TYPES] = ... THREAD_LOCAL_VARIABLE_POINTERS: ClassVar[SECTION_TYPES] = ... THREAD_LOCAL_ZEROFILL: ClassVar[SECTION_TYPES] = ... ZEROFILL: ClassVar[SECTION_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_ORIGINS: __members__: ClassVar[dict] = ... # read-only DYLD_EXPORT: ClassVar[SYMBOL_ORIGINS] = ... LC_SYMTAB: ClassVar[SYMBOL_ORIGINS] = ... UNKNOWN: ClassVar[SYMBOL_ORIGINS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Section(lief.Section): alignment: int flags: int numberof_relocations: int relocation_offset: int reserved1: int reserved2: int reserved3: int segment_name: str type: lief.MachO.SECTION_TYPES @overload def __init__(self) -> None: ... @overload def __init__(self, section_name: str) -> None: ... @overload def __init__(self, section_name: str, content: List[int]) -> None: ... def add(self, flag: lief.MachO.SECTION_FLAGS) -> None: ... def has(self, flag: lief.MachO.SECTION_FLAGS) -> bool: ... def remove(self, flag: lief.MachO.SECTION_FLAGS) -> None: ... def __contains__(self, arg0: lief.MachO.SECTION_FLAGS) -> bool: ... def __iadd__(self, arg0: lief.MachO.SECTION_FLAGS) -> lief.MachO.Section: ... def __isub__(self, arg0: lief.MachO.SECTION_FLAGS) -> lief.MachO.Section: ... @property def flags_list(self) -> Set[lief.MachO.SECTION_FLAGS]: ... @property def has_segment(self) -> bool: ... @property def relocations(self) -> lief.MachO.SegmentCommand.it_relocations: ... @property def segment(self) -> lief.MachO.SegmentCommand: ... class SegmentCommand(LoadCommand): class it_relocations: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Relocation: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.Relocation: ... class it_sections: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.Section: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.Section: ... content: memoryview file_offset: int file_size: int flags: int init_protection: int max_protection: int name: object numberof_sections: int virtual_address: int virtual_size: int @overload def __init__(self) -> None: ... @overload def __init__(self, arg0: str) -> None: ... @overload def __init__(self, arg0: str, arg1: List[int]) -> None: ... def add_section(self, section: lief.MachO.Section) -> lief.MachO.Section: ... def get_section(self, name: str) -> lief.MachO.Section: ... def has(self, section: lief.MachO.Section) -> bool: ... def has_section(self, section_name: str) -> bool: ... @property def index(self) -> int: ... @property def relocations(self) -> lief.MachO.SegmentCommand.it_relocations: ... @property def sections(self) -> lief.MachO.SegmentCommand.it_sections: ... class SegmentSplitInfo(LoadCommand): data_offset: int data_size: int def __init__(self, *args, **kwargs) -> None: ... @property def content(self) -> memoryview: ... class SourceVersion(LoadCommand): version: List[int] def __init__(self, *args, **kwargs) -> None: ... class SubFramework(LoadCommand): umbrella: str def __init__(self, *args, **kwargs) -> None: ... class Symbol(lief.Symbol): class TOOLS: __members__: ClassVar[dict] = ... # read-only EXTERNAL: ClassVar[Symbol.TOOLS] = ... INDIRECT_ABS: ClassVar[Symbol.TOOLS] = ... INDIRECT_LOCAL: ClassVar[Symbol.TOOLS] = ... LOCAL: ClassVar[Symbol.TOOLS] = ... NONE: ClassVar[Symbol.TOOLS] = ... UNDEFINED: ClassVar[Symbol.TOOLS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... description: int numberof_sections: int type: int def __init__(self) -> None: ... @property def binding_info(self) -> lief.MachO.BindingInfo: ... @property def demangled_name(self) -> str: ... @property def export_info(self) -> lief.MachO.ExportInfo: ... @property def has_binding_info(self) -> bool: ... @property def has_export_info(self) -> bool: ... @property def origin(self) -> lief.MachO.SYMBOL_ORIGINS: ... class SymbolCommand(LoadCommand): numberof_symbols: int strings_offset: int strings_size: int symbol_offset: int def __init__(self) -> None: ... class ThreadCommand(LoadCommand): architecture: lief.MachO.CPU_TYPES count: int flavor: int state: List[int] def __init__(self, *args, **kwargs) -> None: ... @property def pc(self) -> int: ... class TwoLevelHints(LoadCommand): def __init__(self, *args, **kwargs) -> None: ... @property def content(self) -> memoryview: ... @property def hints(self) -> Any: ... class UUIDCommand(LoadCommand): uuid: List[int] def __init__(self, *args, **kwargs) -> None: ... class VM_PROTECTIONS: __members__: ClassVar[dict] = ... # read-only EXECUTE: ClassVar[VM_PROTECTIONS] = ... READ: ClassVar[VM_PROTECTIONS] = ... WRITE: ClassVar[VM_PROTECTIONS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class VersionMin(LoadCommand): sdk: List[int] version: List[int] def __init__(self, *args, **kwargs) -> None: ... class X86_64_RELOCATION: __members__: ClassVar[dict] = ... # read-only BRANCH: ClassVar[X86_64_RELOCATION] = ... GOT: ClassVar[X86_64_RELOCATION] = ... GOT_LOAD: ClassVar[X86_64_RELOCATION] = ... SIGNED: ClassVar[X86_64_RELOCATION] = ... SIGNED_1: ClassVar[X86_64_RELOCATION] = ... SIGNED_2: ClassVar[X86_64_RELOCATION] = ... SIGNED_4: ClassVar[X86_64_RELOCATION] = ... SUBTRACTOR: ClassVar[X86_64_RELOCATION] = ... TLV: ClassVar[X86_64_RELOCATION] = ... UNSIGNED: ClassVar[X86_64_RELOCATION] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class X86_RELOCATION: __members__: ClassVar[dict] = ... # read-only LOCAL_SECTDIFF: ClassVar[X86_RELOCATION] = ... PAIR: ClassVar[X86_RELOCATION] = ... PB_LA_PTR: ClassVar[X86_RELOCATION] = ... SECTDIFF: ClassVar[X86_RELOCATION] = ... TLV: ClassVar[X86_RELOCATION] = ... VANILLA: ClassVar[X86_RELOCATION] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class it_data_in_code_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.MachO.DataCodeEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.MachO.DataCodeEntry: ... @overload def check_layout(file: lief.MachO.Binary) -> Tuple[bool,str]: ... @overload def check_layout(file: lief.MachO.FatBinary) -> Tuple[bool,str]: ... def is_64(file: str) -> bool: ... def is_fat(file: str) -> bool: ... @overload def is_macho(filename: str) -> bool: ... @overload def is_macho(raw: List[int]) -> bool: ... @overload def parse(filename: str, config: lief.MachO.ParserConfig = ...) -> lief.MachO.Binary | None: ... @overload def parse(raw: List[int], name: str = ..., config: lief.MachO.ParserConfig = ...) -> lief.MachO.Binary | None: ... @overload def parse(io: object, name: str = ..., config: lief.MachO.ParserConfig = ...) -> lief.MachO.Binary | None: ... def parse_from_memory(address: int, config: lief.MachO.ParserConfig = ...) -> lief.MachO.FatBinary: ... LIEF-0.13.1/api/python/lief/OAT.pyi000066400000000000000000000221241443457337100165060ustar00rootroot00000000000000from typing import Any, ClassVar, Iterator, List from typing import overload import lief # type: ignore import lief.Android # type: ignore import lief.DEX # type: ignore import lief.ELF # type: ignore import lief.OAT # type: ignore class Binary(lief.ELF.Binary): class it_classes: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.OAT.Class: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.OAT.Class: ... class it_dex_files: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.DEX.File: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.DEX.File: ... class it_methods: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.OAT.Method: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.OAT.Method: ... class it_oat_dex_files: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.OAT.DexFile: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.OAT.DexFile: ... def __init__(self, *args, **kwargs) -> None: ... @overload def get_class(self, class_name: str) -> lief.OAT.Class: ... @overload def get_class(self, class_index: int) -> lief.OAT.Class: ... @property def classes(self) -> lief.OAT.Binary.it_classes: ... @property def dex2dex_json_info(self) -> str: ... @property def dex_files(self) -> lief.OAT.Binary.it_dex_files: ... @property def has_class(self) -> bool: ... @property def header(self) -> Any: ... @property def methods(self) -> lief.OAT.Binary.it_methods: ... @property def oat_dex_files(self) -> lief.OAT.Binary.it_oat_dex_files: ... class Class(lief.Object): class it_methods: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.OAT.Method: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.OAT.Method: ... def __init__(self) -> None: ... def has_dex_class(self) -> bool: ... @overload def is_quickened(self, dex_method: lief.DEX.Method) -> bool: ... @overload def is_quickened(self, method_index: int) -> bool: ... @overload def method_offsets_index(self, arg0: lief.DEX.Method) -> int: ... @overload def method_offsets_index(self, arg0: int) -> int: ... @property def bitmap(self) -> List[int]: ... @property def fullname(self) -> str: ... @property def index(self) -> int: ... @property def methods(self) -> lief.OAT.Class.it_methods: ... @property def status(self) -> lief.OAT.OAT_CLASS_STATUS: ... @property def type(self) -> lief.OAT.OAT_CLASS_TYPES: ... class DexFile(lief.Object): checksum: int dex_offset: int location: str def __init__(self) -> None: ... @property def dex_file(self) -> lief.DEX.File: ... @property def has_dex_file(self) -> bool: ... class HEADER_KEYS: __members__: ClassVar[dict] = ... # read-only BOOT_CLASS_PATH: ClassVar[HEADER_KEYS] = ... CLASS_PATH: ClassVar[HEADER_KEYS] = ... COMPILER_FILTER: ClassVar[HEADER_KEYS] = ... CONCURRENT_COPYING: ClassVar[HEADER_KEYS] = ... DEBUGGABLE: ClassVar[HEADER_KEYS] = ... DEX2OAT_CMD_LINE: ClassVar[HEADER_KEYS] = ... DEX2OAT_HOST: ClassVar[HEADER_KEYS] = ... HAS_PATCH_INFO: ClassVar[HEADER_KEYS] = ... IMAGE_LOCATION: ClassVar[HEADER_KEYS] = ... NATIVE_DEBUGGABLE: ClassVar[HEADER_KEYS] = ... PIC: ClassVar[HEADER_KEYS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Header(lief.Object): class it_key_values_t: class value_type: value: str def __init__(self, *args, **kwargs) -> None: ... @property def key(self) -> lief.OAT.HEADER_KEYS: ... def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.OAT.Header.it_key_values_t.value_type: ... def __iter__(self) -> lief.OAT.Header.it_key_values_t: ... def __len__(self) -> int: ... def __next__(self) -> lief.OAT.Header.it_key_values_t.value_type: ... def __init__(self) -> None: ... def get(self, key: lief.OAT.HEADER_KEYS) -> str: ... def set(self, key: lief.OAT.HEADER_KEYS, value: str) -> Any: ... def __getitem__(self, arg0: lief.OAT.HEADER_KEYS) -> str: ... def __setitem__(self, arg0: lief.OAT.HEADER_KEYS, arg1: str) -> Any: ... @property def checksum(self) -> int: ... @property def executable_offset(self) -> int: ... @property def i2c_code_bridge_offset(self) -> int: ... @property def i2i_bridge_offset(self) -> int: ... @property def image_file_location_oat_checksum(self) -> int: ... @property def image_file_location_oat_data_begin(self) -> int: ... @property def image_patch_delta(self) -> int: ... @property def instruction_set(self) -> lief.OAT.INSTRUCTION_SETS: ... @property def jni_dlsym_lookup_offset(self) -> int: ... @property def key_value_size(self) -> int: ... @property def key_values(self) -> lief.OAT.Header.it_key_values_t: ... @property def keys(self) -> List[lief.OAT.HEADER_KEYS]: ... @property def magic(self) -> List[int]: ... @property def nb_dex_files(self) -> int: ... @property def oat_dex_files_offset(self) -> int: ... @property def quick_generic_jni_trampoline_offset(self) -> int: ... @property def quick_imt_conflict_trampoline_offset(self) -> int: ... @property def quick_resolution_trampoline_offset(self) -> int: ... @property def quick_to_interpreter_bridge_offset(self) -> int: ... @property def values(self) -> List[str]: ... @property def version(self) -> int: ... class INSTRUCTION_SETS: __members__: ClassVar[dict] = ... # read-only ARM: ClassVar[INSTRUCTION_SETS] = ... ARM_64: ClassVar[INSTRUCTION_SETS] = ... MIPS: ClassVar[INSTRUCTION_SETS] = ... MIPS_64: ClassVar[INSTRUCTION_SETS] = ... NONE: ClassVar[INSTRUCTION_SETS] = ... THUMB2: ClassVar[INSTRUCTION_SETS] = ... X86: ClassVar[INSTRUCTION_SETS] = ... X86_64: ClassVar[INSTRUCTION_SETS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Method(lief.Object): quick_code: List[int] def __init__(self) -> None: ... @property def dex_method(self) -> lief.DEX.Method: ... @property def has_dex_method(self) -> bool: ... @property def is_compiled(self) -> bool: ... @property def is_dex2dex_optimized(self) -> bool: ... @property def name(self) -> str: ... @property def oat_class(self) -> lief.OAT.Class: ... class OAT_CLASS_STATUS: __members__: ClassVar[dict] = ... # read-only ERROR: ClassVar[OAT_CLASS_STATUS] = ... IDX: ClassVar[OAT_CLASS_STATUS] = ... INITIALIZED: ClassVar[OAT_CLASS_STATUS] = ... INITIALIZING: ClassVar[OAT_CLASS_STATUS] = ... LOADED: ClassVar[OAT_CLASS_STATUS] = ... NOTREADY: ClassVar[OAT_CLASS_STATUS] = ... RESOLVED: ClassVar[OAT_CLASS_STATUS] = ... RESOLVING: ClassVar[OAT_CLASS_STATUS] = ... RETIRED: ClassVar[OAT_CLASS_STATUS] = ... VERIFICATION_AT_RUNTIME: ClassVar[OAT_CLASS_STATUS] = ... VERIFIED: ClassVar[OAT_CLASS_STATUS] = ... VERIFYING: ClassVar[OAT_CLASS_STATUS] = ... VERIFYING_AT_RUNTIME: ClassVar[OAT_CLASS_STATUS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class OAT_CLASS_TYPES: __members__: ClassVar[dict] = ... # read-only ALL_COMPILED: ClassVar[OAT_CLASS_TYPES] = ... NONE_COMPILED: ClassVar[OAT_CLASS_TYPES] = ... SOME_COMPILED: ClassVar[OAT_CLASS_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def android_version(arg0: int) -> lief.Android.ANDROID_VERSIONS: ... @overload def is_oat(binary: lief.ELF.Binary) -> bool: ... @overload def is_oat(path: str) -> bool: ... @overload def is_oat(raw: List[int]) -> bool: ... @overload def parse(oat_file: str) -> lief.OAT.Binary: ... @overload def parse(oat_file: str, vdex_file: str) -> lief.OAT.Binary: ... @overload def parse(raw: List[int], name: str = ...) -> lief.OAT.Binary: ... @overload def parse(io: object, name: str = ...) -> lief.OAT.Binary: ... @overload def version(binary: lief.ELF.Binary) -> int: ... @overload def version(file: str) -> int: ... @overload def version(raw: List[int]) -> int: ... LIEF-0.13.1/api/python/lief/PE.pyi000066400000000000000000003162361443457337100164010ustar00rootroot00000000000000from typing import Any, ClassVar, Iterable, Iterator, List, Set, Tuple from typing import overload import lief # type: ignore import lief.PE # type: ignore class ACCELERATOR_FLAGS: __members__: ClassVar[dict] = ... # read-only END: ClassVar[ACCELERATOR_FLAGS] = ... FALT: ClassVar[ACCELERATOR_FLAGS] = ... FCONTROL: ClassVar[ACCELERATOR_FLAGS] = ... FNOINVERT: ClassVar[ACCELERATOR_FLAGS] = ... FSHIFT: ClassVar[ACCELERATOR_FLAGS] = ... FVIRTKEY: ClassVar[ACCELERATOR_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ACCELERATOR_VK_CODES: __members__: ClassVar[dict] = ... # read-only VK_0: ClassVar[ACCELERATOR_VK_CODES] = ... VK_1: ClassVar[ACCELERATOR_VK_CODES] = ... VK_2: ClassVar[ACCELERATOR_VK_CODES] = ... VK_3: ClassVar[ACCELERATOR_VK_CODES] = ... VK_4: ClassVar[ACCELERATOR_VK_CODES] = ... VK_5: ClassVar[ACCELERATOR_VK_CODES] = ... VK_6: ClassVar[ACCELERATOR_VK_CODES] = ... VK_7: ClassVar[ACCELERATOR_VK_CODES] = ... VK_8: ClassVar[ACCELERATOR_VK_CODES] = ... VK_9: ClassVar[ACCELERATOR_VK_CODES] = ... VK_A: ClassVar[ACCELERATOR_VK_CODES] = ... VK_ACCEPT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_ADD: ClassVar[ACCELERATOR_VK_CODES] = ... VK_APPS: ClassVar[ACCELERATOR_VK_CODES] = ... VK_ATTN: ClassVar[ACCELERATOR_VK_CODES] = ... VK_B: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BACK: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BROWSER_BACK: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BROWSER_FAVORITES: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BROWSER_FORWARD: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BROWSER_HOME: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BROWSER_REFRESH: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BROWSER_SEARCH: ClassVar[ACCELERATOR_VK_CODES] = ... VK_BROWSER_STOP: ClassVar[ACCELERATOR_VK_CODES] = ... VK_C: ClassVar[ACCELERATOR_VK_CODES] = ... VK_CANCEL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_CAPITAL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_CLEAR: ClassVar[ACCELERATOR_VK_CODES] = ... VK_CONTROL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_CONVERT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_CRSEL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_D: ClassVar[ACCELERATOR_VK_CODES] = ... VK_DECIMAL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_DELETE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_DIVIDE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_DOWN: ClassVar[ACCELERATOR_VK_CODES] = ... VK_E: ClassVar[ACCELERATOR_VK_CODES] = ... VK_END: ClassVar[ACCELERATOR_VK_CODES] = ... VK_EREOF: ClassVar[ACCELERATOR_VK_CODES] = ... VK_ESCAPE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_EXECUTE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_EXSEL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F1: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F10: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F11: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F12: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F13: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F14: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F15: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F16: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F17: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F18: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F19: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F2: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F20: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F21: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F22: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F23: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F24: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F3: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F4: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F5: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F6: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F7: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F8: ClassVar[ACCELERATOR_VK_CODES] = ... VK_F9: ClassVar[ACCELERATOR_VK_CODES] = ... VK_FINAL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_G: ClassVar[ACCELERATOR_VK_CODES] = ... VK_H: ClassVar[ACCELERATOR_VK_CODES] = ... VK_HANGUEL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_HANGUL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_HANJA: ClassVar[ACCELERATOR_VK_CODES] = ... VK_HELP: ClassVar[ACCELERATOR_VK_CODES] = ... VK_HOME: ClassVar[ACCELERATOR_VK_CODES] = ... VK_I: ClassVar[ACCELERATOR_VK_CODES] = ... VK_IME_OFF: ClassVar[ACCELERATOR_VK_CODES] = ... VK_IME_ON: ClassVar[ACCELERATOR_VK_CODES] = ... VK_INSERT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_J: ClassVar[ACCELERATOR_VK_CODES] = ... VK_JUNJA: ClassVar[ACCELERATOR_VK_CODES] = ... VK_K: ClassVar[ACCELERATOR_VK_CODES] = ... VK_KANA: ClassVar[ACCELERATOR_VK_CODES] = ... VK_KANJI: ClassVar[ACCELERATOR_VK_CODES] = ... VK_L: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LAUNCH_APP1: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LAUNCH_APP2: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LAUNCH_MAIL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LAUNCH_MEDIA_SELECT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LBUTTON: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LCONTROL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LEFT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LMENU: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LSHIFT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_LWIN: ClassVar[ACCELERATOR_VK_CODES] = ... VK_M: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MBUTTON: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MEDIA_NEXT_TRACK: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MEDIA_PLAY_PAUSE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MEDIA_PREV_TRACK: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MEDIA_STOP: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MENU: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MODECHANGE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_MULTIPLY: ClassVar[ACCELERATOR_VK_CODES] = ... VK_N: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NEXT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NONAME: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NONCONVERT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMLOCK: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD0: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD1: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD2: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD3: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD4: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD5: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD6: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD7: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD8: ClassVar[ACCELERATOR_VK_CODES] = ... VK_NUMPAD9: ClassVar[ACCELERATOR_VK_CODES] = ... VK_O: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_1: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_102: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_2: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_4: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_5: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_6: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_7: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_8: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_CLEAR: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_COMMA: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_MINUS: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_PERIOD: ClassVar[ACCELERATOR_VK_CODES] = ... VK_OEM_PLUS: ClassVar[ACCELERATOR_VK_CODES] = ... VK_P: ClassVar[ACCELERATOR_VK_CODES] = ... VK_PA1: ClassVar[ACCELERATOR_VK_CODES] = ... VK_PACKET: ClassVar[ACCELERATOR_VK_CODES] = ... VK_PAUSE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_PLAY: ClassVar[ACCELERATOR_VK_CODES] = ... VK_PRINT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_PRIOR: ClassVar[ACCELERATOR_VK_CODES] = ... VK_PROCESSKEY: ClassVar[ACCELERATOR_VK_CODES] = ... VK_Q: ClassVar[ACCELERATOR_VK_CODES] = ... VK_R: ClassVar[ACCELERATOR_VK_CODES] = ... VK_RBUTTON: ClassVar[ACCELERATOR_VK_CODES] = ... VK_RCONTROL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_RETURN: ClassVar[ACCELERATOR_VK_CODES] = ... VK_RIGHT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_RMENU: ClassVar[ACCELERATOR_VK_CODES] = ... VK_RSHIFT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_RWIN: ClassVar[ACCELERATOR_VK_CODES] = ... VK_S: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SCROLL: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SELECT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SEPARATOR: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SHIFT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SLEEP: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SNAPSHOT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SPACE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_SUBTRACT: ClassVar[ACCELERATOR_VK_CODES] = ... VK_T: ClassVar[ACCELERATOR_VK_CODES] = ... VK_TAB: ClassVar[ACCELERATOR_VK_CODES] = ... VK_U: ClassVar[ACCELERATOR_VK_CODES] = ... VK_UP: ClassVar[ACCELERATOR_VK_CODES] = ... VK_V: ClassVar[ACCELERATOR_VK_CODES] = ... VK_VOLUME_DOWN: ClassVar[ACCELERATOR_VK_CODES] = ... VK_VOLUME_MUTE: ClassVar[ACCELERATOR_VK_CODES] = ... VK_VOLUME_UP: ClassVar[ACCELERATOR_VK_CODES] = ... VK_W: ClassVar[ACCELERATOR_VK_CODES] = ... VK_X: ClassVar[ACCELERATOR_VK_CODES] = ... VK_XBUTTON1: ClassVar[ACCELERATOR_VK_CODES] = ... VK_XBUTTON2: ClassVar[ACCELERATOR_VK_CODES] = ... VK_Y: ClassVar[ACCELERATOR_VK_CODES] = ... VK_Z: ClassVar[ACCELERATOR_VK_CODES] = ... VK_ZOOM: ClassVar[ACCELERATOR_VK_CODES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ALGORITHMS: __members__: ClassVar[dict] = ... # read-only EC: ClassVar[ALGORITHMS] = ... MD2: ClassVar[ALGORITHMS] = ... MD4: ClassVar[ALGORITHMS] = ... MD5: ClassVar[ALGORITHMS] = ... MD5_RSA: ClassVar[ALGORITHMS] = ... RSA: ClassVar[ALGORITHMS] = ... SHA1_DSA: ClassVar[ALGORITHMS] = ... SHA1_ECDSA: ClassVar[ALGORITHMS] = ... SHA1_RSA: ClassVar[ALGORITHMS] = ... SHA_1: ClassVar[ALGORITHMS] = ... SHA_256: ClassVar[ALGORITHMS] = ... SHA_256_ECDSA: ClassVar[ALGORITHMS] = ... SHA_256_RSA: ClassVar[ALGORITHMS] = ... SHA_384: ClassVar[ALGORITHMS] = ... SHA_384_ECDSA: ClassVar[ALGORITHMS] = ... SHA_384_RSA: ClassVar[ALGORITHMS] = ... SHA_512: ClassVar[ALGORITHMS] = ... SHA_512_ECDSA: ClassVar[ALGORITHMS] = ... SHA_512_RSA: ClassVar[ALGORITHMS] = ... UNKNOWN: ClassVar[ALGORITHMS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Attribute(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def type(self) -> lief.PE.SIG_ATTRIBUTE_TYPES: ... class Binary(lief.Binary): class it_const_signatures: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.Signature: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.Signature: ... class it_data_directories: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.DataDirectory: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.DataDirectory: ... class it_delay_imports: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.DelayImport: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.DelayImport: ... class it_imports: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.Import: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.Import: ... class it_relocations: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.Relocation: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.Relocation: ... class it_section: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.Section: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.Section: ... class it_symbols: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.Symbol: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.Symbol: ... dos_stub: memoryview rich_header: lief.PE.RichHeader tls: lief.PE.TLS def __init__(self, name: str, type: lief.PE.PE_TYPE) -> None: ... def add_import_function(self, import_name: str, function_name: str) -> lief.PE.ImportEntry: ... def add_library(self, import_name: str) -> lief.PE.Import: ... def add_relocation(self, relocation: lief.PE.Relocation) -> lief.PE.Relocation: ... def add_section(self, section: lief.PE.Section, type: lief.PE.SECTION_TYPES = ...) -> lief.PE.Section: ... def authentihash(self, algorithm: lief.PE.ALGORITHMS) -> bytes: ... def data_directory(self, type: lief.PE.DATA_DIRECTORY) -> lief.PE.DataDirectory: ... def get_delay_import(self, import_name: str) -> lief.PE.DelayImport: ... def get_export(self) -> lief.PE.Export: ... def get_import(self, import_name: str) -> lief.PE.Import: ... def get_section(self, section_name: str) -> lief.PE.Section: ... def has_delay_import(self, import_name: str) -> bool: ... def has_import(self, import_name: str) -> bool: ... def predict_function_rva(self, library: str, function: str) -> int: ... def remove(self, section: lief.PE.Section, clear: bool = ...) -> None: ... def remove_all_libraries(self) -> None: ... def remove_all_relocations(self) -> None: ... def remove_library(self, import_name: str) -> None: ... def rva_to_offset(self, rva_address: int) -> int: ... def section_from_offset(self, offset: int) -> lief.PE.Section: ... def section_from_rva(self, rva: int) -> lief.PE.Section: ... def va_to_offset(self, va_address: int) -> int: ... @overload def verify_signature(self, checks: lief.PE.Signature.VERIFICATION_CHECKS = ...) -> lief.PE.Signature.VERIFICATION_FLAGS: ... @overload def verify_signature(self, signature: lief.PE.Signature, checks: lief.PE.Signature.VERIFICATION_CHECKS = ...) -> lief.PE.Signature.VERIFICATION_FLAGS: ... @overload def verify_signature(self, detached) -> lief.PE.Signature.VERIFICATION_FLAGS: ... def write(self, output_path: str) -> None: ... @property def authentihash_md5(self) -> bytes: ... @property def authentihash_sha1(self) -> bytes: ... @property def authentihash_sha256(self) -> bytes: ... @property def authentihash_sha512(self) -> bytes: ... @property def data_directories(self) -> lief.PE.Binary.it_data_directories: ... @property def debug(self) -> List[lief.PE.Debug]: ... @property def delay_imports(self) -> lief.PE.Binary.it_delay_imports: ... @property def dos_header(self) -> lief.PE.DosHeader: ... @property def exception_functions(self) -> List[lief.Function]: ... @property def functions(self) -> List[lief.Function]: ... @property def has_configuration(self) -> bool: ... @property def has_debug(self) -> bool: ... @property def has_delay_imports(self) -> bool: ... @property def has_exceptions(self) -> bool: ... @property def has_exports(self) -> bool: ... @property def has_imports(self) -> bool: ... @property def has_relocations(self) -> bool: ... @property def has_resources(self) -> bool: ... @property def has_rich_header(self) -> bool: ... @property def has_signatures(self) -> bool: ... @property def has_tls(self) -> bool: ... @property def header(self) -> lief.PE.Header: ... @property def imports(self) -> lief.PE.Binary.it_imports: ... @property def is_reproducible_build(self) -> bool: ... @property def load_configuration(self) -> lief.PE.LoadConfiguration: ... @property def optional_header(self) -> lief.PE.OptionalHeader: ... @property def overlay(self) -> memoryview: ... @property def relocations(self) -> lief.PE.Binary.it_relocations: ... @property def resources(self) -> lief.PE.ResourceNode: ... @property def resources_manager(self) -> object: ... @property def sections(self) -> lief.PE.Binary.it_section: ... @property def signatures(self) -> lief.PE.Binary.it_const_signatures: ... @property def sizeof_headers(self) -> int: ... @property def symbols(self) -> List[lief.PE.Symbol]: ... @property def virtual_size(self) -> int: ... class Builder: def __init__(self, pe_binary: lief.PE.Binary) -> None: ... def build(self) -> object: ... def build_dos_stub(self, enable: bool = ...) -> lief.PE.Builder: ... def build_imports(self, enable: bool = ...) -> lief.PE.Builder: ... def build_overlay(self, enable: bool = ...) -> lief.PE.Builder: ... def build_relocations(self, enable: bool = ...) -> lief.PE.Builder: ... def build_resources(self, enable: bool = ...) -> lief.PE.Builder: ... def build_tls(self, enable: bool = ...) -> lief.PE.Builder: ... def get_build(self) -> List[int]: ... def patch_imports(self, enable: bool = ...) -> lief.PE.Builder: ... def write(self, output: str) -> None: ... class CODE_PAGES: __members__: ClassVar[dict] = ... # read-only ASMO_708: ClassVar[CODE_PAGES] = ... BIG5: ClassVar[CODE_PAGES] = ... CP1025: ClassVar[CODE_PAGES] = ... CP866: ClassVar[CODE_PAGES] = ... CP875: ClassVar[CODE_PAGES] = ... CSISO2022JP: ClassVar[CODE_PAGES] = ... DOS_720: ClassVar[CODE_PAGES] = ... DOS_862: ClassVar[CODE_PAGES] = ... EUC_CN: ClassVar[CODE_PAGES] = ... EUC_JP: ClassVar[CODE_PAGES] = ... EUC_JP_JIS: ClassVar[CODE_PAGES] = ... EUC_KR: ClassVar[CODE_PAGES] = ... GB18030: ClassVar[CODE_PAGES] = ... GB2312: ClassVar[CODE_PAGES] = ... HZ_GB_2312: ClassVar[CODE_PAGES] = ... IBM00858: ClassVar[CODE_PAGES] = ... IBM00924: ClassVar[CODE_PAGES] = ... IBM01047: ClassVar[CODE_PAGES] = ... IBM01140: ClassVar[CODE_PAGES] = ... IBM01141: ClassVar[CODE_PAGES] = ... IBM01142: ClassVar[CODE_PAGES] = ... IBM01143: ClassVar[CODE_PAGES] = ... IBM01144: ClassVar[CODE_PAGES] = ... IBM01145: ClassVar[CODE_PAGES] = ... IBM01146: ClassVar[CODE_PAGES] = ... IBM01147: ClassVar[CODE_PAGES] = ... IBM01148: ClassVar[CODE_PAGES] = ... IBM01149: ClassVar[CODE_PAGES] = ... IBM037: ClassVar[CODE_PAGES] = ... IBM1026: ClassVar[CODE_PAGES] = ... IBM273: ClassVar[CODE_PAGES] = ... IBM277: ClassVar[CODE_PAGES] = ... IBM278: ClassVar[CODE_PAGES] = ... IBM280: ClassVar[CODE_PAGES] = ... IBM284: ClassVar[CODE_PAGES] = ... IBM285: ClassVar[CODE_PAGES] = ... IBM290: ClassVar[CODE_PAGES] = ... IBM297: ClassVar[CODE_PAGES] = ... IBM420: ClassVar[CODE_PAGES] = ... IBM423: ClassVar[CODE_PAGES] = ... IBM424: ClassVar[CODE_PAGES] = ... IBM437: ClassVar[CODE_PAGES] = ... IBM500: ClassVar[CODE_PAGES] = ... IBM737: ClassVar[CODE_PAGES] = ... IBM775: ClassVar[CODE_PAGES] = ... IBM850: ClassVar[CODE_PAGES] = ... IBM852: ClassVar[CODE_PAGES] = ... IBM855: ClassVar[CODE_PAGES] = ... IBM857: ClassVar[CODE_PAGES] = ... IBM860: ClassVar[CODE_PAGES] = ... IBM861: ClassVar[CODE_PAGES] = ... IBM863: ClassVar[CODE_PAGES] = ... IBM864: ClassVar[CODE_PAGES] = ... IBM865: ClassVar[CODE_PAGES] = ... IBM869: ClassVar[CODE_PAGES] = ... IBM870: ClassVar[CODE_PAGES] = ... IBM871: ClassVar[CODE_PAGES] = ... IBM880: ClassVar[CODE_PAGES] = ... IBM905: ClassVar[CODE_PAGES] = ... IBM_THAI: ClassVar[CODE_PAGES] = ... ISO_2022_JP: ClassVar[CODE_PAGES] = ... ISO_2022_JP_JIS: ClassVar[CODE_PAGES] = ... ISO_2022_KR: ClassVar[CODE_PAGES] = ... ISO_8859_1: ClassVar[CODE_PAGES] = ... ISO_8859_13: ClassVar[CODE_PAGES] = ... ISO_8859_15: ClassVar[CODE_PAGES] = ... ISO_8859_2: ClassVar[CODE_PAGES] = ... ISO_8859_3: ClassVar[CODE_PAGES] = ... ISO_8859_4: ClassVar[CODE_PAGES] = ... ISO_8859_5: ClassVar[CODE_PAGES] = ... ISO_8859_6: ClassVar[CODE_PAGES] = ... ISO_8859_7: ClassVar[CODE_PAGES] = ... ISO_8859_8: ClassVar[CODE_PAGES] = ... ISO_8859_8_I: ClassVar[CODE_PAGES] = ... ISO_8859_9: ClassVar[CODE_PAGES] = ... JOHAB: ClassVar[CODE_PAGES] = ... KOI8_R: ClassVar[CODE_PAGES] = ... KOI8_U: ClassVar[CODE_PAGES] = ... KS_C_5601_1987: ClassVar[CODE_PAGES] = ... MACINTOSH: ClassVar[CODE_PAGES] = ... SHIFT_JIS: ClassVar[CODE_PAGES] = ... UNICODEFFFE: ClassVar[CODE_PAGES] = ... US_ASCII: ClassVar[CODE_PAGES] = ... UTF_16: ClassVar[CODE_PAGES] = ... UTF_32: ClassVar[CODE_PAGES] = ... UTF_32BE: ClassVar[CODE_PAGES] = ... UTF_7: ClassVar[CODE_PAGES] = ... UTF_8: ClassVar[CODE_PAGES] = ... WINDOWS_1250: ClassVar[CODE_PAGES] = ... WINDOWS_1251: ClassVar[CODE_PAGES] = ... WINDOWS_1252: ClassVar[CODE_PAGES] = ... WINDOWS_1253: ClassVar[CODE_PAGES] = ... WINDOWS_1254: ClassVar[CODE_PAGES] = ... WINDOWS_1255: ClassVar[CODE_PAGES] = ... WINDOWS_1256: ClassVar[CODE_PAGES] = ... WINDOWS_1257: ClassVar[CODE_PAGES] = ... WINDOWS_1258: ClassVar[CODE_PAGES] = ... WINDOWS_874: ClassVar[CODE_PAGES] = ... X_CHINESE_CNS: ClassVar[CODE_PAGES] = ... X_CHINESE_ETEN: ClassVar[CODE_PAGES] = ... X_CP20001: ClassVar[CODE_PAGES] = ... X_CP20003: ClassVar[CODE_PAGES] = ... X_CP20004: ClassVar[CODE_PAGES] = ... X_CP20005: ClassVar[CODE_PAGES] = ... X_CP20261: ClassVar[CODE_PAGES] = ... X_CP20269: ClassVar[CODE_PAGES] = ... X_CP20936: ClassVar[CODE_PAGES] = ... X_CP20949: ClassVar[CODE_PAGES] = ... X_CP50227: ClassVar[CODE_PAGES] = ... X_EBCDIC_KOREANEXTENDED: ClassVar[CODE_PAGES] = ... X_EUROPA: ClassVar[CODE_PAGES] = ... X_IA5: ClassVar[CODE_PAGES] = ... X_IA5_GERMAN: ClassVar[CODE_PAGES] = ... X_IA5_NORWEGIAN: ClassVar[CODE_PAGES] = ... X_IA5_SWEDISH: ClassVar[CODE_PAGES] = ... X_ISCII_AS: ClassVar[CODE_PAGES] = ... X_ISCII_BE: ClassVar[CODE_PAGES] = ... X_ISCII_DE: ClassVar[CODE_PAGES] = ... X_ISCII_GU: ClassVar[CODE_PAGES] = ... X_ISCII_KA: ClassVar[CODE_PAGES] = ... X_ISCII_MA: ClassVar[CODE_PAGES] = ... X_ISCII_OR: ClassVar[CODE_PAGES] = ... X_ISCII_PA: ClassVar[CODE_PAGES] = ... X_ISCII_TA: ClassVar[CODE_PAGES] = ... X_ISCII_TE: ClassVar[CODE_PAGES] = ... X_MAC_ARABIC: ClassVar[CODE_PAGES] = ... X_MAC_CE: ClassVar[CODE_PAGES] = ... X_MAC_CHINESESIMP: ClassVar[CODE_PAGES] = ... X_MAC_CHINESETRAD: ClassVar[CODE_PAGES] = ... X_MAC_CROATIAN: ClassVar[CODE_PAGES] = ... X_MAC_CYRILLIC: ClassVar[CODE_PAGES] = ... X_MAC_GREEK: ClassVar[CODE_PAGES] = ... X_MAC_HEBREW: ClassVar[CODE_PAGES] = ... X_MAC_ICELANDIC: ClassVar[CODE_PAGES] = ... X_MAC_JAPANESE: ClassVar[CODE_PAGES] = ... X_MAC_KOREAN: ClassVar[CODE_PAGES] = ... X_MAC_ROMANIAN: ClassVar[CODE_PAGES] = ... X_MAC_THAI: ClassVar[CODE_PAGES] = ... X_MAC_TURKISH: ClassVar[CODE_PAGES] = ... X_MAC_UKRAINIAN: ClassVar[CODE_PAGES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class CODE_VIEW_SIGNATURES: __members__: ClassVar[dict] = ... # read-only CV_41: ClassVar[CODE_VIEW_SIGNATURES] = ... CV_50: ClassVar[CODE_VIEW_SIGNATURES] = ... PDB_20: ClassVar[CODE_VIEW_SIGNATURES] = ... PDB_70: ClassVar[CODE_VIEW_SIGNATURES] = ... UNKNOWN: ClassVar[CODE_VIEW_SIGNATURES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class CodeIntegrity(lief.Object): catalog: int catalog_offset: int flags: int reserved: int def __init__(self) -> None: ... class CodeView(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def cv_signature(self) -> lief.PE.CODE_VIEW_SIGNATURES: ... class CodeViewPDB(CodeView): age: int filename: str signature: List[int] def __init__(self) -> None: ... class ContentInfo(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def content_type(self) -> str: ... @property def digest(self) -> bytes: ... @property def digest_algorithm(self) -> lief.PE.ALGORITHMS: ... class ContentType(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def oid(self) -> str: ... class DATA_DIRECTORY: __members__: ClassVar[dict] = ... # read-only ARCHITECTURE: ClassVar[DATA_DIRECTORY] = ... BASE_RELOCATION_TABLE: ClassVar[DATA_DIRECTORY] = ... BOUND_IMPORT: ClassVar[DATA_DIRECTORY] = ... CERTIFICATE_TABLE: ClassVar[DATA_DIRECTORY] = ... CLR_RUNTIME_HEADER: ClassVar[DATA_DIRECTORY] = ... DEBUG: ClassVar[DATA_DIRECTORY] = ... DELAY_IMPORT_DESCRIPTOR: ClassVar[DATA_DIRECTORY] = ... EXCEPTION_TABLE: ClassVar[DATA_DIRECTORY] = ... EXPORT_TABLE: ClassVar[DATA_DIRECTORY] = ... GLOBAL_PTR: ClassVar[DATA_DIRECTORY] = ... IAT: ClassVar[DATA_DIRECTORY] = ... IMPORT_TABLE: ClassVar[DATA_DIRECTORY] = ... LOAD_CONFIG_TABLE: ClassVar[DATA_DIRECTORY] = ... RESERVED: ClassVar[DATA_DIRECTORY] = ... RESOURCE_TABLE: ClassVar[DATA_DIRECTORY] = ... TLS_TABLE: ClassVar[DATA_DIRECTORY] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DEBUG_TYPES: __members__: ClassVar[dict] = ... # read-only BORLAND: ClassVar[DEBUG_TYPES] = ... CLSID: ClassVar[DEBUG_TYPES] = ... CODEVIEW: ClassVar[DEBUG_TYPES] = ... COFF: ClassVar[DEBUG_TYPES] = ... EXCEPTION: ClassVar[DEBUG_TYPES] = ... EX_DLLCHARACTERISTICS: ClassVar[DEBUG_TYPES] = ... FIXUP: ClassVar[DEBUG_TYPES] = ... FPO: ClassVar[DEBUG_TYPES] = ... ILTCG: ClassVar[DEBUG_TYPES] = ... MISC: ClassVar[DEBUG_TYPES] = ... MPX: ClassVar[DEBUG_TYPES] = ... OMAP_FROM_SRC: ClassVar[DEBUG_TYPES] = ... OMAP_TO_SRC: ClassVar[DEBUG_TYPES] = ... POGO: ClassVar[DEBUG_TYPES] = ... REPRO: ClassVar[DEBUG_TYPES] = ... UNKNOWN: ClassVar[DEBUG_TYPES] = ... VC_FEATURE: ClassVar[DEBUG_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DIALOG_BOX_STYLES: __members__: ClassVar[dict] = ... # read-only ABSALIGN: ClassVar[DIALOG_BOX_STYLES] = ... CENTER: ClassVar[DIALOG_BOX_STYLES] = ... CENTERMOUSE: ClassVar[DIALOG_BOX_STYLES] = ... CONTEXTHELP: ClassVar[DIALOG_BOX_STYLES] = ... CONTROL: ClassVar[DIALOG_BOX_STYLES] = ... D3DLOOK: ClassVar[DIALOG_BOX_STYLES] = ... FIXEDSYS: ClassVar[DIALOG_BOX_STYLES] = ... LOCALEDIT: ClassVar[DIALOG_BOX_STYLES] = ... MODALFRAME: ClassVar[DIALOG_BOX_STYLES] = ... NOFAILCREATE: ClassVar[DIALOG_BOX_STYLES] = ... NOIDLEMSG: ClassVar[DIALOG_BOX_STYLES] = ... SETFONT: ClassVar[DIALOG_BOX_STYLES] = ... SETFOREGROUND: ClassVar[DIALOG_BOX_STYLES] = ... SHELLFONT: ClassVar[DIALOG_BOX_STYLES] = ... SYSMODAL: ClassVar[DIALOG_BOX_STYLES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DLL_CHARACTERISTICS: __members__: ClassVar[dict] = ... # read-only APPCONTAINER: ClassVar[DLL_CHARACTERISTICS] = ... DYNAMIC_BASE: ClassVar[DLL_CHARACTERISTICS] = ... FORCE_INTEGRITY: ClassVar[DLL_CHARACTERISTICS] = ... GUARD_CF: ClassVar[DLL_CHARACTERISTICS] = ... HIGH_ENTROPY_VA: ClassVar[DLL_CHARACTERISTICS] = ... NO_BIND: ClassVar[DLL_CHARACTERISTICS] = ... NO_ISOLATION: ClassVar[DLL_CHARACTERISTICS] = ... NO_SEH: ClassVar[DLL_CHARACTERISTICS] = ... NX_COMPAT: ClassVar[DLL_CHARACTERISTICS] = ... TERMINAL_SERVER_AWARE: ClassVar[DLL_CHARACTERISTICS] = ... WDM_DRIVER: ClassVar[DLL_CHARACTERISTICS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class DataDirectory(lief.Object): rva: int size: int def __init__(self) -> None: ... @property def has_section(self) -> bool: ... @property def section(self) -> lief.PE.Section: ... @property def type(self) -> lief.PE.DATA_DIRECTORY: ... class Debug(lief.Object): addressof_rawdata: int characteristics: int major_version: int minor_version: int pointerto_rawdata: int sizeof_data: int timestamp: int type: lief.PE.DEBUG_TYPES def __init__(self) -> None: ... @property def code_view(self) -> lief.PE.CodeView: ... @property def has_code_view(self) -> bool: ... @property def has_pogo(self) -> bool: ... @property def pogo(self) -> lief.PE.Pogo: ... class DelayImport(lief.Object): class it_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.DelayImportEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.DelayImportEntry: ... attribute: int biat: int handle: int iat: int name: object names_table: int timestamp: int uiat: int def __init__(self, library_name: str) -> None: ... @property def entries(self) -> lief.PE.DelayImport.it_entries: ... class DelayImportEntry(lief.Symbol): data: int name: object def __init__(self) -> None: ... @property def hint(self) -> int: ... @property def iat_value(self) -> int: ... @property def is_ordinal(self) -> bool: ... @property def ordinal(self) -> int: ... class DictStringVersion: def __init__(self) -> None: ... def items(self) -> Any: ... def keys(self) -> Any: ... def values(self) -> Any: ... def __bool__(self) -> bool: ... @overload def __contains__(self, arg0: str) -> bool: ... @overload def __contains__(self, arg0: object) -> bool: ... def __delitem__(self, arg0: str) -> None: ... def __getitem__(self, arg0: str) -> str: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __setitem__(self, arg0: str, arg1: str) -> None: ... class DosHeader(lief.Object): addressof_new_exeheader: int addressof_relocation_table: int checksum: int file_size_in_pages: int header_size_in_paragraphs: int initial_ip: int initial_relative_cs: int initial_relative_ss: int initial_sp: int magic: int maximum_extra_paragraphs: int minimum_extra_paragraphs: int numberof_relocation: int oem_id: int oem_info: int overlay_number: int used_bytes_in_the_last_page: int def __init__(self) -> None: ... class EXTENDED_WINDOW_STYLES: __members__: ClassVar[dict] = ... # read-only ACCEPTFILES: ClassVar[EXTENDED_WINDOW_STYLES] = ... APPWINDOW: ClassVar[EXTENDED_WINDOW_STYLES] = ... CLIENTEDGE: ClassVar[EXTENDED_WINDOW_STYLES] = ... CONTEXTHELP: ClassVar[EXTENDED_WINDOW_STYLES] = ... CONTROLPARENT: ClassVar[EXTENDED_WINDOW_STYLES] = ... DLGMODALFRAME: ClassVar[EXTENDED_WINDOW_STYLES] = ... LEFT: ClassVar[EXTENDED_WINDOW_STYLES] = ... LEFTSCROLLBAR: ClassVar[EXTENDED_WINDOW_STYLES] = ... LTRREADING: ClassVar[EXTENDED_WINDOW_STYLES] = ... MDICHILD: ClassVar[EXTENDED_WINDOW_STYLES] = ... NOPARENTNOTIFY: ClassVar[EXTENDED_WINDOW_STYLES] = ... RIGHT: ClassVar[EXTENDED_WINDOW_STYLES] = ... RIGHTSCROLLBAR: ClassVar[EXTENDED_WINDOW_STYLES] = ... RTLREADING: ClassVar[EXTENDED_WINDOW_STYLES] = ... STATICEDGE: ClassVar[EXTENDED_WINDOW_STYLES] = ... TOOLWINDOW: ClassVar[EXTENDED_WINDOW_STYLES] = ... TOPMOST: ClassVar[EXTENDED_WINDOW_STYLES] = ... TRANSPARENT: ClassVar[EXTENDED_WINDOW_STYLES] = ... WINDOWEDGE: ClassVar[EXTENDED_WINDOW_STYLES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Export(lief.Object): class it_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ExportEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ExportEntry: ... export_flags: int major_version: int minor_version: int name: object ordinal_base: int timestamp: int def __init__(self) -> None: ... @property def entries(self) -> lief.PE.Export.it_entries: ... class ExportEntry(lief.Symbol): class forward_information_t: function: str library: str def __init__(self, *args, **kwargs) -> None: ... address: int is_extern: bool name: object ordinal: int def __init__(self) -> None: ... @property def forward_information(self) -> lief.PE.ExportEntry.forward_information_t: ... @property def function_rva(self) -> int: ... @property def is_forwarded(self) -> bool: ... class FIXED_VERSION_FILE_FLAGS: __members__: ClassVar[dict] = ... # read-only DEBUG: ClassVar[FIXED_VERSION_FILE_FLAGS] = ... INFOINFERRED: ClassVar[FIXED_VERSION_FILE_FLAGS] = ... PATCHED: ClassVar[FIXED_VERSION_FILE_FLAGS] = ... PRERELEASE: ClassVar[FIXED_VERSION_FILE_FLAGS] = ... PRIVATEBUILD: ClassVar[FIXED_VERSION_FILE_FLAGS] = ... SPECIALBUILD: ClassVar[FIXED_VERSION_FILE_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class FIXED_VERSION_FILE_SUB_TYPES: __members__: ClassVar[dict] = ... # read-only DRV_COMM: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_DISPLAY: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_INSTALLABLE: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_KEYBOARD: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_LANGUAGE: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_MOUSE: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_NETWORK: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_PRINTER: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_SOUND: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_SYSTEM: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... DRV_VERSIONED_PRINTER: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... FONT_RASTER: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... FONT_TRUETYPE: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... FONT_VECTOR: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... UNKNOWN: ClassVar[FIXED_VERSION_FILE_SUB_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class FIXED_VERSION_FILE_TYPES: __members__: ClassVar[dict] = ... # read-only APP: ClassVar[FIXED_VERSION_FILE_TYPES] = ... DLL: ClassVar[FIXED_VERSION_FILE_TYPES] = ... DRV: ClassVar[FIXED_VERSION_FILE_TYPES] = ... FONT: ClassVar[FIXED_VERSION_FILE_TYPES] = ... STATIC_LIB: ClassVar[FIXED_VERSION_FILE_TYPES] = ... UNKNOWN: ClassVar[FIXED_VERSION_FILE_TYPES] = ... VXD: ClassVar[FIXED_VERSION_FILE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class FIXED_VERSION_OS: __members__: ClassVar[dict] = ... # read-only DOS: ClassVar[FIXED_VERSION_OS] = ... DOS_WINDOWS16: ClassVar[FIXED_VERSION_OS] = ... DOS_WINDOWS32: ClassVar[FIXED_VERSION_OS] = ... NT: ClassVar[FIXED_VERSION_OS] = ... NT_WINDOWS32: ClassVar[FIXED_VERSION_OS] = ... OS216: ClassVar[FIXED_VERSION_OS] = ... OS216_PM16: ClassVar[FIXED_VERSION_OS] = ... OS232: ClassVar[FIXED_VERSION_OS] = ... OS232_PM32: ClassVar[FIXED_VERSION_OS] = ... PM16: ClassVar[FIXED_VERSION_OS] = ... PM32: ClassVar[FIXED_VERSION_OS] = ... UNKNOWN: ClassVar[FIXED_VERSION_OS] = ... WINDOWS16: ClassVar[FIXED_VERSION_OS] = ... WINDOWS32: ClassVar[FIXED_VERSION_OS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class GUARD_CF_FLAGS: __members__: ClassVar[dict] = ... # read-only GCF_ENABLE_EXPORT_SUPPRESSION: ClassVar[GUARD_CF_FLAGS] = ... GCF_EXPORT_SUPPRESSION_INFO_PRESENT: ClassVar[GUARD_CF_FLAGS] = ... GCF_FUNCTION_TABLE_PRESENT: ClassVar[GUARD_CF_FLAGS] = ... GCF_INSTRUMENTED: ClassVar[GUARD_CF_FLAGS] = ... GCF_LONGJUMP_TABLE_PRESENT: ClassVar[GUARD_CF_FLAGS] = ... GCF_NONE: ClassVar[GUARD_CF_FLAGS] = ... GCF_W_INSTRUMENTED: ClassVar[GUARD_CF_FLAGS] = ... GRF_ENABLE: ClassVar[GUARD_CF_FLAGS] = ... GRF_INSTRUMENTED: ClassVar[GUARD_CF_FLAGS] = ... GRF_STRICT: ClassVar[GUARD_CF_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class GenericType(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def oid(self) -> str: ... @property def raw_content(self) -> bytes: ... class HEADER_CHARACTERISTICS: __members__: ClassVar[dict] = ... # read-only AGGRESSIVE_WS_TRIM: ClassVar[HEADER_CHARACTERISTICS] = ... BYTES_REVERSED_HI: ClassVar[HEADER_CHARACTERISTICS] = ... BYTES_REVERSED_LO: ClassVar[HEADER_CHARACTERISTICS] = ... CHARA_32BIT_MACHINE: ClassVar[HEADER_CHARACTERISTICS] = ... DEBUG_STRIPPED: ClassVar[HEADER_CHARACTERISTICS] = ... DLL: ClassVar[HEADER_CHARACTERISTICS] = ... EXECUTABLE_IMAGE: ClassVar[HEADER_CHARACTERISTICS] = ... LARGE_ADDRESS_AWARE: ClassVar[HEADER_CHARACTERISTICS] = ... LINE_NUMS_STRIPPED: ClassVar[HEADER_CHARACTERISTICS] = ... LOCAL_SYMS_STRIPPED: ClassVar[HEADER_CHARACTERISTICS] = ... NET_RUN_FROM_SWAP: ClassVar[HEADER_CHARACTERISTICS] = ... RELOCS_STRIPPED: ClassVar[HEADER_CHARACTERISTICS] = ... REMOVABLE_RUN_FROM_SWAP: ClassVar[HEADER_CHARACTERISTICS] = ... SYSTEM: ClassVar[HEADER_CHARACTERISTICS] = ... UP_SYSTEM_ONLY: ClassVar[HEADER_CHARACTERISTICS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Header(lief.Object): characteristics: lief.PE.HEADER_CHARACTERISTICS machine: lief.PE.MACHINE_TYPES numberof_sections: int numberof_symbols: int pointerto_symbol_table: int signature: List[int] sizeof_optional_header: int time_date_stamps: int def __init__(self) -> None: ... def add_characteristic(self, characteristic: lief.PE.HEADER_CHARACTERISTICS) -> None: ... def has_characteristic(self, characteristic: lief.PE.HEADER_CHARACTERISTICS) -> bool: ... def remove_characteristic(self, characteristic: lief.PE.HEADER_CHARACTERISTICS) -> None: ... @property def characteristics_list(self) -> Set[lief.PE.HEADER_CHARACTERISTICS]: ... class IMPHASH_MODE: __members__: ClassVar[dict] = ... # read-only DEFAULT: ClassVar[IMPHASH_MODE] = ... LIEF: ClassVar[IMPHASH_MODE] = ... PEFILE: ClassVar[IMPHASH_MODE] = ... VT: ClassVar[IMPHASH_MODE] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Import(lief.Object): class it_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ImportEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ImportEntry: ... import_address_table_rva: int import_lookup_table_rva: int name: object @overload def __init__(self) -> None: ... @overload def __init__(self, library_name: str) -> None: ... @overload def add_entry(self, entry: lief.PE.ImportEntry) -> lief.PE.ImportEntry: ... @overload def add_entry(self, function_name: str) -> lief.PE.ImportEntry: ... def get_entry(self, function_name: str) -> lief.PE.ImportEntry: ... def get_function_rva_from_iat(self, function_name: str) -> object: ... @property def directory(self) -> lief.PE.DataDirectory: ... @property def entries(self) -> lief.PE.Import.it_entries: ... @property def forwarder_chain(self) -> int: ... @property def iat_directory(self) -> lief.PE.DataDirectory: ... @property def timedatestamp(self) -> int: ... class ImportEntry(lief.Symbol): data: int name: object @overload def __init__(self) -> None: ... @overload def __init__(self, import_name: str) -> None: ... @overload def __init__(self, data: int, name: str = ...) -> None: ... @overload def __init__(self, data: int, type: lief.PE.PE_TYPE, name: str = ...) -> None: ... @overload def __init__(self, name: str, type: lief.PE.PE_TYPE) -> None: ... @property def hint(self) -> int: ... @property def iat_address(self) -> int: ... @property def iat_value(self) -> int: ... @property def is_ordinal(self) -> bool: ... @property def ordinal(self) -> int: ... class LangCodeItem(lief.Object): code_page: lief.PE.CODE_PAGES items: dict key: str lang: lief.PE.RESOURCE_LANGS sublang: lief.PE.RESOURCE_SUBLANGS type: int def __init__(self, *args, **kwargs) -> None: ... class ListLangCodeItem: @overload def __init__(self) -> None: ... @overload def __init__(self, arg0: lief.PE.ListLangCodeItem) -> None: ... @overload def __init__(self, arg0: Iterable) -> None: ... def append(self, x: lief.PE.LangCodeItem) -> None: ... def clear(self) -> None: ... def count(self, x: lief.PE.LangCodeItem) -> int: ... @overload def extend(self, L: lief.PE.ListLangCodeItem) -> None: ... @overload def extend(self, L: Iterable) -> None: ... def insert(self, i: int, x: lief.PE.LangCodeItem) -> None: ... @overload def pop(self) -> lief.PE.LangCodeItem: ... @overload def pop(self, i: int) -> lief.PE.LangCodeItem: ... def remove(self, x: lief.PE.LangCodeItem) -> None: ... def __bool__(self) -> bool: ... def __contains__(self, x: lief.PE.LangCodeItem) -> bool: ... @overload def __delitem__(self, arg0: int) -> None: ... @overload def __delitem__(self, arg0: slice) -> None: ... @overload def __getitem__(self, s: slice) -> lief.PE.ListLangCodeItem: ... @overload def __getitem__(self, arg0: int) -> lief.PE.LangCodeItem: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... @overload def __setitem__(self, arg0: int, arg1: lief.PE.LangCodeItem) -> None: ... @overload def __setitem__(self, arg0: slice, arg1: lief.PE.ListLangCodeItem) -> None: ... class LoadConfiguration(lief.Object): characteristics: int critical_section_default_timeout: int csd_version: int decommit_free_block_threshold: int decommit_total_free_threshold: int dependent_load_flags: int editlist: int global_flags_clear: int global_flags_set: int lock_prefix_table: int major_version: int maximum_allocation_size: int minor_version: int process_affinity_mask: int process_heap_flags: int reserved1: int security_cookie: int timedatestamp: int virtual_memory_threshold: int def __init__(self) -> None: ... @property def size(self) -> int: ... @property def version(self) -> Any: ... class LoadConfigurationV0(LoadConfiguration): se_handler_count: int se_handler_table: int def __init__(self) -> None: ... class LoadConfigurationV1(LoadConfigurationV0): guard_cf_check_function_pointer: int guard_cf_dispatch_function_pointer: int guard_cf_function_count: int guard_cf_function_table: int guard_flags: lief.PE.GUARD_CF_FLAGS def __init__(self) -> None: ... def has(self, flag: lief.PE.GUARD_CF_FLAGS) -> bool: ... def __contains__(self, arg0: lief.PE.GUARD_CF_FLAGS) -> bool: ... @property def guard_cf_flags_list(self) -> Set[lief.PE.GUARD_CF_FLAGS]: ... class LoadConfigurationV10(LoadConfigurationV9): guard_xfg_check_function_pointer: int guard_xfg_dispatch_function_pointer: int guard_xfg_table_dispatch_function_pointer: int def __init__(self) -> None: ... class LoadConfigurationV11(LoadConfigurationV10): cast_guard_os_determined_failure_mode: int def __init__(self) -> None: ... class LoadConfigurationV2(LoadConfigurationV1): def __init__(self) -> None: ... @property def code_integrity(self) -> lief.PE.CodeIntegrity: ... class LoadConfigurationV3(LoadConfigurationV2): guard_address_taken_iat_entry_count: int guard_address_taken_iat_entry_table: int guard_long_jump_target_count: int guard_long_jump_target_table: int def __init__(self) -> None: ... class LoadConfigurationV4(LoadConfigurationV3): dynamic_value_reloc_table: int hybrid_metadata_pointer: int def __init__(self) -> None: ... class LoadConfigurationV5(LoadConfigurationV4): dynamic_value_reloctable_offset: int dynamic_value_reloctable_section: int guard_rf_failure_routine: int guard_rf_failure_routine_function_pointer: int reserved2: int def __init__(self) -> None: ... class LoadConfigurationV6(LoadConfigurationV5): guard_rf_verify_stackpointer_function_pointer: int hotpatch_table_offset: int def __init__(self) -> None: ... class LoadConfigurationV7(LoadConfigurationV6): addressof_unicode_string: int reserved3: int def __init__(self) -> None: ... class LoadConfigurationV8(LoadConfigurationV7): volatile_metadata_pointer: int def __init__(self) -> None: ... class LoadConfigurationV9(LoadConfigurationV8): guard_eh_continuation_count: int guard_eh_continuation_table: int def __init__(self) -> None: ... class MACHINE_TYPES: __members__: ClassVar[dict] = ... # read-only AM33: ClassVar[MACHINE_TYPES] = ... AMD64: ClassVar[MACHINE_TYPES] = ... ARM: ClassVar[MACHINE_TYPES] = ... ARM64: ClassVar[MACHINE_TYPES] = ... ARMNT: ClassVar[MACHINE_TYPES] = ... EBC: ClassVar[MACHINE_TYPES] = ... I386: ClassVar[MACHINE_TYPES] = ... IA64: ClassVar[MACHINE_TYPES] = ... INVALID: ClassVar[MACHINE_TYPES] = ... M32R: ClassVar[MACHINE_TYPES] = ... MIPS16: ClassVar[MACHINE_TYPES] = ... MIPSFPU: ClassVar[MACHINE_TYPES] = ... MIPSFPU16: ClassVar[MACHINE_TYPES] = ... POWERPC: ClassVar[MACHINE_TYPES] = ... POWERPCFP: ClassVar[MACHINE_TYPES] = ... R4000: ClassVar[MACHINE_TYPES] = ... SH3: ClassVar[MACHINE_TYPES] = ... SH3DSP: ClassVar[MACHINE_TYPES] = ... SH4: ClassVar[MACHINE_TYPES] = ... SH5: ClassVar[MACHINE_TYPES] = ... THUMB: ClassVar[MACHINE_TYPES] = ... UNKNOWN: ClassVar[MACHINE_TYPES] = ... WCEMIPSV2: ClassVar[MACHINE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class MsSpcNestedSignature(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def signature(self) -> lief.PE.Signature: ... class MsSpcStatementType(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def oid(self) -> str: ... class OptionalHeader(lief.Object): addressof_entrypoint: int baseof_code: int baseof_data: int checksum: int dll_characteristics: int file_alignment: int imagebase: int loader_flags: int magic: lief.PE.PE_TYPE major_image_version: int major_linker_version: int major_operating_system_version: int major_subsystem_version: int minor_image_version: int minor_linker_version: int minor_operating_system_version: int minor_subsystem_version: int numberof_rva_and_size: int section_alignment: int sizeof_code: int sizeof_headers: int sizeof_heap_commit: int sizeof_heap_reserve: int sizeof_image: int sizeof_initialized_data: int sizeof_stack_commit: int sizeof_stack_reserve: int sizeof_uninitialized_data: int subsystem: Any win32_version_value: int def __init__(self) -> None: ... def add(self, characteristic: lief.PE.DLL_CHARACTERISTICS) -> None: ... def has(self, characteristics: lief.PE.DLL_CHARACTERISTICS) -> bool: ... def remove(self, characteristic: lief.PE.DLL_CHARACTERISTICS) -> None: ... def __contains__(self, arg0: lief.PE.DLL_CHARACTERISTICS) -> bool: ... def __iadd__(self, arg0: lief.PE.DLL_CHARACTERISTICS) -> lief.PE.OptionalHeader: ... def __isub__(self, arg0: lief.PE.DLL_CHARACTERISTICS) -> lief.PE.OptionalHeader: ... @property def computed_checksum(self) -> int: ... @property def dll_characteristics_lists(self) -> Set[lief.PE.DLL_CHARACTERISTICS]: ... class PE_TYPE: __members__: ClassVar[dict] = ... # read-only PE32: ClassVar[PE_TYPE] = ... PE32_PLUS: ClassVar[PE_TYPE] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class PKCS9AtSequenceNumber(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def number(self) -> int: ... class PKCS9CounterSignature(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def signer(self) -> lief.PE.SignerInfo: ... class PKCS9MessageDigest(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def digest(self) -> object: ... class PKCS9SigningTime(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def time(self) -> List[int]: ... class POGO_SIGNATURES: __members__: ClassVar[dict] = ... # read-only LCTG: ClassVar[POGO_SIGNATURES] = ... PGI: ClassVar[POGO_SIGNATURES] = ... UNKNOWN: ClassVar[POGO_SIGNATURES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Pogo(lief.Object): class it_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.PogoEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.PogoEntry: ... def __init__(self) -> None: ... @property def entries(self) -> lief.PE.Pogo.it_entries: ... @property def signature(self) -> lief.PE.POGO_SIGNATURES: ... class PogoEntry(lief.Object): name: object size: int start_rva: int def __init__(self) -> None: ... class RELOCATIONS_BASE_TYPES: __members__: ClassVar[dict] = ... # read-only ABSOLUTE: ClassVar[RELOCATIONS_BASE_TYPES] = ... ARM_MOV32: ClassVar[RELOCATIONS_BASE_TYPES] = ... ARM_MOV32A: ClassVar[RELOCATIONS_BASE_TYPES] = ... ARM_MOV32T: ClassVar[RELOCATIONS_BASE_TYPES] = ... DIR64: ClassVar[RELOCATIONS_BASE_TYPES] = ... HIGH: ClassVar[RELOCATIONS_BASE_TYPES] = ... HIGH3ADJ: ClassVar[RELOCATIONS_BASE_TYPES] = ... HIGHADJ: ClassVar[RELOCATIONS_BASE_TYPES] = ... HIGHLOW: ClassVar[RELOCATIONS_BASE_TYPES] = ... IA64_IMM64: ClassVar[RELOCATIONS_BASE_TYPES] = ... LOW: ClassVar[RELOCATIONS_BASE_TYPES] = ... MIPS_JMPADDR: ClassVar[RELOCATIONS_BASE_TYPES] = ... MIPS_JMPADDR16: ClassVar[RELOCATIONS_BASE_TYPES] = ... REL: ClassVar[RELOCATIONS_BASE_TYPES] = ... RISCV_HI20: ClassVar[RELOCATIONS_BASE_TYPES] = ... RISCV_LOW12I: ClassVar[RELOCATIONS_BASE_TYPES] = ... RISCV_LOW12S: ClassVar[RELOCATIONS_BASE_TYPES] = ... SECTION: ClassVar[RELOCATIONS_BASE_TYPES] = ... THUMB_MOV32: ClassVar[RELOCATIONS_BASE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RESOURCE_LANGS: __members__: ClassVar[dict] = ... # read-only AFRIKAANS: ClassVar[RESOURCE_LANGS] = ... ALBANIAN: ClassVar[RESOURCE_LANGS] = ... ARABIC: ClassVar[RESOURCE_LANGS] = ... ARMENIAN: ClassVar[RESOURCE_LANGS] = ... ASSAMESE: ClassVar[RESOURCE_LANGS] = ... AZERI: ClassVar[RESOURCE_LANGS] = ... BANGLA: ClassVar[RESOURCE_LANGS] = ... BASQUE: ClassVar[RESOURCE_LANGS] = ... BELARUSIAN: ClassVar[RESOURCE_LANGS] = ... BOSNIAN: ClassVar[RESOURCE_LANGS] = ... BRETON: ClassVar[RESOURCE_LANGS] = ... BULGARIAN: ClassVar[RESOURCE_LANGS] = ... CATALAN: ClassVar[RESOURCE_LANGS] = ... CHINESE: ClassVar[RESOURCE_LANGS] = ... CORNISH: ClassVar[RESOURCE_LANGS] = ... CROATIAN: ClassVar[RESOURCE_LANGS] = ... CZECH: ClassVar[RESOURCE_LANGS] = ... DANISH: ClassVar[RESOURCE_LANGS] = ... DIVEHI: ClassVar[RESOURCE_LANGS] = ... DUTCH: ClassVar[RESOURCE_LANGS] = ... ENGLISH: ClassVar[RESOURCE_LANGS] = ... ESPERANTO: ClassVar[RESOURCE_LANGS] = ... ESTONIAN: ClassVar[RESOURCE_LANGS] = ... FAEROESE: ClassVar[RESOURCE_LANGS] = ... FARSI: ClassVar[RESOURCE_LANGS] = ... FINNISH: ClassVar[RESOURCE_LANGS] = ... FRENCH: ClassVar[RESOURCE_LANGS] = ... GAELIC: ClassVar[RESOURCE_LANGS] = ... GALICIAN: ClassVar[RESOURCE_LANGS] = ... GEORGIAN: ClassVar[RESOURCE_LANGS] = ... GERMAN: ClassVar[RESOURCE_LANGS] = ... GREEK: ClassVar[RESOURCE_LANGS] = ... GUJARATI: ClassVar[RESOURCE_LANGS] = ... HEBREW: ClassVar[RESOURCE_LANGS] = ... HINDI: ClassVar[RESOURCE_LANGS] = ... HUNGARIAN: ClassVar[RESOURCE_LANGS] = ... ICELANDIC: ClassVar[RESOURCE_LANGS] = ... INDONESIAN: ClassVar[RESOURCE_LANGS] = ... INUKTITUT: ClassVar[RESOURCE_LANGS] = ... INVARIANT: ClassVar[RESOURCE_LANGS] = ... IRISH: ClassVar[RESOURCE_LANGS] = ... ITALIAN: ClassVar[RESOURCE_LANGS] = ... JAPANESE: ClassVar[RESOURCE_LANGS] = ... KANNADA: ClassVar[RESOURCE_LANGS] = ... KASHMIRI: ClassVar[RESOURCE_LANGS] = ... KAZAK: ClassVar[RESOURCE_LANGS] = ... KONKANI: ClassVar[RESOURCE_LANGS] = ... KOREAN: ClassVar[RESOURCE_LANGS] = ... KYRGYZ: ClassVar[RESOURCE_LANGS] = ... LATVIAN: ClassVar[RESOURCE_LANGS] = ... LITHUANIAN: ClassVar[RESOURCE_LANGS] = ... LOWER_SORBIAN: ClassVar[RESOURCE_LANGS] = ... MACEDONIAN: ClassVar[RESOURCE_LANGS] = ... MALAY: ClassVar[RESOURCE_LANGS] = ... MALAYALAM: ClassVar[RESOURCE_LANGS] = ... MALTESE: ClassVar[RESOURCE_LANGS] = ... MANIPURI: ClassVar[RESOURCE_LANGS] = ... MAORI: ClassVar[RESOURCE_LANGS] = ... MARATHI: ClassVar[RESOURCE_LANGS] = ... MONGOLIAN: ClassVar[RESOURCE_LANGS] = ... NEPALI: ClassVar[RESOURCE_LANGS] = ... NEUTRAL: ClassVar[RESOURCE_LANGS] = ... NORWEGIAN: ClassVar[RESOURCE_LANGS] = ... ORIYA: ClassVar[RESOURCE_LANGS] = ... POLISH: ClassVar[RESOURCE_LANGS] = ... PORTUGUESE: ClassVar[RESOURCE_LANGS] = ... PULAR: ClassVar[RESOURCE_LANGS] = ... PUNJABI: ClassVar[RESOURCE_LANGS] = ... QUECHUA: ClassVar[RESOURCE_LANGS] = ... RHAETO_ROMANCE: ClassVar[RESOURCE_LANGS] = ... ROMANIAN: ClassVar[RESOURCE_LANGS] = ... RUSSIAN: ClassVar[RESOURCE_LANGS] = ... SAMI: ClassVar[RESOURCE_LANGS] = ... SANSKRIT: ClassVar[RESOURCE_LANGS] = ... SERBIAN: ClassVar[RESOURCE_LANGS] = ... SINDHI: ClassVar[RESOURCE_LANGS] = ... SLOVAK: ClassVar[RESOURCE_LANGS] = ... SLOVENIAN: ClassVar[RESOURCE_LANGS] = ... SORBIAN: ClassVar[RESOURCE_LANGS] = ... SPANISH: ClassVar[RESOURCE_LANGS] = ... SUTU: ClassVar[RESOURCE_LANGS] = ... SWAHILI: ClassVar[RESOURCE_LANGS] = ... SWEDISH: ClassVar[RESOURCE_LANGS] = ... SYRIAC: ClassVar[RESOURCE_LANGS] = ... TAMAZIGHT: ClassVar[RESOURCE_LANGS] = ... TAMIL: ClassVar[RESOURCE_LANGS] = ... TATAR: ClassVar[RESOURCE_LANGS] = ... TELUGU: ClassVar[RESOURCE_LANGS] = ... THAI: ClassVar[RESOURCE_LANGS] = ... TIGRINYA: ClassVar[RESOURCE_LANGS] = ... TSONGA: ClassVar[RESOURCE_LANGS] = ... TSWANA: ClassVar[RESOURCE_LANGS] = ... TURKISH: ClassVar[RESOURCE_LANGS] = ... UKRAINIAN: ClassVar[RESOURCE_LANGS] = ... URDU: ClassVar[RESOURCE_LANGS] = ... UZBEK: ClassVar[RESOURCE_LANGS] = ... VALENCIAN: ClassVar[RESOURCE_LANGS] = ... VENDA: ClassVar[RESOURCE_LANGS] = ... VIETNAMESE: ClassVar[RESOURCE_LANGS] = ... WALON: ClassVar[RESOURCE_LANGS] = ... WELSH: ClassVar[RESOURCE_LANGS] = ... XHOSA: ClassVar[RESOURCE_LANGS] = ... ZULU: ClassVar[RESOURCE_LANGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RESOURCE_SUBLANGS: __members__: ClassVar[dict] = ... # read-only AFRIKAANS_SOUTH_AFRICA: ClassVar[RESOURCE_SUBLANGS] = ... ALBANIAN_ALBANIA: ClassVar[RESOURCE_SUBLANGS] = ... ALSATIAN_FRANCE: ClassVar[RESOURCE_SUBLANGS] = ... AMHARIC_ETHIOPIA: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_ALGERIA: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_BAHRAIN: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_EGYPT: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_IRAQ: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_JORDAN: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_KUWAIT: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_LEBANON: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_LIBYA: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_MOROCCO: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_OMAN: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_QATAR: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_SAUDI_ARABIA: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_SYRIA: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_TUNISIA: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_UAE: ClassVar[RESOURCE_SUBLANGS] = ... ARABIC_YEMEN: ClassVar[RESOURCE_SUBLANGS] = ... ARMENIAN_ARMENIA: ClassVar[RESOURCE_SUBLANGS] = ... ASSAMESE_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... AZERI_CYRILLIC: ClassVar[RESOURCE_SUBLANGS] = ... AZERI_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... BANGLA_BANGLADESH: ClassVar[RESOURCE_SUBLANGS] = ... BANGLA_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... BASHKIR_RUSSIA: ClassVar[RESOURCE_SUBLANGS] = ... BASQUE_BASQUE: ClassVar[RESOURCE_SUBLANGS] = ... BELARUSIAN_BELARUS: ClassVar[RESOURCE_SUBLANGS] = ... BOSNIAN_BOSNIA_HERZEGOVINA_CYRILLIC: ClassVar[RESOURCE_SUBLANGS] = ... BOSNIAN_BOSNIA_HERZEGOVINA_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... BRETON_FRANCE: ClassVar[RESOURCE_SUBLANGS] = ... BULGARIAN_BULGARIA: ClassVar[RESOURCE_SUBLANGS] = ... CATALAN_CATALAN: ClassVar[RESOURCE_SUBLANGS] = ... CHINESE_HONGKONG: ClassVar[RESOURCE_SUBLANGS] = ... CHINESE_MACAU: ClassVar[RESOURCE_SUBLANGS] = ... CHINESE_SIMPLIFIED: ClassVar[RESOURCE_SUBLANGS] = ... CHINESE_SINGAPORE: ClassVar[RESOURCE_SUBLANGS] = ... CHINESE_TRADITIONAL: ClassVar[RESOURCE_SUBLANGS] = ... CORSICAN_FRANCE: ClassVar[RESOURCE_SUBLANGS] = ... CROATIAN_BOSNIA_HERZEGOVINA_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... CROATIAN_CROATIA: ClassVar[RESOURCE_SUBLANGS] = ... CUSTOM_DEFAULT: ClassVar[RESOURCE_SUBLANGS] = ... CUSTOM_UNSPECIFIED: ClassVar[RESOURCE_SUBLANGS] = ... CZECH_CZECH_REPUBLIC: ClassVar[RESOURCE_SUBLANGS] = ... DANISH_DENMARK: ClassVar[RESOURCE_SUBLANGS] = ... DARI_AFGHANISTAN: ClassVar[RESOURCE_SUBLANGS] = ... DEFAULT: ClassVar[RESOURCE_SUBLANGS] = ... DIVEHI_MALDIVES: ClassVar[RESOURCE_SUBLANGS] = ... DUTCH: ClassVar[RESOURCE_SUBLANGS] = ... DUTCH_BELGIAN: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_AUS: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_BELIZE: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_CAN: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_CARIBBEAN: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_EIRE: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_IRELAND: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_JAMAICA: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_MALAYSIA: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_NZ: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_PHILIPPINES: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_SINGAPORE: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_SOUTH_AFRICA: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_TRINIDAD: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_UK: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_US: ClassVar[RESOURCE_SUBLANGS] = ... ENGLISH_ZIMBABWE: ClassVar[RESOURCE_SUBLANGS] = ... ESTONIAN_ESTONIA: ClassVar[RESOURCE_SUBLANGS] = ... FAEROESE_FAROE_ISLANDS: ClassVar[RESOURCE_SUBLANGS] = ... FILIPINO_PHILIPPINES: ClassVar[RESOURCE_SUBLANGS] = ... FINNISH_FINLAND: ClassVar[RESOURCE_SUBLANGS] = ... FRENCH: ClassVar[RESOURCE_SUBLANGS] = ... FRENCH_BELGIAN: ClassVar[RESOURCE_SUBLANGS] = ... FRENCH_CANADIAN: ClassVar[RESOURCE_SUBLANGS] = ... FRENCH_LUXEMBOURG: ClassVar[RESOURCE_SUBLANGS] = ... FRENCH_MONACO: ClassVar[RESOURCE_SUBLANGS] = ... FRENCH_SWISS: ClassVar[RESOURCE_SUBLANGS] = ... FRISIAN_NETHERLANDS: ClassVar[RESOURCE_SUBLANGS] = ... GALICIAN_GALICIAN: ClassVar[RESOURCE_SUBLANGS] = ... GEORGIAN_GEORGIA: ClassVar[RESOURCE_SUBLANGS] = ... GERMAN: ClassVar[RESOURCE_SUBLANGS] = ... GERMAN_AUSTRIAN: ClassVar[RESOURCE_SUBLANGS] = ... GERMAN_LIECHTENSTEIN: ClassVar[RESOURCE_SUBLANGS] = ... GERMAN_LUXEMBOURG: ClassVar[RESOURCE_SUBLANGS] = ... GERMAN_SWISS: ClassVar[RESOURCE_SUBLANGS] = ... GREEK_GREECE: ClassVar[RESOURCE_SUBLANGS] = ... GREENLANDIC_GREENLAND: ClassVar[RESOURCE_SUBLANGS] = ... GUJARATI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... HAUSA_NIGERIA_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... HEBREW_ISRAEL: ClassVar[RESOURCE_SUBLANGS] = ... HINDI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... HUNGARIAN_HUNGARY: ClassVar[RESOURCE_SUBLANGS] = ... ICELANDIC_ICELAND: ClassVar[RESOURCE_SUBLANGS] = ... IGBO_NIGERIA: ClassVar[RESOURCE_SUBLANGS] = ... INDONESIAN_INDONESIA: ClassVar[RESOURCE_SUBLANGS] = ... INUKTITUT_CANADA: ClassVar[RESOURCE_SUBLANGS] = ... INUKTITUT_CANADA_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... IRISH_IRELAND: ClassVar[RESOURCE_SUBLANGS] = ... ITALIAN: ClassVar[RESOURCE_SUBLANGS] = ... ITALIAN_SWISS: ClassVar[RESOURCE_SUBLANGS] = ... JAPANESE_JAPAN: ClassVar[RESOURCE_SUBLANGS] = ... KANNADA_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... KASHMIRI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... KASHMIRI_SASIA: ClassVar[RESOURCE_SUBLANGS] = ... KAZAK_KAZAKHSTAN: ClassVar[RESOURCE_SUBLANGS] = ... KHMER_CAMBODIA: ClassVar[RESOURCE_SUBLANGS] = ... KICHE_GUATEMALA: ClassVar[RESOURCE_SUBLANGS] = ... KINYARWANDA_RWANDA: ClassVar[RESOURCE_SUBLANGS] = ... KONKANI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... KOREAN: ClassVar[RESOURCE_SUBLANGS] = ... KYRGYZ_KYRGYZSTAN: ClassVar[RESOURCE_SUBLANGS] = ... LAO_LAO: ClassVar[RESOURCE_SUBLANGS] = ... LATVIAN_LATVIA: ClassVar[RESOURCE_SUBLANGS] = ... LITHUANIAN: ClassVar[RESOURCE_SUBLANGS] = ... LITHUANIAN_CLASSIC: ClassVar[RESOURCE_SUBLANGS] = ... LOWER_SORBIAN_GERMANY: ClassVar[RESOURCE_SUBLANGS] = ... LUXEMBOURGISH_LUXEMBOURG: ClassVar[RESOURCE_SUBLANGS] = ... MACEDONIAN_MACEDONIA: ClassVar[RESOURCE_SUBLANGS] = ... MALAYALAM_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... MALAY_BRUNEI_DARUSSALAM: ClassVar[RESOURCE_SUBLANGS] = ... MALAY_MALAYSIA: ClassVar[RESOURCE_SUBLANGS] = ... MALTESE_MALTA: ClassVar[RESOURCE_SUBLANGS] = ... MAORI_NEW_ZEALAND: ClassVar[RESOURCE_SUBLANGS] = ... MAPUDUNGUN_CHILE: ClassVar[RESOURCE_SUBLANGS] = ... MARATHI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... MOHAWK_MOHAWK: ClassVar[RESOURCE_SUBLANGS] = ... MONGOLIAN_CYRILLIC_MONGOLIA: ClassVar[RESOURCE_SUBLANGS] = ... MONGOLIAN_PRC: ClassVar[RESOURCE_SUBLANGS] = ... NEPALI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... NEPALI_NEPAL: ClassVar[RESOURCE_SUBLANGS] = ... NEUTRAL: ClassVar[RESOURCE_SUBLANGS] = ... NORWEGIAN_BOKMAL: ClassVar[RESOURCE_SUBLANGS] = ... NORWEGIAN_NYNORSK: ClassVar[RESOURCE_SUBLANGS] = ... OCCITAN_FRANCE: ClassVar[RESOURCE_SUBLANGS] = ... ORIYA_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... PASHTO_AFGHANISTAN: ClassVar[RESOURCE_SUBLANGS] = ... PERSIAN_IRAN: ClassVar[RESOURCE_SUBLANGS] = ... POLISH_POLAND: ClassVar[RESOURCE_SUBLANGS] = ... PORTUGUESE: ClassVar[RESOURCE_SUBLANGS] = ... PORTUGUESE_BRAZILIAN: ClassVar[RESOURCE_SUBLANGS] = ... PULAR_SENEGAL: ClassVar[RESOURCE_SUBLANGS] = ... PUNJABI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... PUNJABI_PAKISTAN: ClassVar[RESOURCE_SUBLANGS] = ... QUECHUA_BOLIVIA: ClassVar[RESOURCE_SUBLANGS] = ... QUECHUA_ECUADOR: ClassVar[RESOURCE_SUBLANGS] = ... QUECHUA_PERU: ClassVar[RESOURCE_SUBLANGS] = ... ROMANIAN_ROMANIA: ClassVar[RESOURCE_SUBLANGS] = ... ROMANSH_SWITZERLAND: ClassVar[RESOURCE_SUBLANGS] = ... RUSSIAN_RUSSIA: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_INARI_FINLAND: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_LULE_NORWAY: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_LULE_SWEDEN: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_NORTHERN_FINLAND: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_NORTHERN_NORWAY: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_NORTHERN_SWEDEN: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_SKOLT_FINLAND: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_SOUTHERN_NORWAY: ClassVar[RESOURCE_SUBLANGS] = ... SAMI_SOUTHERN_SWEDEN: ClassVar[RESOURCE_SUBLANGS] = ... SANSKRIT_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... SERBIAN_BOSNIA_HERZEGOVINA_CYRILLIC: ClassVar[RESOURCE_SUBLANGS] = ... SERBIAN_BOSNIA_HERZEGOVINA_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... SERBIAN_CROATIA: ClassVar[RESOURCE_SUBLANGS] = ... SERBIAN_CYRILLIC: ClassVar[RESOURCE_SUBLANGS] = ... SERBIAN_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... SINDHI_AFGHANISTAN: ClassVar[RESOURCE_SUBLANGS] = ... SINDHI_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... SINDHI_PAKISTAN: ClassVar[RESOURCE_SUBLANGS] = ... SINHALESE_SRI_LANKA: ClassVar[RESOURCE_SUBLANGS] = ... SLOVAK_SLOVAKIA: ClassVar[RESOURCE_SUBLANGS] = ... SLOVENIAN_SLOVENIA: ClassVar[RESOURCE_SUBLANGS] = ... SOTHO_NORTHERN_SOUTH_AFRICA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_ARGENTINA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_BOLIVIA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_CHILE: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_COLOMBIA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_COSTA_RICA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_DOMINICAN_REPUBLIC: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_ECUADOR: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_EL_SALVADOR: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_GUATEMALA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_HONDURAS: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_MEXICAN: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_MODERN: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_NICARAGUA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_PANAMA: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_PARAGUAY: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_PERU: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_PUERTO_RICO: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_URUGUAY: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_US: ClassVar[RESOURCE_SUBLANGS] = ... SPANISH_VENEZUELA: ClassVar[RESOURCE_SUBLANGS] = ... SWAHILI_KENYA: ClassVar[RESOURCE_SUBLANGS] = ... SWEDISH: ClassVar[RESOURCE_SUBLANGS] = ... SWEDISH_FINLAND: ClassVar[RESOURCE_SUBLANGS] = ... SYRIAC_SYRIA: ClassVar[RESOURCE_SUBLANGS] = ... SYS_DEFAULT: ClassVar[RESOURCE_SUBLANGS] = ... TAJIK_TAJIKISTAN: ClassVar[RESOURCE_SUBLANGS] = ... TAMAZIGHT_ALGERIA_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... TAMIL_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... TAMIL_SRI_LANKA: ClassVar[RESOURCE_SUBLANGS] = ... TATAR_RUSSIA: ClassVar[RESOURCE_SUBLANGS] = ... TELUGU_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... THAI_THAILAND: ClassVar[RESOURCE_SUBLANGS] = ... TIBETAN_PRC: ClassVar[RESOURCE_SUBLANGS] = ... TIGRIGNA_ERITREA: ClassVar[RESOURCE_SUBLANGS] = ... TIGRINYA_ERITREA: ClassVar[RESOURCE_SUBLANGS] = ... TIGRINYA_ETHIOPIA: ClassVar[RESOURCE_SUBLANGS] = ... TSWANA_BOTSWANA: ClassVar[RESOURCE_SUBLANGS] = ... TSWANA_SOUTH_AFRICA: ClassVar[RESOURCE_SUBLANGS] = ... TURKISH_TURKEY: ClassVar[RESOURCE_SUBLANGS] = ... TURKMEN_TURKMENISTAN: ClassVar[RESOURCE_SUBLANGS] = ... UIGHUR_PRC: ClassVar[RESOURCE_SUBLANGS] = ... UI_CUSTOM_DEFAULT: ClassVar[RESOURCE_SUBLANGS] = ... UKRAINIAN_UKRAINE: ClassVar[RESOURCE_SUBLANGS] = ... UPPER_SORBIAN_GERMANY: ClassVar[RESOURCE_SUBLANGS] = ... URDU_INDIA: ClassVar[RESOURCE_SUBLANGS] = ... URDU_PAKISTAN: ClassVar[RESOURCE_SUBLANGS] = ... UZBEK_CYRILLIC: ClassVar[RESOURCE_SUBLANGS] = ... UZBEK_LATIN: ClassVar[RESOURCE_SUBLANGS] = ... VALENCIAN_VALENCIA: ClassVar[RESOURCE_SUBLANGS] = ... VIETNAMESE_VIETNAM: ClassVar[RESOURCE_SUBLANGS] = ... WELSH_UNITED_KINGDOM: ClassVar[RESOURCE_SUBLANGS] = ... WOLOF_SENEGAL: ClassVar[RESOURCE_SUBLANGS] = ... XHOSA_SOUTH_AFRICA: ClassVar[RESOURCE_SUBLANGS] = ... YAKUT_RUSSIA: ClassVar[RESOURCE_SUBLANGS] = ... YI_PRC: ClassVar[RESOURCE_SUBLANGS] = ... YORUBA_NIGERIA: ClassVar[RESOURCE_SUBLANGS] = ... ZULU_SOUTH_AFRICA: ClassVar[RESOURCE_SUBLANGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class RESOURCE_TYPES: __members__: ClassVar[dict] = ... # read-only ACCELERATOR: ClassVar[RESOURCE_TYPES] = ... ANICURSOR: ClassVar[RESOURCE_TYPES] = ... ANIICON: ClassVar[RESOURCE_TYPES] = ... BITMAP: ClassVar[RESOURCE_TYPES] = ... CURSOR: ClassVar[RESOURCE_TYPES] = ... DIALOG: ClassVar[RESOURCE_TYPES] = ... DLGINCLUDE: ClassVar[RESOURCE_TYPES] = ... FONT: ClassVar[RESOURCE_TYPES] = ... FONTDIR: ClassVar[RESOURCE_TYPES] = ... GROUP_CURSOR: ClassVar[RESOURCE_TYPES] = ... GROUP_ICON: ClassVar[RESOURCE_TYPES] = ... HTML: ClassVar[RESOURCE_TYPES] = ... ICON: ClassVar[RESOURCE_TYPES] = ... MANIFEST: ClassVar[RESOURCE_TYPES] = ... MENU: ClassVar[RESOURCE_TYPES] = ... MESSAGETABLE: ClassVar[RESOURCE_TYPES] = ... PLUGPLAY: ClassVar[RESOURCE_TYPES] = ... RCDATA: ClassVar[RESOURCE_TYPES] = ... STRING: ClassVar[RESOURCE_TYPES] = ... VERSION: ClassVar[RESOURCE_TYPES] = ... VXD: ClassVar[RESOURCE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Relocation(lief.Object): class it_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.RelocationEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.RelocationEntry: ... block_size: int virtual_address: int def __init__(self) -> None: ... def add_entry(self, new_entry: lief.PE.RelocationEntry) -> lief.PE.RelocationEntry: ... @property def entries(self) -> lief.PE.Relocation.it_entries: ... class RelocationEntry(lief.Relocation): data: int position: int type: lief.PE.RELOCATIONS_BASE_TYPES def __init__(self) -> None: ... class ResourceAccelerator(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def ansi(self) -> int: ... @property def flags(self) -> int: ... @property def id(self) -> int: ... @property def padding(self) -> int: ... class ResourceData(ResourceNode): code_page: int content: memoryview reserved: int @overload def __init__(self) -> None: ... @overload def __init__(self, content: List[int], code_page: int) -> None: ... @property def offset(self) -> int: ... class ResourceDialog(lief.Object): class it_const_items: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ResourceDialogItem: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ResourceDialogItem: ... lang: lief.PE.RESOURCE_LANGS sub_lang: lief.PE.RESOURCE_SUBLANGS def __init__(self, *args, **kwargs) -> None: ... def has_dialogbox_style(self, style: lief.PE.DIALOG_BOX_STYLES) -> bool: ... def has_extended_style(self, style: lief.PE.EXTENDED_WINDOW_STYLES) -> bool: ... def has_style(self, style: lief.PE.WINDOW_STYLES) -> bool: ... @property def charset(self) -> int: ... @property def cx(self) -> int: ... @property def cy(self) -> int: ... @property def dialogbox_style_list(self) -> Set[lief.PE.DIALOG_BOX_STYLES]: ... @property def extended_style(self) -> int: ... @property def extended_style_list(self) -> Set[lief.PE.DIALOG_BOX_STYLES]: ... @property def help_id(self) -> int: ... @property def is_extended(self) -> bool: ... @property def items(self) -> lief.PE.ResourceDialog.it_const_items: ... @property def point_size(self) -> int: ... @property def signature(self) -> int: ... @property def style(self) -> int: ... @property def style_list(self) -> Set[lief.PE.WINDOW_STYLES]: ... @property def title(self) -> str: ... @property def typeface(self) -> str: ... @property def version(self) -> int: ... @property def weight(self) -> int: ... @property def x(self) -> int: ... @property def y(self) -> int: ... class ResourceDialogItem(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def cx(self) -> int: ... @property def cy(self) -> int: ... @property def extended_style(self) -> int: ... @property def help_id(self) -> int: ... @property def id(self) -> int: ... @property def is_extended(self) -> bool: ... @property def style(self) -> int: ... @property def title(self) -> str: ... @property def x(self) -> int: ... @property def y(self) -> int: ... class ResourceDirectory(ResourceNode): characteristics: int major_version: int minor_version: int numberof_id_entries: int numberof_name_entries: int time_date_stamp: int def __init__(self) -> None: ... class ResourceFixedFileInfo(lief.Object): file_date_LS: int file_date_MS: int file_flags: int file_flags_mask: int file_os: lief.PE.FIXED_VERSION_OS file_subtype: lief.PE.FIXED_VERSION_FILE_SUB_TYPES file_type: lief.PE.FIXED_VERSION_FILE_TYPES file_version_LS: int file_version_MS: int product_version_LS: int product_version_MS: int signature: int struct_version: int def __init__(self, *args, **kwargs) -> None: ... class ResourceIcon(lief.Object): bit_count: int color_count: int height: int id: int lang: lief.PE.RESOURCE_LANGS pixels: memoryview planes: int reserved: int sublang: lief.PE.RESOURCE_SUBLANGS width: int def __init__(self, *args, **kwargs) -> None: ... def save(self, filepath: str) -> None: ... class ResourceNode(lief.Object): class it_childs: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ResourceNode: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ResourceNode: ... id: int name: object def __init__(self, *args, **kwargs) -> None: ... def add_data_node(self, resource_data: lief.PE.ResourceData) -> lief.PE.ResourceNode: ... def add_directory_node(self, resource_directory: lief.PE.ResourceDirectory) -> lief.PE.ResourceNode: ... @overload def delete_child(self, node: lief.PE.ResourceNode) -> None: ... @overload def delete_child(self, id: int) -> None: ... @property def childs(self) -> lief.PE.ResourceNode.it_childs: ... @property def depth(self) -> int: ... @property def has_name(self) -> bool: ... @property def is_data(self) -> bool: ... @property def is_directory(self) -> bool: ... class ResourceStringFileInfo(lief.Object): key: str langcode_items: Any type: int def __init__(self, *args, **kwargs) -> None: ... class ResourceStringTable(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def length(self) -> int: ... @property def name(self) -> str: ... class ResourceVarFileInfo(lief.Object): key: str translations: List[int] type: int def __init__(self, *args, **kwargs) -> None: ... class ResourceVersion(lief.Object): fixed_file_info: lief.PE.ResourceFixedFileInfo key: str string_file_info: lief.PE.ResourceStringFileInfo type: int var_file_info: lief.PE.ResourceVarFileInfo def __init__(self, *args, **kwargs) -> None: ... def remove_fixed_file_info(self) -> None: ... def remove_string_file_info(self) -> None: ... def remove_var_file_info(self) -> None: ... @property def has_fixed_file_info(self) -> bool: ... @property def has_string_file_info(self) -> bool: ... @property def has_var_file_info(self) -> bool: ... class ResourcesManager(lief.Object): class it_const_accelerators: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ResourceAccelerator: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ResourceAccelerator: ... class it_const_dialogs: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ResourceDialog: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ResourceDialog: ... class it_const_icons: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ResourceIcon: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ResourceIcon: ... class it_const_strings_table: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.ResourceStringTable: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.ResourceStringTable: ... manifest: object def __init__(self, *args, **kwargs) -> None: ... def add_icon(self, icon: lief.PE.ResourceIcon) -> None: ... def change_icon(self, old_one: lief.PE.ResourceIcon, new_one: lief.PE.ResourceIcon) -> None: ... def get_node_type(self, type: lief.PE.RESOURCE_TYPES) -> lief.PE.ResourceNode: ... def has_type(self, type: lief.PE.RESOURCE_TYPES) -> bool: ... @property def accelerator(self) -> lief.PE.ResourcesManager.it_const_accelerators: ... @property def dialogs(self) -> lief.PE.ResourcesManager.it_const_dialogs: ... @property def has_accelerator(self) -> bool: ... @property def has_dialogs(self) -> bool: ... @property def has_html(self) -> bool: ... @property def has_icons(self) -> bool: ... @property def has_manifest(self) -> bool: ... @property def has_string_table(self) -> bool: ... @property def has_version(self) -> bool: ... @property def html(self) -> List[str]: ... @property def icons(self) -> lief.PE.ResourcesManager.it_const_icons: ... @property def langs_available(self) -> Set[lief.PE.RESOURCE_LANGS]: ... @property def string_table(self) -> lief.PE.ResourcesManager.it_const_strings_table: ... @property def sublangs_available(self) -> Set[lief.PE.RESOURCE_SUBLANGS]: ... @property def types_available(self) -> Set[lief.PE.RESOURCE_TYPES]: ... @property def version(self) -> object: ... class RichEntry(lief.Object): build_id: int count: int id: int @overload def __init__(self) -> None: ... @overload def __init__(self, id: int, build_id: int, count: int) -> None: ... class RichHeader: class it_entries: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.RichEntry: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.RichEntry: ... key: int def __init__(self) -> None: ... @overload def add_entry(self, entry: lief.PE.RichEntry) -> None: ... @overload def add_entry(self, id: int, build_id: int, count: int) -> None: ... @overload def hash(self, algo: lief.PE.ALGORITHMS) -> List[int]: ... @overload def hash(self, algo: lief.PE.ALGORITHMS, xor_key: int) -> List[int]: ... @overload def raw(self) -> List[int]: ... @overload def raw(self, xor_key: int) -> List[int]: ... @property def entries(self) -> lief.PE.RichHeader.it_entries: ... class RsaInfo: def __init__(self, *args, **kwargs) -> None: ... @property def D(self) -> bytes: ... @property def E(self) -> bytes: ... @property def N(self) -> bytes: ... @property def P(self) -> bytes: ... @property def Q(self) -> bytes: ... @property def has_private_key(self) -> bool: ... @property def has_public_key(self) -> bool: ... @property def key_size(self) -> int: ... @property def __len__(self) -> int: ... class SECTION_CHARACTERISTICS: __members__: ClassVar[dict] = ... # read-only ALIGN_1024BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_128BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_16BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_1BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_2048BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_256BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_2BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_32BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_4096BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_4BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_512BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_64BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_8192BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... ALIGN_8BYTES: ClassVar[SECTION_CHARACTERISTICS] = ... CNT_CODE: ClassVar[SECTION_CHARACTERISTICS] = ... CNT_INITIALIZED_DATA: ClassVar[SECTION_CHARACTERISTICS] = ... CNT_UNINITIALIZED_DATA: ClassVar[SECTION_CHARACTERISTICS] = ... GPREL: ClassVar[SECTION_CHARACTERISTICS] = ... LNK_COMDAT: ClassVar[SECTION_CHARACTERISTICS] = ... LNK_INFO: ClassVar[SECTION_CHARACTERISTICS] = ... LNK_NRELOC_OVFL: ClassVar[SECTION_CHARACTERISTICS] = ... LNK_OTHER: ClassVar[SECTION_CHARACTERISTICS] = ... LNK_REMOVE: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_16BIT: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_DISCARDABLE: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_EXECUTE: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_LOCKED: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_NOT_CACHED: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_NOT_PAGED: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_PRELOAD: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_PURGEABLE: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_READ: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_SHARED: ClassVar[SECTION_CHARACTERISTICS] = ... MEM_WRITE: ClassVar[SECTION_CHARACTERISTICS] = ... TYPE_NO_PAD: ClassVar[SECTION_CHARACTERISTICS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SECTION_TYPES: __members__: ClassVar[dict] = ... # read-only BSS: ClassVar[SECTION_TYPES] = ... DATA: ClassVar[SECTION_TYPES] = ... EXPORT: ClassVar[SECTION_TYPES] = ... IDATA: ClassVar[SECTION_TYPES] = ... RELOCATION: ClassVar[SECTION_TYPES] = ... RESOURCE: ClassVar[SECTION_TYPES] = ... TEXT: ClassVar[SECTION_TYPES] = ... TLS_: ClassVar[SECTION_TYPES] = ... UNKNOWN: ClassVar[SECTION_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SIG_ATTRIBUTE_TYPES: __members__: ClassVar[dict] = ... # read-only CONTENT_TYPE: ClassVar[SIG_ATTRIBUTE_TYPES] = ... GENERIC_TYPE: ClassVar[SIG_ATTRIBUTE_TYPES] = ... MS_COUNTER_SIGN: ClassVar[SIG_ATTRIBUTE_TYPES] = ... MS_SPC_NESTED_SIGN: ClassVar[SIG_ATTRIBUTE_TYPES] = ... MS_SPC_STATEMENT_TYPE: ClassVar[SIG_ATTRIBUTE_TYPES] = ... PKCS9_AT_SEQUENCE_NUMBER: ClassVar[SIG_ATTRIBUTE_TYPES] = ... PKCS9_COUNTER_SIGNATURE: ClassVar[SIG_ATTRIBUTE_TYPES] = ... PKCS9_MESSAGE_DIGEST: ClassVar[SIG_ATTRIBUTE_TYPES] = ... PKCS9_SIGNING_TIME: ClassVar[SIG_ATTRIBUTE_TYPES] = ... SPC_SP_OPUS_INFO: ClassVar[SIG_ATTRIBUTE_TYPES] = ... UNKNOWN: ClassVar[SIG_ATTRIBUTE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SUBSYSTEM: __members__: ClassVar[dict] = ... # read-only EFI_APPLICATION: ClassVar[SUBSYSTEM] = ... EFI_BOOT_SERVICE_DRIVER: ClassVar[SUBSYSTEM] = ... EFI_ROM: ClassVar[SUBSYSTEM] = ... EFI_RUNTIME_DRIVER: ClassVar[SUBSYSTEM] = ... NATIVE: ClassVar[SUBSYSTEM] = ... NATIVE_WINDOWS: ClassVar[SUBSYSTEM] = ... OS2_CUI: ClassVar[SUBSYSTEM] = ... POSIX_CUI: ClassVar[SUBSYSTEM] = ... UNKNOWN: ClassVar[SUBSYSTEM] = ... WINDOWS_BOOT_APPLICATION: ClassVar[SUBSYSTEM] = ... WINDOWS_CE_GUI: ClassVar[SUBSYSTEM] = ... WINDOWS_CUI: ClassVar[SUBSYSTEM] = ... WINDOWS_GUI: ClassVar[SUBSYSTEM] = ... XBOX: ClassVar[SUBSYSTEM] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_BASE_TYPES: __members__: ClassVar[dict] = ... # read-only BYTE: ClassVar[SYMBOL_BASE_TYPES] = ... CHAR: ClassVar[SYMBOL_BASE_TYPES] = ... DOUBLE: ClassVar[SYMBOL_BASE_TYPES] = ... DWORD: ClassVar[SYMBOL_BASE_TYPES] = ... ENUM: ClassVar[SYMBOL_BASE_TYPES] = ... FLOAT: ClassVar[SYMBOL_BASE_TYPES] = ... INT: ClassVar[SYMBOL_BASE_TYPES] = ... LONG: ClassVar[SYMBOL_BASE_TYPES] = ... MOE: ClassVar[SYMBOL_BASE_TYPES] = ... NULL: ClassVar[SYMBOL_BASE_TYPES] = ... SHORT: ClassVar[SYMBOL_BASE_TYPES] = ... STRUCT: ClassVar[SYMBOL_BASE_TYPES] = ... UINT: ClassVar[SYMBOL_BASE_TYPES] = ... UNION: ClassVar[SYMBOL_BASE_TYPES] = ... VOID: ClassVar[SYMBOL_BASE_TYPES] = ... WORD: ClassVar[SYMBOL_BASE_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_COMPLEX_TYPES: __members__: ClassVar[dict] = ... # read-only ARRAY: ClassVar[SYMBOL_COMPLEX_TYPES] = ... COMPLEX_TYPE_SHIFT: ClassVar[SYMBOL_COMPLEX_TYPES] = ... FUNCTION: ClassVar[SYMBOL_COMPLEX_TYPES] = ... NULL: ClassVar[SYMBOL_COMPLEX_TYPES] = ... POINTER: ClassVar[SYMBOL_COMPLEX_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_SECTION_NUMBER: __members__: ClassVar[dict] = ... # read-only ABSOLUTE: ClassVar[SYMBOL_SECTION_NUMBER] = ... DEBUG: ClassVar[SYMBOL_SECTION_NUMBER] = ... UNDEFINED: ClassVar[SYMBOL_SECTION_NUMBER] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class SYMBOL_STORAGE_CLASS: __members__: ClassVar[dict] = ... # read-only AUTOMATIC: ClassVar[SYMBOL_STORAGE_CLASS] = ... BIT_FIELD: ClassVar[SYMBOL_STORAGE_CLASS] = ... BLOCK: ClassVar[SYMBOL_STORAGE_CLASS] = ... CLR_TOKEN: ClassVar[SYMBOL_STORAGE_CLASS] = ... END_OF_FUNCTION: ClassVar[SYMBOL_STORAGE_CLASS] = ... END_OF_STRUCT: ClassVar[SYMBOL_STORAGE_CLASS] = ... ENUM_TAG: ClassVar[SYMBOL_STORAGE_CLASS] = ... EXTERNAL: ClassVar[SYMBOL_STORAGE_CLASS] = ... EXTERNAL_DEF: ClassVar[SYMBOL_STORAGE_CLASS] = ... FILE: ClassVar[SYMBOL_STORAGE_CLASS] = ... FUNCTION: ClassVar[SYMBOL_STORAGE_CLASS] = ... LABEL: ClassVar[SYMBOL_STORAGE_CLASS] = ... MEMBER_OF_ENUM: ClassVar[SYMBOL_STORAGE_CLASS] = ... MEMBER_OF_STRUCT: ClassVar[SYMBOL_STORAGE_CLASS] = ... NULL: ClassVar[SYMBOL_STORAGE_CLASS] = ... REGISTER: ClassVar[SYMBOL_STORAGE_CLASS] = ... REGISTER_PARAM: ClassVar[SYMBOL_STORAGE_CLASS] = ... SECTION: ClassVar[SYMBOL_STORAGE_CLASS] = ... STATIC: ClassVar[SYMBOL_STORAGE_CLASS] = ... TYPE_DEFINITION: ClassVar[SYMBOL_STORAGE_CLASS] = ... UDEFINED_STATIC: ClassVar[SYMBOL_STORAGE_CLASS] = ... UNDEFINED_LABEL: ClassVar[SYMBOL_STORAGE_CLASS] = ... UNION_TAG: ClassVar[SYMBOL_STORAGE_CLASS] = ... WEAK_EXTERNAL: ClassVar[SYMBOL_STORAGE_CLASS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Section(lief.Section): characteristics: int numberof_line_numbers: int numberof_relocations: int pointerto_line_numbers: int pointerto_raw_data: int pointerto_relocation: int sizeof_raw_data: int virtual_size: int @overload def __init__(self) -> None: ... @overload def __init__(self, content: List[int], name: str = ..., characteristics: int = ...) -> None: ... @overload def __init__(self, name: str) -> None: ... def has_characteristic(self, characteristic: lief.PE.SECTION_CHARACTERISTICS) -> bool: ... @property def characteristics_lists(self) -> Set[lief.PE.SECTION_CHARACTERISTICS]: ... @property def padding(self) -> bytes: ... class Signature(lief.Object): class VERIFICATION_CHECKS: __members__: ClassVar[dict] = ... # read-only DEFAULT: ClassVar[Signature.VERIFICATION_CHECKS] = ... HASH_ONLY: ClassVar[Signature.VERIFICATION_CHECKS] = ... LIFETIME_SIGNING: ClassVar[Signature.VERIFICATION_CHECKS] = ... SKIP_CERT_TIME: ClassVar[Signature.VERIFICATION_CHECKS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class VERIFICATION_FLAGS: __members__: ClassVar[dict] = ... # read-only BAD_DIGEST: ClassVar[Signature.VERIFICATION_FLAGS] = ... BAD_SIGNATURE: ClassVar[Signature.VERIFICATION_FLAGS] = ... CERT_EXPIRED: ClassVar[Signature.VERIFICATION_FLAGS] = ... CERT_FUTURE: ClassVar[Signature.VERIFICATION_FLAGS] = ... CERT_NOT_FOUND: ClassVar[Signature.VERIFICATION_FLAGS] = ... CORRUPTED_AUTH_DATA: ClassVar[Signature.VERIFICATION_FLAGS] = ... CORRUPTED_CONTENT_INFO: ClassVar[Signature.VERIFICATION_FLAGS] = ... INCONSISTENT_DIGEST_ALGORITHM: ClassVar[Signature.VERIFICATION_FLAGS] = ... INVALID_SIGNER: ClassVar[Signature.VERIFICATION_FLAGS] = ... MISSING_PKCS9_MESSAGE_DIGEST: ClassVar[Signature.VERIFICATION_FLAGS] = ... NO_SIGNATURE: ClassVar[Signature.VERIFICATION_FLAGS] = ... OK: ClassVar[Signature.VERIFICATION_FLAGS] = ... UNSUPPORTED_ALGORITHM: ClassVar[Signature.VERIFICATION_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... def name(self, *args, **kwargs) -> Any: ... @property def value(self) -> int: ... class it_const_crt: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.x509: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.x509: ... class it_const_signers_t: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.SignerInfo: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.SignerInfo: ... def __init__(self, *args, **kwargs) -> None: ... def check(self, checks: lief.PE.Signature.VERIFICATION_CHECKS = ...) -> lief.PE.Signature.VERIFICATION_FLAGS: ... def find_crt(self, serialno: List[int]) -> lief.PE.x509: ... @overload def find_crt_issuer(self, issuer: str) -> lief.PE.x509: ... @overload def find_crt_issuer(self, issuer: str, serialno: List[int]) -> lief.PE.x509: ... @overload def find_crt_subject(self, subject: str) -> lief.PE.x509: ... @overload def find_crt_subject(self, subject: str, serialno: List[int]) -> lief.PE.x509: ... def parse(self, *args, **kwargs) -> lief.PE.Binary | None: ... @property def certificates(self) -> lief.PE.Signature.it_const_crt: ... @property def content_info(self) -> lief.PE.ContentInfo: ... @property def digest_algorithm(self) -> lief.PE.ALGORITHMS: ... @property def raw_der(self) -> bytes: ... @property def signers(self) -> List[lief.PE.SignerInfo]: ... @property def version(self) -> int: ... class SignerInfo(lief.Object): class it_const_attributes_t: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.PE.Attribute: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.PE.Attribute: ... def __init__(self, *args, **kwargs) -> None: ... def get_attribute(self, type: lief.PE.SIG_ATTRIBUTE_TYPES) -> lief.PE.Attribute: ... def get_auth_attribute(self, type: lief.PE.SIG_ATTRIBUTE_TYPES) -> lief.PE.Attribute: ... def get_unauth_attribute(self, type: lief.PE.SIG_ATTRIBUTE_TYPES) -> lief.PE.Attribute: ... @property def authenticated_attributes(self) -> lief.PE.SignerInfo.it_const_attributes_t: ... @property def cert(self) -> lief.PE.x509: ... @property def digest_algorithm(self) -> lief.PE.ALGORITHMS: ... @property def encrypted_digest(self) -> bytes: ... @property def encryption_algorithm(self) -> lief.PE.ALGORITHMS: ... @property def issuer(self) -> object: ... @property def serial_number(self) -> bytes: ... @property def unauthenticated_attributes(self) -> lief.PE.SignerInfo.it_const_attributes_t: ... @property def version(self) -> int: ... class SpcSpOpusInfo(Attribute): def __init__(self, *args, **kwargs) -> None: ... @property def more_info(self) -> object: ... @property def program_name(self) -> object: ... class Symbol(lief.Symbol): name: str def __init__(self) -> None: ... @property def base_type(self) -> lief.PE.SYMBOL_BASE_TYPES: ... @property def complex_type(self) -> lief.PE.SYMBOL_COMPLEX_TYPES: ... @property def has_section(self) -> bool: ... @property def numberof_aux_symbols(self) -> int: ... @property def section(self) -> lief.PE.Section: ... @property def section_number(self) -> int: ... @property def storage_class(self) -> lief.PE.SYMBOL_STORAGE_CLASS: ... @property def type(self) -> int: ... class TLS(lief.Object): addressof_callbacks: int addressof_index: int addressof_raw_data: Tuple[int,int] callbacks: List[int] characteristics: int data_template: memoryview sizeof_zero_fill: int def __init__(self) -> None: ... @property def directory(self) -> lief.PE.DataDirectory: ... @property def has_data_directory(self) -> bool: ... @property def has_section(self) -> bool: ... @property def section(self) -> lief.PE.Section: ... class WINDOW_STYLES: __members__: ClassVar[dict] = ... # read-only BORDER: ClassVar[WINDOW_STYLES] = ... CAPTION: ClassVar[WINDOW_STYLES] = ... CHILD: ClassVar[WINDOW_STYLES] = ... CLIPCHILDREN: ClassVar[WINDOW_STYLES] = ... CLIPSIBLINGS: ClassVar[WINDOW_STYLES] = ... DISABLED: ClassVar[WINDOW_STYLES] = ... DLGFRAME: ClassVar[WINDOW_STYLES] = ... GROUP: ClassVar[WINDOW_STYLES] = ... HSCROLL: ClassVar[WINDOW_STYLES] = ... MAXIMIZE: ClassVar[WINDOW_STYLES] = ... MAXIMIZEBOX: ClassVar[WINDOW_STYLES] = ... MINIMIZE: ClassVar[WINDOW_STYLES] = ... MINIMIZEBOX: ClassVar[WINDOW_STYLES] = ... OVERLAPPED: ClassVar[WINDOW_STYLES] = ... POPUP: ClassVar[WINDOW_STYLES] = ... SYSMENU: ClassVar[WINDOW_STYLES] = ... TABSTOP: ClassVar[WINDOW_STYLES] = ... THICKFRAME: ClassVar[WINDOW_STYLES] = ... VISIBLE: ClassVar[WINDOW_STYLES] = ... VSCROLL: ClassVar[WINDOW_STYLES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class WIN_VERSION: __members__: ClassVar[dict] = ... # read-only SEH: ClassVar[WIN_VERSION] = ... UNKNOWN: ClassVar[WIN_VERSION] = ... WIN10_0_14286: ClassVar[WIN_VERSION] = ... WIN10_0_14383: ClassVar[WIN_VERSION] = ... WIN10_0_14901: ClassVar[WIN_VERSION] = ... WIN10_0_15002: ClassVar[WIN_VERSION] = ... WIN10_0_16237: ClassVar[WIN_VERSION] = ... WIN10_0_18362: ClassVar[WIN_VERSION] = ... WIN10_0_19534: ClassVar[WIN_VERSION] = ... WIN10_0_9879: ClassVar[WIN_VERSION] = ... WIN10_0_MSVC_2019: ClassVar[WIN_VERSION] = ... WIN10_0_MSVC_2019_16: ClassVar[WIN_VERSION] = ... WIN_8_1: ClassVar[WIN_VERSION] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class x509(lief.Object): class KEY_TYPES: __members__: ClassVar[dict] = ... # read-only ECDSA: ClassVar[x509.KEY_TYPES] = ... ECKEY: ClassVar[x509.KEY_TYPES] = ... ECKEY_DH: ClassVar[x509.KEY_TYPES] = ... NONE: ClassVar[x509.KEY_TYPES] = ... RSA: ClassVar[x509.KEY_TYPES] = ... RSASSA_PSS: ClassVar[x509.KEY_TYPES] = ... RSA_ALT: ClassVar[x509.KEY_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class KEY_USAGE: __members__: ClassVar[dict] = ... # read-only CRL_SIGN: ClassVar[x509.KEY_USAGE] = ... DATA_ENCIPHERMENT: ClassVar[x509.KEY_USAGE] = ... DECIPHER_ONLY: ClassVar[x509.KEY_USAGE] = ... DIGITAL_SIGNATURE: ClassVar[x509.KEY_USAGE] = ... ENCIPHER_ONLY: ClassVar[x509.KEY_USAGE] = ... KEY_AGREEMENT: ClassVar[x509.KEY_USAGE] = ... KEY_CERT_SIGN: ClassVar[x509.KEY_USAGE] = ... KEY_ENCIPHERMENT: ClassVar[x509.KEY_USAGE] = ... NON_REPUDIATION: ClassVar[x509.KEY_USAGE] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class VERIFICATION_FLAGS: __members__: ClassVar[dict] = ... # read-only BADCERT_BAD_KEY: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_BAD_MD: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_BAD_PK: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_CN_MISMATCH: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_EXPIRED: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_EXT_KEY_USAGE: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_FUTURE: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_KEY_USAGE: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_MISSING: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_NOT_TRUSTED: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_NS_CERT_TYPE: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_OTHERNATURE: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_REVOKED: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCERT_SKIP_VERIFY: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCRL_BAD_KEY: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCRL_BAD_MD: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCRL_BAD_PK: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCRL_EXPIRED: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCRL_FUTURE: ClassVar[x509.VERIFICATION_FLAGS] = ... BADCRL_NOT_TRUSTED: ClassVar[x509.VERIFICATION_FLAGS] = ... OK: ClassVar[x509.VERIFICATION_FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def __init__(self, *args, **kwargs) -> None: ... @overload def is_trusted_by(self, ca_list: List[lief.PE.x509]) -> lief.PE.x509.VERIFICATION_FLAGS: ... @overload def is_trusted_by(self, microsoft_ca_bundle) -> lief.PE.x509.VERIFICATION_FLAGS: ... def parse(self, *args, **kwargs) -> lief.PE.Binary | None: ... @overload def verify(self, ca: lief.PE.x509) -> lief.PE.x509.VERIFICATION_FLAGS: ... @overload def verify(self, signer) -> lief.PE.x509.VERIFICATION_FLAGS: ... @property def certificate_policies(self) -> List[str]: ... @property def ext_key_usage(self) -> List[str]: ... @property def is_ca(self) -> bool: ... @property def issuer(self) -> object: ... @property def key_type(self) -> lief.PE.x509.KEY_TYPES: ... @property def key_usage(self) -> List[lief.PE.x509.KEY_USAGE]: ... @property def raw(self) -> bytes: ... @property def rsa_info(self) -> lief.PE.RsaInfo: ... @property def serial_number(self) -> bytes: ... @property def signature(self) -> bytes: ... @property def signature_algorithm(self) -> str: ... @property def subject(self) -> object: ... @property def valid_from(self) -> List[int]: ... @property def valid_to(self) -> List[int]: ... @property def version(self) -> int: ... def get_imphash(binary: lief.PE.Binary, mode: lief.PE.IMPHASH_MODE = ...) -> str: ... @overload def get_type(file: str) -> object: ... @overload def get_type(raw: List[int]) -> object: ... @overload def is_pe(file: str) -> bool: ... @overload def is_pe(raw: List[int]) -> bool: ... def oid_to_string(arg0: str) -> str: ... @overload def parse(filename: str) -> lief.PE.Binary | None: ... @overload def parse(raw: List[int], name: str = ...) -> lief.PE.Binary | None: ... @overload def parse(io: object, name: str = ...) -> lief.PE.Binary | None: ... def resolve_ordinals(imp: lief.PE.Import, strict: bool = ..., use_std: bool = ...) -> object: ... LIEF-0.13.1/api/python/lief/VDEX.pyi000066400000000000000000000024611443457337100166330ustar00rootroot00000000000000from typing import List from typing import overload import lief # type: ignore import lief.Android # type: ignore import lief.OAT # type: ignore import lief.VDEX # type: ignore class File(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def dex2dex_json_info(self) -> str: ... @property def dex_files(self) -> lief.OAT.Binary.it_dex_files: ... @property def header(self) -> lief.VDEX.Header: ... class Header(lief.Object): def __init__(self, *args, **kwargs) -> None: ... @property def dex_size(self) -> int: ... @property def magic(self) -> List[int]: ... @property def nb_dex_files(self) -> int: ... @property def quickening_info_size(self) -> int: ... @property def verifier_deps_size(self) -> int: ... @property def version(self) -> int: ... def android_version(vdex_version: int) -> lief.Android.ANDROID_VERSIONS: ... @overload def is_vdex(path: str) -> bool: ... @overload def is_vdex(raw: List[int]) -> bool: ... @overload def parse(filename: str) -> lief.VDEX.File: ... @overload def parse(raw: List[int], name: str = ...) -> lief.VDEX.File: ... @overload def parse(io: object, name: str = ...) -> lief.VDEX.File: ... @overload def version(file: str) -> int: ... @overload def version(raw: List[int]) -> int: ... LIEF-0.13.1/api/python/lief/__init__.py000066400000000000000000000006131443457337100174500ustar00rootroot00000000000000import sys from . import _lief from ._lief import * from ._lief import __version__, __tag__, __commit__, __is_tagged__ # cf. https://github.com/pytorch/pytorch/blob/60a3b7425dde97fe8b46183c154a9c3b24f0c733/torch/__init__.py#L467-L470 for attr in dir(_lief): candidate = getattr(_lief, attr) if type(candidate) is type(_lief): sys.modules.setdefault(f"lief.{attr}", candidate) LIEF-0.13.1/api/python/lief/__init__.pyi000066400000000000000000000262241443457337100176270ustar00rootroot00000000000000from typing import Any, ClassVar, Iterator, List, Set from . import ART, Android, DEX, ELF, MachO, OAT, PE, VDEX, logging # type: ignore from typing import overload import lief # type: ignore class ARCHITECTURES: __members__: ClassVar[dict] = ... # read-only ARM: ClassVar[ARCHITECTURES] = ... ARM64: ClassVar[ARCHITECTURES] = ... INTEL: ClassVar[ARCHITECTURES] = ... MIPS: ClassVar[ARCHITECTURES] = ... NONE: ClassVar[ARCHITECTURES] = ... PPC: ClassVar[ARCHITECTURES] = ... RISCV: ClassVar[ARCHITECTURES] = ... SPARC: ClassVar[ARCHITECTURES] = ... SYSZ: ClassVar[ARCHITECTURES] = ... X86: ClassVar[ARCHITECTURES] = ... XCORE: ClassVar[ARCHITECTURES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Binary(Object): class VA_TYPES: __members__: ClassVar[dict] = ... # read-only AUTO: ClassVar[Binary.VA_TYPES] = ... RVA: ClassVar[Binary.VA_TYPES] = ... VA: ClassVar[Binary.VA_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class it_relocations: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.Relocation: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.Relocation: ... class it_sections: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.Section: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.Section: ... class it_symbols: def __init__(self, *args, **kwargs) -> None: ... def __getitem__(self, arg0: int) -> lief.Symbol: ... def __iter__(self) -> Iterator: ... def __len__(self) -> int: ... def __next__(self) -> lief.Symbol: ... name: str def __init__(self, *args, **kwargs) -> None: ... def get_content_from_virtual_address(self, virtual_address: int, size: int, va_type: lief.Binary.VA_TYPES = ...) -> memoryview: ... def get_function_address(self, function_name: str) -> object: ... def get_symbol(self, symbol_name: str) -> lief.Symbol: ... def has_symbol(self, symbol_name: str) -> bool: ... def offset_to_virtual_address(self, offset: int, slide: int = ...) -> object: ... @overload def patch_address(self, address: int, patch_value: List[int], va_type: lief.Binary.VA_TYPES = ...) -> None: ... @overload def patch_address(self, address: int, patch_value: int, size: int = ..., va_type: lief.Binary.VA_TYPES = ...) -> None: ... def remove_section(self, name: str, clear: bool = ...) -> None: ... def xref(self, virtual_address: int) -> List[int]: ... @property def abstract(self) -> lief.Binary: ... @property def concrete(self) -> lief.ELF.Binary | lief.PE.Binary | lief.MachO.Binary: ... @property def ctor_functions(self) -> List[lief.Function]: ... @property def entrypoint(self) -> int: ... @property def exported_functions(self) -> Any: ... @property def format(self) -> lief.EXE_FORMATS: ... @property def has_nx(self) -> bool: ... @property def header(self) -> Any: ... @property def imagebase(self) -> int: ... @property def imported_functions(self) -> Any: ... @property def is_pie(self) -> bool: ... @property def libraries(self) -> Any: ... @property def relocations(self) -> Any: ... @property def sections(self) -> Any: ... @property def symbols(self) -> Any: ... class ENDIANNESS: __members__: ClassVar[dict] = ... # read-only BIG: ClassVar[ENDIANNESS] = ... LITTLE: ClassVar[ENDIANNESS] = ... NONE: ClassVar[ENDIANNESS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class EXE_FORMATS: __members__: ClassVar[dict] = ... # read-only ELF: ClassVar[EXE_FORMATS] = ... MACHO: ClassVar[EXE_FORMATS] = ... PE: ClassVar[EXE_FORMATS] = ... UNKNOWN: ClassVar[EXE_FORMATS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Function(Symbol): class FLAGS: __members__: ClassVar[dict] = ... # read-only CONSTRUCTOR: ClassVar[Function.FLAGS] = ... DEBUG: ClassVar[Function.FLAGS] = ... DESTRUCTOR: ClassVar[Function.FLAGS] = ... EXPORTED: ClassVar[Function.FLAGS] = ... IMPORTED: ClassVar[Function.FLAGS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... address: int @overload def __init__(self) -> None: ... @overload def __init__(self, arg0: str) -> None: ... @overload def __init__(self, arg0: int) -> None: ... @overload def __init__(self, arg0: str, arg1: int) -> None: ... def add(self, flag: lief.Function.FLAGS) -> lief.Function: ... @property def flags(self) -> List[lief.Function.FLAGS]: ... class Header(Object): architecture: Any endianness: lief.ENDIANNESS entrypoint: int modes: Set[lief.MODES] object_type: lief.OBJECT_TYPES def __init__(self) -> None: ... @property def is_32(self) -> bool: ... @property def is_64(self) -> bool: ... class MODES: __members__: ClassVar[dict] = ... # read-only ARM: ClassVar[MODES] = ... M16: ClassVar[MODES] = ... M32: ClassVar[MODES] = ... M64: ClassVar[MODES] = ... MCLASS: ClassVar[MODES] = ... MIPS3: ClassVar[MODES] = ... MIPS32: ClassVar[MODES] = ... MIPS32R6: ClassVar[MODES] = ... MIPS64: ClassVar[MODES] = ... MIPSGP64: ClassVar[MODES] = ... NONE: ClassVar[MODES] = ... THUMB: ClassVar[MODES] = ... UNDEFINED: ClassVar[MODES] = ... V7: ClassVar[MODES] = ... V8: ClassVar[MODES] = ... V9: ClassVar[MODES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class OBJECT_TYPES: __members__: ClassVar[dict] = ... # read-only EXECUTABLE: ClassVar[OBJECT_TYPES] = ... LIBRARY: ClassVar[OBJECT_TYPES] = ... NONE: ClassVar[OBJECT_TYPES] = ... OBJECT: ClassVar[OBJECT_TYPES] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Object: def __init__(self, *args, **kwargs) -> None: ... class PLATFORMS: __members__: ClassVar[dict] = ... # read-only ANDROID: ClassVar[PLATFORMS] = ... IOS: ClassVar[PLATFORMS] = ... LINUX: ClassVar[PLATFORMS] = ... OSX: ClassVar[PLATFORMS] = ... UNKNOWN: ClassVar[PLATFORMS] = ... WINDOWS: ClassVar[PLATFORMS] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class Relocation(Object): address: int size: int @overload def __init__(self) -> None: ... @overload def __init__(self, address: int, size: int) -> None: ... class Section(Object): content: memoryview name: object offset: int size: int virtual_address: int @overload def __init__(self) -> None: ... @overload def __init__(self, name: str) -> None: ... @overload def search(self, number: int, pos: int = ..., size: int = ...) -> int | None: ... @overload def search(self, str: str, pos: int = ...) -> int | None: ... @overload def search(self, bytes: bytes, pos: int = ...) -> int | None: ... @overload def search_all(self, number: int, size: int = ...) -> List[int]: ... @overload def search_all(self, str: str) -> List[int]: ... @property def entropy(self) -> float: ... @property def fullname(self) -> str: ... class Symbol(Object): name: object size: int value: int def __init__(self) -> None: ... class lief_errors: __members__: ClassVar[dict] = ... # read-only __entries: ClassVar[dict] = ... asn1_bad_tag: ClassVar[lief_errors] = ... build_error: ClassVar[lief_errors] = ... conversion_error: ClassVar[lief_errors] = ... corrupted: ClassVar[lief_errors] = ... data_too_large: ClassVar[lief_errors] = ... file_error: ClassVar[lief_errors] = ... file_format_error: ClassVar[lief_errors] = ... not_found: ClassVar[lief_errors] = ... not_implemented: ClassVar[lief_errors] = ... not_supported: ClassVar[lief_errors] = ... parsing_error: ClassVar[lief_errors] = ... read_error: ClassVar[lief_errors] = ... read_out_of_bound: ClassVar[lief_errors] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... class ok_t: def __init__(self, *args, **kwargs) -> None: ... def __bool__(self) -> bool: ... @overload def art_version(filename: str) -> int: ... @overload def art_version(raw: List[int]) -> int: ... def breakp() -> object: ... def current_platform() -> lief.PLATFORMS: ... def demangle(arg0: str) -> object: ... @overload def dex_version(filename: str) -> int: ... @overload def dex_version(raw: List[int]) -> int: ... @overload def hash(arg0: lief.Object) -> int: ... @overload def hash(arg0: List[int]) -> int: ... @overload def hash(arg0: bytes) -> int: ... @overload def hash(arg0: str) -> int: ... @overload def is_art(filename: str) -> bool: ... @overload def is_art(raw: List[int]) -> bool: ... @overload def is_dex(filename: str) -> bool: ... @overload def is_dex(raw: List[int]) -> bool: ... @overload def is_elf(filename: str) -> bool: ... @overload def is_elf(raw: List[int]) -> bool: ... @overload def is_macho(filename: str) -> bool: ... @overload def is_macho(raw: List[int]) -> bool: ... @overload def is_oat(filename: str) -> bool: ... @overload def is_oat(raw: List[int]) -> bool: ... @overload def is_oat(elf: lief.ELF.Binary) -> bool: ... @overload def is_pe(filename: str) -> bool: ... @overload def is_pe(raw: List[int]) -> bool: ... @overload def is_vdex(filename: str) -> bool: ... @overload def is_vdex(raw: List[int]) -> bool: ... @overload def oat_version(filename: str) -> int: ... @overload def oat_version(raw: List[int]) -> int: ... @overload def oat_version(elf: lief.ELF.Binary) -> int: ... @overload def parse(raw: bytes, name: str = ...) -> lief.Binary: ... @overload def parse(filepath: str) -> lief.Binary: ... @overload def parse(io: object, name: str = ...) -> object: ... def shell() -> object: ... def to_json(arg0: lief.Object) -> str: ... def to_json_from_abstract(arg0: lief.Object) -> str: ... @overload def vdex_version(filename: str) -> int: ... @overload def vdex_version(raw: List[int]) -> int: ... LIEF-0.13.1/api/python/lief/logging.pyi000066400000000000000000000014151443457337100175110ustar00rootroot00000000000000from typing import ClassVar import lief.logging # type: ignore class LOGGING_LEVEL: __members__: ClassVar[dict] = ... # read-only CRITICAL: ClassVar[LOGGING_LEVEL] = ... DEBUG: ClassVar[LOGGING_LEVEL] = ... ERROR: ClassVar[LOGGING_LEVEL] = ... INFO: ClassVar[LOGGING_LEVEL] = ... TRACE: ClassVar[LOGGING_LEVEL] = ... WARNING: ClassVar[LOGGING_LEVEL] = ... __entries: ClassVar[dict] = ... def __init__(self, value: int) -> None: ... @property def name(self) -> str: ... @property def value(self) -> int: ... def disable() -> None: ... def enable() -> None: ... def log(level: lief.logging.LOGGING_LEVEL, msg: str) -> None: ... def set_level(level: lief.logging.LOGGING_LEVEL) -> None: ... def set_path(path: str) -> None: ... LIEF-0.13.1/api/python/lief/py.typed000066400000000000000000000000001443457337100170240ustar00rootroot00000000000000LIEF-0.13.1/api/python/pyproject.toml000066400000000000000000000016671443457337100173460ustar00rootroot00000000000000[build-system] requires = ["setuptools", "wheel", "tomli"] build-backend = "setuptools.build_meta" [project] name = "lief" authors = [ {name = "Romain Thomas", email = "contact@lief.re"}, ] description = "Library to instrument executable formats" requires-python = ">=3.8" keywords = ["parser", "elf", "pe", "macho", "reverse-engineering"] license = {text = "Apache License 2.0"} classifiers = [ "Development Status :: 4 - Beta", "Programming Language :: Python :: 3", "Programming Language :: C++", "Topic :: Software Development :: Libraries", ] dynamic = ["version", "readme"] [project.urls] homepage = "https://lief-project.github.io/" documentation = "https://lief-project.github.io/doc/latest/" repository = "https://github.com/lief-project/LIEF" changelog = "https://lief-project.github.io/doc/latest/changelog.html" Funding = "https://lief-project.github.io/about" Tracker = "https://github.com/lief-project/LIEF/issues" LIEF-0.13.1/api/python/setup.py000066400000000000000000000320421443457337100161330ustar00rootroot00000000000000import os import platform import setuptools import subprocess import sys import sysconfig import tomli from typing import List, Optional from pathlib import Path from setuptools import setup, Extension from setuptools.command.build_ext import build_ext from shutil import copy2, which CURRENT_DIR = Path(__file__).parent LIEF_DIR = (CURRENT_DIR / ".." / "..").absolute().resolve() PACKAGE_NAME = "lief" PYLIEF_CONF_ENV = "PYLIEF_CONF" ENV = os.environ cmake_conf = None def report(*args): print(*args) class Config: def __init__(self, config: dict): self._config = config if "cross-compilation" in self._config["lief"]: cross_conf = self._config["lief"]["cross-compilation"] if "platform" in cross_conf: platform = cross_conf["platform"] if os.name == "nt" and platform == "win32": ENV["VSCMD_ARG_TGT_ARCH"] = "x86" os.environ["VSCMD_ARG_TGT_ARCH"] = "x86" @classmethod def from_file(cls, file: Path): with open(file, "rb") as f: toml_config = tomli.load(f) return cls(toml_config) @staticmethod def is_windows() -> bool: return platform.system() == "Windows" and not sysconfig.get_platform().startswith("mingw") def build_type(self) -> str: return self._config['lief']['build']['type'] def gen_cmake_option(self, output: str) -> List[str]: cfg = self.build_type() opt = [ f"-DCMAKE_BUILD_TYPE={cfg}", f'-DCMAKE_LIBRARY_OUTPUT_DIRECTORY={output}', "-DLIEF_USE_CCACHE={}".format("ON" if self._config["lief"]["build"]["cache"] else "OFF"), ] + [ "-DLIEF_FORCE_API_EXPORTS=ON", "-DLIEF_PYTHON_API=on", f"-DPYTHON_EXECUTABLE={sys.executable}", ] + [ "-DLIEF_ELF={}".format("ON" if self._config["lief"]["formats"]["elf"] else "OFF"), "-DLIEF_PE={}".format("ON" if self._config["lief"]["formats"]["pe"] else "OFF"), "-DLIEF_MACHO={}".format("ON" if self._config["lief"]["formats"]["macho"] else "OFF"), "-DLIEF_DEX={}".format("ON" if self._config["lief"]["formats"]["dex"] else "OFF"), "-DLIEF_ART={}".format("ON" if self._config["lief"]["formats"]["art"] else "OFF"), "-DLIEF_OAT={}".format("ON" if self._config["lief"]["formats"]["oat"] else "OFF"), "-DLIEF_VDEX={}".format("ON" if self._config["lief"]["formats"]["vdex"] else "OFF"), ] + [ "-DLIEF_LOGGING={}".format("ON" if self._config["lief"]["logging"]["enabled"] else "OFF"), "-DLIEF_LOGGING_DEBUG={}".format("ON" if self._config["lief"]["logging"]["debug"] else "OFF"), ] + [ "-DLIEF_ENABLE_JSON={}".format("ON" if self._config["lief"]["features"]["json"] else "OFF"), "-DLIEF_DISABLE_FROZEN={}".format("OFF" if self._config["lief"]["features"]["frozen"] else "ON"), ] + [ "-DLIEF_ENABLE_JSON={}".format("ON" if self._config["lief"]["features"]["json"] else "OFF"), "-DLIEF_DISABLE_FROZEN={}".format("OFF" if self._config["lief"]["features"]["frozen"] else "ON"), ] if "include-what-you-use" in self._config["lief"]["build"]: value = self._config["lief"]["build"]["include-what-you-use"] opt.append(f"-DCMAKE_CXX_INCLUDE_WHAT_YOU_USE={value}") else: opt.append("-DCMAKE_CXX_INCLUDE_WHAT_YOU_USE=''") cxx_flags = os.getenv("CXXFLAGS", None) c_flags = os.getenv("CFLAGS", None) if cxx_flags is not None: opt.append(f'-DCMAKE_CXX_FLAGS={cxx_flags}') if c_flags is not None: opt.append(f'-DCMAKE_C_FLAGS={c_flags}') if self._use_ninja(): opt = ["-G", "Ninja"] + opt opt += self._get_third_party_opt() opt += self._get_cross_compile_opt() if Config.is_windows(): is64 = sys.maxsize > 2**32 opt += [ f'-DCMAKE_LIBRARY_OUTPUT_DIRECTORY_{cfg.upper()}={output}', f'-DLIEF_USE_CRT_{cfg.upper()}=MT', ] if self._use_ninja(): from setuptools import msvc arch = 'x64' if is64 else 'x86' report(f"Arch: {arch}") ninja_env = msvc.msvc14_get_vc_env(arch) ENV.update(ninja_env) else: opt += ['-A', 'x64'] if is64 else ['-A', 'win32'] return opt def _get_third_party_opt(self) -> List[str]: if "third-party" not in self._config["lief"]: return [] cmake_opt = [] tp_conf = self._config["lief"]["third-party"] if "spdlog" in tp_conf: cmake_opt += [ "-DLIEF_EXTERNAL_SPDLOG=ON", "-Dspdlog_DIR={}".format(tp_conf["spdlog"]) ] return cmake_opt def _get_cross_compile_opt(self) -> List[str]: if "cross-compilation" not in self._config["lief"]: return [] cmake_opt = [] cross_conf = self._config["lief"]["cross-compilation"] if "osx-arch" in cross_conf: cmake_opt += [ f'-DCMAKE_OSX_ARCHITECTURES={cross_conf["osx-arch"]}' ] return cmake_opt def _get_jobs(self) -> List[str]: if "parallel-jobs" in self._config["lief"]["build"]: jobs = self._config["lief"]["build"]["parallel-jobs"] if jobs > 0: return ["-j", str(jobs)] return [] return [] def get_target_osx_arch(self) -> str: if "cross-compilation" in self._config["lief"]: cross_conf = self._config["lief"]["cross-compilation"] if "osx-arch" in cross_conf: arch = cross_conf["osx-arch"] return arch return platform.machine() def _use_ninja(self) -> bool: return self._config['lief']['build']['ninja'] def _win_compile_cmd(self): return [ 'cmake', '--build', '.', '--target', 'pyLIEF', '--config', self._config['lief']['build']['type'], ] def _unix_compile_cmd(self): gen = which("ninja") if self._use_ninja() else which("make") return [gen] + self._get_jobs() + ["pyLIEF"] def get_compile_cmd(self): if Config.is_windows(): return self._win_compile_cmd() return self._unix_compile_cmd() class Versioning: COMMAND = '{git} describe --tags --long --dirty' GIT_BRANCH = '{git} rev-parse --abbrev-ref HEAD' IS_TAGGED_CMD = '{git} tag --list --points-at=HEAD' FMT_DEV = '{tag}.dev0' FMT_TAGGED = '{tag}' DEFAULT_VERSION = "0.13.1" def __init__(self): self._git = which("git") def _exec_git_cmd(self, cmd: str, **kwargs) -> str: args = dict(kwargs) args["git"] = self._git cmd_list = cmd.format(**args).split() return subprocess.check_output(cmd_list).decode('utf-8').strip() def has_git(self) -> bool: return self._git is not None and (LIEF_DIR / ".git").is_dir() def get_branch(self) -> Optional[str]: if not self.has_git(): return None try: return self._exec_git_cmd(Versioning.GIT_BRANCH) except subprocess.SubprocessError as e: report(f"Error: {e}") return None def format_version(self, version: str, fmt: str, is_dev: bool = False): branch = self.get_branch() if branch is not None and branch.startswith("release-"): _, version = branch.split("release-") return version parts = version.split('-') assert len(parts) in (3, 4) dirty = len(parts) == 4 tag, count, sha = parts[:3] MA, MI, PA = map(int, tag.split(".")) # 0.9.0 -> (0, 9, 0) if is_dev: tag = f"{MA}.{MI + 1}.{0}" if count == '0' and not dirty: return tag return fmt.format(tag=tag, gitsha=sha.lstrip('g')) def version_from_git(self) -> str: try: is_tagged = self._exec_git_cmd(Versioning.IS_TAGGED_CMD) != "" git_version = self._exec_git_cmd(Versioning.COMMAND) if is_tagged: return self.format_version(version=git_version, fmt=Versioning.FMT_TAGGED) return self.format_version(version=git_version, fmt=Versioning.FMT_DEV, is_dev=True) except Exception as e: report(f"Error: {e}") return Versioning.DEFAULT_VERSION def get_version(self) -> str: if self.has_git(): return self.version_from_git() return Versioning.DEFAULT_VERSION class LiefDistribution(setuptools.Distribution): def __init__(self, attrs=None): super().__init__(attrs) class Module(Extension): def __init__(self, name, sourcedir='', *args, **kwargs): Extension.__init__(self, name, sources=[]) self.sourcedir = CURRENT_DIR.resolve().absolute().as_posix() class BuildLibrary(build_ext): def __init__(self, *args, **kwargs): self._fix_platform() super().__init__(*args, **kwargs) def run(self): for ext in self.extensions: self.build_extension(ext) self.copy_extensions_to_source() def _fix_platform(self): if sys.platform == "darwin": deployment_target = os.getenv("MACOSX_DEPLOYMENT_TARGET", None) machine = cmake_conf.get_target_osx_arch() if deployment_target is None: deployment_target = sysconfig.get_config_var("MACOSX_DEPLOYMENT_TARGET") os.environ["_PYTHON_HOST_PLATFORM"] = f"macosx-{deployment_target}-{machine}" report("Using platform: ", os.environ["_PYTHON_HOST_PLATFORM"]) else: if "cross-compilation" in cmake_conf._config["lief"]: cross_conf = cmake_conf._config["lief"]["cross-compilation"] if "platform" in cross_conf: platform = cross_conf["platform"] os.environ["_PYTHON_HOST_PLATFORM"] = platform ENV["_PYTHON_HOST_PLATFORM"] = platform report("Using platform: ", platform) if os.name == "nt" and platform == "win32": self.plat_name = "win32" version_fixed = sys.version.lower().replace("amd64", "") sys.version = version_fixed sys.platform = "win32" def build_extension(self, ext): build_temp = Path(self.build_temp) build_lib = Path(self.build_lib) cmake_output = build_temp.parent.absolute() cmake_bin = which("cmake") if cmake_bin is None: raise RuntimeError("Can't find cmake") build_temp.mkdir(exist_ok=True, parents=True) build_lib.mkdir(exist_ok=True, parents=True) report(f"build-temp: {build_temp}") report(f"build-lib: {build_lib}") report(f"Platform : {platform.system()}") report(f"Wheel library: {self.get_ext_fullname(ext.name)}") cmake_subprocess_args = { 'cwd': build_temp.as_posix(), 'env': ENV, } # 1. Configure configure_cmd = [cmake_bin, "-S", LIEF_DIR.as_posix()] + cmake_conf.gen_cmake_option(cmake_output) report("CMake Config:", " ".join(configure_cmd)) subprocess.check_call(configure_cmd, **cmake_subprocess_args) compile_cmd = cmake_conf.get_compile_cmd() report(" ".join(configure_cmd)) subprocess.check_call(compile_cmd, **cmake_subprocess_args) pylief_dst = build_lib / self.get_ext_filename(self.get_ext_fullname(ext.name)) libsuffix = pylief_dst.suffix pylief_path = cmake_output / f"{PACKAGE_NAME}{libsuffix}" if Config.is_windows(): pylief_base = cmake_output / "Release" / "api" / "python" pylief_path = pylief_base / cmake_conf.build_type() / f"{PACKAGE_NAME}{libsuffix}" if not pylief_path.is_file(): pylief_path = pylief_base / f"{PACKAGE_NAME}{libsuffix}" pylief_path = pylief_path.as_posix() dst = Path(pylief_dst) dst.parent.mkdir(exist_ok=True) report(f"Copying {pylief_path} into {pylief_dst}") if not self.dry_run: copy2(pylief_path, pylief_dst) versioning = Versioning() version = versioning.get_version() report(f"Version is: {version}") conf_env = os.getenv(PYLIEF_CONF_ENV, None) conf_file = CURRENT_DIR / "config-default.toml" if conf_env is None else Path(conf_env).absolute().resolve() cmake_conf = Config.from_file(conf_file) cmdclass = { 'build_ext': BuildLibrary, } long_description = LIEF_DIR / "package" / "README.rst" setup( long_description=long_description.read_text(), long_description_content_type="text/x-rst; charset=UTF-8", distclass=LiefDistribution, scripts=['examples/elf_reader.py', 'examples/pe_reader.py', 'examples/macho_reader.py'], packages=["lief"], package_data={"lief": ["py.typed", "*.pyi"]}, ext_modules=[Module("lief._lief")], cmdclass=cmdclass, version=version ) LIEF-0.13.1/api/python/src/000077500000000000000000000000001443457337100152075ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/ART/000077500000000000000000000000001443457337100156355ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/ART/CMakeLists.txt000066400000000000000000000012501443457337100203730ustar00rootroot00000000000000set(LIEF_PYTHON_ART_SRC "${CMAKE_CURRENT_LIST_DIR}/pyART.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyEnums.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyUtils.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyFile.cpp" ) set(LIEF_PYTHON_ART_HDR "${CMAKE_CURRENT_LIST_DIR}/pyART.hpp") source_group("Source Files\\ART" FILES ${LIEF_PYTHON_ART_SRC}) source_group("Header Files\\ART" FILES ${LIEF_PYTHON_ART_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_ART_SRC}" "${LIEF_PYTHON_ART_HDR}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}" "${CMAKE_CURRENT_LIST_DIR}/../") LIEF-0.13.1/api/python/src/ART/objects/000077500000000000000000000000001443457337100172665ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/ART/objects/pyFile.cpp000066400000000000000000000032621443457337100212250ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/ART/File.hpp" #include "LIEF/ART/hash.hpp" #include "pyART.hpp" namespace LIEF { namespace ART { template using no_const_getter = T (File::*)(void); template using no_const_func = T (File::*)(P); template using getter_t = T (File::*)(void) const; template using setter_t = void (File::*)(T); template<> void create(py::module& m) { // File object py::class_(m, "File", "ART File representation") .def_property_readonly("header", static_cast>(&File::header), "Return the ART " RST_CLASS_REF(lief.ART.Header) "", py::return_value_policy::reference) .def("__eq__", &File::operator==) .def("__ne__", &File::operator!=) .def("__hash__", [] (const File& file) { return Hash::hash(file); }) .def("__str__", [] (const File& file) { std::ostringstream stream; stream << file; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ART/objects/pyHeader.cpp000066400000000000000000000070501443457337100215350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/ART/Header.hpp" #include "LIEF/ART/hash.hpp" #include "pyART.hpp" namespace LIEF { namespace ART { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template<> void create
(py::module& m) { py::class_(m, "Header", "ART Header representation") .def_property_readonly("magic", static_cast>(&Header::magic) ) .def_property_readonly("version", static_cast>(&Header::version) ) .def_property_readonly("image_begin", static_cast>(&Header::image_begin) ) .def_property_readonly("image_size", static_cast>(&Header::image_size) ) .def_property_readonly("oat_checksum", static_cast>(&Header::oat_checksum) ) .def_property_readonly("oat_file_begin", static_cast>(&Header::oat_file_begin) ) .def_property_readonly("oat_file_end", static_cast>(&Header::oat_file_end) ) .def_property_readonly("oat_data_end", static_cast>(&Header::oat_data_end) ) .def_property_readonly("patch_delta", static_cast>(&Header::patch_delta) ) .def_property_readonly("image_roots", static_cast>(&Header::image_roots) ) .def_property_readonly("pointer_size", static_cast>(&Header::pointer_size) ) .def_property_readonly("compile_pic", static_cast>(&Header::compile_pic) ) .def_property_readonly("nb_sections", static_cast>(&Header::nb_sections) ) .def_property_readonly("nb_methods", static_cast>(&Header::nb_methods) ) .def_property_readonly("boot_image_begin", static_cast>(&Header::boot_image_begin) ) .def_property_readonly("boot_image_size", static_cast>(&Header::boot_image_size) ) .def_property_readonly("boot_oat_begin", static_cast>(&Header::boot_oat_begin) ) .def_property_readonly("boot_oat_size", static_cast>(&Header::boot_oat_size) ) .def_property_readonly("storage_mode", static_cast>(&Header::storage_mode) ) .def_property_readonly("data_size", static_cast>(&Header::data_size) ) .def("__eq__", &Header::operator==) .def("__ne__", &Header::operator!=) .def("__hash__", [] (const Header& header) { return Hash::hash(header); }) .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ART/objects/pyParser.cpp000066400000000000000000000046441443457337100216070ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyART.hpp" #include "LIEF/ART/Parser.hpp" #include namespace LIEF { namespace ART { template<> void create(py::module& m) { // Parser (Parser) m.def("parse", static_cast (*) (const std::string&)>(&Parser::parse), "Parse the given filename and return an " RST_CLASS_REF(lief.ART.File) " object", "filename"_a, py::return_value_policy::take_ownership); m.def("parse", static_cast (*) (std::vector, const std::string&)>(&Parser::parse), "Parse the given raw data and return an " RST_CLASS_REF(lief.ART.File) " object", "raw"_a, "name"_a = "", py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, const std::string& name) { const auto& io = py::module::import("io"); const auto& RawIOBase = io.attr("RawIOBase"); const auto& BufferedIOBase = io.attr("BufferedIOBase"); const auto& TextIOBase = io.attr("TextIOBase"); py::object rawio; if (py::isinstance(byteio, RawIOBase)) { rawio = byteio; } else if (py::isinstance(byteio, BufferedIOBase)) { rawio = byteio.attr("raw"); } else if (py::isinstance(byteio, TextIOBase)) { rawio = byteio.attr("buffer").attr("raw"); } else { throw py::type_error(py::repr(byteio).cast().c_str()); } std::string raw_str = static_cast(rawio.attr("readall")()); std::vector raw = { std::make_move_iterator(std::begin(raw_str)), std::make_move_iterator(std::end(raw_str))}; return LIEF::ART::Parser::parse(std::move(raw), name); }, "io"_a, "name"_a = "", py::return_value_policy::take_ownership); } } } LIEF-0.13.1/api/python/src/ART/pyART.cpp000066400000000000000000000017701443457337100173450ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyART.hpp" namespace LIEF { namespace ART { void init_python_module(py::module& m) { py::module LIEF_ART_module = m.def_submodule("ART", "Python API for ART format"); init_enums(LIEF_ART_module); init_objects(LIEF_ART_module); init_utils(LIEF_ART_module); } void init_objects(py::module& m) { CREATE(Parser, m); CREATE(File, m); CREATE(Header, m); } } } LIEF-0.13.1/api/python/src/ART/pyART.hpp000066400000000000000000000022261443457337100173470ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ART_H_ #define PY_LIEF_ART_H_ #include "LIEF/ART.hpp" #include "pyLIEF.hpp" #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) namespace LIEF { namespace ART { template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_enums(py::module&); void init_utils(py::module&); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(File); SPECIALIZE_CREATE(Header); } } #endif LIEF-0.13.1/api/python/src/ART/pyEnums.cpp000066400000000000000000000020121443457337100177740ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyART.hpp" #include "LIEF/ART/enums.hpp" #include "LIEF/ART/EnumToString.hpp" #define PY_ENUM(x) to_string(x), x namespace LIEF { namespace ART { void init_enums(py::module& m) { py::enum_(m, "STORAGE_MODES") .value(PY_ENUM(STORAGE_MODES::STORAGE_UNCOMPRESSED)) .value(PY_ENUM(STORAGE_MODES::STORAGE_LZ4)) .value(PY_ENUM(STORAGE_MODES::STORAGE_LZ4HC)); } } } LIEF-0.13.1/api/python/src/ART/pyUtils.cpp000066400000000000000000000031241443457337100200120ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyART.hpp" #include "LIEF/ART/utils.hpp" namespace LIEF { namespace ART { void init_utils(py::module& m) { m.def("is_art", static_cast(&is_art), "Check if the **file** given in parameter is an ART", "path"_a); m.def("is_art", static_cast&)>(&is_art), "Check if the **raw data** given in parameter is a ART", "raw"_a); m.def("version", static_cast(&version), "Return the ART version of the **file** given in parameter", "file"_a); m.def("version", static_cast&)>(&version), "Return the ART version of the **raw data** given in parameter", "raw"_a); m.def("android_version", &android_version, "Return the " RST_CLASS_REF(lief.Android.ANDROID_VERSIONS) " associated with the given ART version ", "art_version"_a); } } } LIEF-0.13.1/api/python/src/Abstract/000077500000000000000000000000001443457337100167525ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/Abstract/CMakeLists.txt000066400000000000000000000015501443457337100215130ustar00rootroot00000000000000 set(LIEF_PYTHON_ABSTRACT_SRC "${CMAKE_CURRENT_LIST_DIR}/pyAbstract.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBinary.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySection.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbol.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocation.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyFunction.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyEnums.cpp" ) set(LIEF_PYTHON_ABSTRACT_HDR "${CMAKE_CURRENT_LIST_DIR}/pyAbstract.hpp" ) source_group("Source Files\\Abstract" FILES ${LIEF_PYTHON_ABSTRACT_SRC}) source_group("Header Files\\Abstract" FILES ${LIEF_PYTHON_ABSTRACT_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_ABSTRACT_SRC}" "${LIEF_PYTHON_ABSTRACT_HDR}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}") LIEF-0.13.1/api/python/src/Abstract/objects/000077500000000000000000000000001443457337100204035ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/Abstract/objects/pyBinary.cpp000066400000000000000000000225731443457337100227150ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyAbstract.hpp" #include "pyIterators.hpp" #include "pyErr.hpp" #include "LIEF/Abstract/Binary.hpp" #define PY_ENUM(x) LIEF::to_string(x), x namespace LIEF { template using getter_t = T (Binary::*)(void) const; template using setter_t = void (Binary::*)(T); template using it_t = T (Binary::*)(void); template using no_const_func = T (Binary::*)(P); template<> void create(py::module& m) { py::class_ pybinary(m, "Binary", R"delim( File format abstract representation. This object represents the abstraction of an executable file format. It enables to access common features (like the :attr:`~lief.Binary.entrypoint`) regardless of the concrete format (e.g. :attr:`lief.ELF.Binary.entrypoint`) )delim"); py::enum_(pybinary, "VA_TYPES") .value(PY_ENUM(Binary::VA_TYPES::AUTO)) .value(PY_ENUM(Binary::VA_TYPES::VA)) .value(PY_ENUM(Binary::VA_TYPES::RVA)); init_ref_iterator(pybinary, "it_sections"); init_ref_iterator(pybinary, "it_symbols"); init_ref_iterator(pybinary, "it_relocations"); pybinary .def_property_readonly("format", &Binary::format, "File format " RST_CLASS_REF(lief.EXE_FORMATS) " of the underlying binary.") .def_property_readonly("is_pie", &Binary::is_pie, "Check if the binary is position independent") .def_property_readonly("has_nx", &Binary::has_nx, "Check if the binary has ``NX`` protection (non executable stack)") .def_property("name", static_cast>(&Binary::name), static_cast>(&Binary::name), "Binary's name") .def_property_readonly("header", &Binary::header, "Binary's abstract header (" RST_CLASS_REF(lief.Header) ")") .def_property_readonly("entrypoint", &Binary::entrypoint, "Binary's entrypoint") .def("remove_section", static_cast(&Binary::remove_section), "Remove the section with the given name", "name"_a, "clear"_a = false) .def_property_readonly("sections", static_cast>(&Binary::sections), "Return an iterator over the binary's abstract sections (" RST_CLASS_REF(lief.Section) ")", py::return_value_policy::reference_internal) .def_property_readonly("relocations", static_cast>(&Binary::relocations), "Return an iterator over abstract " RST_CLASS_REF(lief.Relocation) "", py::return_value_policy::reference_internal) .def_property_readonly("exported_functions", &Binary::exported_functions, "Return the binary's exported " RST_CLASS_REF(lief.Function) "") .def_property_readonly("imported_functions", &Binary::imported_functions, "Return the binary's imported " RST_CLASS_REF(lief.Function) " (name)") .def_property_readonly("libraries", [] (const Binary& binary) { const std::vector& imported_libraries = binary.imported_libraries(); std::vector imported_libraries_encoded; imported_libraries_encoded.reserve(imported_libraries.size()); std::transform( std::begin(imported_libraries), std::end(imported_libraries), std::back_inserter(imported_libraries_encoded), &safe_string_converter); return imported_libraries_encoded; }, "Return binary's imported libraries (name)") .def_property_readonly("symbols", static_cast>(&Binary::symbols), "Return an iterator over the binary's abstract " RST_CLASS_REF(lief.Symbol) "", py::return_value_policy::reference_internal) .def("has_symbol", &Binary::has_symbol, "Check if a " RST_CLASS_REF(lief.Symbol) " with the given name exists", "symbol_name"_a) .def("get_symbol", static_cast>(&Binary::get_symbol), R"delim( Return the :class:`~lief.Symbol` from the given ``name``. If the symbol can't be found, it returns None. )delim", "symbol_name"_a, py::return_value_policy::reference_internal) .def("get_function_address", [] (const Binary& self, const std::string& name) { return error_or(&Binary::get_function_address, self, name); }, "Return the address of the given function name", "function_name"_a) .def("patch_address", static_cast&, Binary::VA_TYPES)>(&Binary::patch_address), R"delim( Patch the address with the given list of bytes. The virtual address is specified in the first argument and the content in the second (as a list of bytes). If the underlying binary is a PE, one can specify if the virtual address is a :attr:`~lief.Binary.VA_TYPES.RVA` or a :attr:`~lief.Binary.VA_TYPES.VA`. By default, it is set to :attr:`~lief.Binary.VA_TYPES.AUTO`. )delim", "address"_a, "patch_value"_a, "va_type"_a = Binary::VA_TYPES::AUTO) .def("patch_address", static_cast(&Binary::patch_address), R"delim( Patch the address with the given integer value. The virtual address is specified in the first argument, the integer in the second and the integer's size of in third one. If the underlying binary is a PE, one can specify if the virtual address is a :attr:`~lief.Binary.VA_TYPES.RVA` or a :attr:`~lief.Binary.VA_TYPES.VA`. By default, it is set to :attr:`~lief.Binary.VA_TYPES.AUTO`. )delim", "address"_a, "patch_value"_a, "size"_a = 8, "va_type"_a = Binary::VA_TYPES::AUTO) .def("get_content_from_virtual_address", [] (const Binary& self, uint64_t va, size_t size, Binary::VA_TYPES type) { span content = self.get_content_from_virtual_address(va, size, type); return py::memoryview::from_memory(content.data(), content.size()); }, R"delim( Return the content located at the provided virtual address. The virtual address is specified in the first argument and size to read (in bytes) in the second. If the underlying binary is a PE, one can specify if the virtual address is a :attr:`~lief.Binary.VA_TYPES.RVA` or a :attr:`~lief.Binary.VA_TYPES.VA`. By default, it is set to :attr:`~lief.Binary.VA_TYPES.AUTO`. )delim", "virtual_address"_a, "size"_a, "va_type"_a = Binary::VA_TYPES::AUTO) .def_property_readonly("abstract", [m] (py::object& self) { self.attr("__class__") = m.attr("Binary"); return self; }, R"delim( Return the abstract representation of the current binary (:class:`lief.Binary`) .. warning:: Getting this property modifies the ``__class__`` attribute such as the current binary looks like a :class:`lief.Binary`. To get back to the original binary, one needs to access :attr:`lief.Binary.concrete` )delim", py::return_value_policy::reference) .def_property_readonly("concrete", [m] (py::object& self) { self.attr("__class__") = py::cast(self.cast()).attr("__class__"); return self; }, R"delim( The *concrete* representation of the binary. Basically, this property cast a :class:`lief.Binary` into a :class:`lief.PE.Binary`, :class:`lief.ELF.Binary` or :class:`lief.MachO.Binary`. See also: :attr:`lief.Binary.abstract` )delim", py::return_value_policy::reference) .def_property_readonly("ctor_functions", &Binary::ctor_functions, "Constructor functions that are called prior to any other functions") .def("xref", &Binary::xref, "Return all **virtual addresses** that *use* the ``address`` given in parameter", "virtual_address"_a) .def("offset_to_virtual_address", [] (const Binary& self, uint64_t offset, uint64_t slide) { return error_or(&Binary::offset_to_virtual_address, self, offset, slide); }, "Convert an offset into a virtual address.", "offset"_a, "slide"_a = 0) .def_property_readonly("imagebase", &Binary::imagebase, "Default image base (i.e. if the ASLR is not enabled)") .def("__str__", [] (const Binary& binary) { std::ostringstream stream; stream << binary; std::string str = stream.str(); return str; }); } } LIEF-0.13.1/api/python/src/Abstract/objects/pyFunction.cpp000066400000000000000000000042501443457337100232460ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyAbstract.hpp" #include "LIEF/Abstract/Symbol.hpp" #include #include #define PY_ENUM(x) LIEF::to_string(x), x namespace LIEF { template using getter_t = T (Function::*)(void) const; template using setter_t = void (Function::*)(T); template<> void create(py::module& m) { py::class_ pyfunction(m, "Function", R"delim( Class which represents a Function in an executable file format. )delim"); py::enum_(pyfunction, "FLAGS") .value(PY_ENUM(Function::FLAGS::IMPORTED)) .value(PY_ENUM(Function::FLAGS::EXPORTED)) .value(PY_ENUM(Function::FLAGS::CONSTRUCTOR)) .value(PY_ENUM(Function::FLAGS::DESTRUCTOR)) .value(PY_ENUM(Function::FLAGS::DEBUG)); pyfunction .def(py::init()) .def(py::init()) .def(py::init()) .def(py::init()) .def("add", &Function::add, "Add the given " RST_CLASS_REF(lief.Function.FLAGS) "", "flag"_a) .def_property_readonly("flags", &Function::flags, "Function flags as a list of " RST_CLASS_REF(lief.Function.FLAGS) "") .def_property("address", static_cast>(&Function::address), static_cast>(&Function::address), "Function's address") .def("__str__", [] (const Function& f) { std::ostringstream stream; stream << f; std::string str = stream.str(); return str; }); } } LIEF-0.13.1/api/python/src/Abstract/objects/pyHeader.cpp000066400000000000000000000051001443457337100226440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "pyAbstract.hpp" #include "LIEF/Abstract/Header.hpp" namespace LIEF { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template<> void create
(py::module& m) { py::class_(m, "Header") .def(py::init()) .def_property("architecture", static_cast>(&Header::architecture), static_cast>(&Header::architecture), "Target architecture (" RST_CLASS_REF(lief.ARCHITECTURES) ")") .def_property("modes", static_cast&>>(&Header::modes), static_cast&>>(&Header::modes), "Target " RST_CLASS_REF(lief.MODES) " (32-bits, 64-bits...)") .def_property("entrypoint", static_cast>(&Header::entrypoint), static_cast>(&Header::entrypoint), "Binary entrypoint") .def_property("object_type", static_cast>(&Header::object_type), static_cast>(&Header::object_type), "Type of the binary (executable, library...)\n" "See: " RST_CLASS_REF(lief.OBJECT_TYPES) "") .def_property("endianness", static_cast>(&Header::endianness), static_cast>(&Header::endianness), "Binary endianness\n" "See: " RST_CLASS_REF(lief.ENDIANNESS) "") .def_property_readonly("is_32", &Header::is_32, "``True`` if the binary targets a ``32-bits`` architecture") .def_property_readonly("is_64", &Header::is_64, "``True`` if the binary targets a ``64-bits`` architecture") .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } LIEF-0.13.1/api/python/src/Abstract/objects/pyParser.cpp000066400000000000000000000070051443457337100227160ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyAbstract.hpp" #include "PyIOStream.hpp" #include "LIEF/logging.hpp" #include "LIEF/Abstract/Parser.hpp" #include #include namespace LIEF { template<> void create(py::module& m) { m.def("parse", [] (py::bytes bytes, const std::string& name) { std::string raw_str = bytes; std::vector raw = { std::make_move_iterator(std::begin(raw_str)), std::make_move_iterator(std::end(raw_str)) }; std::unique_ptr binary; std::exception_ptr ep; Py_BEGIN_ALLOW_THREADS try { binary = Parser::parse(std::move(raw), name); } catch (...) { ep = std::current_exception(); } Py_END_ALLOW_THREADS if (ep) std::rethrow_exception(ep); return binary; }, R"delim( Parse a binary supported by LIEF from the given bytes and return either: - :class:`lief.ELF.Binary` - :class:`lief.PE.Binary` - :class:`lief.MachO.Binary` depending on the given binary format. )delim", "raw"_a, "name"_a = "", py::return_value_policy::take_ownership); m.def("parse", [] (const std::string& filepath) { std::unique_ptr binary; std::exception_ptr ep; Py_BEGIN_ALLOW_THREADS try { binary = Parser::parse(filepath); } catch (...) { ep = std::current_exception(); } Py_END_ALLOW_THREADS if (ep) std::rethrow_exception(ep); return binary; }, R"delim( Parse a binary from the given file path and return either: - :class:`lief.ELF.Binary` - :class:`lief.PE.Binary` - :class:`lief.MachO.Binary` depending on the given binary format. )delim", "filepath"_a, py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, const std::string& name) -> py::object { if (auto stream = PyIOStream::from_python(byteio)) { auto ptr = std::make_unique(std::move(*stream)); py::object binary; std::exception_ptr ep; Py_BEGIN_ALLOW_THREADS try { binary = py::cast(Parser::parse(std::move(ptr))); } catch (...) { ep = std::current_exception(); } Py_END_ALLOW_THREADS if (ep) std::rethrow_exception(ep); return binary; } logging::log(logging::LOG_ERR, "Can't create a LIEF stream interface over the provided io"); return py::none(); }, R"delim( Parse a binary supported by LIEF from the given Python IO interface and return either: - :class:`lief.ELF.Binary` - :class:`lief.PE.Binary` - :class:`lief.MachO.Binary` depending on the given binary format. )delim", "io"_a, "name"_a = "", py::return_value_policy::take_ownership); } } LIEF-0.13.1/api/python/src/Abstract/objects/pyRelocation.cpp000066400000000000000000000040761443457337100235660ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "pyAbstract.hpp" #include "LIEF/Abstract/hash.hpp" #include "LIEF/Abstract/Relocation.hpp" namespace LIEF { template using getter_t = T (Relocation::*)(void) const; template using setter_t = void (Relocation::*)(T); template<> void create(py::module& m) { py::class_(m, "Relocation", R"delim( Class which represents an abstracted Relocation )delim") .def(py::init(), "Default constructor") .def(py::init(), "Constructor from an :attr:`~lief.Relocation.address` and a :attr:`~lief.Relocation.size`", "address"_a, "size"_a) .def_property("address", static_cast>(&Relocation::address), static_cast>(&Relocation::address), "Relocation's address") .def_property("size", static_cast>(&Relocation::size), static_cast>(&Relocation::size), "Relocation's size (in **bits**)") .def("__eq__", &Relocation::operator==) .def("__ne__", &Relocation::operator!=) .def("__hash__", [] (const Relocation& relocation) { return AbstractHash::hash(relocation); }) .def("__str__", [] (const Relocation& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } LIEF-0.13.1/api/python/src/Abstract/objects/pySection.cpp000066400000000000000000000106061443457337100230670ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "pyAbstract.hpp" #include "LIEF/Abstract/Section.hpp" namespace LIEF { template using getter_t = T (Section::*)(void) const; template using setter_t = void (Section::*)(T); template<> void create
(py::module& m) { py::class_(m, "Section", R"delim( Class which represents an abstracted section )delim") .def(py::init(), "Default constructor") .def(py::init(), "Constructor from section name", "name"_a) .def_property("name", [] (const Section& obj) { return safe_string_converter(obj.name()); }, static_cast>(&Section::name), "Section's name") .def_property_readonly("fullname", &Section::fullname, "Return the **fullname** of the section including the trailing bytes") .def_property("size", static_cast>(&Section::size), static_cast>(&Section::size), "Section's size") .def_property("offset", static_cast>(&Section::offset), static_cast>(&Section::offset), "Section's file offset") .def_property("virtual_address", static_cast>(&Section::virtual_address), static_cast>(&Section::virtual_address), "Section's virtual address") .def_property("content", [] (const Section& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast&>>(&Section::content), "Section's content") .def_property_readonly("entropy", &Section::entropy, "Section's entropy") .def("search", [] (const Section& self, uint64_t number, size_t pos, size_t size) -> py::object { size_t res = self.search(number, pos, size); if (res == Section::npos) { return py::none(); } return py::cast(res); }, "Look for **integer** within the current section", "number"_a, "pos"_a = 0, "size"_a = 0) .def("search", [] (const Section& self, const std::string& str, size_t pos) -> py::object { size_t res = self.search(str, pos); if (res == Section::npos) { return py::none(); } return py::cast(res); }, "Look for **string** within the current section", "str"_a, "pos"_a = 0) .def("search", [] (const Section& self, py::bytes bytes, size_t pos) -> py::object { std::string raw_str = bytes; std::vector raw = { std::make_move_iterator(std::begin(raw_str)), std::make_move_iterator(std::end(raw_str)) }; size_t res = self.search(raw, pos); if (res == Section::npos) { return py::none(); } return py::cast(res); }, "Look for the given bytes within the current section", "bytes"_a, "pos"_a = 0) .def("search_all", static_cast (Section::*)(uint64_t, size_t) const>(&Section::search_all), "Look for **all** integers within the current section", "number"_a, "size"_a = 0) .def("search_all", static_cast (Section::*)(const std::string&) const>(&Section::search_all), "Look for all **strings** within the current section", "str"_a) .def("__str__", [] (const Section& section) { std::ostringstream stream; stream << section; std::string str = stream.str(); return str; }); } } LIEF-0.13.1/api/python/src/Abstract/objects/pySymbol.cpp000066400000000000000000000034501443457337100227270ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyAbstract.hpp" #include "LIEF/Abstract/Symbol.hpp" #include #include namespace LIEF { template using getter_t = T (Symbol::*)(void) const; template using setter_t = void (Symbol::*)(T); template<> void create(py::module& m) { py::class_(m, "Symbol", R"delim( This class represents a symbol in an executable format. )delim") .def(py::init()) .def_property("name", [] (const Symbol& obj) { return safe_string_converter(obj.name()); }, static_cast>(&Symbol::name), "Symbol's name") .def_property("value", static_cast>(&Symbol::value), static_cast>(&Symbol::value), "Symbol's value") .def_property("size", static_cast>(&Symbol::size), static_cast>(&Symbol::size), "Symbol's size") .def("__str__", [] (const Symbol& symbol) { std::ostringstream stream; stream << symbol; std::string str = stream.str(); return str; }); } } LIEF-0.13.1/api/python/src/Abstract/pyAbstract.cpp000066400000000000000000000017161443457337100215770ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyLIEF.hpp" #include "pyAbstract.hpp" namespace LIEF { void init_python_module(py::module& m) { init_enums(m); init_objects(m); } void init_objects(py::module& m) { CREATE(Header, m); CREATE(Binary, m); CREATE(Section, m); CREATE(Symbol, m); CREATE(Parser, m); CREATE(Relocation, m); CREATE(Function, m); } } LIEF-0.13.1/api/python/src/Abstract/pyAbstract.hpp000066400000000000000000000023401443457337100215760ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ABSTRACT_H_ #define PY_LIEF_ABSTRACT_H_ #include "pyLIEF.hpp" #include "LIEF/Abstract.hpp" #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) namespace LIEF { template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_enums(py::module&); SPECIALIZE_CREATE(Header); SPECIALIZE_CREATE(Binary); SPECIALIZE_CREATE(Section); SPECIALIZE_CREATE(Symbol); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(Relocation); SPECIALIZE_CREATE(Function); } #endif LIEF-0.13.1/api/python/src/Abstract/pyEnums.cpp000066400000000000000000000051701443457337100211210ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyAbstract.hpp" #include "LIEF/Abstract/enums.hpp" #include "LIEF/Abstract/EnumToString.hpp" #define PY_ENUM(x) LIEF::to_string(x), x namespace LIEF { void init_enums(py::module& m) { py::enum_(m, "EXE_FORMATS") .value(PY_ENUM(EXE_FORMATS::FORMAT_UNKNOWN)) .value(PY_ENUM(EXE_FORMATS::FORMAT_ELF)) .value(PY_ENUM(EXE_FORMATS::FORMAT_PE)) .value(PY_ENUM(EXE_FORMATS::FORMAT_MACHO)); py::enum_(m, "OBJECT_TYPES") .value(PY_ENUM(OBJECT_TYPES::TYPE_NONE)) .value(PY_ENUM(OBJECT_TYPES::TYPE_EXECUTABLE)) .value(PY_ENUM(OBJECT_TYPES::TYPE_LIBRARY)) .value(PY_ENUM(OBJECT_TYPES::TYPE_OBJECT)); py::enum_(m, "ARCHITECTURES") .value(PY_ENUM(ARCHITECTURES::ARCH_NONE)) .value(PY_ENUM(ARCHITECTURES::ARCH_ARM)) .value(PY_ENUM(ARCHITECTURES::ARCH_ARM64)) .value(PY_ENUM(ARCHITECTURES::ARCH_MIPS)) .value(PY_ENUM(ARCHITECTURES::ARCH_X86)) .value(PY_ENUM(ARCHITECTURES::ARCH_PPC)) .value(PY_ENUM(ARCHITECTURES::ARCH_SPARC)) .value(PY_ENUM(ARCHITECTURES::ARCH_SYSZ)) .value(PY_ENUM(ARCHITECTURES::ARCH_XCORE)) .value(PY_ENUM(ARCHITECTURES::ARCH_INTEL)) .value(PY_ENUM(ARCHITECTURES::ARCH_RISCV)); py::enum_(m, "MODES") .value(PY_ENUM(MODES::MODE_NONE)) .value(PY_ENUM(MODES::MODE_16)) .value(PY_ENUM(MODES::MODE_32)) .value(PY_ENUM(MODES::MODE_64)) .value(PY_ENUM(MODES::MODE_ARM)) .value(PY_ENUM(MODES::MODE_THUMB)) .value(PY_ENUM(MODES::MODE_MCLASS)) .value(PY_ENUM(MODES::MODE_MICRO)) .value(PY_ENUM(MODES::MODE_MIPS3)) .value(PY_ENUM(MODES::MODE_MIPS32R6)) .value(PY_ENUM(MODES::MODE_MIPSGP64)) .value(PY_ENUM(MODES::MODE_V7)) .value(PY_ENUM(MODES::MODE_V8)) .value(PY_ENUM(MODES::MODE_V9)) .value(PY_ENUM(MODES::MODE_MIPS32)) .value(PY_ENUM(MODES::MODE_MIPS64)); py::enum_(m, "ENDIANNESS") .value(PY_ENUM(ENDIANNESS::ENDIAN_NONE)) .value(PY_ENUM(ENDIANNESS::ENDIAN_BIG)) .value(PY_ENUM(ENDIANNESS::ENDIAN_LITTLE)); } } LIEF-0.13.1/api/python/src/DEX/000077500000000000000000000000001443457337100156275ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/DEX/CMakeLists.txt000066400000000000000000000021031443457337100203630ustar00rootroot00000000000000set(LIEF_PYTHON_DEX_SRC "${CMAKE_CURRENT_LIST_DIR}/pyDEX.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyEnums.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyUtils.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyFile.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyClass.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyField.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyMethod.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyCodeInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyMapList.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyMapItem.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyType.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyPrototype.cpp" ) set(LIEF_PYTHON_DEX_HDR "${CMAKE_CURRENT_LIST_DIR}/pyDEX.hpp") source_group("Source Files\\DEX" FILES ${LIEF_PYTHON_DEX_SRC}) source_group("Header Files\\DEX" FILES ${LIEF_PYTHON_DEX_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_DEX_SRC}" "${LIEF_PYTHON_DEX_HDR}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}" "${CMAKE_CURRENT_LIST_DIR}/../") LIEF-0.13.1/api/python/src/DEX/objects/000077500000000000000000000000001443457337100172605ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/DEX/objects/pyClass.cpp000066400000000000000000000076631443457337100214160ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/Class.hpp" #include "LIEF/DEX/hash.hpp" #include "pyIterators.hpp" #include "pyDEX.hpp" namespace LIEF { namespace DEX { template using getter_t = T (Class::*)(void) const; template using no_const_getter_t = T (Class::*)(void); template using setter_t = void (Class::*)(T); template<> void create(py::module& m) { py::class_ cls(m, "Class", "DEX Class representation"); init_ref_iterator(cls, "it_methods"); init_ref_iterator(cls, "it_fields"); init_ref_iterator(cls, "it_named_methods"); init_ref_iterator(cls, "it_named_fields"); cls .def_property_readonly("fullname", &Class::fullname, "Mangled class name (e.g. ``Lcom/example/android/MyActivity;``)") .def_property_readonly("pretty_name", &Class::pretty_name, "Demangled class name (e.g. ``com.example.android.MyActivity``)") .def_property_readonly("name", &Class::name, "Class name (e.g. ``MyActivity``)") .def_property_readonly("source_filename", &Class::source_filename, "Original filename") .def_property_readonly("package_name", &Class::package_name, "Package Name (e.g. ``com.example.android``)") .def_property_readonly("has_parent", &Class::has_parent, "True if the current class extends another one") .def_property_readonly("parent", static_cast>(&Class::parent), "" RST_CLASS_REF(lief.DEX.Class) " parent class") .def_property_readonly("methods", static_cast>(&Class::methods), "Iterator over " RST_CLASS_REF(lief.DEX.Method) " implemented in this class") .def("get_method", static_cast(&Class::methods), "Iterator over " RST_CLASS_REF(lief.DEX.Method) " (s) having the given name", "name"_a) .def_property_readonly("fields", static_cast>(&Class::fields), "Iterator over " RST_CLASS_REF(lief.DEX.Field) " in this class") .def("get_field", static_cast(&Class::fields), "Iterator over " RST_CLASS_REF(lief.DEX.Field) " (s) having the given name", "name"_a) .def_property_readonly("access_flags", static_cast>(&Class::access_flags), "List of " RST_CLASS_REF(lief.DEX.ACCESS_FLAGS) "") .def_property_readonly("dex2dex_info", &Class::dex2dex_info, "De-optimize information") .def_property_readonly("index", &Class::index, "Original index in the DEX class pool") .def("has", static_cast(&Class::has), "Check if the given " RST_CLASS_REF(lief.DEX.ACCESS_FLAGS) " is present", "flag"_a) .def("__eq__", &Class::operator==) .def("__ne__", &Class::operator!=) .def("__hash__", [] (const Class& cls) { return Hash::hash(cls); }) .def("__str__", [] (const Class& cls) { std::ostringstream stream; stream << cls; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyCodeInfo.cpp000066400000000000000000000026401443457337100220250ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/CodeInfo.hpp" #include "LIEF/DEX/hash.hpp" #include "pyDEX.hpp" namespace LIEF { namespace DEX { template using getter_t = T (CodeInfo::*)(void) const; template using no_const_getter_t = T (CodeInfo::*)(void); template using setter_t = void (CodeInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "CodeInfo", "DEX CodeInfo representation") .def("__eq__", &CodeInfo::operator==) .def("__ne__", &CodeInfo::operator!=) .def("__hash__", [] (const CodeInfo& cinfo) { return Hash::hash(cinfo); }) .def("__str__", [] (const CodeInfo& cinfo) { std::ostringstream stream; stream << cinfo; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyField.cpp000066400000000000000000000035741443457337100213710ustar00rootroot00000000000000#include "LIEF/DEX/Field.hpp" #include "LIEF/DEX/hash.hpp" #include "pyDEX.hpp" namespace LIEF { namespace DEX { template using getter_t = T (Field::*)(void) const; template using no_const_getter_t = T (Field::*)(void); template using setter_t = void (Field::*)(T); template<> void create(py::module& m) { py::class_(m, "Field", "DEX Field representation") .def_property_readonly("name", &Field::name, "Field's name") .def_property_readonly("index", &Field::index, "Original DEX file index of the field") .def_property_readonly("has_class", &Field::has_class, "True if a class is associated with this field") .def_property_readonly("cls", static_cast>(&Field::cls), "" RST_CLASS_REF(lief.DEX.Class) " associated with this field") .def_property_readonly("is_static", &Field::is_static, "True if the field is static") .def_property_readonly("type", static_cast>(&Field::type), "" RST_CLASS_REF(lief.DEX.Type) " of this field", py::return_value_policy::reference) .def_property_readonly("access_flags", static_cast>(&Field::access_flags), "List of " RST_CLASS_REF(lief.DEX.ACCESS_FLAGS) "") .def("has", static_cast(&Field::has), "Check if the given " RST_CLASS_REF(lief.DEX.ACCESS_FLAGS) " is present", "flag"_a) .def("__eq__", &Field::operator==) .def("__ne__", &Field::operator!=) .def("__hash__", [] (const Field& fld) { return Hash::hash(fld); }) .def("__str__", [] (const Field& fld) { std::ostringstream stream; stream << fld; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyFile.cpp000066400000000000000000000106621443457337100212210ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/File.hpp" #include "LIEF/DEX/hash.hpp" #include "pyIterators.hpp" #include "pyDEX.hpp" namespace LIEF { namespace DEX { template using getter_t = T (File::*)(void) const; template using no_const_getter_t = T (File::*)(void); template using setter_t = void (File::*)(T); template<> void create(py::module& m) { py::class_ file(m, "File", "DEX File representation"); init_ref_iterator(file, "it_classes"); init_ref_iterator(file, "it_methods"); init_ref_iterator(file, "it_strings"); init_ref_iterator(file, "it_types"); init_ref_iterator(file, "it_prototypes"); init_ref_iterator(file, "it_fields"); file .def_property_readonly("version", &File::version, "Dex version") .def_property_readonly("header", static_cast>(&File::header), "Dex File " RST_CLASS_REF(lief.DEX.Header) "", py::return_value_policy::reference) .def_property_readonly("classes", static_cast>(&File::classes), "Iterator over Dex " RST_CLASS_REF(lief.DEX.Class) "") .def("has_class", &File::has_class, "Check if a class with a name given in parameter exists", "classname"_a) .def("get_class", static_cast(&File::get_class), "classname"_a, py::return_value_policy::reference) .def("get_class", static_cast(&File::get_class), "classname"_a, py::return_value_policy::reference) .def_property_readonly("methods", static_cast>(&File::methods), "Iterator over Dex " RST_CLASS_REF(lief.DEX.Method) "") .def_property_readonly("fields", static_cast>(&File::fields), "Iterator over Dex " RST_CLASS_REF(lief.DEX.Field) "") .def_property_readonly("strings", static_cast>(&File::strings), "Iterator over Dex strings") .def_property_readonly("types", static_cast>(&File::types), "Iterator over Dex " RST_CLASS_REF(lief.DEX.Type) "") .def_property_readonly("prototypes", static_cast>(&File::prototypes), "Iterator over Dex " RST_CLASS_REF(lief.DEX.Prototype) "") .def_property_readonly("map", static_cast>(&File::map), "Dex " RST_CLASS_REF(lief.DEX.MapList) "") .def("raw", &File::raw, "Original raw file", "deoptimize"_a = true) .def_property("name", static_cast>(&File::name), static_cast>(&File::name), "Name of the dex file") .def_property("location", static_cast>(&File::location), static_cast>(&File::location), "Original location of the dex file") //.def_property_readonly("dex2dex_info", // &File::dex2dex_info) .def_property_readonly("dex2dex_json_info", &File::dex2dex_json_info) .def("save", &File::save, "Save the **original** file into the file given in first parameter", "output"_a = "", "deoptimize"_a = true) .def("__eq__", &File::operator==) .def("__ne__", &File::operator!=) .def("__hash__", [] (const File& file) { return Hash::hash(file); }) .def("__str__", [] (const File& file) { std::ostringstream stream; stream << file; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyHeader.cpp000066400000000000000000000075701443457337100215360ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/Header.hpp" #include "LIEF/DEX/hash.hpp" #include "pyDEX.hpp" namespace LIEF { namespace DEX { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template<> void create
(py::module& m) { py::class_(m, "Header", "DEX Header") .def_property_readonly("magic", static_cast>(&Header::magic), "Magic value") .def_property_readonly("checksum", static_cast>(&Header::checksum), "Checksum value of the rest of the file (without " RST_ATTR_REF(lief.DEX.Header.magic) ")") .def_property_readonly("signature", static_cast>(&Header::signature), "SHA-1 signature of the rest of the file (without " RST_ATTR_REF(lief.DEX.Header.magic) " and " RST_ATTR_REF(lief.DEX.Header.checksum) ")") .def_property_readonly("file_size", static_cast>(&Header::file_size), "Size of the current DEX file") .def_property_readonly("header_size", static_cast>(&Header::header_size), "Size of this header. Should be ``0x70``") .def_property_readonly("endian_tag", static_cast>(&Header::endian_tag), "Endianness tag. Should be ``ENDIAN_CONSTANT``") .def_property_readonly("map_offset", static_cast>(&Header::map), "Offset from the start of the file to the map item") .def_property_readonly("strings", static_cast>(&Header::strings), "String identifiers") .def_property_readonly("link", static_cast>(&Header::link), "Link (raw data)") .def_property_readonly("types", static_cast>(&Header::types), "Type identifiers") .def_property_readonly("prototypes", static_cast>(&Header::prototypes), "Prototypes identifiers") .def_property_readonly("fields", static_cast>(&Header::fields), "Fields identifiers") .def_property_readonly("methods", static_cast>(&Header::methods), "Methods identifiers") .def_property_readonly("classes", static_cast>(&Header::classes), "Classess identifiers") .def_property_readonly("data", static_cast>(&Header::data), "Raw data. Should be align on 32-bits") .def_property_readonly("nb_classes", static_cast>(&Header::nb_classes), "Number of classes in the current DEX") .def_property_readonly("nb_methods", static_cast>(&Header::nb_methods), "Number of methods in the current DEX") .def("__eq__", &Header::operator==) .def("__ne__", &Header::operator!=) .def("__hash__", [] (const Header& header) { return Hash::hash(header); }) .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyMapItem.cpp000066400000000000000000000063001443457337100216700ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/MapItem.hpp" #include "LIEF/DEX/hash.hpp" #include "LIEF/DEX/EnumToString.hpp" #include "pyDEX.hpp" namespace LIEF { namespace DEX { #define PY_ENUM(x) to_string(x), x template using getter_t = T (MapItem::*)(void) const; template using no_const_getter_t = T (MapItem::*)(void); template using setter_t = void (MapItem::*)(T); template<> void create(py::module& m) { py::class_ mapitem(m, "MapItem", "DEX MapItem representation"); py::enum_(mapitem, "TYPES") .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::HEADER)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::STRING_ID)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::TYPE_ID)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::PROTO_ID)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::FIELD_ID)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::METHOD_ID)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::CLASS_DEF)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::CALL_SITE_ID)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::METHOD_HANDLE)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::MAP_LIST)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::TYPE_LIST)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::ANNOTATION_SET_REF_LIST)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::ANNOTATION_SET)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::CLASS_DATA)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::CODE)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::STRING_DATA)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::DEBUG_INFO)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::ANNOTATION)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::ENCODED_ARRAY)) .value(PY_ENUM(LIEF::DEX::MapItem::TYPES::ANNOTATIONS_DIRECTORY)); mapitem .def_property_readonly("type", static_cast>(&MapItem::type), "" RST_CLASS_REF(lief.DEX.MapItem.TYPES) " of the item") .def_property_readonly("offset", static_cast>(&MapItem::offset), "Offset from the start of the file to the items in question") .def_property_readonly("size", static_cast>(&MapItem::size), "count of the number of items to be found at the indicated offset") .def("__eq__", &MapItem::operator==) .def("__ne__", &MapItem::operator!=) .def("__hash__", [] (const MapItem& mlist) { return Hash::hash(mlist); }) .def("__str__", [] (const MapItem& mlist) { std::ostringstream stream; stream << mlist; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyMapList.cpp000066400000000000000000000043041443457337100217070ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/MapList.hpp" #include "LIEF/DEX/hash.hpp" #include "pyDEX.hpp" #include "pyIterators.hpp" namespace LIEF { namespace DEX { template using getter_t = T (MapList::*)(void) const; template using no_const_getter_t = T (MapList::*)(void); template using setter_t = void (MapList::*)(T); template<> void create(py::module& m) { py::class_ map_list(m, "MapList", "DEX MapList representation"); init_ref_iterator(map_list, "it_items_t"); map_list .def_property_readonly("items", static_cast>(&MapList::items), "Iterator over " RST_CLASS_REF(lief.DEX.MapItem) "") .def("has", &MapList::has, "Check if the given " RST_CLASS_REF(lief.DEX.MapItem.TYPES) " is present", "type"_a) .def("get", static_cast(&MapList::get), "Return the " RST_CLASS_REF(lief.DEX.MapItem.TYPES) " from " "the given " RST_CLASS_REF(lief.DEX.MapItem.TYPES) "", "type"_a, py::return_value_policy::reference) .def("__getitem__", static_cast(&MapList::get)) .def("__eq__", &MapList::operator==) .def("__ne__", &MapList::operator!=) .def("__hash__", [] (const MapList& mlist) { return Hash::hash(mlist); }) .def("__str__", [] (const MapList& mlist) { std::ostringstream stream; stream << mlist; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyMethod.cpp000066400000000000000000000060051443457337100215560ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/Method.hpp" #include "LIEF/DEX/hash.hpp" #include "pyDEX.hpp" namespace LIEF { namespace DEX { template using getter_t = T (Method::*)(void) const; template using no_const_getter_t = T (Method::*)(void); template using setter_t = void (Method::*)(T); template<> void create(py::module& m) { py::class_(m, "Method", "DEX Method representation") .def_property_readonly("name", &Method::name, "Method's name") .def_property_readonly("index", &Method::index, "Original DEX file index of the method") .def_property_readonly("has_class", &Method::has_class, "True if a class is associated with this method") .def_property_readonly("cls", static_cast>(&Method::cls), "" RST_CLASS_REF(lief.DEX.Class) " associated with this method") .def_property_readonly("code_offset", static_cast>(&Method::code_offset), "Offset to the Dalvik Bytecode") .def_property_readonly("bytecode", static_cast>(&Method::bytecode), "Dalvik Bytecode as a list of bytes") .def_property_readonly("is_virtual", &Method::is_virtual, "True if the method is a virtual (not **private**, **static**, **final**, **constructor**)") .def_property_readonly("prototype", static_cast>(&Method::prototype), "" RST_CLASS_REF(lief.DEX.Prototype) " of this method") .def_property_readonly("access_flags", static_cast>(&Method::access_flags), "List of " RST_CLASS_REF(lief.DEX.ACCESS_FLAGS) "") .def("has", static_cast(&Method::has), "Check if the given " RST_CLASS_REF(lief.DEX.ACCESS_FLAGS) " is present", "flag"_a) .def("insert_dex2dex_info", &Method::insert_dex2dex_info, "Insert de-optimization information", "pc"_a, "index"_a) .def("__eq__", &Method::operator==) .def("__ne__", &Method::operator!=) .def("__hash__", [] (const Method& cls) { return Hash::hash(cls); }) .def("__str__", [] (const Method& cls) { std::ostringstream stream; stream << cls; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyParser.cpp000066400000000000000000000046131443457337100215750ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyDEX.hpp" #include "LIEF/DEX/Parser.hpp" #include namespace LIEF { namespace DEX { template<> void create(py::module& m) { m.def("parse", static_cast (*) (const std::string&)>(&Parser::parse), "Parse the given filename and return a " RST_CLASS_REF(lief.DEX.File) " object", "filename"_a, py::return_value_policy::take_ownership); m.def("parse", static_cast(*)(std::vector, const std::string&)>(&Parser::parse), "Parse the given raw data and return a " RST_CLASS_REF(lief.DEX.File) " object", "raw"_a, "name"_a = "", py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, const std::string& name) { const auto& io = py::module::import("io"); const auto& RawIOBase = io.attr("RawIOBase"); const auto& BufferedIOBase = io.attr("BufferedIOBase"); const auto& TextIOBase = io.attr("TextIOBase"); py::object rawio; if (py::isinstance(byteio, RawIOBase)) { rawio = byteio; } else if (py::isinstance(byteio, BufferedIOBase)) { rawio = byteio.attr("raw"); } else if (py::isinstance(byteio, TextIOBase)) { rawio = byteio.attr("buffer").attr("raw"); } else { throw py::type_error(py::repr(byteio).cast().c_str()); } std::string raw_str = static_cast(rawio.attr("readall")()); std::vector raw = { std::make_move_iterator(std::begin(raw_str)), std::make_move_iterator(std::end(raw_str))}; return LIEF::DEX::Parser::parse(std::move(raw), name); }, "io"_a, "name"_a = "", py::return_value_policy::take_ownership); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyPrototype.cpp000066400000000000000000000036731443457337100223530ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/Prototype.hpp" #include "LIEF/DEX/hash.hpp" #include "pyDEX.hpp" #include "pyIterators.hpp" namespace LIEF { namespace DEX { template using getter_t = T (Prototype::*)(void) const; template using no_const_getter_t = T (Prototype::*)(void); template using setter_t = void (Prototype::*)(T); template<> void create(py::module& m) { py::class_ proto(m, "Prototype", "DEX Prototype representation"); init_ref_iterator(proto, "it_params"); proto .def_property_readonly("return_type", static_cast>(&Prototype::return_type), "" RST_CLASS_REF(lief.DEX.Type) " returned", py::return_value_policy::reference) .def_property_readonly("parameters_type", static_cast>(&Prototype::parameters_type), "Iterator over parameters " RST_CLASS_REF(lief.DEX.Type) "") .def("__eq__", &Prototype::operator==) .def("__ne__", &Prototype::operator!=) .def("__hash__", [] (const Prototype& ptype) { return Hash::hash(ptype); }) .def("__str__", [] (const Prototype& ptype) { std::ostringstream stream; stream << ptype; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/objects/pyType.cpp000066400000000000000000000070321443457337100212600ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/DEX/Type.hpp" #include "LIEF/DEX/hash.hpp" #include "LIEF/DEX/EnumToString.hpp" #include "pyDEX.hpp" #define PY_ENUM(x) to_string(x), x namespace LIEF { namespace DEX { template using getter_t = T (Type::*)(void) const; template using no_const_getter_t = T (Type::*)(void); template using setter_t = void (Type::*)(T); template<> void create(py::module& m) { py::class_ pytype(m, "Type", "DEX Type representation"); py::enum_(pytype, "TYPES") .value(PY_ENUM(Type::TYPES::UNKNOWN)) .value(PY_ENUM(Type::TYPES::ARRAY)) .value(PY_ENUM(Type::TYPES::PRIMITIVE)) .value(PY_ENUM(Type::TYPES::CLASS)); py::enum_(pytype, "PRIMITIVES") .value(PY_ENUM(Type::PRIMITIVES::VOID_T)) .value(PY_ENUM(Type::PRIMITIVES::BOOLEAN)) .value(PY_ENUM(Type::PRIMITIVES::BYTE)) .value(PY_ENUM(Type::PRIMITIVES::SHORT)) .value(PY_ENUM(Type::PRIMITIVES::CHAR)) .value(PY_ENUM(Type::PRIMITIVES::INT)) .value(PY_ENUM(Type::PRIMITIVES::LONG)) .value(PY_ENUM(Type::PRIMITIVES::FLOAT)) .value(PY_ENUM(Type::PRIMITIVES::DOUBLE)); pytype .def_property_readonly("type", &Type::type, "" RST_CLASS_REF(lief.DEX.Type.TYPES) " of this object") .def_property_readonly("value", [] (Type& type) -> py::object { switch (type.type()) { case Type::TYPES::ARRAY: { return py::cast(type.array()); } case Type::TYPES::CLASS: { return py::cast(type.cls(), py::return_value_policy::reference); } case Type::TYPES::PRIMITIVE: { return py::cast(type.primitive()); } case Type::TYPES::UNKNOWN: default: { return py::none{}; } } }, "Depending on the " RST_CLASS_REF(lief.DEX.Type.TYPES) ", return " " " RST_CLASS_REF(lief.DEX.Class) " or " RST_CLASS_REF(lief.DEX.Type.PRIMITIVES) " or array", py::return_value_policy::reference) .def_property_readonly("dim", &Type::dim, "If the current type is an array, return its dimension otherwise 0") .def_property_readonly("underlying_array_type", static_cast>(&Type::underlying_array_type), "Underlying type of the array", py::return_value_policy::reference) .def_static("pretty_name", &Type::pretty_name, "Pretty name of primitives", "primitive"_a) .def("__eq__", &Type::operator==) .def("__ne__", &Type::operator!=) .def("__hash__", [] (const Type& type) { return Hash::hash(type); }) .def("__str__", [] (const Type& type) { std::ostringstream stream; stream << type; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/DEX/pyDEX.cpp000066400000000000000000000022431443457337100173250ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyDEX.hpp" namespace LIEF { namespace DEX { void init_python_module(py::module& m) { py::module LIEF_DEX_module = m.def_submodule("DEX", "Python API for DEX format"); init_enums(LIEF_DEX_module); init_objects(LIEF_DEX_module); init_utils(LIEF_DEX_module); } void init_objects(py::module& m) { CREATE(Parser, m); CREATE(File, m); CREATE(Header, m); CREATE(Class, m); CREATE(Method, m); CREATE(Field, m); CREATE(Prototype, m); CREATE(Type, m); CREATE(MapList, m); CREATE(MapItem, m); CREATE(CodeInfo, m); } } } LIEF-0.13.1/api/python/src/DEX/pyDEX.hpp000066400000000000000000000025611443457337100173350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_DEX_H_ #define PY_LIEF_DEX_H_ #include "LIEF/DEX.hpp" #include "pyLIEF.hpp" #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) namespace LIEF { namespace DEX { template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_enums(py::module&); void init_utils(py::module&); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(File); SPECIALIZE_CREATE(Header); SPECIALIZE_CREATE(Class); SPECIALIZE_CREATE(Method); SPECIALIZE_CREATE(Field); SPECIALIZE_CREATE(Prototype); SPECIALIZE_CREATE(Type); SPECIALIZE_CREATE(MapList); SPECIALIZE_CREATE(MapItem); SPECIALIZE_CREATE(CodeInfo); } } #endif LIEF-0.13.1/api/python/src/DEX/pyEnums.cpp000066400000000000000000000034731443457337100200020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyDEX.hpp" #include "LIEF/DEX/enums.hpp" #include "LIEF/DEX/EnumToString.hpp" #define PY_ENUM(x) to_string(x), x namespace LIEF { namespace DEX { void init_enums(py::module& m) { py::enum_(m, "ACCESS_FLAGS") .value(PY_ENUM(ACCESS_FLAGS::ACC_UNKNOWN)) .value(PY_ENUM(ACCESS_FLAGS::ACC_PUBLIC)) .value(PY_ENUM(ACCESS_FLAGS::ACC_PRIVATE)) .value(PY_ENUM(ACCESS_FLAGS::ACC_PROTECTED)) .value(PY_ENUM(ACCESS_FLAGS::ACC_STATIC)) .value(PY_ENUM(ACCESS_FLAGS::ACC_FINAL)) .value(PY_ENUM(ACCESS_FLAGS::ACC_SYNCHRONIZED)) .value(PY_ENUM(ACCESS_FLAGS::ACC_VOLATILE)) .value("BRIDGE", ACCESS_FLAGS::ACC_BRIDGE) .value("TRANSIENT", ACCESS_FLAGS::ACC_TRANSIENT) .value(PY_ENUM(ACCESS_FLAGS::ACC_VARARGS)) .value(PY_ENUM(ACCESS_FLAGS::ACC_NATIVE)) .value(PY_ENUM(ACCESS_FLAGS::ACC_INTERFACE)) .value(PY_ENUM(ACCESS_FLAGS::ACC_ABSTRACT)) .value(PY_ENUM(ACCESS_FLAGS::ACC_STRICT)) .value(PY_ENUM(ACCESS_FLAGS::ACC_SYNTHETIC)) .value(PY_ENUM(ACCESS_FLAGS::ACC_ANNOTATION)) .value(PY_ENUM(ACCESS_FLAGS::ACC_ENUM)) .value(PY_ENUM(ACCESS_FLAGS::ACC_CONSTRUCTOR)) .value(PY_ENUM(ACCESS_FLAGS::ACC_DECLARED_SYNCHRONIZED)); } } } LIEF-0.13.1/api/python/src/DEX/pyUtils.cpp000066400000000000000000000026331443457337100200100ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyDEX.hpp" #include "LIEF/DEX/utils.hpp" namespace LIEF { namespace DEX { void init_utils(py::module& m) { m.def("is_dex", static_cast(&is_dex), "Check if the **file** given in parameter is a DEX", "path"_a); m.def("is_dex", static_cast&)>(&is_dex), "Check if the **raw data** given in parameter is a DEX", "raw"_a); m.def("version", static_cast(&version), "Return the DEX version of the **file** given in parameter", "file"_a); m.def("version", static_cast&)>(&version), "Return the DEX version of the **raw data** given in parameter", "raw"_a); } } } LIEF-0.13.1/api/python/src/ELF/000077500000000000000000000000001443457337100156155ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/ELF/CMakeLists.txt000066400000000000000000000037221443457337100203610ustar00rootroot00000000000000set(LIEF_PYTHON_ELF_SRC "${CMAKE_CURRENT_LIST_DIR}/pyELF.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbolVersionAuxRequirement.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbolVersion.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicEntryRunPath.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbolVersionRequirement.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBinary.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbolVersionDefinition.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbolVersionAux.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicEntryArray.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicEntryFlags.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySegment.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySection.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicEntryRpath.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocation.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicSharedObject.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicEntryLibrary.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbol.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyGnuHash.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySysvHash.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBuilder.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyEnums.cpp" ) set(LIEF_PYTHON_ELF_NOTE "${CMAKE_CURRENT_LIST_DIR}/objects/pyNote.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyNoteDetails.cpp" ) list(APPEND LIEF_PYTHON_ELF_SRC ${LIEF_PYTHON_ELF_NOTE}) include("${CMAKE_CURRENT_LIST_DIR}/objects/NoteDetails/CMakeLists.txt") set(LIEF_PYTHON_ELF_HDR "${CMAKE_CURRENT_LIST_DIR}/pyELF.hpp") source_group("Source Files\\ELF" FILES ${LIEF_PYTHON_ELF_SRC}) source_group("Header Files\\ELF" FILES ${LIEF_PYTHON_ELF_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_ELF_SRC}" "${LIEF_PYTHON_ELF_HDR}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}") LIEF-0.13.1/api/python/src/ELF/objects/000077500000000000000000000000001443457337100172465ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/000077500000000000000000000000001443457337100214615ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/CMakeLists.txt000066400000000000000000000004061443457337100242210ustar00rootroot00000000000000set(LIEF_PYTHON_ELF_NOTE_DETAILS_SRC "${CMAKE_CURRENT_LIST_DIR}/pyAndroidNote.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyNoteAbi.cpp" ) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_ELF_NOTE_DETAILS_SRC}") include("${CMAKE_CURRENT_LIST_DIR}/core/CMakeLists.txt") LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/000077500000000000000000000000001443457337100224115ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/CMakeLists.txt000066400000000000000000000006171443457337100251550ustar00rootroot00000000000000set(LIEF_PYTHON_ELF_NOTE_DETAILS_CORE "${CMAKE_CURRENT_LIST_DIR}/pyCorePrPsInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyCoreFile.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyCoreFileEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyCorePrStatus.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyCoreAuxv.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyCoreSigInfo.cpp" ) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_ELF_NOTE_DETAILS_CORE}") LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/pyCoreAuxv.cpp000066400000000000000000000077721443457337100252370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails/core/CoreAuxv.hpp" #include "LIEF/ELF/EnumToString.hpp" #include "enums_wrapper.hpp" #define PY_ENUM(x) LIEF::ELF::to_string(x), x namespace LIEF { namespace ELF { template using getter_t = T (CoreAuxv::*)(void) const; template using setter_t = void (CoreAuxv::*)(T); template<> void create(py::module& m) { py::class_ cls(m, "CoreAuxv"); LIEF::enum_(cls, "TYPES") .value(PY_ENUM(AUX_TYPE::AT_NULL)) .value(PY_ENUM(AUX_TYPE::AT_IGNORE)) .value(PY_ENUM(AUX_TYPE::AT_EXECFD)) .value(PY_ENUM(AUX_TYPE::AT_PHDR)) .value(PY_ENUM(AUX_TYPE::AT_PHENT)) .value(PY_ENUM(AUX_TYPE::AT_PHNUM)) .value(PY_ENUM(AUX_TYPE::AT_PAGESZ)) .value(PY_ENUM(AUX_TYPE::AT_BASE)) .value(PY_ENUM(AUX_TYPE::AT_FLAGS)) .value(PY_ENUM(AUX_TYPE::AT_ENTRY)) .value(PY_ENUM(AUX_TYPE::AT_NOTELF)) .value(PY_ENUM(AUX_TYPE::AT_UID)) .value(PY_ENUM(AUX_TYPE::AT_EUID)) .value(PY_ENUM(AUX_TYPE::AT_GID)) .value(PY_ENUM(AUX_TYPE::AT_EGID)) .value(PY_ENUM(AUX_TYPE::AT_CLKTCK)) .value(PY_ENUM(AUX_TYPE::AT_PLATFORM)) .value(PY_ENUM(AUX_TYPE::AT_HWCAP)) .value(PY_ENUM(AUX_TYPE::AT_HWCAP2)) .value(PY_ENUM(AUX_TYPE::AT_FPUCW)) .value(PY_ENUM(AUX_TYPE::AT_DCACHEBSIZE)) .value(PY_ENUM(AUX_TYPE::AT_ICACHEBSIZE)) .value(PY_ENUM(AUX_TYPE::AT_UCACHEBSIZE)) .value(PY_ENUM(AUX_TYPE::AT_IGNOREPPC)) .value(PY_ENUM(AUX_TYPE::AT_SECURE)) .value(PY_ENUM(AUX_TYPE::AT_BASE_PLATFORM)) .value(PY_ENUM(AUX_TYPE::AT_RANDOM)) .value(PY_ENUM(AUX_TYPE::AT_EXECFN)) .value(PY_ENUM(AUX_TYPE::AT_SYSINFO)) .value(PY_ENUM(AUX_TYPE::AT_SYSINFO_EHDR)) .value(PY_ENUM(AUX_TYPE::AT_L1I_CACHESHAPE)) .value(PY_ENUM(AUX_TYPE::AT_L1D_CACHESHAPE)); cls .def_property("values", static_cast>(&CoreAuxv::values), static_cast>(&CoreAuxv::values), "Current values as a dictionarry for which keys are AUXV types") .def("get", [] (const CoreAuxv& status, AUX_TYPE atype) -> py::object { bool error; uint64_t val = status.get(atype, &error); if (error) { return py::none(); } return py::int_(val); }, "Return the type value", "type"_a) .def("set", &CoreAuxv::set, "Set type value", "type"_a, "value"_a) .def("has", &CoreAuxv::has, "Check if a value is associated with the given type", "type"_a) .def("__getitem__", &CoreAuxv::operator[], "", py::return_value_policy::copy) .def("__setitem__", [] (CoreAuxv& status, AUX_TYPE atype, uint64_t val) { status.set(atype, val); }, "") .def("__contains__", &CoreAuxv::has, "") .def("__eq__", &CoreAuxv::operator==) .def("__ne__", &CoreAuxv::operator!=) .def("__hash__", [] (const CoreAuxv& note) { return Hash::hash(note); }) .def("__str__", [] (const CoreAuxv& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } // namespace ELF } // namespace LIEF LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/pyCoreFile.cpp000066400000000000000000000037761443457337100251730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails/core/CoreFile.hpp" namespace LIEF { namespace ELF { template using getter_t = T (CoreFile::*)(void) const; template using setter_t = void (CoreFile::*)(T); template<> void create(py::module& m) { py::class_ cls(m, "CoreFile"); py::bind_vector(cls, "files_t"); cls .def_property("files", static_cast>(&CoreFile::files), static_cast>(&CoreFile::files), "List of files mapped in core. (list of " RST_CLASS_REF(lief.ELF.CoreFileEntry) ")") .def("__len__", &CoreFile::count, "Number of files mapped in core" ) .def("__iter__", [] (const CoreFile& f) { return py::make_iterator(std::begin(f), std::end(f)); }, py::keep_alive<0, 1>()) .def("__eq__", &CoreFile::operator==) .def("__ne__", &CoreFile::operator!=) .def("__hash__", [] (const CoreFile& note) { return Hash::hash(note); }) .def("__str__", [] (const CoreFile& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/pyCoreFileEntry.cpp000066400000000000000000000026351443457337100262060ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "pyELF.hpp" #include "LIEF/ELF/NoteDetails/core/CoreFile.hpp" namespace LIEF { namespace ELF { template<> void create(py::module& m) { py::class_(m, "CoreFileEntry") .def_readwrite("start", &CoreFileEntry::start, "Start address of mapped file") .def_readwrite("end", &CoreFileEntry::end, "End address of mapped file") .def_readwrite("file_ofs", &CoreFileEntry::file_ofs, "Offset (in core) of mapped file") .def_readwrite("path", &CoreFileEntry::path, "Path of mapped file") .def("__str__", [] (const CoreFileEntry& entry) { std::ostringstream stream; stream << entry; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/pyCorePrPsInfo.cpp000066400000000000000000000056541443457337100260110ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails/core/CorePrPsInfo.hpp" namespace LIEF { namespace ELF { template using getter_t = T (CorePrPsInfo::*)(void) const; template using setter_t = void (CorePrPsInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "CorePrPsInfo") .def_property("file_name", static_cast>(&CorePrPsInfo::file_name), static_cast>(&CorePrPsInfo::file_name), "Process file name" ) .def_property("flags", static_cast>(&CorePrPsInfo::flags), static_cast>(&CorePrPsInfo::flags), "Process flags" ) .def_property("uid", static_cast>(&CorePrPsInfo::uid), static_cast>(&CorePrPsInfo::uid), "Process User ID" ) .def_property("gid", static_cast>(&CorePrPsInfo::gid), static_cast>(&CorePrPsInfo::gid), "Process Group ID" ) .def_property("pid", static_cast>(&CorePrPsInfo::pid), static_cast>(&CorePrPsInfo::pid), "Process ID" ) .def_property("ppid", static_cast>(&CorePrPsInfo::ppid), static_cast>(&CorePrPsInfo::ppid), "Process parent ID" ) .def_property("pgrp", static_cast>(&CorePrPsInfo::pgrp), static_cast>(&CorePrPsInfo::pgrp), "Process session group ID" ) .def_property("sid", static_cast>(&CorePrPsInfo::sid), static_cast>(&CorePrPsInfo::sid), "Process session ID" ) .def("__eq__", &CorePrPsInfo::operator==) .def("__ne__", &CorePrPsInfo::operator!=) .def("__hash__", [] (const CorePrPsInfo& note) { return Hash::hash(note); }) .def("__str__", [] (const CorePrPsInfo& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/pyCorePrStatus.cpp000066400000000000000000000260501443457337100260670ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails/core/CorePrStatus.hpp" #include "LIEF/ELF/EnumToString.hpp" #include "enums_wrapper.hpp" #define PY_ENUM(x) LIEF::ELF::to_string(x), x namespace LIEF { namespace ELF { template using getter_t = T (CorePrStatus::*)(void) const; template using setter_t = void (CorePrStatus::*)(T); template<> void create(py::module& m) { py::class_ cls(m, "CorePrStatus"); py::class_(cls, "timeval") .def_readwrite("sec", &CorePrStatus::timeval_t::sec) .def_readwrite("usec", &CorePrStatus::timeval_t::usec); py::class_(cls, "siginfo_t") .def_readwrite("sicode", &CorePrStatus::siginfo_t::si_code) .def_readwrite("errno", &CorePrStatus::siginfo_t::si_errno) .def_readwrite("signo", &CorePrStatus::siginfo_t::si_signo); cls .def_property("siginfo", static_cast>(&CorePrStatus::siginfo), static_cast>(&CorePrStatus::siginfo), "Info associated with the signal") .def_property("current_sig", static_cast>(&CorePrStatus::current_sig), static_cast>(&CorePrStatus::current_sig), "Current Signal") .def_property("sigpend", static_cast>(&CorePrStatus::sigpend), static_cast>(&CorePrStatus::sigpend), "Set of pending signals") .def_property("sighold", static_cast>(&CorePrStatus::sighold), static_cast>(&CorePrStatus::sighold), "Set of held signals") .def_property("pid", static_cast>(&CorePrStatus::pid), static_cast>(&CorePrStatus::pid), "Process ID") .def_property("ppid", static_cast>(&CorePrStatus::ppid), static_cast>(&CorePrStatus::ppid), "Process parent ID") .def_property("pgrp", static_cast>(&CorePrStatus::pgrp), static_cast>(&CorePrStatus::pgrp), "Process group ID") .def_property("sid", static_cast>(&CorePrStatus::sid), static_cast>(&CorePrStatus::sid), "Process session ID") .def_property("utime", static_cast>(&CorePrStatus::utime), static_cast>(&CorePrStatus::utime), "User time (" RST_CLASS_REF(lief.ELF.CorePrStatus.timeval) ")") .def_property("utime", static_cast>(&CorePrStatus::utime), static_cast>(&CorePrStatus::utime), "User time (" RST_CLASS_REF(lief.ELF.CorePrStatus.timeval) ")") .def_property("stime", static_cast>(&CorePrStatus::stime), static_cast>(&CorePrStatus::stime), "System time (" RST_CLASS_REF(lief.ELF.CorePrStatus.timeval) ")") .def_property("cutime", static_cast>(&CorePrStatus::cutime), static_cast>(&CorePrStatus::cutime), "Cumulative user time (" RST_CLASS_REF(lief.ELF.CorePrStatus.timeval) ")") .def_property("cstime", static_cast>(&CorePrStatus::cstime), static_cast>(&CorePrStatus::cstime), "Cumulative system time (" RST_CLASS_REF(lief.ELF.CorePrStatus.timeval) ")") .def_property("register_context", static_cast>(&CorePrStatus::reg_context), static_cast>(&CorePrStatus::reg_context), "Current registers state as a dictionary where the keys are " RST_CLASS_REF(lief.ELF.CorePrStatus.REGISTERS) " and the values the register's value") .def("get", [] (const CorePrStatus& status, CorePrStatus::REGISTERS reg) -> py::object { bool error; uint64_t val = status.get(reg, &error); if (error) { return py::none(); } return py::int_(val); }, "Return the register value", "register"_a) .def("set", &CorePrStatus::set, "Set register value", "register"_a, "value"_a) .def("has", &CorePrStatus::has, "Check if a value is associated with the given register", "register"_a) .def("__getitem__", &CorePrStatus::operator[], "", py::return_value_policy::copy) .def("__setitem__", [] (CorePrStatus& status, CorePrStatus::REGISTERS reg, uint64_t val) { status.set(reg, val); }, "") .def("__contains__", &CorePrStatus::has, "") .def("__eq__", &CorePrStatus::operator==) .def("__ne__", &CorePrStatus::operator!=) .def("__hash__", [] (const CorePrStatus& note) { return Hash::hash(note); }) .def("__str__", [] (const CorePrStatus& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); LIEF::enum_(cls, "REGISTERS") .value(PY_ENUM(CorePrStatus::REGISTERS::UNKNOWN)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_EBX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_ECX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_EDX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_ESI)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_EDI)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_EBP)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_EAX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_DS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_ES)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_FS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_GS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86__)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_EIP)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_CS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_EFLAGS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_ESP)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_SS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R15)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R14)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R13)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R12)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RBP)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RBX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R11)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R10)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R9)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_R8)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RAX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RCX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RDX)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RSI)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RDI)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64__)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RIP)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_CS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_EFLAGS)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_RSP)) .value(PY_ENUM(CorePrStatus::REGISTERS::X86_64_SS)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R0)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R1)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R2)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R3)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R4)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R5)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R6)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R7)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R8)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R9)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R10)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R11)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R12)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R13)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R14)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_R15)) .value(PY_ENUM(CorePrStatus::REGISTERS::ARM_CPSR)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X0)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X1)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X2)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X3)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X4)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X5)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X6)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X7)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X8)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X9)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X10)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X11)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X12)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X13)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X14)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X15)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X16)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X17)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X18)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X19)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X20)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X21)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X22)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X23)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X24)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X25)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X26)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X27)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X28)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X29)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X30)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_X31)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64_PC)) .value(PY_ENUM(CorePrStatus::REGISTERS::AARCH64__)); } } // namespace ELF } // namespace LIEF LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/core/pyCoreSigInfo.cpp000066400000000000000000000040361443457337100256400ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails/core/CoreSigInfo.hpp" namespace LIEF { namespace ELF { template using getter_t = T (CoreSigInfo::*)(void) const; template using setter_t = void (CoreSigInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "CoreSigInfo") .def_property("signo", static_cast>(&CoreSigInfo::signo), static_cast>(&CoreSigInfo::signo), "Signal number") .def_property("sigcode", static_cast>(&CoreSigInfo::sigcode), static_cast>(&CoreSigInfo::sigcode), "Signal code") .def_property("sigerrno", static_cast>(&CoreSigInfo::sigerrno), static_cast>(&CoreSigInfo::sigerrno), "If non-zero, an errno value associated with this signal") .def("__eq__", &CoreSigInfo::operator==) .def("__ne__", &CoreSigInfo::operator!=) .def("__hash__", [] (const CoreSigInfo& note) { return Hash::hash(note); }) .def("__str__", [] (const CoreSigInfo& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } // namespace ELF } // namespace LIEF LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/pyAndroidNote.cpp000066400000000000000000000041651443457337100247520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails/AndroidNote.hpp" namespace LIEF { namespace ELF { template using getter_t = T (AndroidNote::*)(void) const; template using setter_t = void (AndroidNote::*)(T); template<> void create(py::module& m) { py::class_(m, "AndroidNote") .def_property("sdk_version", static_cast>(&AndroidNote::sdk_version), static_cast>(&AndroidNote::sdk_version), "Target SDK platform" ) .def_property("ndk_version", static_cast>(&AndroidNote::ndk_version), static_cast>(&AndroidNote::ndk_version), "Android NDK version used to build the current binary" ) .def_property("ndk_build_number", static_cast>(&AndroidNote::ndk_build_number), static_cast>(&AndroidNote::ndk_build_number), "Android NDK build number" ) .def("__eq__", &AndroidNote::operator==) .def("__ne__", &AndroidNote::operator!=) .def("__hash__", [] (const AndroidNote& note) { return Hash::hash(note); }) .def("__str__", [] (const AndroidNote& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/NoteDetails/pyNoteAbi.cpp000066400000000000000000000033501443457337100240600ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails/NoteAbi.hpp" namespace LIEF { namespace ELF { template using getter_t = T (NoteAbi::*)(void) const; template using setter_t = void (NoteAbi::*)(T); template<> void create(py::module& m) { py::class_(m, "NoteAbi") .def_property_readonly("abi", static_cast>(&NoteAbi::abi), "Return the target " RST_CLASS_REF(lief.ELF.NOTE_ABIS) "" ) .def_property_readonly("version", static_cast>(&NoteAbi::version), "Return the target version as ``(Major, Minor, Patch)``" ) .def("__eq__", &NoteAbi::operator==) .def("__ne__", &NoteAbi::operator!=) .def("__hash__", [] (const NoteAbi& note) { return Hash::hash(note); }) .def("__str__", [] (const NoteAbi& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyBinary.cpp000066400000000000000000000742551443457337100215640ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "pyIterators.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/Binary.hpp" #include "pyErr.hpp" #include "pyELF.hpp" namespace LIEF { namespace ELF { template using no_const_getter = T (Binary::*)(void); template using no_const_func = T (Binary::*)(P); template using getter_t = T (Binary::*)(void) const; template using setter_t = void (Binary::*)(T); template<> void create(py::module& m) { // Binary object py::class_ bin(m, "Binary", R"delim( Class which represents an ELF binary )delim"); init_ref_iterator(bin, "it_notes"); init_ref_iterator(bin, "it_symbols_version_requirement"); init_ref_iterator(bin, "it_symbols_version_definition"); init_ref_iterator(bin, "it_segments"); init_ref_iterator(bin, "it_sections"); init_ref_iterator(bin, "it_dynamic_entries"); init_ref_iterator(bin, "it_symbols_version"); // We don't need to register it_object_relocations, it_dynamic_relocations // as it it the same underlying type init_ref_iterator(bin, "it_filter_relocation"); init_ref_iterator(bin, "it_relocations"); init_ref_iterator(bin, "it_dyn_static_symbols"); init_ref_iterator(bin, "it_symbols"); // For it_dynamic_symbols / it_static_symbols init_ref_iterator(bin, "it_filter_symbols"); // For it_imported_symbols py::enum_(bin, "PHDR_RELOC", R"delim( This enum describes the different ways to relocate the segments table. )delim") .value("AUTO", Binary::PHDR_RELOC::AUTO, R"delim( Defer the choice of the layout to LIEF. )delim") .value("PIE_SHIFT", Binary::PHDR_RELOC::PIE_SHIFT, R"delim( The content of the binary right after the segments table is shifted and the relocations are updated accordingly. This kind of shift only works with PIE binaries. )delim") .value("BSS_END", Binary::PHDR_RELOC::BSS_END, R"delim( The new segments table is relocated right after the first bss-like segments. )delim") .value("FILE_END", Binary::PHDR_RELOC::BINARY_END, R"delim( The new segments table is relocated at the end of the binary. )delim") .value("SEGMENT_GAP", Binary::PHDR_RELOC::SEGMENT_GAP, R"delim( The new segments table is relocated between two LOAD segments. This kind of relocation is only doable when there is an alignment enforcement. )delim"); bin .def_property_readonly("type", &Binary::type, "Return the binary's " RST_CLASS_REF(lief.ELF.ELF_CLASS) "") .def_property_readonly("header", static_cast>(&Binary::header), "Return " RST_CLASS_REF(lief.ELF.Header) " object", py::return_value_policy::reference_internal) .def_property_readonly("sections", static_cast>(&Binary::sections), "Return an iterator over binary's " RST_CLASS_REF(lief.ELF.Section) "", py::return_value_policy::reference_internal) .def_property_readonly("segments", static_cast>(&Binary::segments), "Return an iterator to binary's " RST_CLASS_REF(lief.ELF.Segment) "", py::return_value_policy::reference_internal) .def_property_readonly("dynamic_entries", static_cast>(&Binary::dynamic_entries), "Return an iterator to " RST_CLASS_REF(lief.ELF.DynamicEntry) " entries as a list", py::return_value_policy::reference_internal) .def("add", static_cast(&Binary::add), "Add a new " RST_CLASS_REF(lief.ELF.DynamicEntry) " in the binary", "dynamic_entry", py::return_value_policy::reference) .def_property_readonly("static_symbols", static_cast>(&Binary::static_symbols), "Return an iterator to static " RST_CLASS_REF(lief.ELF.Symbol) "", py::return_value_policy::reference_internal) .def_property_readonly("dynamic_symbols", static_cast>(&Binary::dynamic_symbols), "Return an iterator to dynamic " RST_CLASS_REF(lief.ELF.Symbol) "", py::return_value_policy::reference_internal) .def_property_readonly("symbols", static_cast>(&Binary::symbols), "Return an iterator over both **static** and **dynamic** " RST_CLASS_REF(lief.ELF.Symbol) "", py::return_value_policy::reference_internal) .def_property_readonly("exported_symbols", static_cast>(&Binary::exported_symbols), "Return dynamic " RST_CLASS_REF(lief.ELF.Symbol) " which are exported", py::return_value_policy::reference_internal) .def_property_readonly("imported_symbols", static_cast>(&Binary::imported_symbols), "Return dynamic " RST_CLASS_REF(lief.ELF.Symbol) " which are imported", py::return_value_policy::reference_internal) .def_property_readonly("dynamic_relocations", static_cast>(&Binary::dynamic_relocations), "Return an iterator over dynamics " RST_CLASS_REF(lief.ELF.Relocation) "", py::return_value_policy::reference_internal) .def("add_dynamic_relocation", &Binary::add_dynamic_relocation, R"delim( Add a new *dynamic* relocation. We consider a dynamic relocation as a relocation which is not plt-related. See: :meth:`lief.ELF.Binary.add_pltgot_relocation` )delim", "relocation"_a, py::return_value_policy::reference) .def("add_pltgot_relocation", &Binary::add_pltgot_relocation, R"delim( Add a .plt.got relocation. This kind of relocation is usually associated with a PLT stub that aims at resolving the underlying symbol. See: :meth:`lief.ELF.Binary.add_dynamic_relocation` )delim", "relocation"_a, py::return_value_policy::reference) .def("add_object_relocation", &Binary::add_object_relocation, R"delim( Add relocation for object file (.o) The first parameter is the section to add while the second parameter is the :class:`~lief.ELF.Section` associated with the relocation. If there is an error, this function returns a nullptr. Otherwise, it returns the relocation added.", )delim", "relocation"_a, "section"_a, py::return_value_policy::reference) .def_property_readonly("pltgot_relocations", static_cast>(&Binary::pltgot_relocations), "Return an iterator over PLT/GOT " RST_CLASS_REF(lief.ELF.Relocation) "", py::return_value_policy::reference_internal) .def_property_readonly("object_relocations", static_cast>(&Binary::object_relocations), "Return an iterator over object " RST_CLASS_REF(lief.ELF.Relocation) "", py::return_value_policy::reference_internal) .def_property_readonly("relocations", static_cast>(&Binary::relocations), "Return an iterator over **all** " RST_CLASS_REF(lief.ELF.Relocation) "", py::return_value_policy::reference_internal) .def_property_readonly("symbols_version", static_cast>(&Binary::symbols_version), "Return an iterator " RST_CLASS_REF(lief.ELF.SymbolVersion) "", py::return_value_policy::reference_internal) .def_property_readonly("symbols_version_requirement", static_cast>(&Binary::symbols_version_requirement), "Return an iterator to " RST_CLASS_REF(lief.ELF.SymbolVersionRequirement) "", py::return_value_policy::reference_internal) .def_property_readonly("symbols_version_definition", static_cast>(&Binary::symbols_version_definition), "Return an iterator to " RST_CLASS_REF(lief.ELF.SymbolVersionDefinition) "", py::return_value_policy::reference_internal) .def_property_readonly("use_gnu_hash", &Binary::use_gnu_hash, "``True`` if GNU hash is used") .def_property_readonly("gnu_hash", &Binary::gnu_hash, "Return the " RST_CLASS_REF(lief.ELF.GnuHash) " object\n\n" "Hash are used by the loader to speed up symbols resolution (GNU Version)", py::return_value_policy::reference_internal) .def_property_readonly("use_sysv_hash", &Binary::use_sysv_hash, "``True`` if SYSV hash is used") .def_property_readonly("sysv_hash", &Binary::sysv_hash, "Return the " RST_CLASS_REF(lief.ELF.SysvHash) " object\n\n" "Hash are used by the loader to speed up symbols resolution (SYSV version)", py::return_value_policy::reference_internal) .def_property_readonly("imagebase", &Binary::imagebase, "Return the program image base. (e.g. ``0x400000``)") .def_property_readonly("virtual_size", &Binary::virtual_size, "Return the size of the mapped binary") .def_property_readonly("is_pie", &Binary::is_pie, R"delim( Check if the binary has been compiled with `-fpie -pie` flags To do so we check if there is a `PT_INTERP` segment and if the binary type is `ET_DYN` (Shared object) )delim") .def_property_readonly("has_interpreter", &Binary::has_interpreter, "Check if the binary uses a loader (also named linker or interpreter)") .def_property_readonly("functions", &Binary::functions, "List of the functions found the in the binary") .def_property("interpreter", static_cast>(&Binary::interpreter), static_cast>(&Binary::interpreter), "ELF interpreter (loader) if any. (e.g. ``/lib64/ld-linux-x86-64.so.2``)") .def("section_from_offset", static_cast(&Binary::section_from_offset), R"delim( Return the :class:`~lief.ELF.Section` which encompasses the given offset. It returns None if a section can't be found. If ``skip_nobits`` is set (which is the case by default), this function won't consider sections for which the type is ``SHT_NOBITS`` (like ``.bss, .tbss, ...``) )delim", "offset"_a, "skip_nobits"_a = true, py::return_value_policy::reference) .def("section_from_virtual_address", static_cast(&Binary::section_from_virtual_address), R"delim( Return the :class:`~lief.ELF.Section` which encompasses the given virtual address. It returns None if a section can't be found. If ``skip_nobits`` is set (which is the case by default), this function won't consider sections for which the type is ``SHT_NOBITS`` (like ``.bss, .tbss, ...``) )delim", "address"_a, "skip_nobits"_a = true, py::return_value_policy::reference) .def("segment_from_virtual_address", static_cast>(&Binary::segment_from_virtual_address), R"delim( Return the :class:`~lief.ELF.Segment` which encompasses the given virtual address. It returns None if a segment can't be found. )delim", "address"_a, py::return_value_policy::reference) .def("segment_from_offset", static_cast>(&Binary::segment_from_offset), R"delim( Return the :class:`~lief.ELF.Segment` which encompasses the given offset. It returns None if a segment can't be found. )delim", "offset"_a, py::return_value_policy::reference) .def("get", static_cast>(&Binary::get), R"delim( Return the first binary's :class:`~lief.ELF.DynamicEntry` from the given :class:`~lief.ELF.DYNAMIC_TAGS`. It returns None if the dynamic entry can't be found. )delim", "tag"_a, py::return_value_policy::reference) .def("get", static_cast>(&Binary::get), R"delim( Return the first binary's :class:`~lief.ELF.Segment` from the given :class:`~lief.ELF.SEGMENT_TYPES` It returns None if the segment can't be found. )delim", "type"_a, py::return_value_policy::reference) .def("get", static_cast>(&Binary::get), R"delim( Return the first binary's :class:`~lief.ELF.Note` from the given :class:`~lief.ELF.NOTE_TYPES`. It returns None if the note can't be found. )delim", "type"_a, py::return_value_policy::reference) .def("get", static_cast>(&Binary::get), R"delim( Return the first binary's :class:`~lief.ELF.Section` from the given :class:`~lief.ELF.ELF_SECTION_TYPES` It returns None if the section can't be found. )delim", "type"_a, py::return_value_policy::reference) .def("has", static_cast(&Binary::has), R"delim( Check if it exists a :class:`~lief.ELF.DynamicEntry` with the given :class:`~lief.ELF.DYNAMIC_TAGS` )delim", "tag"_a) .def("has", static_cast(&Binary::has), "Check if a " RST_CLASS_REF(lief.ELF.Segment) " of *type* (" RST_CLASS_REF(lief.ELF.SEGMENT_TYPES) ") exists", "type"_a) .def("has", static_cast(&Binary::has), "Check if a " RST_CLASS_REF(lief.ELF.Note) " of *type* (" RST_CLASS_REF(lief.ELF.NOTE_TYPES) ") exists", "type"_a) .def("has", static_cast(&Binary::has), "Check if a " RST_CLASS_REF(lief.ELF.Section) " of *type* (" RST_CLASS_REF(lief.ELF.SECTION_TYPES) ") exists", "type"_a) .def("patch_pltgot", static_cast(&Binary::patch_pltgot), "Patch the imported symbol's name with the ``address``", "symbol_name"_a, "address"_a) .def("patch_pltgot", static_cast(&Binary::patch_pltgot), "Patch the imported " RST_CLASS_REF(lief.ELF.Symbol) " with the ``address``", "symbol"_a, "address"_a) .def("has_section", &Binary::has_section, "Check if a " RST_CLASS_REF(lief.ELF.Section) " with the given name exists in the binary", "section_name"_a) .def("has_section_with_offset", &Binary::has_section_with_offset, "Check if a " RST_CLASS_REF(lief.ELF.Section) " that encompasses the given offset exists", "offset"_a) .def("has_section_with_va", &Binary::has_section_with_va, "Check if a " RST_CLASS_REF(lief.ELF.Section) " that encompasses the given virtual address exists", "virtual_address"_a) .def("get_section", static_cast>(&Binary::get_section), R"delim( Return the :class:`~lief.ELF.Section` with the given ``name`` It returns None if the section can't be found. )delim", "section_name"_a, py::return_value_policy::reference) .def("add_static_symbol", &Binary::add_static_symbol, "Add a **static** " RST_CLASS_REF(lief.ELF.Symbol) " to the binary", "symbol"_a, py::return_value_policy::reference) .def("add_dynamic_symbol", static_cast(&Binary::add_dynamic_symbol), R"delim( Add a **dynamic** :class:`~lief.ELF.Symbol` to the binary The function also takes an optional :class:`lief.ELF.SymbolVersion` )delim", "symbol"_a, "symbol_version"_a = nullptr, py::return_value_policy::reference) .def("virtual_address_to_offset", [] (const Binary& self, uint64_t address) { return error_or(&Binary::virtual_address_to_offset, self, address); }, "Convert the virtual address to a file offset", "virtual_address"_a) .def("add", static_cast(&Binary::add), R"delim( Add the given :class:`~lief.ELF.Section` to the binary. If the section does not aim at being loaded in memory, the ``loaded`` parameter has to be set to ``False`` (default: ``True``) )delim", "section"_a, "loaded"_a = true, py::return_value_policy::reference) .def("add", static_cast(&Binary::add), "Add a new " RST_CLASS_REF(lief.ELF.Segment) " in the binary" "segment"_a, "base"_a = 0, py::return_value_policy::reference) .def("add", static_cast(&Binary::add), "Add a new " RST_CLASS_REF(lief.ELF.Note) " in the binary", "note"_a, py::return_value_policy::reference) .def("replace", static_cast(&Binary::replace), R"delim( Replace the :class:`~lief.ELF.Segment` given in 2nd parameter with the :class:`~lief.ELF.Segment` given in the first parameter and return the updated segment. .. warning:: The ``original_segment`` is no longer valid after this function )delim", "new_segment"_a, "original_segment"_a, "base"_a = 0, py::return_value_policy::reference) .def("extend", static_cast(&Binary::extend), "Extend the given given " RST_CLASS_REF(lief.ELF.Segment) " by the given size", "segment"_a, "size"_a, py::return_value_policy::reference) .def("extend", static_cast(&Binary::extend), "Extend the given given " RST_CLASS_REF(lief.ELF.Section) " by the given size", "segment"_a, "size"_a, py::return_value_policy::reference) .def("remove", static_cast(&Binary::remove), "Remove the given " RST_CLASS_REF(lief.ELF.DynamicEntry) " from the dynamic table", "dynamic_entry"_a) .def("remove", static_cast(&Binary::remove), "Remove **all** the " RST_CLASS_REF(lief.ELF.DynamicEntry) " with the given " RST_CLASS_REF(lief.ELF.DYNAMIC_TAGS) "", "tag"_a) .def("remove", static_cast(&Binary::remove), "Remove the given " RST_CLASS_REF(lief.ELF.Section) ". The ``clear`` parameter specifies whether or not " "we must fill its content with ``0`` before removing", "section"_a, "clear"_a = false) .def("remove", static_cast(&Binary::remove), "Remove the given " RST_CLASS_REF(lief.ELF.Note) "", "note"_a) .def("remove", static_cast(&Binary::remove), "Remove **all** the " RST_CLASS_REF(lief.ELF.Note) " with the given " RST_CLASS_REF(lief.ELF.NOTE_TYPES) "", "type"_a) .def_property_readonly("has_notes", &Binary::has_notes, "``True`` if the binary contains notes") .def_property_readonly("notes", static_cast>(&Binary::notes), "Return an iterator over the " RST_CLASS_REF(lief.ELF.Note) " entries", py::return_value_policy::reference_internal) .def("strip", &Binary::strip, "Strip the binary") .def("permute_dynamic_symbols", &Binary::permute_dynamic_symbols, "Apply the given permutation on the dynamic symbols table", "permutation"_a) .def("write", static_cast(&Binary::write), "Rebuild the binary and write it in a file", "output"_a, py::return_value_policy::reference_internal) .def("write", static_cast(&Binary::write), "Rebuild the binary with the given configuration and write it in a file", "output"_a, "config"_a, py::return_value_policy::reference_internal) .def_property_readonly("last_offset_section", &Binary::last_offset_section, "Return the last offset used in binary according to **sections table**") .def_property_readonly("last_offset_segment", &Binary::last_offset_segment, "Return the last offset used in binary according to **segments table**") .def_property_readonly("next_virtual_address", &Binary::next_virtual_address, "Return the next virtual address available") .def("add_library", &Binary::add_library, "Add a library with the given name as dependency", "library_name"_a) .def("has_library", &Binary::has_library, "Check if the given library name exists in the current binary", "library_name"_a) .def("remove_library", &Binary::remove_library, "Remove the given library", "library_name"_a) .def("get_library", static_cast>(&Binary::get_library), R"delim( Return the :class:`~lief.ELF.DynamicEntryLibrary` with the given ``name`` It returns None if the library can't be found. )delim", "library_name"_a, py::return_value_policy::reference) .def("has_dynamic_symbol", &Binary::has_dynamic_symbol, "Check if the symbol with the given ``name`` exists in the **dynamic** symbol table", "symbol_name"_a) .def("get_dynamic_symbol", static_cast>(&Binary::get_dynamic_symbol), R"delim( Get the dynamic symbol from the given name. It returns None if it can't be found. )delim", "symbol_name"_a, py::return_value_policy::reference) .def("has_static_symbol", &Binary::has_static_symbol, "Check if the symbol with the given ``name`` exists in the **static** symbol table", "symbol_name"_a) .def("get_static_symbol", static_cast>(&Binary::get_static_symbol), R"delim( Get the **static** symbol from the given ``name``. It returns None if it can't be found. )delim", "symbol_name"_a, py::return_value_policy::reference) .def("get_strings", static_cast(&Binary::strings), "Return list of strings used in the current ELF file with a minimal size given in first parameter (Default: 5)\n" "It looks for strings in the ``.roadata`` section", "min_size"_a = 5, py::return_value_policy::move) .def_property_readonly("strings", [] (const Binary& bin) { return bin.strings(); }, "Return list of strings used in the current ELF file.\n" "Basically this function looks for strings in the ``.roadata`` section", py::return_value_policy::move) .def("remove_static_symbol", static_cast(&Binary::remove_static_symbol), "Remove the given " RST_CLASS_REF(lief.ELF.Symbol) " from the ``.symtab`` section") .def("remove_dynamic_symbol", static_cast(&Binary::remove_dynamic_symbol), "Remove the given " RST_CLASS_REF(lief.ELF.Symbol) " from the ``.dynsym`` section") .def("remove_dynamic_symbol", static_cast(&Binary::remove_dynamic_symbol), "Remove the " RST_CLASS_REF(lief.ELF.Symbol) " with the name given in parameter from the ``.dynsym`` section") .def("add_exported_function", &Binary::add_exported_function, "Create a symbol for the function at the given ``address`` and create an export", "address"_a, "name"_a = "", py::return_value_policy::reference) .def("export_symbol", static_cast(&Binary::export_symbol), "Export the given symbol and create an entry if it doesn't exist", "symbol"_a, py::return_value_policy::reference) .def("export_symbol", static_cast(&Binary::export_symbol), "Export the symbol with the given name and create an entry if it doesn't exist", "symbol_name"_a, "value"_a = 0, py::return_value_policy::reference) .def("get_relocation", static_cast>(&Binary::get_relocation), "Return the " RST_CLASS_REF(lief.ELF.Relocation) " associated with the given symbol name", "symbol_name"_a, py::return_value_policy::reference) .def("get_relocation", static_cast>(&Binary::get_relocation), "Return the " RST_CLASS_REF(lief.ELF.Relocation) " associated with the given " RST_CLASS_REF(lief.ELF.Symbol) "", "symbol"_a, py::return_value_policy::reference) .def("get_relocation", static_cast>(&Binary::get_relocation), "Return the " RST_CLASS_REF(lief.ELF.Relocation) " associated with the given address", "address"_a, py::return_value_policy::reference) .def_property_readonly("dtor_functions", &Binary::dtor_functions, "List of the binary destructors (typically, the functions located in the ``.fini_array``)") .def_property_readonly("eof_offset", &Binary::eof_offset, "Return the last offset used by the ELF binary according to both, the sections table " "and the segments table.") .def_property_readonly("has_overlay", &Binary::has_overlay, "True if data are appended to the end of the binary") .def_property("overlay", static_cast>(&Binary::overlay), static_cast>(&Binary::overlay), "Overlay data that are not a part of the ELF format") .def("relocate_phdr_table", &Binary::relocate_phdr_table, R"delim( Force relocating the segments table in a specific way (see: :class:`~lief.ELF.Binary.PHDR_RELOC`). This function can be used to enforce a specific relocation of the segments table. Upon successful relocation, the function returns the offset of the relocated segments table. Otherwise, if the function fails, it returns 0 )delim", "type"_a = Binary::PHDR_RELOC::AUTO) .def(py::self += Segment()) .def(py::self += Section()) .def(py::self += DynamicEntry()) .def(py::self += Note()) .def(py::self -= DynamicEntry()) .def(py::self -= DYNAMIC_TAGS()) .def(py::self -= Note()) .def(py::self -= NOTE_TYPES()) .def("__eq__", &Binary::operator==) .def("__ne__", &Binary::operator!=) .def("__hash__", [] (const Binary& binary) { return Hash::hash(binary); }) .def("__getitem__", static_cast(&Binary::operator[]), "", py::return_value_policy::reference) .def("__getitem__", static_cast(&Binary::operator[]), "", py::return_value_policy::reference) .def("__getitem__", static_cast(&Binary::operator[]), "", py::return_value_policy::reference) .def("__getitem__", static_cast(&Binary::operator[]), "", py::return_value_policy::reference) .def("__contains__", static_cast(&Binary::has), "Check if a " RST_CLASS_REF(lief.ELF.Segment) " of *type* (" RST_CLASS_REF(lief.ELF.SEGMENT_TYPES) ") exists") .def("__contains__", static_cast(&Binary::has), "Check if the " RST_CLASS_REF(lief.ELF.DynamicEntry) " associated with the given " RST_CLASS_REF(lief.ELF.DYNAMIC_TAGS) " exists") .def("__contains__", static_cast(&Binary::has), "Check if the " RST_CLASS_REF(lief.ELF.Note) " associated with the given " RST_CLASS_REF(lief.ELF.NOTE_TYPES) " exists") .def("__contains__", static_cast(&Binary::has), "Check if the " RST_CLASS_REF(lief.ELF.Section) " associated with the given " RST_CLASS_REF(lief.ELF.SECTION_TYPES) " exists") .def("__str__", [] (const Binary& binary) { std::ostringstream stream; stream << binary; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyBuilder.cpp000066400000000000000000000061671443457337100217230ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/Binary.hpp" #include "LIEF/ELF/Builder.hpp" namespace LIEF { namespace ELF { template<> void create(py::module& m) { py::class_ builder(m, "Builder", R"delim( Class which takes an :class:`lief.ELF.Binary` object and reconstructs a valid binary )delim"); py::class_(builder, "config_t", "Interface to tweak the " RST_CLASS_REF(lief.ELF.Builder) "") .def(py::init<>()) .def_readwrite("force_relocate", &Builder::config_t::force_relocate, "Force to relocate all the ELF structures that can be relocated (mostly for testing)") .def_readwrite("dt_hash", &Builder::config_t::dt_hash) .def_readwrite("dyn_str", &Builder::config_t::dyn_str) .def_readwrite("dynamic_section", &Builder::config_t::dynamic_section) .def_readwrite("fini_array", &Builder::config_t::fini_array) .def_readwrite("init_array", &Builder::config_t::init_array) .def_readwrite("interpreter", &Builder::config_t::interpreter) .def_readwrite("jmprel", &Builder::config_t::jmprel) .def_readwrite("notes", &Builder::config_t::notes) .def_readwrite("preinit_array", &Builder::config_t::preinit_array) .def_readwrite("rela", &Builder::config_t::rela) .def_readwrite("static_symtab", &Builder::config_t::static_symtab) .def_readwrite("sym_verdef", &Builder::config_t::sym_verdef) .def_readwrite("sym_verneed", &Builder::config_t::sym_verneed) .def_readwrite("sym_versym", &Builder::config_t::sym_versym) .def_readwrite("symtab", &Builder::config_t::symtab); builder .def(py::init(), "Constructor that takes a " RST_CLASS_REF(lief.ELF.Binary) "", "elf_binary"_a) .def("build", static_cast(&Builder::build), "Perform the build of the provided ELF binary") .def_property("config", &Builder::config, &Builder::set_config, "Tweak the ELF builder with the provided config parameter", py::return_value_policy::reference_internal) .def("write", static_cast(&Builder::write), "Write the build result into the ``output`` file", "output"_a) .def("get_build", &Builder::get_build, "Return the build result as a ``list`` of bytes", py::return_value_policy::reference_internal); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyDynamicEntry.cpp000066400000000000000000000046631443457337100227420ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/DynamicEntry.hpp" #include "LIEF/ELF/hash.hpp" namespace LIEF { namespace ELF { template using getter_t = T (DynamicEntry::*)(void) const; template using setter_t = void (DynamicEntry::*)(T); template<> void create(py::module& m) { // DynamicEntry object py::class_(m, "DynamicEntry", R"delim( Class which represents an entry in the dynamic table These entries are located in the ``.dynamic`` section or the ``PT_DYNAMIC`` segment )delim") .def(py::init<>(), "Default constructor") .def(py::init(), "Constructor from a " RST_CLASS_REF(lief.ELF.DYNAMIC_TAGS) " and value", "tag"_a, "value"_a) .def_property("tag", static_cast>(&DynamicEntry::tag), static_cast>(&DynamicEntry::tag), "Return the entry's " RST_CLASS_REF(lief.ELF.DYNAMIC_TAGS) " which represent the entry type") .def_property("value", static_cast>(&DynamicEntry::value), static_cast>(&DynamicEntry::value), R"delim( Return the entry's value The meaning of the value strongly depends on the tag. It can be an offset, an index, a flag, ... )delim") .def("__eq__", &DynamicEntry::operator==) .def("__ne__", &DynamicEntry::operator!=) .def("__hash__", [] (const DynamicEntry& entry) { return Hash::hash(entry); }) .def("__str__", [] (const DynamicEntry& dynamicEntry) { std::ostringstream stream; stream << dynamicEntry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyDynamicEntryArray.cpp000066400000000000000000000061551443457337100237370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/DynamicEntryArray.hpp" #include "LIEF/ELF/DynamicEntry.hpp" namespace LIEF { namespace ELF { template using getter_t = T (DynamicEntryArray::*)(void) const; template using setter_t = void (DynamicEntryArray::*)(T); template<> void create(py::module& m) { // Dynamic Entry Array object py::class_(m, "DynamicEntryArray", R"delim( Class that represent an Array in the dynamic table. This entry is associated with constructors: - ``DT_PREINIT_ARRAY`` - ``DT_INIT_ARRAY`` - ``DT_FINI_ARRAY`` The underlying values are 64-bits integers to cover both: ELF32 and ELF64 binaries. )delim") .def(py::init<>()) .def(py::init(), "Constructor with " RST_CLASS_REF(lief.ELF.DYNAMIC_TAGS) " and value", "tag"_a, "value"_a) .def_property("array", static_cast& (DynamicEntryArray::*)()>(&DynamicEntryArray::array), static_cast&>>(&DynamicEntryArray::array), "Return the array as a list of intergers", py::return_value_policy::reference) .def("insert", &DynamicEntryArray::insert, "Insert the given ``function`` at ``pos``", "pos"_a, "function"_a, py::return_value_policy::reference) .def("append", &DynamicEntryArray::append, "Append the given ``function`` ", "function"_a, py::return_value_policy::reference) .def("remove", &DynamicEntryArray::remove, "Remove the given ``function`` ", "function"_a, py::return_value_policy::reference) .def(py::self += uint64_t()) .def(py::self -= uint64_t()) .def("__getitem__", static_cast(&DynamicEntryArray::operator[]), py::return_value_policy::reference) .def("__len__", &DynamicEntryArray::size) .def("__eq__", &DynamicEntryArray::operator==) .def("__ne__", &DynamicEntryArray::operator!=) .def("__hash__", [] (const DynamicEntryArray& entry) { return Hash::hash(entry); }) .def("__str__", [] (const DynamicEntryArray& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyDynamicEntryFlags.cpp000066400000000000000000000073041443457337100237120ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/DynamicEntryFlags.hpp" #include "LIEF/ELF/DynamicEntry.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (DynamicEntryFlags::*)(void) const; template using setter_t = void (DynamicEntryFlags::*)(T); template<> void create(py::module& m) { py::class_(m, "DynamicEntryFlags") .def(py::init<>()) .def(py::init(), "Constructor with " RST_CLASS_REF(lief.ELF.DYNAMIC_TAGS) " and value", "tag"_a, "value"_a) .def_property_readonly("flags", &DynamicEntryFlags::flags, "Return list of " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS) " or " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS_1) " (integer)", py::return_value_policy::move) .def("has", static_cast(&DynamicEntryFlags::has), "Check if this entry contains the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS) "", "flag"_a) .def("has", static_cast(&DynamicEntryFlags::has), "Check if this entry contains the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS_1) "", "flag"_a) .def("add", static_cast(&DynamicEntryFlags::add), "Add the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS) "", "flag"_a) .def("add", static_cast(&DynamicEntryFlags::add), "Add the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS_1) "", "flag"_a) .def("remove", static_cast(&DynamicEntryFlags::remove), "Remove the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS) "", "flag"_a) .def("remove", static_cast(&DynamicEntryFlags::remove), "Remove the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS_1) "", "flag"_a) .def("__eq__", &DynamicEntryFlags::operator==) .def("__ne__", &DynamicEntryFlags::operator!=) .def("__hash__", [] (const DynamicEntryFlags& entry) { return Hash::hash(entry); }) .def(py::self += DYNAMIC_FLAGS()) .def(py::self += DYNAMIC_FLAGS_1()) .def(py::self -= DYNAMIC_FLAGS()) .def(py::self -= DYNAMIC_FLAGS_1()) .def("__contains__", static_cast(&DynamicEntryFlags::has), "Check if the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS) " is present") .def("__contains__", static_cast(&DynamicEntryFlags::has), "Check if the given " RST_CLASS_REF(lief.ELF.DYNAMIC_FLAGS_1) " is present") .def("__str__", [] (const DynamicEntryFlags& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyDynamicEntryLibrary.cpp000066400000000000000000000041661443457337100242650ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/DynamicEntryLibrary.hpp" #include "LIEF/ELF/DynamicEntry.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (DynamicEntryLibrary::*)(void) const; template using setter_t = void (DynamicEntryLibrary::*)(T); template<> void create(py::module& m) { py::class_(m, "DynamicEntryLibrary", R"delim( Class which represents a ``DT_NEEDED`` entry in the dynamic table. This kind of entry is usually used to create library dependency. )delim") .def(py::init(), "Constructor from a library name", "library_name"_a) .def_property("name", [] (const DynamicEntryLibrary& obj) { return safe_string_converter(obj.name()); }, static_cast>(&DynamicEntryLibrary::name), "Library associated with this entry (e.g. ``libc.so.6``)") .def("__eq__", &DynamicEntryLibrary::operator==) .def("__ne__", &DynamicEntryLibrary::operator!=) .def("__hash__", [] (const DynamicEntryLibrary& entry) { return Hash::hash(entry); }) .def("__str__", [] (const DynamicEntryLibrary& dynamicEntryLibrary) { std::ostringstream stream; stream << dynamicEntryLibrary; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyDynamicEntryRpath.cpp000066400000000000000000000063211443457337100237320ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/DynamicEntryRpath.hpp" #include "LIEF/ELF/DynamicEntry.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (DynamicEntryRpath::*)(void) const; template using setter_t = void (DynamicEntryRpath::*)(T); template<> void create(py::module& m) { py::class_(m, "DynamicEntryRpath", R"delim( Class which represents a ``DT_RPATH`` entry. This attribute is deprecated (cf. ``man ld``) in favour of ``DT_RUNPATH`` (See :class:`~lief.ELF.DynamicRunPath`) )delim") .def(py::init(), "Constructor from (r)path", "path"_a = "") .def(py::init &>(), "Constructor from a list of paths", "paths"_a) .def_property("name", [] (const DynamicEntryRpath& obj) { return safe_string_converter(obj.name()); }, static_cast>(&DynamicEntryRpath::name), "The actual rpath as a string") .def_property("rpath", [] (const DynamicEntryRpath& obj) { return safe_string_converter(obj.rpath()); }, static_cast>(&DynamicEntryRpath::rpath), "The actual rpath as a string") .def_property("paths", static_cast >>(&DynamicEntryRpath::paths), static_cast&>>(&DynamicEntryRpath::paths), "Paths as a list") .def("insert", &DynamicEntryRpath::insert, "Insert a ``path`` at the given ``position``", "position"_a, "path"_a, py::return_value_policy::reference) .def("append", &DynamicEntryRpath::append, "Append the given ``path`` ", "path"_a, py::return_value_policy::reference) .def("remove", &DynamicEntryRpath::remove, "Remove the given ``path`` ", "path"_a, py::return_value_policy::reference) .def(py::self += std::string()) .def(py::self -= std::string()) .def("__eq__", &DynamicEntryRpath::operator==) .def("__ne__", &DynamicEntryRpath::operator!=) .def("__hash__", [] (const DynamicEntryRpath& entry) { return Hash::hash(entry); }) .def("__str__", [] (const DynamicEntryRpath& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyDynamicEntryRunPath.cpp000066400000000000000000000063141443457337100242370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/DynamicEntryRunPath.hpp" #include "LIEF/ELF/DynamicEntry.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (DynamicEntryRunPath::*)(void) const; template using setter_t = void (DynamicEntryRunPath::*)(T); template<> void create(py::module& m) { py::class_(m, "DynamicEntryRunPath", R"delim( Class that represents a ``DT_RUNPATH`` wich is used by the loader to resolve libraries (:class:`~lief.ELF.DynamicEntryLibrary`). )delim") .def(py::init(), "Constructor from a (run)path", "path"_a = "") .def(py::init &>(), "Constructor from a list of paths", "paths"_a) .def_property("name", [] (const DynamicEntryRunPath& obj) { return safe_string_converter(obj.name()); }, static_cast>(&DynamicEntryRunPath::name), "Runpath raw value") .def_property("runpath", [] (const DynamicEntryRunPath& obj) { return safe_string_converter(obj.runpath()); }, static_cast>(&DynamicEntryRunPath::runpath), "Runpath raw value") .def_property("paths", static_cast >>(&DynamicEntryRunPath::paths), static_cast&>>(&DynamicEntryRunPath::paths), "Paths as a list") .def("insert", &DynamicEntryRunPath::insert, "Insert a ``path`` at the given ``position``", "position"_a, "path"_a, py::return_value_policy::reference) .def("append", &DynamicEntryRunPath::append, "Append the given ``path`` ", "path"_a, py::return_value_policy::reference) .def("remove", &DynamicEntryRunPath::remove, "Remove the given ``path`` ", "path"_a, py::return_value_policy::reference) .def(py::self += std::string()) .def(py::self -= std::string()) .def("__eq__", &DynamicEntryRunPath::operator==) .def("__ne__", &DynamicEntryRunPath::operator!=) .def("__hash__", [] (const DynamicEntryRunPath& entry) { return Hash::hash(entry); }) .def("__str__", [] (const DynamicEntryRunPath& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyDynamicSharedObject.cpp000066400000000000000000000041311443457337100241640ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/DynamicSharedObject.hpp" #include "LIEF/ELF/DynamicEntry.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (DynamicSharedObject::*)(void) const; template using setter_t = void (DynamicSharedObject::*)(T); template<> void create(py::module& m) { py::class_(m, "DynamicSharedObject", R"delim( Class which represents a ``DT_SONAME`` entry in the dynamic table This kind of entry is usually used no name the original library. This entry is not present for executable. )delim") .def(py::init(), "Constructor from library name", "library_name"_a) .def_property("name", [] (const DynamicSharedObject& obj) { return safe_string_converter(obj.name()); }, static_cast>(&DynamicSharedObject::name), "Return the library name") .def("__eq__", &DynamicSharedObject::operator==) .def("__ne__", &DynamicSharedObject::operator!=) .def("__hash__", [] (const DynamicSharedObject& entry) { return Hash::hash(entry); }) .def("__str__", [] (const DynamicSharedObject& dynamicSharedObject) { std::ostringstream stream; stream << dynamicSharedObject; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyGnuHash.cpp000066400000000000000000000066171443457337100216720ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/GnuHash.hpp" namespace LIEF { namespace ELF { template using getter_t = T (GnuHash::*)(void) const; template using setter_t = void (GnuHash::*)(T); template<> void create(py::module& m) { py::class_(m, "GnuHash", R"delim( Class which provides a view over the GNU Hash implementation. Most of the fields are read-only since the values are re-computed by the :class:`lief.ELF.Builder`. )delim") .def(py::init<>()) .def_property_readonly("nb_buckets", &GnuHash::nb_buckets, "Return the number of buckets") .def_property_readonly("symbol_index", &GnuHash::symbol_index, "Index of the first symbol in the dynamic symbols table which is accessible with the hash table") .def_property_readonly("shift2", &GnuHash::shift2, "Shift count used in the bloom filter") .def_property_readonly("bloom_filters", &GnuHash::bloom_filters, "Bloom filters", py::return_value_policy::reference_internal) .def_property_readonly("buckets", &GnuHash::buckets, "hash buckets", py::return_value_policy::reference_internal) .def_property_readonly("hash_values", &GnuHash::hash_values, "Hash values", py::return_value_policy::reference_internal) .def("check_bloom_filter", &GnuHash::check_bloom_filter, "Check if the given hash pass the bloom filter", "hash"_a) .def("check_bucket", &GnuHash::check_bucket, "Check if the given hash pass the bucket filter", "hash"_a) .def("check", static_cast(&GnuHash::check), "Check if the symbol *probably* exists. If " "the returned value is ``false`` you can assume at ``100%`` that " "the symbol with the given name doesn't exists. If ``true`` you can't " "do any assumption ", "symbol_name"_a) .def("check", static_cast(&GnuHash::check), "Check if the symbol associated with the given *probably* exists. If " "the returned value is ``false`` you can assume at ``100%`` that " "the symbol doesn't exists. If ``true`` you can't " "do any assumption", "hash_value"_a) .def("__eq__", &GnuHash::operator==) .def("__ne__", &GnuHash::operator!=) .def("__hash__", [] (const GnuHash& gnuhash) { return Hash::hash(gnuhash); }) .def("__str__", [] (const GnuHash& gnuhash) { std::ostringstream stream; stream << gnuhash; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyHeader.cpp000066400000000000000000000216451443457337100215230ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/Header.hpp" namespace LIEF { namespace ELF { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template<> void create
(py::module& m) { py::class_(m, "Header", R"delim( Class which represents the ELF's header. This is the ELF structure that starts an ELF file. )delim") .def(py::init<>()) .def_property("identity_class", static_cast>(&Header::identity_class), static_cast>(&Header::identity_class), "Header's " RST_CLASS_REF(lief.ELF.ELF_CLASS) "." ) .def_property("identity_data", static_cast>(&Header::identity_data), static_cast>(&Header::identity_data), "Specify the data encoding (" RST_CLASS_REF(lief.ELF.ELF_DATA) ")" ) .def_property("identity_version", static_cast>(&Header::identity_version), static_cast>(&Header::identity_version), "Return header's " RST_CLASS_REF(lief.ELF.VERSION) "." ) .def_property("identity_os_abi", static_cast>(&Header::identity_os_abi), static_cast>(&Header::identity_os_abi), "Identifies the version of the ABI for which the object is prepared (" RST_CLASS_REF(lief.ELF.OS_ABI) ")." ) .def_property("identity_abi_version", static_cast>(&Header::identity_abi_version), static_cast>(&Header::identity_abi_version), "Return the ABI version (integer)." ) .def_property("identity", static_cast(&Header::identity), [] (Header& header, const py::object& obj) { if (py::isinstance(obj)) { header.identity(obj.cast()); return; } if (py::isinstance(obj)) { header.identity(obj.cast()); return; } if (py::isinstance(obj)) { header.identity(obj.cast()); return; } std::string error_str = py::repr(obj).cast(); error_str = error_str + " is not supported!"; throw py::type_error(error_str.c_str()); }, "Header's identity.", py::return_value_policy::reference_internal ) .def_property("file_type", static_cast>(&Header::file_type), static_cast>(&Header::file_type), "Return binary's " RST_CLASS_REF(lief.ELF.E_TYPE) ". This field determines if the binary \ is a executable, a library..." ) .def_property("machine_type", static_cast>(&Header::machine_type), static_cast>(&Header::machine_type), "Return the target architecture (" RST_CLASS_REF(lief.ELF.ARCH) ")") .def_property("object_file_version", static_cast>(&Header::object_file_version), static_cast>(&Header::object_file_version), "Return the " RST_CLASS_REF(lief.ELF.VERSION) "") .def_property("entrypoint", static_cast>(&Header::entrypoint), static_cast>(&Header::entrypoint), "Return the binary entry point") .def_property("program_header_offset", static_cast>(&Header::program_headers_offset), static_cast>(&Header::program_headers_offset), "Offset of program table (also known as segments table)") .def_property("section_header_offset", static_cast>(&Header::section_headers_offset), static_cast>(&Header::section_headers_offset), "Offset of section table") .def_property("processor_flag", static_cast>(&Header::processor_flag), static_cast>(&Header::processor_flag), "Processor-specific flags") .def_property_readonly("arm_flags_list", &Header::arm_flags_list, "Return a list of " RST_CLASS_REF(lief.ELF.ARM_EFLAGS) " present in " ":attr:`~lief.ELF.Header.processor_flag`", py::return_value_policy::reference_internal) .def_property_readonly("mips_flags_list", &Header::mips_flags_list, "Return a list of " RST_CLASS_REF(lief.ELF.MIPS_EFLAGS) " present in " ":attr:`~lief.ELF.Header.processor_flag`", py::return_value_policy::reference_internal) .def_property_readonly("ppc64_flags_list", &Header::ppc64_flags_list, "Return a list of " RST_CLASS_REF(lief.ELF.PPC64_EFLAGS) " present in " ":attr:`~lief.ELF.Header.processor_flag`", py::return_value_policy::reference_internal) .def_property_readonly("hexagon_flags_list", &Header::hexagon_flags_list, "Return a list of " RST_CLASS_REF(lief.ELF.HEXAGON_EFLAGS) " present in " ":attr:`~lief.ELF.Header.processor_flag`", py::return_value_policy::reference_internal) .def_property("header_size", static_cast>(&Header::header_size), static_cast>(&Header::header_size), R"delim( Return the size of the ELF header This size should be 64 for an ``ELF64`` binary and 52 for an ``ELF32``. )delim") .def_property("program_header_size", static_cast>(&Header::program_header_size), static_cast>(&Header::program_header_size), R"delim( Return the size of a Segment header (:class:`lief.ELF.Segment`) This size should be 56 for a ``ELF64`` binary and 32 for an ``ELF32``. )delim") .def_property("numberof_segments", static_cast>(&Header::numberof_segments), static_cast>(&Header::numberof_segments), "Return the number of program headers (segments)") .def_property("section_header_size", static_cast>(&Header::section_header_size), static_cast>(&Header::section_header_size), R"delim( Return the size of a Section header (:class:`lief.ELF.Section`) This size should be 64 for a ``ELF64`` binary and 40 for an ``ELF32``. )delim") .def_property("numberof_sections", static_cast>(&Header::numberof_sections), static_cast>(&Header::numberof_sections), "Return the number of sections") .def_property("section_name_table_idx", static_cast>(&Header::section_name_table_idx), static_cast>(&Header::section_name_table_idx), "Return the section index which contains sections' names") .def("__eq__", &Header::operator==) .def("__ne__", &Header::operator!=) .def("__hash__", [] (const Header& header) { return Hash::hash(header); }) .def("__contains__", static_cast(&Header::has), "Check if the given " RST_CLASS_REF(lief.ELF.ARM_EFLAGS) " is present in " ":attr:`~lief.ELF.Header.processor_flag`") .def("__contains__", static_cast(&Header::has), "Check if the given " RST_CLASS_REF(lief.ELF.MIPS_EFLAGS) " is present in " ":attr:`~lief.ELF.Header.processor_flag`") .def("__contains__", static_cast(&Header::has), "Check if the given " RST_CLASS_REF(lief.ELF.PPC64_EFLAGS) " is present in " ":attr:`~lief.ELF.Header.processor_flag`") .def("__contains__", static_cast(&Header::has), "Check if the given " RST_CLASS_REF(lief.ELF.HEXAGON_EFLAGS) " is present in " ":attr:`~lief.ELF.Header.processor_flag`") .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyNote.cpp000066400000000000000000000066471443457337100212450ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/Note.hpp" namespace LIEF { namespace ELF { template using getter_t = T (Note::*)(void) const; template using setter_t = void (Note::*)(T); template<> void create(py::module& m) { py::class_(m, "Note", R"delim( Class which represents an ELF note. )delim") .def(py::init<>(), "Default constructor") .def(py::init&>(), "Constructor from a ``name``, ``type`` and ``description``", "name"_a, "type"_a, "description"_a) .def_property_readonly("details", static_cast(&Note::details), "Parse the given note description and return a " RST_CLASS_REF(lief.ELF.NoteDetails) " object", py::return_value_policy::reference_internal) .def_property("name", static_cast>(&Note::name), static_cast>(&Note::name), "Return the *name* of the note (Usually the owner)." ) .def_property("type", static_cast>(&Note::type), static_cast>(&Note::type), "Return the type of the note. It can be one of the " RST_CLASS_REF(lief.ELF.NOTE_TYPES) " values" ) .def_property("type_core", static_cast>(&Note::type_core), static_cast>(&Note::type_core), "Return the type of the note for ELF Core (ET_CORE). It Can be one of the " RST_CLASS_REF(lief.ELF.NOTE_TYPES_CORE) " values" ) .def_property("description", static_cast>(&Note::description), static_cast>(&Note::description), "Return the description associated with the note" ) .def_property_readonly("is_core", &Note::is_core, "True if the note is associated with a coredump") .def_property_readonly("is_android", &Note::is_android, R"delim( True if the current note is specific to Android. If true, :attr:`lief.Note.details` returns a reference to the :class:`~lief.ELF.AndroidNote` object )delim") .def_property_readonly("size", &Note::size, "Size of the **raw** note") .def("__eq__", &Note::operator==) .def("__ne__", &Note::operator!=) .def("__hash__", [] (const Note& note) { return Hash::hash(note); }) .def("__str__", [] (const Note& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyNoteDetails.cpp000066400000000000000000000027251443457337100225440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/NoteDetails.hpp" namespace LIEF { namespace ELF { template using getter_t = T (NoteDetails::*)(void) const; template using setter_t = void (NoteDetails::*)(T); template<> void create(py::module& m) { py::class_(m, "NoteDetails") .def(py::init<>(), "Default ctor") .def("__eq__", &NoteDetails::operator==) .def("__ne__", &NoteDetails::operator!=) .def("__hash__", [] (const NoteDetails& note) { return Hash::hash(note); }) .def("__str__", [] (const NoteDetails& note) { std::ostringstream stream; stream << note; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyParser.cpp000066400000000000000000000061101443457337100215550ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "PyIOStream.hpp" #include "LIEF/logging.hpp" #include "LIEF/ELF/Parser.hpp" #include "LIEF/ELF/Binary.hpp" #include namespace LIEF { namespace ELF { template<> void create(py::module& m) { // Parser (Parser) m.def("parse", static_cast (*) (const std::string&, DYNSYM_COUNT_METHODS)>(&Parser::parse), R"delim( Parse the ELF binary from the given **file path** and return a :class:`lief.ELF.Binary` object For *weird* binaries (e.g sectionless) you can choose the method to use to count dynamic symbols (:class:`lief.ELF.DYNSYM_COUNT_METHODS`). By default, the value is set to :attr:`lief.ELF.DYNSYM_COUNT_METHODS.COUNT_AUTO` )delim", "filename"_a, "dynsym_count_method"_a = DYNSYM_COUNT_METHODS::COUNT_AUTO, py::return_value_policy::take_ownership); m.def("parse", static_cast(*)(const std::vector&, const std::string&, DYNSYM_COUNT_METHODS)>(&Parser::parse), R"delim( Parse the ELF binary from the given **list of bytes** and return a :class:`lief.ELF.Binary` object For *weird* binaries (e.g sectionless) you can choose the method to use to count dynamic symbols (:class:`lief.ELF.DYNSYM_COUNT_METHODS`). By default, the value is set to :attr:`lief.ELF.DYNSYM_COUNT_METHODS.COUNT_AUTO` )delim", "raw"_a, "name"_a = "", "dynsym_count_method"_a = DYNSYM_COUNT_METHODS::COUNT_AUTO, py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, const std::string& name, DYNSYM_COUNT_METHODS count) -> py::object { if (auto stream = PyIOStream::from_python(byteio)) { auto ptr = std::make_unique(std::move(*stream)); return py::cast(ELF::Parser::parse(std::move(ptr), name, count)); } logging::log(logging::LOG_ERR, "Can't create a LIEF stream interface over the provided io"); return py::none(); }, R"delim( Parse the ELF binary from a Python IO stream and return a :class:`lief.ELF.Binary` object For *weird* binaries (e.g sectionless) you can choose the method to use to count dynamic symbols (:class:`lief.ELF.lief.ELF.DYNSYM_COUNT_METHODS`). By default, the value is set to :attr:`lief.ELF.lief.ELF.DYNSYM_COUNT_METHODS.COUNT_AUTO` )delim", "io"_a, "name"_a = "", "dynsym_count_method"_a = DYNSYM_COUNT_METHODS::COUNT_AUTO, py::return_value_policy::take_ownership); } } } LIEF-0.13.1/api/python/src/ELF/objects/pyRelocation.cpp000066400000000000000000000106731443457337100224310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/Relocation.hpp" #include "LIEF/ELF/Symbol.hpp" #include "LIEF/ELF/Section.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (Relocation::*)(void) const; template using setter_t = void (Relocation::*)(T); template<> void create(py::module& m) { // Relocation object py::class_(m, "Relocation", R"delim( Class that represents an ELF relocation. )delim") .def(py::init<>()) .def(py::init(), "arch"_a) .def(py::init(), "address"_a, "type"_a = 0, "addend"_a = 0, "is_rela"_a = false) .def_property("addend", static_cast>(&Relocation::addend), static_cast>(&Relocation::addend), "Additional value") .def_property("info", static_cast>(&Relocation::info), static_cast>(&Relocation::info), "Extra information like the symbol index") .def_property("purpose", static_cast>(&Relocation::purpose), static_cast>(&Relocation::purpose), R"delim( Purpose of the relocation (:class:`~lief.ELF.RELOCATION_PURPOSES`). This value provides the information about how the relocation is used (PLT/GOT resolution, ``.o`` file, ...) )delim") .def_property("type", static_cast>(&Relocation::type), static_cast>(&Relocation::type), R"delim( Relocation type. This value depends on the underlying architecture. See: * :class:`~lief.ELF.RELOCATION_X86_64` * :class:`~lief.ELF.RELOCATION_i386` * :class:`~lief.ELF.RELOCATION_AARCH64` * :class:`~lief.ELF.RELOCATION_ARM` )delim") .def_property_readonly("has_symbol", &Relocation::has_symbol, "``True`` if a " RST_CLASS_REF(lief.ELF.Symbol) " is associated with the relocation") .def_property("symbol", static_cast(&Relocation::symbol), static_cast(&Relocation::symbol), R"delim( :class:`~lief.ELF.Symbol` associated with the relocation or None if no symbol are associated with this relocation. )delim", py::return_value_policy::reference) .def_property_readonly("has_section", &Relocation::has_section, R"delim( ``True`` if this relocation has a :class:`lief.ELF.Section` associated with. This is usually the case for object files (``.o``) )delim") .def_property_readonly("section", static_cast(&Relocation::section), R"delim( :class:`~lief.ELF.Section` in which the relocation is applied or None if not relevant )delim", py::return_value_policy::reference) .def_property_readonly("is_rela", static_cast>(&Relocation::is_rela), "``True`` if the relocation **uses** the :attr:`~lief.ELF.Relocation.addend` proprety") .def_property_readonly("is_rel", static_cast>(&Relocation::is_rel), "``True`` if the relocation **doesn't use** the :attr:`~lief.ELF.Relocation.addend` proprety") .def("__eq__", &Relocation::operator==) .def("__ne__", &Relocation::operator!=) .def("__hash__", [] (const Relocation& relocation) { return Hash::hash(relocation); }) .def("__str__", [] (const Relocation& relocation) { std::ostringstream stream; stream << relocation; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySection.cpp000066400000000000000000000142501443457337100217310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "pyIterators.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/Abstract/Section.hpp" #include "LIEF/ELF/Section.hpp" #include "LIEF/ELF/Segment.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (Section::*)(void) const; template using setter_t = void (Section::*)(T); template using no_const_getter = T (Section::*)(void); template<> void create
(py::module& m) { // Section object py::class_ sec(m, "Section", R"delim( Class which represents an ELF section. )delim"); init_ref_iterator(sec, "it_segments"); sec .def(py::init<>(), "Default constructor") .def("as_frame", &Section::as_frame, py::return_value_policy::reference_internal) .def_property_readonly("is_frame", &Section::is_frame) .def(py::init(), "Constructor from a name and a section type", "name"_a, "type"_a = ELF_SECTION_TYPES::SHT_PROGBITS) .def(py::init([] (Section& section, std::vector& content, ELF_CLASS type) { return new Section(content.data(), type); })) .def_property("type", static_cast>(&Section::type), static_cast>(&Section::type), "Return the " RST_CLASS_REF(lief.ELF.SECTION_TYPES) "") .def_property("flags", static_cast>(&Section::flags), static_cast>(&Section::flags), "Return the section's flags as an integer") .def_property_readonly("flags_list", &Section::flags_list, "Return section's flags as a list of " RST_CLASS_REF(lief.ELF.SECTION_FLAGS) "") .def_property("file_offset", static_cast>(&Section::file_offset), static_cast>(&Section::file_offset), "Offset of the section's content") .def_property_readonly("original_size", static_cast>(&Section::original_size), R"delim( Original size of the section's data. This value is used by the :class:`~lief.ELF.Builder` to determine if it needs to be relocated to avoid an override of the data )delim") .def_property("alignment", static_cast>(&Section::alignment), static_cast>(&Section::alignment), "Section alignment") .def_property("information", static_cast>(&Section::information), static_cast>(&Section::information), "Section information (this value depends on the section)") .def_property("entry_size", static_cast>(&Section::entry_size), static_cast>(&Section::entry_size), R"delim( This property returns the size of an element in the case of a section that contains an array. :Example: The `.dynamic` section contains an array of :class:`~lief.ELF.DynamicEntry`. As the size of the raw C structure of this entry is 0x10 (``sizeof(Elf64_Dyn)``) in a ELF64, the :attr:`~lief.ELF.Section.entry_size`, is set to this value. )delim") .def_property("link", static_cast>(&Section::link), static_cast>(&Section::link), "Index to another section") .def_property_readonly("segments", static_cast>(&Section::segments), "Return segment(s) associated with the given section", py::return_value_policy::reference_internal) .def("clear", &Section::clear, "Clear the content of the section with the given ``value``", "value"_a = 0, py::return_value_policy::reference) .def("add", &Section::add, "Add the given " RST_CLASS_REF(lief.ELF.SECTION_FLAGS) " to the list of " ":attr:`~lief.ELF.Section.flags`", "flag"_a) .def("remove", &Section::remove, "Remove the given " RST_CLASS_REF(lief.ELF.SECTION_FLAGS) " from the list of " ":attr:`~lief.ELF.Section.flags`", "flag"_a) .def("has", static_cast(&Section::has), "Check if the given " RST_CLASS_REF(lief.ELF.SECTION_FLAGS) " is present", "flag"_a) .def("has", static_cast(&Section::has), "Check if the given " RST_CLASS_REF(lief.ELF.Segment) " is present " "in :attr:`~lief.ELF.Section.segments`", "segment"_a) .def("__eq__", &Section::operator==) .def("__ne__", &Section::operator!=) .def("__hash__", [] (const Section& section) { return Hash::hash(section); }) .def(py::self += ELF_SECTION_FLAGS()) .def(py::self -= ELF_SECTION_FLAGS()) .def("__contains__", static_cast(&Section::has), "Check if the given " RST_CLASS_REF(lief.ELF.SECTION_FLAGS) " is present") .def("__contains__", static_cast(&Section::has), "Check if the given " RST_CLASS_REF(lief.ELF.Segment) " is present " "in :attr:`~lief.ELF.Section.segments`") .def("__str__", [] (const Section& section) { std::ostringstream stream; stream << section; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySegment.cpp000066400000000000000000000156031443457337100217320ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/Segment.hpp" #include "LIEF/ELF/Section.hpp" #include "pyIterators.hpp" #include "pyELF.hpp" namespace LIEF { namespace ELF { template using getter_t = T (Segment::*)(void) const; template using setter_t = void (Segment::*)(T); template using no_const_getter = T (Segment::*)(void); template<> void create(py::module& m) { py::class_ seg(m, "Segment", R"delim( Class which represents the ELF segments )delim"); init_ref_iterator(seg, "it_sections"); seg .def(py::init<>()) .def_static("from_raw", [] (py::bytes raw) -> py::object { const std::string& bytes_as_str = raw; std::vector cpp_raw = {std::begin(bytes_as_str), std::end(bytes_as_str)}; auto* f_ptr = static_cast(*)(const std::vector&)>(&Segment::from_raw); return error_or(f_ptr, std::move(cpp_raw)); }) .def_property("type", static_cast>(&Segment::type), static_cast>(&Segment::type), "Segment's type: " RST_CLASS_REF(lief.ELF.SEGMENT_TYPES) "") .def_property("flags", static_cast>(&Segment::flags), static_cast>(&Segment::flags), "The flag permissions associated with this segment") .def_property("file_offset", static_cast>(&Segment::file_offset), static_cast>(&Segment::file_offset), "The file offset of the data associated with this segment") .def_property("virtual_address", static_cast>(&Segment::virtual_address), static_cast>(&Segment::virtual_address), R"delim( The virtual address of the segment. .. warning:: The ELF format specifications require the following relationship: .. math:: \text{virtual address} \equiv \text{file offset} \pmod{\text{page size}} \text{virtual address} \equiv \text{file offset} \pmod{\text{alignment}} )delim") .def_property("physical_address", static_cast>(&Segment::physical_address), static_cast>(&Segment::physical_address), R"delim( The physical address of the segment. This value is not really relevant on systems like Linux or Android. On the other hand, Qualcomm trustlets might use this value. Usually this value matches :attr:`~lief.ELF.Segment.virtual_address` )delim") .def_property("physical_size", static_cast>(&Segment::physical_size), static_cast>(&Segment::physical_size), "The **file** size of the data associated with this segment") .def_property("virtual_size", static_cast>(&Segment::virtual_size), static_cast>(&Segment::virtual_size), R"delim( The in-memory size of this segment. Usually, if the ``.bss`` segment is wrapped by this segment then, virtual_size is larger than physical_size )delim") .def_property("alignment", static_cast>(&Segment::alignment), static_cast>(&Segment::alignment), "The offset alignment of the segment") .def_property("content", [] (const Segment& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast>>(&Segment::content), "The raw data associated with this segment.") .def("add", &Segment::add, "Add the given " RST_CLASS_REF(lief.ELF.SEGMENT_FLAGS) " to the list of " ":attr:`~lief.ELF.Segment.flags`", "flag"_a) .def("remove", &Segment::remove, "Remove the given " RST_CLASS_REF(lief.ELF.SEGMENT_FLAGS) " from the list of " ":attr:`~lief.ELF.Segment.flags`", "flag"_a) .def("has", static_cast(&Segment::has), "Check if the given " RST_CLASS_REF(lief.ELF.SEGMENT_FLAGS) " is present", "flag"_a) .def("has", static_cast(&Segment::has), "Check if the given " RST_CLASS_REF(lief.ELF.Section) " is present " "in :attr:`~lief.ELF.Segment.sections`", "section"_a) .def("has", static_cast(&Segment::has), "Check if the given " RST_CLASS_REF(lief.ELF.Section) " 's name is present " "in :attr:`~lief.ELF.Segment.sections`", "section_name"_a) .def_property_readonly("sections", static_cast>(&Segment::sections), "Iterator over the " RST_CLASS_REF(lief.ELF.Section) " wrapped by this segment", py::return_value_policy::reference_internal) .def("__eq__", &Segment::operator==) .def("__ne__", &Segment::operator!=) .def("__hash__", [] (const Segment& segment) { return Hash::hash(segment); }) .def(py::self += ELF_SEGMENT_FLAGS()) .def(py::self -= ELF_SEGMENT_FLAGS()) .def("__contains__", static_cast(&Segment::has), "Check if the given " RST_CLASS_REF(lief.ELF.SEGMENT_FLAGS) " is present") .def("__contains__", static_cast(&Segment::has), "Check if the given " RST_CLASS_REF(lief.ELF.Section) " is present " "in :attr:`~lief.ELF.Segment.sections`") .def("__contains__", static_cast(&Segment::has), "Check if the given " RST_CLASS_REF(lief.ELF.Section) " 's name is present " "in :attr:`~lief.ELF.Segment.sections`") .def("__str__", [] (const Segment& segment) { std::ostringstream stream; stream << segment; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySymbol.cpp000066400000000000000000000135111443457337100215710ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "pyIterators.hpp" #include "LIEF/ELF/Symbol.hpp" #include "LIEF/ELF/SymbolVersion.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/Abstract/Symbol.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (Symbol::*)(void) const; template using setter_t = void (Symbol::*)(T); template<> void create(py::module& m) { py::class_(m, "Symbol", R"delim( "Class which represents an ELF symbol" )delim") .def(py::init<>()) .def_property_readonly("demangled_name", &Symbol::demangled_name, "Symbol's name demangled or an empty string if the demangling is not possible/failed") .def_property("type", static_cast>(&Symbol::type), static_cast>(&Symbol::type), "The symbol's type provides a general classification for the associated entity. " "See: " RST_CLASS_REF(lief.ELF.SYMBOL_TYPES) "") .def_property("binding", static_cast>(&Symbol::binding), static_cast>(&Symbol::binding), "A symbol's binding determines the linkage visibility and behavior. " "See " RST_CLASS_REF(lief.ELF.SYMBOL_BINDINGS) "") .def_property("information", static_cast>(&Symbol::information), static_cast>(&Symbol::information), "This property specifies the symbol's type and binding attributes") .def_property("other", static_cast>(&Symbol::other), static_cast>(&Symbol::other), "Alias for " RST_ATTR_REF(lief.ELF.Symbol.visibility) "") .def_property("visibility", static_cast>(&Symbol::visibility), static_cast>(&Symbol::visibility), R"delim( Symbol :class:`~lief.ELF.SYMBOL_VISIBILITY`. It's basically an alias on :attr:`~lief.ELF.Symbol.other` )delim") .def_property("value", // Even though it is already defined in the base class (Abstract/Symbol) // We keep the definition to provide a dedicated documentation static_cast>(&Symbol::value), static_cast>(&Symbol::value), R"delim( This member has different menaing depending on the symbol's type and the type of the ELF file (library, object, ...) - In relocatable files, this property contains the alignment constraints of the symbol for which the section index is `SHN_COMMON`. - In relocatable files, can also contain a section's offset for a defined symbol. That is, `value` is an offset from the beginning of the section associated with this symbol. - In executable and libraries, this property contains a virtual address. )delim") .def_property("size", static_cast>(&Symbol::size), static_cast>(&Symbol::size), "Many symbols have associated sizes. For example, a data object's size is the number of " "bytes contained in the object. This member holds `0` if the symbol has no size or " "an unknown size.") .def_property("shndx", static_cast>(&Symbol::shndx), static_cast>(&Symbol::shndx), "Section index associated with the symbol") .def_property_readonly("has_version", &Symbol::has_version, "Check if this symbols has a " RST_CLASS_REF(lief.ELF.SymbolVersion) "") .def_property_readonly("symbol_version", static_cast(&Symbol::symbol_version), R"delim( Return the :class:`~lief.ELF.SymbolVersion` associated with this symbol It returns None if no version is tied to this symbol. )delim", py::return_value_policy::reference_internal) .def_property_readonly("section", &Symbol::section, R"delim( Return the section (:class:`~lief.ELF.Section`) associated with this symbol if any. Otherwise, return None. )delim", py::return_value_policy::reference) .def_property_readonly("is_static", &Symbol::is_static, "True if the symbol is a static one (i.e. from the ``.symtab`` section") .def_property_readonly("is_function", &Symbol::is_function, "True if the symbol is a function") .def_property_readonly("is_variable", &Symbol::is_variable, "True if the symbol is a variable") .def_property("exported", &Symbol::is_exported, &Symbol::set_exported, "Whether the symbol is **exported**") .def_property("imported", &Symbol::is_imported, &Symbol::set_imported, "Whether the symbol is **imported**") .def("__eq__", &Symbol::operator==) .def("__ne__", &Symbol::operator!=) .def("__hash__", [] (const Symbol& symbol) { return Hash::hash(symbol); }) .def("__str__", [] (const Symbol& symbol) { std::ostringstream stream; stream << symbol; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySymbolVersion.cpp000066400000000000000000000070511443457337100231410ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/SymbolVersion.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/SymbolVersionAux.hpp" #include "LIEF/ELF/SymbolVersionAuxRequirement.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (SymbolVersion::*)(void) const; template using setter_t = void (SymbolVersion::*)(T); template<> void create(py::module& m) { py::class_(m, "SymbolVersion") .def(py::init<>(),"Default constructor") .def(py::init(), "Constructor from :attr:`~lief.SymbolVersion.value`") .def_property_readonly_static("local", [] (const py::object&) { return SymbolVersion::local(); }, "Generate a *local* " RST_CLASS_REF(lief.ELF.SymbolVersion) "") .def_property_readonly_static("global_", [] (const py::object&) { return SymbolVersion::global(); }, "Generate a *global* " RST_CLASS_REF(lief.ELF.SymbolVersion) "") .def_property("value", static_cast>(&SymbolVersion::value), static_cast>(&SymbolVersion::value), R"delim( Value associated with the symbol. If the given SymbolVersion hasn't Auxiliary version: - `0` : The symbol is local - `1` : The symbol is global All other values are used for versions in the own object or in any of the dependencies. This is the version the symbol is tight to. )delim") .def_property_readonly("has_auxiliary_version", &SymbolVersion::has_auxiliary_version, "Check if this symbols has a " RST_CLASS_REF(lief.ELF.SymbolVersionAux) "") .def_property( "symbol_version_auxiliary", static_cast(&SymbolVersion::symbol_version_auxiliary), static_cast(&SymbolVersion::symbol_version_auxiliary), R"delim( Return the :class:`~lief.ELF.SymbolVersionAux` associated with this version or None if not present. The value can be changed by assigning a :class:`~lief.ELF.SymbolVersionAuxRequirement` which must already exist in the :class:`~lief.ELF.SymbolVersionRequirement`. Once can use :meth:`~lief.ELF.SymbolVersionAuxRequirement.add_aux_requirement` to add a new :class:`~lief.ELF.SymbolVersionAuxRequirement`. )delim", py::return_value_policy::reference_internal) .def("__eq__", &SymbolVersion::operator==) .def("__ne__", &SymbolVersion::operator!=) .def("__hash__", [] (const SymbolVersion& sv) { return Hash::hash(sv); }) .def("__str__", [] (const SymbolVersion& symbolVersion) { std::ostringstream stream; stream << symbolVersion; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySymbolVersionAux.cpp000066400000000000000000000034531443457337100236210ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/SymbolVersionAux.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (SymbolVersionAux::*)(void) const; template using setter_t = void (SymbolVersionAux::*)(T); template<> void create(py::module& m) { py::class_(m, "SymbolVersionAux", "Class which represents an Auxiliary Symbol version") .def_property("name", [] (const SymbolVersionAux& obj) { return safe_string_converter(obj.name()); }, static_cast>(&SymbolVersionAux::name), "Symbol's name (e.g. ``GLIBC_2.2.5``)") .def("__eq__", &SymbolVersionAux::operator==) .def("__ne__", &SymbolVersionAux::operator!=) .def("__hash__", [] (const SymbolVersionAux& sva) { return Hash::hash(sva); }) .def("__str__", [] (const SymbolVersionAux& symbolVersionAux) { std::ostringstream stream; stream << symbolVersionAux; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySymbolVersionAuxRequirement.cpp000066400000000000000000000050461443457337100260420ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/SymbolVersionAuxRequirement.hpp" #include #include namespace LIEF { namespace ELF { template using getter_t = T (SymbolVersionAuxRequirement::*)(void) const; template using setter_t = void (SymbolVersionAuxRequirement::*)(T); template<> void create(py::module& m) { py::class_(m, "SymbolVersionAuxRequirement") .def(py::init<>(),"Default constructor") .def_property("hash", static_cast>(&SymbolVersionAuxRequirement::hash), static_cast>(&SymbolVersionAuxRequirement::hash), "Hash value of the dependency name (use ELF hashing function)") .def_property("flags", static_cast>(&SymbolVersionAuxRequirement::flags), static_cast>(&SymbolVersionAuxRequirement::flags), "Bitmask of flags") .def_property("other", static_cast>(&SymbolVersionAuxRequirement::other), static_cast>(&SymbolVersionAuxRequirement::other), R"delim( It returns the unique version index for the file which is used in the version symbol table. If the highest bit (bit 15) is set this is a hidden symbol which cannot be referenced from outside the object. )delim") .def("__eq__", &SymbolVersionAuxRequirement::operator==) .def("__ne__", &SymbolVersionAuxRequirement::operator!=) .def("__hash__", [] (const SymbolVersionAuxRequirement& svar) { return Hash::hash(svar); }) .def("__str__", [] (const SymbolVersionAuxRequirement& symbolVersionAux) { std::ostringstream stream; stream << symbolVersionAux; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySymbolVersionDefinition.cpp000066400000000000000000000056201443457337100251520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyIterators.hpp" #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/SymbolVersionDefinition.hpp" namespace LIEF { namespace ELF { template using getter_t = T (SymbolVersionDefinition::*)(void) const; template using setter_t = void (SymbolVersionDefinition::*)(T); template using no_const_getter = T (SymbolVersionDefinition::*)(void); template<> void create(py::module& m) { py::class_ sym_ver_def(m, "SymbolVersionDefinition", "Class which represents an entry defined in ``DT_VERDEF`` or ``.gnu.version_d``"); init_ref_iterator(sym_ver_def, "it_version_aux"); sym_ver_def .def_property("version", static_cast>(&SymbolVersionDefinition::version), static_cast>(&SymbolVersionDefinition::version), R"delim( Version revision. Should be 1 This field should always have the value ``1``. It will be changed if the versioning implementation has to be changed in an incompatible way. )delim") .def_property("flags", static_cast>(&SymbolVersionDefinition::flags), static_cast>(&SymbolVersionDefinition::flags), "Version information") .def_property("hash", static_cast>(&SymbolVersionDefinition::hash), static_cast>(&SymbolVersionDefinition::hash), "Hash value of the symbol's name (using ELF hash function)") .def_property_readonly("auxiliary_symbols", static_cast>(&SymbolVersionDefinition::symbols_aux), py::return_value_policy::reference_internal) .def("__eq__", &SymbolVersionDefinition::operator==) .def("__ne__", &SymbolVersionDefinition::operator!=) .def("__hash__", [] (const SymbolVersionDefinition& svd) { return Hash::hash(svd); }) .def("__str__", [] (const SymbolVersionDefinition& svd) { std::ostringstream stream; stream << svd; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySymbolVersionRequirement.cpp000066400000000000000000000060071443457337100253620ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/SymbolVersionRequirement.hpp" #include "pyIterators.hpp" #include "pyELF.hpp" namespace LIEF { namespace ELF { template using getter_t = T (SymbolVersionRequirement::*)(void) const; template using setter_t = void (SymbolVersionRequirement::*)(T); template using no_const_getter = T (SymbolVersionRequirement::*)(void); template<> void create(py::module& m) { // Symbol Version Requirement object py::class_ sym_ver_req(m, "SymbolVersionRequirement", "Class which represents an entry in the ``DT_VERNEED`` or ``.gnu.version_r`` table"); init_ref_iterator(sym_ver_req, "it_aux_requirement"); sym_ver_req .def_property("version", static_cast>(&SymbolVersionRequirement::version), static_cast>(&SymbolVersionRequirement::version), "Version revision. Should be 1") .def_property("name", static_cast>(&SymbolVersionRequirement::name), static_cast>(&SymbolVersionRequirement::name), "Library's name associated with this requirement (e.g. ``libc.so.6``)") .def("get_auxiliary_symbols", static_cast>(&SymbolVersionRequirement::auxiliary_symbols), "Auxiliary entries (iterator over " RST_CLASS_REF(lief.ELF.SymbolVersionAuxRequirement) ")", py::return_value_policy::reference_internal) .def("add_auxiliary_requirement", static_cast(&SymbolVersionRequirement::add_aux_requirement), "Add an auxiliary version requirement to the existing entries") .def("__eq__", &SymbolVersionRequirement::operator==) .def("__ne__", &SymbolVersionRequirement::operator!=) .def("__hash__", [] (const SymbolVersionRequirement& svr) { return Hash::hash(svr); }) .def("__str__", [] (const SymbolVersionRequirement& symbolVersionRequirement) { std::ostringstream stream; stream << symbolVersionRequirement; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/objects/pySysvHash.cpp000066400000000000000000000044021443457337100220730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "pyELF.hpp" #include "LIEF/ELF/hash.hpp" #include "LIEF/ELF/SysvHash.hpp" namespace LIEF { namespace ELF { template using getter_t = T (SysvHash::*)() const; template using setter_t = void (SysvHash::*)(T); template<> void create(py::module& m) { py::class_(m, "SysvHash", R"delim( Class which represents the SYSV hash for the symbols resolution References: * http://www.linker-aliens.org/blogs/ali/entry/gnu_hash_elf_sections/ * https://docs.oracle.com/cd/E23824_01/html/819-0690/chapter6-48031.html )delim") .def(py::init<>()) .def_property_readonly("nbucket", &SysvHash::nbucket, "Return the number of buckets") .def_property("nchain", static_cast>(&SysvHash::nchain), static_cast>(&SysvHash::nchain), "Return the number of *chains* (symbol table index)") .def_property_readonly("buckets", &SysvHash::buckets, "Buckets values", py::return_value_policy::reference_internal) .def_property_readonly("chains", &SysvHash::chains, "Chains values", py::return_value_policy::reference_internal) .def("__eq__", &SysvHash::operator==) .def("__ne__", &SysvHash::operator!=) .def("__hash__", [] (const SysvHash& sysvhash) { return Hash::hash(sysvhash); }) .def("__str__", [] (const SysvHash& sysvhash) { std::ostringstream stream; stream << sysvhash; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/ELF/pyELF.cpp000066400000000000000000000034051443457337100173020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" namespace LIEF { namespace ELF { void init_python_module(py::module& m) { py::module LIEF_ELF_module = m.def_submodule("ELF", "Python API for the ELF format"); init_enums(LIEF_ELF_module); init_objects(LIEF_ELF_module); } void init_objects(py::module& m) { CREATE(Parser, m); CREATE(SymbolVersion, m); CREATE(Binary, m); CREATE(Header, m); CREATE(Section, m); CREATE(Segment, m); CREATE(Symbol, m); CREATE(Relocation, m); CREATE(SymbolVersionAux, m); CREATE(SymbolVersionAuxRequirement, m); CREATE(SymbolVersionDefinition,m ); CREATE(SymbolVersionRequirement, m); CREATE(DynamicEntry, m); CREATE(DynamicEntryLibrary, m); CREATE(DynamicSharedObject, m); CREATE(DynamicEntryArray, m); CREATE(DynamicEntryRpath, m); CREATE(DynamicEntryRunPath, m); CREATE(DynamicEntryFlags, m); CREATE(GnuHash, m); CREATE(SysvHash, m); CREATE(Builder, m); CREATE(Note, m); CREATE(NoteDetails, m); CREATE(AndroidNote, m); CREATE(NoteAbi, m); CREATE(CorePrPsInfo, m); CREATE(CoreFile, m); CREATE(CoreFileEntry, m); CREATE(CorePrStatus, m); CREATE(CoreAuxv, m); CREATE(CoreSigInfo, m); } } } LIEF-0.13.1/api/python/src/ELF/pyELF.hpp000066400000000000000000000055351443457337100173150ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ELF_H_ #define PY_LIEF_ELF_H_ #include #include #include "LIEF/ELF/NoteDetails/core/CoreFile.hpp" #include "pyLIEF.hpp" #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) namespace LIEF { namespace ELF { class Parser; class Binary; class Header; class Section; class Segment; class Symbol; class Relocation; class SymbolVersion; class SymbolVersionAux; class SymbolVersionRequirement; class SymbolVersionDefinition; class SymbolVersionAuxRequirement; class DynamicEntry; class DynamicEntryLibrary; class DynamicSharedObject; class DynamicEntryArray; class DynamicEntryRpath; class DynamicEntryRunPath; class DynamicEntryFlags; class GnuHash; class SysvHash; class Builder; class Note; class NoteDetails; class AndroidNote; class NoteAbi; class CorePrPsInfo; class CoreFile; class CoreFileEntry; class CorePrStatus; class CoreAuxv; class CoreSigInfo; template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_enums(py::module&); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(Binary); SPECIALIZE_CREATE(Header); SPECIALIZE_CREATE(Section); SPECIALIZE_CREATE(Segment); SPECIALIZE_CREATE(Symbol); SPECIALIZE_CREATE(Relocation); SPECIALIZE_CREATE(SymbolVersion); SPECIALIZE_CREATE(SymbolVersionAux); SPECIALIZE_CREATE(SymbolVersionRequirement); SPECIALIZE_CREATE(SymbolVersionDefinition); SPECIALIZE_CREATE(SymbolVersionAuxRequirement); SPECIALIZE_CREATE(DynamicEntry); SPECIALIZE_CREATE(DynamicEntryLibrary); SPECIALIZE_CREATE(DynamicSharedObject); SPECIALIZE_CREATE(DynamicEntryArray); SPECIALIZE_CREATE(DynamicEntryRpath); SPECIALIZE_CREATE(DynamicEntryRunPath); SPECIALIZE_CREATE(DynamicEntryFlags); SPECIALIZE_CREATE(GnuHash); SPECIALIZE_CREATE(SysvHash); SPECIALIZE_CREATE(Builder); SPECIALIZE_CREATE(Note); SPECIALIZE_CREATE(NoteDetails); SPECIALIZE_CREATE(AndroidNote); SPECIALIZE_CREATE(NoteAbi); SPECIALIZE_CREATE(CorePrPsInfo); SPECIALIZE_CREATE(CoreFile); SPECIALIZE_CREATE(CoreFileEntry); SPECIALIZE_CREATE(CorePrStatus); SPECIALIZE_CREATE(CoreAuxv); SPECIALIZE_CREATE(CoreSigInfo); } } PYBIND11_MAKE_OPAQUE(LIEF::ELF::CoreFile::files_t); #endif LIEF-0.13.1/api/python/src/ELF/pyEnums.cpp000066400000000000000000001661661443457337100200010ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyELF.hpp" #include "enums_wrapper.hpp" #include "LIEF/ELF/enums.hpp" #include "LIEF/ELF/EnumToString.hpp" #define PY_ENUM(x) to_string(x), x namespace LIEF { namespace ELF { void init_enums(py::module& m) { LIEF::enum_(m, "ELF_CLASS") .value(PY_ENUM(ELF_CLASS::ELFCLASSNONE)) .value(PY_ENUM(ELF_CLASS::ELFCLASS32)) .value(PY_ENUM(ELF_CLASS::ELFCLASS64)); LIEF::enum_(m, "ELF_DATA") .value(PY_ENUM(ELF_DATA::ELFDATANONE)) .value(PY_ENUM(ELF_DATA::ELFDATA2LSB)) .value(PY_ENUM(ELF_DATA::ELFDATA2MSB)); LIEF::enum_(m, "OS_ABI") .value(PY_ENUM(OS_ABI::ELFOSABI_SYSTEMV)) .value(PY_ENUM(OS_ABI::ELFOSABI_HPUX)) .value(PY_ENUM(OS_ABI::ELFOSABI_NETBSD)) .value(PY_ENUM(OS_ABI::ELFOSABI_LINUX)) .value("GNU", OS_ABI::ELFOSABI_GNU) .value(PY_ENUM(OS_ABI::ELFOSABI_HURD)) .value(PY_ENUM(OS_ABI::ELFOSABI_SOLARIS)) .value(PY_ENUM(OS_ABI::ELFOSABI_AIX)) .value(PY_ENUM(OS_ABI::ELFOSABI_IRIX)) .value(PY_ENUM(OS_ABI::ELFOSABI_FREEBSD)) .value(PY_ENUM(OS_ABI::ELFOSABI_TRU64)) .value(PY_ENUM(OS_ABI::ELFOSABI_MODESTO)) .value(PY_ENUM(OS_ABI::ELFOSABI_OPENBSD)) .value(PY_ENUM(OS_ABI::ELFOSABI_OPENVMS)) .value(PY_ENUM(OS_ABI::ELFOSABI_NSK)) .value(PY_ENUM(OS_ABI::ELFOSABI_AROS)) .value(PY_ENUM(OS_ABI::ELFOSABI_FENIXOS)) .value(PY_ENUM(OS_ABI::ELFOSABI_CLOUDABI)) .value(PY_ENUM(OS_ABI::ELFOSABI_AMDGPU_HSA)) .value("C6000_ELFABI", OS_ABI::ELFOSABI_C6000_ELFABI) .value(PY_ENUM(OS_ABI::ELFOSABI_C6000_LINUX)) .value(PY_ENUM(OS_ABI::ELFOSABI_ARM)) .value(PY_ENUM(OS_ABI::ELFOSABI_STANDALONE)); // Enum for the *e_type* of ElfXX_Ehdr LIEF::enum_(m, "E_TYPE") .value(PY_ENUM(E_TYPE::ET_NONE)) .value(PY_ENUM(E_TYPE::ET_REL)) .value(PY_ENUM(E_TYPE::ET_EXEC)) .value(PY_ENUM(E_TYPE::ET_DYN)) .value(PY_ENUM(E_TYPE::ET_CORE)) .value(PY_ENUM(E_TYPE::ET_LOPROC)) .value(PY_ENUM(E_TYPE::ET_HIPROC)); //! Enum for the *e_version* of ElfXX_Ehdr; LIEF::enum_(m, "VERSION") .value(PY_ENUM(VERSION::EV_NONE)) .value(PY_ENUM(VERSION::EV_CURRENT)); // Enum for the *e_machine* of ElfXX_Ehdr LIEF::enum_(m, "ARCH") .value(PY_ENUM(ARCH::EM_NONE)) .value(PY_ENUM(ARCH::EM_M32)) .value(PY_ENUM(ARCH::EM_SPARC)) .value(PY_ENUM(ARCH::EM_386)) .value(PY_ENUM(ARCH::EM_68K)) .value(PY_ENUM(ARCH::EM_88K)) .value(PY_ENUM(ARCH::EM_IAMCU)) .value(PY_ENUM(ARCH::EM_860)) .value(PY_ENUM(ARCH::EM_MIPS)) .value(PY_ENUM(ARCH::EM_S370)) .value(PY_ENUM(ARCH::EM_MIPS_RS3_LE)) .value(PY_ENUM(ARCH::EM_PARISC)) .value(PY_ENUM(ARCH::EM_VPP500)) .value(PY_ENUM(ARCH::EM_SPARC32PLUS)) .value(PY_ENUM(ARCH::EM_960)) .value(PY_ENUM(ARCH::EM_PPC)) .value(PY_ENUM(ARCH::EM_PPC64)) .value(PY_ENUM(ARCH::EM_S390)) .value(PY_ENUM(ARCH::EM_SPU)) .value(PY_ENUM(ARCH::EM_V800)) .value(PY_ENUM(ARCH::EM_FR20)) .value(PY_ENUM(ARCH::EM_RH32)) .value(PY_ENUM(ARCH::EM_RCE)) .value(PY_ENUM(ARCH::EM_ARM)) .value(PY_ENUM(ARCH::EM_ALPHA)) .value(PY_ENUM(ARCH::EM_SH)) .value(PY_ENUM(ARCH::EM_SPARCV9)) .value(PY_ENUM(ARCH::EM_TRICORE)) .value(PY_ENUM(ARCH::EM_ARC)) .value(PY_ENUM(ARCH::EM_H8_300)) .value(PY_ENUM(ARCH::EM_H8_300H)) .value(PY_ENUM(ARCH::EM_H8S)) .value(PY_ENUM(ARCH::EM_H8_500)) .value(PY_ENUM(ARCH::EM_IA_64)) .value(PY_ENUM(ARCH::EM_MIPS_X)) .value(PY_ENUM(ARCH::EM_COLDFIRE)) .value(PY_ENUM(ARCH::EM_68HC12)) .value(PY_ENUM(ARCH::EM_MMA)) .value(PY_ENUM(ARCH::EM_PCP)) .value(PY_ENUM(ARCH::EM_NCPU)) .value(PY_ENUM(ARCH::EM_NDR1)) .value(PY_ENUM(ARCH::EM_STARCORE)) .value(PY_ENUM(ARCH::EM_ME16)) .value(PY_ENUM(ARCH::EM_ST100)) .value(PY_ENUM(ARCH::EM_TINYJ)) .value(PY_ENUM(ARCH::EM_X86_64)) .value(PY_ENUM(ARCH::EM_PDSP)) .value(PY_ENUM(ARCH::EM_PDP10)) .value(PY_ENUM(ARCH::EM_PDP11)) .value(PY_ENUM(ARCH::EM_FX66)) .value(PY_ENUM(ARCH::EM_ST9PLUS)) .value(PY_ENUM(ARCH::EM_ST7)) .value(PY_ENUM(ARCH::EM_68HC16)) .value(PY_ENUM(ARCH::EM_68HC11)) .value(PY_ENUM(ARCH::EM_68HC08)) .value(PY_ENUM(ARCH::EM_68HC05)) .value(PY_ENUM(ARCH::EM_SVX)) .value(PY_ENUM(ARCH::EM_ST19)) .value(PY_ENUM(ARCH::EM_VAX)) .value(PY_ENUM(ARCH::EM_CRIS)) .value(PY_ENUM(ARCH::EM_JAVELIN)) .value(PY_ENUM(ARCH::EM_FIREPATH)) .value(PY_ENUM(ARCH::EM_ZSP)) .value(PY_ENUM(ARCH::EM_MMIX)) .value(PY_ENUM(ARCH::EM_HUANY)) .value(PY_ENUM(ARCH::EM_PRISM)) .value(PY_ENUM(ARCH::EM_AVR)) .value(PY_ENUM(ARCH::EM_FR30)) .value(PY_ENUM(ARCH::EM_D10V)) .value(PY_ENUM(ARCH::EM_D30V)) .value(PY_ENUM(ARCH::EM_V850)) .value(PY_ENUM(ARCH::EM_M32R)) .value(PY_ENUM(ARCH::EM_MN10300)) .value(PY_ENUM(ARCH::EM_MN10200)) .value(PY_ENUM(ARCH::EM_PJ)) .value(PY_ENUM(ARCH::EM_OPENRISC)) .value(PY_ENUM(ARCH::EM_ARC_COMPACT)) .value(PY_ENUM(ARCH::EM_XTENSA)) .value(PY_ENUM(ARCH::EM_VIDEOCORE)) .value(PY_ENUM(ARCH::EM_TMM_GPP)) .value(PY_ENUM(ARCH::EM_NS32K)) .value(PY_ENUM(ARCH::EM_TPC)) .value(PY_ENUM(ARCH::EM_SNP1K)) .value(PY_ENUM(ARCH::EM_ST200)) .value(PY_ENUM(ARCH::EM_IP2K)) .value(PY_ENUM(ARCH::EM_MAX)) .value(PY_ENUM(ARCH::EM_CR)) .value(PY_ENUM(ARCH::EM_F2MC16)) .value(PY_ENUM(ARCH::EM_MSP430)) .value(PY_ENUM(ARCH::EM_BLACKFIN)) .value(PY_ENUM(ARCH::EM_SE_C33)) .value(PY_ENUM(ARCH::EM_SEP)) .value(PY_ENUM(ARCH::EM_ARCA)) .value(PY_ENUM(ARCH::EM_UNICORE)) .value(PY_ENUM(ARCH::EM_EXCESS)) .value(PY_ENUM(ARCH::EM_DXP)) .value(PY_ENUM(ARCH::EM_ALTERA_NIOS2)) .value(PY_ENUM(ARCH::EM_CRX)) .value(PY_ENUM(ARCH::EM_XGATE)) .value(PY_ENUM(ARCH::EM_C166)) .value(PY_ENUM(ARCH::EM_M16C)) .value(PY_ENUM(ARCH::EM_DSPIC30F)) .value(PY_ENUM(ARCH::EM_CE)) .value(PY_ENUM(ARCH::EM_M32C)) .value(PY_ENUM(ARCH::EM_TSK3000)) .value(PY_ENUM(ARCH::EM_RS08)) .value(PY_ENUM(ARCH::EM_SHARC)) .value(PY_ENUM(ARCH::EM_ECOG2)) .value(PY_ENUM(ARCH::EM_SCORE7)) .value(PY_ENUM(ARCH::EM_DSP24)) .value(PY_ENUM(ARCH::EM_VIDEOCORE3)) .value(PY_ENUM(ARCH::EM_LATTICEMICO32)) .value(PY_ENUM(ARCH::EM_SE_C17)) .value(PY_ENUM(ARCH::EM_TI_C6000)) .value(PY_ENUM(ARCH::EM_TI_C2000)) .value(PY_ENUM(ARCH::EM_TI_C5500)) .value(PY_ENUM(ARCH::EM_MMDSP_PLUS)) .value(PY_ENUM(ARCH::EM_CYPRESS_M8C)) .value(PY_ENUM(ARCH::EM_R32C)) .value(PY_ENUM(ARCH::EM_TRIMEDIA)) .value(PY_ENUM(ARCH::EM_HEXAGON)) .value(PY_ENUM(ARCH::EM_8051)) .value(PY_ENUM(ARCH::EM_STXP7X)) .value(PY_ENUM(ARCH::EM_NDS32)) .value("ECOG1", ARCH::EM_ECOG1) .value("ECOG1X", ARCH::EM_ECOG1X) .value(PY_ENUM(ARCH::EM_MAXQ30)) .value(PY_ENUM(ARCH::EM_XIMO16)) .value(PY_ENUM(ARCH::EM_MANIK)) .value(PY_ENUM(ARCH::EM_CRAYNV2)) .value(PY_ENUM(ARCH::EM_RX)) .value(PY_ENUM(ARCH::EM_METAG)) .value(PY_ENUM(ARCH::EM_MCST_ELBRUS)) .value(PY_ENUM(ARCH::EM_ECOG16)) .value(PY_ENUM(ARCH::EM_CR16)) .value(PY_ENUM(ARCH::EM_ETPU)) .value(PY_ENUM(ARCH::EM_SLE9X)) .value(PY_ENUM(ARCH::EM_L10M)) .value(PY_ENUM(ARCH::EM_K10M)) .value(PY_ENUM(ARCH::EM_AARCH64)) .value(PY_ENUM(ARCH::EM_AVR32)) .value(PY_ENUM(ARCH::EM_STM8)) .value(PY_ENUM(ARCH::EM_TILE64)) .value(PY_ENUM(ARCH::EM_TILEPRO)) .value(PY_ENUM(ARCH::EM_CUDA)) .value(PY_ENUM(ARCH::EM_TILEGX)) .value(PY_ENUM(ARCH::EM_CLOUDSHIELD)) .value(PY_ENUM(ARCH::EM_COREA_1ST)) .value(PY_ENUM(ARCH::EM_COREA_2ND)) .value(PY_ENUM(ARCH::EM_ARC_COMPACT2)) .value(PY_ENUM(ARCH::EM_OPEN8)) .value(PY_ENUM(ARCH::EM_RL78)) .value(PY_ENUM(ARCH::EM_VIDEOCORE5)) .value(PY_ENUM(ARCH::EM_78KOR)) .value(PY_ENUM(ARCH::EM_56800EX)) .value(PY_ENUM(ARCH::EM_BA1)) .value(PY_ENUM(ARCH::EM_BA2)) .value(PY_ENUM(ARCH::EM_XCORE)) .value(PY_ENUM(ARCH::EM_MCHP_PIC)) .value(PY_ENUM(ARCH::EM_INTEL205)) .value(PY_ENUM(ARCH::EM_INTEL206)) .value(PY_ENUM(ARCH::EM_INTEL207)) .value(PY_ENUM(ARCH::EM_INTEL208)) .value(PY_ENUM(ARCH::EM_INTEL209)) .value(PY_ENUM(ARCH::EM_KM32)) .value(PY_ENUM(ARCH::EM_KMX32)) .value(PY_ENUM(ARCH::EM_KMX16)) .value(PY_ENUM(ARCH::EM_KMX8)) .value(PY_ENUM(ARCH::EM_KVARC)) .value(PY_ENUM(ARCH::EM_CDP)) .value(PY_ENUM(ARCH::EM_COGE)) .value(PY_ENUM(ARCH::EM_COOL)) .value(PY_ENUM(ARCH::EM_NORC)) .value(PY_ENUM(ARCH::EM_CSR_KALIMBA)) .value(PY_ENUM(ARCH::EM_AMDGPU)) .value(PY_ENUM(ARCH::EM_RISCV)) .value(PY_ENUM(ARCH::EM_BPF)); //! Enum for the *sh_type* of ElfXX_Shdr; LIEF::enum_(m, "SECTION_TYPES") .value(PY_ENUM(ELF_SECTION_TYPES::SHT_NULL)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_PROGBITS)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_SYMTAB)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_STRTAB)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_RELA)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_HASH)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_DYNAMIC)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_NOTE)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_NOBITS)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_REL)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_SHLIB)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_DYNSYM)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_INIT_ARRAY)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_FINI_ARRAY)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_PREINIT_ARRAY)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_GROUP)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_SYMTAB_SHNDX)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_LOOS)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_GNU_ATTRIBUTES)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_GNU_HASH)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_GNU_verdef)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_GNU_verneed)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_GNU_versym)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_ANDROID_REL)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_ANDROID_RELA)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_LLVM_ADDRSIG)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_RELR)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_ARM_EXIDX)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_ARM_PREEMPTMAP)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_ARM_ATTRIBUTES)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_ARM_DEBUGOVERLAY)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_ARM_OVERLAYSECTION)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_HEX_ORDERED)) .value("X86_64_UNWIND", ELF_SECTION_TYPES::SHT_X86_64_UNWIND) //.value(PY_ENUM(ELF_SECTION_TYPES::SHT_MIPS_REGINFO)) //.value(PY_ENUM(ELF_SECTION_TYPES::SHT_MIPS_OPTIONS)) //.value(PY_ENUM(ELF_SECTION_TYPES::SHT_MIPS_ABIFLAGS)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_HIPROC)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_LOUSER)) .value(PY_ENUM(ELF_SECTION_TYPES::SHT_HIUSER)); //! Enum for the *sh_flags* field of ElfXX_Shdr; LIEF::enum_(m, "SECTION_FLAGS", py::arithmetic()) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_NONE)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_WRITE)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_ALLOC)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_EXECINSTR)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_MERGE)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_STRINGS)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_INFO_LINK)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_LINK_ORDER)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_OS_NONCONFORMING)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_GROUP)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_TLS)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_EXCLUDE)) .value("SHF_CP_SECTION", ELF_SECTION_FLAGS::XCORE_SHF_CP_SECTION) .value(PY_ENUM(ELF_SECTION_FLAGS::XCORE_SHF_DP_SECTION)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_MASKOS)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_MASKPROC)) .value(PY_ENUM(ELF_SECTION_FLAGS::SHF_HEX_GPREL)); //! Enum for the *p_type* field of ElfXX_Phdr LIEF::enum_(m, "SEGMENT_TYPES") .value(PY_ENUM(SEGMENT_TYPES::PT_NULL)) .value(PY_ENUM(SEGMENT_TYPES::PT_LOAD)) .value(PY_ENUM(SEGMENT_TYPES::PT_DYNAMIC)) .value(PY_ENUM(SEGMENT_TYPES::PT_INTERP)) .value(PY_ENUM(SEGMENT_TYPES::PT_NOTE)) .value(PY_ENUM(SEGMENT_TYPES::PT_SHLIB)) .value(PY_ENUM(SEGMENT_TYPES::PT_PHDR)) .value(PY_ENUM(SEGMENT_TYPES::PT_TLS)) .value(PY_ENUM(SEGMENT_TYPES::PT_GNU_EH_FRAME)) .value(PY_ENUM(SEGMENT_TYPES::PT_GNU_PROPERTY)) .value(PY_ENUM(SEGMENT_TYPES::PT_GNU_STACK)) .value(PY_ENUM(SEGMENT_TYPES::PT_GNU_RELRO)) .value(PY_ENUM(SEGMENT_TYPES::PT_ARM_ARCHEXT)) .value(PY_ENUM(SEGMENT_TYPES::PT_ARM_EXIDX)) .value("UNWIND", SEGMENT_TYPES::PT_ARM_UNWIND); //! Enum for the *p_flags* field of ElfXX_Phdr LIEF::enum_(m, "SEGMENT_FLAGS", py::arithmetic()) .value(PY_ENUM(ELF_SEGMENT_FLAGS::PF_NONE)) .value(PY_ENUM(ELF_SEGMENT_FLAGS::PF_X)) .value(PY_ENUM(ELF_SEGMENT_FLAGS::PF_W)) .value(PY_ENUM(ELF_SEGMENT_FLAGS::PF_R)); LIEF::enum_(m, "DYNAMIC_TAGS") .value(PY_ENUM(DYNAMIC_TAGS::DT_NULL)) .value(PY_ENUM(DYNAMIC_TAGS::DT_NEEDED)) .value(PY_ENUM(DYNAMIC_TAGS::DT_PLTRELSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_PLTGOT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_HASH)) .value(PY_ENUM(DYNAMIC_TAGS::DT_STRTAB)) .value(PY_ENUM(DYNAMIC_TAGS::DT_SYMTAB)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELA)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELASZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELAENT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_STRSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_SYMENT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_INIT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_FINI)) .value(PY_ENUM(DYNAMIC_TAGS::DT_SONAME)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RPATH)) .value(PY_ENUM(DYNAMIC_TAGS::DT_SYMBOLIC)) .value(PY_ENUM(DYNAMIC_TAGS::DT_REL)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELENT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_PLTREL)) .value(PY_ENUM(DYNAMIC_TAGS::DT_DEBUG)) .value(PY_ENUM(DYNAMIC_TAGS::DT_TEXTREL)) .value(PY_ENUM(DYNAMIC_TAGS::DT_JMPREL)) .value(PY_ENUM(DYNAMIC_TAGS::DT_BIND_NOW)) .value(PY_ENUM(DYNAMIC_TAGS::DT_INIT_ARRAY)) .value(PY_ENUM(DYNAMIC_TAGS::DT_FINI_ARRAY)) .value(PY_ENUM(DYNAMIC_TAGS::DT_INIT_ARRAYSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_FINI_ARRAYSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RUNPATH)) .value(PY_ENUM(DYNAMIC_TAGS::DT_FLAGS)) .value(PY_ENUM(DYNAMIC_TAGS::DT_PREINIT_ARRAY)) .value(PY_ENUM(DYNAMIC_TAGS::DT_PREINIT_ARRAYSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_GNU_HASH)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELACOUNT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELCOUNT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_FLAGS_1)) .value(PY_ENUM(DYNAMIC_TAGS::DT_VERSYM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_VERDEF)) .value(PY_ENUM(DYNAMIC_TAGS::DT_VERDEFNUM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_VERNEED)) .value(PY_ENUM(DYNAMIC_TAGS::DT_VERNEEDNUM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_RLD_VERSION)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_TIME_STAMP)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_ICHECKSUM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_IVERSION)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_FLAGS)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_BASE_ADDRESS)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_MSYM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_CONFLICT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_LIBLIST)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_LOCAL_GOTNO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_CONFLICTNO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_LIBLISTNO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_SYMTABNO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_UNREFEXTNO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_GOTSYM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_HIPAGENO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_RLD_MAP)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_CLASS)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_CLASS_NO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_INSTANCE)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_INSTANCE_NO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_RELOC)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_RELOC_NO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_SYM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_SYM_NO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_CLASSSYM)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DELTA_CLASSSYM_NO)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_CXX_FLAGS)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_PIXIE_INIT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_SYMBOL_LIB)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_LOCALPAGE_GOTIDX)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_LOCAL_GOTIDX)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_HIDDEN_GOTIDX)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_PROTECTED_GOTIDX)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_OPTIONS)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_INTERFACE)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_DYNSTR_ALIGN)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_INTERFACE_SIZE)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_RLD_TEXT_RESOLVE_ADDR)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_PERF_SUFFIX)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_COMPACT_SIZE)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_GP_VALUE)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_AUX_DYNAMIC)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_PLTGOT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_MIPS_RWPLT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_ANDROID_REL_OFFSET)) .value(PY_ENUM(DYNAMIC_TAGS::DT_ANDROID_REL_SIZE)) .value(PY_ENUM(DYNAMIC_TAGS::DT_ANDROID_REL)) .value(PY_ENUM(DYNAMIC_TAGS::DT_ANDROID_RELSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_ANDROID_RELA)) .value(PY_ENUM(DYNAMIC_TAGS::DT_ANDROID_RELASZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELR)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELRSZ)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELRENT)) .value(PY_ENUM(DYNAMIC_TAGS::DT_RELRCOUNT)); LIEF::enum_(m, "SYMBOL_TYPES") .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_NOTYPE)) .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_OBJECT)) .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_FUNC)) .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_SECTION)) .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_FILE)) .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_COMMON)) .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_TLS)) .value(PY_ENUM(ELF_SYMBOL_TYPES::STT_GNU_IFUNC)); LIEF::enum_(m, "SYMBOL_BINDINGS") .value(PY_ENUM(SYMBOL_BINDINGS::STB_LOCAL)) .value(PY_ENUM(SYMBOL_BINDINGS::STB_GLOBAL)) .value(PY_ENUM(SYMBOL_BINDINGS::STB_WEAK)) .value(PY_ENUM(SYMBOL_BINDINGS::STB_GNU_UNIQUE)); LIEF::enum_(m, "RELOCATION_X86_64") .value(PY_ENUM(RELOC_x86_64::R_X86_64_NONE)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PC32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOT32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PLT32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_COPY)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GLOB_DAT)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_JUMP_SLOT)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_RELATIVE)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTPCREL)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_32S)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_16)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PC16)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_8)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PC8)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_DTPMOD64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_DTPOFF64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_TPOFF64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_TLSGD)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_TLSLD)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_DTPOFF32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTTPOFF)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_TPOFF32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PC64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTOFF64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTPC32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOT64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTPCREL64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTPC64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTPLT64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PLTOFF64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_SIZE32)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_SIZE64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTPC32_TLSDESC)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_TLSDESC_CALL)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_TLSDESC)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_IRELATIVE)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_RELATIVE64)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PC32_BND)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_PLT32_BND)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_GOTPCRELX)) .value(PY_ENUM(RELOC_x86_64::R_X86_64_REX_GOTPCRELX)); LIEF::enum_(m, "RELOCATION_ARM") .value(PY_ENUM(RELOC_ARM::R_ARM_NONE)) .value(PY_ENUM(RELOC_ARM::R_ARM_PC24)) .value(PY_ENUM(RELOC_ARM::R_ARM_ABS32)) .value(PY_ENUM(RELOC_ARM::R_ARM_REL32)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDR_PC_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_ABS16)) .value(PY_ENUM(RELOC_ARM::R_ARM_ABS12)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_ABS5)) .value(PY_ENUM(RELOC_ARM::R_ARM_ABS8)) .value(PY_ENUM(RELOC_ARM::R_ARM_SBREL32)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_CALL)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_PC8)) .value(PY_ENUM(RELOC_ARM::R_ARM_BREL_ADJ)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_DESC)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_SWI8)) .value(PY_ENUM(RELOC_ARM::R_ARM_XPC25)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_XPC22)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_DTPMOD32)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_DTPOFF32)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_TPOFF32)) .value(PY_ENUM(RELOC_ARM::R_ARM_COPY)) .value(PY_ENUM(RELOC_ARM::R_ARM_GLOB_DAT)) .value(PY_ENUM(RELOC_ARM::R_ARM_JUMP_SLOT)) .value(PY_ENUM(RELOC_ARM::R_ARM_RELATIVE)) .value(PY_ENUM(RELOC_ARM::R_ARM_GOTOFF32)) .value(PY_ENUM(RELOC_ARM::R_ARM_BASE_PREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_GOT_BREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_PLT32)) .value(PY_ENUM(RELOC_ARM::R_ARM_CALL)) .value(PY_ENUM(RELOC_ARM::R_ARM_JUMP24)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_JUMP24)) .value(PY_ENUM(RELOC_ARM::R_ARM_BASE_ABS)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PCREL_7_0)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PCREL_15_8)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PCREL_23_15)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDR_SBREL_11_0_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_SBREL_19_12_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_SBREL_27_20_CK)) .value(PY_ENUM(RELOC_ARM::R_ARM_TARGET1)) .value(PY_ENUM(RELOC_ARM::R_ARM_SBREL31)) .value(PY_ENUM(RELOC_ARM::R_ARM_V4BX)) .value(PY_ENUM(RELOC_ARM::R_ARM_TARGET2)) .value(PY_ENUM(RELOC_ARM::R_ARM_PREL31)) .value(PY_ENUM(RELOC_ARM::R_ARM_MOVW_ABS_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_MOVT_ABS)) .value(PY_ENUM(RELOC_ARM::R_ARM_MOVW_PREL_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_MOVT_PREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_MOVW_ABS_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_MOVT_ABS)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_MOVW_PREL_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_MOVT_PREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_JUMP19)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_JUMP6)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_ALU_PREL_11_0)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_PC12)) .value(PY_ENUM(RELOC_ARM::R_ARM_ABS32_NOI)) .value(PY_ENUM(RELOC_ARM::R_ARM_REL32_NOI)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PC_G0_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PC_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PC_G1_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PC_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_PC_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDR_PC_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDR_PC_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDRS_PC_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDRS_PC_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDRS_PC_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDC_PC_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDC_PC_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDC_PC_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_SB_G0_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_SB_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_SB_G1_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_SB_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_ALU_SB_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDR_SB_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDR_SB_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDR_SB_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDRS_SB_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDRS_SB_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDRS_SB_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDC_SB_G0)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDC_SB_G1)) .value(PY_ENUM(RELOC_ARM::R_ARM_LDC_SB_G2)) .value(PY_ENUM(RELOC_ARM::R_ARM_MOVW_BREL_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_MOVT_BREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_MOVW_BREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_MOVW_BREL_NC)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_MOVT_BREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_MOVW_BREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_GOTDESC)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_CALL)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_DESCSEQ)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_TLS_CALL)) .value(PY_ENUM(RELOC_ARM::R_ARM_PLT32_ABS)) .value(PY_ENUM(RELOC_ARM::R_ARM_GOT_ABS)) .value(PY_ENUM(RELOC_ARM::R_ARM_GOT_PREL)) .value(PY_ENUM(RELOC_ARM::R_ARM_GOT_BREL12)) .value(PY_ENUM(RELOC_ARM::R_ARM_GOTOFF12)) .value(PY_ENUM(RELOC_ARM::R_ARM_GOTRELAX)) .value(PY_ENUM(RELOC_ARM::R_ARM_GNU_VTENTRY)) .value(PY_ENUM(RELOC_ARM::R_ARM_GNU_VTINHERIT)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_JUMP11)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_JUMP8)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_GD32)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_LDM32)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_LDO32)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_IE32)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_LE32)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_LDO12)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_LE12)) .value(PY_ENUM(RELOC_ARM::R_ARM_TLS_IE12GP)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_0)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_1)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_2)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_3)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_4)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_5)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_6)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_7)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_8)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_9)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_10)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_11)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_12)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_13)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_14)) .value(PY_ENUM(RELOC_ARM::R_ARM_PRIVATE_15)) .value(PY_ENUM(RELOC_ARM::R_ARM_ME_TOO)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_TLS_DESCSEQ16)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_TLS_DESCSEQ32)) .value(PY_ENUM(RELOC_ARM::R_ARM_IRELATIVE)) .value(PY_ENUM(RELOC_ARM::R_ARM_RXPC25)) .value(PY_ENUM(RELOC_ARM::R_ARM_RSBREL32)) .value(PY_ENUM(RELOC_ARM::R_ARM_THM_RPC22)) .value(PY_ENUM(RELOC_ARM::R_ARM_RREL32)) .value(PY_ENUM(RELOC_ARM::R_ARM_RPC24)) .value(PY_ENUM(RELOC_ARM::R_ARM_RBASE)); LIEF::enum_(m, "RELOCATION_i386") .value(PY_ENUM(RELOC_i386::R_386_NONE)) .value(PY_ENUM(RELOC_i386::R_386_32)) .value(PY_ENUM(RELOC_i386::R_386_PC32)) .value(PY_ENUM(RELOC_i386::R_386_GOT32)) .value(PY_ENUM(RELOC_i386::R_386_PLT32)) .value(PY_ENUM(RELOC_i386::R_386_COPY)) .value(PY_ENUM(RELOC_i386::R_386_GLOB_DAT)) .value(PY_ENUM(RELOC_i386::R_386_JUMP_SLOT)) .value(PY_ENUM(RELOC_i386::R_386_RELATIVE)) .value(PY_ENUM(RELOC_i386::R_386_GOTOFF)) .value(PY_ENUM(RELOC_i386::R_386_GOTPC)) .value(PY_ENUM(RELOC_i386::R_386_32PLT)) .value(PY_ENUM(RELOC_i386::R_386_TLS_TPOFF)) .value(PY_ENUM(RELOC_i386::R_386_TLS_IE)) .value(PY_ENUM(RELOC_i386::R_386_TLS_GOTIE)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LE)) .value(PY_ENUM(RELOC_i386::R_386_TLS_GD)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LDM)) .value(PY_ENUM(RELOC_i386::R_386_16)) .value(PY_ENUM(RELOC_i386::R_386_PC16)) .value(PY_ENUM(RELOC_i386::R_386_8)) .value(PY_ENUM(RELOC_i386::R_386_PC8)) .value(PY_ENUM(RELOC_i386::R_386_TLS_GD_32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_GD_PUSH)) .value(PY_ENUM(RELOC_i386::R_386_TLS_GD_CALL)) .value(PY_ENUM(RELOC_i386::R_386_TLS_GD_POP)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LDM_32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LDM_PUSH)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LDM_CALL)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LDM_POP)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LDO_32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_IE_32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_LE_32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_DTPMOD32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_DTPOFF32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_TPOFF32)) .value(PY_ENUM(RELOC_i386::R_386_TLS_GOTDESC)) .value(PY_ENUM(RELOC_i386::R_386_TLS_DESC_CALL)) .value(PY_ENUM(RELOC_i386::R_386_TLS_DESC)) .value(PY_ENUM(RELOC_i386::R_386_IRELATIVE)) .value(PY_ENUM(RELOC_i386::R_386_NUM)); LIEF::enum_(m, "RELOCATION_AARCH64") .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_NONE)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ABS64)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ABS32)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ABS16)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_PREL64)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_PREL32)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_PREL16)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_UABS_G0)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_UABS_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_UABS_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_UABS_G1_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_UABS_G2)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_UABS_G2_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_UABS_G3)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_SABS_G0)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_SABS_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_SABS_G2)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LD_PREL_LO19)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ADR_PREL_LO21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ADR_PREL_PG_HI21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ADR_PREL_PG_HI21_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ADD_ABS_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LDST8_ABS_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TSTBR14)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_CONDBR19)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_JUMP26)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_CALL26)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LDST16_ABS_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LDST32_ABS_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LDST64_ABS_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_PREL_G0)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_PREL_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_PREL_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_PREL_G1_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_PREL_G2)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_PREL_G2_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_PREL_G3)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LDST128_ABS_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_GOTOFF_G0)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_GOTOFF_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_GOTOFF_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_GOTOFF_G1_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_GOTOFF_G2)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_GOTOFF_G2_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_MOVW_GOTOFF_G3)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_GOTREL64)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_GOTREL32)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_GOT_LD_PREL19)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LD64_GOTOFF_LO15)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_ADR_GOT_PAGE)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LD64_GOT_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_LD64_GOTPAGE_LO15)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSGD_ADR_PREL21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSGD_ADR_PAGE21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSGD_ADD_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSGD_MOVW_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSGD_MOVW_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_ADR_PREL21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_ADR_PAGE21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_ADD_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_MOVW_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_MOVW_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LD_PREL19)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_MOVW_DTPREL_G2)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_MOVW_DTPREL_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_MOVW_DTPREL_G1_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_MOVW_DTPREL_G0)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_MOVW_DTPREL_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_ADD_DTPREL_HI12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_ADD_DTPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_ADD_DTPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST8_DTPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST8_DTPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST16_DTPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST16_DTPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST32_DTPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST32_DTPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST64_DTPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST64_DTPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSIE_MOVW_GOTTPREL_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSIE_MOVW_GOTTPREL_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSIE_ADR_GOTTPREL_PAGE21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSIE_LD64_GOTTPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSIE_LD_GOTTPREL_PREL19)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_MOVW_TPREL_G2)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_MOVW_TPREL_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_MOVW_TPREL_G1_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_MOVW_TPREL_G0)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_MOVW_TPREL_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_ADD_TPREL_HI12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_ADD_TPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_ADD_TPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST8_TPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST8_TPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST16_TPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST16_TPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST32_TPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST32_TPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST64_TPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST64_TPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_LD_PREL19)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_ADR_PREL21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_ADR_PAGE21)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_LD64_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_ADD_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_OFF_G1)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_OFF_G0_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_LDR)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_ADD)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC_CALL)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST128_TPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLE_LDST128_TPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST128_DTPREL_LO12)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSLD_LDST128_DTPREL_LO12_NC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_COPY)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_GLOB_DAT)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_JUMP_SLOT)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_RELATIVE)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLS_DTPREL64)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLS_DTPMOD64)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLS_TPREL64)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_TLSDESC)) .value(PY_ENUM(RELOC_AARCH64::R_AARCH64_IRELATIVE)); LIEF::enum_(m, "RELOCATION_PPC") .value(PY_ENUM(RELOC_POWERPC32::R_PPC_NONE)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR32)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR24)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR14)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR14_BRTAKEN)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_ADDR14_BRNTAKEN)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL24)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL14)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL14_BRTAKEN)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL14_BRNTAKEN)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_PLTREL24)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_JMP_SLOT)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_RELATIVE)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_LOCAL24PC)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL32)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TLS)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_DTPMOD32)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TPREL16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TPREL16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TPREL32)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_DTPREL16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_DTPREL16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_DTPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_DTPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_DTPREL32)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSGD16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSGD16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSGD16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSGD16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSLD16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSLD16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSLD16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TLSLD16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TPREL16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TPREL16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_TPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_DTPREL16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_DTPREL16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_DTPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_GOT_DTPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TLSGD)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_TLSLD)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL16)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL16_LO)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL16_HI)) .value(PY_ENUM(RELOC_POWERPC32::R_PPC_REL16_HA)); LIEF::enum_(m, "RELOCATION_PPC64") .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_NONE)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR32)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR24)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR14)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR14_BRTAKEN)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR14_BRNTAKEN)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL24)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL14)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL14_BRTAKEN)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL14_BRNTAKEN)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_JMP_SLOT)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_RELATIVE)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL32)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR64)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_HIGHER)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_HIGHERA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_HIGHEST)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_HIGHESTA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL64)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TOC16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TOC16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TOC16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TOC16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TOC)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_ADDR16_LO_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT16_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT16_LO_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TOC16_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TOC16_LO_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TLS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPMOD64)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL64)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL64)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSGD16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSGD16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSGD16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSGD16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSLD16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSLD16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSLD16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TLSLD16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TPREL16_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TPREL16_LO_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_TPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_DTPREL16_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_DTPREL16_LO_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_DTPREL16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_GOT_DTPREL16_HA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_LO_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_HIGHER)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_HIGHERA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_HIGHEST)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TPREL16_HIGHESTA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_LO_DS)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_HIGHER)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_HIGHERA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_HIGHEST)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_DTPREL16_HIGHESTA)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TLSGD)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_TLSLD)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL16)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL16_LO)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL16_HI)) .value(PY_ENUM(RELOC_POWERPC64::R_PPC64_REL16_HA)); LIEF::enum_(m, "RELOCATION_MIPS") .value(PY_ENUM(RELOC_MIPS::R_MIPS_NONE)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_32)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_REL32)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_26)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GPREL16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_LITERAL)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GOT16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PC16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_CALL16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GPREL32)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_UNUSED1)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_UNUSED2)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_UNUSED3)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_SHIFT5)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_SHIFT6)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_64)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GOT_DISP)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GOT_PAGE)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GOT_OFST)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GOT_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GOT_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_SUB)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_INSERT_A)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_INSERT_B)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_DELETE)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_HIGHER)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_HIGHEST)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_CALL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_CALL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_SCN_DISP)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_REL16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_ADD_IMMEDIATE)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PJUMP)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_RELGOT)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_JALR)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_DTPMOD32)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_DTPREL32)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_DTPMOD64)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_DTPREL64)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_GD)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_LDM)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_DTPREL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_DTPREL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_GOTTPREL)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_TPREL32)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_TPREL64)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_TPREL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_TLS_TPREL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_GLOB_DAT)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PC21_S2)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PC26_S2)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PC18_S3)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PC19_S2)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PCHI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_PCLO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_26)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_GPREL)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_GOT16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_CALL16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_TLS_GD)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_TLS_LDM)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_TLS_DTPREL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_TLS_DTPREL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_TLS_GOTTPREL)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_TLS_TPREL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS16_TLS_TPREL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_COPY)) .value(PY_ENUM(RELOC_MIPS::R_MIPS_JUMP_SLOT)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_26_S1)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GPREL16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_LITERAL)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GOT16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC7_S1)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC10_S1)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC16_S1)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_CALL16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GOT_DISP)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GOT_PAGE)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GOT_OFST)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GOT_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GOT_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_SUB)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_HIGHER)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_HIGHEST)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_CALL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_CALL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_SCN_DISP)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_JALR)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_HI0_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_TLS_GD)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_TLS_LDM)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_TLS_DTPREL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_TLS_DTPREL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_TLS_GOTTPREL)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_TLS_TPREL_HI16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_TLS_TPREL_LO16)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_GPREL7_S2)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC23_S2)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC21_S2)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC26_S2)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC18_S3)) .value(PY_ENUM(RELOC_MIPS::R_MICROMIPS_PC19_S2)); LIEF::enum_(m, "DYNSYM_COUNT_METHODS") .value(PY_ENUM(DYNSYM_COUNT_METHODS::COUNT_AUTO)) .value(PY_ENUM(DYNSYM_COUNT_METHODS::COUNT_SECTION)) .value(PY_ENUM(DYNSYM_COUNT_METHODS::COUNT_HASH)) .value(PY_ENUM(DYNSYM_COUNT_METHODS::COUNT_RELOCATIONS)); LIEF::enum_(m, "NOTE_TYPES") .value(PY_ENUM(NOTE_TYPES::NT_UNKNOWN)) .value(PY_ENUM(NOTE_TYPES::NT_GNU_ABI_TAG)) .value(PY_ENUM(NOTE_TYPES::NT_GNU_HWCAP)) .value(PY_ENUM(NOTE_TYPES::NT_GNU_BUILD_ID)) .value(PY_ENUM(NOTE_TYPES::NT_GNU_GOLD_VERSION)) .value(PY_ENUM(NOTE_TYPES::NT_GNU_PROPERTY_TYPE_0)) .value(PY_ENUM(NOTE_TYPES::NT_GNU_BUILD_ATTRIBUTE_OPEN)) .value(PY_ENUM(NOTE_TYPES::NT_GNU_BUILD_ATTRIBUTE_FUNC)) .value(PY_ENUM(NOTE_TYPES::NT_CRASHPAD)); LIEF::enum_(m, "NOTE_TYPES_CORE") .value(PY_ENUM(NOTE_TYPES_CORE::NT_CORE_UNKNOWN)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_PRSTATUS)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_PRFPREG)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_PRPSINFO)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_TASKSTRUCT)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_AUXV)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_SIGINFO)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_FILE)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_ARM_VFP)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_ARM_TLS)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_ARM_HW_BREAK)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_ARM_HW_WATCH)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_ARM_SYSTEM_CALL)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_ARM_SVE)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_386_TLS)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_386_IOPERM)) .value(PY_ENUM(NOTE_TYPES_CORE::NT_386_XSTATE)); LIEF::enum_(m, "NOTE_ABIS") .value(PY_ENUM(NOTE_ABIS::ELF_NOTE_UNKNOWN)) .value(PY_ENUM(NOTE_ABIS::ELF_NOTE_OS_LINUX)) .value(PY_ENUM(NOTE_ABIS::ELF_NOTE_OS_GNU)) .value(PY_ENUM(NOTE_ABIS::ELF_NOTE_OS_SOLARIS2)) .value(PY_ENUM(NOTE_ABIS::ELF_NOTE_OS_FREEBSD)) .value(PY_ENUM(NOTE_ABIS::ELF_NOTE_OS_NETBSD)) .value(PY_ENUM(NOTE_ABIS::ELF_NOTE_OS_SYLLABLE)); LIEF::enum_(m, "RELOCATION_PURPOSES") .value(PY_ENUM(RELOCATION_PURPOSES::RELOC_PURPOSE_NONE)) .value(PY_ENUM(RELOCATION_PURPOSES::RELOC_PURPOSE_PLTGOT)) .value(PY_ENUM(RELOCATION_PURPOSES::RELOC_PURPOSE_DYNAMIC)) .value(PY_ENUM(RELOCATION_PURPOSES::RELOC_PURPOSE_OBJECT)); LIEF::enum_(m, "ARM_EFLAGS", py::arithmetic()) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_SOFT_FLOAT)) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_VFP_FLOAT)) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_EABI_UNKNOWN)) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_EABI_VER1)) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_EABI_VER2)) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_EABI_VER3)) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_EABI_VER4)) .value(PY_ENUM(ARM_EFLAGS::EF_ARM_EABI_VER5)); LIEF::enum_(m, "PPC64_EFLAGS", py::arithmetic()) .value(PY_ENUM(PPC64_EFLAGS::EF_PPC64_ABI)); LIEF::enum_(m, "MIPS_EFLAGS", py::arithmetic()) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_NOREORDER)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_PIC)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_CPIC)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ABI2)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_32BITMODE)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_FP64)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_NAN2008)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ABI_O32)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ABI_O64)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ABI_EABI32)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ABI_EABI64)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_3900)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_4010)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_4100)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_4650)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_4120)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_4111)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_SB1)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_OCTEON)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_XLR)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_OCTEON2)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_OCTEON3)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_5400)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_5900)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_5500)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_9000)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_LS2E)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_LS2F)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MACH_LS3A)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_MICROMIPS)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_ASE_M16)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_ASE_MDMX)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_1)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_2)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_3)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_4)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_5)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_32)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_64)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_32R2)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_64R2)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_32R6)) .value(PY_ENUM(MIPS_EFLAGS::EF_MIPS_ARCH_64R6)); LIEF::enum_(m, "HEXAGON_EFLAGS", py::arithmetic()) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_MACH_V2)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_MACH_V3)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_MACH_V4)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_MACH_V5)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_ISA_MACH)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_ISA_V2)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_ISA_V3)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_ISA_V4)) .value(PY_ENUM(HEXAGON_EFLAGS::EF_HEXAGON_ISA_V5)); LIEF::enum_(m, "IDENTITY") .value(PY_ENUM(IDENTITY::EI_MAG0)) .value(PY_ENUM(IDENTITY::EI_MAG1)) .value(PY_ENUM(IDENTITY::EI_MAG2)) .value(PY_ENUM(IDENTITY::EI_MAG3)) .value(PY_ENUM(IDENTITY::EI_CLASS)) .value(PY_ENUM(IDENTITY::EI_DATA)) .value(PY_ENUM(IDENTITY::EI_VERSION)) .value(PY_ENUM(IDENTITY::EI_OSABI)) .value(PY_ENUM(IDENTITY::EI_ABIVERSION)) .value(PY_ENUM(IDENTITY::EI_PAD)) .value(PY_ENUM(IDENTITY::EI_NIDENT)); LIEF::enum_(m, "SYMBOL_SECTION_INDEX") .value(PY_ENUM(SYMBOL_SECTION_INDEX::SHN_UNDEF)) .value(PY_ENUM(SYMBOL_SECTION_INDEX::SHN_ABS)) .value(PY_ENUM(SYMBOL_SECTION_INDEX::SHN_COMMON)) .value(PY_ENUM(SYMBOL_SECTION_INDEX::SHN_HIRESERVE)); LIEF::enum_(m, "DYNAMIC_FLAGS", py::arithmetic()) .value(PY_ENUM(DYNAMIC_FLAGS::DF_ORIGIN)) .value(PY_ENUM(DYNAMIC_FLAGS::DF_SYMBOLIC)) .value(PY_ENUM(DYNAMIC_FLAGS::DF_TEXTREL)) .value(PY_ENUM(DYNAMIC_FLAGS::DF_BIND_NOW)) .value(PY_ENUM(DYNAMIC_FLAGS::DF_STATIC_TLS)); LIEF::enum_(m, "DYNAMIC_FLAGS_1", py::arithmetic()) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NOW)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_GLOBAL)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_GROUP)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NODELETE)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_LOADFLTR)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_INITFIRST)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NOOPEN)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_ORIGIN)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_DIRECT)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_TRANS)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_INTERPOSE)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NODEFLIB)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NODUMP)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_CONFALT)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_ENDFILTEE)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_DISPRELDNE)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_DISPRELPND)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NODIRECT)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_IGNMULDEF)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NOKSYMS)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NOHDR)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_EDITED)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_NORELOC)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_SYMINTPOSE)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_GLOBAUDIT)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_SINGLETON)) .value(PY_ENUM(DYNAMIC_FLAGS_1::DF_1_PIE)); LIEF::enum_(m, "SYMBOL_VISIBILITY") .value(PY_ENUM(ELF_SYMBOL_VISIBILITY::STV_DEFAULT)) .value(PY_ENUM(ELF_SYMBOL_VISIBILITY::STV_HIDDEN)) .value(PY_ENUM(ELF_SYMBOL_VISIBILITY::STV_INTERNAL)) .value(PY_ENUM(ELF_SYMBOL_VISIBILITY::STV_PROTECTED)); } } } LIEF-0.13.1/api/python/src/MachO/000077500000000000000000000000001443457337100161765ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/MachO/CMakeLists.txt000066400000000000000000000057161443457337100207470ustar00rootroot00000000000000set(LIEF_PYTHON_MACHO_SRC "${CMAKE_CURRENT_LIST_DIR}/pyMachO.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDylibCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBinary.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyFatBinary.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyLoadCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySegmentCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySection.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbol.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbolCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyUUID.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySourceVersion.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyVersionMin.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyMainCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDylinker.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDyldInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDyldChainedFixups.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyChainedBindingInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDyldBindingInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDyldExportsTrie.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocationFixup.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyFunctionStarts.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocation.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocationObject.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocationDyld.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBindingInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyExportInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyThreadCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRPathCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParserConfig.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDynamicSymbolCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyCodeSignature.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySegmentSplitInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDataInCode.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDataCodeEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySubFramework.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDyldEnvironment.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyEncryptionInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBuildVersion.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyFilesetCommand.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyCodeSignatureDir.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyTwoLevelHints.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyLinkerOptHint.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBuilder.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyEnums.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyUtils.cpp" ) set(LIEF_PYTHON_MACHO_HDR "${CMAKE_CURRENT_LIST_DIR}/pyMachO.hpp") source_group("Source Files\\MachO" FILES ${LIEF_PYTHON_MACHO_SRC}) source_group("Header Files\\MachO" FILES ${LIEF_PYTHON_MACHO_HDR}) target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}") target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_MACHO_SRC}" "${LIEF_PYTHON_MACHO_HDR}") LIEF-0.13.1/api/python/src/MachO/objects/000077500000000000000000000000001443457337100176275ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/MachO/objects/pyBinary.cpp000066400000000000000000000654131443457337100221410ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "LIEF/Abstract/Binary.hpp" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/Symbol.hpp" #include "LIEF/MachO/Section.hpp" #include "LIEF/MachO/hash.hpp" #include "pyErr.hpp" #include "pyMachO.hpp" #include "pyIterators.hpp" namespace LIEF { namespace MachO { template using no_const_getter = T (Binary::*)(void); template using no_const_func = T (Binary::*)(P); template<> void create(py::module& m) { py::class_ bin(m, "Binary", R"delim( Class which represents a MachO binary )delim"); init_ref_iterator(bin, "it_commands"); init_ref_iterator(bin, "it_symbols"); init_ref_iterator(bin, "it_filter_symbols"); init_ref_iterator(bin, "it_sections"); init_ref_iterator(bin, "it_segments"); init_ref_iterator(bin, "it_libraries"); init_ref_iterator(bin, "it_relocations"); init_ref_iterator(bin, "it_rpaths"); py::class_(bin, "range_t") .def_readwrite("start", &Binary::range_t::start) .def_readwrite("end", &Binary::range_t::end); // --> Already registered with FatMachO (same container) //init_ref_iterator(bin, "it_fileset_binaries"); bin .def_property_readonly("header", static_cast>(&Binary::header), "Return binary's " RST_CLASS_REF(lief.MachO.Header) "", py::return_value_policy::reference_internal) .def_property_readonly("sections", static_cast>(&Binary::sections), "Return an iterator over the binary's " RST_CLASS_REF(lief.MachO.Section) "", py::return_value_policy::reference_internal) .def_property_readonly("relocations", static_cast>(&Binary::relocations), "Return an iterator over binary's " RST_CLASS_REF(lief.MachO.Relocation) "", py::return_value_policy::reference_internal) .def_property_readonly("segments", static_cast>(&Binary::segments), "Return an iterator over the binary's " RST_CLASS_REF(lief.MachO.SegmentCommand) "", py::return_value_policy::reference_internal) .def_property_readonly("libraries", static_cast>(&Binary::libraries), "Return an iterator over the binary's " RST_CLASS_REF(lief.MachO.DylibCommand) "", py::return_value_policy::reference_internal) .def_property_readonly("symbols", static_cast>(&Binary::symbols), "Return an iterator over the binary's " RST_CLASS_REF(lief.MachO.Symbol) "", py::return_value_policy::reference_internal) .def("has_symbol", &Binary::has_symbol, "Check if a " RST_CLASS_REF(lief.MachO.Symbol) " with the given name exists", "name"_a) .def("get_symbol", static_cast>(&Binary::get_symbol), "Return the " RST_CLASS_REF(lief.MachO.Symbol) " from the given name", "name"_a, py::return_value_policy::reference) .def_property_readonly("imported_symbols", static_cast>(&Binary::imported_symbols), "Return the binary's " RST_CLASS_REF(lief.MachO.Symbol) " which are imported", py::return_value_policy::reference_internal) .def_property_readonly("exported_symbols", static_cast>(&Binary::exported_symbols), "Return the binary's " RST_CLASS_REF(lief.MachO.Symbol) " which are exported", py::return_value_policy::reference_internal) .def_property_readonly("commands", static_cast>(&Binary::commands), "Return an iterator over the binary's " RST_CLASS_REF(lief.MachO.Command) "", py::return_value_policy::reference_internal) .def_property_readonly("filesets", static_cast>(&Binary::filesets), "Return binary's " RST_CLASS_REF(lief.MachO.Filesets) "", py::return_value_policy::reference_internal) .def_property_readonly("has_filesets", &Binary::has_filesets, "Return ``True`` if the binary has filesets") .def_property_readonly("imagebase", &Binary::imagebase, R"delim( Return the binary's ``imagebase`` which is the base address where segments are mapped (without the ASLR). ``0`` if not relevant. )delim") .def_property_readonly("virtual_size", &Binary::virtual_size, "Binary's memory size when mapped") .def_property_readonly("fat_offset", &Binary::fat_offset, "Return binary's *fat offset*. ``0`` if not relevant.", py::return_value_policy::copy) .def("section_from_offset", static_cast(&Binary::section_from_offset), "Return the " RST_CLASS_REF(lief.MachO.Section) " which encompasses the offset", py::return_value_policy::reference) .def("section_from_virtual_address", static_cast(&Binary::section_from_virtual_address), "Return the " RST_CLASS_REF(lief.MachO.Section) " which encompasses the virtual address", py::return_value_policy::reference) .def("segment_from_offset", static_cast(&Binary::segment_from_offset), "Return the " RST_CLASS_REF(lief.MachO.SegmentCommand) " which encompasses the offset", py::return_value_policy::reference) .def("segment_from_virtual_address", static_cast(&Binary::segment_from_virtual_address), "Return the " RST_CLASS_REF(lief.MachO.SegmentCommand) " which encompasses the virtual address", py::return_value_policy::reference) .def_property_readonly("has_entrypoint", &Binary::has_entrypoint, R"delim( ``True`` if the binary has an entrypoint. Basically for libraries it will return ``false`` )delim") .def_property_readonly("has_uuid", &Binary::has_uuid, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.UUIDCommand) " command.") .def_property_readonly("uuid", static_cast>(&Binary::uuid), "Return the binary's " RST_CLASS_REF(lief.MachO.UUIDCommand) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_main_command", &Binary::has_main_command, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.MainCommand) " command.") .def_property_readonly("main_command", static_cast>(&Binary::main_command), "Return the binary's " RST_CLASS_REF(lief.MachO.MainCommand) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_dylinker", &Binary::has_dylinker, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.DylinkerCommand) " command.") .def_property_readonly("dylinker", static_cast>(&Binary::dylinker), "Return the binary's " RST_CLASS_REF(lief.MachO.DylinkerCommand) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_dyld_info", &Binary::has_dyld_info, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.DyldInfo) " command.") .def_property_readonly("dyld_info", static_cast>(&Binary::dyld_info), "Return the binary's " RST_CLASS_REF(lief.MachO.DyldInfo) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_function_starts", &Binary::has_function_starts, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.FunctionStarts) " command.") .def_property_readonly("function_starts", static_cast>(&Binary::function_starts), "Return the binary's " RST_CLASS_REF(lief.MachO.FunctionStarts) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_source_version", &Binary::has_source_version, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.SourceVersion) " command.") .def_property_readonly("source_version", static_cast>(&Binary::source_version), "Return the binary's " RST_CLASS_REF(lief.MachO.SourceVersion) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_version_min", &Binary::has_version_min, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.VersionMin) " command.") .def_property_readonly("version_min", static_cast>(&Binary::version_min), "Return the binary's " RST_CLASS_REF(lief.MachO.VersionMin) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_thread_command", &Binary::has_thread_command, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.ThreadCommand) " command.") .def_property_readonly("thread_command", static_cast>(&Binary::thread_command), "Return the binary's " RST_CLASS_REF(lief.MachO.ThreadCommand) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_rpath", &Binary::has_rpath, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.RPathCommand) " command.") .def_property_readonly("rpath", static_cast>(&Binary::rpath), "Return the binary's " RST_CLASS_REF(lief.MachO.RPathCommand) " if any, or None", py::return_value_policy::reference) .def_property_readonly("rpaths", static_cast>(&Binary::rpaths), "Return an iterator over the binary's " RST_CLASS_REF(lief.MachO.RPathCommand) "", py::return_value_policy::reference_internal) .def_property_readonly("has_symbol_command", &Binary::has_symbol_command, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.SymbolCommand) " command.") .def_property_readonly("symbol_command", static_cast>(&Binary::symbol_command), "Return the binary's " RST_CLASS_REF(lief.MachO.SymbolCommand) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_dynamic_symbol_command", &Binary::has_dynamic_symbol_command, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.DynamicSymbolCommand) " command.") .def_property_readonly("dynamic_symbol_command", static_cast>(&Binary::dynamic_symbol_command), "Return the binary's " RST_CLASS_REF(lief.MachO.DynamicSymbolCommand) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_code_signature", &Binary::has_code_signature, "``True`` if the binary is signed (i.e. has a " RST_CLASS_REF(lief.MachO.CodeSignature) " command)") .def_property_readonly("code_signature", static_cast>(&Binary::code_signature), "Return the binary's " RST_CLASS_REF(lief.MachO.CodeSignature) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_code_signature_dir", &Binary::has_code_signature_dir, "``True`` if the binary is signed (i.e. has a " RST_CLASS_REF(lief.MachO.CodeSignatureDir) " command) " "with the command LC_DYLIB_CODE_SIGN_DRS") .def_property_readonly("code_signature_dir", static_cast>(&Binary::code_signature_dir), "Return the binary's " RST_CLASS_REF(lief.MachO.CodeSignatureDir) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_data_in_code", &Binary::has_data_in_code, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.DataInCode) " command") .def_property_readonly("data_in_code", static_cast>(&Binary::data_in_code), "Return the binary's " RST_CLASS_REF(lief.MachO.DataInCode) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_segment_split_info", &Binary::has_segment_split_info, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.SegmentSplitInfo) " command") .def_property_readonly("segment_split_info", static_cast>(&Binary::segment_split_info), "Return the binary's " RST_CLASS_REF(lief.MachO.SegmentSplitInfo) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_sub_framework", &Binary::has_sub_framework, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.SubFramework) " command") .def_property_readonly("sub_framework", static_cast>(&Binary::sub_framework), "Return the binary's " RST_CLASS_REF(lief.MachO.SubFramework) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_dyld_environment", &Binary::has_dyld_environment, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.DyldEnvironment) " command") .def_property_readonly("dyld_environment", static_cast>(&Binary::dyld_environment), "Return the binary's " RST_CLASS_REF(lief.MachO.DyldEnvironment) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_encryption_info", &Binary::has_encryption_info, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.EncryptionInfo) " command") .def_property_readonly("encryption_info", static_cast>(&Binary::encryption_info), "Return the binary's " RST_CLASS_REF(lief.MachO.EncryptionInfo) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_build_version", &Binary::has_build_version, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.BuildVersion) " command") .def_property_readonly("build_version", static_cast>(&Binary::build_version), "Return the binary's " RST_CLASS_REF(lief.MachO.BuildVersion) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_dyld_chained_fixups", &Binary::has_dyld_chained_fixups, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.DyldChainedFixups) " command") .def_property_readonly("dyld_chained_fixups", static_cast>(&Binary::dyld_chained_fixups), "Return the binary's " RST_CLASS_REF(lief.MachO.DyldChainedFixups) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_dyld_exports_trie", &Binary::has_dyld_exports_trie, "``True`` if the binary has a " RST_CLASS_REF(lief.MachO.DyldExportsTrie) " command") .def_property_readonly("dyld_exports_trie", static_cast>(&Binary::dyld_exports_trie), "Return the binary's " RST_CLASS_REF(lief.MachO.DyldExportsTrie) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_two_level_hints", &Binary::has_two_level_hints, "``True`` if the binary embeds the Two Level Hint command (" RST_CLASS_REF(lief.MachO.TwoLevelHints) ")") .def_property_readonly("two_level_hints", static_cast>(&Binary::two_level_hints), "Return the binary's " RST_CLASS_REF(lief.MachO.TwoLevelHints) " if any, or None", py::return_value_policy::reference) .def_property_readonly("has_linker_opt_hint", &Binary::has_linker_opt_hint, "``True`` if the binary embeds the Linker optimization hint command (" RST_CLASS_REF(lief.MachO.LinkerOptHint) ")") .def_property_readonly("linker_opt_hint", static_cast>(&Binary::linker_opt_hint), "Return the binary's " RST_CLASS_REF(lief.MachO.LinkerOptHint) " if any, or None", py::return_value_policy::reference) .def("virtual_address_to_offset", [] (const Binary& self, uint64_t va) { return error_or(&Binary::virtual_address_to_offset, self, va); }, "Convert the virtual address to an offset in the binary", "virtual_address"_a) .def("has_section", &Binary::has_section, "Check if a section with the given name exists", "name"_a) .def("get_section", static_cast(&Binary::get_section), "Return the section from the given name or None if the section does not exist", "name"_a, py::return_value_policy::reference) .def("has_segment", &Binary::has_segment, "Check if a " RST_CLASS_REF(lief.MachO.SegmentCommand) " with the given name exists", "name"_a) .def("get_segment", static_cast(&Binary::get_segment), "Return the " RST_CLASS_REF(lief.MachO.SegmentCommand) " from the given name", "name"_a, py::return_value_policy::reference) .def_property_readonly("va_ranges", &Binary::va_ranges, "Return the range of virtual addresses as a tuple ``(va_start, va_end)``") .def_property_readonly("off_ranges", &Binary::off_ranges, "Return the range of offsets as a tuple ``(off_start, off_end)``") .def("is_valid_addr", &Binary::is_valid_addr, R"delim( Check if the given address is encompassed between the range of virtual addresses. See: :attr:`~lief.MachO.Binary.va_ranges` )delim", "address"_a) .def("write", static_cast(&Binary::write), "Rebuild the binary and write and write its content if the file given in parameter", "output"_a, py::return_value_policy::reference_internal) .def("add", static_cast(&Binary::add), "Add a new " RST_CLASS_REF(lief.MachO.DylibCommand) "", "dylib_command"_a, py::return_value_policy::reference) .def("add", static_cast(&Binary::add), "Add a new " RST_CLASS_REF(lief.MachO.SegmentCommand) "", "segment"_a, py::return_value_policy::reference) .def("add", static_cast(&Binary::add), "Add a new " RST_CLASS_REF(lief.MachO.LoadCommand) "", "load_command"_a, py::return_value_policy::reference) .def("add", static_cast(&Binary::add), "Add a new " RST_CLASS_REF(lief.MachO.LoadCommand) " at ``index``", "load_command"_a, "index"_a, py::return_value_policy::reference) .def("remove", static_cast(&Binary::remove), "Remove a " RST_CLASS_REF(lief.MachO.LoadCommand) "", "load_command"_a) .def("remove", static_cast(&Binary::remove), "Remove **all** the " RST_CLASS_REF(lief.MachO.LoadCommand) " having the given " "" RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES) "", "type"_a) .def("remove", static_cast(&Binary::remove), "Remove the given " RST_CLASS_REF(lief.MachO.Symbol)"", "symbol"_a) .def("remove_command", static_cast(&Binary::remove_command), "Remove the " RST_CLASS_REF(lief.MachO.LoadCommand) " at the given ``index``", "index"_a) .def("remove_section", static_cast(&Binary::remove_section), "Remove the section with the given name", "name"_a, "clear"_a = false) .def("remove_section", py::overload_cast(&Binary::remove_section), R"delim( Remove the section from the segment with the name given in the first parameter and with the section's name provided in the second parameter.)delim", "segname"_a, "secname"_a, "clear"_a = false) .def("remove_signature", static_cast(&Binary::remove_signature), "Remove the " RST_CLASS_REF(lief.MachO.CodeSignature) " (if any)") .def("remove_symbol", static_cast(&Binary::remove_symbol), "Remove all symbol(s) with the given name", "name"_a) .def("can_remove", static_cast(&Binary::can_remove), "Check if the given symbol can be safely removed.", "symbol"_a) .def("can_remove_symbol", static_cast(&Binary::can_remove_symbol), "Check if the given symbol name can be safely removed.", "symbol_name"_a) .def("unexport", static_cast(&Binary::unexport), "Remove the symbol from the export table", "name"_a) .def("unexport", static_cast(&Binary::unexport), "Remove the symbol from the export table", "symbol"_a) .def("extend", static_cast(&Binary::extend), "Extend a " RST_CLASS_REF(lief.MachO.LoadCommand) " by ``size``", "load_command"_a, "size"_a) .def("extend_segment", static_cast(&Binary::extend_segment), "Extend the **content** of the given " RST_CLASS_REF(lief.MachO.SegmentCommand) " by ``size``", "segment_command"_a, "size"_a) .def("add_section", static_cast(&Binary::add_section), "Add a new " RST_CLASS_REF(lief.MachO.Section) " in the given " RST_CLASS_REF(lief.MachO.SegmentCommand) "", "segment"_a, "section"_a, py::return_value_policy::reference) .def("add_section", static_cast(&Binary::add_section), "Add a new " RST_CLASS_REF(lief.MachO.Section) " within the ``__TEXT`` segment", "section"_a, py::return_value_policy::reference) .def("add_section", static_cast(&Binary::add_section), "Add a new " RST_CLASS_REF(lief.MachO.Section) " in the given " RST_CLASS_REF(lief.MachO.SegmentCommand) "", "section"_a, "section"_a, py::return_value_policy::reference) .def("add_library", static_cast(&Binary::add_library), "Add a new library dependency", "library_name"_a, py::return_value_policy::reference) .def("get", static_cast(&Binary::get), "Return the **first** " RST_CLASS_REF(lief.MachO.LoadCommand) " having the given " "" RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES) " or None if it is not present.", "type"_a, py::return_value_policy::reference) .def("has", static_cast(&Binary::has), "Check if the current binary has a " RST_CLASS_REF(lief.MachO.LoadCommand) " with the given " "" RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES) "", "type"_a) .def_property_readonly("unwind_functions", &Binary::unwind_functions, "Return list of " RST_CLASS_REF(lief.Function) " found in the ``__unwind_info`` section") .def_property_readonly("functions", &Binary::functions, "Return list of **all** " RST_CLASS_REF(lief.Function) " found") .def("get_section", py::overload_cast(&Binary::get_section), R"delim( Return the section from the segment with the name given in the first parameter and with the section's name provided in the second parameter. If the section cannot be found, it returns a nullptr )delim", "segname"_a, "secname"_a, py::return_value_policy::reference_internal) .def("shift", [] (Binary& self, size_t width) { return error_or(&Binary::shift, self, width); }, R"delim( Shift the content located right after the Load commands table. This operation can be used to add a new command )delim", "value"_a) .def("shift_linkedit", [] (Binary& self, size_t width) { return error_or(&Binary::shift_linkedit, self, width); }, "Shift the position on the __LINKEDIT data by `width`", "value"_a) .def("add_exported_function", &Binary::add_exported_function, "Add a new export in the binary", "address"_a, "name"_a, py::return_value_policy::reference) .def("add_local_symbol", &Binary::add_local_symbol, "Add a new a new symbol in the LC_SYMTAB", "address"_a, "name"_a, py::return_value_policy::reference) .def_property_readonly("page_size", &Binary::page_size, "Return the binary's page size") .def("__getitem__", static_cast(&Binary::operator[]), "", py::return_value_policy::reference) .def("__contains__", static_cast(&Binary::has)) .def("__str__", [] (const Binary& binary) { std::ostringstream stream; stream << binary; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyBindingInfo.cpp000066400000000000000000000101201443457337100230640ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/BindingInfo.hpp" #include "LIEF/MachO/SegmentCommand.hpp" #include "LIEF/MachO/Symbol.hpp" #include "LIEF/MachO/DylibCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (BindingInfo::*)(void) const; template using setter_t = void (BindingInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "BindingInfo", R"delim( Class that provides an interface over an entry in DyldInfo structure This class does not represent a structure that exists in the Mach-O format specifications but it provides a *view* of a binding operation that is performed by the Dyld binding bytecode (`LC_DYLD_INFO`) or the Dyld chained fixups (`DYLD_CHAINED_FIXUPS`) See: :class:`~lief.MachO.ChainedBindingInfo`, :class:`~lief.MachO.DyldBindingInfo` )delim") .def_property("address", static_cast>(&BindingInfo::address), static_cast>(&BindingInfo::address), "Binding's address") .def_property("library_ordinal", static_cast>(&BindingInfo::library_ordinal), static_cast>(&BindingInfo::library_ordinal)) .def_property("addend", static_cast>(&BindingInfo::addend), static_cast>(&BindingInfo::addend), "Value added to the segment's virtual address when binding") .def_property("weak_import", static_cast>(&BindingInfo::is_weak_import), static_cast>(&BindingInfo::set_weak_import)) .def_property_readonly("has_library", &BindingInfo::has_library, "``True`` if the binding info has a " RST_CLASS_REF(lief.MachO.DylibCommand) " associated with") .def_property_readonly("library", static_cast(&BindingInfo::library), "" RST_CLASS_REF(lief.MachO.DylibCommand) " associated with the binding if any, or None", py::return_value_policy::reference) .def_property_readonly("has_segment", &BindingInfo::has_segment, "``True`` if the binding info has a " RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with") .def_property_readonly("segment", static_cast(&BindingInfo::segment), "" RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with the binding if any, or None", py::return_value_policy::reference) .def_property_readonly("has_symbol", &BindingInfo::has_symbol, "``True`` if the binding info has a " RST_CLASS_REF(lief.MachO.Symbol) " associated with") .def_property_readonly("symbol", static_cast(&BindingInfo::symbol), "" RST_CLASS_REF(lief.MachO.Symbol) " associated with the binding if any, or None", py::return_value_policy::reference) .def("__eq__", &BindingInfo::operator==) .def("__ne__", &BindingInfo::operator!=) .def("__hash__", [] (const BindingInfo& binding_info) { return Hash::hash(binding_info); }) .def("__str__", [] (const BindingInfo& binding_info) { std::ostringstream stream; stream << binding_info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyBuildVersion.cpp000066400000000000000000000076471443457337100233270ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/BuildVersion.hpp" #include "LIEF/MachO/EnumToString.hpp" #include "enums_wrapper.hpp" #include "pyMachO.hpp" #define PY_ENUM(x) LIEF::MachO::to_string(x), x namespace LIEF { namespace MachO { template using getter_t = T (BuildVersion::*)(void) const; template using setter_t = void (BuildVersion::*)(T); template<> void create(py::module& m) { py::class_ cls(m, "BuildVersion"); py::class_ tool_version_cls(m, "BuildToolVersion", R"delim( Class that represents a tool's version that was involved in the build of the binary )delim"); // Build Tool Version // ================== tool_version_cls .def_property_readonly("tool", &BuildToolVersion::tool, "" RST_CLASS_REF(.BuildVersion.TOOLS) " type") .def_property_readonly("version", &BuildToolVersion::version, "Version of the tool") .def("__eq__", &BuildToolVersion::operator==) .def("__ne__", &BuildToolVersion::operator!=) .def("__hash__", [] (const BuildToolVersion& version) { return Hash::hash(version); }) .def("__str__", [] (const BuildToolVersion& version) { std::ostringstream stream; stream << version; return stream.str(); }); LIEF::enum_(tool_version_cls, "TOOLS") .value(PY_ENUM(BuildToolVersion::TOOLS::UNKNOWN)) .value(PY_ENUM(BuildToolVersion::TOOLS::CLANG)) .value(PY_ENUM(BuildToolVersion::TOOLS::SWIFT)) .value(PY_ENUM(BuildToolVersion::TOOLS::LD)); cls .def_property("platform", static_cast>(&BuildVersion::platform), static_cast>(&BuildVersion::platform), "Target " RST_CLASS_REF(.BuildVersion.PLATFORMS) "") .def_property("minos", static_cast>(&BuildVersion::minos), static_cast>(&BuildVersion::minos), "Minimal OS version on which this binary was built to run") .def_property("sdk", static_cast>(&BuildVersion::sdk), static_cast>(&BuildVersion::sdk), "SDK Version") .def_property_readonly("tools", static_cast>(&BuildVersion::tools), "List of " RST_CLASS_REF(BuildToolVersion) " used when while this binary") .def("__eq__", &BuildVersion::operator==) .def("__ne__", &BuildVersion::operator!=) .def("__hash__", [] (const BuildVersion& version) { return Hash::hash(version); }) .def("__str__", [] (const BuildVersion& version) { std::ostringstream stream; stream << version; return stream.str(); }); LIEF::enum_(cls, "PLATFORMS") .value(PY_ENUM(BuildVersion::PLATFORMS::UNKNOWN)) .value(PY_ENUM(BuildVersion::PLATFORMS::MACOS)) .value(PY_ENUM(BuildVersion::PLATFORMS::IOS)) .value(PY_ENUM(BuildVersion::PLATFORMS::TVOS)) .value(PY_ENUM(BuildVersion::PLATFORMS::WATCHOS)); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyBuilder.cpp000066400000000000000000000053551443457337100223020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyMachO.hpp" #include "pyErr.hpp" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/FatBinary.hpp" #include "LIEF/MachO/Builder.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_ builder(m, "Builder", R"delim( Class used to reconstruct a Mach-O binary from its object representation )delim"); py::class_(builder, "config_t", "Interface to tweak the " RST_CLASS_REF(lief.MachO.Builder) "") .def(py::init<>()) .def_readwrite("linkedit", &Builder::config_t::linkedit); builder .def_static("write", [] (Binary& bin, const std::string& out) { auto target = py::overload_cast(&Builder::write); return error_or(target, bin, out); }, R"delim( )delim", "binary"_a, "output"_a) .def_static("write", [] (Binary& bin, const std::string& out, Builder::config_t config) { auto target = py::overload_cast(&Builder::write); return error_or(target, bin, out, config); }, R"delim( )delim", "binary"_a, "output"_a, "config"_a) .def_static("write", [] (FatBinary& fat, const std::string& out) { auto target = py::overload_cast(&Builder::write); return error_or(target, fat, out); }, R"delim( )delim", "fat_binary"_a, "output"_a) .def_static("write", [] (FatBinary& fat, const std::string& out, Builder::config_t config) { auto target = py::overload_cast(&Builder::write); return error_or(target, fat, out, config); }, R"delim( )delim", "fat_binary"_a, "output"_a, "config"_a); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyChainedBindingInfo.cpp000066400000000000000000000050641443457337100243530ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/ChainedBindingInfo.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_(m, "ChainedBindingInfo", R"delim( This class represents a symbol binding operation associated with the LC_DYLD_CHAINED_FIXUPS command. This class does not represent a structure that exists in the Mach-O format specifications but it provides a *view* on an entry. See also: :class:`~lief.MachO.BindingInfo` )delim") .def_property_readonly("format", &ChainedBindingInfo::format, R"delim( :class:`~lief.MachO.DYLD_CHAINED_FORMAT` of the import )delim") .def_property_readonly("ptr_format", &ChainedBindingInfo::ptr_format, R"delim( :class:`~lief.MachO.DYLD_CHAINED_PTR_FORMAT` of the import )delim") .def_property("offset", py::overload_cast<>(&ChainedBindingInfo::offset, py::const_), py::overload_cast(&ChainedBindingInfo::offset), R"delim( Offset of the entry in the chained fixups )delim") .def_property_readonly("sign_extended_addend", &ChainedBindingInfo::sign_extended_addend) .def("__eq__", &ChainedBindingInfo::operator==) .def("__ne__", &ChainedBindingInfo::operator!=) .def("__hash__", [] (const ChainedBindingInfo& info) { return Hash::hash(info); }) .def("__str__", [] (const ChainedBindingInfo& info) { std::ostringstream stream; std::string str = stream.str(); return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyCodeSignature.cpp000066400000000000000000000042261443457337100234440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/CodeSignature.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (CodeSignature::*)(void) const; template using setter_t = void (CodeSignature::*)(T); template<> void create(py::module& m) { py::class_(m, "CodeSignature") .def_property("data_offset", static_cast>(&CodeSignature::data_offset), static_cast>(&CodeSignature::data_offset), "Offset in the binary where the signature starts") .def_property("data_size", static_cast>(&CodeSignature::data_size), static_cast>(&CodeSignature::data_size), "Size of the raw signature") .def_property_readonly("content", [] (const CodeSignature& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The raw signature as a bytes stream") .def("__eq__", &CodeSignature::operator==) .def("__ne__", &CodeSignature::operator!=) .def("__hash__", [] (const CodeSignature& func) { return Hash::hash(func); }) .def("__str__", [] (const CodeSignature& func) { std::ostringstream stream; stream << func; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyCodeSignatureDir.cpp000066400000000000000000000040151443457337100240770ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/CodeSignatureDir.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_(m, "CodeSignatureDir") .def_property("data_offset", py::overload_cast<>(&CodeSignatureDir::data_offset, py::const_), py::overload_cast(&CodeSignatureDir::data_offset), "Offset in the binary where the signature starts") .def_property("data_size", py::overload_cast<>(&CodeSignatureDir::data_offset, py::const_), py::overload_cast(&CodeSignatureDir::data_offset), "Size of the raw signature") .def_property_readonly("content", [] (const CodeSignatureDir& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The raw signature as a bytes stream") .def("__eq__", &CodeSignatureDir::operator==) .def("__ne__", &CodeSignatureDir::operator!=) .def("__hash__", [] (const CodeSignatureDir& sig) { return Hash::hash(sig); }) .def("__str__", [] (const CodeSignatureDir& dir) { std::ostringstream stream; stream << dir; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDataCodeEntry.cpp000066400000000000000000000054001443457337100233710ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DataCodeEntry.hpp" #include "LIEF/MachO/EnumToString.hpp" #include "enums_wrapper.hpp" #include "pyMachO.hpp" #define PY_ENUM(x) LIEF::MachO::to_string(x), x namespace LIEF { namespace MachO { template using getter_t = T (DataCodeEntry::*)(void) const; template using setter_t = void (DataCodeEntry::*)(T); template<> void create(py::module& m) { py::class_ cls(m, "DataCodeEntry", R"delim( Interface over an entry in the :class:`~lief.MachO.DataInCode` command )delim"); cls .def(py::init()) .def_property("offset", static_cast>(&DataCodeEntry::offset), static_cast>(&DataCodeEntry::offset), "Offset of the data") .def_property("length", static_cast>(&DataCodeEntry::length), static_cast>(&DataCodeEntry::length), "Length of the data") .def_property("type", static_cast>(&DataCodeEntry::type), static_cast>(&DataCodeEntry::type), "Type of the data (" RST_CLASS_REF(lief.MachO.DataCodeEntry.TYPES) "") .def("__eq__", &DataCodeEntry::operator==) .def("__ne__", &DataCodeEntry::operator!=) .def("__hash__", [] (const DataCodeEntry& func) { return Hash::hash(func); }) .def("__str__", [] (const DataCodeEntry& func) { std::ostringstream stream; stream << func; std::string str = stream.str(); return str; }); LIEF::enum_(cls, "TYPES") .value(PY_ENUM(DataCodeEntry::TYPES::UNKNOWN)) .value(PY_ENUM(DataCodeEntry::TYPES::DATA)) .value(PY_ENUM(DataCodeEntry::TYPES::JUMP_TABLE_8)) .value(PY_ENUM(DataCodeEntry::TYPES::JUMP_TABLE_16)) .value(PY_ENUM(DataCodeEntry::TYPES::JUMP_TABLE_32)) .value(PY_ENUM(DataCodeEntry::TYPES::ABS_JUMP_TABLE_32)); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDataInCode.cpp000066400000000000000000000056101443457337100226410ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DataInCode.hpp" #include "pyIterators.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (DataInCode::*)(void) const; template using setter_t = void (DataInCode::*)(T); template<> void create(py::module& m) { // Init Iterator init_ref_iterator(m, "it_data_in_code_entries"); py::class_(m, "DataInCode", R"delim( Interface of the LC_DATA_IN_CODE command This command is used to list slices of code sections that contain data. The *slices* information are stored as an array of :class:`~lief.MachO.DataCodeEntry` )delim") .def_property("data_offset", static_cast>(&DataInCode::data_offset), static_cast>(&DataInCode::data_offset), "Start of the array of the DataCodeEntry entries") .def_property("data_size", static_cast>(&DataInCode::data_size), static_cast>(&DataInCode::data_size), "Whole size of the array (``size = sizeof(DataCodeEntry) * nb_elements``)") .def_property_readonly("entries", static_cast(&DataInCode::entries), "Iterator over " RST_CLASS_REF(lief.MachO.DataCodeEntry) "", py::return_value_policy::reference_internal) .def("add", &DataInCode::add, "Add an new " RST_CLASS_REF(lief.MachO.DataCodeEntry) "", "entry"_a) .def_property_readonly("content", [] (const DataInCode& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The original content as a bytes stream") .def("__eq__", &DataInCode::operator==) .def("__ne__", &DataInCode::operator!=) .def("__hash__", [] (const DataInCode& func) { return Hash::hash(func); }) .def("__str__", [] (const DataInCode& func) { std::ostringstream stream; stream << func; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDyldBindingInfo.cpp000066400000000000000000000050411443457337100237070ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DyldBindingInfo.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (DyldBindingInfo::*)() const; template using setter_t = void (DyldBindingInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "DyldBindingInfo", R"delim( This class represents a symbol binding operation associated with the LC_DYLD_INFO bytecode. This class does not represent a structure that exists in the Mach-O format specifications but it provides a *view* on an entry of the Dyld binding opcodes. See also: :class:`~lief.MachO.BindingInfo` )delim") .def_property("binding_class", static_cast>(&DyldBindingInfo::binding_class), static_cast>(&DyldBindingInfo::binding_class), "" RST_CLASS_REF(lief.MachO.BINDING_CLASS) " of the binding") .def_property("binding_type", static_cast>(&DyldBindingInfo::binding_type), static_cast>(&DyldBindingInfo::binding_type), R"delim( :class:`~lief.MachO.BIND_TYPES` of the binding. Usually, it is :attr:`~lief.MachO.BIND_TYPES.POINTER`. )delim") .def_property_readonly("original_offset", &DyldBindingInfo::original_offset, "Original relative offset of the binding opcodes") .def("__eq__", &DyldBindingInfo::operator==) .def("__ne__", &DyldBindingInfo::operator!=) .def("__hash__", [] (const DyldBindingInfo& info) { return Hash::hash(info); }) .def("__str__", [] (const DyldBindingInfo& info) { std::ostringstream stream; std::string str = stream.str(); return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDyldChainedFixups.cpp000066400000000000000000000171651443457337100242650ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "pyIterators.hpp" #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DyldChainedFixups.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_ chained(m, "DyldChainedFixups", R"delim( Class that represents the LC_DYLD_CHAINED_FIXUPS command This command aims at providing rebase and binding information like the :class:`~lief.MachO.DyldInfo` 's bytecode. Compared to the :class:`~lief.MachO.DyldInfo` bytecode, these chained fixups are taking less space. )delim"); init_ref_iterator(chained, "it_binding_info"); init_ref_iterator(chained, "it_chained_starts_in_segments_t"); py::class_(chained, "chained_starts_in_segment", R"delim( Structure that mirrors the raw dyld_chained_starts_in_segment which aims at providing information about the chained rebase/bind fixups The relocations provided by this structure can be accessed through :attr:`~lief.MachO.SegmentCommand.relocations` )delim") .def_readonly("offset", &DyldChainedFixups::chained_starts_in_segment::offset, "Original offset of the structure, relative to :attr:`~lief.MachO.DyldChainedFixups.starts_offset`") .def_readonly("size", &DyldChainedFixups::chained_starts_in_segment::size, "``sizeof(size) + sizeof(page_size) + ... + sizeof(pointer_format)``") .def_readonly("page_size", &DyldChainedFixups::chained_starts_in_segment::page_size, "Likely 0x1000 for x86/x86_64 architectures and 0x4000 for ARM64 architecture") .def_readonly("segment_offset", &DyldChainedFixups::chained_starts_in_segment::segment_offset, R"delim( Offset of the segment's data from the beginning of the file. (it should match :attr:`~lief.MachO.SegmentCommand.file_offset`) )delim") .def_readonly("page_start", &DyldChainedFixups::chained_starts_in_segment::page_start, R"delim( Offset in the :class:`~lief.MachO.SegmentCommand` of the first element of the chain. )delim") .def_readonly("pointer_format", &DyldChainedFixups::chained_starts_in_segment::pointer_format, R"delim( How pointers are encoded )delim") .def_readonly("max_valid_pointer", &DyldChainedFixups::chained_starts_in_segment::max_valid_pointer, R"delim( for 32-bit OS, any value beyond this is not a pointer )delim") .def_property_readonly("page_count", &DyldChainedFixups::chained_starts_in_segment::page_count, "How many pages are in the :attr:`~lief.MachO.DyldChainedFixups.page_start` array") .def_property_readonly("segment", [] (DyldChainedFixups::chained_starts_in_segment& self) -> SegmentCommand* { return &self.segment; }, ":class:`~lief.MachO.SegmentCommand` in which the rebase/bind fixups take place", py::return_value_policy::reference) .def("__str__", [] (const DyldChainedFixups::chained_starts_in_segment& self) { std::ostringstream stream; stream << self; return stream.str(); }); chained .def_property("data_offset", py::overload_cast<>(&DyldChainedFixups::data_offset, py::const_), py::overload_cast(&DyldChainedFixups::data_offset), R"delim( Offset of the LC_DYLD_CHAINED_FIXUPS chained payload. This offset should point in the ``__LINKEDIT`` segment )delim") .def_property("data_size", py::overload_cast<>(&DyldChainedFixups::data_size, py::const_), py::overload_cast(&DyldChainedFixups::data_size), "Size of the LC_DYLD_CHAINED_FIXUPS payload") .def_property_readonly("bindings", py::overload_cast<>(&DyldChainedFixups::bindings), "Iterator over the bindings " RST_CLASS_REF(lief.MachO.ChainedBindingInfo) " associated with this command") .def_property_readonly("chained_starts_in_segments", py::overload_cast<>(&DyldChainedFixups::chained_starts_in_segments), "Iterator over the chained fixup metadata, " RST_CLASS_REF(lief.MachO.DyldChainedFixups.chained_starts_in_segment) "") .def_property("fixups_version", py::overload_cast<>(&DyldChainedFixups::fixups_version, py::const_), py::overload_cast(&DyldChainedFixups::fixups_version), R"delim( Chained fixups version. The loader (as far of dyld v852.2) checks that this value is set to 0. )delim") .def_property("starts_offset", py::overload_cast<>(&DyldChainedFixups::starts_offset, py::const_), py::overload_cast(&DyldChainedFixups::starts_offset), R"delim( offset of dyld_chained_starts_in_image in chain_data )delim") .def_property("imports_offset", py::overload_cast<>(&DyldChainedFixups::imports_offset, py::const_), py::overload_cast(&DyldChainedFixups::imports_offset), R"delim( Offset of imports table in chain data )delim") .def_property("symbols_offset", py::overload_cast<>(&DyldChainedFixups::symbols_offset, py::const_), py::overload_cast(&DyldChainedFixups::symbols_offset), R"delim( Offset of symbol strings in chain data )delim") .def_property("imports_count", py::overload_cast<>(&DyldChainedFixups::imports_count, py::const_), py::overload_cast(&DyldChainedFixups::imports_count), R"delim( Number of imported symbol names )delim") .def_property("symbols_format", py::overload_cast<>(&DyldChainedFixups::symbols_format, py::const_), py::overload_cast(&DyldChainedFixups::symbols_format), R"delim( The compression algorithm (if any) used to store the symbols 0 means uncompressed while 1 means zlib compressed. As far of the version v852.2 of dyld loader, it only supports **uncompressed** format )delim") .def_property("imports_format", py::overload_cast<>(&DyldChainedFixups::imports_format, py::const_), py::overload_cast(&DyldChainedFixups::imports_format), R"delim( The format of the imports (:class:`~lief.MachO.ChainedBindingInfo`) )delim") .def("__eq__", &DyldChainedFixups::operator==) .def("__ne__", &DyldChainedFixups::operator!=) .def("__hash__", [] (const DyldChainedFixups& func) { return Hash::hash(func); }) .def("__str__", [] (const DyldChainedFixups& fixups) { std::ostringstream stream; stream << fixups; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDyldEnvironment.cpp000066400000000000000000000036031443457337100240270ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DyldEnvironment.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (DyldEnvironment::*)(void) const; template using setter_t = void (DyldEnvironment::*)(T); template<> void create(py::module& m) { py::class_(m, "DyldEnvironment", R"delim( Class that represents a LC_DYLD_ENVIRONMENT which is used by the Mach-O linker/loader to initialize an environment variable )delim") .def_property("value", static_cast>(&DyldEnvironment::value), static_cast>(&DyldEnvironment::value), "Environment variable as a string", py::return_value_policy::reference_internal) .def("__eq__", &DyldEnvironment::operator==) .def("__ne__", &DyldEnvironment::operator!=) .def("__hash__", [] (const DyldEnvironment& env) { return Hash::hash(env); }) .def("__str__", [] (const DyldEnvironment& env) { std::ostringstream stream; stream << env; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDyldExportsTrie.cpp000066400000000000000000000055751443457337100240250ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "pyIterators.hpp" #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DyldExportsTrie.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_ exports_trie(m, "DyldExportsTrie", R"delim( Class that represents the LC_DYLD_EXPORTS_TRIE command In recent Mach-O binaries, this command replace the DyldInfo export trie buffer )delim"); try { init_ref_iterator(exports_trie, "it_export_info"); } catch (const std::runtime_error&) { } exports_trie .def_property("data_offset", py::overload_cast<>(&DyldExportsTrie::data_offset, py::const_), py::overload_cast(&DyldExportsTrie::data_offset), "Offset of the trie in the binary. This offset should point in the __LINKEDIT") .def_property("data_size", py::overload_cast<>(&DyldExportsTrie::data_size, py::const_), py::overload_cast(&DyldExportsTrie::data_size), "Raw size of the trie") .def_property_readonly("content", [] (const DyldExportsTrie& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The raw export trie") .def_property_readonly("exports", py::overload_cast<>(&DyldExportsTrie::exports), R"delim( Iterator over the :class:`~lief.MachO.ExportInfo` associated with this trie. )delim") .def("show_export_trie", &DyldExportsTrie::show_export_trie, "Show the trie in a humman-readable way") .def("__eq__", &DyldExportsTrie::operator==) .def("__ne__", &DyldExportsTrie::operator!=) .def("__hash__", [] (const DyldExportsTrie& info) { return Hash::hash(info); }) .def("__str__", [] (const DyldExportsTrie& info) { std::ostringstream stream; std::string str = stream.str(); return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDyldInfo.cpp000066400000000000000000000266621443457337100224300ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DyldInfo.hpp" #include "pyIterators.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (DyldInfo::*)(void) const; template using setter_t = void (DyldInfo::*)(T); template using no_const_getter = T (DyldInfo::*)(void); template<> void create(py::module& m) { py::class_ dyld(m, "DyldInfo", R"delim( Class that represents the LC_DYLD_INFO and LC_DYLD_INFO_ONLY commands )delim"); init_ref_iterator(dyld, "it_binding_info"); try { init_ref_iterator(dyld, "it_export_info"); } catch (const std::runtime_error&) { } dyld .def_property("rebase", static_cast>(&DyldInfo::rebase), static_cast>(&DyldInfo::rebase), R"delim( *Rebase* information as a tuple ``(offset, size)`` Dyld rebases an image whenever dyld loads it at an address different from its preferred address. The rebase information is a stream of byte sized opcodes for which symbolic names start with ``REBASE_OPCODE_``. Conceptually the rebase information is a table of tuples: ``(seg-index, seg-offset, type)`` The opcodes are a compressed way to encode the table by only encoding when a column changes. In addition simple patterns like "every n'th offset for m times" can be encoded in a few bytes .. seealso:: ``/usr/include/mach-o/loader.h`` )delim") .def_property("rebase_opcodes", [] (const DyldInfo& self) { span content = self.rebase_opcodes(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast>(&DyldInfo::rebase_opcodes), "Return the rebase's opcodes as ``list`` of bytes") .def_property_readonly("show_rebases_opcodes", &DyldInfo::show_rebases_opcodes, "Return the rebase opcodes in a humman-readable way") .def_property("bind", static_cast>(&DyldInfo::bind), static_cast>(&DyldInfo::bind), R"delim( *Bind* information as a tuple ``(offset, size)`` Dyld binds an image during the loading process, if the image requires any pointers to be initialized to symbols in other images. The rebase information is a stream of byte sized opcodes for which symbolic names start with ``BIND_OPCODE_``. Conceptually the bind information is a table of tuples: ``(seg-index, seg-offset, type, symbol-library-ordinal, symbol-name, addend)`` The opcodes are a compressed way to encode the table by only encoding when a column changes. In addition simple patterns like for runs of pointers initialzed to the same value can be encoded in a few bytes. .. seealso:: ``/usr/include/mach-o/loader.h`` )delim") .def_property("bind_opcodes", [] (const DyldInfo& self) { span content = self.bind_opcodes(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast>(&DyldInfo::bind_opcodes), "Return the binding's opcodes as ``list`` of bytes") .def_property_readonly("show_bind_opcodes", &DyldInfo::show_bind_opcodes, "Return the bind opcodes in a humman-readable way") .def_property("weak_bind", static_cast>(&DyldInfo::weak_bind), static_cast>(&DyldInfo::weak_bind), R"delim( *Weak Bind* information as a tuple ``(offset, size)`` Some C++ programs require dyld to unique symbols so that all images in the process use the same copy of some code/data. This step is done after binding. The content of the weak_bind info is an opcode stream like the bind_info. But it is sorted alphabetically by symbol name. This enables dyld to walk all images with weak binding information in order and look for collisions. If there are no collisions, dyld does no updating. That means that some fixups are also encoded in the bind_info. For instance, all calls to ``operator new`` are first bound to ``libstdc++.dylib`` using the information in bind_info. Then if some image overrides operator new that is detected when the weak_bind information is processed and the call to operator new is then rebound. .. seealso:: ``/usr/include/mach-o/loader.h`` )delim") .def_property("weak_bind_opcodes", [] (const DyldInfo& self) { span content = self.weak_bind_opcodes(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast>(&DyldInfo::weak_bind_opcodes), "Return **Weak** binding's opcodes as ``list`` of bytes") .def_property_readonly("show_weak_bind_opcodes", &DyldInfo::show_weak_bind_opcodes, "Return the weak bind opcodes in a humman-readable way") .def_property("lazy_bind", static_cast>(&DyldInfo::lazy_bind), static_cast>(&DyldInfo::lazy_bind), R"delim( *Lazy Bind* information as a tuple ``(offset, size)`` Some uses of external symbols do not need to be bound immediately. Instead they can be lazily bound on first use. The lazy_bind are contains a stream of BIND opcodes to bind all lazy symbols. Normal use is that dyld ignores the lazy_bind section when loading an image. Instead the static linker arranged for the lazy pointer to initially point to a helper function which pushes the offset into the lazy_bind area for the symbol needing to be bound, then jumps to dyld which simply adds the offset to lazy_bind_off to get the information on what to bind. .. seealso:: ``/usr/include/mach-o/loader.h`` )delim") .def_property("lazy_bind_opcodes", [] (const DyldInfo& self) { span content = self.lazy_bind_opcodes(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast>(&DyldInfo::lazy_bind_opcodes), "Return **lazy** binding's opcodes as ``list`` of bytes") .def_property_readonly("show_lazy_bind_opcodes", &DyldInfo::show_lazy_bind_opcodes, "Return the weak bind opcodes in a humman-readable way", py::return_value_policy::reference_internal) .def_property_readonly("bindings", static_cast>(&DyldInfo::bindings), "Return an iterator over Dyld's " RST_CLASS_REF(lief.MachO.BindingInfo) "", py::return_value_policy::reference_internal) .def_property("export_info", static_cast>(&DyldInfo::export_info), static_cast>(&DyldInfo::export_info), R"delim( *Export* information as a tuple ``(offset, size)`` The symbols exported by a dylib are encoded in a trie. This is a compact representation that factors out common prefixes. It also reduces ``LINKEDIT`` pages in RAM because it encodes all information (name, address, flags) in one small, contiguous range. The export area is a stream of nodes. The first node sequentially is the start node for the trie. Nodes for a symbol start with a byte that is the length of the exported symbol information for the string so far. If there is no exported symbol, the byte is zero. If there is exported info, it follows the length byte. The exported info normally consists of a flags and offset both encoded in `uleb128 `_. The offset is location of the content named by the symbol. It is the offset from the mach_header for the image. After the initial byte and optional exported symbol information is a byte of how many edges (0-255) that this node has leaving it, followed by each edge. Each edge is a zero terminated cstring of the addition chars in the symbol, followed by a uleb128 offset for the node that edge points to. .. seealso:: ``/usr/include/mach-o/loader.h`` )delim") .def_property("export_trie", [] (const DyldInfo& self) { span content = self.export_trie(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast>(&DyldInfo::export_trie), "Return Export's trie as ``list`` of bytes") .def_property_readonly("exports", static_cast>(&DyldInfo::exports), "Return an iterator over Dyld's " RST_CLASS_REF(lief.MachO.ExportInfo) "", py::return_value_policy::reference_internal) .def_property_readonly("show_export_trie", &DyldInfo::show_export_trie, "Return the export trie in a humman-readable way", py::return_value_policy::reference_internal) .def("set_rebase_offset", &DyldInfo::set_rebase_offset, "offset"_a) .def("set_rebase_size", &DyldInfo::set_rebase_size, "size"_a) .def("set_bind_offset", &DyldInfo::set_bind_offset, "offset"_a) .def("set_bind_size", &DyldInfo::set_bind_size, "size"_a) .def("set_weak_bind_offset", &DyldInfo::set_weak_bind_offset, "offset"_a) .def("set_weak_bind_size", &DyldInfo::set_weak_bind_size, "size"_a) .def("set_lazy_bind_offset", &DyldInfo::set_lazy_bind_offset, "offset"_a) .def("set_lazy_bind_size", &DyldInfo::set_lazy_bind_size, "size"_a) .def("set_export_offset", &DyldInfo::set_export_offset, "offset"_a) .def("set_export_size", &DyldInfo::set_export_size, "size"_a) .def("__eq__", &DyldInfo::operator==) .def("__ne__", &DyldInfo::operator!=) .def("__hash__", [] (const DyldInfo& info) { return Hash::hash(info); }) .def("__str__", [] (const DyldInfo& info) { std::ostringstream stream; stream << info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDylibCommand.cpp000066400000000000000000000103651443457337100232530ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DylibCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (DylibCommand::*)(void) const; template using setter_t = void (DylibCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "DylibCommand", R"delim( Class which represents a library dependency )delim") .def_property("name", static_cast>(&DylibCommand::name), static_cast>(&DylibCommand::name), "Library's name", py::return_value_policy::reference_internal) .def_property("timestamp", static_cast>(&DylibCommand::timestamp), static_cast>(&DylibCommand::timestamp), "Library's timestamp", py::return_value_policy::reference_internal) .def_property("current_version", static_cast>(&DylibCommand::current_version), static_cast>(&DylibCommand::current_version), "Library's current version", py::return_value_policy::reference_internal) .def_property("compatibility_version", static_cast>(&DylibCommand::compatibility_version), static_cast>(&DylibCommand::compatibility_version), "Library's compatibility version", py::return_value_policy::reference_internal) .def_static("weak_lib", &DylibCommand::weak_dylib, "Factory function to generate a " RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES.LOAD_WEAK_DYLIB) " library", "name"_a, "timestamp"_a = 0, "current_version"_a = 0, "compat_version"_a = 0) .def_static("id_dylib", &DylibCommand::id_dylib, "Factory function to generate a " RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES.ID_DYLIB) " library", "name"_a, "timestamp"_a = 0, "current_version"_a = 0, "compat_version"_a = 0) .def_static("load_dylib", &DylibCommand::load_dylib, "Factory function to generate a " RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES.LOAD_DYLIB) " library", "name"_a, "timestamp"_a = 0, "current_version"_a = 0, "compat_version"_a = 0) .def_static("reexport_dylib", &DylibCommand::reexport_dylib, "Factory function to generate a " RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES.REEXPORT_DYLIB) " library", "name"_a, "timestamp"_a = 0, "current_version"_a = 0, "compat_version"_a = 0) .def_static("load_upward_dylib", &DylibCommand::load_upward_dylib, "Factory function to generate a " RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES.LOAD_UPWARD_DYLIB) " library", "name"_a, "timestamp"_a = 0, "current_version"_a = 0, "compat_version"_a = 0) .def_static("lazy_load_dylib", &DylibCommand::lazy_load_dylib, "Factory function to generate a " RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES.LAZY_LOAD_DYLIB) " library", "name"_a, "timestamp"_a = 0, "current_version"_a = 0, "compat_version"_a = 0) .def("__eq__", &DylibCommand::operator==) .def("__ne__", &DylibCommand::operator!=) .def("__hash__", [] (const DylibCommand& dylib_command) { return Hash::hash(dylib_command); }) .def("__str__", [] (const DylibCommand& command) { std::ostringstream stream; stream << command; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDylinker.cpp000066400000000000000000000037021443457337100224670ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DylinkerCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (DylinkerCommand::*)(void) const; template using setter_t = void (DylinkerCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "DylinkerCommand", R"delim( Class that represents the Mach-O linker, also named loader Most of the time, :attr:`~lief.MachO.DylinkerCommand.name` returns ``/usr/lib/dyld`` )delim") .def_property("name", static_cast>(&DylinkerCommand::name), static_cast>(&DylinkerCommand::name), "Path to the loader/linker", py::return_value_policy::reference_internal) .def("__eq__", &DylinkerCommand::operator==) .def("__ne__", &DylinkerCommand::operator!=) .def("__hash__", [] (const DylinkerCommand& dylinker) { return Hash::hash(dylinker); }) .def("__str__", [] (const DylinkerCommand& dylinker) { std::ostringstream stream; stream << dylinker; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyDynamicSymbolCommand.cpp000066400000000000000000000200231443457337100247520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/DynamicSymbolCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (DynamicSymbolCommand::*)(void) const; template using setter_t = void (DynamicSymbolCommand::*)(T); template using no_const_getter = T (DynamicSymbolCommand::*)(void); template<> void create(py::module& m) { py::class_(m, "DynamicSymbolCommand", R"delim( Class that represents the LC_DYSYMTAB command. This command completes the LC_SYMTAB (SymbolCommand) to provide a better granularity over the symbols layout. )delim") .def_property("idx_local_symbol", static_cast>(&DynamicSymbolCommand::idx_local_symbol), static_cast>(&DynamicSymbolCommand::idx_local_symbol), "Index of the first symbol in the group of local symbols." ) .def_property("nb_local_symbols", static_cast>(&DynamicSymbolCommand::nb_local_symbols), static_cast>(&DynamicSymbolCommand::nb_local_symbols), "Number of symbols in the group of local symbols." ) .def_property("idx_external_define_symbol", static_cast>(&DynamicSymbolCommand::idx_external_define_symbol), static_cast>(&DynamicSymbolCommand::idx_external_define_symbol), "Index of the first symbol in the group of defined external symbols." ) .def_property("nb_external_define_symbols", static_cast>(&DynamicSymbolCommand::nb_external_define_symbols), static_cast>(&DynamicSymbolCommand::nb_external_define_symbols), "Number of symbols in the group of defined external symbols." ) .def_property("idx_undefined_symbol", static_cast>(&DynamicSymbolCommand::idx_undefined_symbol), static_cast>(&DynamicSymbolCommand::idx_undefined_symbol), "Index of the first symbol in the group of undefined external symbols." ) .def_property("nb_undefined_symbols", static_cast>(&DynamicSymbolCommand::nb_undefined_symbols), static_cast>(&DynamicSymbolCommand::nb_undefined_symbols), "Number of symbols in the group of undefined external symbols." ) .def_property("toc_offset", static_cast>(&DynamicSymbolCommand::toc_offset), static_cast>(&DynamicSymbolCommand::toc_offset), R"delim( Byte offset from the start of the file to the table of contents data. Table of content is used by legacy Mach-O loader and this field should be set to 0 )delim") .def_property("nb_toc", static_cast>(&DynamicSymbolCommand::nb_toc), static_cast>(&DynamicSymbolCommand::nb_toc), R"delim( Number of entries in the table of contents Should be set to 0 on recent Mach-O )delim") .def_property("module_table_offset", static_cast>(&DynamicSymbolCommand::module_table_offset), static_cast>(&DynamicSymbolCommand::module_table_offset), R"delim( Byte offset from the start of the file to the module table data. This field seems unused by recent Mach-O loader and should be set to 0 )delim") .def_property("nb_module_table", static_cast>(&DynamicSymbolCommand::nb_module_table), static_cast>(&DynamicSymbolCommand::nb_module_table), R"delim( Number of entries in the module table. This field seems unused by recent Mach-O loader and should be set to 0. )delim") .def_property("external_reference_symbol_offset", static_cast>(&DynamicSymbolCommand::external_reference_symbol_offset), static_cast>(&DynamicSymbolCommand::external_reference_symbol_offset), R"delim( Byte offset from the start of the file to the external reference table data. This field seems unused by recent Mach-O loader and should be set to 0 )delim") .def_property("nb_external_reference_symbols", static_cast>(&DynamicSymbolCommand::nb_external_reference_symbols), static_cast>(&DynamicSymbolCommand::nb_external_reference_symbols), R"delim( Number of entries in the external reference table. This field seems unused by recent Mach-O loader and should be set to 0. )delim") .def_property("indirect_symbol_offset", static_cast>(&DynamicSymbolCommand::indirect_symbol_offset), static_cast>(&DynamicSymbolCommand::indirect_symbol_offset), R"delim( Byte offset from the start of the file to the indirect symbol table data. Indirect symbol table is used by the loader to speed-up symbol resolution during the *lazy binding* process References: * ``dyld-519.2.1/src/ImageLoaderMachOCompressed.cpp`` * ``dyld-519.2.1/src/ImageLoaderMachOClassic.cpp`` )delim") .def_property("nb_indirect_symbols", static_cast>(&DynamicSymbolCommand::nb_indirect_symbols), static_cast>(&DynamicSymbolCommand::nb_indirect_symbols), "Number of entries in the indirect symbol table.") .def_property("external_relocation_offset", static_cast>(&DynamicSymbolCommand::external_relocation_offset), static_cast>(&DynamicSymbolCommand::external_relocation_offset), R"delim( Byte offset from the start of the file to the module table data. This field seems unused by recent Mach-O loader and should be set to 0 )delim") .def_property("nb_external_relocations", static_cast>(&DynamicSymbolCommand::nb_external_relocations), static_cast>(&DynamicSymbolCommand::nb_external_relocations), R"delim( Number of entries in the external relocation table. This field seems unused by recent Mach-O loader and should be set to 0 )delim") .def_property("local_relocation_offset", static_cast>(&DynamicSymbolCommand::local_relocation_offset), static_cast>(&DynamicSymbolCommand::local_relocation_offset), R"delim( Byte offset from the start of the file to the local relocation table data. This field seems unused by recent Mach-O loader and should be set to 0 )delim") .def_property("nb_local_relocations", static_cast>(&DynamicSymbolCommand::nb_local_relocations), static_cast>(&DynamicSymbolCommand::nb_local_relocations), R"delim( Number of entries in the local relocation table. This field seems unused by recent Mach-O loader and should be set to 0 )delim") .def("__eq__", &DynamicSymbolCommand::operator==) .def("__ne__", &DynamicSymbolCommand::operator!=) .def("__hash__", [] (const DynamicSymbolCommand& cmd) { return Hash::hash(cmd); }) .def("__str__", [] (const DynamicSymbolCommand& info) { std::ostringstream stream; stream << info; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyEncryptionInfo.cpp000066400000000000000000000045471443457337100236640ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/EncryptionInfo.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (EncryptionInfo::*)(void) const; template using setter_t = void (EncryptionInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "EncryptionInfo", R"delim( Class that represents the LC_ENCRYPTION_INFO / LC_ENCRYPTION_INFO_64 commands The encryption info is usually present in Mach-O executables that target iOS to encrypt some sections of the binary )delim") .def_property("crypt_offset", static_cast>(&EncryptionInfo::crypt_offset), static_cast>(&EncryptionInfo::crypt_offset), "File offset of encrypted range") .def_property("crypt_size", static_cast>(&EncryptionInfo::crypt_size), static_cast>(&EncryptionInfo::crypt_size), "File size of encrypted range") .def_property("crypt_id", static_cast>(&EncryptionInfo::crypt_id), static_cast>(&EncryptionInfo::crypt_id), "The encryption system. 0 means no encrypted") .def("__eq__", &EncryptionInfo::operator==) .def("__ne__", &EncryptionInfo::operator!=) .def("__hash__", [] (const EncryptionInfo& uuid) { return Hash::hash(uuid); }) .def("__str__", [] (const EncryptionInfo& uuid) { std::ostringstream stream; stream << uuid; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyExportInfo.cpp000066400000000000000000000100511443457337100227760ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/ExportInfo.hpp" #include "LIEF/MachO/Symbol.hpp" #include "LIEF/MachO/DylibCommand.hpp" #include "pyMachO.hpp" #include "pyIterators.hpp" namespace LIEF { namespace MachO { template using getter_t = T (ExportInfo::*)(void) const; template using no_const_getter_t = T (ExportInfo::*)(void); template using setter_t = void (ExportInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "ExportInfo", R"delim( Class that provides an interface over the Dyld export info This class does not represent a structure that exists in the Mach-O format specification but provides a *view* on an entry of the Dyld export trie. )delim") .def_property_readonly("node_offset", static_cast>(&ExportInfo::node_offset), "Original offset in the export Trie") .def_property_readonly("kind", static_cast>(&ExportInfo::kind), "The export's kind: regular, thread local, absolute, ... (" RST_CLASS_REF(lief.MachO.EXPORT_SYMBOL_KINDS) ")") .def_property_readonly("flags_list", static_cast>(&ExportInfo::flags_list), "Return flags as a list of " RST_CLASS_REF(lief.MachO.EXPORT_SYMBOL_KINDS) "") .def_property("flags", static_cast>(&ExportInfo::flags), static_cast>(&ExportInfo::flags), "Some information (" RST_CLASS_REF(lief.MachO.EXPORT_SYMBOL_FLAGS) ") about the export (like weak export, reexport, ...)") .def_property("address", static_cast>(&ExportInfo::address), static_cast>(&ExportInfo::address), "The address of the export") .def_property_readonly("alias", static_cast>(&ExportInfo::alias), "" RST_CLASS_REF(lief.MachO.Symbol) " alias if the current symbol is re-exported", py::return_value_policy::reference) .def_property_readonly("alias_library", static_cast>(&ExportInfo::alias_library), "If the current symbol has an alias, it returns the " RST_CLASS_REF(lief.MachO.DylibCommand) " " " command associated with", py::return_value_policy::reference) .def_property_readonly("has_symbol", &ExportInfo::has_symbol, "``True`` if the export info has a " RST_CLASS_REF(lief.MachO.Symbol) " associated with") .def("has", &ExportInfo::has, "Check if the flag " RST_CLASS_REF(lief.MachO.EXPORT_SYMBOL_FLAGS) " given in first parameter is present" "flag"_a) .def_property_readonly("symbol", static_cast(&ExportInfo::symbol), "" RST_CLASS_REF(lief.MachO.Symbol) " associated with the export if any, or None ", py::return_value_policy::reference) .def("__eq__", &ExportInfo::operator==) .def("__ne__", &ExportInfo::operator!=) .def("__hash__", [] (const ExportInfo& export_info) { return Hash::hash(export_info); }) .def("__str__", [] (const ExportInfo& export_info) { std::ostringstream stream; stream << export_info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyFatBinary.cpp000066400000000000000000000050741443457337100225710ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "LIEF/MachO/FatBinary.hpp" #include "pyIterators.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_ fat(m, "FatBinary", R"delim( Class which represent a Mach-O (fat) binary This object is also used for representing Mach-O binaries that are **NOT FAT** )delim"); init_ref_iterator(fat, "it_binaries"); fat .def_property_readonly("size", &FatBinary::size, "Number of " RST_CLASS_REF(lief.MachO.Binary) " registred") .def("at", static_cast(&FatBinary::at), "Return the " RST_CLASS_REF(lief.MachO.Binary) " at the given index or None if it is not present", "index"_a, py::return_value_policy::reference_internal) .def("take", static_cast(FatBinary::*)(CPU_TYPES)>(&FatBinary::take), "Return the " RST_CLASS_REF(lief.MachO.Binary) " that matches the " "given " RST_CLASS_REF(lief.MachO.CPU_TYPES) "", "cpu"_a, py::return_value_policy::take_ownership) .def("write", &FatBinary::write, "Build a Mach-O universal binary", "filename"_a) .def("raw", &FatBinary::raw, "Build a Mach-O universal binary and return its bytes") .def("__len__", &FatBinary::size) .def("__getitem__", static_cast(&FatBinary::operator[]), "", py::return_value_policy::reference_internal) .def("__iter__", static_cast(&FatBinary::begin), py::return_value_policy::reference_internal) .def("__str__", [] (const FatBinary& fat_binary) { std::ostringstream stream; stream << fat_binary; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyFilesetCommand.cpp000066400000000000000000000047651443457337100236120ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/FilesetCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (FilesetCommand::*)(void) const; template using setter_t = void (FilesetCommand::*)(T); template using no_const_getter_t = T (FilesetCommand::*)(); template<> void create(py::module& m) { py::class_(m, "FilesetCommand", "Class associated with the LC_FILESET_ENTRY commands") .def_property("name", static_cast>(&FilesetCommand::name), static_cast>(&FilesetCommand::name), "Name of the underlying MachO binary") .def_property("virtual_address", static_cast>(&FilesetCommand::virtual_address), static_cast>(&FilesetCommand::virtual_address), "Memory address where the MachO file should be mapped") .def_property("file_offset", static_cast>(&FilesetCommand::file_offset), static_cast>(&FilesetCommand::file_offset), "Original offset in the kernel cache") .def_property_readonly("binary", static_cast>(&FilesetCommand::binary), "Return the " RST_CLASS_REF(lief.MachO.Binary) " object associated with the entry", py::return_value_policy::reference) .def("__eq__", &FilesetCommand::operator==) .def("__ne__", &FilesetCommand::operator!=) .def("__hash__", [] (const FilesetCommand& main) { return Hash::hash(main); }) .def("__str__", [] (const FilesetCommand& main) { std::ostringstream stream; stream << main; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyFunctionStarts.cpp000066400000000000000000000057351443457337100237040ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/FunctionStarts.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (FunctionStarts::*)(void) const; template using setter_t = void (FunctionStarts::*)(T); template<> void create(py::module& m) { py::class_(m, "FunctionStarts", R"delim( Class which represents the LC_FUNCTION_STARTS command This command is an array of ULEB128 encoded values )delim") .def_property("data_offset", static_cast>(&FunctionStarts::data_offset), static_cast>(&FunctionStarts::data_offset), "Offset in the binary where *start functions* are located") .def_property("data_size", static_cast>(&FunctionStarts::data_size), static_cast>(&FunctionStarts::data_size), "Size of the functions list in the binary") .def_property("functions", static_cast&>>(&FunctionStarts::functions), static_cast&>>(&FunctionStarts::functions), R"delim( Addresses of every function entry point in the executable This allows functions to exist for which there are no entries in the symbol table. .. warning:: The address is relative to the ``__TEXT`` segment )delim", py::return_value_policy::reference_internal) .def("add_function", &FunctionStarts::add_function, "Add a new function", "address"_a) .def_property_readonly("content", [] (const FunctionStarts& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The original content as a bytes stream") .def("__eq__", &FunctionStarts::operator==) .def("__ne__", &FunctionStarts::operator!=) .def("__hash__", [] (const FunctionStarts& func) { return Hash::hash(func); }) .def("__str__", [] (const FunctionStarts& func) { std::ostringstream stream; stream << func; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyHeader.cpp000066400000000000000000000105751443457337100221040ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/Header.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template<> void create
(py::module& m) { py::class_(m, "Header", "Class that represents the Mach-O header") .def(py::init<>()) .def_property("magic", static_cast>(&Header::magic), static_cast>(&Header::magic), R"delim( The Mach-O magic bytes. These bytes determine whether it is a 32 bits Mach-O, a 64 bits Mach-O files etc. )delim") .def_property("cpu_type", static_cast>(&Header::cpu_type), static_cast>(&Header::cpu_type), "Target CPU ( " RST_CLASS_REF(lief.MachO.CPU_TYPES) ")") .def_property("cpu_subtype", static_cast>(&Header::cpu_subtype), static_cast>(&Header::cpu_subtype), R"delim( Return the CPU subtype supported by the Mach-O binary. For ARM architectures, this value could represent the minimum version for which the Mach-O binary has been compiled for. )delim") .def_property("file_type", static_cast>(&Header::file_type), static_cast>(&Header::file_type), "Binary's type ( " RST_CLASS_REF(lief.MachO.FILE_TYPES) ")") .def_property("flags", static_cast>(&Header::flags), static_cast>(&Header::flags), "Binary's flags ( " RST_CLASS_REF(lief.MachO.HEADER_FLAGS) ")") .def_property("nb_cmds", static_cast>(&Header::nb_cmds), static_cast>(&Header::nb_cmds), "Number of " RST_CLASS_REF(lief.MachO.LoadCommand) "") .def_property("sizeof_cmds", static_cast>(&Header::sizeof_cmds), static_cast>(&Header::sizeof_cmds), "Size of all " RST_CLASS_REF(lief.MachO.LoadCommand) "") .def_property("reserved", static_cast>(&Header::reserved), static_cast>(&Header::reserved), "According to the official documentation, a reserved value") .def_property_readonly("flags_list", &Header::flags_list, "" RST_CLASS_REF(lief.PE.HEADER_FLAGS) " as a list") .def("add", static_cast(&Header::add), "Add the given " RST_CLASS_REF(lief.MachO.HEADER_FLAGS) "", "flag"_a) .def("remove", static_cast(&Header::remove), "Remove the given " RST_CLASS_REF(lief.MachO.HEADER_FLAGS) "", "flag"_a) .def("has", static_cast(&Header::has), "``True`` if the given " RST_CLASS_REF(lief.MachO.HEADER_FLAGS) " is in the " ":attr:`~lief.MachO.Header.flags`", "flag"_a) .def("__eq__", &Header::operator==) .def("__ne__", &Header::operator!=) .def("__hash__", [] (const Header& header) { return Hash::hash(header); }) .def(py::self += HEADER_FLAGS()) .def(py::self -= HEADER_FLAGS()) .def("__contains__", static_cast(&Header::has), "Check if the given " RST_CLASS_REF(lief.MachO.HEADER_FLAGS) " is present") .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyLinkerOptHint.cpp000066400000000000000000000040551443457337100234420ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/LinkerOptHint.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_(m, "LinkerOptHint", R"delim( Class which represents the `LC_LINKER_OPTIMIZATION_HINT` command )delim") .def_property("data_offset", py::overload_cast<>(&LinkerOptHint::data_offset, py::const_), py::overload_cast(&LinkerOptHint::data_offset), "Offset in the binary where the payload starts") .def_property("data_size", py::overload_cast<>(&LinkerOptHint::data_offset, py::const_), py::overload_cast(&LinkerOptHint::data_offset), "Size of the raw payload") .def_property_readonly("content", [] (const LinkerOptHint& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The raw payload") .def("__eq__", &LinkerOptHint::operator==) .def("__ne__", &LinkerOptHint::operator!=) .def("__hash__", [] (const LinkerOptHint& opt) { return Hash::hash(opt); }) .def("__str__", [] (const LinkerOptHint& opt) { std::ostringstream stream; stream << opt; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyLoadCommand.cpp000066400000000000000000000047011443457337100230640ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/LoadCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (LoadCommand::*)(void) const; template using setter_t = void (LoadCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadCommand", "Based class for the Mach-O load commands") .def(py::init<>()) .def_property("command", static_cast>(&LoadCommand::command), static_cast>(&LoadCommand::command), "Command type ( " RST_CLASS_REF(lief.MachO.LOAD_COMMAND_TYPES) ")" ) .def_property("size", static_cast>(&LoadCommand::size), static_cast>(&LoadCommand::size), "Size of the command (should be greather than ``sizeof(load_command)``)") .def_property("data", static_cast>(&LoadCommand::data), static_cast>(&LoadCommand::data), "Command's data") .def_property("command_offset", static_cast>(&LoadCommand::command_offset), static_cast>(&LoadCommand::command_offset), "Offset of the command within the *Load Command Table*") .def("__eq__", &LoadCommand::operator==) .def("__ne__", &LoadCommand::operator!=) .def("__hash__", [] (const LoadCommand& load_command) { return Hash::hash(load_command); }) .def("__str__", [] (const LoadCommand& command) { std::ostringstream stream; stream << command; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyMainCommand.cpp000066400000000000000000000040571443457337100230750ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/MainCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (MainCommand::*)(void) const; template using setter_t = void (MainCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "MainCommand", R"delim( Class that represent the LC_MAIN command. This kind of command can be used to determine the entrypoint of an executable )delim") .def_property("entrypoint", static_cast>(&MainCommand::entrypoint), static_cast>(&MainCommand::entrypoint), "Offset of the *main* function relative to the ``__TEXT`` segment") .def_property("stack_size", static_cast>(&MainCommand::stack_size), static_cast>(&MainCommand::stack_size), "The initial stack size (if not 0)") .def("__eq__", &MainCommand::operator==) .def("__ne__", &MainCommand::operator!=) .def("__hash__", [] (const MainCommand& main) { return Hash::hash(main); }) .def("__str__", [] (const MainCommand& main) { std::ostringstream stream; stream << main; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyParser.cpp000066400000000000000000000057351443457337100221520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "PyIOStream.hpp" #include "LIEF/MachO/Parser.hpp" #include "LIEF/MachO/FatBinary.hpp" #include "LIEF/logging.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { // Parser (Parser) m.def("parse", static_cast (*) (const std::string&, const ParserConfig&)>(&LIEF::MachO::Parser::parse), R"delim( Parse the given binary and return a :class:`~lief.MachO.FatBinary` object One can configure the parsing with the ``config`` parameter. See :class:`~lief.MachO.ParserConfig`, )delim", "filename"_a, "config"_a = ParserConfig::deep(), py::return_value_policy::take_ownership); m.def("parse", static_cast (*) (const std::vector&, const std::string&, const ParserConfig&)>(&LIEF::MachO::Parser::parse), R"delim( Parse the given binary (from raw bytes) and return a :class:`~lief.MachO.FatBinary` object One can configure the parsing with the ``config`` parameter. See :class:`~lief.MachO.ParserConfig` )delim", "raw"_a, "name"_a = "", "config"_a = ParserConfig::quick(), py::return_value_policy::take_ownership); m.def("parse_from_memory", static_cast (*) (uintptr_t, const ParserConfig&)>(&MachO::Parser::parse_from_memory), R"delim( Parse the Mach-O binary from the address given in the first parameter )delim", "address"_a, "config"_a = ParserConfig::deep(), py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, std::string name, const ParserConfig& config) -> py::object { if (auto stream = PyIOStream::from_python(byteio)) { auto ptr = std::make_unique(std::move(*stream)); return py::cast(MachO::Parser::parse(std::move(ptr), config)); } logging::log(logging::LOG_ERR, "Can't create a LIEF stream interface over the provided io"); return py::none(); }, R"delim( Parse the given binary from a Python IO interface and return a :class:`~lief.MachO.FatBinary` object One can configure the parsing with the ``config`` parameter. See :class:`~lief.MachO.ParserConfig` )delim", "io"_a, "name"_a = "", "config"_a = ParserConfig::quick(), py::return_value_policy::take_ownership); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyParserConfig.cpp000066400000000000000000000047161443457337100232760ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "LIEF/MachO/ParserConfig.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_(m, "ParserConfig", R"delim( This class is used to tweak the MachO Parser (:class:`~lief.MachO.Parser`) )delim") .def(py::init<>()) .def_readwrite("parse_dyld_exports", &ParserConfig::parse_dyld_exports, "Parse the Dyld export trie") .def_readwrite("parse_dyld_bindings", &ParserConfig::parse_dyld_bindings, "Parse the Dyld binding opcodes") .def_readwrite("parse_dyld_rebases", &ParserConfig::parse_dyld_rebases, "Parse the Dyld rebase opcodes") .def_readwrite("fix_from_memory", &ParserConfig::fix_from_memory, R"delim( When parsing Mach-O from memory, this option can be used to *undo* relocations and symbols bindings. When activated, this option requires parse_dyld_bindings and parse_dyld_rebases to be enabled. )delim") .def("full_dyldinfo", &ParserConfig::full_dyldinfo, R"delim( If ``flag`` is set to ``true``, Exports, Bindings and Rebases opcodes are parsed. .. warning:: Enabling this flag can slow down the parsing )delim", "flag"_a) .def_property_readonly_static("deep", [] (py::object /* self */) { return ParserConfig::deep(); }, R"delim( Return a parser configuration such as all the objects supported by LIEF are parsed )delim") .def_property_readonly_static("quick", [] (py::object /* self */) { return ParserConfig::quick(); }, R"delim( Return a configuration to parse the most important MachO structures )delim"); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyRPathCommand.cpp000066400000000000000000000034051443457337100232230ustar00rootroot00000000000000/* Copyright 2017 - 2021 J.Rieck (based on R. Thomas's work) * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/RPathCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (RPathCommand::*)(void) const; template using setter_t = void (RPathCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "RPathCommand") .def_property("path", static_cast>(&RPathCommand::path), static_cast>(&RPathCommand::path), "@rpath path", py::return_value_policy::reference_internal) .def("__eq__", &RPathCommand::operator==) .def("__ne__", &RPathCommand::operator!=) .def("__hash__", [] (const RPathCommand& rpath_command) { return Hash::hash(rpath_command); }) .def("__str__", [] (const RPathCommand& rpath_command) { std::ostringstream stream; stream << rpath_command; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyRelocation.cpp000066400000000000000000000132601443457337100230050ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/Relocation.hpp" #include "LIEF/MachO/Symbol.hpp" #include "LIEF/MachO/Section.hpp" #include "LIEF/MachO/SegmentCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (Relocation::*)(void) const; template using setter_t = void (Relocation::*)(T); template<> void create(py::module& m) { py::class_(m, "Relocation", R"delim( It extends the LIEF :class:`lief.Relocation` abstract class and it is sub-classed by 1. :class:`~lief.MachO.RelocationObject` 2. :class:`~lief.MachO.RelocationDyld` )delim") .def_property("address", static_cast>(&Relocation::address), static_cast>(&Relocation::address), R"delim( For :attr:`~lief.MachO.FILE_TYPES.OBJECT` or (:attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.RELOC_TABLE`) this is an " offset from the start of the :class:`~lief.MachO.Section` to the item containing the address requiring relocation. For :attr:`~lief.MachO.FILE_TYPES.EXECUTE` / :attr:`~lief.MachO.FILE_TYPES.DYLIB` or (:attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.DYLDINFO`) this is a :attr:`~lief.MachO.SegmentCommand.virtual_address`. )delim") .def_property("pc_relative", static_cast>(&Relocation::is_pc_relative), static_cast>(&Relocation::pc_relative), R"delim( Indicates whether the item containing the address to be relocated is part of a CPU instruction that uses PC-relative addressing. For addresses contained in PC-relative instructions, the CPU adds the address of the instruction to the address contained in the instruction. )delim") .def_property("type", static_cast>(&Relocation::type), static_cast>(&Relocation::type), R"delim( Type of the relocation according to the :attr:`~lief.MachO.Relocation.architecture` and/or :attr:`~lief.MachO.Relocation.origin` If :attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.RELOC_TABLE`: See: * :class:`lief.MachO.X86_RELOCATION` * :class:`lief.MachO.X86_64_RELOCATION` * :class:`lief.MachO.PPC_RELOCATION` * :class:`lief.MachO.ARM_RELOCATION` * :class:`lief.MachO.ARM64_RELOCATION` If :attr:`~lief.MachO.Relocation.origin` is :attr:`~lief.MachO.RELOCATION_ORIGINS.DYLDINFO`, the value is associated with :class:`~lief.MachO.REBASE_TYPES`. )delim") .def_property_readonly("architecture", &Relocation::architecture, "" RST_CLASS_REF(lief.MachO.CPU_TYPES) " of the relocation") .def_property_readonly("has_symbol", &Relocation::has_symbol, "``True`` if the relocation has a " RST_CLASS_REF(lief.MachO.Symbol) " associated with") .def_property_readonly("symbol", static_cast(&Relocation::symbol), "" RST_CLASS_REF(lief.MachO.Symbol) " associated with the relocation if any, or None", py::return_value_policy::reference) .def_property_readonly("has_section", &Relocation::has_section, "``True`` if the relocation has a " RST_CLASS_REF(lief.MachO.Section) " associated with") .def_property_readonly("section", static_cast(&Relocation::section), "" RST_CLASS_REF(lief.MachO.Section) " associated with the relocation if any, or None", py::return_value_policy::reference) .def_property_readonly("origin", &Relocation::origin, R"delim( :class:`~lief.MachO.RELOCATION_ORIGINS` of the relocation * For :attr:`~lief.MachO.FILE_TYPES.OBJECT` file it should be :attr:`~lief.MachO.RELOCATION_ORIGINS.RELOC_TABLE` * For :attr:`~lief.MachO.FILE_TYPES.EXECUTE` or :attr:`~lief.MachO.FILE_TYPES.DYLIB` it should be :attr:`~lief.MachO.RELOCATION_ORIGINS.DYLDINFO`") )delim") .def_property_readonly("has_segment", &Relocation::has_segment, "``True`` if the relocation has a " RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with") .def_property_readonly("segment", static_cast(&Relocation::segment), "" RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with the relocation if any, or None", py::return_value_policy::reference) .def("__eq__", &Relocation::operator==) .def("__ne__", &Relocation::operator!=) .def("__hash__", [] (const Relocation& relocation) { return Hash::hash(relocation); }) .def("__str__", [] (const Relocation& relocation) { std::ostringstream stream; stream << relocation; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyRelocationDyld.cpp000066400000000000000000000040501443457337100236170ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/RelocationDyld.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (RelocationDyld::*)(void) const; template using setter_t = void (RelocationDyld::*)(T); template<> void create(py::module& m) { py::class_(m, "RelocationDyld", R"delim( Class that represents a relocation found in the :class:`~lief.MachO.DyldInfo` structure. While this class does not have an associated structure in the Mach-O format specification, it provides a convenient interface for the :attr:`lief.MachO.DyldInfo.rebase` values See also: :class:`~lief.MachO.RelocationObject` )delim") .def("__le__", &RelocationDyld::operator<=) .def("__lt__", &RelocationDyld::operator<) .def("__ge__", &RelocationDyld::operator>=) .def("__gt__", &RelocationDyld::operator>) .def("__eq__", &RelocationDyld::operator==) .def("__ne__", &RelocationDyld::operator!=) .def("__hash__", [] (const RelocationDyld& relocation) { return Hash::hash(relocation); }) .def("__str__", [] (const RelocationDyld& relocation) { std::ostringstream stream; stream << relocation; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyRelocationFixup.cpp000066400000000000000000000045151443457337100240240ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/RelocationFixup.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (RelocationFixup::*)() const; template using setter_t = void (RelocationFixup::*)(T); template<> void create(py::module& m) { py::class_(m, "RelocationFixup", R"delim( Class that represents a rebase relocation found in the LC_DYLD_CHAINED_FIXUPS command. This class extends :class:`lief.Relocation` (and :class:`lief.MachO.Relocation`) in which :attr:`~lief.Relocation.address` is set to the absolute virtual address where the relocation must take place (e.g. `0x10000d270`). On the other hand, :attr:`~lief.MachO.RelocationFixup.target` contains the value that should be set at :attr:`~lief.Relocation.address` if the imagebase is :attr:`~lief.Binary.imagebase` (e.g. `0x1000073a8`). If the Mach-O loader chooses another base address (like 0x7ff100000), it must set `0x10000d270` to `0x7ff1073a8`. )delim") .def_property("target", py::overload_cast<>(&RelocationFixup::target, py::const_), py::overload_cast(&RelocationFixup::target)) .def("__eq__", &RelocationFixup::operator==) .def("__ne__", &RelocationFixup::operator!=) .def("__hash__", [] (const RelocationFixup& relocation) { return Hash::hash(relocation); }) .def("__str__", [] (const RelocationFixup& relocation) { std::ostringstream stream; std::string str = stream.str(); return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyRelocationObject.cpp000066400000000000000000000050061443457337100241330ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/RelocationObject.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (RelocationObject::*)(void) const; template using setter_t = void (RelocationObject::*)(T); template<> void create(py::module& m) { py::class_(m, "RelocationObject", R"delim( Class that represents a relocation presents in the MachO object file (``.o``). Usually, this kind of relocation is found in the :class:`lief.MachO.Section`. )delim") .def_property("value", static_cast>(&RelocationObject::value), static_cast>(&RelocationObject::value), R"delim( For **scattered** relocations, the address of the relocatable expression for the item in the file that needs to be updated if the address is changed. For relocatable expressions with the difference of two section addresses, the address from which to subtract (in mathematical terms, the minuend) is contained in the first relocation entry and the address to subtract (the subtrahend) is contained in the second relocation entry.", )delim") .def_property_readonly("is_scattered", &RelocationObject::is_scattered, "``True`` if the relocation is a scattered one") .def("__eq__", &RelocationObject::operator==) .def("__ne__", &RelocationObject::operator!=) .def("__hash__", [] (const RelocationObject& relocation) { return Hash::hash(relocation); }) .def("__str__", [] (const RelocationObject& relocation) { std::ostringstream stream; stream << relocation; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pySection.cpp000066400000000000000000000144531443457337100223170ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/Section.hpp" #include "LIEF/MachO/Relocation.hpp" #include "LIEF/MachO/SegmentCommand.hpp" #include "pyMachO.hpp" #include "pyIterators.hpp" namespace LIEF { namespace MachO { template using getter_t = T (Section::*)(void) const; template using setter_t = void (Section::*)(T); template using no_const_getter = T (Section::*)(void); template<> void create
(py::module& m) { py::class_ sec(m, "Section", "Class that represents a Mach-O section"); try { /* * it_relocations could be already registered by the SegmentCommand */ init_ref_iterator(sec, "it_relocations"); } catch (const std::runtime_error&) { } sec .def(py::init<>()) .def(py::init(), "Constructor from a section's name", "section_name"_a) .def(py::init(), "Constructor from a section's name and its content", "section_name"_a, "content"_a) .def_property("alignment", static_cast>(&Section::alignment), static_cast>(&Section::alignment), "Section's alignment as a power of 2") .def_property("relocation_offset", static_cast>(&Section::relocation_offset), static_cast>(&Section::relocation_offset), R"delim( Offset of the relocation table. This value should be 0 for executable and libraries as the relocations are managed by the :attr:`lief.MachO.DyldInfo.rebase` Other the other hand, for object files (``.o``) this value should not be 0 )delim") .def_property("numberof_relocations", static_cast>(&Section::numberof_relocations), static_cast>(&Section::numberof_relocations), "Number of relocations associated with this section") .def_property("type", static_cast>(&Section::type), static_cast>(&Section::type), R"delim( Type of the section. This value can help to determine the purpose of the section (c.f. :class:`~lief.MachO.MACHO_SECTION_TYPES`) )delim") .def_property_readonly("relocations", static_cast>(&Section::relocations), "Iterator over the " RST_CLASS_REF(lief.MachO.Relocation) " (if any)", py::return_value_policy::reference_internal) .def_property("reserved1", static_cast>(&Section::reserved1), static_cast>(&Section::reserved1), "According to the official ``loader.h`` file, this value is reserved for *offset* or *index*") .def_property("reserved2", static_cast>(&Section::reserved2), static_cast>(&Section::reserved2), "According to the official ``loader.h`` file, this value is reserved for *offset* or *index*") .def_property("reserved3", static_cast>(&Section::reserved3), static_cast>(&Section::reserved3), "According to the official ``loader.h`` file, this value is reserved for *offset* or *index*") .def_property("flags", static_cast>(&Section::flags), static_cast>(&Section::flags), "Section's flags masked with SECTION_FLAGS_MASK (see: :class:`~lief.MachO.MACHO_SECTION_FLAGS`)") .def_property_readonly("flags_list", static_cast>(&Section::flags_list), py::return_value_policy::reference_internal) .def_property_readonly("segment", static_cast(&Section::segment), "" RST_CLASS_REF(lief.MachO.SegmentCommand) " associated with the section or None if not present", py::return_value_policy::reference) .def_property("segment_name", static_cast>(&Section::segment_name), static_cast>(&Section::segment_name), R"delim( The segment name associated with the section )delim") .def_property_readonly("has_segment", &Section::has_segment, "True if the current section has a segment associated with") .def("has", static_cast(&Section::has), "Check if the section has the given " RST_CLASS_REF(lief.MachO.SECTION_FLAGS) "", "flag"_a) .def("add", static_cast(&Section::add), "Add the given " RST_CLASS_REF(lief.MachO.SECTION_FLAGS) "", "flag"_a) .def("remove", static_cast(&Section::remove), "Remove the given " RST_CLASS_REF(lief.MachO.SECTION_FLAGS) "", "flag"_a) .def(py::self += MACHO_SECTION_FLAGS()) .def(py::self -= MACHO_SECTION_FLAGS()) .def("__contains__", static_cast(&Section::has), "Check if the given " RST_CLASS_REF(lief.MachO.MACHO_SECTION_FLAGS) " is present") .def("__eq__", &Section::operator==) .def("__ne__", &Section::operator!=) .def("__hash__", [] (const Section& section) { return Hash::hash(section); }) .def("__str__", [] (const Section& section) { std::ostringstream stream; stream << section; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pySegmentCommand.cpp000066400000000000000000000134211443457337100236060ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyMachO.hpp" #include "pyIterators.hpp" #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/SegmentCommand.hpp" #include "LIEF/MachO/Section.hpp" #include #include namespace LIEF { namespace MachO { template using getter_t = T (SegmentCommand::*)(void) const; template using setter_t = void (SegmentCommand::*)(T); template using no_const_getter = T (SegmentCommand::*)(void); template<> void create(py::module& m) { py::class_ seg_cmd(m, "SegmentCommand", R"delim( Class which represents a LOAD_COMMAND_TYPES::LC_SEGMENT / LOAD_COMMAND_TYPES::LC_SEGMENT_64 command )delim"); init_ref_iterator(seg_cmd, "it_sections"); try { /* * it_relocations could be already registered by the Section */ init_ref_iterator(seg_cmd, "it_relocations"); } catch (const std::runtime_error&) { } seg_cmd .def(py::init<>()) .def(py::init()) .def(py::init()) .def_property("name", [] (const SegmentCommand& obj) { return safe_string_converter(obj.name()); }, static_cast>(&SegmentCommand::name), "Segment's name") .def_property("virtual_address", static_cast>(&SegmentCommand::virtual_address), static_cast>(&SegmentCommand::virtual_address), "Segment's virtual address") .def_property("virtual_size", static_cast>(&SegmentCommand::virtual_size), static_cast>(&SegmentCommand::virtual_size), "Segment's virtual size") .def_property("file_size", static_cast>(&SegmentCommand::file_size), static_cast>(&SegmentCommand::file_size), "Segment's file size") .def_property("file_offset", static_cast>(&SegmentCommand::file_offset), static_cast>(&SegmentCommand::file_offset), "Segment's file offset") .def_property("max_protection", static_cast>(&SegmentCommand::max_protection), static_cast>(&SegmentCommand::max_protection), "Segment's max protection") .def_property("init_protection", static_cast>(&SegmentCommand::init_protection), static_cast>(&SegmentCommand::init_protection), "Segment's initial protection") .def_property("numberof_sections", static_cast>(&SegmentCommand::numberof_sections), static_cast>(&SegmentCommand::numberof_sections), "Number of sections in this segment") .def_property_readonly("sections", static_cast>(&SegmentCommand::sections), "Segment's sections") .def_property_readonly("relocations", static_cast>(&SegmentCommand::relocations), "Segment's relocations") .def_property_readonly("index", &SegmentCommand::index, "Relative index of the segment in the segment table") .def_property("content", [] (const SegmentCommand& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast>(&SegmentCommand::content), "Segment's content") .def_property("flags", static_cast>(&SegmentCommand::flags), static_cast>(&SegmentCommand::flags), "Segment's flags") .def("has", static_cast(&SegmentCommand::has), "Check if the given " RST_CLASS_REF(lief.MachO.Section) " belongs to the current segment", "section"_a) .def("has_section", static_cast(&SegmentCommand::has_section), "Check if the given section name belongs to the current segment", "section_name"_a) .def("add_section", static_cast(&SegmentCommand::add_section), "", "section"_a, py::return_value_policy::reference) .def("get_section", py::overload_cast(&SegmentCommand::get_section), R"delim( Get the :class:`~lief.MachO.Section` with the given name )delim", "name"_a, py::return_value_policy::reference_internal) .def("__eq__", &SegmentCommand::operator==) .def("__ne__", &SegmentCommand::operator!=) .def("__hash__", [] (const SegmentCommand& segment_command) { return Hash::hash(segment_command); }) .def("__str__", [] (const SegmentCommand& segment) { std::ostringstream stream; stream << segment; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pySegmentSplitInfo.cpp000066400000000000000000000044201443457337100241360ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/SegmentSplitInfo.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (SegmentSplitInfo::*)(void) const; template using setter_t = void (SegmentSplitInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "SegmentSplitInfo", "Class that represents the LOAD_COMMAND_TYPES::LC_SEGMENT_SPLIT_INFO command") .def_property("data_offset", static_cast>(&SegmentSplitInfo::data_offset), static_cast>(&SegmentSplitInfo::data_offset), "Offset in the binary where the data start") .def_property("data_size", static_cast>(&SegmentSplitInfo::data_size), static_cast>(&SegmentSplitInfo::data_size), "Size of the raw data") .def_property_readonly("content", [] (const SegmentSplitInfo& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The original content as a bytes stream") .def("__eq__", &SegmentSplitInfo::operator==) .def("__ne__", &SegmentSplitInfo::operator!=) .def("__hash__", [] (const SegmentSplitInfo& func) { return Hash::hash(func); }) .def("__str__", [] (const SegmentSplitInfo& func) { std::ostringstream stream; stream << func; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pySourceVersion.cpp000066400000000000000000000037401443457337100235160ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/SourceVersion.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (SourceVersion::*)(void) const; template using setter_t = void (SourceVersion::*)(T); template<> void create(py::module& m) { py::class_(m, "SourceVersion", R"delim( Class that represents the MachO LOAD_COMMAND_TYPES::LC_SOURCE_VERSION This command is used to provide the *version* of the sources used to build the binary )delim") .def_property("version", static_cast>(&SourceVersion::version), static_cast>(&SourceVersion::version), "Version as a tuple of **5** integers", py::return_value_policy::reference_internal) .def("__eq__", &SourceVersion::operator==) .def("__ne__", &SourceVersion::operator!=) .def("__hash__", [] (const SourceVersion& version) { return Hash::hash(version); }) .def("__str__", [] (const SourceVersion& version) { std::ostringstream stream; stream << version; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pySubFramework.cpp000066400000000000000000000046341443457337100233220ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/SubFramework.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (SubFramework::*)(void) const; template using setter_t = void (SubFramework::*)(T); template<> void create(py::module& m) { py::class_(m, "SubFramework", R"delim( Class that represents the SubFramework command. Accodring to the Mach-O ``loader.h`` documentation: > A dynamically linked shared library may be a subframework of an umbrella > framework. If so it will be linked with "-umbrella umbrella_name" where > Where "umbrella_name" is the name of the umbrella framework. A subframework > can only be linked against by its umbrella framework or other subframeworks > that are part of the same umbrella framework. Otherwise the static link > editor produces an error and states to link against the umbrella framework. > The name of the umbrella framework for subframeworks is recorded in the > following structure. )delim") .def_property("umbrella", static_cast>(&SubFramework::umbrella), static_cast>(&SubFramework::umbrella), "Name of the umbrella framework") .def("__eq__", &SubFramework::operator==) .def("__ne__", &SubFramework::operator!=) .def("__hash__", [] (const SubFramework& func) { return Hash::hash(func); }) .def("__str__", [] (const SubFramework& func) { std::ostringstream stream; stream << func; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pySymbol.cpp000066400000000000000000000077061443457337100221630ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/Section.hpp" #include "LIEF/MachO/Symbol.hpp" #include "pyIterators.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (Symbol::*)(void) const; template using setter_t = void (Symbol::*)(T); template<> void create(py::module& m) { py::class_ symbol(m, "Symbol", R"delim( Class that represents a Symbol in a Mach-O file. A Mach-O symbol can come from: 1. The symbols command (LC_SYMTAB / SymbolCommand) 2. The Dyld Export trie 3. The Dyld Symbol bindings )delim"); py::enum_(symbol, "TOOLS") .value("NONE", Symbol::CATEGORY::NONE) .value("LOCAL", Symbol::CATEGORY::LOCAL) .value("EXTERNAL", Symbol::CATEGORY::EXTERNAL) .value("UNDEFINED", Symbol::CATEGORY::UNDEFINED) .value("INDIRECT_ABS", Symbol::CATEGORY::INDIRECT_ABS) .value("INDIRECT_LOCAL", Symbol::CATEGORY::INDIRECT_LOCAL); symbol .def(py::init<>()) .def_property_readonly("demangled_name", &Symbol::demangled_name, "Symbol's unmangled name") .def_property("type", static_cast>(&Symbol::type), static_cast>(&Symbol::type)) .def_property("numberof_sections", static_cast>(&Symbol::numberof_sections), static_cast>(&Symbol::numberof_sections), R"delim( It returns the number of sections in which this symbol can be found. If the symbol can't be found in any section, it returns 0 (NO_SECT) )delim") .def_property("description", static_cast>(&Symbol::description), static_cast>(&Symbol::description), "Return information about the symbol (:class:`~lief.MachO.SYMBOL_DESCRIPTIONS`)") .def_property_readonly("has_export_info", &Symbol::has_export_info, "``True`` if the symbol has an " RST_CLASS_REF(lief.MachO.ExportInfo) " associated with") .def_property_readonly("origin", &Symbol::origin, "Return the " RST_CLASS_REF(lief.MachO.SYMBOL_ORIGINS) " of this symbol") .def_property_readonly("export_info", static_cast(&Symbol::export_info), "" RST_CLASS_REF(lief.MachO.ExportInfo) " associated with the symbol if any, or None", py::return_value_policy::reference) .def_property_readonly("has_binding_info", &Symbol::has_binding_info, "``True`` if the symbol has an " RST_CLASS_REF(lief.MachO.BindingInfo) " associated with") .def_property_readonly("binding_info", static_cast(&Symbol::binding_info), "" RST_CLASS_REF(lief.MachO.BindingInfo) " associated with the symbol if any, or None", py::return_value_policy::reference) .def("__eq__", &Symbol::operator==) .def("__ne__", &Symbol::operator!=) .def("__hash__", [] (const Symbol& symbol) { return Hash::hash(symbol); }) .def("__str__", [] (const Symbol& symbol) { std::ostringstream stream; stream << symbol; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pySymbolCommand.cpp000066400000000000000000000050031443457337100234460ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/SymbolCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (SymbolCommand::*)(void) const; template using setter_t = void (SymbolCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "SymbolCommand", R"delim( Class that represents the LC_SYMTAB command )delim") .def(py::init<>()) .def_property("symbol_offset", static_cast>(&SymbolCommand::symbol_offset), static_cast>(&SymbolCommand::symbol_offset), "Offset from the start of the file to the n_list associated with the command") .def_property("numberof_symbols", static_cast>(&SymbolCommand::numberof_symbols), static_cast>(&SymbolCommand::numberof_symbols), "Number of symbols registered") .def_property("strings_offset", static_cast>(&SymbolCommand::strings_offset), static_cast>(&SymbolCommand::strings_offset), "Offset from the start of the file to the string table") .def_property("strings_size", static_cast>(&SymbolCommand::strings_size), static_cast>(&SymbolCommand::strings_size), "Size of the size string table") .def("__eq__", &SymbolCommand::operator==) .def("__ne__", &SymbolCommand::operator!=) .def("__hash__", [] (const SymbolCommand& symbolcmd) { return Hash::hash(symbolcmd); }) .def("__str__", [] (const SymbolCommand& symbolcmd) { std::ostringstream stream; stream << symbolcmd; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyThreadCommand.cpp000066400000000000000000000073711443457337100234220ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/ThreadCommand.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (ThreadCommand::*)(void) const; template using setter_t = void (ThreadCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "ThreadCommand", R"delim( Class that represents the LC_THREAD / LC_UNIXTHREAD commands and that can be used to get the binary entrypoint when the LC_MAIN (MainCommand) is not present Generally speaking, this command aims at defining the original state of the main thread which includes the registers' values )delim") .def_property("flavor", static_cast>(&ThreadCommand::flavor), static_cast>(&ThreadCommand::flavor), R"delim( Integer that defines a special *flavor* for the thread. The meaning of this value depends on the :attr:`~lief.MachO.ThreadCommand.architecture`. The list of the values can be found in the XNU kernel files: - xnu/osfmk/mach/arm/thread_status.h for the ARM/AArch64 architectures - xnu/osfmk/mach/i386/thread_status.h for the x86/x86-64 architectures )delim") .def_property("state", static_cast&>>(&ThreadCommand::state), static_cast&>>(&ThreadCommand::state), R"delim( The actual thread state as a vector of bytes. Depending on the architecture(), these data can be casted into x86_thread_state_t, x86_thread_state64_t, ... )delim") .def_property("count", static_cast>(&ThreadCommand::count), static_cast>(&ThreadCommand::count), R"delim( Size of the thread state data with 32-bits alignment. This value should match len(:attr:`~lief.MachO.ThreadCommand.state`) )delim") .def_property_readonly("pc", static_cast>(&ThreadCommand::pc), R"delim( Return the initial Program Counter regardless of the underlying architecture. This value, when non null, can be used to determine the binary's entrypoint. Underneath, it works by looking for the PC register value in the :attr:`~lief.MachO.ThreadCommand.state` data )delim") .def_property("architecture", static_cast>(&ThreadCommand::architecture), static_cast>(&ThreadCommand::architecture), "The CPU architecture that is targeted by this ThreadCommand") .def("__eq__", &ThreadCommand::operator==) .def("__ne__", &ThreadCommand::operator!=) .def("__hash__", [] (const ThreadCommand& thread) { return LIEF::Hash::hash(thread); }) .def("__str__", [] (const ThreadCommand& thread) { std::ostringstream stream; stream << thread; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyTwoLevelHints.cpp000066400000000000000000000033471443457337100234620ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/TwoLevelHints.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template<> void create(py::module& m) { py::class_ cmd(m, "TwoLevelHints", R"delim( Class which represents the `LC_TWOLEVEL_HINTS` command )delim"); cmd .def_property_readonly("hints", py::overload_cast<>(&TwoLevelHints::hints)) .def_property_readonly("content", [] (const TwoLevelHints& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, "The original content as a bytes stream") .def("__eq__", &TwoLevelHints::operator==) .def("__ne__", &TwoLevelHints::operator!=) .def("__hash__", [] (const TwoLevelHints& two) { return Hash::hash(two); }) .def("__str__", [] (const TwoLevelHints& two) { std::ostringstream stream; stream << two; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyUUID.cpp000066400000000000000000000035401443457337100214540ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/UUIDCommand.hpp" #include "pyMachO.hpp" #ifdef uuid_t #pragma message("Windows #define uuid_t, undefine it for this file.") #undef uuid_t #endif namespace LIEF { namespace MachO { template using getter_t = T (UUIDCommand::*)(void) const; template using setter_t = void (UUIDCommand::*)(T); template<> void create(py::module& m) { py::class_(m, "UUIDCommand", "Class that represents the UUID command") .def_property("uuid", static_cast>(&UUIDCommand::uuid), static_cast>(&UUIDCommand::uuid), "UUID as a list", py::return_value_policy::reference_internal) .def("__eq__", &UUIDCommand::operator==) .def("__ne__", &UUIDCommand::operator!=) .def("__hash__", [] (const UUIDCommand& uuid) { return Hash::hash(uuid); }) .def("__str__", [] (const UUIDCommand& uuid) { std::ostringstream stream; stream << uuid; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/objects/pyVersionMin.cpp000066400000000000000000000041461443457337100230020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include "LIEF/MachO/hash.hpp" #include "LIEF/MachO/VersionMin.hpp" #include "pyMachO.hpp" namespace LIEF { namespace MachO { template using getter_t = T (VersionMin::*)(void) const; template using setter_t = void (VersionMin::*)(T); template<> void create(py::module& m) { py::class_(m, "VersionMin", "Class that wraps the LC_VERSION_MIN_MACOSX, LC_VERSION_MIN_IPHONEOS, ... commands") .def_property("version", static_cast>(&VersionMin::version), static_cast>(&VersionMin::version), "Version as a tuple of **3** integers", py::return_value_policy::reference_internal) .def_property("sdk", static_cast>(&VersionMin::sdk), static_cast>(&VersionMin::sdk), "SDK as a tuple of **3** integers", py::return_value_policy::reference_internal) .def("__eq__", &VersionMin::operator==) .def("__ne__", &VersionMin::operator!=) .def("__hash__", [] (const VersionMin& version) { return Hash::hash(version); }) .def("__str__", [] (const VersionMin& version) { std::ostringstream stream; stream << version; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/MachO/pyEnums.cpp000066400000000000000000000507731443457337100203560ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyMachO.hpp" #include "LIEF/MachO/enums.hpp" #include "LIEF/MachO/EnumToString.hpp" #include "enums_wrapper.hpp" #define PY_ENUM(x) LIEF::MachO::to_string(x), x namespace LIEF { namespace MachO { void init_enums(py::module& m) { LIEF::enum_(m, "CPU_TYPES") .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_ANY)) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_X86)) .value("I386", LIEF::MachO::CPU_TYPES::CPU_TYPE_I386) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_X86_64)) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_MC98000)) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_ARM)) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_ARM64)) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_SPARC)) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_POWERPC)) .value(PY_ENUM(LIEF::MachO::CPU_TYPES::CPU_TYPE_POWERPC64)); LIEF::enum_(m, "MACHO_TYPES") .value(PY_ENUM(LIEF::MachO::MACHO_TYPES::MH_MAGIC)) .value(PY_ENUM(LIEF::MachO::MACHO_TYPES::MH_CIGAM)) .value(PY_ENUM(LIEF::MachO::MACHO_TYPES::MH_MAGIC_64)) .value(PY_ENUM(LIEF::MachO::MACHO_TYPES::MH_CIGAM_64)) .value(PY_ENUM(LIEF::MachO::MACHO_TYPES::FAT_MAGIC)) .value(PY_ENUM(LIEF::MachO::MACHO_TYPES::FAT_CIGAM)); LIEF::enum_(m, "FILE_TYPES") .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_OBJECT)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_EXECUTE)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_FVMLIB)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_CORE)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_PRELOAD)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_DYLIB)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_DYLINKER)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_BUNDLE)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_DYLIB_STUB)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_DSYM)) .value(PY_ENUM(LIEF::MachO::FILE_TYPES::MH_KEXT_BUNDLE)); LIEF::enum_(m, "HEADER_FLAGS") .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_NOUNDEFS)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_INCRLINK)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_DYLDLINK)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_BINDATLOAD)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_PREBOUND)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_SPLIT_SEGS)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_LAZY_INIT)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_TWOLEVEL)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_FORCE_FLAT)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_NOMULTIDEFS)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_NOFIXPREBINDING)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_PREBINDABLE)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_ALLMODSBOUND)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_SUBSECTIONS_VIA_SYMBOLS)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_CANONICAL)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_WEAK_DEFINES)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_BINDS_TO_WEAK)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_ALLOW_STACK_EXECUTION)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_ROOT_SAFE)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_SETUID_SAFE)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_NO_REEXPORTED_DYLIBS)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_PIE)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_DEAD_STRIPPABLE_DYLIB)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_HAS_TLV_DESCRIPTORS)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_NO_HEAP_EXECUTION)) .value(PY_ENUM(LIEF::MachO::HEADER_FLAGS::MH_APP_EXTENSION_SAFE)); LIEF::enum_(m, "LOAD_COMMAND_TYPES") .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SEGMENT)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SYMTAB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SYMSEG)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_THREAD)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_UNIXTHREAD)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LOADFVMLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_IDFVMLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_IDENT)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_FVMFILE)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_PREPAGE)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DYSYMTAB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LOAD_DYLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_ID_DYLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LOAD_DYLINKER)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_ID_DYLINKER)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_PREBOUND_DYLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_ROUTINES)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SUB_FRAMEWORK)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SUB_UMBRELLA)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SUB_CLIENT)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SUB_LIBRARY)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_TWOLEVEL_HINTS)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_PREBIND_CKSUM)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LOAD_WEAK_DYLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SEGMENT_64)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_ROUTINES_64)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_UUID)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_RPATH)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_CODE_SIGNATURE)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SEGMENT_SPLIT_INFO)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_REEXPORT_DYLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LAZY_LOAD_DYLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_ENCRYPTION_INFO)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DYLD_INFO)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DYLD_INFO_ONLY)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LOAD_UPWARD_DYLIB)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_VERSION_MIN_MACOSX)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_VERSION_MIN_IPHONEOS)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_FUNCTION_STARTS)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DYLD_ENVIRONMENT)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_MAIN)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DATA_IN_CODE)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_SOURCE_VERSION)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DYLIB_CODE_SIGN_DRS)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_ENCRYPTION_INFO_64)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LINKER_OPTION)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_LINKER_OPTIMIZATION_HINT)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_VERSION_MIN_TVOS)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_VERSION_MIN_WATCHOS)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_NOTE)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_BUILD_VERSION)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DYLD_EXPORTS_TRIE)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_DYLD_CHAINED_FIXUPS)) .value(PY_ENUM(LIEF::MachO::LOAD_COMMAND_TYPES::LC_FILESET_ENTRY)); LIEF::enum_(m, "SECTION_TYPES") .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_REGULAR)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_ZEROFILL)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_CSTRING_LITERALS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_4BYTE_LITERALS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_8BYTE_LITERALS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_LITERAL_POINTERS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_NON_LAZY_SYMBOL_POINTERS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_LAZY_SYMBOL_POINTERS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_SYMBOL_STUBS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_MOD_INIT_FUNC_POINTERS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_MOD_TERM_FUNC_POINTERS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_COALESCED)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_GB_ZEROFILL)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_INTERPOSING)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_16BYTE_LITERALS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_DTRACE_DOF)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_LAZY_DYLIB_SYMBOL_POINTERS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_THREAD_LOCAL_REGULAR)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_THREAD_LOCAL_ZEROFILL)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_THREAD_LOCAL_VARIABLES)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_THREAD_LOCAL_VARIABLE_POINTERS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_TYPES::S_THREAD_LOCAL_INIT_FUNCTION_POINTERS)); LIEF::enum_(m, "X86_RELOCATION") .value(PY_ENUM(LIEF::MachO::X86_RELOCATION::GENERIC_RELOC_VANILLA)) .value(PY_ENUM(LIEF::MachO::X86_RELOCATION::GENERIC_RELOC_PAIR)) .value(PY_ENUM(LIEF::MachO::X86_RELOCATION::GENERIC_RELOC_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::X86_RELOCATION::GENERIC_RELOC_PB_LA_PTR)) .value(PY_ENUM(LIEF::MachO::X86_RELOCATION::GENERIC_RELOC_LOCAL_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::X86_RELOCATION::GENERIC_RELOC_TLV)); LIEF::enum_(m, "X86_64_RELOCATION") .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_UNSIGNED)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_SIGNED)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_BRANCH)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_GOT_LOAD)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_GOT)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_SUBTRACTOR)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_SIGNED_1)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_SIGNED_2)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_SIGNED_4)) .value(PY_ENUM(LIEF::MachO::X86_64_RELOCATION::X86_64_RELOC_TLV)); LIEF::enum_(m, "PPC_RELOCATION") .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_VANILLA)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_PAIR)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_BR14)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_BR24)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_HI16)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_LO16)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_HA16)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_LO14)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_PB_LA_PTR)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_HI16_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_LO16_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_HA16_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_JBSR)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_LO14_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::PPC_RELOCATION::PPC_RELOC_LOCAL_SECTDIFF)); LIEF::enum_(m, "ARM_RELOCATION") .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_VANILLA)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_PAIR)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_LOCAL_SECTDIFF)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_PB_LA_PTR)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_BR24)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_THUMB_RELOC_BR22)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_THUMB_32BIT_BRANCH)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_HALF)) .value(PY_ENUM(LIEF::MachO::ARM_RELOCATION::ARM_RELOC_HALF_SECTDIFF)); LIEF::enum_(m, "ARM64_RELOCATION") .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_UNSIGNED)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_SUBTRACTOR)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_BRANCH26)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_PAGE21)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_PAGEOFF12)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_GOT_LOAD_PAGE21)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_GOT_LOAD_PAGEOFF12)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_POINTER_TO_GOT)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_TLVP_LOAD_PAGE21)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_TLVP_LOAD_PAGEOFF12)) .value(PY_ENUM(LIEF::MachO::ARM64_RELOCATION::ARM64_RELOC_ADDEND)); LIEF::enum_(m, "RELOCATION_ORIGINS") .value(PY_ENUM(LIEF::MachO::RELOCATION_ORIGINS::ORIGIN_UNKNOWN)) .value(PY_ENUM(LIEF::MachO::RELOCATION_ORIGINS::ORIGIN_DYLDINFO)) .value(PY_ENUM(LIEF::MachO::RELOCATION_ORIGINS::ORIGIN_RELOC_TABLE)) .value(PY_ENUM(LIEF::MachO::RELOCATION_ORIGINS::ORIGIN_CHAINED_FIXUPS)); LIEF::enum_(m, "REBASE_TYPES") .value(PY_ENUM(LIEF::MachO::REBASE_TYPES::REBASE_TYPE_POINTER)) .value(PY_ENUM(LIEF::MachO::REBASE_TYPES::REBASE_TYPE_TEXT_ABSOLUTE32)) .value(PY_ENUM(LIEF::MachO::REBASE_TYPES::REBASE_TYPE_TEXT_PCREL32)); LIEF::enum_(m, "BINDING_CLASS") .value(PY_ENUM(LIEF::MachO::BINDING_CLASS::BIND_CLASS_WEAK)) .value(PY_ENUM(LIEF::MachO::BINDING_CLASS::BIND_CLASS_LAZY)) .value(PY_ENUM(LIEF::MachO::BINDING_CLASS::BIND_CLASS_STANDARD)) .value(PY_ENUM(LIEF::MachO::BINDING_CLASS::BIND_CLASS_THREADED)); LIEF::enum_(m, "REBASE_OPCODES") .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_DONE)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_SET_TYPE_IMM)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_SET_SEGMENT_AND_OFFSET_ULEB)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_ADD_ADDR_ULEB)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_ADD_ADDR_IMM_SCALED)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_DO_REBASE_IMM_TIMES)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_DO_REBASE_ULEB_TIMES)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_DO_REBASE_ADD_ADDR_ULEB)) .value(PY_ENUM(LIEF::MachO::REBASE_OPCODES::REBASE_OPCODE_DO_REBASE_ULEB_TIMES_SKIPPING_ULEB)); LIEF::enum_(m, "BIND_TYPES") .value(PY_ENUM(LIEF::MachO::BIND_TYPES::BIND_TYPE_POINTER)) .value(PY_ENUM(LIEF::MachO::BIND_TYPES::BIND_TYPE_TEXT_ABSOLUTE32)) .value(PY_ENUM(LIEF::MachO::BIND_TYPES::BIND_TYPE_TEXT_PCREL32)); LIEF::enum_(m, "BIND_SPECIAL_DYLIB") .value(PY_ENUM(LIEF::MachO::BIND_SPECIAL_DYLIB::BIND_SPECIAL_DYLIB_SELF)) .value(PY_ENUM(LIEF::MachO::BIND_SPECIAL_DYLIB::BIND_SPECIAL_DYLIB_MAIN_EXECUTABLE)) .value(PY_ENUM(LIEF::MachO::BIND_SPECIAL_DYLIB::BIND_SPECIAL_DYLIB_FLAT_LOOKUP)); LIEF::enum_(m, "BIND_OPCODES") .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_DONE)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_SET_DYLIB_ORDINAL_IMM)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_SET_DYLIB_ORDINAL_ULEB)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_SET_DYLIB_SPECIAL_IMM)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_SET_SYMBOL_TRAILING_FLAGS_IMM)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_SET_TYPE_IMM)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_SET_ADDEND_SLEB)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_SET_SEGMENT_AND_OFFSET_ULEB)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_ADD_ADDR_ULEB)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_DO_BIND)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_DO_BIND_ADD_ADDR_ULEB)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_DO_BIND_ADD_ADDR_IMM_SCALED)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_DO_BIND_ULEB_TIMES_SKIPPING_ULEB)) .value(PY_ENUM(LIEF::MachO::BIND_OPCODES::BIND_OPCODE_THREADED)); LIEF::enum_(m, "EXPORT_SYMBOL_KINDS") .value(PY_ENUM(LIEF::MachO::EXPORT_SYMBOL_KINDS::EXPORT_SYMBOL_FLAGS_KIND_REGULAR)) .value(PY_ENUM(LIEF::MachO::EXPORT_SYMBOL_KINDS::EXPORT_SYMBOL_FLAGS_KIND_THREAD_LOCAL)) .value(PY_ENUM(LIEF::MachO::EXPORT_SYMBOL_KINDS::EXPORT_SYMBOL_FLAGS_KIND_ABSOLUTE)); py::enum_(m, "EXPORT_SYMBOL_FLAGS") .value(PY_ENUM(LIEF::MachO::EXPORT_SYMBOL_FLAGS::EXPORT_SYMBOL_FLAGS_WEAK_DEFINITION)) .value(PY_ENUM(LIEF::MachO::EXPORT_SYMBOL_FLAGS::EXPORT_SYMBOL_FLAGS_REEXPORT)) .value(PY_ENUM(LIEF::MachO::EXPORT_SYMBOL_FLAGS::EXPORT_SYMBOL_FLAGS_STUB_AND_RESOLVER)); LIEF::enum_(m, "VM_PROTECTIONS") .value(PY_ENUM(LIEF::MachO::VM_PROTECTIONS::VM_PROT_READ)) .value(PY_ENUM(LIEF::MachO::VM_PROTECTIONS::VM_PROT_WRITE)) .value(PY_ENUM(LIEF::MachO::VM_PROTECTIONS::VM_PROT_EXECUTE)); LIEF::enum_(m, "SYMBOL_ORIGINS") .value(PY_ENUM(LIEF::MachO::SYMBOL_ORIGINS::SYM_ORIGIN_UNKNOWN)) .value(PY_ENUM(LIEF::MachO::SYMBOL_ORIGINS::SYM_ORIGIN_DYLD_EXPORT)) .value(PY_ENUM(LIEF::MachO::SYMBOL_ORIGINS::SYM_ORIGIN_LC_SYMTAB)); LIEF::enum_(m, "SECTION_FLAGS") .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_PURE_INSTRUCTIONS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_NO_TOC)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_STRIP_STATIC_SYMS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_NO_DEAD_STRIP)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_LIVE_SUPPORT)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_SELF_MODIFYING_CODE)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_DEBUG)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_SOME_INSTRUCTIONS)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_EXT_RELOC)) .value(PY_ENUM(LIEF::MachO::MACHO_SECTION_FLAGS::S_ATTR_LOC_RELOC)); LIEF::enum_(m, "DYLD_CHAINED_FORMAT") .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_FORMAT::IMPORT)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_FORMAT::IMPORT_ADDEND)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_FORMAT::IMPORT_ADDEND64)); LIEF::enum_(m, "DYLD_CHAINED_PTR_FORMAT") .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_ARM64E)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_64)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_32)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_32_CACHE)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_32_FIRMWARE)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_64_OFFSET)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_ARM64E_KERNEL)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_64_KERNEL_CACHE)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_ARM64E_USERLAND)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_ARM64E_FIRMWARE)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_X86_64_KERNEL_CACHE)) .value(PY_ENUM(LIEF::MachO::DYLD_CHAINED_PTR_FORMAT::PTR_ARM64E_USERLAND24)); } } } LIEF-0.13.1/api/python/src/MachO/pyMachO.cpp000066400000000000000000000042371443457337100202500ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "pyMachO.hpp" namespace LIEF { namespace MachO { void init_python_module(py::module& m) { py::module LIEF_MachO_module = m.def_submodule("MachO", "Python API for the MachO format"); init_enums(LIEF_MachO_module); init_objects(LIEF_MachO_module); init_utils(LIEF_MachO_module); } void init_objects(py::module& m) { CREATE(ParserConfig, m); CREATE(Parser, m); CREATE(FatBinary, m); CREATE(Binary, m); CREATE(Header, m); CREATE(LoadCommand, m); CREATE(UUIDCommand, m); CREATE(SymbolCommand, m); CREATE(SegmentCommand, m); CREATE(Section, m); CREATE(MainCommand, m); CREATE(DynamicSymbolCommand, m); CREATE(DylinkerCommand, m); CREATE(DyldInfo, m); CREATE(DyldChainedFixups, m); CREATE(DyldExportsTrie, m); CREATE(DylibCommand, m); CREATE(ThreadCommand, m); CREATE(RPathCommand, m); CREATE(Symbol, m); CREATE(Relocation, m); CREATE(RelocationObject, m); CREATE(RelocationDyld, m); CREATE(RelocationFixup, m); CREATE(BindingInfo, m); CREATE(DyldBindingInfo, m); CREATE(ExportInfo, m); CREATE(FunctionStarts, m); CREATE(CodeSignature, m); CREATE(CodeSignatureDir, m); CREATE(DataInCode, m); CREATE(DataCodeEntry, m); CREATE(SourceVersion, m); CREATE(VersionMin, m); CREATE(SegmentSplitInfo, m); CREATE(SubFramework, m); CREATE(DyldEnvironment, m); CREATE(EncryptionInfo, m); CREATE(BuildVersion, m); CREATE(FilesetCommand, m); CREATE(ChainedBindingInfo, m); CREATE(TwoLevelHints, m); CREATE(LinkerOptHint, m); CREATE(Builder, m); } } } LIEF-0.13.1/api/python/src/MachO/pyMachO.hpp000066400000000000000000000060441443457337100202530ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_MACHO_H_ #define PY_LIEF_MACHO_H_ #include "LIEF/MachO/Parser.hpp" #include "LIEF/MachO/Binary.hpp" #include "LIEF/MachO/Builder.hpp" #include "LIEF/MachO/BindingInfo.hpp" #include "LIEF/MachO/ChainedBindingInfo.hpp" #include "LIEF/MachO/DataInCode.hpp" #include "LIEF/MachO/DyldBindingInfo.hpp" #include "LIEF/MachO/FilesetCommand.hpp" #include "LIEF/MachO/RelocationDyld.hpp" #include "LIEF/MachO/RelocationFixup.hpp" #include "LIEF/MachO/RelocationObject.hpp" #include #include #include "pyLIEF.hpp" #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) namespace LIEF { namespace MachO { template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_enums(py::module&); void init_utils(py::module&); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(ParserConfig); SPECIALIZE_CREATE(Binary); SPECIALIZE_CREATE(BindingInfo); SPECIALIZE_CREATE(BuildVersion); SPECIALIZE_CREATE(ChainedBindingInfo); SPECIALIZE_CREATE(CodeSignature); SPECIALIZE_CREATE(CodeSignatureDir); SPECIALIZE_CREATE(DataCodeEntry); SPECIALIZE_CREATE(DataInCode); SPECIALIZE_CREATE(DyldBindingInfo); SPECIALIZE_CREATE(DyldChainedFixups); SPECIALIZE_CREATE(DyldEnvironment); SPECIALIZE_CREATE(DyldExportsTrie); SPECIALIZE_CREATE(DyldInfo); SPECIALIZE_CREATE(DylibCommand); SPECIALIZE_CREATE(DylinkerCommand); SPECIALIZE_CREATE(DynamicSymbolCommand); SPECIALIZE_CREATE(EncryptionInfo); SPECIALIZE_CREATE(ExportInfo); SPECIALIZE_CREATE(FatBinary); SPECIALIZE_CREATE(FilesetCommand); SPECIALIZE_CREATE(FunctionStarts); SPECIALIZE_CREATE(Header); SPECIALIZE_CREATE(LinkerOptHint); SPECIALIZE_CREATE(LoadCommand); SPECIALIZE_CREATE(MainCommand); SPECIALIZE_CREATE(RPathCommand); SPECIALIZE_CREATE(Relocation); SPECIALIZE_CREATE(RelocationDyld); SPECIALIZE_CREATE(RelocationFixup); SPECIALIZE_CREATE(RelocationObject); SPECIALIZE_CREATE(Section); SPECIALIZE_CREATE(SegmentCommand); SPECIALIZE_CREATE(SegmentSplitInfo); SPECIALIZE_CREATE(SourceVersion); SPECIALIZE_CREATE(SubFramework); SPECIALIZE_CREATE(Symbol); SPECIALIZE_CREATE(SymbolCommand); SPECIALIZE_CREATE(ThreadCommand); SPECIALIZE_CREATE(TwoLevelHints); SPECIALIZE_CREATE(UUIDCommand); SPECIALIZE_CREATE(VersionMin); SPECIALIZE_CREATE(Builder); } } // Opaque containers PYBIND11_MAKE_OPAQUE(std::vector) #endif LIEF-0.13.1/api/python/src/MachO/pyUtils.cpp000066400000000000000000000041741443457337100203610ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyMachO.hpp" #include "LIEF/MachO/utils.hpp" #include "LIEF/MachO/FatBinary.hpp" namespace LIEF { namespace MachO { void init_utils(py::module& m) { m.def("is_macho", static_cast(&is_macho), "Check if the given file is a ``MachO`` (from filename)", "filename"_a); m.def("is_macho", static_cast&)>(&is_macho), "Check if the given raw data is a ``MachO``", "raw"_a); m.def("is_fat", &is_fat, "Check if the given Mach-O is fat", "file"_a); m.def("is_64", &is_64, "Check if the given Mach-O is 64-bits", "file"_a); m.def("check_layout", [] (const Binary& bin) { std::string on_error; bool is_valid = check_layout(bin, &on_error); return std::pair{is_valid, on_error}; }, "Check the layout of the given Mach-O binary. It checks if it can be signed " "according to ``cctools-921/libstuff/checkout.c``", "file"_a); m.def("check_layout", [] (const FatBinary& bin) { std::string on_error; bool is_valid = check_layout(bin, &on_error); return std::pair{is_valid, on_error}; }, R"delim( Check the layout of the given FAT Mach-O by checking individually the layout of the binaries embedded in the FAT. )delim", "file"_a); } } // namespace Mach-O } LIEF-0.13.1/api/python/src/OAT/000077500000000000000000000000001443457337100156325ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/OAT/CMakeLists.txt000066400000000000000000000017341443457337100203770ustar00rootroot00000000000000set(LIEF_PYTHON_OAT_OBJECTS_SRC "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDexFile.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyClass.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyMethod.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBinary.cpp" ) set(LIEF_PYTHON_OAT_SRC "${CMAKE_CURRENT_LIST_DIR}/pyOAT.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyEnums.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyUtils.cpp" ) set(LIEF_PYTHON_OAT_HDR "${CMAKE_CURRENT_LIST_DIR}/pyOAT.hpp") list(APPEND LIEF_PYTHON_OAT_SRC ${LIEF_PYTHON_OAT_OBJECTS_SRC}) source_group("Source Files\\OAT" FILES ${LIEF_PYTHON_OAT_SRC}) source_group("Header Files\\OAT" FILES ${LIEF_PYTHON_OAT_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_OAT_SRC}" "${LIEF_PYTHON_OAT_HDR}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}" "${CMAKE_CURRENT_LIST_DIR}/../") LIEF-0.13.1/api/python/src/OAT/objects/000077500000000000000000000000001443457337100172635ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/OAT/objects/pyBinary.cpp000066400000000000000000000070231443457337100215660ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/OAT/Binary.hpp" #include "LIEF/OAT/hash.hpp" #include "LIEF/ELF/Binary.hpp" #include "pyIterators.hpp" #include "pyOAT.hpp" namespace LIEF { namespace OAT { template using no_const_getter = T (Binary::*)(); template using no_const_func = T (Binary::*)(P); template using getter_t = T (Binary::*)() const; template using setter_t = void (Binary::*)(T); template<> void create(py::module& m) { // Binary object py::class_ bin(m, "Binary", "OAT binary representation"); init_ref_iterator(bin, "it_dex_files"); init_ref_iterator(bin, "it_oat_dex_files"); init_ref_iterator(bin, "it_classes"); init_ref_iterator(bin, "it_methods"); bin .def_property_readonly("header", static_cast>(&Binary::header), "Return the OAT " RST_CLASS_REF(lief.OAT.Header) "", py::return_value_policy::reference) .def_property_readonly("dex_files", static_cast>(&Binary::dex_files), "Return an iterator over " RST_CLASS_REF(lief.DEX.File) "") .def_property_readonly("oat_dex_files", static_cast>(&Binary::oat_dex_files), "Return an iterator over " RST_CLASS_REF(lief.OAT.DexFile) "") .def_property_readonly("classes", static_cast>(&Binary::classes), "Return an iterator over " RST_CLASS_REF(lief.OAT.Class) "", py::return_value_policy::reference) .def_property_readonly("methods", static_cast>(&Binary::methods), "Return an iterator over " RST_CLASS_REF(lief.OAT.Method) "", py::return_value_policy::reference) .def_property_readonly("has_class", &Binary::has_class, "Check if the class if the given name is present in the current OAT binary") .def("get_class", static_cast>(&Binary::get_class), "Return the " RST_CLASS_REF(lief.OAT.Class) " from its name", "class_name"_a, py::return_value_policy::reference) .def("get_class", static_cast>(&Binary::get_class), "Return the " RST_CLASS_REF(lief.OAT.Class) " from its **index**", "class_index"_a, py::return_value_policy::reference) .def_property_readonly("dex2dex_json_info", &Binary::dex2dex_json_info) .def("__eq__", &Binary::operator==) .def("__ne__", &Binary::operator!=) .def("__hash__", [] (const Binary& bin) { return Hash::hash(bin); }) .def("__str__", [] (const Binary& binary) { std::ostringstream stream; stream << binary; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/OAT/objects/pyClass.cpp000066400000000000000000000064011443457337100214060ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/OAT/Class.hpp" #include "LIEF/OAT/hash.hpp" #include "pyIterators.hpp" #include "pyOAT.hpp" namespace LIEF { namespace OAT { template using getter_t = T (Class::*)(void) const; template using setter_t = void (Class::*)(T); template using no_const_getter = T (Class::*)(void); template<> void create(py::module& m) { py::class_ cls(m, "Class", "OAT Class representation"); init_ref_iterator(cls, "it_methods"); cls .def(py::init<>()) .def("has_dex_class", &Class::has_dex_class, "True if a " RST_CLASS_REF_FULL(lief.DEX.Class) " object " "is associated with this **OAT** Class") .def_property_readonly("status", &Class::status, "Class " RST_CLASS_REF(lief.OAT.OAT_CLASS_STATUS) "") .def_property_readonly("type", &Class::type, "Information (" RST_CLASS_REF(lief.OAT.OAT_CLASS_TYPES) ") about how methods " "are optimized") .def_property_readonly("fullname", &Class::fullname, "Class mangled name (e.g. ``Lcom/android/MyActivity;``)") .def_property_readonly("index", &Class::index, "Index the **DEX** classes pool (" RST_ATTR_REF_FULL(lief.DEX.File.classes) ")") .def_property_readonly("methods", static_cast>(&Class::methods), "Iterator over " RST_CLASS_REF_FULL(lief.OAT.Method) "") .def_property_readonly("bitmap", &Class::bitmap, "Bitmap information used to quickly find which methods are " "optimized") .def("is_quickened", static_cast(&Class::is_quickened), "Check if the given " RST_CLASS_REF_FULL(lief.DEX.Method) " is compiled into native code", "dex_method"_a) .def("is_quickened", static_cast(&Class::is_quickened), "Check if the Method at the given index is compiled into native code", "method_index"_a) .def("method_offsets_index", static_cast(&Class::method_offsets_index)) .def("method_offsets_index", static_cast(&Class::method_offsets_index)) .def("__eq__", &Class::operator==) .def("__ne__", &Class::operator!=) .def("__hash__", [] (const Class& cls) { return Hash::hash(cls); }) .def("__str__", [] (const Class& cls) { std::ostringstream stream; stream << cls; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/OAT/objects/pyDexFile.cpp000066400000000000000000000046311443457337100216640ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/OAT/DexFile.hpp" #include "LIEF/OAT/hash.hpp" #include "LIEF/DEX/File.hpp" #include "pyOAT.hpp" namespace LIEF { namespace OAT { template using getter_t = T (DexFile::*)(void) const; template using setter_t = void (DexFile::*)(T); template using no_const_getter = T (DexFile::*)(void); template<> void create(py::module& m) { py::class_(m, "DexFile", "OAT DexFile representation") .def(py::init<>()) .def_property("location", static_cast>(&DexFile::location), static_cast>(&DexFile::location), "Original location of the DEX file") .def_property("checksum", static_cast>(&DexFile::checksum), static_cast>(&DexFile::checksum), "Checksum of the underlying DEX file") .def_property("dex_offset", static_cast>(&DexFile::dex_offset), static_cast>(&DexFile::dex_offset), "Offset to the raw " RST_CLASS_REF_FULL(lief.DEX.File) "") .def_property_readonly("has_dex_file", &DexFile::has_dex_file, "Check if the " RST_CLASS_REF_FULL(lief.DEX.File) " is present") .def_property_readonly("dex_file", static_cast>(&DexFile::dex_file), "Associated " RST_CLASS_REF_FULL(lief.DEX.File) "") .def("__eq__", &DexFile::operator==) .def("__ne__", &DexFile::operator!=) .def("__hash__", [] (const DexFile& dex_file) { return Hash::hash(dex_file); }) .def("__str__", [] (const DexFile& dexfile) { std::ostringstream stream; stream << dexfile; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/OAT/objects/pyHeader.cpp000066400000000000000000000155561443457337100215440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/OAT/Header.hpp" #include "LIEF/OAT/hash.hpp" #include "pyOAT.hpp" namespace LIEF { namespace OAT { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template using no_const_getter = T (Header::*)(void); template<> void create
(py::module& m) { py::class_ hdr(m, "Header", "OAT Header representation"); py::class_ it_key_values_t(hdr, "it_key_values_t"); py::class_(it_key_values_t, "value_type") .def_property_readonly("key", [] (Header::it_key_values_t::reference p) { return p.first; }, py::return_value_policy::reference_internal) .def_property("value", [] (Header::it_key_values_t::reference p) { return p.second; }, [] (Header::it_key_values_t::reference p, const std::string& value) { std::string& ref_value = p.second; ref_value = value; }, py::return_value_policy::reference_internal); it_key_values_t .def("__getitem__", [] (Header::it_key_values_t& v, size_t i) -> Header::it_key_values_t::value_type { if (i >= v.size()) throw py::index_error(); return v[i]; }, py::return_value_policy::reference_internal) .def("__len__", [](Header::it_key_values_t& v) { return v.size(); }) .def("__iter__", [](Header::it_key_values_t& v) -> Header::it_key_values_t { return std::begin(v); }, py::return_value_policy::reference_internal) .def("__next__", [] (Header::it_key_values_t& v) -> Header::it_key_values_t::value_type { if (v == std::end(v)) { throw py::stop_iteration(); } return *(v++); }, py::return_value_policy::reference_internal); hdr .def(py::init<>()) .def_property_readonly("key_values", static_cast>(&Header::key_values), "Configuration used for the ``dex2oat`` transformation", py::return_value_policy::reference_internal) .def_property_readonly("keys", &Header::keys, "List of " RST_CLASS_REF(lief.OAT.HEADER_KEYS) " present", py::return_value_policy::reference_internal) .def_property_readonly("values", &Header::values, "List of values associated with " RST_ATTR_REF(lief.OAT.Header.keys) "", py::return_value_policy::move) .def_property_readonly("magic", static_cast>(&Header::magic), "Magic number which shoud be ``oat\\x0A``") .def_property_readonly("version", static_cast>(&Header::version), "Underlying version of the OAT file") .def_property_readonly("checksum", static_cast>(&Header::checksum), "Checksum of the OAT file") .def_property_readonly("instruction_set", static_cast>(&Header::instruction_set), "List of " RST_CLASS_REF(lief.OAT.INSTRUCTION_SETS) "") .def_property_readonly("nb_dex_files", static_cast>(&Header::nb_dex_files), "Number of " RST_CLASS_REF_FULL(lief.DEX.File) " registred in the current OAT") .def_property_readonly("oat_dex_files_offset", static_cast>(&Header::oat_dex_files_offset), "Offset to the raw " RST_CLASS_REF_FULL(lief.OAT.DexFile) "\n\n" ".. warning::\n\n" "\tThis attribute is only relevant for OAT for which the version is above 131") .def_property_readonly("executable_offset", static_cast>(&Header::executable_offset)) .def_property_readonly("i2i_bridge_offset", static_cast>(&Header::i2i_bridge_offset)) .def_property_readonly("i2c_code_bridge_offset", static_cast>(&Header::i2c_code_bridge_offset)) .def_property_readonly("jni_dlsym_lookup_offset", static_cast>(&Header::jni_dlsym_lookup_offset)) .def_property_readonly("quick_generic_jni_trampoline_offset", static_cast>(&Header::quick_generic_jni_trampoline_offset)) .def_property_readonly("quick_imt_conflict_trampoline_offset", static_cast>(&Header::quick_imt_conflict_trampoline_offset)) .def_property_readonly("quick_resolution_trampoline_offset", static_cast>(&Header::quick_resolution_trampoline_offset)) .def_property_readonly("quick_to_interpreter_bridge_offset", static_cast>(&Header::quick_to_interpreter_bridge_offset)) .def_property_readonly("image_patch_delta", static_cast>(&Header::image_patch_delta)) .def_property_readonly("image_file_location_oat_checksum", static_cast>(&Header::image_file_location_oat_checksum)) .def_property_readonly("image_file_location_oat_data_begin", static_cast>(&Header::image_file_location_oat_data_begin)) .def_property_readonly("key_value_size", static_cast>(&Header::key_value_size)) .def("get", static_cast(&Header::get), "key"_a, py::return_value_policy::reference) .def("set", static_cast(&Header::set), "key"_a, "value"_a, py::return_value_policy::reference) .def("__getitem__", static_cast(&Header::operator[]), "", py::return_value_policy::reference) .def("__setitem__", static_cast(&Header::set), "", py::return_value_policy::reference) .def("__eq__", &Header::operator==) .def("__ne__", &Header::operator!=) .def("__hash__", [] (const Header& header) { return Hash::hash(header); }) .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/OAT/objects/pyMethod.cpp000066400000000000000000000053211443457337100215610ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/OAT/Method.hpp" #include "LIEF/OAT/hash.hpp" #include "LIEF/DEX/Method.hpp" #include "pyOAT.hpp" namespace LIEF { namespace OAT { template using getter_t = T (Method::*)(void) const; template using setter_t = void (Method::*)(T); template using no_const_getter = T (Method::*)(void); template<> void create(py::module& m) { py::class_(m, "Method", "OAT Method representation") .def(py::init<>()) .def_property_readonly("name", &Method::name, "Method's name") .def_property_readonly("oat_class", static_cast>(&Method::oat_class), "" RST_CLASS_REF(lief.OAT.Class) " associated with the method (or None)", py::return_value_policy::reference) .def_property_readonly("dex_method", static_cast>(&Method::dex_method), "Mirrored " RST_CLASS_REF(lief.DEX.Method) " associated with the OAT method (or None)", py::return_value_policy::reference) .def_property_readonly("has_dex_method", &Method::has_dex_method, "Check if a " RST_CLASS_REF(lief.DEX.Method) " is associated with the OAT method", py::return_value_policy::reference) .def_property_readonly("is_dex2dex_optimized", &Method::is_dex2dex_optimized, "True if the optimization is **DEX**") .def_property_readonly("is_compiled", &Method::is_compiled, "True if the optimization is **native**") .def_property("quick_code", static_cast>(&Method::quick_code), static_cast>(&Method::quick_code), "Quick code associated with the method") .def("__eq__", &Method::operator==) .def("__ne__", &Method::operator!=) .def("__hash__", [] (const Method& method) { return Hash::hash(method); }) .def("__str__", [] (const Method& method) { std::ostringstream stream; stream << method; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/OAT/objects/pyParser.cpp000066400000000000000000000053261443457337100216020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyOAT.hpp" #include "LIEF/OAT/Parser.hpp" #include namespace LIEF { namespace OAT { template<> void create(py::module& m) { // Parser (Parser) m.def("parse", static_cast (*) (const std::string&)>(&Parser::parse), "Parse the given OAT file and return a " RST_CLASS_REF(lief.OAT.Binary) " object", "oat_file"_a, py::return_value_policy::take_ownership); m.def("parse", static_cast (*) (const std::string&, const std::string&)>(&Parser::parse), "Parse the given OAT with its VDEX file and return a " RST_CLASS_REF(lief.OAT.Binary) " object", "oat_file"_a, "vdex_file"_a, py::return_value_policy::take_ownership); m.def("parse", static_cast (*) (std::vector, const std::string&)>(&Parser::parse), "Parse the given raw data and return a " RST_CLASS_REF(lief.OAT.Binary) " object", "raw"_a, "name"_a = "", py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, const std::string& name) { const auto& io = py::module::import("io"); const auto& RawIOBase = io.attr("RawIOBase"); const auto& BufferedIOBase = io.attr("BufferedIOBase"); const auto& TextIOBase = io.attr("TextIOBase"); py::object rawio; if (py::isinstance(byteio, RawIOBase)) { rawio = byteio; } else if (py::isinstance(byteio, BufferedIOBase)) { rawio = byteio.attr("raw"); } else if (py::isinstance(byteio, TextIOBase)) { rawio = byteio.attr("buffer").attr("raw"); } else { throw py::type_error(py::repr(byteio).cast().c_str()); } std::string raw_str = static_cast(rawio.attr("readall")()); std::vector raw = { std::make_move_iterator(std::begin(raw_str)), std::make_move_iterator(std::end(raw_str))}; return LIEF::OAT::Parser::parse(std::move(raw), name); }, "io"_a, "name"_a = "", py::return_value_policy::take_ownership); } } } LIEF-0.13.1/api/python/src/OAT/pyEnums.cpp000066400000000000000000000056401443457337100200030ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyOAT.hpp" #include "LIEF/OAT/enums.hpp" #include "LIEF/OAT/EnumToString.hpp" #define PY_ENUM(x) to_string(x), x namespace LIEF { namespace OAT { void init_enums(py::module& m) { py::enum_(m, "OAT_CLASS_TYPES") .value(PY_ENUM(OAT_CLASS_TYPES::OAT_CLASS_ALL_COMPILED)) .value(PY_ENUM(OAT_CLASS_TYPES::OAT_CLASS_SOME_COMPILED)) .value(PY_ENUM(OAT_CLASS_TYPES::OAT_CLASS_NONE_COMPILED)); py::enum_(m, "OAT_CLASS_STATUS") .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_RETIRED)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_ERROR)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_NOTREADY)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_IDX)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_LOADED)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_RESOLVING)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_RESOLVED)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_VERIFYING)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_RETRY_VERIFICATION_AT_RUNTIME)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_VERIFYING_AT_RUNTIME)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_VERIFIED)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_INITIALIZING)) .value(PY_ENUM(OAT_CLASS_STATUS::STATUS_INITIALIZED)); py::enum_(m, "HEADER_KEYS") .value(PY_ENUM(HEADER_KEYS::KEY_IMAGE_LOCATION)) .value(PY_ENUM(HEADER_KEYS::KEY_DEX2OAT_CMD_LINE)) .value(PY_ENUM(HEADER_KEYS::KEY_DEX2OAT_HOST)) .value(PY_ENUM(HEADER_KEYS::KEY_PIC)) .value(PY_ENUM(HEADER_KEYS::KEY_HAS_PATCH_INFO)) .value(PY_ENUM(HEADER_KEYS::KEY_DEBUGGABLE)) .value(PY_ENUM(HEADER_KEYS::KEY_NATIVE_DEBUGGABLE)) .value(PY_ENUM(HEADER_KEYS::KEY_COMPILER_FILTER)) .value(PY_ENUM(HEADER_KEYS::KEY_CLASS_PATH)) .value(PY_ENUM(HEADER_KEYS::KEY_BOOT_CLASS_PATH)) .value(PY_ENUM(HEADER_KEYS::KEY_CONCURRENT_COPYING)); py::enum_(m, "INSTRUCTION_SETS") .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_NONE)) .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_ARM)) .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_ARM_64)) .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_THUMB2)) .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_X86)) .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_X86_64)) .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_MIPS)) .value(PY_ENUM(INSTRUCTION_SETS::INST_SET_MIPS_64)); } } } LIEF-0.13.1/api/python/src/OAT/pyOAT.cpp000066400000000000000000000020711443457337100173320ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyOAT.hpp" namespace LIEF { namespace OAT { void init_python_module(py::module& m) { py::module LIEF_OAT_module = m.def_submodule("OAT", "Python API for OAT format"); init_enums(LIEF_OAT_module); init_utils(LIEF_OAT_module); init_objects(LIEF_OAT_module); } void init_objects(py::module& m) { CREATE(Parser, m); CREATE(Binary, m); CREATE(Header, m); CREATE(DexFile, m); CREATE(Class, m); CREATE(Method, m); } } } LIEF-0.13.1/api/python/src/OAT/pyOAT.hpp000066400000000000000000000026111443457337100173370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_OAT_H_ #define PY_LIEF_OAT_H_ #include "LIEF/OAT.hpp" #include "pyLIEF.hpp" #include #include #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) PYBIND11_MAKE_OPAQUE(LIEF::OAT::Header::it_key_values_t::value_type); // std::pair> namespace LIEF { namespace OAT { template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_enums(py::module&); void init_utils(py::module&); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(Binary); SPECIALIZE_CREATE(Header); SPECIALIZE_CREATE(DexFile); SPECIALIZE_CREATE(Class); SPECIALIZE_CREATE(Method); } } #endif LIEF-0.13.1/api/python/src/OAT/pyUtils.cpp000066400000000000000000000037101443457337100200100ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyOAT.hpp" #include "LIEF/OAT/utils.hpp" namespace LIEF { namespace OAT { void init_utils(py::module& m) { m.def("is_oat", static_cast(&is_oat), "Check if the " RST_CLASS_REF(lief.ELF.Binary) " given in parameter is an OAT", "binary"_a); m.def("is_oat", static_cast(&is_oat), "Check if the **file** given in parameter is an OAT", "path"_a); m.def("is_oat", static_cast&)>(&is_oat), "Check if the **raw data** given in parameter is an OAT", "raw"_a); m.def("version", static_cast(&version), "Return the OAT version of the " RST_CLASS_REF(lief.ELF.Binary) " given in parameter", "binary"_a); m.def("version", static_cast(&version), "Return the OAT version of the **file** given in parameter", "file"_a); m.def("version", static_cast&)>(&version), "Return the OAT version of the **raw data** given in parameter", "raw"_a); m.def("android_version", &android_version, "Return the " RST_CLASS_REF(lief.Android.ANDROID_VERSIONS) " associated with the given OAT version"); } } } LIEF-0.13.1/api/python/src/PE/000077500000000000000000000000001443457337100155135ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/PE/CMakeLists.txt000066400000000000000000000056711443457337100202640ustar00rootroot00000000000000set(LIEF_PYTHON_PE_SRC "${CMAKE_CURRENT_LIST_DIR}/pyUtils.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyResourceNode.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyResourceData.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyResourceDirectory.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceIcon.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceVersion.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceVarFileInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceFixedFileInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceStringFileInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyLangCodeItem.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceDialog.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceDialogItem.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceStringTable.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/resources/pyResourceAccelerator.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyCodeIntegrity.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDataDirectory.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDosHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRichHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRichEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBuilder.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyOptionalHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocationEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyBinary.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyResourcesManager.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDebug.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyCodeView.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyCodeViewPDB.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyPogo.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyPogoEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySection.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyExport.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyImport.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyExportEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyRelocation.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyImportEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDelayImport.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyDelayImportEntry.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pySymbol.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyTLS.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyEnums.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyPE.cpp" ) set(LIEF_PYTHON_PE_HDR "${CMAKE_CURRENT_LIST_DIR}/pyPE.hpp") source_group("Source Files\\PE" FILES ${LIEF_PYTHON_PE_SRC}) source_group("Header Files\\PE" FILES ${LIEF_PYTHON_PE_HDR}) target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}") target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_PE_SRC}" "${LIEF_PYTHON_PE_HDR}") include("${CMAKE_CURRENT_LIST_DIR}/objects/LoadConfigurations/CMakeLists.txt") include("${CMAKE_CURRENT_LIST_DIR}/objects/signature/CMakeLists.txt") LIEF-0.13.1/api/python/src/PE/objects/000077500000000000000000000000001443457337100171445ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/000077500000000000000000000000001443457337100227365ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/CMakeLists.txt000066400000000000000000000016531443457337100255030ustar00rootroot00000000000000set(LIEF_PYTHON_PE_LOAD_CONFIGURE_SRC "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfiguration.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV0.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV1.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV2.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV3.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV4.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV5.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV6.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV7.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV8.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV9.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV10.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyLoadConfigurationV11.cpp" ) source_group("Source Files\\PE\\Load Configuration" FILES ${LIEF_PYTHON_PE_LOAD_CONFIGURE_SRC}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_PE_LOAD_CONFIGURE_SRC}") LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfiguration.cpp000066400000000000000000000165151443457337100274320ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfiguration::*)(void) const; template using setter_t = void (LoadConfiguration::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfiguration", R"delim( Class that represents the default PE's ``LoadConfiguration`` It's the base class for any future versions of the structure )delim") .def(py::init<>()) .def_property_readonly("version", &LoadConfiguration::version, "(SDK) Version of the structure. (" RST_CLASS_REF(lief.PE.WIN_VERSION) ")") .def_property("characteristics", static_cast>(&LoadConfiguration::characteristics), static_cast>(&LoadConfiguration::characteristics), "Characteristics of the structure.") .def_property_readonly("size", static_cast>(&LoadConfiguration::size), "Size of the structure which is an alias for " RST_ATTR_REF(lief.PE.LoadConfiguration.characteristics) "") .def_property("timedatestamp", static_cast>(&LoadConfiguration::timedatestamp), static_cast>(&LoadConfiguration::timedatestamp), "Date and time stamp value") .def_property("major_version", static_cast>(&LoadConfiguration::major_version), static_cast>(&LoadConfiguration::major_version), "Major Version") .def_property("minor_version", static_cast>(&LoadConfiguration::minor_version), static_cast>(&LoadConfiguration::minor_version), "Minor version") .def_property("global_flags_clear", static_cast>(&LoadConfiguration::global_flags_clear), static_cast>(&LoadConfiguration::global_flags_clear), "The global loader flags to clear for this process as the loader start the process.") .def_property("global_flags_set", static_cast>(&LoadConfiguration::global_flags_set), static_cast>(&LoadConfiguration::global_flags_set), "The global loader flags to set for this process as the loader starts the process.") .def_property("critical_section_default_timeout", static_cast>(&LoadConfiguration::critical_section_default_timeout), static_cast>(&LoadConfiguration::critical_section_default_timeout), "The default timeout value to use for is process’s critical sections that are abandoned.") .def_property("decommit_free_block_threshold", static_cast>(&LoadConfiguration::decommit_free_block_threshold), static_cast>(&LoadConfiguration::decommit_free_block_threshold), "Memory that must be freed before it is returned to the system, in bytes.") .def_property("decommit_total_free_threshold", static_cast>(&LoadConfiguration::decommit_total_free_threshold), static_cast>(&LoadConfiguration::decommit_total_free_threshold), "Total amount of free memory, in bytes") .def_property("lock_prefix_table", static_cast>(&LoadConfiguration::lock_prefix_table), static_cast>(&LoadConfiguration::lock_prefix_table), "The **VA** of a list of addresses where the ``LOCK`` prefix " "is used so that they can be replaced with ``NOP`` on single processor machines.") .def_property("maximum_allocation_size", static_cast>(&LoadConfiguration::maximum_allocation_size), static_cast>(&LoadConfiguration::maximum_allocation_size), "Maximum allocation size, in bytes.") .def_property("virtual_memory_threshold", static_cast>(&LoadConfiguration::virtual_memory_threshold), static_cast>(&LoadConfiguration::virtual_memory_threshold), "Maximum virtual memory size, in bytes.") .def_property("process_affinity_mask", static_cast>(&LoadConfiguration::process_affinity_mask), static_cast>(&LoadConfiguration::process_affinity_mask), "Setting this field to a non-zero value is equivalent to calling " "``SetProcessAffinityMask`` with this value during process startup (.exe only)") .def_property("process_heap_flags", static_cast>(&LoadConfiguration::process_heap_flags), static_cast>(&LoadConfiguration::process_heap_flags), R"delim( Process heap flags that correspond to the first argument of the ``HeapCreate`` function. These flags apply to the process heap that is created during process startup. )delim") .def_property("csd_version", static_cast>(&LoadConfiguration::csd_version), static_cast>(&LoadConfiguration::csd_version), "The service pack version identifier.") .def_property("reserved1", static_cast>(&LoadConfiguration::reserved1), static_cast>(&LoadConfiguration::reserved1), "Must be zero.") .def_property("dependent_load_flags", static_cast>(&LoadConfiguration::dependent_load_flags), static_cast>(&LoadConfiguration::dependent_load_flags), "On recent the version of the structure, Microsoft renamed reserved1 to DependentLoadFlags. " "This is an alias for " RST_ATTR_REF(lief.PE.LoadConfiguration.reserved1) "") .def_property("editlist", static_cast>(&LoadConfiguration::editlist), static_cast>(&LoadConfiguration::editlist), "Reserved for use by the system.") .def_property("security_cookie", static_cast>(&LoadConfiguration::security_cookie), static_cast>(&LoadConfiguration::security_cookie), "A pointer to a cookie that is used by Visual C++ or GS implementation.") .def("__eq__", &LoadConfiguration::operator==) .def("__ne__", &LoadConfiguration::operator!=) .def("__hash__", [] (const LoadConfiguration& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfiguration& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV0.cpp000066400000000000000000000043621443457337100276350ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV0::*)(void) const; template using setter_t = void (LoadConfigurationV0::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV0", R"delim( :class:`~lief.PE.LoadConfiguration` enhanced with SEH. It is associated with the :class:`~lief.PE.WIN_VERSION`: :attr:`~lief.PE.WIN_VERSION.SEH` )delim") .def(py::init<>()) .def_property("se_handler_table", static_cast>(&LoadConfigurationV0::se_handler_table), static_cast>(&LoadConfigurationV0::se_handler_table), "The VA of the sorted table of RVAs of each valid, unique " "SE handler in the image.") .def_property("se_handler_count", static_cast>(&LoadConfigurationV0::se_handler_count), static_cast>(&LoadConfigurationV0::se_handler_count), "The count of unique handlers in the table.") .def("__eq__", &LoadConfigurationV0::operator==) .def("__ne__", &LoadConfigurationV0::operator!=) .def("__hash__", [] (const LoadConfigurationV0& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV0& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV1.cpp000066400000000000000000000076601443457337100276420ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV1::*)(void) const; template using setter_t = void (LoadConfigurationV1::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV1", R"delim( :class:`~lief.PE.LoadConfigurationV0` enhanced with *Control Flow Guard*. It is associated with the :class:`~lief.PE.WIN_VERSION` set to :attr:`~lief.PE.WIN_VERSION.WIN_8_1` )delim") .def(py::init<>()) .def_property("guard_cf_check_function_pointer", static_cast>(&LoadConfigurationV1::guard_cf_check_function_pointer), static_cast>(&LoadConfigurationV1::guard_cf_check_function_pointer), "The VA where Control Flow Guard check-function pointer is stored.") .def_property("guard_cf_dispatch_function_pointer", static_cast>(&LoadConfigurationV1::guard_cf_dispatch_function_pointer), static_cast>(&LoadConfigurationV1::guard_cf_dispatch_function_pointer), "The VA where Control Flow Guard dispatch-function pointer is stored.") .def_property("guard_cf_function_table", static_cast>(&LoadConfigurationV1::guard_cf_function_table), static_cast>(&LoadConfigurationV1::guard_cf_function_table), "The VA of the sorted table of RVAs of each Control Flow Guard function in the image.") .def_property("guard_cf_function_count", static_cast>(&LoadConfigurationV1::guard_cf_function_count), static_cast>(&LoadConfigurationV1::guard_cf_function_count), "The count of unique RVAs in the :attr:`~lief.PE.LoadConfigurationV1.guard_cf_function_table`") .def_property("guard_flags", static_cast>(&LoadConfigurationV1::guard_flags), static_cast>(&LoadConfigurationV1::guard_flags), "Control Flow Guard related flags.") .def("has", static_cast(&LoadConfigurationV1::has), "Check if the given " RST_CLASS_REF(lief.PE.GUARD_CF_FLAGS) " is present in " ":attr:`~lief.PE.LoadConfigurationV1.guard_flags`", "flag"_a) .def_property_readonly("guard_cf_flags_list", &LoadConfigurationV1::guard_cf_flags_list, "Return list of " RST_CLASS_REF(lief.PE.GUARD_CF_FLAGS) " present in " ":attr:`~lief.PE.LoadConfigurationV1.guard_flags`", py::return_value_policy::reference_internal) .def("__eq__", &LoadConfigurationV1::operator==) .def("__ne__", &LoadConfigurationV1::operator!=) .def("__hash__", [] (const LoadConfigurationV1& config) { return Hash::hash(config); }) .def("__contains__", static_cast(&LoadConfigurationV1::has)) .def("__str__", [] (const LoadConfigurationV1& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV10.cpp000066400000000000000000000042621443457337100277150ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV10") .def(py::init<>()) .def_property("guard_xfg_check_function_pointer", py::overload_cast<>(&LoadConfigurationV10::guard_xfg_check_function_pointer, py::const_), py::overload_cast(&LoadConfigurationV10::guard_xfg_check_function_pointer), "") .def_property("guard_xfg_dispatch_function_pointer", py::overload_cast<>(&LoadConfigurationV10::guard_xfg_dispatch_function_pointer, py::const_), py::overload_cast(&LoadConfigurationV10::guard_xfg_dispatch_function_pointer), "") .def_property("guard_xfg_table_dispatch_function_pointer", py::overload_cast<>(&LoadConfigurationV10::guard_xfg_table_dispatch_function_pointer, py::const_), py::overload_cast(&LoadConfigurationV10::guard_xfg_table_dispatch_function_pointer), "") .def("__eq__", &LoadConfigurationV10::operator==) .def("__ne__", &LoadConfigurationV10::operator!=) .def("__hash__", [] (const LoadConfigurationV10& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV10& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV11.cpp000066400000000000000000000032271443457337100277160ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV11") .def(py::init<>()) .def_property("cast_guard_os_determined_failure_mode", py::overload_cast<>(&LoadConfigurationV11::cast_guard_os_determined_failure_mode, py::const_), py::overload_cast(&LoadConfigurationV11::cast_guard_os_determined_failure_mode), "") .def("__eq__", &LoadConfigurationV11::operator==) .def("__ne__", &LoadConfigurationV11::operator!=) .def("__hash__", [] (const LoadConfigurationV11& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV11& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV2.cpp000066400000000000000000000037511443457337100276400ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV2::*)(void) const; template using setter_t = void (LoadConfigurationV2::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV2", R"delim( :class:`~lief.PE.LoadConfigurationV1` enhanced with *code integrity*. It is associated with the :class:`~lief.PE.WIN_VERSION` set to :attr:`~lief.PE.WIN_VERSION.WIN10_0_9879` )delim") .def(py::init<>()) .def_property_readonly("code_integrity", static_cast(&LoadConfigurationV2::code_integrity), "" RST_CLASS_REF(lief.PE.CodeIntegrity) " object", py::return_value_policy::reference) .def("__eq__", &LoadConfigurationV2::operator==) .def("__ne__", &LoadConfigurationV2::operator!=) .def("__hash__", [] (const LoadConfigurationV2& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV2& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV3.cpp000066400000000000000000000057641443457337100276470ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV3::*)(void) const; template using setter_t = void (LoadConfigurationV3::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV3", R"delim( :class:`~lief.PE.LoadConfigurationV2` with Control Flow Guard improved. It is associated with the :class:`~lief.PE.WIN_VERSION` set to :attr:`~lief.PE.WIN_VERSION.WIN10_0_14286` )delim") .def(py::init<>()) .def_property("guard_address_taken_iat_entry_table", static_cast>(&LoadConfigurationV3::guard_address_taken_iat_entry_table), static_cast>(&LoadConfigurationV3::guard_address_taken_iat_entry_table), "VA of a table associated with CFG's *IAT* checks") .def_property("guard_address_taken_iat_entry_count", static_cast>(&LoadConfigurationV3::guard_address_taken_iat_entry_count), static_cast>(&LoadConfigurationV3::guard_address_taken_iat_entry_count), "Number of entries in the :attr:`~lief.PE.guard_address_taken_iat_entry_table`") .def_property("guard_long_jump_target_table", static_cast>(&LoadConfigurationV3::guard_long_jump_target_table), static_cast>(&LoadConfigurationV3::guard_long_jump_target_table), "VA of a table associated with CFG's *long jump*") .def_property("guard_long_jump_target_count", static_cast>(&LoadConfigurationV3::guard_long_jump_target_count), static_cast>(&LoadConfigurationV3::guard_long_jump_target_count), "Number of entries in the :attr:`~lief.PE.guard_address_taken_iat_entry_table`") .def("__eq__", &LoadConfigurationV3::operator==) .def("__ne__", &LoadConfigurationV3::operator!=) .def("__hash__", [] (const LoadConfigurationV3& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV3& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV4.cpp000066400000000000000000000044651443457337100276450ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV4::*)(void) const; template using setter_t = void (LoadConfigurationV4::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV4", R"delim( :class:`~lief.PE.LoadConfigurationV3` enhanced with: * Kind of dynamic relocations * *Hybrid Metadata Pointer* It is associated with the :class:`~lief.PE.WIN_VERSION` set to :attr:`~lief.PE.WIN_VERSION.WIN10_0_14383` )delim") .def(py::init<>()) .def_property("dynamic_value_reloc_table", static_cast>(&LoadConfigurationV4::dynamic_value_reloc_table), static_cast>(&LoadConfigurationV4::dynamic_value_reloc_table), "VA of pointing to a ``IMAGE_DYNAMIC_RELOCATION_TABLE``") .def_property("hybrid_metadata_pointer", static_cast>(&LoadConfigurationV4::hybrid_metadata_pointer), static_cast>(&LoadConfigurationV4::hybrid_metadata_pointer), "") .def("__eq__", &LoadConfigurationV4::operator==) .def("__ne__", &LoadConfigurationV4::operator!=) .def("__hash__", [] (const LoadConfigurationV4& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV4& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV5.cpp000066400000000000000000000062121443457337100276360ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV5::*)(void) const; template using setter_t = void (LoadConfigurationV5::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV5", R"delim( :class:`~lief.PE.LoadConfigurationV4` enhanced nhanced with Return Flow Guard. It is associated with the :class:`~lief.PE.WIN_VERSION` set to :attr:`~lief.PE.WIN_VERSION.WIN10_0_14901` )delim") .def(py::init<>()) .def_property("guard_rf_failure_routine", static_cast>(&LoadConfigurationV5::guard_rf_failure_routine), static_cast>(&LoadConfigurationV5::guard_rf_failure_routine), "VA of the failure routine") .def_property("guard_rf_failure_routine_function_pointer", static_cast>(&LoadConfigurationV5::guard_rf_failure_routine_function_pointer), static_cast>(&LoadConfigurationV5::guard_rf_failure_routine_function_pointer), "VA of the failure routine ``fptr``") .def_property("dynamic_value_reloctable_offset", static_cast>(&LoadConfigurationV5::dynamic_value_reloctable_offset), static_cast>(&LoadConfigurationV5::dynamic_value_reloctable_offset), "Offset of dynamic relocation table relative to the relocation table") .def_property("dynamic_value_reloctable_section", static_cast>(&LoadConfigurationV5::dynamic_value_reloctable_section), static_cast>(&LoadConfigurationV5::dynamic_value_reloctable_section), "The section index of the dynamic value relocation table") .def_property("reserved2", static_cast>(&LoadConfigurationV5::reserved2), static_cast>(&LoadConfigurationV5::reserved2), "Must be zero") .def("__eq__", &LoadConfigurationV5::operator==) .def("__ne__", &LoadConfigurationV5::operator!=) .def("__hash__", [] (const LoadConfigurationV5& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV5& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV6.cpp000066400000000000000000000045111443457337100276370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV6::*)(void) const; template using setter_t = void (LoadConfigurationV6::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV6", R"delim( :class:`~lief.PE.LoadConfigurationV5` enhanced with Hotpatch and improved RFG. It is associated with the :class:`~lief.PE.WIN_VERSION` set to :attr:`~lief.PE.WIN_VERSION.WIN10_0_15002` )delim") .def(py::init<>()) .def_property("guard_rf_verify_stackpointer_function_pointer", static_cast>(&LoadConfigurationV6::guard_rf_verify_stackpointer_function_pointer), static_cast>(&LoadConfigurationV6::guard_rf_verify_stackpointer_function_pointer), "VA of the Function verifying the stack pointer") .def_property("hotpatch_table_offset", static_cast>(&LoadConfigurationV6::hotpatch_table_offset), static_cast>(&LoadConfigurationV6::hotpatch_table_offset), "Offset to the *hotpatch* table") .def("__eq__", &LoadConfigurationV6::operator==) .def("__ne__", &LoadConfigurationV6::operator!=) .def("__hash__", [] (const LoadConfigurationV6& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV6& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV7.cpp000066400000000000000000000036751443457337100276520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LoadConfigurationV7::*)(void) const; template using setter_t = void (LoadConfigurationV7::*)(T); template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV7") .def(py::init<>()) .def_property("reserved3", static_cast>(&LoadConfigurationV7::reserved3), static_cast>(&LoadConfigurationV7::reserved3), "") .def_property("addressof_unicode_string", static_cast>(&LoadConfigurationV7::addressof_unicode_string), static_cast>(&LoadConfigurationV7::addressof_unicode_string), "") .def("__eq__", &LoadConfigurationV7::operator==) .def("__ne__", &LoadConfigurationV7::operator!=) .def("__hash__", [] (const LoadConfigurationV7& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV7& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV8.cpp000066400000000000000000000031501443457337100276370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV8") .def(py::init<>()) .def_property("volatile_metadata_pointer", py::overload_cast<>(&LoadConfigurationV8::volatile_metadata_pointer, py::const_), py::overload_cast(&LoadConfigurationV8::volatile_metadata_pointer), "") .def("__eq__", &LoadConfigurationV8::operator==) .def("__ne__", &LoadConfigurationV8::operator!=) .def("__hash__", [] (const LoadConfigurationV8& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV8& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/LoadConfigurations/pyLoadConfigurationV9.cpp000066400000000000000000000035411443457337100276440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/LoadConfigurations.hpp" #include #include namespace LIEF { namespace PE { template<> void create(py::module& m) { py::class_(m, "LoadConfigurationV9") .def(py::init<>()) .def_property("guard_eh_continuation_table", py::overload_cast<>(&LoadConfigurationV9::guard_eh_continuation_table, py::const_), py::overload_cast(&LoadConfigurationV9::guard_eh_continuation_table), "") .def_property("guard_eh_continuation_count", py::overload_cast<>(&LoadConfigurationV9::guard_eh_continuation_count, py::const_), py::overload_cast(&LoadConfigurationV9::guard_eh_continuation_count), "") .def("__eq__", &LoadConfigurationV9::operator==) .def("__ne__", &LoadConfigurationV9::operator!=) .def("__hash__", [] (const LoadConfigurationV9& config) { return Hash::hash(config); }) .def("__str__", [] (const LoadConfigurationV9& config) { std::ostringstream stream; stream << config; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyBinary.cpp000066400000000000000000000412721443457337100214530ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/PE/Parser.hpp" #include "LIEF/PE/Builder.hpp" #include "LIEF/PE/Binary.hpp" #include "LIEF/Abstract/Binary.hpp" #include "pyPE.hpp" #include "pyIterators.hpp" namespace LIEF { namespace PE { template using no_const_func = T (Binary::*)(P); template using no_const_getter = T (Binary::*)(void); template using getter_t = T (Binary::*)(void) const; template using setter_t = void (Binary::*)(T); template<> void create(py::module& m) { py::class_ bin(m, "Binary", R"delim( Class which represents a PE binary which is the main interface to manage and modify a PE executable. This object can be instantiated through :func:`lief.parse` or :func:`lief.PE.parse` while the constructor of this object can be used to craft a binary from scratch (see: :ref:`02-pe-from-scratch`) )delim"); init_ref_iterator(bin, "it_section"); init_ref_iterator(bin, "it_data_directories"); init_ref_iterator(bin, "it_relocations"); init_ref_iterator(bin, "it_imports"); init_ref_iterator(bin, "it_delay_imports"); init_ref_iterator(bin, "it_symbols"); init_ref_iterator(bin, "it_const_signatures"); bin .def(py::init(), "name"_a, "type"_a) .def_property_readonly("sections", static_cast>(&Binary::sections), "Return binary's an iterator over the PE's " RST_CLASS_REF(lief.PE.Section) "", py::return_value_policy::reference) .def_property_readonly("dos_header", static_cast(&Binary::dos_header), "Return the " RST_CLASS_REF(lief.PE.DosHeader) "", py::return_value_policy::reference) .def_property_readonly("header", static_cast(&Binary::header), "Return the " RST_CLASS_REF(lief.PE.Header) "", py::return_value_policy::reference) .def_property_readonly("optional_header", static_cast(&Binary::optional_header), "Return the " RST_CLASS_REF(lief.PE.OptionalHeader) "", py::return_value_policy::reference) .def_property_readonly("virtual_size", &Binary::virtual_size, R"delim( Return the binary's virtual size. This value should match :attr:`~lief.PE.OptionalHeader.sizeof_image` )delim") .def_property_readonly("sizeof_headers", &Binary::sizeof_headers, "Size of all the PE headers") .def("rva_to_offset", &Binary::rva_to_offset, "rva_address"_a, R"delim( Convert a relative virtual address to an offset The conversion is performed by looking for the section that encompasses the provided RVA. )delim") .def("va_to_offset", &Binary::va_to_offset, "va_address"_a, R"delim( Convert an **absolute** virtual address into an offset See: :meth:`~lief.PE.Binary.rva_to_offset` )delim") .def("section_from_offset", static_cast(&Binary::section_from_offset), R"delim( Return the :class:`~lief.PE.Section` which encompasses the provided offset. It returns None if a section can't be found. )delim", "offset"_a, py::return_value_policy::reference) .def("section_from_rva", static_cast(&Binary::section_from_rva), R"delim( Return the :class:`~lief.PE.Section` which encompasses the provided **relative** virtual address. If a section can't be found, it returns None. )delim", "rva"_a, py::return_value_policy::reference) .def_property("tls", static_cast(&Binary::tls), static_cast(&Binary::tls), "" RST_CLASS_REF(lief.PE.TLS) " object (if present)", py::return_value_policy::reference) .def_property("rich_header", static_cast(&Binary::rich_header), static_cast(&Binary::rich_header), "" RST_CLASS_REF(lief.PE.RichHeader) " object (if present)", py::return_value_policy::reference) .def_property_readonly("has_rich_header", &Binary::has_rich_header, "``True`` if the current binary has a " RST_CLASS_REF(lief.PE.RichHeader) " object") .def_property_readonly("has_debug", &Binary::has_debug, "``True`` if the current binary has a " RST_CLASS_REF(lief.PE.Debug) " object") .def_property_readonly("has_tls", &Binary::has_tls, "``True`` if the current binary has a " RST_CLASS_REF(lief.PE.TLS) " object") .def_property_readonly("has_imports", &Binary::has_imports, "``True`` if the current binary has imports (" RST_CLASS_REF(lief.PE.Import) ")") .def_property_readonly("has_exports", &Binary::has_exports, "``True`` if the current binary has a " RST_CLASS_REF(lief.PE.Export) " object") .def_property_readonly("has_resources", &Binary::has_resources, "``True`` if the current binary has a " RST_CLASS_REF(lief.PE.Resources) " object") .def_property_readonly("has_exceptions", &Binary::has_exceptions, "``True`` if the current binary uses ``Exceptions``") .def_property_readonly("has_relocations", &Binary::has_relocations, "``True`` if the current binary uses " RST_CLASS_REF(lief.PE.Relocation) "") .def_property_readonly("has_configuration", &Binary::has_configuration, "``True`` if the current binary has " RST_CLASS_REF(lief.PE.LoadConfiguration) "") .def_property_readonly("has_signatures", &Binary::has_signatures, "``True`` if the binary is signed with the PE authenticode (" RST_CLASS_REF(lief.PE.Signature) ")") .def_property_readonly("is_reproducible_build", &Binary::is_reproducible_build, "``True`` if the binary was compiled with a reproducible build directive (" RST_CLASS_REF(lief.PE.Debug) ")") .def_property_readonly("functions", &Binary::functions, "**All** " RST_CLASS_REF(lief.Function) " found in the binary") .def_property_readonly("exception_functions", &Binary::exception_functions, "" RST_CLASS_REF(lief.Function) " found in the Exception directory") .def("predict_function_rva", static_cast(&Binary::predict_function_rva), "Try to predict the RVA of the given function name in the given import library name", "library"_a, "function"_a) .def_property_readonly("signatures", static_cast(&Binary::signatures), "Return an iterator over the " RST_CLASS_REF(lief.PE.Signature) " objects", py::return_value_policy::reference) .def("authentihash", [] (const Binary& bin, ALGORITHMS algo) { const std::vector& data = bin.authentihash(algo); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Compute the authentihash according to the " RST_CLASS_REF(lief.PE.ALGORITHMS) " " "given in the first parameter", "algorithm"_a) .def("verify_signature", static_cast(&Binary::verify_signature), R"delim( Verify the binary against the embedded signature(s) (if any) First off, it checks that the embedded signatures are correct (c.f. :meth:`lief.PE.Signature.check`) and then it checks that the authentihash matches :attr:`lief.PE.ContentInfo.digest` One can tweak the verification process with the :class:`lief.PE.Signature.VERIFICATION_CHECKS` flags .. seealso:: :meth:`lief.PE.Signature.check` )delim", "checks"_a = Signature::VERIFICATION_CHECKS::DEFAULT) .def("verify_signature", static_cast(&Binary::verify_signature), R"delim( Verify the binary with the Signature object provided in the first parameter It can be used to verify a detached signature: .. code-block:: python detached = lief.PE.Signature.parse("sig.pkcs7") binary.verify_signature(detached) )delim", "signature"_a, "checks"_a = Signature::VERIFICATION_CHECKS::DEFAULT) .def_property_readonly("authentihash_md5", [] (const Binary& bin) { const std::vector& data = bin.authentihash(ALGORITHMS::MD5); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Authentihash **MD5** value") .def_property_readonly("authentihash_sha1", [] (const Binary& bin) { const std::vector& data = bin.authentihash(ALGORITHMS::SHA_1); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Authentihash **SHA1** value") .def_property_readonly("authentihash_sha256", [] (const Binary& bin) { const std::vector& data = bin.authentihash(ALGORITHMS::SHA_256); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Authentihash **SHA-256** value") .def_property_readonly("authentihash_sha512", [] (const Binary& bin) { const std::vector& data = bin.authentihash(ALGORITHMS::SHA_512); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Authentihash **SHA-512** value") .def_property_readonly("debug", static_cast(&Binary::debug), "Return the " RST_CLASS_REF(lief.PE.Debug) "", py::return_value_policy::reference) .def_property_readonly("load_configuration", static_cast(&Binary::load_configuration), "Return the " RST_CLASS_REF(lief.PE.LoadConfiguration) " object or None if not present", py::return_value_policy::reference) .def("get_export", static_cast(&Binary::get_export), "Return the " RST_CLASS_REF(lief.PE.Export) " object", py::return_value_policy::reference) .def_property_readonly("symbols", static_cast& (Binary::*)(void)>(&Binary::symbols), "Return binary's " RST_CLASS_REF(lief.PE.Symbol) "", py::return_value_policy::reference) .def("get_section", static_cast>(&Binary::get_section), "Return the " RST_CLASS_REF(lief.PE.Section) " object from the given name or None if not not found", "section_name"_a, py::return_value_policy::reference) .def("add_section", &Binary::add_section, "Add a " RST_CLASS_REF(lief.PE.Section) " to the binary.", "section"_a, py::arg("type") = PE_SECTION_TYPES::UNKNOWN, py::return_value_policy::reference) .def_property_readonly("relocations", static_cast>(&Binary::relocations), "Return an iterator over the " RST_CLASS_REF(lief.PE.Relocation) "", py::return_value_policy::reference) .def("add_relocation", &Binary::add_relocation, "Add a " RST_CLASS_REF(lief.PE.Relocation) " to the binary", "relocation"_a) .def("remove_all_relocations", &Binary::remove_all_relocations) .def("remove", static_cast(&Binary::remove), "Remove the " RST_CLASS_REF(lief.PE.Section) " given in first parameter", "section"_a, "clear"_a = false) .def_property_readonly("data_directories", static_cast>(&Binary::data_directories), "Return an iterator over the " RST_CLASS_REF(lief.PE.DataDirectory) "", py::return_value_policy::reference) .def("data_directory", static_cast(&Binary::data_directory), "Return the " RST_CLASS_REF(lief.PE.DataDirectory) " object from the given " RST_CLASS_REF(lief.PE.DATA_DIRECTORY) " type", "type"_a, py::return_value_policy::reference) .def_property_readonly("imports", static_cast>(&Binary::imports), "Return an iterator over the " RST_CLASS_REF(lief.PE.Import) " libraries", py::return_value_policy::reference) .def("has_import", &Binary::has_import, "``True`` if the binary imports the given library name", "import_name"_a) .def("get_import", static_cast>(&Binary::get_import), "Return the " RST_CLASS_REF(lief.PE.Import) " from the given name or None if not not found", "import_name"_a, py::return_value_policy::reference) .def_property_readonly("delay_imports", static_cast>(&Binary::delay_imports), "Return an iterator over the " RST_CLASS_REF(lief.PE.DelayImport) " ") .def_property_readonly("has_delay_imports", &Binary::has_delay_imports, "``True`` if the current binary has delay imports (" RST_CLASS_REF(lief.PE.DelayImport) ")") .def("has_delay_import", &Binary::has_delay_import, "``True`` if the binary imports the given library name", "import_name"_a) .def("get_delay_import", static_cast>(&Binary::get_delay_import), "Return the " RST_CLASS_REF(lief.PE.DelayImport) " from the given name or None if not not found", "import_name"_a, py::return_value_policy::reference) .def_property_readonly("resources_manager", [] (Binary& self) { return error_or(&Binary::resources_manager, self); }, "Return the " RST_CLASS_REF(lief.PE.ResourcesManager) " to manage resources") .def_property_readonly("resources", static_cast>(&Binary::resources), "Return the " RST_CLASS_REF(lief.PE.ResourceNode) " tree or None if not not present", py::return_value_policy::reference) .def_property_readonly("overlay", [] (Binary& self) { span content = self.overlay(); return py::memoryview::from_memory(content.data(), content.size()); }, "Return the overlay content as a ``list`` of bytes", py::return_value_policy::reference) .def_property("dos_stub", [] (Binary& self) { span content = self.dos_stub(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast&>>(&Binary::dos_stub), "DOS stub content as a ``list`` of bytes") .def("add_import_function", &Binary::add_import_function, "Add a function to the given " RST_CLASS_REF(lief.PE.Import) " name", "import_name"_a, "function_name"_a, py::return_value_policy::reference) .def("add_library", &Binary::add_library, "Add an " RST_CLASS_REF(lief.PE.Import) " by name", "import_name"_a, py::return_value_policy::reference) .def("remove_library", &Binary::remove_library, "Remove the " RST_CLASS_REF(lief.PE.Import) " from the given name", "import_name"_a) .def("remove_all_libraries", &Binary::remove_all_libraries, "Remove all imported libraries") .def("write", static_cast(&Binary::write), "Build the binary and write the result to the given ``output`` file", "output_path"_a) .def("__str__", [] (const Binary& binary) { std::ostringstream stream; stream << binary; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyBuilder.cpp000066400000000000000000000072671443457337100216230ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/Builder.hpp" #include #include //template>{}, int> = 0 > //constexpr decltype(auto) my_invoke(Fn&& f, Args&&... args) // noexcept(noexcept(std::mem_fn(f)(std::forward(args)...))) //{ // return std::mem_fn(f)(std::forward(args)...); //} namespace LIEF { namespace PE { template<> void create(py::module& m) { py::class_(m, "Builder", R"delim( Class that is used to rebuild a raw PE binary from a PE::Binary object )delim") .def(py::init(), "Constructor that takes a " RST_CLASS_REF(lief.PE.Binary) "", "pe_binary"_a) .def("build", [] (Builder& self) -> py::object { return error_or(static_cast(&Builder::build), self); }, "Perform the build process") .def("build_imports", &Builder::build_imports, "Rebuild the import table into another section", py::arg("enable") = true, py::return_value_policy::reference) .def("patch_imports", &Builder::patch_imports, "Patch the original import table in order to redirect functions to " "the new import table.\n\n" "This setting should be used with ``build_imports`` set to ``True``", py::arg("enable") = true, py::return_value_policy::reference) .def("build_relocations", &Builder::build_relocations, "Rebuild the relocation table in another section", py::arg("enable") = true, py::return_value_policy::reference) .def("build_tls", static_cast(&Builder::build_tls), "Rebuild TLS object in another section", py::arg("enable") = true, py::return_value_policy::reference) .def("build_resources", static_cast(&Builder::build_resources), "Rebuid the resources in another section", py::arg("enable") = true, py::return_value_policy::reference) .def("build_overlay", static_cast(&Builder::build_overlay), "Rebuild the binary's overlay", py::arg("enable") = true, py::return_value_policy::reference) .def("build_dos_stub", static_cast(&Builder::build_dos_stub), "Rebuild the DOS stub", py::arg("enable") = true, py::return_value_policy::reference) .def("write", static_cast(&Builder::write), "Write the build result into the ``output`` file", "output"_a) .def("get_build", &Builder::get_build, "Return the build result as a ``list`` of bytes", py::return_value_policy::reference_internal) .def("__str__", [] (const Builder& builder) { std::ostringstream stream; stream << builder; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyCodeIntegrity.cpp000066400000000000000000000044121443457337100227730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/CodeIntegrity.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (CodeIntegrity::*)(void) const; template using setter_t = void (CodeIntegrity::*)(T); template<> void create(py::module& m) { py::class_(m, "CodeIntegrity") .def(py::init<>()) .def_property("flags", static_cast>(&CodeIntegrity::flags), static_cast>(&CodeIntegrity::flags), "Flags to indicate if CI information is available, etc.") .def_property("catalog", static_cast>(&CodeIntegrity::catalog), static_cast>(&CodeIntegrity::catalog), "``0xFFFF`` means not available") .def_property("catalog_offset", static_cast>(&CodeIntegrity::catalog_offset), static_cast>(&CodeIntegrity::catalog_offset), "") .def_property("reserved", static_cast>(&CodeIntegrity::reserved), static_cast>(&CodeIntegrity::reserved), "Additional bitmask to be defined later") .def("__eq__", &CodeIntegrity::operator==) .def("__ne__", &CodeIntegrity::operator!=) .def("__hash__", [] (const CodeIntegrity& code) { return Hash::hash(code); }) .def("__str__", [] (const CodeIntegrity& code) { std::ostringstream stream; stream << code; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyCodeView.cpp000066400000000000000000000030521443457337100217260ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/CodeView.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (CodeView::*)(void) const; template using setter_t = void (CodeView::*)(T); template<> void create(py::module& m) { py::class_(m, "CodeView") .def_property_readonly("cv_signature", static_cast>(&CodeView::cv_signature), "Type of the code view (" RST_CLASS_REF(lief.PE.CODE_VIEW_SIGNATURES) ")") .def("__eq__", &CodeView::operator==) .def("__ne__", &CodeView::operator!=) .def("__hash__", [] (const CodeView& codeview) { return Hash::hash(codeview); }) .def("__str__", [] (const CodeView& cv) { std::ostringstream stream; stream << cv; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyCodeViewPDB.cpp000066400000000000000000000036321443457337100222600ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/CodeViewPDB.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (CodeViewPDB::*)(void) const; template using setter_t = void (CodeViewPDB::*)(T); template<> void create(py::module& m) { py::class_(m, "CodeViewPDB") .def(py::init<>()) .def_property("signature", static_cast>(&CodeViewPDB::signature), static_cast>(&CodeViewPDB::signature)) .def_property("age", static_cast>(&CodeViewPDB::age), static_cast>(&CodeViewPDB::age)) .def_property("filename", static_cast>(&CodeViewPDB::filename), static_cast>(&CodeViewPDB::filename)) .def("__eq__", &CodeViewPDB::operator==) .def("__ne__", &CodeViewPDB::operator!=) .def("__hash__", [] (const CodeViewPDB& codeview) { return Hash::hash(codeview); }) .def("__str__", [] (const CodeViewPDB& cv) { std::ostringstream stream; stream << cv; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyDataDirectory.cpp000066400000000000000000000052551443457337100227660ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/PE/hash.hpp" #include "LIEF/PE/DataDirectory.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { template using getter_t = T (DataDirectory::*)(void) const; template using setter_t = void (DataDirectory::*)(T); template<> void create(py::module& m) { py::class_(m, "DataDirectory", R"delim( Class that represents a PE data directory entry )delim") .def(py::init<>()) .def_property("rva", static_cast>(&DataDirectory::RVA), static_cast>(&DataDirectory::RVA), "**Relative** virtual address of the content associated with the current data directory") .def_property("size", static_cast>(&DataDirectory::size), static_cast>(&DataDirectory::size), "Size in bytes of the content associated with the current data directory") .def_property_readonly("section", static_cast(&DataDirectory::section), "" RST_CLASS_REF(lief.PE.Section) " associated with the current data directory or None if not linked", py::return_value_policy::reference) .def_property_readonly("type", &DataDirectory::type, "Type (" RST_CLASS_REF(lief.PE.DATA_DIRECTORY) ") of the current data directory", py::return_value_policy::reference_internal) .def_property_readonly("has_section", &DataDirectory::has_section, "``True`` if the current data directory is tied to a " RST_CLASS_REF(lief.PE.Section) "") .def("__eq__", &DataDirectory::operator==) .def("__ne__", &DataDirectory::operator!=) .def("__hash__", [] (const DataDirectory& data_directory) { return Hash::hash(data_directory); }) .def("__str__", [] (const DataDirectory& datadir) { std::ostringstream stream; stream << datadir; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyDebug.cpp000066400000000000000000000100341443457337100212450ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/Debug.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Debug::*)(void) const; template using setter_t = void (Debug::*)(T); template<> void create(py::module& m) { py::class_(m, "Debug") .def(py::init<>()) .def_property("characteristics", static_cast>(&Debug::characteristics), static_cast>(&Debug::characteristics), "Reserved should be 0") .def_property("timestamp", static_cast>(&Debug::timestamp), static_cast>(&Debug::timestamp), "The time and date that the debug data was created.") .def_property("major_version", static_cast>(&Debug::major_version), static_cast>(&Debug::major_version), "The major version number of the debug data format.") .def_property("minor_version", static_cast>(&Debug::minor_version), static_cast>(&Debug::minor_version), "The minor version number of the debug data format.") .def_property("type", static_cast>(&Debug::type), static_cast>(&Debug::type), "The format (" RST_CLASS_REF(lief.PE.DEBUG_TYPES) ") of the debugging information") .def_property("sizeof_data", static_cast>(&Debug::sizeof_data), static_cast>(&Debug::sizeof_data), "Size of the debug data") .def_property("addressof_rawdata", static_cast>(&Debug::addressof_rawdata), static_cast>(&Debug::addressof_rawdata), "Address of the debug data relative to the image base") .def_property("pointerto_rawdata", static_cast>(&Debug::pointerto_rawdata), static_cast>(&Debug::pointerto_rawdata), "File offset of the debug data") .def_property_readonly("has_code_view", &Debug::has_code_view, "Whether or not a code view is present") .def_property_readonly("code_view", static_cast(&Debug::code_view), R"delim( Return an object which subclass :class:`~lief.PE.CodeView` representing the code view" The subclassed object can be one of: * :class:`~lief.PE.CodeViewPDB` If a code view is not present, it is set to None )delim", py::return_value_policy::reference) .def_property_readonly("has_pogo", &Debug::has_pogo, "Whether or not a pogo is present") .def_property_readonly("pogo", static_cast(&Debug::pogo), R"delim( Return an object which subclasses :class:`~lief.PE.Pogo` representing the pogo entry. It returns None if not present. )delim", py::return_value_policy::reference) .def("__eq__", &Debug::operator==) .def("__ne__", &Debug::operator!=) .def("__hash__", [] (const Debug& debug) { return Hash::hash(debug); }) .def("__str__", [] (const Debug& debug) { std::ostringstream stream; stream << debug; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyDelayImport.cpp000066400000000000000000000110201443457337100224440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/DelayImport.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (DelayImport::*)() const; template using setter_t = void (DelayImport::*)(T); template using no_const_getter = T (DelayImport::*)(); template using no_const_func = T (DelayImport::*)(P); template<> void create(py::module& m) { py::class_ imp(m, "DelayImport", R"delim( Class that represents a PE delay import )delim"); init_ref_iterator(imp, "it_entries"); imp .def(py::init(), "Constructor from a library name", "library_name"_a) .def_property_readonly("entries", static_cast>(&DelayImport::entries), "Iterator over the " RST_CLASS_REF(lief.PE.DelayImportEntry) " (functions)", py::return_value_policy::reference) .def_property("name", [] (const DelayImport& obj) { return safe_string_converter(obj.name()); }, static_cast>(&DelayImport::name), "Library name (e.g. ``kernel32.dll``)", py::return_value_policy::reference_internal) .def_property("attribute", static_cast>(&DelayImport::attribute), static_cast>(&DelayImport::attribute), R"delim( Reserved and **should** be zero according to the PE specifications )delim") .def_property("handle", static_cast>(&DelayImport::handle), static_cast>(&DelayImport::handle), R"delim( The RVA of the module handle (in the ``.data`` section) It is used for storage by the routine that is supplied to manage delay-loading. )delim") .def_property("iat", static_cast>(&DelayImport::iat), static_cast>(&DelayImport::iat), R"delim( RVA of the delay-load import address table. )delim") .def_property("names_table", static_cast>(&DelayImport::names_table), static_cast>(&DelayImport::names_table), R"delim( RVA of the delay-load import names table. The content of this table has the layout as the Import lookup table )delim") .def_property("biat", static_cast>(&DelayImport::biat), static_cast>(&DelayImport::biat), R"delim( RVA of the **bound** delay-load import address table or 0 if the table does not exist. )delim") .def_property("uiat", static_cast>(&DelayImport::uiat), static_cast>(&DelayImport::uiat), R"delim( RVA of the **unload** delay-load import address table or 0 if the table does not exist. According to the PE specifications, this table is an exact copy of the delay import address table that can be used to to restore the original IAT the case of unloading. )delim") .def_property("timestamp", static_cast>(&DelayImport::timestamp), static_cast>(&DelayImport::timestamp), R"delim( The timestamp of the DLL to which this image has been bound. )delim") .def("__eq__", &DelayImport::operator==) .def("__ne__", &DelayImport::operator!=) .def("__hash__", [] (const DelayImport& import) { return Hash::hash(import); }) .def("__str__", [] (const DelayImport& import) { std::ostringstream stream; stream << import; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyDelayImportEntry.cpp000066400000000000000000000057571443457337100235120ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/PE/hash.hpp" #include "LIEF/PE/DelayImportEntry.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { template using getter_t = T (DelayImportEntry::*)() const; template using setter_t = void (DelayImportEntry::*)(T); template<> void create(py::module& m) { py::class_(m, "DelayImportEntry", R"delim( Class that represents an entry (i.e. a delay import) in the delay import table (:class:`~lief.PE.DelayImport`). It extends the :class:`lief.Symbol` generic class that provides the :attr:`lief.Symbol.name` and :attr:`lief.Symbol.value` The meaning of :attr:`lief.Symbol.value` for this PE object is the address (as an RVA) in the IAT where the resolution should take place )delim") .def(py::init<>()) .def_property("name", [] (const DelayImportEntry& obj) { return safe_string_converter(obj.name()); }, static_cast>(&DelayImportEntry::name), "Delay import name if not ordinal") .def_property("data", static_cast>(&DelayImportEntry::data), static_cast>(&DelayImportEntry::data), "Raw value") .def_property_readonly("is_ordinal", &DelayImportEntry::is_ordinal, "``True`` if it is an import by ordinal") .def_property_readonly("ordinal", &DelayImportEntry::ordinal, "Ordinal value (if any). See: :attr:`~lief.PE.DelayImportEntry.is_ordinal`") .def_property_readonly("hint", &DelayImportEntry::hint, "Index into the :attr:`lief.PE.Export.entries` that is used to speed-up the symbol resolution") .def_property_readonly("iat_value", &DelayImportEntry::iat_value, R"delim( Value of the current entry in the delay-loaded import address table. See: :attr:`~DelayImportEntry.iat` )delim") .def("__eq__", &DelayImportEntry::operator==) .def("__ne__", &DelayImportEntry::operator!=) .def("__hash__", [] (const DelayImportEntry& import_entry) { return Hash::hash(import_entry); }) .def("__str__", [] (const DelayImportEntry& importEntry) { std::ostringstream stream; stream << importEntry; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyDosHeader.cpp000066400000000000000000000110031443457337100220520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/DosHeader.hpp" #include #include namespace LIEF { namespace PE { template using getter_abs_t = T (DosHeader::*)(void) const; template using setter_abs_t = void (DosHeader::*)(T); using getter_t = getter_abs_t; using setter_t = setter_abs_t; template<> void create(py::module& m) { py::class_(m, "DosHeader", R"delim( Class which represents the DosHeader, the **first** structure presents at the beginning of a PE file. Most of the attributes of this structures are not relevant, except :attr:`~lief.PE.DosHeader.addressof_new_exeheader` )delim") .def(py::init<>()) .def_property("magic", static_cast(&DosHeader::magic), static_cast(&DosHeader::magic)) .def_property("used_bytes_in_the_last_page", static_cast(&DosHeader::used_bytes_in_the_last_page), static_cast(&DosHeader::used_bytes_in_the_last_page)) .def_property("file_size_in_pages", static_cast(&DosHeader::file_size_in_pages), static_cast(&DosHeader::file_size_in_pages)) .def_property("numberof_relocation", static_cast(&DosHeader::numberof_relocation), static_cast(&DosHeader::numberof_relocation)) .def_property("header_size_in_paragraphs", static_cast(&DosHeader::header_size_in_paragraphs), static_cast(&DosHeader::header_size_in_paragraphs)) .def_property("minimum_extra_paragraphs", static_cast(&DosHeader::minimum_extra_paragraphs), static_cast(&DosHeader::minimum_extra_paragraphs)) .def_property("maximum_extra_paragraphs", static_cast(&DosHeader::maximum_extra_paragraphs), static_cast(&DosHeader::maximum_extra_paragraphs)) .def_property("initial_relative_ss", static_cast(&DosHeader::initial_relative_ss), static_cast(&DosHeader::initial_relative_ss)) .def_property("initial_sp", static_cast(&DosHeader::initial_sp), static_cast(&DosHeader::initial_sp)) .def_property("checksum", static_cast(&DosHeader::checksum), static_cast(&DosHeader::checksum)) .def_property("initial_ip", static_cast(&DosHeader::initial_ip), static_cast(&DosHeader::initial_ip)) .def_property("initial_relative_cs", static_cast(&DosHeader::initial_relative_cs), static_cast(&DosHeader::initial_relative_cs)) .def_property("addressof_relocation_table", static_cast(&DosHeader::addressof_relocation_table), static_cast(&DosHeader::addressof_relocation_table)) .def_property("overlay_number", static_cast(&DosHeader::overlay_number), static_cast(&DosHeader::overlay_number)) .def_property("oem_id", static_cast(&DosHeader::oem_id), static_cast(&DosHeader::oem_id)) .def_property("oem_info", static_cast(&DosHeader::oem_info), static_cast(&DosHeader::oem_info)) .def_property("addressof_new_exeheader", static_cast>(&DosHeader::addressof_new_exeheader), static_cast>(&DosHeader::addressof_new_exeheader)) .def("__eq__", &DosHeader::operator==) .def("__ne__", &DosHeader::operator!=) .def("__hash__", [] (const DosHeader& dos_header) { return Hash::hash(dos_header); }) .def("__str__", [] (const DosHeader& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyExport.cpp000066400000000000000000000063541443457337100215120ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/Export.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Export::*)(void) const; template using setter_t = void (Export::*)(T); template using no_const_getter = T (Export::*)(void); template<> void create(py::module& m) { py::class_ exp(m, "Export", R"delim( Class which represents a PE Export )delim"); init_ref_iterator(exp, "it_entries"); exp .def(py::init<>()) .def_property("name", [] (const Export& obj) { return safe_string_converter(obj.name()); }, static_cast>(&Export::name), "The name of the library exported (e.g. ``KERNEL32.dll``)") .def_property("export_flags", static_cast>(&Export::export_flags), static_cast>(&Export::export_flags), "According to the PE specifications this value is reserved and should be set to 0") .def_property("timestamp", static_cast>(&Export::timestamp), static_cast>(&Export::timestamp), "The time and date that the export data was created") .def_property("major_version", static_cast>(&Export::major_version), static_cast>(&Export::major_version), "The major version number (can be user-defined)") .def_property("minor_version", static_cast>(&Export::minor_version), static_cast>(&Export::minor_version), "The minor version number (can be user-defined)") .def_property("ordinal_base", static_cast>(&Export::ordinal_base), static_cast>(&Export::ordinal_base), "The starting number for the exports. Usually this value is set to 1") .def_property_readonly("entries", static_cast>(&Export::entries), "Iterator over the " RST_CLASS_REF(lief.PE.ExportEntry) "", py::return_value_policy::reference_internal) .def("__eq__", &Export::operator==) .def("__ne__", &Export::operator!=) .def("__hash__", [] (const Export& export_) { return Hash::hash(export_); }) .def("__str__", [] (const Export& export_) { std::ostringstream stream; stream << export_; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyExportEntry.cpp000066400000000000000000000056301443457337100225300ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/ExportEntry.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ExportEntry::*)(void) const; template using setter_t = void (ExportEntry::*)(T); template<> void create(py::module& m) { py::class_ export_entry(m, "ExportEntry", R"delim( Class which represents a PE Export entry (cf. :class:`lief.PE.Export`) )delim"); py::class_(export_entry, "forward_information_t") .def_readwrite("library", &ExportEntry::forward_information_t::library) .def_readwrite("function", &ExportEntry::forward_information_t::function) .def("__str__", [] (const ExportEntry::forward_information_t& info) { std::ostringstream stream; stream << info; return stream.str(); }); export_entry .def(py::init<>()) .def_property("name", [] (const ExportEntry& obj) { return safe_string_converter(obj.name()); }, static_cast>(&ExportEntry::name)) .def_property("ordinal", static_cast>(&ExportEntry::ordinal), static_cast>(&ExportEntry::ordinal)) .def_property("address", static_cast>(&ExportEntry::address), static_cast>(&ExportEntry::address)) .def_property("is_extern", static_cast>(&ExportEntry::is_extern), static_cast>(&ExportEntry::is_extern)) .def_property_readonly("is_forwarded", &ExportEntry::is_forwarded) .def_property_readonly("forward_information", &ExportEntry::forward_information) .def_property_readonly("function_rva", &ExportEntry::function_rva) .def("__eq__", &ExportEntry::operator==) .def("__ne__", &ExportEntry::operator!=) .def("__hash__", [] (const ExportEntry& export_entry) { return Hash::hash(export_entry); }) .def("__str__", [] (const ExportEntry& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyHeader.cpp000066400000000000000000000117261443457337100214200ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/Header.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template<> void create
(py::module& m) { py::class_(m, "Header", R"delim( Class that represents the PE header (which follows the :class:`lief.PE.DosHeader`) )delim") .def(py::init<>()) .def_property("signature", static_cast>(&Header::signature), static_cast>(&Header::signature), "Signature (or magic byte) of the header. It must be: ``PE\\0\\0``") .def_property("machine", static_cast>(&Header::machine), static_cast>(&Header::machine), "The target machine architecture (" RST_CLASS_REF(lief.PE.MACHINE_TYPES) ")") .def_property("numberof_sections", static_cast>(&Header::numberof_sections), static_cast>(&Header::numberof_sections), "Number of sections in the binary") .def_property("time_date_stamps", static_cast>(&Header::time_date_stamp), static_cast>(&Header::time_date_stamp), "The low 32 bits of the number of seconds since 00:00 January 1, 1970 that indicates when the file was created.") .def_property("pointerto_symbol_table", static_cast>(&Header::pointerto_symbol_table), static_cast>(&Header::pointerto_symbol_table), R"delim( The file offset of the COFF symbol table, or zero if no COFF symbol table is present. This value should be zero for an image because COFF debugging information is deprecated. )delim") .def_property("numberof_symbols", static_cast>(&Header::numberof_symbols), static_cast>(&Header::numberof_symbols), R"delim( The number of entries in the symbol table. This data can be used to locate the string table which immediately follows the symbol table. This value should be zero for an image because COFF debugging information is deprecated. )delim") .def_property("sizeof_optional_header", static_cast>(&Header::sizeof_optional_header), static_cast>(&Header::sizeof_optional_header), R"delim( Size of the :class:`~lief.PE.OptionalHeader` **AND** the data directories which follows this header. This value is equivalent to: ``sizeof(pe_optional_header) + NB_DATA_DIR * sizeof(data_directory)`` This size **should** be either: * 0xE0 (224) for a PE32 (32 bits) * 0xF0 (240) for a PE32+ (64 bits) )delim") .def_property("characteristics", static_cast>(&Header::characteristics), static_cast>(&Header::characteristics), "The " RST_CLASS_REF(lief.PE.HEADER_CHARACTERISTICS) " that indicate the attributes of the file.") .def("has_characteristic", &Header::has_characteristic, "``True`` if the header has the given " RST_CLASS_REF(lief.PE.HEADER_CHARACTERISTICS) "", "characteristic"_a) .def("add_characteristic", &Header::add_characteristic, "Add the given " RST_CLASS_REF(lief.PE.HEADER_CHARACTERISTICS) " to the header", "characteristic"_a) .def("remove_characteristic", &Header::remove_characteristic, "Remove the given " RST_CLASS_REF(lief.PE.HEADER_CHARACTERISTICS) " from the header", "characteristic"_a) .def_property_readonly("characteristics_list", &Header::characteristics_list, "Return the " RST_CLASS_REF(lief.PE.HEADER_CHARACTERISTICS) " as a ``list``") .def("__eq__", &Header::operator==) .def("__ne__", &Header::operator!=) .def("__hash__", [] (const Header& header) { return Hash::hash(header); }) .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyImport.cpp000066400000000000000000000131121443457337100214710ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "pyErr.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/Import.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Import::*)(void) const; template using setter_t = void (Import::*)(T); template using no_const_getter = T (Import::*)(void); template using no_const_func = T (Import::*)(P); template<> void create(py::module& m) { py::class_ imp(m, "Import", R"delim( Class that represents a PE import )delim"); init_ref_iterator(imp, "it_entries"); imp .def(py::init<>(), "Default constructor") .def(py::init(), "Constructor from a library name", "library_name"_a) .def_property_readonly("forwarder_chain", &Import::forwarder_chain, "The index of the first forwarder reference") .def_property_readonly("timedatestamp", &Import::timedatestamp, R"delim( The stamp that is set to zero until the image is bound. After the image is bound, this field is set to the time/data stamp of the DLL )delim") .def_property_readonly("entries", static_cast>(&Import::entries), "Iterator over the " RST_CLASS_REF(lief.PE.ImportEntry) " (functions)", py::return_value_policy::reference) .def_property("name", [] (const Import& obj) { return safe_string_converter(obj.name()); }, static_cast>(&Import::name), "Library name (e.g. ``kernel32.dll``)", py::return_value_policy::reference) .def_property_readonly("directory", static_cast>(&Import::directory), R"delim( Return the :class:`~lief.PE.DataDirectory` associated with this import. It should be the one at index :attr:`lief.PE.DATA_DIRECTORY.IMPORT_TABLE`. It can return None if the Import directory can't be resolved. )delim", py::return_value_policy::reference) .def_property_readonly("iat_directory", static_cast>(&Import::iat_directory), R"delim( Return the :class:`~lief.PE.DataDirectory` associated with the ``IAT`` table. It should be the one at index :attr:`lief.PE.DATA_DIRECTORY.IAT`. It can return None if the IAT directory can't be resolved. )delim", py::return_value_policy::reference) .def_property("import_address_table_rva", static_cast>(&Import::import_address_table_rva), static_cast>(&Import::import_address_table_rva), R"delim( The RVA of the import address table (``IAT``). The content of this table is **identical** to the content of the Import Lookup Table (``ILT``) until the image is bound. .. warning:: This address could change when re-building the binary )delim") .def_property("import_lookup_table_rva", static_cast>(&Import::import_lookup_table_rva), static_cast>(&Import::import_lookup_table_rva), R"delim( The RVA of the import lookup table. This table contains the :attr:`~lief.PE.ImportEntry.name` or the :attr:`~lief.PE.ImportEntry.ordinal` for all the imports. )delim") .def("get_function_rva_from_iat", [] (const Import& self, const std::string& name) { return error_or(&Import::get_function_rva_from_iat, self, name); }, "Return the relative virtual address of the given function within the *Import Address Table*", "function_name"_a) .def("add_entry", static_cast(&Import::add_entry), "Add an " RST_CLASS_REF(lief.PE.ImportEntry) " (function) to the current import", "entry"_a, py::return_value_policy::reference) .def("add_entry", static_cast(&Import::add_entry), "Add an " RST_CLASS_REF(lief.PE.ImportEntry) " (function) to the current import", "function_name"_a, py::return_value_policy::reference) .def("get_entry", static_cast>(&Import::get_entry), "Return the " RST_CLASS_REF(lief.PE.ImportEntry) " with the given name or None if not found", "function_name"_a, py::return_value_policy::reference) .def("__eq__", &Import::operator==) .def("__ne__", &Import::operator!=) .def("__hash__", [] (const Import& import) { return Hash::hash(import); }) .def("__str__", [] (const Import& import) { std::ostringstream stream; stream << import; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyImportEntry.cpp000066400000000000000000000071751443457337100225270ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/PE/hash.hpp" #include "LIEF/PE/ImportEntry.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { template using getter_t = T (ImportEntry::*)(void) const; template using setter_t = void (ImportEntry::*)(T); template<> void create(py::module& m) { py::class_(m, "ImportEntry", R"delim( Class that represents an entry (i.e. an import) in the import table (:class:`~lief.PE.Import`). It extends the :class:`lief.Symbol` generic class that provides the :attr:`lief.Symbol.name` and :attr:`lief.Symbol.value` )delim") .def(py::init<>()) .def(py::init(), "Constructor from a :attr:`~lief.PE.ImportEntry.name`", "import_name"_a) .def(py::init(), "Constructor from a :attr:`~lief.PE.ImportEntry.data` and an optionally :attr:`~lief.PE.ImportEntry.name`", "data"_a, "name"_a = "") .def(py::init(), "Constructor from a :attr:`~lief.PE.ImportEntry.data`, a :attr:`~lief.PE.ImportEntry.type` and an optional :attr:`~lief.PE.ImportEntry.name`", "data"_a, "type"_a, "name"_a = "") .def(py::init(), "Constructor from a :attr:`~lief.PE.ImportEntry.name`, and a :attr:`~lief.PE.ImportEntry.type`", "name"_a, "type"_a) .def_property("name", [] (const ImportEntry& obj) { return safe_string_converter(obj.name()); }, static_cast>(&ImportEntry::name), "Import name if not ordinal") .def_property("data", static_cast>(&ImportEntry::data), static_cast>(&ImportEntry::data), "Raw value") .def_property_readonly("is_ordinal", &ImportEntry::is_ordinal, "``True`` if it is an import by ordinal") .def_property_readonly("ordinal", &ImportEntry::ordinal, "Ordinal value (if any). See: :attr:`~lief.PE.ImportEntry.is_ordinal`") .def_property_readonly("hint", &ImportEntry::hint, "Index into the :attr:`lief.PE.Export.entries` that is used to speed-up the symbol resolution") .def_property_readonly("iat_value", &ImportEntry::iat_value, "Value of the current entry in the Import Address Table. It should match the lookup table value.") .def_property_readonly("iat_address", &ImportEntry::iat_address, "**Original** address of the entry in the Import Address Table") .def("__eq__", &ImportEntry::operator==) .def("__ne__", &ImportEntry::operator!=) .def("__hash__", [] (const ImportEntry& import_entry) { return Hash::hash(import_entry); }) .def("__str__", [] (const ImportEntry& importEntry) { std::ostringstream stream; stream << importEntry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyOptionalHeader.cpp000066400000000000000000000334741443457337100231320ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/OptionalHeader.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (OptionalHeader::*)(void) const; template using setter_t = void (OptionalHeader::*)(T); template<> void create(py::module& m) { py::class_(m, "OptionalHeader", R"delim( Class which represents the PE OptionalHeader structure.. )delim") .def(py::init<>()) .def_property("magic", static_cast>(&OptionalHeader::magic), static_cast>(&OptionalHeader::magic), "Magic value (" RST_CLASS_REF(lief.PE.PE_TYPE) ") that identifies a ``PE32`` from a ``PE64``") .def_property("major_linker_version", static_cast>(&OptionalHeader::major_linker_version), static_cast>(&OptionalHeader::major_linker_version), "The linker major version number") .def_property("minor_linker_version", static_cast>(&OptionalHeader::minor_linker_version), static_cast>(&OptionalHeader::minor_linker_version), "The linker minor version number") .def_property("sizeof_code", static_cast>(&OptionalHeader::sizeof_code), static_cast>(&OptionalHeader::sizeof_code), R"delim( The size of the code ``.text`` section or the sum of all the sections that contain code (ie. :class:`~lief.PE.Section` with the flag :attr:`~lief.PE.SECTION_CHARACTERISTICS.CNT_CODE`) )delim") .def_property("sizeof_initialized_data", static_cast>(&OptionalHeader::sizeof_initialized_data), static_cast>(&OptionalHeader::sizeof_initialized_data), R"delim( The size of the initialized data which are usually located in the ``.data`` section. If the initialized data are split across multiple sections, it is the sum of the sections. The sections associated with the initialized data are usually identified with the flag :attr:`~lief.PE.SECTION_CHARACTERISTICS.CNT_INITIALIZED_DATA` )delim") .def_property("sizeof_uninitialized_data", static_cast>(&OptionalHeader::sizeof_uninitialized_data), static_cast>(&OptionalHeader::sizeof_uninitialized_data), R"delim( The size of the uninitialized data which are usually located in the ``.bss`` section. If the uninitialized data are split across multiple sections, it is the sum of the sections. The sections associated with the uninitialized data are usually identified with the flag :attr:`~lief.PE.SECTION_CHARACTERISTICS.CNT_UNINITIALIZED_DATA` )delim") .def_property("addressof_entrypoint", static_cast>(&OptionalHeader::addressof_entrypoint), static_cast>(&OptionalHeader::addressof_entrypoint), R"delim( The address of the entry point relative to the image base when the executable file is loaded into memory. For program images, this is the starting address. For device drivers, this is the address of the initialization function. An entry point is optional for DLLs. When no entry point is present, this field must be zero. )delim") .def_property("baseof_code", static_cast>(&OptionalHeader::baseof_code), static_cast>(&OptionalHeader::baseof_code), "Address relative to the imagebase where the binary's code starts") .def_property("baseof_data", static_cast>(&OptionalHeader::baseof_data), static_cast>(&OptionalHeader::baseof_data), R"delim( Address relative to the imagebase where the binary's data starts. .. warning:: This value is not present for ``PE64`` files )delim") .def_property("imagebase", static_cast>(&OptionalHeader::imagebase), static_cast>(&OptionalHeader::imagebase), "The preferred base address when mapping the binary in memory") .def_property("section_alignment", static_cast>(&OptionalHeader::section_alignment), static_cast>(&OptionalHeader::section_alignment), R"delim( The alignment (in bytes) of sections when they are loaded into memory. It must be greater than or equal to :attr:`~lief.PE.OptionalHeader.file_alignment` and the default is the page size for the architecture. )delim") .def_property("file_alignment", static_cast>(&OptionalHeader::file_alignment), static_cast>(&OptionalHeader::file_alignment), R"delim( The alignment factor (in bytes) that is used to align the raw data of sections in the image file. The value should be a **power of 2** between 512 and 64K, inclusive. The default value is 512. If the :attr:`~lief.PE.OptionalHeader.section_alignment` is less than the architecture's page size, then :attr:`~lief.PE.OptionalHeader.file_alignment` must match :attr:`~lief.PE.OptionalHeader.section_alignment`. )delim") .def_property("major_operating_system_version", static_cast>(&OptionalHeader::major_operating_system_version), static_cast>(&OptionalHeader::major_operating_system_version), "The major version number of the required operating system.") .def_property("minor_operating_system_version", static_cast>(&OptionalHeader::minor_operating_system_version), static_cast>(&OptionalHeader::minor_operating_system_version), "The minor version number of the required operating system.") .def_property("major_image_version", static_cast>(&OptionalHeader::major_image_version), static_cast>(&OptionalHeader::major_image_version), "The major version number of the image.") .def_property("minor_image_version", static_cast>(&OptionalHeader::minor_image_version), static_cast>(&OptionalHeader::minor_image_version), "The minor version number of the image.") .def_property("major_subsystem_version", static_cast>(&OptionalHeader::major_subsystem_version), static_cast>(&OptionalHeader::major_subsystem_version), "The major version number of the subsystem.") .def_property("minor_subsystem_version", static_cast>(&OptionalHeader::minor_subsystem_version), static_cast>(&OptionalHeader::minor_subsystem_version), "The minor version number of the subsystem") .def_property("win32_version_value", static_cast>(&OptionalHeader::win32_version_value), static_cast>(&OptionalHeader::win32_version_value), "Reserved, must be zero.") .def_property("sizeof_image", static_cast>(&OptionalHeader::sizeof_image), static_cast>(&OptionalHeader::sizeof_image), R"delim( The size (in bytes) of the image, including all headers, as the image is loaded in memory. It must be a multiple of :attr:`~lief.PE.OptionalHeader.section_alignment` and should match :attr:`~lief.PE.Binary.virtual_size`. )delim") .def_property("sizeof_headers", static_cast>(&OptionalHeader::sizeof_headers), static_cast>(&OptionalHeader::sizeof_headers), R"delim( The combined size of an MS-DOS stub, PE header, and section headers rounded up to a multiple of :attr:`~lief.PE.OptionalHeader.file_alignment`. )delim") .def_property("checksum", static_cast>(&OptionalHeader::checksum), static_cast>(&OptionalHeader::checksum), R"delim( The image file checksum. The algorithm for computing the checksum is incorporated into ``IMAGHELP.DLL``. The following are checked for validation at load time all **drivers**, any **DLL loaded at boot** time, and any **DLL** that is loaded into a **critical** Windows process. )delim") .def_property_readonly("computed_checksum", &OptionalHeader::computed_checksum, R"delim( The re-computed value of the :attr:`~lief.PE.OptionalHeader.checksum`. If both values do not match, it could mean that the binary has been modified after the compilation. This value is computed by LIEF when parsing the PE binary. )delim") .def_property("subsystem", static_cast>(&OptionalHeader::subsystem), static_cast>(&OptionalHeader::subsystem), R"delim( Target subsystem (:class:`~lief.PE.SUBSYSTEM`) like Driver, XBox, Windows GUI, .. )delim") .def_property("dll_characteristics", static_cast>(&OptionalHeader::dll_characteristics), static_cast>(&OptionalHeader::dll_characteristics), R"delim( Some characteristics (:class:`~lief.PE.DLL_CHARACTERISTICS`) of the underlying binary like the support of the PIE. The prefix ``dll`` comes from the official PE specifications but these characteristics are also used for **executables** )delim") .def("add", static_cast(&OptionalHeader::add), "Add the given " RST_CLASS_REF(lief.PE.DLL_CHARACTERISTICS) "", "characteristic"_a) .def("remove", static_cast(&OptionalHeader::remove), "Remove the given " RST_CLASS_REF(lief.PE.DLL_CHARACTERISTICS) "", "characteristic"_a) .def_property_readonly("dll_characteristics_lists", &OptionalHeader::dll_characteristics_list, ":attr:`~lief.PE.OptionalHeader.dll_characteristics` as a list of " RST_CLASS_REF(lief.PE.DLL_CHARACTERISTICS) "") .def("has", static_cast(&OptionalHeader::has), "``True`` if the given " RST_CLASS_REF(lief.PE.DLL_CHARACTERISTICS) " is in the " ":attr:`~lief.PE.OptionalHeader.dll_characteristics`", "characteristics"_a) .def_property("sizeof_stack_reserve", static_cast>(&OptionalHeader::sizeof_stack_reserve), static_cast>(&OptionalHeader::sizeof_stack_reserve), R"delim( The size of the stack to reserve. Only :attr:`~lief.PE.OptionalHeader.sizeof_stack_commit` is committed, the rest is made available one page at a time until the reserve size is reached. )delim") .def_property("sizeof_stack_commit", static_cast>(&OptionalHeader::sizeof_stack_commit), static_cast>(&OptionalHeader::sizeof_stack_commit), "The size of the stack to commit.") .def_property("sizeof_heap_reserve", static_cast>(&OptionalHeader::sizeof_heap_reserve), static_cast>(&OptionalHeader::sizeof_heap_reserve), R"delim( The size of the local heap space to reserve. Only :attr:`~lief.PE.OptionalHeader.sizeof_heap_commit` is available one page at a time until the reserve size is reached. )delim") .def_property("sizeof_heap_commit", static_cast>(&OptionalHeader::sizeof_heap_commit), static_cast>(&OptionalHeader::sizeof_heap_commit), "The size of the local heap space to commit.") .def_property("loader_flags", static_cast>(&OptionalHeader::loader_flags), static_cast>(&OptionalHeader::loader_flags), "According to the PE specifications, this value is *reserved* and **should** be 0.") .def_property("numberof_rva_and_size", static_cast>(&OptionalHeader::numberof_rva_and_size), static_cast>(&OptionalHeader::numberof_rva_and_size), "The number of " RST_CLASS_REF(lief.PE.DataDirectory) " that follow this header") .def("__eq__", &OptionalHeader::operator==) .def("__ne__", &OptionalHeader::operator!=) .def("__hash__", [] (const OptionalHeader& optional_header) { return Hash::hash(optional_header); }) .def(py::self += DLL_CHARACTERISTICS()) .def(py::self -= DLL_CHARACTERISTICS()) .def("__contains__", static_cast(&OptionalHeader::has), "Check if the given " RST_CLASS_REF(lief.PE.DLL_CHARACTERISTICS) " is present") .def("__str__", [] (const OptionalHeader& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyParser.cpp000066400000000000000000000040201443457337100214510ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "PyIOStream.hpp" #include "LIEF/PE/Parser.hpp" #include "LIEF/logging.hpp" #include namespace LIEF { namespace PE { template<> void create(py::module& m) { m.def("parse", static_cast (*) (const std::string&)>(&Parser::parse), "Parse the PE binary from the given **file path** and return a " RST_CLASS_REF(lief.PE.Binary) " object", "filename"_a, py::return_value_policy::take_ownership); m.def("parse", static_cast (*) (std::vector, const std::string&)>(&Parser::parse), "Parse the PE binary from the given **list of bytes** and return a :class:`lief.PE.Binary` object", "raw"_a, "name"_a = "", py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, const std::string& name) -> py::object { if (auto stream = PyIOStream::from_python(byteio)) { auto ptr = std::make_unique(std::move(*stream)); return py::cast(PE::Parser::parse(std::move(ptr), name)); } logging::log(logging::LOG_ERR, "Can't create a LIEF stream interface over the provided io"); return py::none(); }, "Parse the PE binary from the given Python IO interface and return a :class:`lief.PE.Binary` object", "io"_a, "name"_a = "", py::return_value_policy::take_ownership); } } } LIEF-0.13.1/api/python/src/PE/objects/pyPogo.cpp000066400000000000000000000035621443457337100211330ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/Pogo.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Pogo::*)(void) const; template using setter_t = void (Pogo::*)(T); template using no_const_getter = T (Pogo::*)(void); template<> void create(py::module& m) { py::class_ pogo(m, "Pogo"); init_ref_iterator(pogo, "it_entries"); pogo .def(py::init<>()) .def_property_readonly("entries", static_cast>(&Pogo::entries), py::return_value_policy::reference_internal) .def_property_readonly("signature", static_cast>(&Pogo::signature), "Type of the pogo (" RST_CLASS_REF(lief.PE.POGO_SIGNATURES) ")") .def("__eq__", &Pogo::operator==) .def("__ne__", &Pogo::operator!=) .def("__hash__", [] (const Pogo& pogo_entry) { return Hash::hash(pogo_entry); }) .def("__str__", [] (const Pogo& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyPogoEntry.cpp000066400000000000000000000036361443457337100221570ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/PogoEntry.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (PogoEntry::*)(void) const; template using setter_t = void (PogoEntry::*)(T); template<> void create(py::module& m) { py::class_(m, "PogoEntry") .def(py::init<>()) .def_property("name", [] (const PogoEntry& obj) { return safe_string_converter(obj.name()); }, static_cast>(&PogoEntry::name)) .def_property("start_rva", static_cast>(&PogoEntry::start_rva), static_cast>(&PogoEntry::start_rva)) .def_property("size", static_cast>(&PogoEntry::size), static_cast>(&PogoEntry::size)) .def("__eq__", &PogoEntry::operator==) .def("__ne__", &PogoEntry::operator!=) .def("__hash__", [] (const PogoEntry& pogo_entry) { return Hash::hash(pogo_entry); }) .def("__str__", [] (const PogoEntry& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyRelocation.cpp000066400000000000000000000053021443457337100223200ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/Relocation.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Relocation::*)(void) const; template using setter_t = void (Relocation::*)(T); template using it_t = T (Relocation::*)(void); template<> void create(py::module& m) { py::class_ reloc(m, "Relocation", R"delim( Class which represents the *Base Relocation Block* Usually, we find this structure in the ``.reloc`` section )delim"); init_ref_iterator(reloc, "it_entries"); reloc .def(py::init<>()) .def_property("virtual_address", static_cast>(&Relocation::virtual_address), static_cast>(&Relocation::virtual_address), "The RVA for which the offset of the relocation entries (RelocationEntry) is added") .def_property("block_size", static_cast>(&Relocation::block_size), static_cast>(&Relocation::block_size), R"delim( The total number of bytes in the base relocation block. ``block_size = sizeof(BaseRelocationBlock) + nb_of_relocs * sizeof(uint16_t = RelocationEntry)`` )delim") .def_property_readonly("entries", static_cast>(&Relocation::entries), "Iterator over the " RST_CLASS_REF(lief.PE.RelocationEntry) "") .def("add_entry", &Relocation::add_entry, "Add a new " RST_CLASS_REF(lief.PE.RelocationEntry) "", "new_entry"_a) .def("__eq__", &Relocation::operator==) .def("__ne__", &Relocation::operator!=) .def("__hash__", [] (const Relocation& relocation) { return Hash::hash(relocation); }) .def("__str__", [] (const Relocation& relocation) { std::ostringstream stream; stream << relocation; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyRelocationEntry.cpp000066400000000000000000000052271443457337100233500ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/RelocationEntry.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (RelocationEntry::*)(void) const; template using setter_t = void (RelocationEntry::*)(T); template<> void create(py::module& m) { py::class_(m, "RelocationEntry", R"delim( Class which represents an entry of the PE relocation table. It extends the :class:`lief.Relocation` object to provide an uniform API across the file formats )delim") .def(py::init<>()) .def_property("data", static_cast>(&RelocationEntry::data), static_cast>(&RelocationEntry::data), R"delim( Raw data of the relocation: * The **high** 4 bits store the relocation :attr:`~lief.PE.RelocationEntry.type` * The **low** 12 bits store the relocation offset (:attr:`~lief.PE.RelocationEntry.position`) )delim") .def_property("position", static_cast>(&RelocationEntry::position), static_cast>(&RelocationEntry::position), "Offset - relative to :attr:`~lief.PE.Relocation.virtual_address` - where the relocation occurs") .def_property("type", static_cast>(&RelocationEntry::type), static_cast>(&RelocationEntry::type), "Type of the relocation (see: " RST_CLASS_REF(lief.PE.RELOCATIONS_BASE_TYPES) ")") .def("__eq__", &RelocationEntry::operator==) .def("__ne__", &RelocationEntry::operator!=) .def("__hash__", [] (const RelocationEntry& relocation_entry) { return Hash::hash(relocation_entry); }) .def("__str__", [] (const RelocationEntry& relocation) { std::ostringstream stream; stream << relocation; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyResourceData.cpp000066400000000000000000000054111443457337100226030ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/ResourceData.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceData::*)(void) const; template using setter_t = void (ResourceData::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceData", R"delim( Class which represents a Data Node in the PE resources tree )delim") .def(py::init<>(), "Default constructor") .def(py::init&, uint32_t>(), "content"_a, "code_page"_a) .def_property("code_page", static_cast>(&ResourceData::code_page), static_cast>(&ResourceData::code_page), R"delim( Return the code page that is used to decode code point values within the resource data. Typically, the code page is the Unicode code page. )delim") .def_property("content", [] (const ResourceData& self) { span content = self.content(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast&>>(&ResourceData::content), "Resource content") .def_property("reserved", static_cast>(&ResourceData::reserved), static_cast>(&ResourceData::reserved), "Reserved value. Should be ``0``") .def_property_readonly("offset", &ResourceData::offset, R"delim( Offset of the content within the resource .. warning:: This value can change when re-building the resource table )delim") .def("__eq__", &ResourceData::operator==) .def("__ne__", &ResourceData::operator!=) .def("__hash__", [] (const ResourceData& node) { return Hash::hash(node); }) .def("__str__", [] (const ResourceData& data) { std::ostringstream stream; stream << data; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyResourceDirectory.cpp000066400000000000000000000065741443457337100237110ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/ResourceDirectory.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceDirectory::*)(void) const; template using setter_t = void (ResourceDirectory::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceDirectory") .def(py::init<>(), "Default constructor") .def_property("characteristics", static_cast>(&ResourceDirectory::characteristics), static_cast>(&ResourceDirectory::characteristics), "Resource characteristics. This field is reserved for future use. " "It is currently set to zero.") .def_property("time_date_stamp", static_cast>(&ResourceDirectory::time_date_stamp), static_cast>(&ResourceDirectory::time_date_stamp), "The time that the resource data was created by the " "resource compiler.") .def_property("major_version", static_cast>(&ResourceDirectory::major_version), static_cast>(&ResourceDirectory::major_version), "The major version number, set by the user.") .def_property("minor_version", static_cast>(&ResourceDirectory::minor_version), static_cast>(&ResourceDirectory::minor_version), "The minor version number, set by the user.") .def_property("numberof_name_entries", static_cast>(&ResourceDirectory::numberof_name_entries), static_cast>(&ResourceDirectory::numberof_name_entries), "The number of directory entries immediately " "following the table that use strings to identify Type, " "Name, or Language entries (depending on the level " "of the table") .def_property("numberof_id_entries", static_cast>(&ResourceDirectory::numberof_id_entries), static_cast>(&ResourceDirectory::numberof_id_entries), "The number of directory entries immediately " "following the Name entries that use numeric IDs for " "Type, Name, or Language entries.") .def("__eq__", &ResourceDirectory::operator==) .def("__ne__", &ResourceDirectory::operator!=) .def("__hash__", [] (const ResourceDirectory& node) { return Hash::hash(node); }) .def("__str__", [] (const ResourceDirectory& directory) { std::ostringstream stream; stream << directory; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyResourceNode.cpp000066400000000000000000000077051443457337100226270ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/utils.hpp" #include "LIEF/PE/ResourceNode.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceNode::*)(void) const; template using setter_t = void (ResourceNode::*)(T); template<> void create(py::module& m) { py::class_ res_node(m, "ResourceNode", R"delim( Class which represents a Node in the resource tree. It is extended by :class:`lief.PE.ResourceData` and :class:`lief.PE.ResourceNode` )delim"); init_ref_iterator(res_node, "it_childs"); res_node .def_property("id", static_cast>(&ResourceNode::id), static_cast>(&ResourceNode::id), "Integer that identifies the Type, Name, or " "Language ID entry.") .def_property_readonly("is_directory", &ResourceNode::is_directory, "``True`` if the current resource is a " RST_CLASS_REF(lief.PE.ResourceDirectory) "") .def_property_readonly("is_data", &ResourceNode::is_data, "``True`` if the current resource is a " RST_CLASS_REF(lief.PE.ResourceData) "") .def_property_readonly("has_name", &ResourceNode::has_name, "``True`` if the current resource uses a name") .def_property("name", [] (const ResourceNode& node) { return safe_string_converter(LIEF::u16tou8(node.name())); }, static_cast(&ResourceNode::name), "Resource's name") .def_property_readonly("childs", static_cast(&ResourceNode::childs), "Node's childs") .def("add_directory_node", static_cast(&ResourceNode::add_child), "Add a " RST_CLASS_REF(lief.PE.ResourceDirectory) " to the current node", "resource_directory"_a, py::return_value_policy::reference) .def("add_data_node", static_cast(&ResourceNode::add_child), "Add a " RST_CLASS_REF(lief.PE.ResourceData) " to the current node", "resource_data"_a, py::return_value_policy::reference) .def("delete_child", static_cast(&ResourceNode::delete_child), "Delete the given " RST_CLASS_REF(lief.PE.ResourceNode) " from childs", "node"_a) .def("delete_child", static_cast(&ResourceNode::delete_child), "Delete the " RST_CLASS_REF(lief.PE.ResourceNode) " with the given :attr:`~lief.PE.ResourceNode.id` from childs", "id"_a) .def_property_readonly("depth", &ResourceNode::depth, "Current depth of the entry in the resource tree") .def("__eq__", &ResourceNode::operator==) .def("__ne__", &ResourceNode::operator!=) .def("__hash__", [] (const ResourceNode& node) { return Hash::hash(node); }) .def("__str__", [] (const ResourceNode& node) { std::ostringstream stream; stream << node; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyResourcesManager.cpp000066400000000000000000000127711443457337100234760ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * Copyright 2017 - 2021 K. Nakagawa * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "pyErr.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/ResourcesManager.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourcesManager::*)(void) const; template using setter_t = void (ResourcesManager::*)(T); template using no_const_func = T (ResourcesManager::*)(P); template<> void create(py::module& m) { py::class_ manager(m, "ResourcesManager", "The Resource Manager provides an enhanced API to manipulate the resource tree"); init_ref_iterator(manager, "it_const_dialogs"); init_ref_iterator(manager, "it_const_icons"); init_ref_iterator(manager, "it_const_strings_table"); init_ref_iterator(manager, "it_const_accelerators"); manager .def_property_readonly("has_manifest", &ResourcesManager::has_manifest, "``True`` if the resources contain a Manifest element") .def_property("manifest", [] (const ResourcesManager& obj) { return safe_string_converter(obj.manifest()); }, static_cast>(&ResourcesManager::manifest), "Manifest as a ``string``") .def_property_readonly("has_version", &ResourcesManager::has_version, "``true`` if the resources contain a " RST_CLASS_REF(lief.PE.ResourceVersion) "") .def_property_readonly("version", [] (ResourcesManager& self) { return error_or(&ResourcesManager::version, self); }, "Return the " RST_CLASS_REF(lief.PE.ResourceVersion) "") .def_property_readonly("has_icons", &ResourcesManager::has_icons, "``true`` if the resources contain " RST_CLASS_REF(lief.PE.ResourceIcon) "") .def_property_readonly("icons", &ResourcesManager::icons, "Return the list of the " RST_CLASS_REF(lief.PE.ResourceIcon) " present in the resource") .def("change_icon", &ResourcesManager::change_icon, "Switch the given icons", "old_one"_a, "new_one"_a) .def_property_readonly("has_dialogs", &ResourcesManager::has_dialogs, "``true`` if the resources contain " RST_CLASS_REF(lief.PE.ResourceDialog) "") .def_property_readonly("dialogs", &ResourcesManager::dialogs, "Return the list of the " RST_CLASS_REF(lief.PE.ResourceDialog) " present in the resource") .def_property_readonly("types_available", &ResourcesManager::get_types_available, "Return list of " RST_CLASS_REF(lief.PE.RESOURCE_TYPES) " present in the resources") .def_property_readonly("langs_available", &ResourcesManager::get_langs_available, "Return list of " RST_CLASS_REF(lief.PE.RESOURCE_LANGS) " present in the resources") .def_property_readonly("sublangs_available", &ResourcesManager::get_sublangs_available, "Return list of " RST_CLASS_REF(lief.PE.RESOURCE_SUBLANGS) " present in the resources") .def("add_icon", &ResourcesManager::add_icon, "Add an icon to the resources", "icon"_a) .def("has_type", &ResourcesManager::has_type, "``True`` if the resource has the given " RST_CLASS_REF(lief.PE.RESOURCE_TYPES) "", "type"_a) .def_property_readonly("has_string_table", &ResourcesManager::has_string_table, "``True`` if resources contain " RST_CLASS_REF(lief.PE.ResourceStringTable) "") .def_property_readonly("string_table", &ResourcesManager::string_table, "Return list of " RST_CLASS_REF(lief.PE.ResourceStringTable) " present in the resource") .def_property_readonly("has_html", &ResourcesManager::has_html, "``True`` if resources contain HTML resource") .def_property_readonly("html", &ResourcesManager::html, "HTML resource as the list of ``string``") .def_property_readonly("has_accelerator", &ResourcesManager::has_accelerator, "``True`` if resources contain " RST_CLASS_REF(lief.PE.ResourceAccelerator) "") .def_property_readonly("accelerator", &ResourcesManager::accelerator, "Return list of " RST_CLASS_REF(lief.PE.ResourceAccelerator) " present in the resource") .def("get_node_type", static_cast>(&ResourcesManager::get_node_type), R"delim( Return :class:`~lief.PE.ResourceNode` with the given :class:`~lief.PE.RESOURCE_TYPES` or None if not found. )delim", "type"_a, py::return_value_policy::reference) .def("__str__", [] (const ResourcesManager& manager) { std::ostringstream stream; stream << manager; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyRichEntry.cpp000066400000000000000000000044471443457337100221410ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/RichEntry.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (RichEntry::*)(void) const; template using setter_t = void (RichEntry::*)(T); template<> void create(py::module& m) { py::class_(m, "RichEntry", R"delim( Class which represents an entry associated to the RichHeader )delim") .def(py::init<>()) .def(py::init(), "Contructor from " ":attr:`~lief.PE.RichEntry.id`, " ":attr:`~lief.PE.RichEntry.build_id` and " ":attr:`~lief.PE.RichEntry.count`", "id"_a, "build_id"_a, "count"_a) .def_property("id", static_cast>(&RichEntry::id), static_cast>(&RichEntry::id), "Type of the entry") .def_property("build_id", static_cast>(&RichEntry::build_id), static_cast>(&RichEntry::build_id), "Builder number of the tool (if any)") .def_property("count", static_cast>(&RichEntry::count), static_cast>(&RichEntry::count), "*Occurrence* count") .def("__eq__", &RichEntry::operator==) .def("__ne__", &RichEntry::operator!=) .def("__hash__", [] (const RichEntry& entry) { return Hash::hash(entry); }) .def("__str__", [] (const RichEntry& entry) { std::ostringstream stream; stream << entry; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyRichHeader.cpp000066400000000000000000000101351443457337100222170ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/RichHeader.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (RichHeader::*)(void) const; template using setter_t = void (RichHeader::*)(T); template using no_const_getter = T (RichHeader::*)(void); template<> void create(py::module& m) { py::class_ rich(m, "RichHeader", R"delim( Class which represents the not-so-documented rich header This structure is usually located at the end of the :attr:`~lief.PE.Binary.dos_stub` and contains information about the build environment. It is generated by the Microsoft linker `link.exe` and there are no options to disable or remove this information. )delim"); init_ref_iterator(rich, "it_entries"); rich .def(py::init<>()) .def_property("key", static_cast>(&RichHeader::key), static_cast>(&RichHeader::key), "Key used to encode the header (xor operation)") .def_property_readonly("entries", static_cast>(&RichHeader::entries), "Return an iterator over the " RST_CLASS_REF(lief.PE.RichEntry) " within the header", py::return_value_policy::reference) .def("add_entry", static_cast(&RichHeader::add_entry), "Add a new " RST_CLASS_REF(lief.PE.RichEntry) "", "entry"_a) .def("add_entry", static_cast(&RichHeader::add_entry), "Add a new " RST_CLASS_REF(lief.PE.RichEntry) " given its " ":attr:`~lief.PE.RichEntry.id`, " ":attr:`~lief.PE.RichEntry.build_id`, " ":attr:`~lief.PE.RichEntry.count`", "id"_a, "build_id"_a, "count"_a) .def("raw", py::overload_cast<>(&RichHeader::raw, py::const_), R"delim( The raw structure of the Rich header without xor-encoding. This function is equivalent as calling the other raw function with a `xor_key` set to 0 )delim") .def("raw", py::overload_cast(&RichHeader::raw, py::const_), R"delim( Given this rich header, this function re-computes the raw bytes of the structure with the provided xor-key. You can access the decoded data's structure with the `xor_key` set to 0 )delim", "xor_key"_a) .def("hash", py::overload_cast(&RichHeader::hash, py::const_), R"delim( Compute the hash of the decoded rich header structure with the given hash :class:`~lief.PE.ALGORITHMS` )delim", "algo"_a) .def("hash", py::overload_cast(&RichHeader::hash, py::const_), R"delim( Compute the hash of the rich header structure encoded with the provided key and the given hash :class:`~lief.PE.ALGORITHMS` )delim", "algo"_a, "xor_key"_a) .def("__eq__", &RichHeader::operator==) .def("__ne__", &RichHeader::operator!=) .def("__hash__", [] (const RichHeader& rich_header) { return Hash::hash(rich_header); }) .def("__str__", [] (const RichHeader& rich_header) { std::ostringstream stream; stream << rich_header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pySection.cpp000066400000000000000000000131431443457337100216270ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/Abstract/Section.hpp" #include "LIEF/PE/Section.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Section::*)(void) const; template using setter_t = void (Section::*)(T); template<> void create
(py::module& m) { py::class_(m, "Section", R"delim( Class which represents a PE section. It extends the base class :class:`lief.Section` )delim") .def(py::init<>()) .def(py::init&, const std::string&, uint32_t>(), "Constructor from " ":attr:`~lief.PE.Section.content`, " ":attr:`~lief.PE.Section.name` and " ":attr:`~lief.PE.Section.characteristics`", "content"_a, py::arg("name") = "", py::arg("characteristics") = 0) .def(py::init(), "Constructor from a " ":attr:`~lief.PE.Section.name`", "name"_a) .def_property("virtual_size", static_cast>(&Section::virtual_size), static_cast>(&Section::virtual_size), R"delim( The total size of the section when loaded into memory. If this value is greater than :attr:`~lief.PE.Section.sizeof_raw_data`, the section is zero-padded. )delim") .def_property("sizeof_raw_data", static_cast>(&Section::sizeof_raw_data), static_cast>(&Section::sizeof_raw_data), "Alias of :attr:`~lief.PE.Section.size` (size of the data in the section)") .def_property("pointerto_raw_data", static_cast>(&Section::pointerto_raw_data), static_cast>(&Section::pointerto_raw_data), "The offset of the section data in the PE file. Alias of :attr:`~lief.PE.Section.offset`") .def_property("pointerto_relocation", static_cast>(&Section::pointerto_relocation), static_cast>(&Section::pointerto_relocation), R"delim( The file pointer to the beginning of the COFF relocation entries for the section. This is set to zero for executable images or if there are no relocations. For modern PE binaries, this value is usually set to 0 as the relocations are managed by :class:`~lief.PE.Relocation`. )delim") .def_property("pointerto_line_numbers", static_cast>(&Section::pointerto_line_numbers), static_cast>(&Section::pointerto_line_numbers), R"delim( The file pointer to the beginning of line-number entries for the section. This is set to zero if there are no COFF line numbers. This value should be zero for an image because COFF debugging information is deprecated and modern debug information relies on the PDB files. )delim") .def_property("numberof_relocations", static_cast>(&Section::numberof_relocations), static_cast>(&Section::numberof_relocations), R"delim( The number of relocation entries for the section. See: :attr:`~lief.PE.Section.pointerto_relocation` )delim") .def_property("numberof_line_numbers", static_cast>(&Section::numberof_line_numbers), static_cast>(&Section::numberof_line_numbers), R"delim( The number of line-number entries for the section. This value should be zero for an image because COFF debugging information is deprecated. See: :attr:`~lief.PE.Section.pointerto_line_numbers` )delim") .def_property("characteristics", static_cast>(&Section::characteristics), static_cast>(&Section::characteristics), "The " RST_CLASS_REF(lief.PE.SECTION_CHARACTERISTICS) " that describe the characteristics of the section") .def_property_readonly("characteristics_lists", &Section::characteristics_list, ":attr:`~lief.PE.Section.characteristics` as a ``list``") .def("has_characteristic", &Section::has_characteristic, "``True`` if the section has the given " RST_CLASS_REF(lief.PE.SECTION_CHARACTERISTICS) "", "characteristic"_a) .def_property_readonly("padding", [] (const Section& sec) { const std::vector& data = sec.padding(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Section padding content as bytes") .def("__eq__", &Section::operator==) .def("__ne__", &Section::operator!=) .def("__hash__", [] (const Section& section) { return Hash::hash(section); }) .def("__str__", [] (const Section& section) { std::ostringstream stream; stream << section; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pySymbol.cpp000066400000000000000000000044771443457337100215020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/Symbol.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Symbol::*)(void) const; template using setter_t = void (Symbol::*)(T); template using no_const_getter = T (Symbol::*)(void); template<> void create(py::module& m) { py::class_(m, "Symbol") .def(py::init<>()) .def_property("name", static_cast> (&Symbol::wname), static_cast>(&Symbol::name)) .def_property_readonly("section_number", &Symbol::section_number) .def_property_readonly("type", &Symbol::type) .def_property_readonly("base_type", &Symbol::base_type) .def_property_readonly("complex_type", &Symbol::complex_type) .def_property_readonly("storage_class", &Symbol::storage_class) .def_property_readonly("numberof_aux_symbols", &Symbol::numberof_aux_symbols) .def_property_readonly("section", static_cast>(&Symbol::section), py::return_value_policy::reference) .def_property_readonly("has_section", &Symbol::has_section, "``True`` if symbols are located in a section") .def("__eq__", &Symbol::operator==) .def("__ne__", &Symbol::operator!=) .def("__hash__", [] (const Symbol& symbol) { return Hash::hash(symbol); }) .def("__str__", [] (const Symbol& symbol) { std::ostringstream stream; stream << symbol; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/pyTLS.cpp000066400000000000000000000131041443457337100206620ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/TLS.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (TLS::*)(void) const; template using setter_t = void (TLS::*)(T); template using no_const_getter = T (TLS::*)(void); template<> void create(py::module& m) { py::class_(m, "TLS", R"delim( Class which represents the PE Thread Local Storage. This PE structure is also used to implement binary/library constructors. )delim") .def(py::init<>(), "Default constructor") .def_property("callbacks", static_cast&>>(&TLS::callbacks), static_cast&>>(&TLS::callbacks), R"delim( List of the callback associated with the current TLS. These functions are called before any other functions of the PE binary. )delim") .def_property("addressof_index", static_cast>(&TLS::addressof_index), static_cast>(&TLS::addressof_index), R"delim( The location to receive the TLS index, which the loader assigns. This location is in an ordinary data section, so it can be given a symbolic name that is accessible to the program. )delim") .def_property("addressof_callbacks", static_cast>(&TLS::addressof_callbacks), static_cast>(&TLS::addressof_callbacks), R"delim( The pointer to an array of TLS callback functions. The array is null-terminated, so if no callback function is supported, this field points to 4 bytes set to zero. See: :attr:`~lief.PE.TLS.callbacks` )delim") .def_property("sizeof_zero_fill", static_cast>(&TLS::sizeof_zero_fill), static_cast>(&TLS::sizeof_zero_fill), R"delim( The size in bytes of the template, beyond the initialized data delimited by the :attr:`~lief.PE.TLS.addressof_raw_data` fields. The total template size should be the same as the total size of TLS data in the image file. The zero fill is the amount of data that comes after the initialized nonzero data. )delim") .def_property("characteristics", static_cast>(&TLS::characteristics), static_cast>(&TLS::characteristics), R"delim( The four bits [23:20] describe alignment info. Possible values are those defined as IMAGE_SCN_ALIGN_*, which are also used to describe alignment of section in object files. The other 28 bits are reserved for future use. )delim") .def_property("addressof_raw_data", static_cast>>(&TLS::addressof_raw_data), static_cast>>(&TLS::addressof_raw_data), R"delim( Tuple ``(start address, end address)`` of the TLS template. The template is a block of data that is used to initialize TLS data. The system copies all of this data each time a thread is created, so it must not be corrupted. .. note:: These addresses are not RVA. It is addresses for which there should be a base relocation in the ``.reloc`` section. )delim") .def_property("data_template", [] (const TLS& self) { span content = self.data_template(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast&>>(&TLS::data_template), "The data template content") .def_property_readonly("has_section", &TLS::has_section, "``True`` if there is a " RST_CLASS_REF(lief.PE.Section) " associated with the TLS object") .def_property_readonly("has_data_directory", &TLS::has_data_directory, "``True`` if there is a " RST_CLASS_REF(lief.PE.DataDirectory) " associated with the TLS object") .def_property_readonly("directory", static_cast>(&TLS::directory), "" RST_CLASS_REF(lief.PE.DataDirectory) " associated with the TLS object (or None if not linked)", py::return_value_policy::reference) .def_property_readonly("section", static_cast>(&TLS::section), "" RST_CLASS_REF(lief.PE.Section) " associated with the TLS object (or None if not linked)", py::return_value_policy::reference) .def("__eq__", &TLS::operator==) .def("__ne__", &TLS::operator!=) .def("__hash__", [] (const TLS& tls) { return Hash::hash(tls); }) .def("__str__", [] (const TLS& tls) { std::ostringstream stream; stream << tls; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/000077500000000000000000000000001443457337100211565ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/PE/objects/resources/pyLangCodeItem.cpp000066400000000000000000000075521443457337100245370ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/LangCodeItem.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (LangCodeItem::*)(void) const; template using setter_t = void (LangCodeItem::*)(T); template<> void create(py::module& m) { py::class_(m, "LangCodeItem", R"delim( Class which represents the childs of the :class:`~lief.PE.ResourceStringFileInfo` See: https://docs.microsoft.com/en-us/windows/win32/menurc/stringtable )delim") .def_property("type", static_cast>(&LangCodeItem::type), static_cast>(&LangCodeItem::type), R"delim( The type of data in the version resource * ``1`` if it contains text data * ``0`` if it contains binary data )delim") .def_property("key", static_cast>(&LangCodeItem::key), static_cast>(&LangCodeItem::key), R"delim( A 8-digit hexadecimal number stored as an Unicode string * The four most significant digits represent the language identifier. * The four least significant digits represent the code page for which the data is formatted. See: * :attr:`~lief.PE.LangCodeItem.code_page` * :attr:`~lief.PE.LangCodeItem.lang` * :attr:`~lief.PE.LangCodeItem.sublang` )delim") .def_property("lang", static_cast>(&LangCodeItem::lang), static_cast>(&LangCodeItem::lang), "Lang (" RST_CLASS_REF(lief.PE.RESOURCE_LANGS) ") for which " ":attr:`~lief.PE.LangCodeItem.items` are defined") .def_property("sublang", static_cast>(&LangCodeItem::sublang), static_cast>(&LangCodeItem::sublang), "Sub-lang (" RST_CLASS_REF(lief.PE.RESOURCE_SUBLANGS) ") for which " ":attr:`~lief.PE.LangCodeItem.items` are defined") .def_property("code_page", static_cast>(&LangCodeItem::code_page), static_cast>(&LangCodeItem::code_page), R"delim( :class:`~lief.PE.CODE_PAGES` for which :attr:`~lief.PE.LangCodeItem.items` are defined. See: https://docs.microsoft.com/en-us/windows/win32/intl/code-page-identifiers )delim") .def_property("items", [] (const LangCodeItem& item) -> py::dict { py::dict output; for (const auto& p : item.items()) { output[u16tou8(p.first).c_str()] = py::bytes(u16tou8(p.second)); } return output; }, static_cast>(&LangCodeItem::items)) .def("__eq__", &LangCodeItem::operator==) .def("__ne__", &LangCodeItem::operator!=) .def("__hash__", [] (const LangCodeItem& item) { return Hash::hash(item); }) .def("__str__", [] (const LangCodeItem& item) { std::ostringstream stream; stream << item; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceAccelerator.cpp000066400000000000000000000042111443457337100261650ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * Copyright 2017 - 2021 K. Nakagawa * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceAccelerator.hpp" namespace LIEF { namespace PE { template using getter_t = T (ResourceAccelerator::*)(void) const; template using setter_t = void (ResourceAccelerator::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceAccelerator") .def_property_readonly("flags", static_cast>(&ResourceAccelerator::flags), "Describe the keyboard accelerator characteristics.") .def_property_readonly("ansi", static_cast>(&ResourceAccelerator::ansi), "An ANSI character value or a virtual-key code that identifies the accelerator key.") .def_property_readonly("id", static_cast>(&ResourceAccelerator::id), "An identifier for the keyboard accelerator.") .def_property_readonly("padding", static_cast>(&ResourceAccelerator::padding), "The number of bytes inserted to ensure that the structure is aligned on a DWORD boundary.") .def("__eq__", &ResourceAccelerator::operator==) .def("__ne__", &ResourceAccelerator::operator!=) .def("__hash__", [] (const ResourceAccelerator& acc) { return Hash::hash(acc); }) .def("__str__", [] (const ResourceAccelerator& acc) { std::ostringstream stream; stream << acc; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceDialog.cpp000066400000000000000000000150421443457337100251440ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyIterators.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceDialog.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceDialog::*)(void) const; template using setter_t = void (ResourceDialog::*)(T); template<> void create(py::module& m) { py::class_ dialog(m, "ResourceDialog", R"delim( Representation of a dialog box. Windows allows two kinds of dialog box: * Simple one * Extended one :attr:`~lief.PE.ResourceDialog.is_extended` can be used to determine which one is implemented )delim"); init_ref_iterator(dialog, "it_const_items"); dialog .def_property_readonly("is_extended", &ResourceDialog::is_extended, "``True`` if the dialog is an extended one") .def_property_readonly("version", &ResourceDialog::version, "The version number of the extended dialog box template. This member must be set to 1.") .def_property_readonly("signature", &ResourceDialog::signature, R"delim( Indicate whether a template is an extended dialog box template: * ``0xFFFF``: Extended dialog box template * Other value: Standard dialog box template )delim") .def_property_readonly("help_id", &ResourceDialog::version, "The help context identifier for the dialog box window") .def_property_readonly("x", static_cast>(&ResourceDialog::x), "The x-coordinate, in dialog box units, of the upper-left corner of the dialog box.") .def_property_readonly("y", static_cast>(&ResourceDialog::y), "The y-coordinate, in dialog box units, of the upper-left corner of the dialog box.") .def_property_readonly("cx", static_cast>(&ResourceDialog::cx), "The width, in dialog box units, of the dialog box.") .def_property_readonly("cy", static_cast>(&ResourceDialog::cy), "The height, in dialog box units, of the dialog box.") .def_property_readonly("title", static_cast>(&ResourceDialog::title), "The title of the dialog box") .def_property_readonly("typeface", static_cast>(&ResourceDialog::typeface), "The name of the typeface for the font") .def_property_readonly("weight", static_cast>(&ResourceDialog::weight), "The weight of the font") .def_property_readonly("point_size", static_cast>(&ResourceDialog::point_size), "The point size of the font to use for the text in the dialog box and its controls.") .def_property_readonly("charset", static_cast>(&ResourceDialog::charset), "The character set to be used") .def_property_readonly("style_list", &ResourceDialog::style_list, "Return list of " RST_CLASS_REF(lief.PE.WINDOW_STYLES) " associated with the " ":attr:`~lief.PE.ResourceDialog.style` member") .def_property_readonly("dialogbox_style_list", &ResourceDialog::dialogbox_style_list, "Return list of " RST_CLASS_REF(lief.PE.DIALOG_BOX_STYLES) " associated with the " ":attr:`~lief.PE.ResourceDialog.style` member") .def_property_readonly("extended_style_list", &ResourceDialog::dialogbox_style_list, "Return list of " RST_CLASS_REF(lief.PE.EXTENDED_WINDOW_STYLES) " associated with the " ":attr:`~lief.PE.ResourceDialog.extended_style` member") .def_property_readonly("style", &ResourceDialog::extended_style, "The style of the dialog box. This member can be a combination of " RST_CLASS_REF(lief.PE.WINDOW_STYLES) " and " RST_CLASS_REF(lief.PE.DIALOG_BOX_STYLES) "") .def_property_readonly("extended_style", &ResourceDialog::extended_style, "The extended windows styles (" RST_CLASS_REF(lief.PE.EXTENDED_WINDOW_STYLES) ")") .def_property_readonly("items", &ResourceDialog::items, "Iterator over the controls (" RST_CLASS_REF(lief.PE.ResourceDialogItem) ") that defines the Dialog (Button, Label...)") .def("has_style", &ResourceDialog::has_style, "Check if the :attr:`~lief.PE.ResourceDialog.style` member has the given " "" RST_CLASS_REF(lief.PE.WINDOW_STYLES) "", "style"_a) .def("has_dialogbox_style", &ResourceDialog::has_dialogbox_style, "Check if the :attr:`~lief.PE.ResourceDialog.style` member has the given " "" RST_CLASS_REF(lief.PE.DIALOG_BOX_STYLES) "", "style"_a) .def("has_extended_style", &ResourceDialog::has_extended_style, "Check if the :attr:`~lief.PE.ResourceDialog.extended_style` member has the given " "" RST_CLASS_REF(lief.PE.EXTENDED_WINDOW_STYLES) "", "style"_a) .def_property("lang", static_cast>(&ResourceDialog::lang), static_cast>(&ResourceDialog::lang), "Primary " RST_CLASS_REF(lief.PE.RESOURCE_LANGS) " associated with the dialog") .def_property("sub_lang", static_cast>(&ResourceDialog::sub_lang), static_cast>(&ResourceDialog::sub_lang), "Secondary " RST_CLASS_REF(lief.PE.RESOURCE_SUBLANGS) " associated with the dialog") .def("__eq__", &ResourceDialog::operator==) .def("__ne__", &ResourceDialog::operator!=) .def("__hash__", [] (const ResourceDialog& dialog) { return Hash::hash(dialog); }) .def("__str__", [] (const ResourceDialog& dialog) { std::ostringstream stream; stream << dialog; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceDialogItem.cpp000066400000000000000000000064731443457337100257730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceDialogItem.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceDialogItem::*)(void) const; template using setter_t = void (ResourceDialogItem::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceDialogItem", R"delim( This class represents an item in the :class:`lief.PE.ResourceDialog` )delim") .def_property_readonly("is_extended", &ResourceDialogItem::is_extended, "``True`` if the control is an extended one") .def_property_readonly("help_id", static_cast>(&ResourceDialogItem::help_id), "The help context identifier for the control") .def_property_readonly("extended_style", static_cast>(&ResourceDialogItem::extended_style), "The extended styles for the window") .def_property_readonly("style", static_cast>(&ResourceDialogItem::style), "The style of the control. This member can be a combination of " "" RST_CLASS_REF(lief.PE.WINDOW_STYLES) " values " "and one or more of the control style values.") .def_property_readonly("x", static_cast>(&ResourceDialogItem::x), "The x-coordinate, in dialog box units, of the upper-left corner of the control") .def_property_readonly("y", static_cast>(&ResourceDialogItem::y), "The y-coordinate, in dialog box units, of the upper-left corner of the control") .def_property_readonly("cx", static_cast>(&ResourceDialogItem::cx), "The width, in dialog box units, of the control") .def_property_readonly("cy", static_cast>(&ResourceDialogItem::cy), "The height, in dialog box units, of the control") .def_property_readonly("id", static_cast>(&ResourceDialogItem::id), "The control identifier") .def_property_readonly("title", static_cast>(&ResourceDialogItem::title), "Initial text of the control") .def("__eq__", &ResourceDialogItem::operator==) .def("__ne__", &ResourceDialogItem::operator!=) .def("__hash__", [] (const ResourceDialogItem& dialog) { return Hash::hash(dialog); }) .def("__str__", [] (const ResourceDialogItem& dialog_item) { std::ostringstream stream; stream << dialog_item; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceFixedFileInfo.cpp000066400000000000000000000147221443457337100264240ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceFixedFileInfo.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceFixedFileInfo::*)(void) const; template using setter_t = void (ResourceFixedFileInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceFixedFileInfo", R"delim( Representation of the `VS_FIXEDFILEINFO `_ structure )delim") .def_property("signature", static_cast>(&ResourceFixedFileInfo::signature), static_cast>(&ResourceFixedFileInfo::signature), "Must be set to ``0xFEEF04BD``") .def_property("struct_version", static_cast>(&ResourceFixedFileInfo::struct_version), static_cast>(&ResourceFixedFileInfo::struct_version), R"delim( The binary version number of this structure. * The high-order word of this member contains the major version number. * The low-order word contains the minor version number )delim") .def_property("file_version_MS", static_cast>(&ResourceFixedFileInfo::file_version_MS), static_cast>(&ResourceFixedFileInfo::file_version_MS), R"delim( The **most** significant 32 bits of the file's binary version number This member is used with :attr:`~lief.PE.ResourceFixedFileInfo.file_version_LS` to form a 64-bits value used for numeric comparisons. )delim") .def_property("file_version_LS", static_cast>(&ResourceFixedFileInfo::file_version_LS), static_cast>(&ResourceFixedFileInfo::file_version_LS), R"delim( The **least** significant 32 bits of the file's binary version number This member is used with :attr:`~lief.PE.ResourceFixedFileInfo.file_version_MS` to form a 64-bits value used for numeric comparisons. )delim") .def_property("product_version_MS", static_cast>(&ResourceFixedFileInfo::product_version_MS), static_cast>(&ResourceFixedFileInfo::product_version_MS), R"delim( The **most** significant 32 bits of the product with which this file was distributed This member is used with :attr:`~lief.PE.ResourceFixedFileInfo.product_version_LS` to form a 64-bits value used for numeric comparisons. )delim") .def_property("product_version_LS", static_cast>(&ResourceFixedFileInfo::product_version_LS), static_cast>(&ResourceFixedFileInfo::product_version_LS), R"delim( The **least** significant 32 bits of the product with which this file was distributed This member is used with :attr:`~lief.PE.ResourceFixedFileInfo.product_version_MS` to form a 64-bits value used for numeric comparisons. )delim") .def_property("file_flags_mask", static_cast>(&ResourceFixedFileInfo::file_flags_mask), static_cast>(&ResourceFixedFileInfo::file_flags_mask), R"delim( Contains a bitmask that specifies the valid bits in :attr:`~lief.PE.ResourceFixedFileInfo.file_flags`. A bit is valid only if it was defined when the file was created. )delim") .def_property("file_flags", static_cast>(&ResourceFixedFileInfo::file_flags), static_cast>(&ResourceFixedFileInfo::file_flags), "Contains a bitmask that specifies the Boolean attributes of the file (" RST_CLASS_REF(lief.PE.FIXED_VERSION_FILE_FLAGS) ")") .def_property("file_os", static_cast>(&ResourceFixedFileInfo::file_os), static_cast>(&ResourceFixedFileInfo::file_os), "The operating system for which this file was designed (" RST_CLASS_REF(lief.PE.FIXED_VERSION_OS) ")") .def_property("file_type", static_cast>(&ResourceFixedFileInfo::file_type), static_cast>(&ResourceFixedFileInfo::file_type), "The general type of file (" RST_CLASS_REF(lief.PE.FIXED_VERSION_FILE_TYPES) ")") .def_property("file_subtype", static_cast>(&ResourceFixedFileInfo::file_subtype), static_cast>(&ResourceFixedFileInfo::file_subtype), "The function of the file (" RST_CLASS_REF(lief.PE.FIXED_VERSION_FILE_SUB_TYPES) ")") .def_property("file_date_MS", static_cast>(&ResourceFixedFileInfo::file_date_MS), static_cast>(&ResourceFixedFileInfo::file_date_MS), "The **most** significant 32 bits of the file's 64-bit binary creation date and time stamp") .def_property("file_date_LS", static_cast>(&ResourceFixedFileInfo::file_date_LS), static_cast>(&ResourceFixedFileInfo::file_date_LS), "The **least** significant 32 bits of the file's 64-bit binary creation date and time stamp") .def("__eq__", &ResourceFixedFileInfo::operator==) .def("__ne__", &ResourceFixedFileInfo::operator!=) .def("__hash__", [] (const ResourceFixedFileInfo& fixed_file_info) { return Hash::hash(fixed_file_info); }) .def("__str__", [] (const ResourceFixedFileInfo& fixed_file_info) { std::ostringstream stream; stream << fixed_file_info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceIcon.cpp000066400000000000000000000072401443457337100246360ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceIcon.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceIcon::*)(void) const; template using setter_t = void (ResourceIcon::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceIcon") .def_property("id", static_cast>(&ResourceIcon::id), static_cast>(&ResourceIcon::id), "Id associated with the icon") .def_property("lang", static_cast>(&ResourceIcon::lang), static_cast>(&ResourceIcon::lang), "Language (" RST_CLASS_REF(lief.PE.RESOURCE_LANGS) ") associated with the icon") .def_property("sublang", static_cast>(&ResourceIcon::sublang), static_cast>(&ResourceIcon::sublang), "Sub language (" RST_CLASS_REF(lief.PE.RESOURCE_SUBLANGS) ") associated with the icon") .def_property("width", static_cast>(&ResourceIcon::width), static_cast>(&ResourceIcon::width), "Width in pixels of the image") .def_property("height", static_cast>(&ResourceIcon::height), static_cast>(&ResourceIcon::height), "Height in pixels of the image") .def_property("color_count", static_cast>(&ResourceIcon::color_count), static_cast>(&ResourceIcon::color_count), "Number of colors in image (0 if >=8bpp)") .def_property("reserved", static_cast>(&ResourceIcon::reserved), static_cast>(&ResourceIcon::reserved), "Reserved (must be 0)") .def_property("planes", static_cast>(&ResourceIcon::planes), static_cast>(&ResourceIcon::planes), "Color Planes") .def_property("bit_count", static_cast>(&ResourceIcon::bit_count), static_cast>(&ResourceIcon::bit_count), "Bits per pixel") .def_property("pixels", [] (ResourceIcon& self) { span content = self.pixels(); return py::memoryview::from_memory(content.data(), content.size()); }, static_cast&>>(&ResourceIcon::pixels)) .def("save", &ResourceIcon::save, "Save the icon to the given filepath", "filepath"_a) .def("__eq__", &ResourceIcon::operator==) .def("__ne__", &ResourceIcon::operator!=) .def("__hash__", [] (const ResourceIcon& icon) { return Hash::hash(icon); }) .def("__str__", [] (const ResourceIcon& icon) { std::ostringstream stream; stream << icon; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceStringFileInfo.cpp000066400000000000000000000055121443457337100266300ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceStringFileInfo.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceStringFileInfo::*)(void) const; template using setter_t = void (ResourceStringFileInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceStringFileInfo", R"delim( Representation of the ``StringFileInfo`` structure See: https://docs.microsoft.com/en-us/windows/win32/menurc/stringfileinfo )delim") .def_property("type", static_cast>(&ResourceStringFileInfo::type), static_cast>(&ResourceStringFileInfo::type), R"delim( The type of data in the version resource: * ``1`` if it contains text data * ``0`` if it contains binary data )delim") .def_property("key", static_cast>(&ResourceStringFileInfo::key), static_cast>(&ResourceStringFileInfo::key), "Signature of the structure. Must be ``StringFileInfo``") .def_property("langcode_items", static_cast& (ResourceStringFileInfo::*)(void)>(&ResourceStringFileInfo::langcode_items), static_cast&>>(&ResourceStringFileInfo::langcode_items), R"delim( List of the LangCodeItem items Each :attr:`~lief.PE.LangCodeItem.key` indicates the appropriate language and code page for displaying the ``key: value`` of :attr:`~lief.PE.LangCodeItem.items` )delim") .def("__eq__", &ResourceStringFileInfo::operator==) .def("__ne__", &ResourceStringFileInfo::operator!=) .def("__hash__", [] (const ResourceStringFileInfo& string_file_info) { return Hash::hash(string_file_info); }) .def("__str__", [] (const ResourceStringFileInfo& string_file_info) { std::ostringstream stream; stream << string_file_info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceStringTable.cpp000066400000000000000000000036371443457337100261720ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * Copyright 2017 - 2021 K. Nakagawa * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceStringTable.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceStringTable::*)(void) const; template using setter_t = void (ResourceStringTable::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceStringTable") .def_property_readonly("length", static_cast>(&ResourceStringTable::length), "The size of the string, not including length field itself.") .def_property_readonly("name", static_cast>(&ResourceStringTable::name), "The variable-length Unicode string data, word-aligned." ) .def("__eq__", &ResourceStringTable::operator==) .def("__ne__", &ResourceStringTable::operator!=) .def("__hash__", [] (const ResourceStringTable& string_table) { return Hash::hash(string_table); }) .def("__str__", [] (const ResourceStringTable& string_table) { std::ostringstream stream; stream << string_table; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceVarFileInfo.cpp000066400000000000000000000054661443457337100261220ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceVarFileInfo.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceVarFileInfo::*)(void) const; template using setter_t = void (ResourceVarFileInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceVarFileInfo", "This object describes information about languages supported by the application") .def_property("type", static_cast>(&ResourceVarFileInfo::type), static_cast>(&ResourceVarFileInfo::type), R"delim( The type of data in the version resource * ``1`` if it contains text data * ``0`` if it contains binary data )delim") .def_property("key", static_cast>(&ResourceVarFileInfo::key), static_cast>(&ResourceVarFileInfo::key), "Signature of the structure. Must be ``VarFileInfo``") .def_property("translations", static_cast& (ResourceVarFileInfo::*)(void)>(&ResourceVarFileInfo::translations), static_cast&>>(&ResourceVarFileInfo::translations), R"delim( List of languages that the application supports The **least** significant 16-bits must contain a Microsoft language identifier, and the **most** significant 16-bits must contain the :class:`~lief.PE.CODE_PAGES` Either **most** or **least** 16-bits can be zero, indicating that the file is language or code page independent. )delim") .def("__eq__", &ResourceVarFileInfo::operator==) .def("__ne__", &ResourceVarFileInfo::operator!=) .def("__hash__", [] (const ResourceVarFileInfo& var_file_info) { return Hash::hash(var_file_info); }) .def("__str__", [] (const ResourceVarFileInfo& var_file_info) { std::ostringstream stream; stream << var_file_info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/resources/pyResourceVersion.cpp000066400000000000000000000117131443457337100253730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/resources/ResourceVersion.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ResourceVersion::*)(void) const; template using setter_t = void (ResourceVersion::*)(T); template<> void create(py::module& m) { py::class_(m, "ResourceVersion", R"delim( Class that represents the data associated with the ``RT_VERSION`` entry See: `VS_VERSIONINFO `_ )delim") .def_property("type", static_cast>(&ResourceVersion::type), static_cast>(&ResourceVersion::type), R"delim( The type of data in the version resource * ``1`` if it contains text data * ``0`` if it contains binary data )delim") .def_property("key", static_cast>(&ResourceVersion::key), static_cast>(&ResourceVersion::key), "Signature of the structure. Must be ``VS_VERSION_INFO``") .def_property("fixed_file_info", static_cast>(&ResourceVersion::fixed_file_info), static_cast>(&ResourceVersion::fixed_file_info), R"delim( :class:`~lief.PE.ResourceFixedFileInfo` associated with the version (if any). This object describes various information about the application's version. If not present, this property is set to None )delim") .def_property("string_file_info", static_cast>(&ResourceVersion::string_file_info), static_cast>(&ResourceVersion::string_file_info), R"delim( :class:`~lief.PE.ResourceStringFileInfo` associated with the version (if any) This object describes various information about the application's version. The underlying structure is basically a dictionary (key/value) If the current :class:`~lief.PE.ResourceVersion` does not use :class:`~lief.PE.ResourceStringFileInfo`, it returns None. )delim") .def_property("var_file_info", static_cast>(&ResourceVersion::var_file_info), static_cast>(&ResourceVersion::var_file_info), R"delim( :class:`~lief.PE.ResourceVarFileInfo` associated with the version (if any) This object describes information about languages supported by the application. If the current :class:`~lief.PE.ResourceVersion` does not use :class:`~lief.PE.ResourceVarFileInfo`, it returns None. )delim") .def_property_readonly("has_fixed_file_info", &ResourceVersion::has_fixed_file_info, "``True`` if the version contains a " RST_CLASS_REF(lief.PE.ResourceFixedFileInfo) "") .def_property_readonly("has_string_file_info", &ResourceVersion::has_string_file_info, "``True`` if the version contains a " RST_CLASS_REF(lief.PE.ResourceStringFileInfo) "") .def_property_readonly("has_var_file_info", &ResourceVersion::has_var_file_info, "``True`` if the version contains a " RST_CLASS_REF(lief.PE.ResourceVarFileInfo) "") .def("remove_fixed_file_info", &ResourceVersion::remove_fixed_file_info, "Remove the " RST_CLASS_REF(lief.PE.ResourceFixedFileInfo) " from the version") .def("remove_string_file_info", &ResourceVersion::remove_string_file_info, "Remove the " RST_CLASS_REF(lief.PE.ResourceStringFileInfo) " from the version") .def("remove_var_file_info", &ResourceVersion::remove_var_file_info, "Remove the " RST_CLASS_REF(lief.PE.ResourceVarFileInfo) " from the version") .def("__eq__", &ResourceVersion::operator==) .def("__ne__", &ResourceVersion::operator!=) .def("__hash__", [] (const ResourceVersion& version) { return Hash::hash(version); }) .def("__str__", [] (const ResourceVersion& version) { std::ostringstream stream; stream << version; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/000077500000000000000000000000001443457337100211455ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/PE/objects/signature/CMakeLists.txt000066400000000000000000000010721443457337100237050ustar00rootroot00000000000000set(LIEF_PYTHON_PE_SIG_SRC "${CMAKE_CURRENT_LIST_DIR}/pySignerInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyAttribute.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyRsaInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyx509.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyContentInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/pySignature.cpp" ) source_group("Header Files\\PE\\signature" FILES ${LIEF_PYTHON_PE_SIG_SRC}) target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}") target_sources(pyLIEF PRIVATE ${LIEF_PYTHON_PE_SIG_SRC}) include("${CMAKE_CURRENT_LIST_DIR}/attributes/CMakeLists.txt") LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/000077500000000000000000000000001443457337100233335ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/CMakeLists.txt000066400000000000000000000014331443457337100260740ustar00rootroot00000000000000set(LIEF_PYTHON_PE_SIG_ATTR_SRC "${CMAKE_CURRENT_LIST_DIR}/pyMsCounterSign.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyContentType.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyGenericType.cpp" "${CMAKE_CURRENT_LIST_DIR}/pySpcSpOpusInfo.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyMsSpcStatementType.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyMsSpcNestedSignature.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyPKCS9SigningTime.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyPKCS9MessageDigest.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyPKCS9AtSequenceNumber.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyPKCS9CounterSignature.cpp" ) source_group("Header Files\\PE\\signature\\attributes" FILES ${LIEF_PYTHON_PE_SIG_ATTR_SRC}) target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}") target_sources(pyLIEF PRIVATE ${LIEF_PYTHON_PE_SIG_ATTR_SRC}) LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyContentType.cpp000066400000000000000000000032571443457337100266730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/ContentType.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (ContentType::*)(void) const; template using setter_t = void (ContentType::*)(T); template<> void create(py::module& m) { py::class_(m, "ContentType", R"delim( Interface over the structure described by the OID ``1.2.840.113549.1.9.3`` (PKCS #9) The internal structure is described in the: `RFC #2985: PKCS #9 - Selected Object Classes and Attribute Types Version 2.0 `_ .. code-block:: text ContentType ::= OBJECT IDENTIFIER )delim") .def_property_readonly("oid", &ContentType::oid, "OID as described in RFC #2985 (string object)") .def("__hash__", [] (const ContentType& obj) { return Hash::hash(obj); }) .def("__str__", &ContentType::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyGenericType.cpp000066400000000000000000000033431443457337100266310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/GenericType.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (GenericType::*)(void) const; template using setter_t = void (GenericType::*)(T); template<> void create(py::module& m) { py::class_(m, "GenericType", R"delim( Interface over an attribute for which the internal structure is not supported by LIEF )delim") .def_property_readonly("oid", &GenericType::oid, "OID of the original attribute") .def_property_readonly("raw_content", [] (const GenericType& type) -> py::bytes { const std::vector& raw = type.raw_content(); return py::bytes(reinterpret_cast(raw.data()), raw.size()); }, "Original DER blob of the attribute") .def("__hash__", [] (const GenericType& obj) { return Hash::hash(obj); }) .def("__str__", &GenericType::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyMsCounterSign.cpp000066400000000000000000000015331443457337100271520ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/MsCounterSign.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyMsSpcNestedSignature.cpp000066400000000000000000000035231443457337100304650ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/MsSpcNestedSignature.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (MsSpcNestedSignature::*)(void) const; template using setter_t = void (MsSpcNestedSignature::*)(T); template<> void create(py::module& m) { py::class_(m, "MsSpcNestedSignature", R"delim( Interface over the structure described by the OID ``1.3.6.1.4.1.311.2.4.1`` The internal structure is not documented but we can infer the following structure: .. code-block:: text MsSpcNestedSignature ::= SET OF SignedData With ``SignedData``, the structure described in PKCS #7 RFC (See: :class:`lief.PE.Signature`) )delim") .def_property_readonly("signature", &MsSpcNestedSignature::sig, "Underlying " RST_CLASS_REF(lief.PE.Signature) " object", py::return_value_policy::reference) .def("__hash__", [] (const MsSpcNestedSignature& obj) { return Hash::hash(obj); }) .def("__str__", &MsSpcNestedSignature::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyMsSpcStatementType.cpp000066400000000000000000000041231443457337100301640ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/MsSpcStatementType.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (MsSpcStatementType::*)(void) const; template using setter_t = void (MsSpcStatementType::*)(T); template<> void create(py::module& m) { py::class_(m, "MsSpcStatementType", R"delim( Interface over the structure described by the OID ``1.3.6.1.4.1.311.2.1.11`` The internal structure is described in the official document: `Windows Authenticode Portable Executable Signature Format `_ .. code-block:: text SpcStatementType ::= SEQUENCE of OBJECT IDENTIFIER )delim") .def_property_readonly("oid", &MsSpcStatementType::oid, R"delim( According to the documentation: :: The SpcStatementType MUST contain one Object Identifier with either the value ``1.3.6.1.4.1.311.2.1.21 (SPC_INDIVIDUAL_SP_KEY_PURPOSE_OBJID)`` or ``1.3.6.1.4.1.311.2.1.22 (SPC_COMMERCIAL_SP_KEY_PURPOSE_OBJID)``. )delim") .def("__hash__", [] (const MsSpcStatementType& obj) { return Hash::hash(obj); }) .def("__str__", &MsSpcStatementType::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyPKCS9AtSequenceNumber.cpp000066400000000000000000000037231443457337100303750ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/PKCS9AtSequenceNumber.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (PKCS9AtSequenceNumber::*)(void) const; template using setter_t = void (PKCS9AtSequenceNumber::*)(T); template<> void create(py::module& m) { py::class_(m, "PKCS9AtSequenceNumber", R"delim( Interface over the structure described by the OID ``1.2.840.113549.1.9.25.4`` (PKCS #9) The internal structure is described in the `RFC #2985: PKCS #9 - Selected Object Classes and Attribute Types Version 2.0 `_ .. code-block:: text sequenceNumber ATTRIBUTE ::= { WITH SYNTAX SequenceNumber EQUALITY MATCHING RULE integerMat SINGLE VALUE TRUE ID pkcs-9-at-sequenceNumber } SequenceNumber ::= INTEGER (1..MAX) )delim") .def_property_readonly("number", &PKCS9AtSequenceNumber::number, "Number as described in the RFC") .def("__hash__", [] (const PKCS9AtSequenceNumber& obj) { return Hash::hash(obj); }) .def("__str__", &PKCS9AtSequenceNumber::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyPKCS9CounterSignature.cpp000066400000000000000000000036661443457337100304760ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/PKCS9CounterSignature.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (PKCS9CounterSignature::*)(void) const; template using setter_t = void (PKCS9CounterSignature::*)(T); template<> void create(py::module& m) { py::class_(m, "PKCS9CounterSignature", R"delim( Interface over the structure described by the OID ``1.2.840.113549.1.9.6`` (PKCS #9) The internal structure is described in the `RFC #2985: PKCS #9 - Selected Object Classes and Attribute Types Version 2.0 `_ .. code-block:: text counterSignature ATTRIBUTE ::= { WITH SYNTAX SignerInfo ID pkcs-9-at-counterSignature } )delim") .def_property_readonly("signer", &PKCS9CounterSignature::signer, "Return the " RST_CLASS_REF(lief.PE.SignerInfo) " as described in the RFC #2985", py::return_value_policy::reference) .def("__hash__", [] (const PKCS9CounterSignature& obj) { return Hash::hash(obj); }) .def("__str__", &PKCS9CounterSignature::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyPKCS9MessageDigest.cpp000066400000000000000000000041731443457337100277130ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/PKCS9MessageDigest.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (PKCS9MessageDigest::*)(void) const; template using setter_t = void (PKCS9MessageDigest::*)(T); template<> void create(py::module& m) { py::class_(m, "PKCS9MessageDigest", R"delim( Interface over the structure described by the OID ``1.2.840.113549.1.9.4`` (PKCS #9) The internal structure is described in the `RFC #2985: PKCS #9 - Selected Object Classes and Attribute Types Version 2.0 `_ .. code-block:: text messageDigest ATTRIBUTE ::= { WITH SYNTAX MessageDigest EQUALITY MATCHING RULE octet SINGLE VALUE TRUE ID pkcs-9-at-messageDigest } MessageDigest ::= OCTET STRING )delim") .def_property_readonly("digest", [] (const PKCS9MessageDigest& digest) -> py::object { const std::vector& data = digest.digest(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Message digeset as a blob of bytes as described in the RFC") .def("__hash__", [] (const PKCS9MessageDigest& obj) { return Hash::hash(obj); }) .def("__str__", &PKCS9MessageDigest::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pyPKCS9SigningTime.cpp000066400000000000000000000037301443457337100274020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/PKCS9SigningTime.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (PKCS9SigningTime::*)(void) const; template using setter_t = void (PKCS9SigningTime::*)(T); template<> void create(py::module& m) { py::class_(m, "PKCS9SigningTime", R"delim( Interface over the structure described by the OID ``1.2.840.113549.1.9.5`` (PKCS #9) The internal structure is described in the `RFC #2985: PKCS #9 - Selected Object Classes and Attribute Types Version 2.0 `_ .. code-block:: text signingTime ATTRIBUTE ::= { WITH SYNTAX SigningTime EQUALITY MATCHING RULE signingTimeMatch SINGLE VALUE TRUE ID pkcs-9-at-signingTime } SigningTime ::= Time -- imported from ISO/IEC 9594-8 )delim") .def_property_readonly("time", &PKCS9SigningTime::time, "Time as a list [year, month, day, hour, min, sec]") .def("__hash__", [] (const PKCS9SigningTime& obj) { return Hash::hash(obj); }) .def("__str__", &PKCS9SigningTime::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/attributes/pySpcSpOpusInfo.cpp000066400000000000000000000042071443457337100271260ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "LIEF/PE/signature/attributes/SpcSpOpusInfo.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (SpcSpOpusInfo::*)(void) const; template using setter_t = void (SpcSpOpusInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "SpcSpOpusInfo", R"delim( Interface over the structure described by the OID ``1.3.6.1.4.1.311.2.1.12`` The internal structure is described in the official document: `Windows Authenticode Portable Executable Signature Format `_ .. code-block:: text SpcSpOpusInfo ::= SEQUENCE { programName [0] EXPLICIT SpcString OPTIONAL, moreInfo [1] EXPLICIT SpcLink OPTIONAL } )delim" ) .def_property_readonly("program_name", [] (const SpcSpOpusInfo& info) { return safe_string_converter(info.program_name()); }, "Program description provided by the publisher") .def_property_readonly("more_info", [] (const SpcSpOpusInfo& info) { return safe_string_converter(info.more_info()); }, "Other information such as an URL") .def("__hash__", [] (const SpcSpOpusInfo& obj) { return Hash::hash(obj); }) .def("__str__", &SpcSpOpusInfo::print); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/pyAttribute.cpp000066400000000000000000000024461443457337100241730ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include #include namespace LIEF { namespace PE { template using getter_t = T (Attribute::*)(void) const; template using setter_t = void (Attribute::*)(T); template<> void create(py::module& m) { py::class_(m, "Attribute", "Interface over PKCS #7 attribute") .def_property_readonly("type", &Attribute::type, "Concrete type (" RST_CLASS_REF(lief.PE.SIG_ATTRIBUTE_TYPES) ") of the attribute") .def("__str__", [] (const Attribute& attr) { return attr.print(); }); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/pyContentInfo.cpp000066400000000000000000000067371443457337100244650ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/ContentInfo.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { template using getter_t = T (ContentInfo::*)(void) const; template using setter_t = void (ContentInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "ContentInfo", R"delim( ContentInfo as described in the `RFC 2315 `_ .. code-block:: text ContentInfo ::= SEQUENCE { contentType ContentType, content [0] EXPLICIT ANY DEFINED BY contentType OPTIONAL } ContentType ::= OBJECT IDENTIFIER In the case of PE signature, ContentType **must** be set to SPC_INDIRECT_DATA_OBJID OID: ``1.3.6.1.4.1.311.2.1.4`` and content is defined by the structure: ``SpcIndirectDataContent`` .. code-block:: text SpcIndirectDataContent ::= SEQUENCE { data SpcAttributeTypeAndOptionalValue, messageDigest DigestInfo } SpcAttributeTypeAndOptionalValue ::= SEQUENCE { type ObjectID, value [0] EXPLICIT ANY OPTIONAL } For PE signature, ``SpcAttributeTypeAndOptionalValue.type`` is set to ``SPC_PE_IMAGE_DATAOBJ`` (OID: ``1.3.6.1.4.1.311.2.1.15``) and the value is defined by ``SpcPeImageData`` .. code-block:: text DigestInfo ::= SEQUENCE { digestAlgorithm AlgorithmIdentifier, digest OCTETSTRING } AlgorithmIdentifier ::= SEQUENCE { algorithm ObjectID, parameters [0] EXPLICIT ANY OPTIONAL } )delim") .def_property_readonly("content_type", &ContentInfo::content_type, "OID of the content type. This value should match ``SPC_INDIRECT_DATA_OBJID``") .def_property_readonly("digest_algorithm", &ContentInfo::digest_algorithm, "Algorithm (" RST_CLASS_REF(lief.PE.ALGORITHMS) ") used to hash the file. " "This value should match " RST_ATTR_REF_FULL(SignerInfo.digest_algorithm) " and " "" RST_ATTR_REF_FULL(Signature.digest_algorithm) "") .def_property_readonly("digest", [] (const ContentInfo& info) -> py::bytes { const std::vector& dg = info.digest(); return py::bytes(reinterpret_cast(dg.data()), dg.size()); }, "The digest as ``bytes``. It should match the binary :meth:`~lief.PE.Binary.authentihash`") .def("__hash__", [] (const ContentInfo& info) { return Hash::hash(info); }) .def("__str__", [] (const ContentInfo& content_info) { std::ostringstream stream; stream << content_info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/pyRsaInfo.cpp000066400000000000000000000055241443457337100235710ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/PE/signature/RsaInfo.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { template using getter_t = T (RsaInfo::*)(void) const; template using setter_t = void (RsaInfo::*)(T); template<> void create(py::module& m) { py::class_(m, "RsaInfo", "Object representing a RSA key") .def_property_readonly("has_public_key", &RsaInfo::has_public_key, "True if it embeds a public key") .def_property_readonly("has_private_key", &RsaInfo::has_private_key, "True if it embeds a private key") .def_property_readonly("N", [] (const RsaInfo& info) { const std::vector& data = info.N(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "RSA public modulus (in bytes)") .def_property_readonly("E", [] (const RsaInfo& info) { const std::vector& data = info.E(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "RSA public exponent (in bytes)") .def_property_readonly("D", [] (const RsaInfo& info) { const std::vector& data = info.D(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "RSA private exponent (in bytes)") .def_property_readonly("P", [] (const RsaInfo& info) { const std::vector& data = info.P(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "First prime factor (in bytes)") .def_property_readonly("Q", [] (const RsaInfo& info) { const std::vector& data = info.Q(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Second prime factor (in bytes)") .def_property_readonly("key_size", &RsaInfo::key_size, "Size of the public modulus in bits") .def_property_readonly("__len__", &RsaInfo::key_size) .def("__str__", [] (const RsaInfo& info) { std::ostringstream stream; stream << info; return safe_string_converter(stream.str()); }); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/pySignature.cpp000066400000000000000000000243521443457337100241710ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "enums_wrapper.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/Signature.hpp" #include "LIEF/PE/signature/SignatureParser.hpp" #define LIEF_PE_FORCE_UNDEF #include "LIEF/PE/undef.h" #include "pyPE.hpp" #include "pyIterators.hpp" namespace LIEF { namespace PE { template using getter_t = T (Signature::*)(void) const; template using setter_t = void (Signature::*)(T); template<> void create(py::module& m) { py::class_ signature(m, "Signature"); LIEF::enum_ verif_flags_enums(signature, "VERIFICATION_FLAGS", py::arithmetic()); verif_flags_enums .value("OK", Signature::VERIFICATION_FLAGS::OK) .value("INVALID_SIGNER", Signature::VERIFICATION_FLAGS::INVALID_SIGNER) .value("UNSUPPORTED_ALGORITHM", Signature::VERIFICATION_FLAGS::UNSUPPORTED_ALGORITHM) .value("INCONSISTENT_DIGEST_ALGORITHM", Signature::VERIFICATION_FLAGS::INCONSISTENT_DIGEST_ALGORITHM) .value("CERT_NOT_FOUND", Signature::VERIFICATION_FLAGS::CERT_NOT_FOUND) .value("CORRUPTED_CONTENT_INFO", Signature::VERIFICATION_FLAGS::CORRUPTED_CONTENT_INFO) .value("CORRUPTED_AUTH_DATA", Signature::VERIFICATION_FLAGS::CORRUPTED_AUTH_DATA) .value("MISSING_PKCS9_MESSAGE_DIGEST", Signature::VERIFICATION_FLAGS::MISSING_PKCS9_MESSAGE_DIGEST) .value("BAD_DIGEST", Signature::VERIFICATION_FLAGS::BAD_DIGEST) .value("BAD_SIGNATURE", Signature::VERIFICATION_FLAGS::BAD_SIGNATURE) .value("NO_SIGNATURE", Signature::VERIFICATION_FLAGS::NO_SIGNATURE) .value("CERT_EXPIRED", Signature::VERIFICATION_FLAGS::CERT_EXPIRED) .value("CERT_FUTURE", Signature::VERIFICATION_FLAGS::CERT_FUTURE); py::dict verif_flags_entries = verif_flags_enums.attr("__entries"); verif_flags_enums .def("__str__", [verif_flags_entries] (const Signature::VERIFICATION_FLAGS& flags) { if (flags == Signature::VERIFICATION_FLAGS::OK) { return Signature::flag_to_string(flags); } std::string flags_str; for (const auto& item : verif_flags_entries) { Signature::VERIFICATION_FLAGS flag = item.second[py::int_(0)].cast(); if ((flags & flag) == flag && flag != Signature::VERIFICATION_FLAGS::OK) { if (!flags_str.empty()) { flags_str += " | "; } flags_str += "VERIFICATION_FLAGS." + Signature::flag_to_string(flag); } } return flags_str; }, py::prepend{}); LIEF::enum_(signature, "VERIFICATION_CHECKS", py::arithmetic(), R"delim( Flags to tweak the verification process of the signature See :meth:`lief.PE.Signature.check` and :meth:`lief.PE.Binary.verify_signature` )delim") .value("DEFAULT", Signature::VERIFICATION_CHECKS::DEFAULT, "Default behavior that tries to follow the Microsoft verification process as close as possible") .value("HASH_ONLY", Signature::VERIFICATION_CHECKS::HASH_ONLY, R"delim( Only check that :meth:`lief.PE.Binary.authentihash` matches :attr:`lief.PE.ContentInfo.digest` regardless of the signature's validity )delim") .value("LIFETIME_SIGNING", Signature::VERIFICATION_CHECKS::LIFETIME_SIGNING, R"delim( Same semantic as `WTD_LIFETIME_SIGNING_FLAG `_ )delim") .value("SKIP_CERT_TIME", Signature::VERIFICATION_CHECKS::SKIP_CERT_TIME, R"delim( Skip the verification of the certificates time validities so that even though a certificate expired, it returns :attr:`lief.PE.Signature.VERIFICATION_FLAGS.OK` )delim"); init_ref_iterator(signature, "it_const_crt"); init_ref_iterator(signature, "it_const_signers_t"); signature .def_static("parse", [] (const std::string& path) -> py::object { auto sig = SignatureParser::parse(path); if (!sig) { return py::none(); } return py::cast(sig.value()); }, "Parse the DER PKCS #7 signature from the file path given in the first parameter", "path"_a) .def_static("parse", [] (const std::vector& raw, bool skip_header) -> py::object { auto sig = SignatureParser::parse(raw, skip_header); if (!sig) { return py::none(); } return py::cast(sig.value()); }, "Parse the raw (DER) PKCS #7 signature given in the first parameter", "raw"_a, "skip_header"_a = false) .def_property_readonly("version", &Signature::version, "Version of the signature. It should be 1") .def_property_readonly("digest_algorithm", &Signature::digest_algorithm, "Return the algorithm (" RST_CLASS_REF(lief.PE.ALGORITHMS) ") \ used to sign the content of " RST_CLASS_REF(lief.PE.ContentInfo) "") .def_property_readonly("content_info", &Signature::content_info, "Return the " RST_CLASS_REF(lief.PE.ContentInfo) "", py::return_value_policy::reference) .def_property_readonly("certificates", &Signature::certificates, "Return an iterator over " RST_CLASS_REF(lief.PE.x509) " certificates", py::return_value_policy::reference) .def_property_readonly("signers", &Signature::signers, "Return an iterator over the signers (" RST_CLASS_REF(lief.PE.SignerInfo) ")", py::return_value_policy::reference) .def("find_crt", static_cast&) const>(&Signature::find_crt), "Find the " RST_CLASS_REF(lief.PE.x509) " certificate according to its serial number", py::return_value_policy::reference, "serialno"_a) .def("find_crt_subject", static_cast(&Signature::find_crt_subject), "Find the " RST_CLASS_REF(lief.PE.x509) " certificate according to its subject", py::return_value_policy::reference, "subject"_a) .def("find_crt_subject", static_cast&) const>(&Signature::find_crt_subject), "Find the " RST_CLASS_REF(lief.PE.x509) " certificate according to its subject **AND** its serial number", py::return_value_policy::reference, "subject"_a, "serialno"_a) .def("find_crt_issuer", static_cast(&Signature::find_crt_issuer), "Find the " RST_CLASS_REF(lief.PE.x509) " certificate according to its issuer", py::return_value_policy::reference, "issuer"_a) .def("find_crt_issuer", static_cast&) const>(&Signature::find_crt_issuer), "Find the " RST_CLASS_REF(lief.PE.x509) " certificate according to its issuer **AND** its serial number", py::return_value_policy::reference, "issuer"_a, "serialno"_a) .def("check", &Signature::check, // Note: This documentation needs to be sync with LIEF::PE::Signature::check R"delim( Check the integrity of the signature and return a :class:`lief.PE.Signature.VERIFICATION_FLAGS` By default, it performs the following verifications: 1. It must contain only **one** signer info (:attr:`~lief.PE.Signature.signers`) 2. :attr:`lief.PE.Signature.digest_algorithm` must match: * :attr:`lief.PE.ContentInfo.digest_algorithm` * :attr:`lief.PE.SignerInfo.digest_algorithm` 3. The x509 certificate specified by :attr:`lief.PE.SignerInfo.serial_number` **and** :attr:`lief.PE.SignerInfo.issuer` must exist within :attr:`lief.PE.Signature.certificates` 4. Given the x509 certificate, compare :attr:`lief.PE.SignerInfo.encrypted_digest` against either: * hash of authenticated attributes (:attr:`~lief.PE.SignerInfo.authenticated_attributes`) if present * hash of ContentInfo 5. If they are Authenticated attributes, check that a PKCS9_MESSAGE_DIGEST (:class:`lief.PE.PKCS9MessageDigest`) attribute exists and that its value matches hash of ContentInfo 6. Check the validity of the PKCS #9 counter signature if present 7. If the signature doesn't embed a signing-time in the counter signature, check the certificate validity. (See :attr:`lief.PE.Signature.VERIFICATION_CHECKS.LIFETIME_SIGNING` and :attr:`lief.pe.Signature.VERIFICATION_CHECKS.SKIP_CERT_TIME`) See: :class:`lief.PE.Signature.VERIFICATION_CHECKS` to tweak the behavior )delim", "checks"_a = Signature::VERIFICATION_CHECKS::DEFAULT ) .def_property_readonly("raw_der", [] (const Signature& sig) { const std::vector& raw = sig.raw_der(); return py::bytes(reinterpret_cast(raw.data()), raw.size()); }, "Return the raw original signature as a byte object", py::return_value_policy::reference_internal) .def("__hash__", [] (const Signature& obj) { return Hash::hash(obj); }) .def("__str__", [] (const Signature& signature) { std::ostringstream stream; stream << signature; return stream.str(); }); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/pySignerInfo.cpp000066400000000000000000000131751443457337100242740ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/SignerInfo.hpp" #include "LIEF/PE/signature/Attribute.hpp" #include "pyPE.hpp" #include "pyIterators.hpp" namespace LIEF { namespace PE { template using getter_t = T (SignerInfo::*)(void) const; template using setter_t = void (SignerInfo::*)(T); template<> void create(py::module& m) { py::class_ signer(m, "SignerInfo", R"delim( SignerInfo as described in the `RFC 2315 #Section 9.2 `_ .. code-block:: text SignerInfo ::= SEQUENCE { version Version, issuerAndSerialNumber IssuerAndSerialNumber, digestAlgorithm DigestAlgorithmIdentifier, authenticatedAttributes [0] IMPLICIT Attributes OPTIONAL, digestEncryptionAlgorithm DigestEncryptionAlgorithmIdentifier, encryptedDigest EncryptedDigest, unauthenticatedAttributes [1] IMPLICIT Attributes OPTIONAL } EncryptedDigest ::= OCTET STRING )delim"); init_ref_iterator(signer, "it_const_attributes_t"); signer .def_property_readonly("version", &SignerInfo::version, "Should be 1") .def_property_readonly("serial_number", [] (const SignerInfo& info) -> py::bytes { const std::vector& data = info.serial_number(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "The X509 serial number used to sign the signed-data (see: :attr:`lief.PE.x509.serial_number`)") .def_property_readonly("issuer", [] (const SignerInfo& object) { return safe_string_converter(object.issuer()); }, "The X509 issuer used to sign the signed-data (see: :attr:`lief.PE.x509.issuer`)", py::return_value_policy::copy) .def_property_readonly("digest_algorithm", &SignerInfo::digest_algorithm, "Algorithm (" RST_CLASS_REF(lief.PE.ALGORITHMS) ") used to hash the file. " "This value should match " RST_ATTR_REF_FULL(ContentInfo.digest_algorithm) " " "and " RST_ATTR_REF_FULL(Signature.digest_algorithm) "") .def_property_readonly("encryption_algorithm", &SignerInfo::encryption_algorithm, "Return algorithm (" RST_CLASS_REF(lief.PE.ALGORITHMS) ") used to encrypt the digest") .def_property_readonly("encrypted_digest", [] (const SignerInfo& info) { const std::vector& data = info.encrypted_digest(); return py::bytes(reinterpret_cast(data.data()), data.size()); }, "Return the signature created by the signing certificate's private key") .def_property_readonly("authenticated_attributes", &SignerInfo::authenticated_attributes, "Return an iterator over the authenticated attributes (" "" RST_CLASS_REF(lief.PE.Attribute) ")", py::return_value_policy::reference) .def_property_readonly("unauthenticated_attributes", &SignerInfo::unauthenticated_attributes, "Return an iterator over the unauthenticated attributes (" "" RST_CLASS_REF(lief.PE.Attribute) ")", py::return_value_policy::reference) .def("get_attribute", &SignerInfo::get_attribute, R"delim( Return the authenticated or un-authenticated attribute matching the given :class:`lief.PE.SIG_ATTRIBUTE_TYPES` It returns **the first** entry that matches the given type. If it can't be found, it returns None )delim", "type"_a, py::return_value_policy::reference) .def("get_auth_attribute", &SignerInfo::get_auth_attribute, R"delim( Return the authenticated attribute matching the given :class:`lief.PE.SIG_ATTRIBUTE_TYPES` It returns **the first** entry that matches the given type. If it can't be found, it returns None )delim", "type"_a, py::return_value_policy::reference) .def("get_unauth_attribute", &SignerInfo::get_unauth_attribute, R"delim( Return the un-authenticated attribute matching the given :class:`lief.PE.SIG_ATTRIBUTE_TYPES` It returns **the first** entry that matches the given type. If it can't be found, it returns a nullptr )delim", "type"_a, py::return_value_policy::reference) .def_property_readonly("cert", static_cast(&SignerInfo::cert), "" RST_CLASS_REF(lief.PE.x509) " certificate used by this signer. If it can't be found, it returns None", py::return_value_policy::reference) .def("__hash__", [] (const SignerInfo& obj) { return Hash::hash(obj); }) .def("__str__", [] (const SignerInfo& signer_info) { std::ostringstream stream; stream << signer_info; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/PE/objects/signature/pyx509.cpp000066400000000000000000000257761443457337100227500ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include "enums_wrapper.hpp" #include "LIEF/PE/hash.hpp" #include "LIEF/PE/signature/x509.hpp" #include "LIEF/PE/signature/RsaInfo.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { template using getter_t = T (x509::*)(void) const; template using setter_t = void (x509::*)(T); template<> void create(py::module& m) { py::class_ cls_x509(m, "x509", "Interface over a x509 certificate"); LIEF::enum_(cls_x509, "VERIFICATION_FLAGS", py::arithmetic(), "Verification flags associated with " RST_METH_REF(lief.PE.x509.verify) "") .value("OK", x509::VERIFICATION_FLAGS::OK, "The verification succeed") .value("BADCERT_EXPIRED", x509::VERIFICATION_FLAGS::BADCERT_EXPIRED, "The certificate validity has expired") .value("BADCERT_REVOKED", x509::VERIFICATION_FLAGS::BADCERT_REVOKED, "The certificate has been revoked (is on a CRL)") .value("BADCERT_CN_MISMATCH", x509::VERIFICATION_FLAGS::BADCERT_CN_MISMATCH, "The certificate Common Name (CN) does not match with the expected CN.") .value("BADCERT_NOT_TRUSTED", x509::VERIFICATION_FLAGS::BADCERT_NOT_TRUSTED, "The certificate is not correctly signed by the trusted CA.") .value("BADCRL_NOT_TRUSTED", x509::VERIFICATION_FLAGS::BADCRL_NOT_TRUSTED, "The CRL is not correctly signed by the trusted CA.") .value("BADCRL_EXPIRED", x509::VERIFICATION_FLAGS::BADCRL_EXPIRED, "The CRL is expired.") .value("BADCERT_MISSING", x509::VERIFICATION_FLAGS::BADCERT_MISSING, "Certificate was missing.") .value("BADCERT_SKIP_VERIFY", x509::VERIFICATION_FLAGS::BADCERT_SKIP_VERIFY, "Certificate verification was skipped.") .value("BADCERT_OTHERNATURE", x509::VERIFICATION_FLAGS::BADCERT_OTHER, "Other reason") .value("BADCERT_FUTURE", x509::VERIFICATION_FLAGS::BADCERT_FUTURE, "The certificate validity starts in the future.") .value("BADCRL_FUTURE", x509::VERIFICATION_FLAGS::BADCRL_FUTURE, "The CRL is from the future") .value("BADCERT_KEY_USAGE", x509::VERIFICATION_FLAGS::BADCERT_KEY_USAGE, "Usage does not match the keyUsage extension.") .value("BADCERT_EXT_KEY_USAGE", x509::VERIFICATION_FLAGS::BADCERT_EXT_KEY_USAGE, "Usage does not match the extendedKeyUsage extension.") .value("BADCERT_NS_CERT_TYPE", x509::VERIFICATION_FLAGS::BADCERT_NS_CERT_TYPE, "Usage does not match the nsCertType extension.") .value("BADCERT_BAD_MD", x509::VERIFICATION_FLAGS::BADCERT_BAD_MD, "The certificate is signed with an unacceptable hash.") .value("BADCERT_BAD_PK", x509::VERIFICATION_FLAGS::BADCERT_BAD_PK, "The certificate is signed with an unacceptable PK alg (eg RSA vs ECDSA).") .value("BADCERT_BAD_KEY", x509::VERIFICATION_FLAGS::BADCERT_BAD_KEY, "The certificate is signed with an unacceptable key (eg bad curve, RSA too short).") .value("BADCRL_BAD_MD", x509::VERIFICATION_FLAGS::BADCRL_BAD_MD, "The CRL is signed with an unacceptable hash.") .value("BADCRL_BAD_PK", x509::VERIFICATION_FLAGS::BADCRL_BAD_PK, "The CRL is signed with an unacceptable PK alg (eg RSA vs ECDSA).") .value("BADCRL_BAD_KEY", x509::VERIFICATION_FLAGS::BADCRL_BAD_KEY, "The CRL is signed with an unacceptable key (eg bad curve, RSA too short)."); LIEF::enum_(cls_x509, "KEY_TYPES", "Public key scheme used by the x509 certificate") .value("NONE", x509::KEY_TYPES::NONE, "Unknown scheme") .value("RSA", x509::KEY_TYPES::RSA, "RSA scheme") .value("ECKEY", x509::KEY_TYPES::ECKEY, "Elliptic-curve scheme") .value("ECKEY_DH", x509::KEY_TYPES::ECKEY_DH, "Elliptic-curve Diffie-Hellman") .value("ECDSA", x509::KEY_TYPES::ECDSA, "Elliptic-curve Digital Signature Algorithm") .value("RSA_ALT", x509::KEY_TYPES::RSA_ALT, "RSA scheme with an alternative implementation for signing and decrypting") .value("RSASSA_PSS", x509::KEY_TYPES::RSASSA_PSS, "RSA Probabilistic signature scheme"); LIEF::enum_(cls_x509, "KEY_USAGE", "Key usage as defined in `RFC #5280 - section-4.2.1.3 `_") .value("DIGITAL_SIGNATURE", x509::KEY_USAGE::DIGITAL_SIGNATURE, "The key is used for digital signature") .value("NON_REPUDIATION", x509::KEY_USAGE::NON_REPUDIATION, "The key is used for digital signature AND to protects against falsely denying some action") .value("KEY_ENCIPHERMENT", x509::KEY_USAGE::KEY_ENCIPHERMENT, "The key is used for enciphering private or secret keys") .value("DATA_ENCIPHERMENT", x509::KEY_USAGE::DATA_ENCIPHERMENT, "The key is used for directly enciphering raw user data without the use of an intermediate symmetric cipher") .value("KEY_AGREEMENT", x509::KEY_USAGE::KEY_AGREEMENT, "The Key is used for key agreement. (e.g. with Diffie-Hellman)") .value("KEY_CERT_SIGN", x509::KEY_USAGE::KEY_CERT_SIGN, "The key is used for verifying signatures on public key certificates") .value("CRL_SIGN", x509::KEY_USAGE::CRL_SIGN, "The key is used for verifying signatures on certificate revocation lists") .value("ENCIPHER_ONLY", x509::KEY_USAGE::ENCIPHER_ONLY, "In **association with** KEY_AGREEMENT (otherwise the meaning is undefined), the key is only used for enciphering data while performing key agreement") .value("DECIPHER_ONLY", x509::KEY_USAGE::DECIPHER_ONLY, "In **association with** KEY_AGREEMENT (otherwise the meaning is undefined), the key is only used for deciphering data while performing key agreement"); cls_x509 .def_static("parse", static_cast(&x509::parse), "Parse " RST_CLASS_REF(lief.PE.x509) " certificate(s) from a file path given in the first parameter.\n" "It returns a **list** of " RST_CLASS_REF(lief.PE.x509) " objects", "path"_a) .def_static("parse", static_cast&)>(&x509::parse), "Parse " RST_CLASS_REF(lief.PE.x509) " certificate(s) from a raw blob given in the first parameter.\n" "It returns a **list** of " RST_CLASS_REF(lief.PE.x509) " objects", "raw"_a) .def_property_readonly("version", &x509::version, "X.509 version. (1=v1, 2=v2, 3=v3)") .def_property_readonly("serial_number", [] (const x509& crt) -> py::bytes { const std::vector& sn = crt.serial_number(); return py::bytes(reinterpret_cast(sn.data()), sn.size()); }, "Unique id for certificate issued by a specific CA.") .def_property_readonly("signature_algorithm", &x509::signature_algorithm, "Signature algorithm (OID)") .def_property_readonly("valid_from", &x509::valid_from, "Start time of certificate validity") .def_property_readonly("valid_to", &x509::valid_to, "End time of certificate validity") .def_property_readonly("issuer", [] (const x509& object) { return safe_string_converter(object.issuer()); }, "Issuer of the certificate") .def_property_readonly("subject", [] (const x509& object) { return safe_string_converter(object.subject()); }, "Subject of the certificate") .def_property_readonly("raw", [] (const x509& crt) -> py::bytes { const std::vector& raw = crt.raw(); return py::bytes(reinterpret_cast(raw.data()), raw.size()); }, "The raw bytes associated with this x509 cert (DER encoded)") .def_property_readonly("key_type", &x509::key_type, "Return the underlying public-key scheme (" RST_CLASS_REF(lief.PE.x509.KEY_TYPES) ")") .def_property_readonly("rsa_info", &x509::rsa_info, "If the underlying public-key scheme is RSA, return the " RST_CLASS_REF(lief.PE.RsaInfo) " associated with this certificate. " "Otherwise, return None", py::return_value_policy::take_ownership) .def_property_readonly("key_usage", &x509::key_usage, "Purpose of the key contained in the certificate (see " RST_CLASS_REF(lief.PE.x509.KEY_USAGE) ")") .def_property_readonly("ext_key_usage", &x509::ext_key_usage, "Indicates one or more purposes for which the certified public key may be used (list of OID)") .def_property_readonly("certificate_policies", &x509::certificate_policies, "Policy information terms as list of OID (see RFC #5280)") .def_property_readonly("is_ca", &x509::is_ca) .def_property_readonly("signature", [] (const x509& cert) -> py::bytes { const std::vector& sig = cert.signature(); return py::bytes(reinterpret_cast(sig.data()), sig.size()); }, "The signature of the certificate") .def("verify", static_cast(&x509::verify), R"delim( Verify that this certificate has been used **to trust** the given :class:`~lief.PE.x509` certificate It returns a set of flags defined by :class:`~lief.PE.x509.VERIFICATION_FLAGS` :Example: .. code-block:: python ca = lief.PE.x509.parse("ca.crt")[0] signer = lief.PE.x509.parse("signer.crt")[0] print(ca.verify(signer)) # lief.PE.x509.VERIFICATION_FLAGS.OK )delim", "ca"_a) .def("is_trusted_by", &x509::is_trusted_by, R"delim( Verify this certificate against a list of root CA (list of :class:`~lief.PE.x509` objects) It returns a set of flags defined by :class:`~lief.PE.x509.VERIFICATION_FLAGS` :Example: .. code-block:: python signer = binary.signatures[0].signers[0] microsoft_ca_bundle lief.PE.x509.parse("bundle.pem") print(signer.cert.is_trusted_by(microsoft_ca_bundle)) )delim", "ca_list"_a) .def("__hash__", [] (const x509& obj) { return Hash::hash(obj); }) .def("__str__", [] (const x509& x509_crt) { std::ostringstream stream; stream << x509_crt; return safe_string_converter(stream.str()); }); } } } LIEF-0.13.1/api/python/src/PE/pyEnums.cpp000066400000000000000000001771121443457337100176700ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #define LIEF_PE_FORCE_UNDEF #include "LIEF/PE/undef.h" #include "LIEF/PE/enums.hpp" #include "LIEF/PE/EnumToString.hpp" #include "enums_wrapper.hpp" #define PY_ENUM(x) LIEF::PE::to_string(x), x namespace LIEF { namespace PE { void init_enums(py::module& m) { LIEF::enum_(m, "PE_TYPE") .value(PY_ENUM(PE_TYPE::PE32)) .value(PY_ENUM(PE_TYPE::PE32_PLUS)); LIEF::enum_(m, "MACHINE_TYPES") .value(PY_ENUM(MACHINE_TYPES::MT_Invalid)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_UNKNOWN)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_AM33)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_AMD64)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_ARM)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_ARMNT)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_ARM64)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_EBC)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_I386)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_IA64)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_M32R)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_MIPS16)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_MIPSFPU)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_MIPSFPU16)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_POWERPC)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_POWERPCFP)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_R4000)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_SH3)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_SH3DSP)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_SH4)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_SH5)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_THUMB)) .value(PY_ENUM(MACHINE_TYPES::IMAGE_FILE_MACHINE_WCEMIPSV2)); LIEF::enum_(m, "HEADER_CHARACTERISTICS", py::arithmetic()) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_RELOCS_STRIPPED)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_EXECUTABLE_IMAGE)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_LINE_NUMS_STRIPPED)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_LOCAL_SYMS_STRIPPED)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_AGGRESSIVE_WS_TRIM)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_LARGE_ADDRESS_AWARE)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_BYTES_REVERSED_LO)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_32BIT_MACHINE)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_DEBUG_STRIPPED)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_REMOVABLE_RUN_FROM_SWAP)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_NET_RUN_FROM_SWAP)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_SYSTEM)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_DLL)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_UP_SYSTEM_ONLY)) .value(PY_ENUM(HEADER_CHARACTERISTICS::IMAGE_FILE_BYTES_REVERSED_HI)); LIEF::enum_(m, "SUBSYSTEM") .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_UNKNOWN)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_NATIVE)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_WINDOWS_GUI)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_WINDOWS_CUI)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_OS2_CUI)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_POSIX_CUI)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_NATIVE_WINDOWS)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_WINDOWS_CE_GUI)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_EFI_APPLICATION)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_EFI_BOOT_SERVICE_DRIVER)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_EFI_RUNTIME_DRIVER)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_EFI_ROM)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_XBOX)) .value(PY_ENUM(SUBSYSTEM::IMAGE_SUBSYSTEM_WINDOWS_BOOT_APPLICATION)); LIEF::enum_(m, "DATA_DIRECTORY") .value(PY_ENUM(DATA_DIRECTORY::EXPORT_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::IMPORT_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::RESOURCE_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::EXCEPTION_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::CERTIFICATE_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::BASE_RELOCATION_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::DEBUG)) .value(PY_ENUM(DATA_DIRECTORY::ARCHITECTURE)) .value(PY_ENUM(DATA_DIRECTORY::GLOBAL_PTR)) .value(PY_ENUM(DATA_DIRECTORY::TLS_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::LOAD_CONFIG_TABLE)) .value(PY_ENUM(DATA_DIRECTORY::BOUND_IMPORT)) .value(PY_ENUM(DATA_DIRECTORY::IAT)) .value(PY_ENUM(DATA_DIRECTORY::DELAY_IMPORT_DESCRIPTOR)) .value(PY_ENUM(DATA_DIRECTORY::CLR_RUNTIME_HEADER)) .value(PY_ENUM(DATA_DIRECTORY::RESERVED)); LIEF::enum_(m, "DLL_CHARACTERISTICS", py::arithmetic()) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_HIGH_ENTROPY_VA)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_DYNAMIC_BASE)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_FORCE_INTEGRITY)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_NX_COMPAT)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_NO_ISOLATION)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_NO_SEH)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_NO_BIND)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_APPCONTAINER)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_WDM_DRIVER)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_GUARD_CF)) .value(PY_ENUM(DLL_CHARACTERISTICS::IMAGE_DLL_CHARACTERISTICS_TERMINAL_SERVER_AWARE)); LIEF::enum_(m, "SECTION_CHARACTERISTICS", py::arithmetic()) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_TYPE_NO_PAD)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_CNT_CODE)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_CNT_INITIALIZED_DATA)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_CNT_UNINITIALIZED_DATA)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_LNK_OTHER)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_LNK_INFO)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_LNK_REMOVE)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_LNK_COMDAT)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_GPREL)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_PURGEABLE)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_16BIT)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_LOCKED)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_PRELOAD)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_1BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_2BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_4BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_8BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_16BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_32BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_64BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_128BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_256BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_512BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_1024BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_2048BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_4096BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_ALIGN_8192BYTES)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_LNK_NRELOC_OVFL)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_DISCARDABLE)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_NOT_CACHED)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_NOT_PAGED)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_SHARED)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_EXECUTE)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_READ)) .value(PY_ENUM(SECTION_CHARACTERISTICS::IMAGE_SCN_MEM_WRITE)); LIEF::enum_(m, "SECTION_TYPES") .value(PY_ENUM(PE_SECTION_TYPES::TEXT)) .value(PY_ENUM(PE_SECTION_TYPES::TLS)) .value(PY_ENUM(PE_SECTION_TYPES::IMPORT)) .value(PY_ENUM(PE_SECTION_TYPES::DATA)) .value(PY_ENUM(PE_SECTION_TYPES::BSS)) .value(PY_ENUM(PE_SECTION_TYPES::RESOURCE)) .value(PY_ENUM(PE_SECTION_TYPES::RELOCATION)) .value(PY_ENUM(PE_SECTION_TYPES::EXPORT)) .value(PY_ENUM(PE_SECTION_TYPES::UNKNOWN)); LIEF::enum_(m, "SYMBOL_BASE_TYPES") .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_NULL)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_VOID)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_CHAR)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_SHORT)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_INT)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_LONG)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_FLOAT)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_DOUBLE)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_STRUCT)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_UNION)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_ENUM)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_MOE)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_BYTE)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_WORD)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_UINT)) .value(PY_ENUM(SYMBOL_BASE_TYPES::IMAGE_SYM_TYPE_DWORD)); LIEF::enum_(m, "SYMBOL_COMPLEX_TYPES") .value(PY_ENUM(SYMBOL_COMPLEX_TYPES::IMAGE_SYM_DTYPE_NULL)) .value(PY_ENUM(SYMBOL_COMPLEX_TYPES::IMAGE_SYM_DTYPE_POINTER)) .value(PY_ENUM(SYMBOL_COMPLEX_TYPES::IMAGE_SYM_DTYPE_FUNCTION)) .value(PY_ENUM(SYMBOL_COMPLEX_TYPES::IMAGE_SYM_DTYPE_ARRAY)) .value(PY_ENUM(SYMBOL_COMPLEX_TYPES::SCT_COMPLEX_TYPE_SHIFT)); LIEF::enum_(m, "SYMBOL_SECTION_NUMBER") .value(PY_ENUM(SYMBOL_SECTION_NUMBER::IMAGE_SYM_DEBUG)) .value(PY_ENUM(SYMBOL_SECTION_NUMBER::IMAGE_SYM_ABSOLUTE)) .value(PY_ENUM(SYMBOL_SECTION_NUMBER::IMAGE_SYM_UNDEFINED)); LIEF::enum_(m, "SYMBOL_STORAGE_CLASS") .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_END_OF_FUNCTION)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_NULL)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_AUTOMATIC)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_EXTERNAL)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_STATIC)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_REGISTER)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_EXTERNAL_DEF)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_LABEL)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_UNDEFINED_LABEL)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_MEMBER_OF_STRUCT)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_UNION_TAG)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_TYPE_DEFINITION)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_UNDEFINED_STATIC)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_ENUM_TAG)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_MEMBER_OF_ENUM)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_REGISTER_PARAM)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_BIT_FIELD)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_BLOCK)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_FUNCTION)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_END_OF_STRUCT)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_FILE)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_SECTION)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_WEAK_EXTERNAL)) .value(PY_ENUM(SYMBOL_STORAGE_CLASS::IMAGE_SYM_CLASS_CLR_TOKEN)); LIEF::enum_(m, "RELOCATIONS_BASE_TYPES") .value("ABSOLUTE", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_ABSOLUTE) .value("HIGH", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_HIGH) .value("LOW", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_LOW) .value("HIGHLOW", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_HIGHLOW) .value("HIGHADJ", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_HIGHADJ) .value("MIPS_JMPADDR", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_MIPS_JMPADDR) .value("ARM_MOV32A", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_ARM_MOV32A) .value("ARM_MOV32", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_ARM_MOV32) .value("RISCV_HI20", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_RISCV_HI20) .value("ARM_MOV32T", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_ARM_MOV32T) .value("THUMB_MOV32", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_THUMB_MOV32) .value("RISCV_LOW12I", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_RISCV_LOW12I) .value("RISCV_LOW12S", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_RISCV_LOW12S) .value("SECTION", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_SECTION) .value("REL", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_REL) .value("MIPS_JMPADDR16", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_MIPS_JMPADDR16) .value("IA64_IMM64", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_IA64_IMM64) .value("DIR64", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_DIR64) .value("HIGH3ADJ", RELOCATIONS_BASE_TYPES::IMAGE_REL_BASED_HIGH3ADJ); LIEF::enum_(m, "DEBUG_TYPES") .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_UNKNOWN)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_COFF)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_CODEVIEW)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_FPO)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_MISC)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_EXCEPTION)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_FIXUP)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_OMAP_TO_SRC)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_OMAP_FROM_SRC)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_BORLAND)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_CLSID)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_VC_FEATURE)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_POGO)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_ILTCG)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_MPX)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_REPRO)) .value(PY_ENUM(DEBUG_TYPES::IMAGE_DEBUG_TYPE_EX_DLLCHARACTERISTICS)); LIEF::enum_(m, "RESOURCE_TYPES") .value(PY_ENUM(RESOURCE_TYPES::CURSOR)) .value(PY_ENUM(RESOURCE_TYPES::BITMAP)) .value(PY_ENUM(RESOURCE_TYPES::ICON)) .value(PY_ENUM(RESOURCE_TYPES::MENU)) .value(PY_ENUM(RESOURCE_TYPES::DIALOG)) .value(PY_ENUM(RESOURCE_TYPES::STRING)) .value(PY_ENUM(RESOURCE_TYPES::FONTDIR)) .value(PY_ENUM(RESOURCE_TYPES::FONT)) .value(PY_ENUM(RESOURCE_TYPES::ACCELERATOR)) .value(PY_ENUM(RESOURCE_TYPES::RCDATA)) .value(PY_ENUM(RESOURCE_TYPES::MESSAGETABLE)) .value(PY_ENUM(RESOURCE_TYPES::GROUP_CURSOR)) .value(PY_ENUM(RESOURCE_TYPES::GROUP_ICON)) .value(PY_ENUM(RESOURCE_TYPES::VERSION)) .value(PY_ENUM(RESOURCE_TYPES::DLGINCLUDE)) .value(PY_ENUM(RESOURCE_TYPES::PLUGPLAY)) .value(PY_ENUM(RESOURCE_TYPES::VXD)) .value(PY_ENUM(RESOURCE_TYPES::ANICURSOR)) .value(PY_ENUM(RESOURCE_TYPES::ANIICON)) .value(PY_ENUM(RESOURCE_TYPES::HTML)) .value(PY_ENUM(RESOURCE_TYPES::MANIFEST)); LIEF::enum_(m, "RESOURCE_LANGS") .value(PY_ENUM(RESOURCE_LANGS::LANG_NEUTRAL)) .value(PY_ENUM(RESOURCE_LANGS::LANG_INVARIANT)) .value(PY_ENUM(RESOURCE_LANGS::LANG_AFRIKAANS)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ALBANIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ARABIC)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ARMENIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ASSAMESE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_AZERI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_BASQUE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_BELARUSIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_BANGLA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_BULGARIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_CATALAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_CHINESE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_CROATIAN)) .value("BOSNIAN", RESOURCE_LANGS::LANG_BOSNIAN) .value(PY_ENUM(RESOURCE_LANGS::LANG_CZECH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_DANISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_DIVEHI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_DUTCH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ENGLISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ESTONIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_FAEROESE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_FARSI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_FINNISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_FRENCH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_GALICIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_GEORGIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_GERMAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_GREEK)) .value(PY_ENUM(RESOURCE_LANGS::LANG_GUJARATI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_HEBREW)) .value(PY_ENUM(RESOURCE_LANGS::LANG_HINDI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_HUNGARIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ICELANDIC)) .value(PY_ENUM(RESOURCE_LANGS::LANG_INDONESIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ITALIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_JAPANESE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_KANNADA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_KASHMIRI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_KAZAK)) .value(PY_ENUM(RESOURCE_LANGS::LANG_KONKANI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_KOREAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_KYRGYZ)) .value(PY_ENUM(RESOURCE_LANGS::LANG_LATVIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_LITHUANIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_MACEDONIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_MALAY)) .value(PY_ENUM(RESOURCE_LANGS::LANG_MALAYALAM)) .value(PY_ENUM(RESOURCE_LANGS::LANG_MANIPURI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_MARATHI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_MONGOLIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_NEPALI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_NORWEGIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ORIYA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_POLISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_PORTUGUESE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_PUNJABI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ROMANIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_RUSSIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SANSKRIT)) .value("SERBIAN", RESOURCE_LANGS::LANG_SERBIAN) .value(PY_ENUM(RESOURCE_LANGS::LANG_SINDHI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SLOVAK)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SLOVENIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SPANISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SWAHILI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SWEDISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SYRIAC)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TAMIL)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TATAR)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TELUGU)) .value(PY_ENUM(RESOURCE_LANGS::LANG_THAI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TURKISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_UKRAINIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_URDU)) .value(PY_ENUM(RESOURCE_LANGS::LANG_UZBEK)) .value(PY_ENUM(RESOURCE_LANGS::LANG_VIETNAMESE)) .value("GAELIC", RESOURCE_LANGS::LANG_GAELIC) .value(PY_ENUM(RESOURCE_LANGS::LANG_MALTESE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_MAORI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_RHAETO_ROMANCE)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SAMI)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SORBIAN)) .value(PY_ENUM(RESOURCE_LANGS::LANG_SUTU)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TSONGA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TSWANA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_VENDA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_XHOSA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ZULU)) .value(PY_ENUM(RESOURCE_LANGS::LANG_ESPERANTO)) .value(PY_ENUM(RESOURCE_LANGS::LANG_WALON)) .value(PY_ENUM(RESOURCE_LANGS::LANG_CORNISH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_WELSH)) .value(PY_ENUM(RESOURCE_LANGS::LANG_BRETON)) .value(PY_ENUM(RESOURCE_LANGS::LANG_INUKTITUT)) .value(PY_ENUM(RESOURCE_LANGS::LANG_IRISH)) .value("LOWER_SORBIAN", RESOURCE_LANGS::LANG_LOWER_SORBIAN) .value(PY_ENUM(RESOURCE_LANGS::LANG_PULAR)) .value(PY_ENUM(RESOURCE_LANGS::LANG_QUECHUA)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TAMAZIGHT)) .value(PY_ENUM(RESOURCE_LANGS::LANG_TIGRINYA)) .value("VALENCIAN", RESOURCE_LANGS::LANG_VALENCIAN); LIEF::enum_(m, "RESOURCE_SUBLANGS") .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_AFRIKAANS_SOUTH_AFRICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ALBANIAN_ALBANIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ALSATIAN_FRANCE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_AMHARIC_ETHIOPIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_ALGERIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_BAHRAIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_EGYPT)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_IRAQ)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_JORDAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_KUWAIT)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_LEBANON)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_LIBYA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_MOROCCO)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_OMAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_QATAR)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_SAUDI_ARABIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_SYRIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_TUNISIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_UAE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARABIC_YEMEN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ARMENIAN_ARMENIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ASSAMESE_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_AZERI_CYRILLIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_AZERI_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BASHKIR_RUSSIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BASQUE_BASQUE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BELARUSIAN_BELARUS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BANGLA_BANGLADESH)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BANGLA_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BOSNIAN_BOSNIA_HERZEGOVINA_CYRILLIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BOSNIAN_BOSNIA_HERZEGOVINA_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BRETON_FRANCE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_BULGARIAN_BULGARIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CATALAN_CATALAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CHINESE_HONGKONG)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CHINESE_MACAU)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CHINESE_SIMPLIFIED)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CHINESE_SINGAPORE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CHINESE_TRADITIONAL)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CORSICAN_FRANCE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CROATIAN_BOSNIA_HERZEGOVINA_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CROATIAN_CROATIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CUSTOM_DEFAULT)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CUSTOM_UNSPECIFIED)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_CZECH_CZECH_REPUBLIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_DANISH_DENMARK)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_DARI_AFGHANISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_DEFAULT)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_DIVEHI_MALDIVES)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_DUTCH_BELGIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_DUTCH)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_AUS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_BELIZE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_CAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_CARIBBEAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_EIRE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_JAMAICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_MALAYSIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_NZ)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_PHILIPPINES)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_SINGAPORE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_SOUTH_AFRICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_TRINIDAD)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_UK)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_US)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_ZIMBABWE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ENGLISH_IRELAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ESTONIAN_ESTONIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FAEROESE_FAROE_ISLANDS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FILIPINO_PHILIPPINES)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FINNISH_FINLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FRENCH_BELGIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FRENCH_CANADIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FRENCH_LUXEMBOURG)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FRENCH_MONACO)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FRENCH_SWISS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FRENCH)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_FRISIAN_NETHERLANDS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GALICIAN_GALICIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GEORGIAN_GEORGIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GERMAN_AUSTRIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GERMAN_LIECHTENSTEIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GERMAN_LUXEMBOURG)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GERMAN_SWISS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GERMAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GREEK_GREECE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GREENLANDIC_GREENLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_GUJARATI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_HAUSA_NIGERIA_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_HEBREW_ISRAEL)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_HINDI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_HUNGARIAN_HUNGARY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ICELANDIC_ICELAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_IGBO_NIGERIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_INDONESIAN_INDONESIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_INUKTITUT_CANADA_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_INUKTITUT_CANADA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_IRISH_IRELAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ITALIAN_SWISS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ITALIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_JAPANESE_JAPAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KANNADA_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KASHMIRI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KASHMIRI_SASIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KAZAK_KAZAKHSTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KHMER_CAMBODIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KICHE_GUATEMALA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KINYARWANDA_RWANDA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KONKANI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KOREAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_KYRGYZ_KYRGYZSTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_LAO_LAO)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_LATVIAN_LATVIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_LITHUANIAN_CLASSIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_LITHUANIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_LOWER_SORBIAN_GERMANY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_LUXEMBOURGISH_LUXEMBOURG)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MACEDONIAN_MACEDONIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MALAY_BRUNEI_DARUSSALAM)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MALAY_MALAYSIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MALAYALAM_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MALTESE_MALTA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MAORI_NEW_ZEALAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MAPUDUNGUN_CHILE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MARATHI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MOHAWK_MOHAWK)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MONGOLIAN_CYRILLIC_MONGOLIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_MONGOLIAN_PRC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_NEPALI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_NEPALI_NEPAL)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_NEUTRAL)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_NORWEGIAN_BOKMAL)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_NORWEGIAN_NYNORSK)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_OCCITAN_FRANCE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ORIYA_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_PASHTO_AFGHANISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_PERSIAN_IRAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_POLISH_POLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_PORTUGUESE_BRAZILIAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_PORTUGUESE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_PUNJABI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_QUECHUA_BOLIVIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_QUECHUA_ECUADOR)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_QUECHUA_PERU)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ROMANIAN_ROMANIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ROMANSH_SWITZERLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_RUSSIAN_RUSSIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_INARI_FINLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_LULE_NORWAY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_LULE_SWEDEN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_NORTHERN_FINLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_NORTHERN_NORWAY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_NORTHERN_SWEDEN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_SKOLT_FINLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_SOUTHERN_NORWAY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SAMI_SOUTHERN_SWEDEN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SANSKRIT_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SERBIAN_BOSNIA_HERZEGOVINA_CYRILLIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SERBIAN_BOSNIA_HERZEGOVINA_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SERBIAN_CROATIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SERBIAN_CYRILLIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SERBIAN_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SINDHI_AFGHANISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SINDHI_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SINDHI_PAKISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SINHALESE_SRI_LANKA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SLOVAK_SLOVAKIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SLOVENIAN_SLOVENIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SOTHO_NORTHERN_SOUTH_AFRICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_ARGENTINA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_BOLIVIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_CHILE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_COLOMBIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_COSTA_RICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_DOMINICAN_REPUBLIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_ECUADOR)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_EL_SALVADOR)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_GUATEMALA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_HONDURAS)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_MEXICAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_MODERN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_NICARAGUA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_PANAMA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_PARAGUAY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_PERU)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_PUERTO_RICO)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_URUGUAY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_US)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH_VENEZUELA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SPANISH)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SWAHILI_KENYA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SWEDISH_FINLAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SWEDISH)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SYRIAC_SYRIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_SYS_DEFAULT)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TAJIK_TAJIKISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TAMAZIGHT_ALGERIA_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TAMIL_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TATAR_RUSSIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TELUGU_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_THAI_THAILAND)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TIBETAN_PRC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TIGRIGNA_ERITREA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TSWANA_SOUTH_AFRICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TURKISH_TURKEY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TURKMEN_TURKMENISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_UI_CUSTOM_DEFAULT)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_UIGHUR_PRC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_UKRAINIAN_UKRAINE)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_UPPER_SORBIAN_GERMANY)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_URDU_INDIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_URDU_PAKISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_UZBEK_CYRILLIC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_UZBEK_LATIN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_VIETNAMESE_VIETNAM)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_WELSH_UNITED_KINGDOM)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_WOLOF_SENEGAL)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_XHOSA_SOUTH_AFRICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_YAKUT_RUSSIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_YI_PRC)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_YORUBA_NIGERIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_ZULU_SOUTH_AFRICA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_PULAR_SENEGAL)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_PUNJABI_PAKISTAN)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TSWANA_BOTSWANA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TAMIL_SRI_LANKA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TIGRINYA_ETHIOPIA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_TIGRINYA_ERITREA)) .value(PY_ENUM(RESOURCE_SUBLANGS::SUBLANG_VALENCIAN_VALENCIA)); LIEF::enum_(m, "EXTENDED_WINDOW_STYLES") .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_DLGMODALFRAME)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_NOPARENTNOTIFY)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_TOPMOST)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_ACCEPTFILES)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_TRANSPARENT)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_MDICHILD)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_TOOLWINDOW)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_WINDOWEDGE)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_CLIENTEDGE)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_CONTEXTHELP)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_RIGHT)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_LEFT)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_RTLREADING)) .value("LTRREADING", EXTENDED_WINDOW_STYLES::WS_EX_LTRREADING) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_LEFTSCROLLBAR)) .value("RIGHTSCROLLBAR", EXTENDED_WINDOW_STYLES::WS_EX_RIGHTSCROLLBAR) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_CONTROLPARENT)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_STATICEDGE)) .value(PY_ENUM(EXTENDED_WINDOW_STYLES::WS_EX_APPWINDOW)); LIEF::enum_(m, "WINDOW_STYLES") .value(PY_ENUM(WINDOW_STYLES::WS_OVERLAPPED)) .value(PY_ENUM(WINDOW_STYLES::WS_POPUP)) .value(PY_ENUM(WINDOW_STYLES::WS_CHILD)) .value(PY_ENUM(WINDOW_STYLES::WS_MINIMIZE)) .value(PY_ENUM(WINDOW_STYLES::WS_VISIBLE)) .value(PY_ENUM(WINDOW_STYLES::WS_DISABLED)) .value(PY_ENUM(WINDOW_STYLES::WS_CLIPSIBLINGS)) .value(PY_ENUM(WINDOW_STYLES::WS_CLIPCHILDREN)) .value(PY_ENUM(WINDOW_STYLES::WS_MAXIMIZE)) .value(PY_ENUM(WINDOW_STYLES::WS_CAPTION)) .value(PY_ENUM(WINDOW_STYLES::WS_BORDER)) .value(PY_ENUM(WINDOW_STYLES::WS_DLGFRAME)) .value(PY_ENUM(WINDOW_STYLES::WS_VSCROLL)) .value(PY_ENUM(WINDOW_STYLES::WS_HSCROLL)) .value(PY_ENUM(WINDOW_STYLES::WS_SYSMENU)) .value(PY_ENUM(WINDOW_STYLES::WS_THICKFRAME)) .value("GROUP", WINDOW_STYLES::WS_GROUP) .value("TABSTOP", WINDOW_STYLES::WS_TABSTOP) .value(PY_ENUM(WINDOW_STYLES::WS_MINIMIZEBOX)) .value(PY_ENUM(WINDOW_STYLES::WS_MAXIMIZEBOX)); LIEF::enum_(m, "DIALOG_BOX_STYLES") .value(PY_ENUM(DIALOG_BOX_STYLES::DS_ABSALIGN)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_SYSMODAL)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_LOCALEDIT)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_SETFONT)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_MODALFRAME)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_NOIDLEMSG)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_SETFOREGROUND)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_3DLOOK)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_FIXEDSYS)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_NOFAILCREATE)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_CONTROL)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_CENTER)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_CENTERMOUSE)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_CONTEXTHELP)) .value(PY_ENUM(DIALOG_BOX_STYLES::DS_SHELLFONT)); LIEF::enum_(m, "FIXED_VERSION_OS") .value(PY_ENUM(FIXED_VERSION_OS::VOS_UNKNOWN)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_DOS)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_NT)) .value(PY_ENUM(FIXED_VERSION_OS::VOS__WINDOWS16)) .value(PY_ENUM(FIXED_VERSION_OS::VOS__WINDOWS32)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_OS216)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_OS232)) .value(PY_ENUM(FIXED_VERSION_OS::VOS__PM16)) .value(PY_ENUM(FIXED_VERSION_OS::VOS__PM32)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_DOS_WINDOWS16)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_DOS_WINDOWS32)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_NT_WINDOWS32)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_OS216_PM16)) .value(PY_ENUM(FIXED_VERSION_OS::VOS_OS232_PM32)); LIEF::enum_(m, "FIXED_VERSION_FILE_FLAGS") .value(PY_ENUM(FIXED_VERSION_FILE_FLAGS::VS_FF_DEBUG)) .value(PY_ENUM(FIXED_VERSION_FILE_FLAGS::VS_FF_INFOINFERRED)) .value(PY_ENUM(FIXED_VERSION_FILE_FLAGS::VS_FF_PATCHED)) .value(PY_ENUM(FIXED_VERSION_FILE_FLAGS::VS_FF_PRERELEASE)) .value(PY_ENUM(FIXED_VERSION_FILE_FLAGS::VS_FF_PRIVATEBUILD)) .value(PY_ENUM(FIXED_VERSION_FILE_FLAGS::VS_FF_SPECIALBUILD)); LIEF::enum_(m, "FIXED_VERSION_FILE_TYPES") .value(PY_ENUM(FIXED_VERSION_FILE_TYPES::VFT_APP)) .value(PY_ENUM(FIXED_VERSION_FILE_TYPES::VFT_DLL)) .value(PY_ENUM(FIXED_VERSION_FILE_TYPES::VFT_DRV)) .value(PY_ENUM(FIXED_VERSION_FILE_TYPES::VFT_FONT)) .value(PY_ENUM(FIXED_VERSION_FILE_TYPES::VFT_STATIC_LIB)) .value(PY_ENUM(FIXED_VERSION_FILE_TYPES::VFT_UNKNOWN)) .value(PY_ENUM(FIXED_VERSION_FILE_TYPES::VFT_VXD)); LIEF::enum_(m, "FIXED_VERSION_FILE_SUB_TYPES") .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_COMM)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_DISPLAY)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_INSTALLABLE)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_KEYBOARD)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_LANGUAGE)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_MOUSE)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_NETWORK)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_PRINTER)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_SOUND)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_SYSTEM)) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_DRV_VERSIONED_PRINTER)) .value("FONT_RASTER", FIXED_VERSION_FILE_SUB_TYPES::VFT2_FONT_RASTER) .value("FONT_TRUETYPE", FIXED_VERSION_FILE_SUB_TYPES::VFT2_FONT_TRUETYPE) .value("FONT_VECTOR", FIXED_VERSION_FILE_SUB_TYPES::VFT2_FONT_VECTOR) .value(PY_ENUM(FIXED_VERSION_FILE_SUB_TYPES::VFT2_UNKNOWN)); LIEF::enum_(m, "CODE_PAGES") .value(PY_ENUM(CODE_PAGES::CP_IBM037)) .value(PY_ENUM(CODE_PAGES::CP_IBM437)) .value(PY_ENUM(CODE_PAGES::CP_IBM500)) .value(PY_ENUM(CODE_PAGES::CP_ASMO_708)) .value(PY_ENUM(CODE_PAGES::CP_DOS_720)) .value(PY_ENUM(CODE_PAGES::CP_IBM737)) .value(PY_ENUM(CODE_PAGES::CP_IBM775)) .value(PY_ENUM(CODE_PAGES::CP_IBM850)) .value(PY_ENUM(CODE_PAGES::CP_IBM852)) .value(PY_ENUM(CODE_PAGES::CP_IBM855)) .value(PY_ENUM(CODE_PAGES::CP_IBM857)) .value(PY_ENUM(CODE_PAGES::CP_IBM00858)) .value(PY_ENUM(CODE_PAGES::CP_IBM860)) .value(PY_ENUM(CODE_PAGES::CP_IBM861)) .value(PY_ENUM(CODE_PAGES::CP_DOS_862)) .value(PY_ENUM(CODE_PAGES::CP_IBM863)) .value(PY_ENUM(CODE_PAGES::CP_IBM864)) .value(PY_ENUM(CODE_PAGES::CP_IBM865)) .value(PY_ENUM(CODE_PAGES::CP_CP866)) .value(PY_ENUM(CODE_PAGES::CP_IBM869)) .value(PY_ENUM(CODE_PAGES::CP_IBM870)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_874)) .value(PY_ENUM(CODE_PAGES::CP_CP875)) .value(PY_ENUM(CODE_PAGES::CP_SHIFT_JIS)) .value(PY_ENUM(CODE_PAGES::CP_GB2312)) .value(PY_ENUM(CODE_PAGES::CP_KS_C_5601_1987)) .value(PY_ENUM(CODE_PAGES::CP_BIG5)) .value(PY_ENUM(CODE_PAGES::CP_IBM1026)) .value(PY_ENUM(CODE_PAGES::CP_IBM01047)) .value(PY_ENUM(CODE_PAGES::CP_IBM01140)) .value(PY_ENUM(CODE_PAGES::CP_IBM01141)) .value(PY_ENUM(CODE_PAGES::CP_IBM01142)) .value(PY_ENUM(CODE_PAGES::CP_IBM01143)) .value(PY_ENUM(CODE_PAGES::CP_IBM01144)) .value(PY_ENUM(CODE_PAGES::CP_IBM01145)) .value(PY_ENUM(CODE_PAGES::CP_IBM01146)) .value(PY_ENUM(CODE_PAGES::CP_IBM01147)) .value(PY_ENUM(CODE_PAGES::CP_IBM01148)) .value(PY_ENUM(CODE_PAGES::CP_IBM01149)) .value(PY_ENUM(CODE_PAGES::CP_UTF_16)) .value(PY_ENUM(CODE_PAGES::CP_UNICODEFFFE)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1250)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1251)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1252)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1253)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1254)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1255)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1256)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1257)) .value(PY_ENUM(CODE_PAGES::CP_WINDOWS_1258)) .value(PY_ENUM(CODE_PAGES::CP_JOHAB)) .value(PY_ENUM(CODE_PAGES::CP_MACINTOSH)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_JAPANESE)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_CHINESETRAD)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_KOREAN)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_ARABIC)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_HEBREW)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_GREEK)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_CYRILLIC)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_CHINESESIMP)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_ROMANIAN)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_UKRAINIAN)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_THAI)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_CE)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_ICELANDIC)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_TURKISH)) .value(PY_ENUM(CODE_PAGES::CP_X_MAC_CROATIAN)) .value(PY_ENUM(CODE_PAGES::CP_UTF_32)) .value(PY_ENUM(CODE_PAGES::CP_UTF_32BE)) .value(PY_ENUM(CODE_PAGES::CP_X_CHINESE_CNS)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20001)) .value(PY_ENUM(CODE_PAGES::CP_X_CHINESE_ETEN)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20003)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20004)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20005)) .value(PY_ENUM(CODE_PAGES::CP_X_IA5)) .value(PY_ENUM(CODE_PAGES::CP_X_IA5_GERMAN)) .value(PY_ENUM(CODE_PAGES::CP_X_IA5_SWEDISH)) .value(PY_ENUM(CODE_PAGES::CP_X_IA5_NORWEGIAN)) .value(PY_ENUM(CODE_PAGES::CP_US_ASCII)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20261)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20269)) .value(PY_ENUM(CODE_PAGES::CP_IBM273)) .value(PY_ENUM(CODE_PAGES::CP_IBM277)) .value(PY_ENUM(CODE_PAGES::CP_IBM278)) .value(PY_ENUM(CODE_PAGES::CP_IBM280)) .value(PY_ENUM(CODE_PAGES::CP_IBM284)) .value(PY_ENUM(CODE_PAGES::CP_IBM285)) .value(PY_ENUM(CODE_PAGES::CP_IBM290)) .value(PY_ENUM(CODE_PAGES::CP_IBM297)) .value(PY_ENUM(CODE_PAGES::CP_IBM420)) .value(PY_ENUM(CODE_PAGES::CP_IBM423)) .value(PY_ENUM(CODE_PAGES::CP_IBM424)) .value(PY_ENUM(CODE_PAGES::CP_X_EBCDIC_KOREANEXTENDED)) .value(PY_ENUM(CODE_PAGES::CP_IBM_THAI)) .value(PY_ENUM(CODE_PAGES::CP_KOI8_R)) .value(PY_ENUM(CODE_PAGES::CP_IBM871)) .value(PY_ENUM(CODE_PAGES::CP_IBM880)) .value(PY_ENUM(CODE_PAGES::CP_IBM905)) .value(PY_ENUM(CODE_PAGES::CP_IBM00924)) .value(PY_ENUM(CODE_PAGES::CP_EUC_JP_JIS)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20936)) .value(PY_ENUM(CODE_PAGES::CP_X_CP20949)) .value(PY_ENUM(CODE_PAGES::CP_CP1025)) .value(PY_ENUM(CODE_PAGES::CP_KOI8_U)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_1)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_2)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_3)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_4)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_5)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_6)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_7)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_8)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_9)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_13)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_15)) .value(PY_ENUM(CODE_PAGES::CP_X_EUROPA)) .value(PY_ENUM(CODE_PAGES::CP_ISO_8859_8_I)) .value(PY_ENUM(CODE_PAGES::CP_ISO_2022_JP)) .value(PY_ENUM(CODE_PAGES::CP_CSISO2022JP)) .value(PY_ENUM(CODE_PAGES::CP_ISO_2022_JP_JIS)) .value(PY_ENUM(CODE_PAGES::CP_ISO_2022_KR)) .value(PY_ENUM(CODE_PAGES::CP_X_CP50227)) .value(PY_ENUM(CODE_PAGES::CP_EUC_JP)) .value(PY_ENUM(CODE_PAGES::CP_EUC_CN)) .value(PY_ENUM(CODE_PAGES::CP_EUC_KR)) .value(PY_ENUM(CODE_PAGES::CP_HZ_GB_2312)) .value(PY_ENUM(CODE_PAGES::CP_GB18030)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_DE)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_BE)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_TA)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_TE)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_AS)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_OR)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_KA)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_MA)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_GU)) .value(PY_ENUM(CODE_PAGES::CP_X_ISCII_PA)) .value(PY_ENUM(CODE_PAGES::CP_UTF_7)) .value(PY_ENUM(CODE_PAGES::CP_UTF_8)); LIEF::enum_(m, "WIN_VERSION") .value(PY_ENUM(WIN_VERSION::WIN_UNKNOWN)) .value(PY_ENUM(WIN_VERSION::WIN_SEH)) .value(PY_ENUM(WIN_VERSION::WIN8_1)) .value(PY_ENUM(WIN_VERSION::WIN10_0_9879)) .value(PY_ENUM(WIN_VERSION::WIN10_0_14286)) .value(PY_ENUM(WIN_VERSION::WIN10_0_14383)) .value(PY_ENUM(WIN_VERSION::WIN10_0_14901)) .value(PY_ENUM(WIN_VERSION::WIN10_0_15002)) .value(PY_ENUM(WIN_VERSION::WIN10_0_16237)) .value(PY_ENUM(WIN_VERSION::WIN10_0_18362)) .value(PY_ENUM(WIN_VERSION::WIN10_0_19534)) .value(PY_ENUM(WIN_VERSION::WIN10_0_MSVC_2019)) .value(PY_ENUM(WIN_VERSION::WIN10_0_MSVC_2019_16)); LIEF::enum_(m, "GUARD_CF_FLAGS", py::arithmetic()) .value(PY_ENUM(GUARD_CF_FLAGS::GCF_NONE)) .value(PY_ENUM(GUARD_CF_FLAGS::GCF_INSTRUMENTED)) .value(PY_ENUM(GUARD_CF_FLAGS::GCF_W_INSTRUMENTED)) .value(PY_ENUM(GUARD_CF_FLAGS::GCF_FUNCTION_TABLE_PRESENT)) .value(PY_ENUM(GUARD_CF_FLAGS::GCF_EXPORT_SUPPRESSION_INFO_PRESENT)) .value(PY_ENUM(GUARD_CF_FLAGS::GCF_ENABLE_EXPORT_SUPPRESSION)) .value(PY_ENUM(GUARD_CF_FLAGS::GCF_LONGJUMP_TABLE_PRESENT)) .value(PY_ENUM(GUARD_CF_FLAGS::GRF_INSTRUMENTED)) .value(PY_ENUM(GUARD_CF_FLAGS::GRF_ENABLE)) .value(PY_ENUM(GUARD_CF_FLAGS::GRF_STRICT)); LIEF::enum_(m, "CODE_VIEW_SIGNATURES") .value(PY_ENUM(CODE_VIEW_SIGNATURES::CVS_UNKNOWN)) .value(PY_ENUM(CODE_VIEW_SIGNATURES::CVS_PDB_70)) .value(PY_ENUM(CODE_VIEW_SIGNATURES::CVS_PDB_20)) .value(PY_ENUM(CODE_VIEW_SIGNATURES::CVS_CV_50)) .value(PY_ENUM(CODE_VIEW_SIGNATURES::CVS_CV_41)); LIEF::enum_(m, "POGO_SIGNATURES") .value(PY_ENUM(POGO_SIGNATURES::POGO_UNKNOWN)) .value(PY_ENUM(POGO_SIGNATURES::POGO_LCTG)) .value(PY_ENUM(POGO_SIGNATURES::POGO_PGI)); LIEF::enum_(m, "ACCELERATOR_FLAGS", py::arithmetic()) .value(PY_ENUM(ACCELERATOR_FLAGS::FVIRTKEY)) .value(PY_ENUM(ACCELERATOR_FLAGS::FNOINVERT)) .value(PY_ENUM(ACCELERATOR_FLAGS::FSHIFT)) .value(PY_ENUM(ACCELERATOR_FLAGS::FCONTROL)) .value(PY_ENUM(ACCELERATOR_FLAGS::FALT)) .value(PY_ENUM(ACCELERATOR_FLAGS::END)); LIEF::enum_(m, "ACCELERATOR_VK_CODES") .value("VK_LBUTTON" , ACCELERATOR_VK_CODES::VK_LBUTTON) .value("VK_RBUTTON" , ACCELERATOR_VK_CODES::VK_RBUTTON) .value("VK_CANCEL" , ACCELERATOR_VK_CODES::VK_CANCEL) .value("VK_MBUTTON" , ACCELERATOR_VK_CODES::VK_MBUTTON) .value("VK_XBUTTON1" , ACCELERATOR_VK_CODES::VK_XBUTTON1) .value("VK_XBUTTON2" , ACCELERATOR_VK_CODES::VK_XBUTTON2) .value("VK_BACK" , ACCELERATOR_VK_CODES::VK_BACK) .value("VK_TAB" , ACCELERATOR_VK_CODES::VK_TAB) .value("VK_CLEAR" , ACCELERATOR_VK_CODES::VK_CLEAR) .value("VK_RETURN" , ACCELERATOR_VK_CODES::VK_RETURN) .value("VK_SHIFT" , ACCELERATOR_VK_CODES::VK_SHIFT) .value("VK_CONTROL" , ACCELERATOR_VK_CODES::VK_CONTROL) .value("VK_MENU" , ACCELERATOR_VK_CODES::VK_MENU) .value("VK_PAUSE" , ACCELERATOR_VK_CODES::VK_PAUSE) .value("VK_CAPITAL" , ACCELERATOR_VK_CODES::VK_CAPITAL) .value("VK_KANA" , ACCELERATOR_VK_CODES::VK_KANA) .value("VK_HANGUEL" , ACCELERATOR_VK_CODES::VK_HANGUEL) .value("VK_HANGUL" , ACCELERATOR_VK_CODES::VK_HANGUL) .value("VK_IME_ON" , ACCELERATOR_VK_CODES::VK_IME_ON) .value("VK_JUNJA" , ACCELERATOR_VK_CODES::VK_JUNJA) .value("VK_FINAL" , ACCELERATOR_VK_CODES::VK_FINAL) .value("VK_HANJA" , ACCELERATOR_VK_CODES::VK_HANJA) .value("VK_KANJI" , ACCELERATOR_VK_CODES::VK_KANJI) .value("VK_IME_OFF" , ACCELERATOR_VK_CODES::VK_IME_OFF) .value("VK_ESCAPE" , ACCELERATOR_VK_CODES::VK_ESCAPE) .value("VK_CONVERT" , ACCELERATOR_VK_CODES::VK_CONVERT) .value("VK_NONCONVERT" , ACCELERATOR_VK_CODES::VK_NONCONVERT) .value("VK_ACCEPT" , ACCELERATOR_VK_CODES::VK_ACCEPT) .value("VK_MODECHANGE" , ACCELERATOR_VK_CODES::VK_MODECHANGE) .value("VK_SPACE" , ACCELERATOR_VK_CODES::VK_SPACE) .value("VK_PRIOR" , ACCELERATOR_VK_CODES::VK_PRIOR) .value("VK_NEXT" , ACCELERATOR_VK_CODES::VK_NEXT) .value("VK_END" , ACCELERATOR_VK_CODES::VK_END) .value("VK_HOME" , ACCELERATOR_VK_CODES::VK_HOME) .value("VK_LEFT" , ACCELERATOR_VK_CODES::VK_LEFT) .value("VK_UP" , ACCELERATOR_VK_CODES::VK_UP) .value("VK_RIGHT" , ACCELERATOR_VK_CODES::VK_RIGHT) .value("VK_DOWN" , ACCELERATOR_VK_CODES::VK_DOWN) .value("VK_SELECT" , ACCELERATOR_VK_CODES::VK_SELECT) .value("VK_PRINT" , ACCELERATOR_VK_CODES::VK_PRINT) .value("VK_EXECUTE" , ACCELERATOR_VK_CODES::VK_EXECUTE) .value("VK_SNAPSHOT" , ACCELERATOR_VK_CODES::VK_SNAPSHOT) .value("VK_INSERT" , ACCELERATOR_VK_CODES::VK_INSERT) .value("VK_DELETE" , ACCELERATOR_VK_CODES::VK_DELETE) .value("VK_HELP" , ACCELERATOR_VK_CODES::VK_HELP) .value("VK_0" , ACCELERATOR_VK_CODES::VK_0) .value("VK_1" , ACCELERATOR_VK_CODES::VK_1) .value("VK_2" , ACCELERATOR_VK_CODES::VK_2) .value("VK_3" , ACCELERATOR_VK_CODES::VK_3) .value("VK_4" , ACCELERATOR_VK_CODES::VK_4) .value("VK_5" , ACCELERATOR_VK_CODES::VK_5) .value("VK_6" , ACCELERATOR_VK_CODES::VK_6) .value("VK_7" , ACCELERATOR_VK_CODES::VK_7) .value("VK_8" , ACCELERATOR_VK_CODES::VK_8) .value("VK_9" , ACCELERATOR_VK_CODES::VK_9) .value("VK_A" , ACCELERATOR_VK_CODES::VK_A) .value("VK_B" , ACCELERATOR_VK_CODES::VK_B) .value("VK_C" , ACCELERATOR_VK_CODES::VK_C) .value("VK_D" , ACCELERATOR_VK_CODES::VK_D) .value("VK_E" , ACCELERATOR_VK_CODES::VK_E) .value("VK_F" , ACCELERATOR_VK_CODES::VK_F) .value("VK_G" , ACCELERATOR_VK_CODES::VK_G) .value("VK_H" , ACCELERATOR_VK_CODES::VK_H) .value("VK_I" , ACCELERATOR_VK_CODES::VK_I) .value("VK_J" , ACCELERATOR_VK_CODES::VK_J) .value("VK_K" , ACCELERATOR_VK_CODES::VK_K) .value("VK_L" , ACCELERATOR_VK_CODES::VK_L) .value("VK_M" , ACCELERATOR_VK_CODES::VK_M) .value("VK_N" , ACCELERATOR_VK_CODES::VK_N) .value("VK_O" , ACCELERATOR_VK_CODES::VK_O) .value("VK_P" , ACCELERATOR_VK_CODES::VK_P) .value("VK_Q" , ACCELERATOR_VK_CODES::VK_Q) .value("VK_R" , ACCELERATOR_VK_CODES::VK_R) .value("VK_S" , ACCELERATOR_VK_CODES::VK_S) .value("VK_T" , ACCELERATOR_VK_CODES::VK_T) .value("VK_U" , ACCELERATOR_VK_CODES::VK_U) .value("VK_V" , ACCELERATOR_VK_CODES::VK_V) .value("VK_W" , ACCELERATOR_VK_CODES::VK_W) .value("VK_X" , ACCELERATOR_VK_CODES::VK_X) .value("VK_Y" , ACCELERATOR_VK_CODES::VK_Y) .value("VK_Z" , ACCELERATOR_VK_CODES::VK_Z) .value("VK_LWIN" , ACCELERATOR_VK_CODES::VK_LWIN) .value("VK_RWIN" , ACCELERATOR_VK_CODES::VK_RWIN) .value("VK_APPS" , ACCELERATOR_VK_CODES::VK_APPS) .value("VK_SLEEP" , ACCELERATOR_VK_CODES::VK_SLEEP) .value("VK_NUMPAD0" , ACCELERATOR_VK_CODES::VK_NUMPAD0) .value("VK_NUMPAD1" , ACCELERATOR_VK_CODES::VK_NUMPAD1) .value("VK_NUMPAD2" , ACCELERATOR_VK_CODES::VK_NUMPAD2) .value("VK_NUMPAD3" , ACCELERATOR_VK_CODES::VK_NUMPAD3) .value("VK_NUMPAD4" , ACCELERATOR_VK_CODES::VK_NUMPAD4) .value("VK_NUMPAD5" , ACCELERATOR_VK_CODES::VK_NUMPAD5) .value("VK_NUMPAD6" , ACCELERATOR_VK_CODES::VK_NUMPAD6) .value("VK_NUMPAD7" , ACCELERATOR_VK_CODES::VK_NUMPAD7) .value("VK_NUMPAD8" , ACCELERATOR_VK_CODES::VK_NUMPAD8) .value("VK_NUMPAD9" , ACCELERATOR_VK_CODES::VK_NUMPAD9) .value("VK_MULTIPLY" , ACCELERATOR_VK_CODES::VK_MULTIPLY) .value("VK_ADD" , ACCELERATOR_VK_CODES::VK_ADD) .value("VK_SEPARATOR" , ACCELERATOR_VK_CODES::VK_SEPARATOR) .value("VK_SUBTRACT" , ACCELERATOR_VK_CODES::VK_SUBTRACT) .value("VK_DECIMAL" , ACCELERATOR_VK_CODES::VK_DECIMAL) .value("VK_DIVIDE" , ACCELERATOR_VK_CODES::VK_DIVIDE) .value("VK_F1" , ACCELERATOR_VK_CODES::VK_F1) .value("VK_F2" , ACCELERATOR_VK_CODES::VK_F2) .value("VK_F3" , ACCELERATOR_VK_CODES::VK_F3) .value("VK_F4" , ACCELERATOR_VK_CODES::VK_F4) .value("VK_F5" , ACCELERATOR_VK_CODES::VK_F5) .value("VK_F6" , ACCELERATOR_VK_CODES::VK_F6) .value("VK_F7" , ACCELERATOR_VK_CODES::VK_F7) .value("VK_F8" , ACCELERATOR_VK_CODES::VK_F8) .value("VK_F9" , ACCELERATOR_VK_CODES::VK_F9) .value("VK_F10" , ACCELERATOR_VK_CODES::VK_F10) .value("VK_F11" , ACCELERATOR_VK_CODES::VK_F11) .value("VK_F12" , ACCELERATOR_VK_CODES::VK_F12) .value("VK_F13" , ACCELERATOR_VK_CODES::VK_F13) .value("VK_F14" , ACCELERATOR_VK_CODES::VK_F14) .value("VK_F15" , ACCELERATOR_VK_CODES::VK_F15) .value("VK_F16" , ACCELERATOR_VK_CODES::VK_F16) .value("VK_F17" , ACCELERATOR_VK_CODES::VK_F17) .value("VK_F18" , ACCELERATOR_VK_CODES::VK_F18) .value("VK_F19" , ACCELERATOR_VK_CODES::VK_F19) .value("VK_F20" , ACCELERATOR_VK_CODES::VK_F20) .value("VK_F21" , ACCELERATOR_VK_CODES::VK_F21) .value("VK_F22" , ACCELERATOR_VK_CODES::VK_F22) .value("VK_F23" , ACCELERATOR_VK_CODES::VK_F23) .value("VK_F24" , ACCELERATOR_VK_CODES::VK_F24) .value("VK_NUMLOCK" , ACCELERATOR_VK_CODES::VK_NUMLOCK) .value("VK_SCROLL" , ACCELERATOR_VK_CODES::VK_SCROLL) .value("VK_LSHIFT" , ACCELERATOR_VK_CODES::VK_LSHIFT) .value("VK_RSHIFT" , ACCELERATOR_VK_CODES::VK_RSHIFT) .value("VK_LCONTROL" , ACCELERATOR_VK_CODES::VK_LCONTROL) .value("VK_RCONTROL" , ACCELERATOR_VK_CODES::VK_RCONTROL) .value("VK_LMENU" , ACCELERATOR_VK_CODES::VK_LMENU) .value("VK_RMENU" , ACCELERATOR_VK_CODES::VK_RMENU) .value("VK_BROWSER_BACK" , ACCELERATOR_VK_CODES::VK_BROWSER_BACK) .value("VK_BROWSER_FORWARD" , ACCELERATOR_VK_CODES::VK_BROWSER_FORWARD) .value("VK_BROWSER_REFRESH" , ACCELERATOR_VK_CODES::VK_BROWSER_REFRESH) .value("VK_BROWSER_STOP" , ACCELERATOR_VK_CODES::VK_BROWSER_STOP) .value("VK_BROWSER_SEARCH" , ACCELERATOR_VK_CODES::VK_BROWSER_SEARCH) .value("VK_BROWSER_FAVORITES" , ACCELERATOR_VK_CODES::VK_BROWSER_FAVORITES) .value("VK_BROWSER_HOME" , ACCELERATOR_VK_CODES::VK_BROWSER_HOME) .value("VK_VOLUME_MUTE" , ACCELERATOR_VK_CODES::VK_VOLUME_MUTE) .value("VK_VOLUME_DOWN" , ACCELERATOR_VK_CODES::VK_VOLUME_DOWN) .value("VK_VOLUME_UP" , ACCELERATOR_VK_CODES::VK_VOLUME_UP) .value("VK_MEDIA_NEXT_TRACK" , ACCELERATOR_VK_CODES::VK_MEDIA_NEXT_TRACK) .value("VK_MEDIA_PREV_TRACK" , ACCELERATOR_VK_CODES::VK_MEDIA_PREV_TRACK) .value("VK_MEDIA_STOP" , ACCELERATOR_VK_CODES::VK_MEDIA_STOP) .value("VK_MEDIA_PLAY_PAUSE" , ACCELERATOR_VK_CODES::VK_MEDIA_PLAY_PAUSE) .value("VK_LAUNCH_MAIL" , ACCELERATOR_VK_CODES::VK_LAUNCH_MAIL) .value("VK_LAUNCH_MEDIA_SELECT" , ACCELERATOR_VK_CODES::VK_LAUNCH_MEDIA_SELECT) .value("VK_LAUNCH_APP1" , ACCELERATOR_VK_CODES::VK_LAUNCH_APP1) .value("VK_LAUNCH_APP2" , ACCELERATOR_VK_CODES::VK_LAUNCH_APP2) .value("VK_OEM_1" , ACCELERATOR_VK_CODES::VK_OEM_1) .value("VK_OEM_PLUS" , ACCELERATOR_VK_CODES::VK_OEM_PLUS) .value("VK_OEM_COMMA" , ACCELERATOR_VK_CODES::VK_OEM_COMMA) .value("VK_OEM_MINUS" , ACCELERATOR_VK_CODES::VK_OEM_MINUS) .value("VK_OEM_PERIOD" , ACCELERATOR_VK_CODES::VK_OEM_PERIOD) .value("VK_OEM_2" , ACCELERATOR_VK_CODES::VK_OEM_2) .value("VK_OEM_4" , ACCELERATOR_VK_CODES::VK_OEM_4) .value("VK_OEM_5" , ACCELERATOR_VK_CODES::VK_OEM_5) .value("VK_OEM_6" , ACCELERATOR_VK_CODES::VK_OEM_6) .value("VK_OEM_7" , ACCELERATOR_VK_CODES::VK_OEM_7) .value("VK_OEM_8" , ACCELERATOR_VK_CODES::VK_OEM_8) .value("VK_OEM_102" , ACCELERATOR_VK_CODES::VK_OEM_102) .value("VK_PROCESSKEY" , ACCELERATOR_VK_CODES::VK_PROCESSKEY) .value("VK_PACKET" , ACCELERATOR_VK_CODES::VK_PACKET) .value("VK_ATTN" , ACCELERATOR_VK_CODES::VK_ATTN) .value("VK_CRSEL" , ACCELERATOR_VK_CODES::VK_CRSEL) .value("VK_EXSEL" , ACCELERATOR_VK_CODES::VK_EXSEL) .value("VK_EREOF" , ACCELERATOR_VK_CODES::VK_EREOF) .value("VK_PLAY" , ACCELERATOR_VK_CODES::VK_PLAY) .value("VK_ZOOM" , ACCELERATOR_VK_CODES::VK_ZOOM) .value("VK_NONAME" , ACCELERATOR_VK_CODES::VK_NONAME) .value("VK_PA1" , ACCELERATOR_VK_CODES::VK_PA1) .value("VK_OEM_CLEAR" , ACCELERATOR_VK_CODES::VK_OEM_CLEAR); LIEF::enum_(m, "ALGORITHMS") .value(PY_ENUM(ALGORITHMS::UNKNOWN)) .value(PY_ENUM(ALGORITHMS::SHA_512)) .value(PY_ENUM(ALGORITHMS::SHA_384)) .value(PY_ENUM(ALGORITHMS::SHA_256)) .value(PY_ENUM(ALGORITHMS::SHA_1)) .value(PY_ENUM(ALGORITHMS::MD5)) .value(PY_ENUM(ALGORITHMS::MD4)) .value(PY_ENUM(ALGORITHMS::MD2)) .value(PY_ENUM(ALGORITHMS::RSA)) .value(PY_ENUM(ALGORITHMS::EC)) .value(PY_ENUM(ALGORITHMS::MD5_RSA)) .value(PY_ENUM(ALGORITHMS::SHA1_DSA)) .value(PY_ENUM(ALGORITHMS::SHA1_RSA)) .value(PY_ENUM(ALGORITHMS::SHA_256_RSA)) .value(PY_ENUM(ALGORITHMS::SHA_384_RSA)) .value(PY_ENUM(ALGORITHMS::SHA_512_RSA)) .value(PY_ENUM(ALGORITHMS::SHA1_ECDSA)) .value(PY_ENUM(ALGORITHMS::SHA_256_ECDSA)) .value(PY_ENUM(ALGORITHMS::SHA_384_ECDSA)) .value(PY_ENUM(ALGORITHMS::SHA_512_ECDSA)); LIEF::enum_(m, "SIG_ATTRIBUTE_TYPES") .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::UNKNOWN)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::CONTENT_TYPE)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::GENERIC_TYPE)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::SPC_SP_OPUS_INFO)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::MS_COUNTER_SIGN)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::MS_SPC_NESTED_SIGN)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::MS_SPC_STATEMENT_TYPE)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::PKCS9_AT_SEQUENCE_NUMBER)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::PKCS9_COUNTER_SIGNATURE)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::PKCS9_MESSAGE_DIGEST)) .value(PY_ENUM(SIG_ATTRIBUTE_TYPES::PKCS9_SIGNING_TIME)); } } } LIEF-0.13.1/api/python/src/PE/pyPE.cpp000066400000000000000000000062771443457337100171100ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * Copyright 2017 - 2021 K. Nakagawa * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/PE/signature/OIDToString.hpp" #include "pyPE.hpp" namespace LIEF { namespace PE { void init_python_module(py::module& m) { py::module LIEF_PE_module = m.def_submodule("PE", "Python API for the LIEF's PE format"); init_enums(LIEF_PE_module); init_objects(LIEF_PE_module); init_utils(LIEF_PE_module); LIEF_PE_module.def("oid_to_string", &oid_to_string, "Convert an OID to a human-readable string"); // Opaque containers py::bind_vector>(LIEF_PE_module, "ListLangCodeItem"); py::bind_map(LIEF_PE_module, "DictStringVersion"); } void init_objects(py::module& m) { CREATE(Parser, m); CREATE(DosHeader, m); CREATE(Header, m); CREATE(OptionalHeader, m); CREATE(RichHeader, m); CREATE(RichEntry, m); CREATE(DataDirectory, m); CREATE(Section, m); CREATE(Relocation, m); CREATE(RelocationEntry, m); CREATE(Export, m); CREATE(ExportEntry, m); CREATE(TLS, m); CREATE(Symbol, m); CREATE(Debug, m); CREATE(CodeView, m); CREATE(CodeViewPDB, m); CREATE(Pogo, m); CREATE(PogoEntry, m); CREATE(Import, m); CREATE(ImportEntry, m); CREATE(DelayImport, m); CREATE(DelayImportEntry, m); CREATE(ResourcesManager, m); CREATE(ResourceNode, m); CREATE(ResourceData, m); CREATE(ResourceDirectory, m); CREATE(ResourceVersion, m); CREATE(ResourceStringFileInfo, m); CREATE(ResourceFixedFileInfo, m); CREATE(ResourceVarFileInfo, m); CREATE(LangCodeItem, m); CREATE(ResourceIcon, m); CREATE(ResourceDialog, m); CREATE(ResourceDialogItem, m); CREATE(ResourceStringTable, m); CREATE(ResourceAccelerator, m); CREATE(Signature, m); CREATE(RsaInfo, m); CREATE(x509, m); CREATE(ContentInfo, m); CREATE(SignerInfo, m); CREATE(CodeIntegrity, m); CREATE(Attribute, m); CREATE(ContentType, m); CREATE(GenericType, m); CREATE(MsSpcNestedSignature, m); CREATE(MsSpcStatementType, m); CREATE(PKCS9AtSequenceNumber, m); CREATE(PKCS9CounterSignature, m); CREATE(PKCS9MessageDigest, m); CREATE(PKCS9SigningTime, m); CREATE(SpcSpOpusInfo, m); CREATE(LoadConfiguration, m); CREATE(LoadConfigurationV0, m); CREATE(LoadConfigurationV1, m); CREATE(LoadConfigurationV2, m); CREATE(LoadConfigurationV3, m); CREATE(LoadConfigurationV4, m); CREATE(LoadConfigurationV5, m); CREATE(LoadConfigurationV6, m); CREATE(LoadConfigurationV7, m); CREATE(LoadConfigurationV8, m); CREATE(LoadConfigurationV9, m); CREATE(LoadConfigurationV10, m); CREATE(LoadConfigurationV11, m); CREATE(Binary, m); CREATE(Builder, m); } } } LIEF-0.13.1/api/python/src/PE/pyPE.hpp000066400000000000000000000073121443457337100171040ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * Copyright 2017 - 2021 K. Nakagawa * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_PE_H_ #define PY_LIEF_PE_H_ #include #include #include #include #include "LIEF/PE.hpp" #include "pyLIEF.hpp" #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) namespace LIEF { namespace PE { template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_enums(py::module&); void init_utils(py::module&); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(Binary); SPECIALIZE_CREATE(DosHeader); SPECIALIZE_CREATE(Header); SPECIALIZE_CREATE(OptionalHeader); SPECIALIZE_CREATE(RichHeader); SPECIALIZE_CREATE(RichEntry); SPECIALIZE_CREATE(DataDirectory); SPECIALIZE_CREATE(Section); SPECIALIZE_CREATE(Relocation); SPECIALIZE_CREATE(RelocationEntry); SPECIALIZE_CREATE(Export); SPECIALIZE_CREATE(ExportEntry); SPECIALIZE_CREATE(TLS); SPECIALIZE_CREATE(Symbol); SPECIALIZE_CREATE(Debug); SPECIALIZE_CREATE(CodeView); SPECIALIZE_CREATE(CodeViewPDB); SPECIALIZE_CREATE(Pogo); SPECIALIZE_CREATE(PogoEntry); SPECIALIZE_CREATE(Import); SPECIALIZE_CREATE(ImportEntry); SPECIALIZE_CREATE(DelayImport); SPECIALIZE_CREATE(DelayImportEntry); SPECIALIZE_CREATE(ResourceNode); SPECIALIZE_CREATE(ResourceData); SPECIALIZE_CREATE(ResourceDirectory); SPECIALIZE_CREATE(ResourcesManager); SPECIALIZE_CREATE(ResourceVersion); SPECIALIZE_CREATE(ResourceStringFileInfo); SPECIALIZE_CREATE(ResourceFixedFileInfo); SPECIALIZE_CREATE(ResourceVarFileInfo); SPECIALIZE_CREATE(LangCodeItem); SPECIALIZE_CREATE(ResourceIcon); SPECIALIZE_CREATE(ResourceStringTable); SPECIALIZE_CREATE(ResourceDialog); SPECIALIZE_CREATE(ResourceDialogItem); SPECIALIZE_CREATE(ResourceAccelerator); SPECIALIZE_CREATE(Signature); SPECIALIZE_CREATE(RsaInfo); SPECIALIZE_CREATE(x509); SPECIALIZE_CREATE(SignerInfo); SPECIALIZE_CREATE(Attribute); SPECIALIZE_CREATE(ContentInfo); SPECIALIZE_CREATE(ContentType); SPECIALIZE_CREATE(GenericType); SPECIALIZE_CREATE(MsSpcNestedSignature); SPECIALIZE_CREATE(MsSpcStatementType); SPECIALIZE_CREATE(PKCS9AtSequenceNumber); SPECIALIZE_CREATE(PKCS9CounterSignature); SPECIALIZE_CREATE(PKCS9MessageDigest); SPECIALIZE_CREATE(PKCS9SigningTime); SPECIALIZE_CREATE(SpcSpOpusInfo); SPECIALIZE_CREATE(CodeIntegrity); SPECIALIZE_CREATE(LoadConfiguration); SPECIALIZE_CREATE(LoadConfigurationV0); SPECIALIZE_CREATE(LoadConfigurationV1); SPECIALIZE_CREATE(LoadConfigurationV2); SPECIALIZE_CREATE(LoadConfigurationV3); SPECIALIZE_CREATE(LoadConfigurationV4); SPECIALIZE_CREATE(LoadConfigurationV5); SPECIALIZE_CREATE(LoadConfigurationV6); SPECIALIZE_CREATE(LoadConfigurationV7); SPECIALIZE_CREATE(LoadConfigurationV8); SPECIALIZE_CREATE(LoadConfigurationV9); SPECIALIZE_CREATE(LoadConfigurationV10); SPECIALIZE_CREATE(LoadConfigurationV11); SPECIALIZE_CREATE(ResourcesManager); SPECIALIZE_CREATE(Builder); } } // Opaque containers PYBIND11_MAKE_OPAQUE(std::vector) using dict_langcode_item = std::map; PYBIND11_MAKE_OPAQUE(dict_langcode_item) #endif LIEF-0.13.1/api/python/src/PE/pyUtils.cpp000066400000000000000000000067431443457337100177020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPE.hpp" #include "pyErr.hpp" #include "LIEF/PE/utils.hpp" namespace LIEF { namespace PE { void init_utils(py::module& m) { py::enum_(m, "IMPHASH_MODE", "Enum to define the behavior of :func:`~lief.PE.get_imphash`") .value("DEFAULT", IMPHASH_MODE::DEFAULT, "Default implementation") .value("LIEF", IMPHASH_MODE::LIEF, "Same as DEFAULT") .value("PEFILE", IMPHASH_MODE::PEFILE, "Use pefile algorithm") .value("VT", IMPHASH_MODE::VT, "Same as PEFILE since Virus Total is using pefile"); m.def("is_pe", static_cast(&is_pe), "Check if the given file is a ``PE``", "file"_a); m.def("is_pe", static_cast&)>(&is_pe), "Check if the given raw data is a ``PE``", "raw"_a); m.def("get_type", [] (const std::string& file) { return error_or(static_cast (*)(const std::string&)>(&get_type), file); }, "If the input file is a ``PE`` one, return the " RST_CLASS_REF(lief.PE.PE_TYPE) " \n" "If the function fails to determine the type, it returns a " RST_CLASS_REF(lief.lief_errors) "", "file"_a); m.def("get_type", [] (const std::vector& raw) { return error_or(static_cast (*)(const std::vector&)>(&get_type), raw); }, "If the input *raw* data represent a ``PE`` file, return the " RST_CLASS_REF(lief.PE.PE_TYPE) " \n" "If the function fails to determine the type, it returns a " RST_CLASS_REF(lief.lief_errors) "", "raw"_a); m.def("get_imphash", &get_imphash, R"delim( Compute the hash of imported functions Properties of the hash generated: * Order agnostic * Casse agnostic * Ordinal (**in some extent**) agnostic * If one needs the same output as Virus Total (i.e. pefile), you can use :attr:`~lief.PE.IMPHASH_MODE.PEFILE` as second parameter. .. warning:: The algorithm used to compute the *imphash* value has some variations compared to Yara, pefile, VT implementation .. seealso:: https://www.fireeye.com/blog/threat-research/2014/01/tracking-malware-import-hashing.html )delim", "binary"_a, "mode"_a = IMPHASH_MODE::DEFAULT); m.def("resolve_ordinals", [] (const Import& import, bool strict = false, bool use_std = false) { return error_or(resolve_ordinals, import, strict, use_std); }, "Take an " RST_CLASS_REF(lief.PE.Import) " as entry and try to resolve its ordinal imports\n\n" "The ``strict`` boolean parameter enables to throw a " RST_CLASS_REF(lief.not_found) " exception " "if the ordinal can't be resolved. Otherwise it skips the entry.", "imp"_a, "strict"_a = false, "use_std"_a = false, py::return_value_policy::copy); } } } LIEF-0.13.1/api/python/src/PyIOStream.cpp000066400000000000000000000061461443457337100177160ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "PyIOStream.hpp" #include "LIEF/logging.hpp" namespace LIEF { PyIOStream::PyIOStream(PyIOStream&& other) = default; PyIOStream& PyIOStream::operator=(PyIOStream&& other) = default; result PyIOStream::from_python(py::object object) { py::module_ mod_io; py::object IOBase; if (!mod_io) { mod_io = py::module::import("io"); } if (!IOBase) { IOBase = mod_io.attr("IOBase"); } if (!py::isinstance(object, IOBase)) { logging::log(logging::LOGGING_LEVEL::LOG_ERR, "The provided io object does not sub-class io.IOBase"); return make_error_code(lief_errors::read_error); } if (!py::hasattr(object, "tell")) { logging::log(logging::LOGGING_LEVEL::LOG_ERR, "The provided io object does not implement tell() from io.IOBase"); return make_error_code(lief_errors::read_error); } if (!py::hasattr(object, "seek")) { logging::log(logging::LOGGING_LEVEL::LOG_ERR, "The provided io object does not implement tell() from io.IOBase"); return make_error_code(lief_errors::read_error); } if (!py::hasattr(object, "read") && !py::hasattr(object, "readinto")) { logging::log(logging::LOGGING_LEVEL::LOG_ERR, "The provided io object does not implement read() or readinto()"); return make_error_code(lief_errors::read_error); } return PyIOStream(object); } PyIOStream::PyIOStream(py::object io) : io_{io} { static constexpr int PY_SEEK_SET = 0; static constexpr int PY_SEEK_END = 2; auto seek = io.attr("seek"); seek(0, PY_SEEK_SET); seek(0, PY_SEEK_END); const size_t size = io.attr("tell")().cast(); data_.resize(size); seek(0, PY_SEEK_SET); if (py::hasattr(io_, "readinto")) { auto view = py::memoryview::from_memory(data_.data(), size); io_.attr("readinto")(view); } else if (py::hasattr(io_, "read")) { py::bytes content = io_.attr("read")(size); std::string buffer = std::move(content); std::move(std::begin(buffer), std::end(buffer), data_.data()); } seek(0, PY_SEEK_SET); } result PyIOStream::read_at(uint64_t offset, uint64_t size) const { const uint64_t stream_size = this->size(); if (offset > stream_size || (offset + size) > stream_size) { size_t out_size = (offset + size) - stream_size; //logging::log(logging::LOGGING_LEVEL::LOG_DEBUG, // "Can't read #{:d} bytes at 0x{:04x} (0x{:x} bytes out of bound)", size, offset, out_size); return make_error_code(lief_errors::read_error); } return data_.data() + offset; } PyIOStream::~PyIOStream() = default; } LIEF-0.13.1/api/python/src/PyIOStream.hpp000066400000000000000000000027531443457337100177230ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIEF_PY_IO_STREAM_H #define LIEF_PY_IO_STREAM_H #include #include #include "LIEF/errors.hpp" #include "LIEF/BinaryStream/BinaryStream.hpp" #include "pyLIEF.hpp" namespace LIEF { class PyIOStream : public BinaryStream { public: static result from_python(py::object object); PyIOStream() = delete; PyIOStream(const PyIOStream&) = delete; PyIOStream& operator=(const PyIOStream&) = delete; PyIOStream(PyIOStream&& other); PyIOStream& operator=(PyIOStream&& other); inline uint64_t size() const override { return data_.size(); } ~PyIOStream() override; protected: PyIOStream(py::object io); //ok_error_t peek_in(void* dst, uint64_t offset, uint64_t size) const override; result read_at(uint64_t offset, uint64_t size) const override; py::object io_; std::vector data_; }; } #endif LIEF-0.13.1/api/python/src/VDEX/000077500000000000000000000000001443457337100157555ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/VDEX/CMakeLists.txt000066400000000000000000000012101443457337100205070ustar00rootroot00000000000000set(LIEF_PYTHON_VDEX_SRC "${CMAKE_CURRENT_LIST_DIR}/pyVDEX.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyUtils.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyHeader.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyParser.cpp" "${CMAKE_CURRENT_LIST_DIR}/objects/pyFile.cpp" ) set(LIEF_PYTHON_VDEX_HDR "${CMAKE_CURRENT_LIST_DIR}/pyVDEX.hpp") source_group("Source Files\\VDEX" FILES ${LIEF_PYTHON_VDEX_SRC}) source_group("Header Files\\VDEX" FILES ${LIEF_PYTHON_VDEX_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_VDEX_SRC}" "${LIEF_PYTHON_VDEX_HDR}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}" "${CMAKE_CURRENT_LIST_DIR}/../") LIEF-0.13.1/api/python/src/VDEX/objects/000077500000000000000000000000001443457337100174065ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/VDEX/objects/pyFile.cpp000066400000000000000000000046701443457337100213510ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/VDEX/File.hpp" #include "LIEF/VDEX/hash.hpp" #include "pyIterators.hpp" #include "pyVDEX.hpp" namespace LIEF { namespace VDEX { template using no_const_getter = T (File::*)(); template using no_const_func = T (File::*)(P); template using getter_t = T (File::*)() const; template using setter_t = void (File::*)(T); template<> void create(py::module& m) { // File object py::class_ file(m, "File", "VDEX File representation"); /* * it_dex_files is also registered by OAT/pyBinary.cpp and pybind11 * seems not able to see their (limited) scope such as it raises * generic_type: type "it_dex_files" is already registered! * * NOTE(romain): I tried to add py::local_module in pyIterator.hpp without * success */ try { init_ref_iterator(file, "it_dex_files"); } catch (const std::runtime_error&) {} file .def_property_readonly("header", static_cast>(&File::header), "Return the VDEX " RST_CLASS_REF(lief.VDEX.Header) "", py::return_value_policy::reference) .def_property_readonly("dex_files", static_cast>(&File::dex_files), "Return an iterator over " RST_CLASS_REF(lief.DEX.File) "", py::return_value_policy::reference) .def_property_readonly("dex2dex_json_info", &File::dex2dex_json_info) .def("__eq__", &File::operator==) .def("__ne__", &File::operator!=) .def("__hash__", [] (const File& file) { return Hash::hash(file); }) .def("__str__", [] (const File& file) { std::ostringstream stream; stream << file; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/VDEX/objects/pyHeader.cpp000066400000000000000000000044551443457337100216630ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/VDEX/Header.hpp" #include "LIEF/VDEX/hash.hpp" #include "pyVDEX.hpp" namespace LIEF { namespace VDEX { template using getter_t = T (Header::*)(void) const; template using setter_t = void (Header::*)(T); template<> void create
(py::module& m) { py::class_(m, "Header", "VDEX Header representation") .def_property_readonly("magic", static_cast>(&Header::magic), "Magic value used to identify VDEX") .def_property_readonly("version", static_cast>(&Header::version), "VDEX version number") .def_property_readonly("nb_dex_files", static_cast>(&Header::nb_dex_files), "Number of " RST_CLASS_REF(lief.DEX.File) " files registered") .def_property_readonly("dex_size", static_cast>(&Header::dex_size), "Size of **all** " RST_CLASS_REF(lief.DEX.File) "") .def_property_readonly("verifier_deps_size", static_cast>(&Header::verifier_deps_size), "Size of verifier deps section") .def_property_readonly("quickening_info_size", static_cast>(&Header::quickening_info_size), "Size of quickening info section") .def("__eq__", &Header::operator==) .def("__ne__", &Header::operator!=) .def("__hash__", [] (const Header& header) { return Hash::hash(header); }) .def("__str__", [] (const Header& header) { std::ostringstream stream; stream << header; std::string str = stream.str(); return str; }); } } } LIEF-0.13.1/api/python/src/VDEX/objects/pyParser.cpp000066400000000000000000000046731443457337100217310ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyVDEX.hpp" #include "LIEF/VDEX/Parser.hpp" #include namespace LIEF { namespace VDEX { template<> void create(py::module& m) { // Parser (Parser) m.def("parse", static_cast (*) (const std::string&)>(&Parser::parse), "Parse the given filename and return a " RST_CLASS_REF(lief.VDEX.File) " object", "filename"_a, py::return_value_policy::take_ownership); m.def("parse", static_cast (*) (const std::vector&, const std::string&)>(&Parser::parse), "Parse the given raw data and return a " RST_CLASS_REF(lief.VDEX.File) " object", "raw"_a, py::arg("name") = "", py::return_value_policy::take_ownership); m.def("parse", [] (py::object byteio, const std::string& name) { const auto& io = py::module::import("io"); const auto& RawIOBase = io.attr("RawIOBase"); const auto& BufferedIOBase = io.attr("BufferedIOBase"); const auto& TextIOBase = io.attr("TextIOBase"); py::object rawio; if (py::isinstance(byteio, RawIOBase)) { rawio = byteio; } else if (py::isinstance(byteio, BufferedIOBase)) { rawio = byteio.attr("raw"); } else if (py::isinstance(byteio, TextIOBase)) { rawio = byteio.attr("buffer").attr("raw"); } else { throw py::type_error(py::repr(byteio).cast().c_str()); } std::string raw_str = static_cast(rawio.attr("readall")()); std::vector raw = { std::make_move_iterator(std::begin(raw_str)), std::make_move_iterator(std::end(raw_str))}; return LIEF::VDEX::Parser::parse(std::move(raw), name); }, "io"_a, "name"_a = "", py::return_value_policy::take_ownership); } } } LIEF-0.13.1/api/python/src/VDEX/pyUtils.cpp000066400000000000000000000031421443457337100201320ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyVDEX.hpp" #include "LIEF/VDEX/utils.hpp" namespace LIEF { namespace VDEX { void init_utils(py::module& m) { m.def("is_vdex", static_cast(&is_vdex), "Check if the **file** given in parameter is an VDEX", "path"_a); m.def("is_vdex", static_cast&)>(&is_vdex), "Check if the **raw data** given in parameter is a VDEX", "raw"_a); m.def("version", static_cast(&version), "Return the VDEX version of the **file** given in parameter", "file"_a); m.def("version", static_cast&)>(&version), "Return the VDEX version of the **raw data** given in parameter", "raw"_a); m.def("android_version", &android_version, "Return the " RST_CLASS_REF(lief.Android.ANDROID_VERSIONS) " associated with the given VDEX version ", "vdex_version"_a); } } } LIEF-0.13.1/api/python/src/VDEX/pyVDEX.cpp000066400000000000000000000017401443457337100176020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyVDEX.hpp" namespace LIEF { namespace VDEX { void init_python_module(py::module& m) { py::module LIEF_VDEX_module = m.def_submodule("VDEX", "Python API for VDEX format"); init_objects(LIEF_VDEX_module); init_utils(LIEF_VDEX_module); } void init_objects(py::module& m) { CREATE(Parser, m); CREATE(File, m); CREATE(Header, m); } } } LIEF-0.13.1/api/python/src/VDEX/pyVDEX.hpp000066400000000000000000000021731443457337100176100ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_VDEX_H_ #define PY_LIEF_VDEX_H_ #include "LIEF/VDEX.hpp" #include "pyLIEF.hpp" #define SPECIALIZE_CREATE(X) \ template<> \ void create(py::module&) #define CREATE(X,Y) create(Y) namespace LIEF { namespace VDEX { template void create(py::module&); void init_python_module(py::module& m); void init_objects(py::module&); void init_utils(py::module&); SPECIALIZE_CREATE(Parser); SPECIALIZE_CREATE(File); SPECIALIZE_CREATE(Header); } } #endif LIEF-0.13.1/api/python/src/encoding.cpp000066400000000000000000000050711443457337100175040ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "encoding.hpp" py::object safe_string_converter(const std::string& str) { auto global = py::dict(py::module::import("__main__").attr("__dict__")); auto local = py::dict(); py::bytes name_bytes = py::bytes(str); local["name_bytes"] = name_bytes; #if PY_MAJOR_VERSION >= 3 py::eval(R"( encodings = ["big5", "big5hkscs", "cp037", "cp424", "cp437", "cp500", "cp737", "cp775", "cp850", "cp852", "cp855", "cp856", "cp857", "cp860", "cp861", "cp862", "cp863", "cp864", "cp865", "cp866", "cp869", "cp874", "cp875", "cp932", "cp949", "cp950", "cp1006", "cp1026", "cp1140", "cp1250", "cp1251", "cp1252", "cp1253", "cp1254", "cp1255", "cp1256", "cp1257", "cp1258", "euc_jp", "euc_jis_2004", "euc_jisx0213", "euc_kr", "gb2312", "gbk", "gb18030", "hz", "iso2022_jp", "iso2022_jp_1", "iso2022_jp_2", "iso2022_jp_2004", "iso2022_jp_3", "iso2022_jp_ext", "iso2022_kr", "latin_1", "iso8859_2", "iso8859_3", "iso8859_4", "iso8859_5", "iso8859_6", "iso8859_7", "iso8859_8", "iso8859_9", "iso8859_10", "iso8859_13", "iso8859_14", "iso8859_15", "johab", "koi8_r", "koi8_u", "mac_cyrillic", "mac_greek", "mac_iceland", "mac_latin2", "mac_roman", "mac_turkish", "ptcp154", "shift_jis", "shift_jis_2004", "shift_jisx0213", "utf_32", "utf_32_be", "utf_32_le", "utf_16", "utf_16_be", "utf_16_le", "utf_7", "utf_8_sig" ] for e in encodings: try: name_str = name_bytes.decode(e) break except (UnicodeEncodeError, UnicodeDecodeError) as e: continue name_str = name_bytes.decode('ascii', 'backslashreplace') )", global, local); #else py::eval(R"( def handler(err): start = err.start end = err.end return (u"".join([u"\\x{0:02x}".format(ord(err.object[i])) for i in range(start,end)]),end) import codecs codecs.register_error('backslashreplace_', handler) name_str = name_bytes.decode('ascii', 'backslashreplace_') )", global, local); #endif return local["name_str"]; } LIEF-0.13.1/api/python/src/encoding.hpp000066400000000000000000000015111443457337100175040ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ENCODING_H_ #define PY_LIEF_ENCODING_H_ #include #include namespace py = pybind11; py::object safe_string_converter(const std::string& str); #endif LIEF-0.13.1/api/python/src/enums_wrapper.hpp000066400000000000000000000055421443457337100206150ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ENUMS_WRAPPER_H_ #define PY_LIEF_ENUMS_WRAPPER_H_ #include #include #include "LIEF/visibility.h" namespace py = pybind11; namespace LIEF { template class LIEF_LOCAL enum_ : public pybind11::enum_ { public: using py::enum_::def; using py::enum_::def_property_readonly_static; using Scalar = typename py::enum_::Scalar; template enum_(const py::handle &scope, const char *name, const Extra&... extra) : py::enum_{scope, name, extra...} { constexpr bool is_arithmetic = py::detail::any_of...>::value; def("__eq__", [](const Type &value, Scalar value2) { return (Scalar) value == value2; }); def("__ne__", [](const Type &value, Scalar value2) { return (Scalar) value != value2; }); if (is_arithmetic) { def("__lt__", [](const Type &value, Scalar value2) { return (Scalar) value < value2; }); def("__gt__", [](const Type &value, Scalar value2) { return (Scalar) value > value2; }); def("__le__", [](const Type &value, Scalar value2) { return (Scalar) value <= value2; }); def("__ge__", [](const Type &value, Scalar value2) { return (Scalar) value >= value2; }); def("__invert__", [](const Type &value) { return ~((Scalar) value); }); def("__and__", [](const Type &value, Scalar value2) { return (Scalar) value & value2; }); def("__or__", [](const Type &value, Scalar value2) { return (Scalar) value | value2; }); def("__xor__", [](const Type &value, Scalar value2) { return (Scalar) value ^ value2; }); def("__rand__", [](const Type &value, Scalar value2) { return (Scalar) value & value2; }); def("__ror__", [](const Type &value, Scalar value2) { return (Scalar) value | value2; }); def("__rxor__", [](const Type &value, Scalar value2) { return (Scalar) value ^ value2; }); def("__and__", [](const Type &value, const Type &value2) { return (Scalar) value & (Scalar) value2; }); def("__or__", [](const Type &value, const Type &value2) { return (Scalar) value | (Scalar) value2; }); def("__xor__", [](const Type &value, const Type &value2) { return (Scalar) value ^ (Scalar) value2; }); } } }; } #endif LIEF-0.13.1/api/python/src/platforms/000077500000000000000000000000001443457337100172165ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/platforms/CMakeLists.txt000066400000000000000000000010521443457337100217540ustar00rootroot00000000000000set(LIEF_PYTHON_PLATFORM_SRC "${CMAKE_CURRENT_LIST_DIR}/pyPlatform.cpp" ) set(LIEF_PYTHON_PLATFORM_HDR "${CMAKE_CURRENT_LIST_DIR}/pyPlatform.hpp") source_group("Source Files\\Platform" FILES ${LIEF_PYTHON_PLATFORM_SRC}) source_group("Header Files\\Platform" FILES ${LIEF_PYTHON_PLATFORM_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_PLATFORM_HDR}" "${LIEF_PYTHON_PLATFORM_SRC}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}" "${CMAKE_CURRENT_LIST_DIR}/../") include("${CMAKE_CURRENT_LIST_DIR}/android/CMakeLists.txt") LIEF-0.13.1/api/python/src/platforms/android/000077500000000000000000000000001443457337100206365ustar00rootroot00000000000000LIEF-0.13.1/api/python/src/platforms/android/CMakeLists.txt000066400000000000000000000010231443457337100233720ustar00rootroot00000000000000set(LIEF_PYTHON_ANDROID_SRC "${CMAKE_CURRENT_LIST_DIR}/pyAndroid.cpp" "${CMAKE_CURRENT_LIST_DIR}/pyVersion.cpp" ) set(LIEF_PYTHON_ANDROID_HDR "${CMAKE_CURRENT_LIST_DIR}/pyAndroid.hpp") source_group("Source Files\\Android" FILES ${LIEF_PYTHON_ANDROID_SRC}) source_group("Header Files\\Android" FILES ${LIEF_PYTHON_ANDROID_HDR}) target_sources(pyLIEF PRIVATE "${LIEF_PYTHON_ANDROID_SRC}" "${LIEF_PYTHON_ANDROID_HDR}") target_include_directories(pyLIEF PUBLIC "${CMAKE_CURRENT_LIST_DIR}" "${CMAKE_CURRENT_LIST_DIR}/../../") LIEF-0.13.1/api/python/src/platforms/android/pyAndroid.cpp000066400000000000000000000015621443457337100232770ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyAndroid.hpp" namespace LIEF { namespace Android { void init_python_module(py::module& m) { py::module lief_android_module = m.def_submodule("Android", "Python API for Android platform"); init_versions(lief_android_module); } } } LIEF-0.13.1/api/python/src/platforms/android/pyAndroid.hpp000066400000000000000000000015461443457337100233060ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ANDROID_H_ #define PY_LIEF_ANDROID_H_ #include "LIEF/platforms/android.hpp" #include "pyLIEF.hpp" namespace LIEF { namespace Android { void init_python_module(py::module&); void init_versions(py::module&); } } #endif LIEF-0.13.1/api/python/src/platforms/android/pyVersion.cpp000066400000000000000000000032051443457337100233400ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyAndroid.hpp" #include "LIEF/platforms/android/version.hpp" #define PY_ENUM(x) to_string(x), x namespace LIEF { namespace Android { void init_versions(py::module& m) { py::enum_(m, "ANDROID_VERSIONS") .value(PY_ENUM(ANDROID_VERSIONS::VERSION_UNKNOWN)) .value(PY_ENUM(ANDROID_VERSIONS::VERSION_601)) .value(PY_ENUM(ANDROID_VERSIONS::VERSION_700)) .value(PY_ENUM(ANDROID_VERSIONS::VERSION_710)) .value(PY_ENUM(ANDROID_VERSIONS::VERSION_712)) .value(PY_ENUM(ANDROID_VERSIONS::VERSION_800)) .value(PY_ENUM(ANDROID_VERSIONS::VERSION_810)) .value(PY_ENUM(ANDROID_VERSIONS::VERSION_900)); m.def("code_name", &code_name, "Return the Android code associated with a " RST_CLASS_REF(lief.Android.ANDROID_VERSIONS) ".\n" "For example: ``Nougat``", "version"_a); m.def("version_string", &version_string, "Return the " RST_CLASS_REF(lief.Android.ANDROID_VERSIONS) " as a string.\n" "For example: ``7.0.1``", "version"_a); } } } LIEF-0.13.1/api/python/src/platforms/pyPlatform.cpp000066400000000000000000000022411443457337100220560ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyPlatform.hpp" #include "enums_wrapper.hpp" namespace LIEF { void init_python_platforms(py::module& m) { LIEF::enum_(m, "PLATFORMS") .value("UNKNOWN", PLATFORMS::UNKNOWN) .value("LINUX", PLATFORMS::LINUX) .value("ANDROID", PLATFORMS::ANDROID_PLAT) .value("WINDOWS", PLATFORMS::WINDOWS) .value("IOS", PLATFORMS::IOS) .value("OSX", PLATFORMS::OSX); m.def("current_platform", ¤t_platform, "Return the current plaform (Linux, Windows, ...) as a :attr:`lief.PLATFORMS` enum"); } } LIEF-0.13.1/api/python/src/platforms/pyPlatform.hpp000066400000000000000000000014541443457337100220700ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_PLATFORM_H_ #define PY_LIEF_PLATFORM_H_ #include "LIEF/platforms.hpp" #include "pyLIEF.hpp" namespace LIEF { void init_python_platforms(py::module&); } #endif LIEF-0.13.1/api/python/src/pyErr.cpp000066400000000000000000000034421443457337100170170ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyErr.hpp" void init_LIEF_errors(py::module& m) { py::class_(m, "ok_t", R"delim( Opaque value returned when a **void** function is executed successfully. )delim") .def("__bool__", [] (const LIEF::ok_t& ok) { return true; }); py::enum_(m, "lief_errors", R"delim( Enum class which represents an error generated by LIEF's functions )delim") .value("read_error", lief_errors::read_error) .value("not_found", lief_errors::not_found) .value("not_implemented", lief_errors::not_implemented) .value("not_supported", lief_errors::not_supported) .value("corrupted", lief_errors::corrupted) .value("conversion_error", lief_errors::conversion_error) .value("read_out_of_bound", lief_errors::read_out_of_bound) .value("asn1_bad_tag", lief_errors::asn1_bad_tag) .value("file_error", lief_errors::file_error) .value("file_format_error", lief_errors::file_format_error) .value("parsing_error", lief_errors::parsing_error) .value("build_error", lief_errors::build_error) .value("data_too_large", lief_errors::data_too_large) ; } LIEF-0.13.1/api/python/src/pyErr.hpp000066400000000000000000000026401443457337100170230ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ERR_H_ #define PY_LIEF_ERR_H_ #include #include "LIEF/errors.hpp" namespace py = pybind11; template >{}, int> = 0> py::object error_or(Func f, Ts&&... args) { auto&& ret = f(std::forward(args)...); if (!ret) { return py::cast(LIEF::as_lief_err(ret)); } return py::cast(ret.value()); } template >{}, int> = 0> py::object error_or(Func f, Ts&&... args) { auto&& ret = std::mem_fn(f)(std::forward(args)...); if (!ret) { return py::cast(LIEF::as_lief_err(ret)); } return py::cast(ret.value()); } void init_LIEF_errors(py::module&); #endif LIEF-0.13.1/api/python/src/pyHash.cpp000066400000000000000000000024031443457337100171460ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/config.h" #include "LIEF/hash.hpp" #include "pyLIEF.hpp" void init_hash_functions(py::module& m) { m.def("hash", static_cast(&LIEF::hash)); m.def("hash", static_cast&)>(&LIEF::hash)); m.def("hash", [] (py::bytes bytes) { std::string x = bytes; std::vector data = {std::begin(x), std::end(x)}; return LIEF::hash(data); }); m.def("hash", [] (const std::string& bytes) { std::vector data = {std::begin(bytes), std::end(bytes)}; return LIEF::hash(data); }); } LIEF-0.13.1/api/python/src/pyIterators.hpp000066400000000000000000000031531443457337100202470ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_ITERATORS_H_ #define PY_LIEF_ITERATORS_H_ #include #include "LIEF/LIEF.hpp" namespace py = pybind11; template void init_ref_iterator(py::handle& m, const char* it_name) { py::class_(m, it_name) .def("__getitem__", [](T& v, size_t i) -> typename T::reference { if (i >= v.size()) throw py::index_error(); return v[i]; }, py::return_value_policy::reference_internal, py::keep_alive<1, 0>()) .def("__len__", [] (T& v) { return v.size(); }) .def("__iter__", [] (const T& v) { return py::make_iterator(std::begin(v), std::end(v)); }, py::keep_alive<0, 1>()) .def("__next__", [] (T& v) -> typename T::reference { if (v == std::end(v)) { throw py::stop_iteration(); } return *(v++); }, py::return_value_policy::reference_internal, py::keep_alive<1, 0>()); } #endif LIEF-0.13.1/api/python/src/pyJson.cpp000066400000000000000000000016171443457337100172020ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/config.h" #include "LIEF/json.hpp" #include "LIEF/Abstract/json.hpp" #include "LIEF/Object.hpp" #include "pyLIEF.hpp" void init_json_functions(py::module& m) { m.def("to_json", &LIEF::to_json); m.def("to_json_from_abstract", &LIEF::to_json_from_abstract); } LIEF-0.13.1/api/python/src/pyLIEF.cpp000066400000000000000000000053321443457337100170060ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/logging.hpp" #include "LIEF/version.h" #include "pyLIEF.hpp" #include "pyAbstract.hpp" #if defined(LIEF_ELF_SUPPORT) #include "ELF/pyELF.hpp" #endif #if defined(LIEF_PE_SUPPORT) #include "PE/pyPE.hpp" #endif #if defined(LIEF_MACHO_SUPPORT) #include "MachO/pyMachO.hpp" #endif #if defined(LIEF_OAT_SUPPORT) #include "OAT/pyOAT.hpp" #endif #if defined(LIEF_VDEX_SUPPORT) #include "VDEX/pyVDEX.hpp" #endif #if defined(LIEF_DEX_SUPPORT) #include "DEX/pyDEX.hpp" #endif #if defined(LIEF_ART_SUPPORT) #include "ART/pyART.hpp" #endif #include "platforms/android/pyAndroid.hpp" #include "platforms/pyPlatform.hpp" PYBIND11_MODULE(_lief, LIEF_module) { LIEF_module.attr("__version__") = py::str(LIEF_VERSION); LIEF_module.attr("__tag__") = py::str(LIEF_TAG); LIEF_module.attr("__commit__") = py::str(LIEF_COMMIT); LIEF_module.attr("__is_tagged__") = py::bool_(LIEF_TAGGED); LIEF_module.doc() = "Python API for LIEF"; LIEF::init_python_platforms(LIEF_module); init_LIEF_Object_class(LIEF_module); init_LIEF_errors(LIEF_module); init_LIEF_Logger(LIEF_module); // Init the LIEF module LIEF::init_python_module(LIEF_module); init_hash_functions(LIEF_module); // Init the ELF module #if defined(LIEF_ELF_SUPPORT) LIEF::ELF::init_python_module(LIEF_module); #endif // Init the PE module #if defined(LIEF_PE_SUPPORT) LIEF::PE::init_python_module(LIEF_module); #endif // Init the MachO module #if defined(LIEF_MACHO_SUPPORT) LIEF::MachO::init_python_module(LIEF_module); #endif // Init the OAT module #if defined(LIEF_OAT_SUPPORT) LIEF::OAT::init_python_module(LIEF_module); #endif // Init the VDEX module #if defined(LIEF_VDEX_SUPPORT) LIEF::VDEX::init_python_module(LIEF_module); #endif // Init the DEX module #if defined(LIEF_DEX_SUPPORT) LIEF::DEX::init_python_module(LIEF_module); #endif // Init the ART module #if defined(LIEF_ART_SUPPORT) LIEF::ART::init_python_module(LIEF_module); #endif LIEF::Android::init_python_module(LIEF_module); // Init util functions init_utils_functions(LIEF_module); init_json_functions(LIEF_module); } LIEF-0.13.1/api/python/src/pyLIEF.hpp000066400000000000000000000026171443457337100170160ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef PY_LIEF_H_ #define PY_LIEF_H_ #include #include #include #include #include #include "encoding.hpp" #include "pyErr.hpp" #define RST_CLASS_REF(X) ":class:`~"#X"`" #define RST_CLASS_REF_FULL(X) ":class:`"#X"`" #define RST_ATTR_REF(X) ":attr:`~"#X"`" #define RST_ATTR_REF_FULL(X) ":attr:`"#X"`" #define RST_METH_REF(X) ":class:`~"#X"`" #define RST_METH_REF_FULL(X) ":class:`"#X"`" namespace py = pybind11; using namespace pybind11::literals; void init_LIEF_Object_class(py::module&); void init_LIEF_Logger(py::module&); void init_LIEF_module(py::module&); void init_hash_functions(py::module&); void init_utils_functions(py::module&); void init_json_functions(py::module&); #endif LIEF-0.13.1/api/python/src/pyLogger.cpp000066400000000000000000000033601443457337100175050ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "pyLIEF.hpp" #include "LIEF/logging.hpp" #define PY_ENUM(x) LIEF::logging::to_string(x), x void init_LIEF_Logger(py::module& m) { using namespace LIEF; py::module logging = m.def_submodule("logging"); py::enum_(logging, "LOGGING_LEVEL") .value(PY_ENUM(logging::LOGGING_LEVEL::LOG_TRACE)) .value(PY_ENUM(logging::LOGGING_LEVEL::LOG_DEBUG)) .value(PY_ENUM(logging::LOGGING_LEVEL::LOG_CRITICAL)) .value(PY_ENUM(logging::LOGGING_LEVEL::LOG_ERR)) .value(PY_ENUM(logging::LOGGING_LEVEL::LOG_WARN)) .value(PY_ENUM(logging::LOGGING_LEVEL::LOG_INFO)); logging.def("disable", &logging::disable, "Disable the logger globally"); logging.def("enable", &logging::enable, "Enable the logger globally"); logging.def("set_level", &logging::set_level, "Change logging level", "level"_a); logging.def("set_path", &logging::set_path, "Change the logger as a file-base logging and set its path", "path"_a); logging.def("log", &logging::log, "Log a message with the LIEF's logger", "level"_a, "msg"_a); } LIEF-0.13.1/api/python/src/pyObject.cpp000066400000000000000000000002121443457337100174650ustar00rootroot00000000000000#include "pyLIEF.hpp" #include "LIEF/Object.hpp" void init_LIEF_Object_class(py::module& m) { py::class_(m, "Object"); } LIEF-0.13.1/api/python/src/pyUtils.cpp000066400000000000000000000147601443457337100173740ustar00rootroot00000000000000/* Copyright 2017 - 2023 R. Thomas * Copyright 2017 - 2023 Quarkslab * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "LIEF/PE/utils.hpp" #include "LIEF/MachO/utils.hpp" #include "LIEF/ELF/utils.hpp" #include "LIEF/OAT.hpp" #include "LIEF/DEX.hpp" #include "LIEF/VDEX.hpp" #include "LIEF/ART.hpp" #define LIEF_PE_FORCE_UNDEF #include "LIEF/PE/undef.h" #include "pyLIEF.hpp" void init_utils_functions(py::module& m) { m.def("shell", [] (void) { const auto& InteractiveShellEmbed = py::module::import("IPython").attr("terminal").attr("embed").attr("InteractiveShellEmbed"); const auto& ipshell = InteractiveShellEmbed("banner1"_a = "Dropping into IPython", "exit_msg"_a = "Leaving Interpreter, back to program."); return ipshell(); }, "Drop into an IPython Interpreter"); m.def("demangle", [] (const std::string& name) -> py::object { #if defined(__unix__) int status; char* demangled_name = abi::__cxa_demangle(name.c_str(), 0, 0, &status); if (status == 0) { std::string realname = demangled_name; free(demangled_name); return py::str(realname); } else { return py::none(); } #else return py::none(); #endif }); m.def("breakp", [] (void) { py::object set_trace = py::module::import("pdb").attr("set_trace"); return set_trace(); }, "Trigger 'pdb.set_trace()'"); #if defined(LIEF_PE_SUPPORT) m.def("is_pe", static_cast(&LIEF::PE::is_pe), "Check if the given file is a ``PE`` (from filename)", "filename"_a); m.def("is_pe", static_cast&)>(&LIEF::PE::is_pe), "Check if the given raw data is a ``PE``", "raw"_a); #endif #if defined(LIEF_ELF_SUPPORT) m.def("is_elf", static_cast(&LIEF::ELF::is_elf), "Check if the given file is an ``ELF``", "filename"_a); m.def("is_elf", static_cast&)>(&LIEF::ELF::is_elf), "Check if the given raw data is an ``ELF``", "raw"_a); #endif #if defined(LIEF_MACHO_SUPPORT) m.def("is_macho", static_cast(&LIEF::MachO::is_macho), "Check if the given file is a ``MachO`` (from filename)", "filename"_a); m.def("is_macho", static_cast&)>(&LIEF::MachO::is_macho), "Check if the given raw data is a ``MachO``", "raw"_a); #endif #if defined(LIEF_OAT_SUPPORT) m.def("is_oat", static_cast(&LIEF::OAT::is_oat), "Check if the given file is an ``OAT`` (from filename)", "filename"_a); m.def("is_oat", static_cast&)>(&LIEF::OAT::is_oat), "Check if the given raw data is an ``OAT``", "raw"_a); m.def("is_oat", static_cast(&LIEF::OAT::is_oat), "Check if the given " RST_CLASS_REF(lief.ELF.Binary) " is an ``OAT``", "elf"_a); m.def("oat_version", static_cast(&LIEF::OAT::version), "Return the OAT version of the given file", "filename"_a); m.def("oat_version", static_cast&)>(&LIEF::OAT::version), "Return the OAT version of the raw data", "raw"_a); m.def("oat_version", static_cast(&LIEF::OAT::version), "Return the OAT version of the given " RST_CLASS_REF(lief.ELF.Binary) "", "elf"_a); #endif #if defined(LIEF_DEX_SUPPORT) m.def("is_dex", static_cast(&LIEF::DEX::is_dex), "Check if the given file is a ``DEX`` (from filename)", "filename"_a); m.def("is_dex", static_cast&)>(&LIEF::DEX::is_dex), "Check if the given raw data is a ``DEX``", "raw"_a); m.def("dex_version", static_cast(&LIEF::DEX::version), "Return the OAT version of the given file", "filename"_a); m.def("dex_version", static_cast&)>(&LIEF::DEX::version), "Return the DEX version of the raw data", "raw"_a); #endif #if defined(LIEF_VDEX_SUPPORT) m.def("is_vdex", static_cast(&LIEF::VDEX::is_vdex), "Check if the given file is a ``VDEX`` (from filename)", "filename"_a); m.def("is_vdex", static_cast&)>(&LIEF::VDEX::is_vdex), "Check if the given raw data is a ``VDEX``", "raw"_a); m.def("vdex_version", static_cast(&LIEF::VDEX::version), "Return the VDEX version of the given file", "filename"_a); m.def("vdex_version", static_cast&)>(&LIEF::VDEX::version), "Return the VDEX version of the raw data", "raw"_a); #endif #if defined(LIEF_ART_SUPPORT) m.def("is_art", static_cast(&LIEF::ART::is_art), "Check if the given file is an ``ART`` (from filename)", "filename"_a); m.def("is_art", static_cast&)>(&LIEF::ART::is_art), "Check if the given raw data is an ``ART``", "raw"_a); m.def("art_version", static_cast(&LIEF::ART::version), "Return the ART version of the given file", "filename"_a); m.def("art_version", static_cast&)>(&LIEF::ART::version), "Return the ART version of the raw data", "raw"_a); #endif } LIEF-0.13.1/cmake/000077500000000000000000000000001443457337100134065ustar00rootroot00000000000000LIEF-0.13.1/cmake/FindPythonLibsNew.cmake000066400000000000000000000242151443457337100177620ustar00rootroot00000000000000# - Find python libraries # This module finds the libraries corresponding to the Python interpreter # FindPythonInterp provides. # This code sets the following variables: # # PYTHONLIBS_FOUND - have the Python libs been found # PYTHON_PREFIX - path to the Python installation # PYTHON_LIBRARIES - path to the python library # PYTHON_INCLUDE_DIRS - path to where Python.h is found # PYTHON_MODULE_EXTENSION - lib extension, e.g. '.so' or '.pyd' # PYTHON_MODULE_PREFIX - lib name prefix: usually an empty string # PYTHON_SITE_PACKAGES - path to installation site-packages # PYTHON_IS_DEBUG - whether the Python interpreter is a debug build # # Thanks to talljimbo for the patch adding the 'LDVERSION' config # variable usage. #============================================================================= # Copyright 2001-2009 Kitware, Inc. # Copyright 2012 Continuum Analytics, Inc. # # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # # * Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # # * Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # # * Neither the names of Kitware, Inc., the Insight Software Consortium, # nor the names of their contributors may be used to endorse or promote # products derived from this software without specific prior written # permission. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR # # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT # HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #============================================================================= # Checking for the extension makes sure that `LibsNew` was found and not just `Libs`. if(PYTHONLIBS_FOUND AND PYTHON_MODULE_EXTENSION) return() endif() if(PythonLibsNew_FIND_QUIETLY) set(_pythonlibs_quiet QUIET) else() set(_pythonlibs_quiet "") endif() if(PythonLibsNew_FIND_REQUIRED) set(_pythonlibs_required REQUIRED) endif() # Check to see if the `python` command is present and from a virtual # environment, conda, or GHA activation - if it is, try to use that. if(NOT DEFINED PYTHON_EXECUTABLE) if(DEFINED ENV{VIRTUAL_ENV}) find_program( PYTHON_EXECUTABLE python PATHS "$ENV{VIRTUAL_ENV}" "$ENV{VIRTUAL_ENV}/bin" NO_DEFAULT_PATH) elseif(DEFINED ENV{CONDA_PREFIX}) find_program( PYTHON_EXECUTABLE python PATHS "$ENV{CONDA_PREFIX}" "$ENV{CONDA_PREFIX}/bin" NO_DEFAULT_PATH) elseif(DEFINED ENV{pythonLocation}) find_program( PYTHON_EXECUTABLE python PATHS "$ENV{pythonLocation}" "$ENV{pythonLocation}/bin" NO_DEFAULT_PATH) endif() if(NOT PYTHON_EXECUTABLE) unset(PYTHON_EXECUTABLE) endif() endif() # Use the Python interpreter to find the libs. if(NOT PythonLibsNew_FIND_VERSION) set(PythonLibsNew_FIND_VERSION "3.6") endif() find_package(PythonInterp ${PythonLibsNew_FIND_VERSION} ${_pythonlibs_required} ${_pythonlibs_quiet}) if(NOT PYTHONINTERP_FOUND) set(PYTHONLIBS_FOUND FALSE) set(PythonLibsNew_FOUND FALSE) return() endif() # According to https://stackoverflow.com/questions/646518/python-how-to-detect-debug-interpreter # testing whether sys has the gettotalrefcount function is a reliable, cross-platform # way to detect a CPython debug interpreter. # # The library suffix is from the config var LDVERSION sometimes, otherwise # VERSION. VERSION will typically be like "2.7" on unix, and "27" on windows. execute_process( COMMAND "${PYTHON_EXECUTABLE}" "-c" " import sys;import struct; import sysconfig as s USE_SYSCONFIG = sys.version_info >= (3, 10) if not USE_SYSCONFIG: from distutils import sysconfig as ds print('.'.join(str(v) for v in sys.version_info)); print(sys.prefix); if USE_SYSCONFIG: scheme = s.get_default_scheme() if scheme == 'posix_local': # Debian's default scheme installs to /usr/local/ but we want to find headers in /usr/ scheme = 'posix_prefix' print(s.get_path('platinclude', scheme)) print(s.get_path('platlib')) else: print(ds.get_python_inc(plat_specific=True)); print(ds.get_python_lib(plat_specific=True)); print(s.get_config_var('EXT_SUFFIX') or s.get_config_var('SO')); print(hasattr(sys, 'gettotalrefcount')+0); print(struct.calcsize('@P')); print(s.get_config_var('LDVERSION') or s.get_config_var('VERSION')); print(s.get_config_var('LIBDIR') or ''); print(s.get_config_var('MULTIARCH') or ''); " RESULT_VARIABLE _PYTHON_SUCCESS OUTPUT_VARIABLE _PYTHON_VALUES ERROR_VARIABLE _PYTHON_ERROR_VALUE) if(NOT _PYTHON_SUCCESS MATCHES 0) if(PythonLibsNew_FIND_REQUIRED) message(FATAL_ERROR "Python config failure:\n${_PYTHON_ERROR_VALUE}") endif() set(PYTHONLIBS_FOUND FALSE) set(PythonLibsNew_FOUND FALSE) return() endif() # Convert the process output into a list if(WIN32) string(REGEX REPLACE "\\\\" "/" _PYTHON_VALUES ${_PYTHON_VALUES}) endif() string(REGEX REPLACE ";" "\\\\;" _PYTHON_VALUES ${_PYTHON_VALUES}) string(REGEX REPLACE "\n" ";" _PYTHON_VALUES ${_PYTHON_VALUES}) list(GET _PYTHON_VALUES 0 _PYTHON_VERSION_LIST) list(GET _PYTHON_VALUES 1 PYTHON_PREFIX) list(GET _PYTHON_VALUES 2 PYTHON_INCLUDE_DIR) list(GET _PYTHON_VALUES 3 PYTHON_SITE_PACKAGES) list(GET _PYTHON_VALUES 4 PYTHON_MODULE_EXTENSION) list(GET _PYTHON_VALUES 5 PYTHON_IS_DEBUG) list(GET _PYTHON_VALUES 6 PYTHON_SIZEOF_VOID_P) list(GET _PYTHON_VALUES 7 PYTHON_LIBRARY_SUFFIX) list(GET _PYTHON_VALUES 8 PYTHON_LIBDIR) list(GET _PYTHON_VALUES 9 PYTHON_MULTIARCH) # Make sure the Python has the same pointer-size as the chosen compiler # Skip if CMAKE_SIZEOF_VOID_P is not defined if(CMAKE_SIZEOF_VOID_P AND (NOT "${PYTHON_SIZEOF_VOID_P}" STREQUAL "${CMAKE_SIZEOF_VOID_P}")) if(PythonLibsNew_FIND_REQUIRED) math(EXPR _PYTHON_BITS "${PYTHON_SIZEOF_VOID_P} * 8") math(EXPR _CMAKE_BITS "${CMAKE_SIZEOF_VOID_P} * 8") message(FATAL_ERROR "Python config failure: Python is ${_PYTHON_BITS}-bit, " "chosen compiler is ${_CMAKE_BITS}-bit") endif() set(PYTHONLIBS_FOUND FALSE) set(PythonLibsNew_FOUND FALSE) return() endif() # The built-in FindPython didn't always give the version numbers string(REGEX REPLACE "\\." ";" _PYTHON_VERSION_LIST ${_PYTHON_VERSION_LIST}) list(GET _PYTHON_VERSION_LIST 0 PYTHON_VERSION_MAJOR) list(GET _PYTHON_VERSION_LIST 1 PYTHON_VERSION_MINOR) list(GET _PYTHON_VERSION_LIST 2 PYTHON_VERSION_PATCH) set(PYTHON_VERSION "${PYTHON_VERSION_MAJOR}.${PYTHON_VERSION_MINOR}.${PYTHON_VERSION_PATCH}") # Make sure all directory separators are '/' string(REGEX REPLACE "\\\\" "/" PYTHON_PREFIX "${PYTHON_PREFIX}") string(REGEX REPLACE "\\\\" "/" PYTHON_INCLUDE_DIR "${PYTHON_INCLUDE_DIR}") string(REGEX REPLACE "\\\\" "/" PYTHON_SITE_PACKAGES "${PYTHON_SITE_PACKAGES}") if(CMAKE_HOST_WIN32) set(PYTHON_LIBRARY "${PYTHON_PREFIX}/libs/python${PYTHON_LIBRARY_SUFFIX}.lib") # when run in a venv, PYTHON_PREFIX points to it. But the libraries remain in the # original python installation. They may be found relative to PYTHON_INCLUDE_DIR. if(NOT EXISTS "${PYTHON_LIBRARY}") get_filename_component(_PYTHON_ROOT ${PYTHON_INCLUDE_DIR} DIRECTORY) set(PYTHON_LIBRARY "${_PYTHON_ROOT}/libs/python${PYTHON_LIBRARY_SUFFIX}.lib") endif() # if we are in MSYS & MINGW, and we didn't find windows python lib, look for system python lib if(DEFINED ENV{MSYSTEM} AND MINGW AND NOT EXISTS "${PYTHON_LIBRARY}") if(PYTHON_MULTIARCH) set(_PYTHON_LIBS_SEARCH "${PYTHON_LIBDIR}/${PYTHON_MULTIARCH}" "${PYTHON_LIBDIR}") else() set(_PYTHON_LIBS_SEARCH "${PYTHON_LIBDIR}") endif() unset(PYTHON_LIBRARY) find_library( PYTHON_LIBRARY NAMES "python${PYTHON_LIBRARY_SUFFIX}" PATHS ${_PYTHON_LIBS_SEARCH} NO_DEFAULT_PATH) endif() # raise an error if the python libs are still not found. if(NOT EXISTS "${PYTHON_LIBRARY}") message(FATAL_ERROR "Python libraries not found") endif() else() if(PYTHON_MULTIARCH) set(_PYTHON_LIBS_SEARCH "${PYTHON_LIBDIR}/${PYTHON_MULTIARCH}" "${PYTHON_LIBDIR}") else() set(_PYTHON_LIBS_SEARCH "${PYTHON_LIBDIR}") endif() #message(STATUS "Searching for Python libs in ${_PYTHON_LIBS_SEARCH}") # Probably this needs to be more involved. It would be nice if the config # information the python interpreter itself gave us were more complete. find_library( PYTHON_LIBRARY NAMES "python${PYTHON_LIBRARY_SUFFIX}" PATHS ${_PYTHON_LIBS_SEARCH} NO_DEFAULT_PATH) # If all else fails, just set the name/version and let the linker figure out the path. if(NOT PYTHON_LIBRARY) set(PYTHON_LIBRARY python${PYTHON_LIBRARY_SUFFIX}) endif() endif() mark_as_advanced(PYTHON_LIBRARY PYTHON_INCLUDE_DIR) # We use PYTHON_INCLUDE_DIR, PYTHON_LIBRARY and PYTHON_DEBUG_LIBRARY for the # cache entries because they are meant to specify the location of a single # library. We now set the variables listed by the documentation for this # module. set(PYTHON_INCLUDE_DIRS "${PYTHON_INCLUDE_DIR}") set(PYTHON_LIBRARIES "${PYTHON_LIBRARY}") if(NOT PYTHON_DEBUG_LIBRARY) set(PYTHON_DEBUG_LIBRARY "") endif() set(PYTHON_DEBUG_LIBRARIES "${PYTHON_DEBUG_LIBRARY}") find_package_message(PYTHON "Found PythonLibs: ${PYTHON_LIBRARY}" "${PYTHON_EXECUTABLE}${PYTHON_VERSION_STRING}") set(PYTHONLIBS_FOUND TRUE) set(PythonLibsNew_FOUND TRUE) if(NOT PYTHON_MODULE_PREFIX) set(PYTHON_MODULE_PREFIX "") endif() LIEF-0.13.1/cmake/FindSphinx.cmake000066400000000000000000000016531443457337100164670ustar00rootroot00000000000000# CMake find_package() Module for Sphinx documentation generator # http://sphinx-doc.org/ # # Example usage: # # find_package(Sphinx) # # If successful the following variables will be defined # SPHINX_FOUND # SPHINX_EXECUTABLE find_program(SPHINX_EXECUTABLE NAMES sphinx-build sphinx-build2 DOC "Path to sphinx-build executable") # Handle REQUIRED and QUIET arguments # this will also set SPHINX_FOUND to true if SPHINX_EXECUTABLE exists include(FindPackageHandleStandardArgs) find_package_handle_standard_args(Sphinx "Failed to locate sphinx-build executable" SPHINX_EXECUTABLE) # Provide options for controlling different types of output option(SPHINX_OUTPUT_HTML "Output standalone HTML files" ON) option(SPHINX_OUTPUT_MAN "Output man pages" ON) option(SPHINX_WARNINGS_AS_ERRORS "When building documentation treat warnings as errors" ON) LIEF-0.13.1/cmake/LIEF.pc.in000066400000000000000000000007171443457337100150630ustar00rootroot00000000000000prefix="@CMAKE_INSTALL_PREFIX@" exec_prefix="${prefix}" libdir="${prefix}/lib" includedir="${prefix}/include" Name: LIEF Description: Library to Instrument Executable Formats URL: https://github.com/lief-project/LIEF Version: @LIEF_VERSION_MAJOR@.@LIEF_VERSION_MINOR@.@LIEF_VERSION_PATCH@ Requires: @PKGCONF_REQ_PUB@ Requires.private: @PKGCONF_REQ_PRIV@ Cflags: -I"${includedir}" Libs: -L"${libdir}" -lLIEF Libs.private: -L"${libdir}" -lLIEF @PKGCONF_LIBS_PRIV@ LIEF-0.13.1/cmake/LIEFApi.cmake000066400000000000000000000010671443457337100155650ustar00rootroot00000000000000if(__add_lief_api) return() endif() set(__add_lief_api ON) # Python # ------ if (LIEF_PYTHON_API) if(WIN32) set(PYTHON_BUILD_LIEF_DIRECTORY "${CMAKE_BINARY_DIR}/api/python/Release") else() set(PYTHON_BUILD_LIEF_DIRECTORY "${CMAKE_BINARY_DIR}/api/python") endif() add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/api/python") endif() # C API # ----- if(LIEF_C_API) target_include_directories(LIB_LIEF PUBLIC "$") include("${CMAKE_CURRENT_SOURCE_DIR}/api/c/CMakeLists.txt") endif() LIEF-0.13.1/cmake/LIEFCompilerDetection.cmake000066400000000000000000000015441443457337100204650ustar00rootroot00000000000000if(__add_lief_compiler_detection) return() endif() set(__add_lief_compiler_detection ON) set(LIEF_SUPPORT_CXX11 0) set(LIEF_SUPPORT_CXX14 0) set(LIEF_SUPPORT_CXX17 0) if (cxx_std_11 IN_LIST CMAKE_CXX_COMPILE_FEATURES) set(LIEF_SUPPORT_CXX11 1) endif() if (cxx_std_14 IN_LIST CMAKE_CXX_COMPILE_FEATURES) if (${MSVC} AND ${MSVC_TOOLSET_VERSION} GREATER_EQUAL 141) set(LIEF_SUPPORT_CXX14 1) elseif((NOT DEFINED MSVC) OR (NOT ${MSVC})) set(LIEF_SUPPORT_CXX14 1) endif() endif() if (cxx_std_17 IN_LIST CMAKE_CXX_COMPILE_FEATURES) if (${MSVC} AND ${MSVC_TOOLSET_VERSION} GREATER_EQUAL 142) set(LIEF_SUPPORT_CXX17 1) elseif((NOT DEFINED MSVC) OR (NOT ${MSVC})) set(LIEF_SUPPORT_CXX17 1) endif() endif() configure_file( "${CMAKE_CURRENT_SOURCE_DIR}/src/compiler_support.h.in" "${CMAKE_CURRENT_BINARY_DIR}/compiler_support.h" @ONLY ) LIEF-0.13.1/cmake/LIEFCompilerFlags.cmake000066400000000000000000000164251443457337100176070ustar00rootroot00000000000000include(CheckCCompilerFlag) include(CheckCXXCompilerFlag) if(__add_lief_compiler_flags) return() endif() set(__add_lief_compiler_flags ON) function(append value) foreach(variable ${ARGN}) set(${variable} "${${variable}} ${value}" PARENT_SCOPE) endforeach(variable) endfunction() function(append_if condition value) if (${condition}) foreach(variable ${ARGN}) set(${variable} "${${variable}} ${value}" PARENT_SCOPE) endforeach(variable) endif() endfunction() macro(ADD_FLAG_IF_SUPPORTED flag name) CHECK_C_COMPILER_FLAG("${flag}" "C_SUPPORTS_${name}") CHECK_CXX_COMPILER_FLAG("${flag}" "CXX_SUPPORTS_${name}") if (C_SUPPORTS_${name}) target_compile_options(LIB_LIEF PRIVATE ${flag}) endif() if (CXX_SUPPORTS_${name}) target_compile_options(LIB_LIEF PRIVATE ${flag}) endif() endmacro() if (MSVC) add_definitions(-DNOMINMAX) endif() if(CMAKE_COMPILER_IS_GNUCXX OR CMAKE_CXX_COMPILER_ID MATCHES "Clang") if (UNIX) if (LIEF_FORCE32) target_compile_options(LIB_LIEF PRIVATE -m32) set_property(TARGET LIB_LIEF PROPERTY LINK_FLAGS -m32) endif() endif() endif() if (NOT MSVC) ADD_FLAG_IF_SUPPORTED("-Wall" WALL) ADD_FLAG_IF_SUPPORTED("-Wextra" WEXTRA) ADD_FLAG_IF_SUPPORTED("-Wpedantic" WPEDANTIC) ADD_FLAG_IF_SUPPORTED("-fomit-frame-pointer" OMIT_FRAME_POINTER) ADD_FLAG_IF_SUPPORTED("-Wno-expansion-to-defined" NO_EXPANSION_TO_DEFINED) # Promote this warning into an error as Leaf error management # where the result is 'result' might miss the "return {}" ADD_FLAG_IF_SUPPORTED("-Werror=return-type" ERR_RET_TYPE) ADD_FLAG_IF_SUPPORTED("-fdiagnostics-color=always" DIAGNOSTICS_COLOR) ADD_FLAG_IF_SUPPORTED("-fcolor-diagnostics" COLOR_DIAGNOSTICS) endif() #ADD_FLAG_IF_SUPPORTED("-Wduplicated-cond" HAS_DUPLICATED_COND) #ADD_FLAG_IF_SUPPORTED("-Wduplicated-branches" HAS_DUPLICATED_BRANCHES) #ADD_FLAG_IF_SUPPORTED("-Wlogical-op" HAS_LOGICAL_OP) #ADD_FLAG_IF_SUPPORTED("-Wshadow" HAS_SHADOW) # ========================================= # MSVC FLAGS # This part is inspired from LLVM: # https://github.com/llvm-mirror/llvm/blob/a86576d8771c89502d239f0b85a1a6992020aa47/cmake/modules/HandleLLVMOptions.cmake # ========================================= set(msvc_warning_flags # Disabled warnings. -wd4141 # Suppress ''modifier' : used more than once' (because of __forceinline combined with inline) -wd4146 # Suppress 'unary minus operator applied to unsigned type, result still unsigned' -wd4180 # Suppress 'qualifier applied to function type has no meaning; ignored' -wd4244 # Suppress ''argument' : conversion from 'type1' to 'type2', possible loss of data' -wd4258 # Suppress ''var' : definition from the for loop is ignored; the definition from the enclosing scope is used' -wd4267 # Suppress ''var' : conversion from 'size_t' to 'type', possible loss of data' -wd4291 # Suppress ''declaration' : no matching operator delete found; memory will not be freed if initialization throws an exception' -wd4345 # Suppress 'behavior change: an object of POD type constructed with an initializer of the form () will be default-initialized' -wd4351 # Suppress 'new behavior: elements of array 'array' will be default initialized' -wd4355 # Suppress ''this' : used in base member initializer list' -wd4456 # Suppress 'declaration of 'var' hides local variable' -wd4457 # Suppress 'declaration of 'var' hides function parameter' -wd4458 # Suppress 'declaration of 'var' hides class member' -wd4459 # Suppress 'declaration of 'var' hides global declaration' -wd4503 # Suppress ''identifier' : decorated name length exceeded, name was truncated' -wd4624 # Suppress ''derived class' : destructor could not be generated because a base class destructor is inaccessible' -wd4722 # Suppress 'function' : destructor never returns, potential memory leak -wd4800 # Suppress ''type' : forcing value to bool 'true' or 'false' (performance warning)' -wd4100 # Suppress 'unreferenced formal parameter' -wd4127 # Suppress 'conditional expression is constant' -wd4512 # Suppress 'assignment operator could not be generated' -wd4505 # Suppress 'unreferenced local function has been removed' -wd4610 # Suppress ' can never be instantiated' -wd4510 # Suppress 'default constructor could not be generated' -wd4702 # Suppress 'unreachable code' -wd4245 # Suppress 'signed/unsigned mismatch' -wd4706 # Suppress 'assignment within conditional expression' -wd4310 # Suppress 'cast truncates constant value' -wd4701 # Suppress 'potentially uninitialized local variable' -wd4703 # Suppress 'potentially uninitialized local pointer variable' -wd4389 # Suppress 'signed/unsigned mismatch' -wd4611 # Suppress 'interaction between '_setjmp' and C++ object destruction is non-portable' -wd4805 # Suppress 'unsafe mix of type and type in operation' -wd4204 # Suppress 'nonstandard extension used : non-constant aggregate initializer' -wd4577 # Suppress 'noexcept used with no exception handling mode specified; termination on exception is not guaranteed' -wd4091 # Suppress 'typedef: ignored on left of '' when no variable is declared' # C4592 is disabled because of false positives in Visual Studio 2015 # Update 1. Re-evaluate the usefulness of this diagnostic with Update 2. -wd4592 # Suppress ''var': symbol will be dynamically initialized (implementation limitation) -wd4319 # Suppress ''operator' : zero extending 'type' to 'type' of greater size' -wd4710 # Suppress 'function not inlined' -wd4820 # Suppress 'XXX bytes padding added after data member' -wd4514 # Suppress 'unreferenced inline function has been removed' # Ideally, we'd like this warning to be enabled, but MSVC 2013 doesn't # support the 'aligned' attribute in the way that clang sources requires (for # any code that uses the LLVM_ALIGNAS macro), so this is must be disabled to # avoid unwanted alignment warnings. # When we switch to requiring a version of MSVC that supports the 'alignas' # specifier (MSVC 2015?) this warning can be re-enabled. -wd4324 # Suppress 'structure was padded due to __declspec(align())' # Promoted warnings. -w14062 # Promote 'enumerator in switch of enum is not handled' to level 1 warning. # Promoted warnings to errors. -we4238 # Promote 'nonstandard extension used : class rvalue used as lvalue' to error. ) if (MSVC) set(msvc_warning_flags "/W4 ${msvc_warning_flags}") string(REGEX REPLACE " /W[0-4]" "" CMAKE_C_FLAGS "${CMAKE_C_FLAGS}") string(REGEX REPLACE " /W[0-4]" "" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}") #foreach(flag ${msvc_warning_flags}) # target_compile_options(LIB_LIEF PRIVATE ${flag}) #endforeach(flag) endif() # Speed up MSVC build if (MSVC_IDE) set(LIEF_COMPILER_JOBS "0" CACHE STRING "Number of parallel compiler jobs. 0 means use all processors. Default is 0.") if (NOT LIEF_COMPILER_JOBS STREQUAL "1") if(LIEF_COMPILER_JOBS STREQUAL "0") message(STATUS "Number of parallel compiler jobs set to /MP") add_definitions(/MP) else() message(STATUS "Number of parallel compiler jobs set to /MP${LIEF_COMPILER_JOBS}") add_definitions(/MP${LIEF_COMPILER_JOBS}) endif() else() message(STATUS "Parallel compilation disabled") endif() endif() LIEF-0.13.1/cmake/LIEFConfig.cmake.in000066400000000000000000000134401443457337100166640ustar00rootroot00000000000000#.rst: # LIEFConfig # -------- # # Populate the native LIEF targets. # # IMPORTED Targets # ^^^^^^^^^^^^^^^^ # # This module defines :prop_tgt:`IMPORTED` target ``LIEF::LIEF`` # # Hints # ^^^^^ # # A user may set ``LIEF_DIR`` to the directory where ``LIEFConfig.cmake`` file # resides to tell CMake where to find this file. # # To choose between STATIC and SHARED version of LIEF library, one can use # ``COMPONENTS STATIC`` of ``COMPONENTS SHARED``. If no components are # specified, then a user may set ``LIEF_SHARED_LIBS`` to a true value to # request shared libraries. By default, if no variables or components are set, # the static library is preferred if present, else shared library will be used. # # .. code-block:: cmake # # find_package(LIEF 0.11.0 REQUIRED COMPONENTS STATIC) # CMake component support for static and shared libraries based on # https://alexreinking.com/blog/building-a-dual-shared-and-static-library-with-cmake.html # Process known components set(LIEF_known_comps STATIC SHARED) set(LIEF_comp_STATIC NO) set(LIEF_comp_SHARED NO) foreach(_comp ${LIEF_FIND_COMPONENTS}) if(";${LIEF_known_comps};" MATCHES ";${_comp};") set(LIEF_comp_${_comp} YES) else() set(LIEF_NOT_FOUND_MESSAGE "LIEF does not recognize component `${_comp}`.") set(LIEF_FOUND FALSE) return() endif() endforeach() # Validate component selection makes sense if(LIEF_comp_STATIC AND LIEF_comp_SHARED) set(LIEF_NOT_FOUND_MESSAGE "LIEF `STATIC` and `SHARED` components are mutually exclusive.") set(LIEF_FOUND FALSE) return() endif() # These files are generated by CMake and hold the LIEF library target(s). set(LIEF_static_export "${CMAKE_CURRENT_LIST_DIR}/LIEFExport-static.cmake") set(LIEF_shared_export "${CMAKE_CURRENT_LIST_DIR}/LIEFExport-shared.cmake") # Helper macro to load the requested targets, where `lib_type` is `static` or # `shared` macro(LIEF_load_targets lib_type) if(NOT EXISTS "${LIEF_${lib_type}_export}") set(LIEF_NOT_FOUND_MESSAGE "LIEF `${lib_type}` libraries were requested but not found.") set(LIEF_FOUND FALSE) return() endif () if("${lib_type}" STREQUAL "static") # Need to find all dependencies even if they're private when LIEF is # compiled statically include(CMakeFindDependencyMacro) if(@LIEF_EXTERNAL_MBEDTLS@) find_dependency(MbedTLS) endif() if(@LIEF_EXTERNAL_UTF8CPP@) find_dependency(utf8cpp) endif() if(@LIEF_EXTERNAL_SPDLOG@) find_dependency(spdlog) endif() if(@LIEF_ENABLE_JSON@ AND @LIEF_NLOHMANN_JSON_EXTERNAL@) find_dependency(nlohmann_json) endif() if(NOT @LIEF_DISABLE_FROZEN@ AND @LIEF_OPT_FROZEN_EXTERNAL@) find_dependency(frozen) endif() endif() # Include the respective targets file include("${LIEF_${lib_type}_export}") endmacro() # Run the logic to choose static or shared libraries # 1. Check components if(LIEF_comp_STATIC) LIEF_load_targets("static") elseif(LIEF_comp_SHARED) LIEF_load_targets("shared") # 2. Check LIEF-only library selection elseif(DEFINED LIEF_SHARED_LIBS AND LIEF_SHARED_LIBS) LIEF_load_targets("shared") elseif(DEFINED LIEF_SHARED_LIBS AND NOT LIEF_SHARED_LIBS) LIEF_load_targets("static") # 3. Check CMake build type and choose what's available elseif(BUILD_SHARED_LIBS) if(EXISTS "${LIEF_shared_export}") LIEF_load_targets("shared") else() LIEF_load_targets("static") endif() else() if(EXISTS "${LIEF_static_export}") LIEF_load_targets("static") else() LIEF_load_targets("shared") endif() endif() # Attach location of public interface libraries that don't have # their own CMake config that would otherwise be found using `find_dependency` # Header-only library can be found relatively easily if(@LIEF_EXTERNAL_LEAF@) find_path(BOOST_LEAF_INCLUDE_DIR boost/leaf.hpp) if(NOT BOOST_LEAF_INCLUDE_DIR) set(LIEF_NOT_FOUND_MESSAGE "Could not find include directory with 'boost/leaf.hpp'. Consider setting `BOOST_LEAF_INCLUDE_DIR` during CMake configuration") set(LIEF_FOUND FALSE) return() endif() set_property(TARGET LIEF::LIEF APPEND PROPERTY INTERFACE_SYSTEM_INCLUDE_DIRECTORIES "${BOOST_LEAF_INCLUDE_DIR}" ) endif() # Header-only library can be found relatively easily if(@LIEF_EXTERNAL_SPAN@) find_path(TCB_SPAN_INCLUDE_DIR tcb/span.hpp) if(NOT TCB_SPAN_INCLUDE_DIR) set(LIEF_NOT_FOUND_MESSAGE "Could not find include directory with 'tcb/span.hpp'. Consider setting `TCB_SPAN_INCLUDE_DIR` during CMake configuration") set(LIEF_FOUND FALSE) return() endif() set_property(TARGET LIEF::LIEF APPEND PROPERTY INTERFACE_SYSTEM_INCLUDE_DIRECTORIES "${TCB_SPAN_INCLUDE_DIR}" ) endif() # Set this for backwards compatibility. This isn't quite the path to the # actual library file, but using the target is strictly better because it # includes all other information needed to correctly link and use LIEF set(LIEF_LIBRARIES LIEF::LIEF) # Set this for backwards compatibility get_target_property(LIEF_INCLUDE_DIRS LIEF::LIEF INTERFACE_INCLUDE_DIRECTORIES) # Set the following for backwards compatibility if(DEFINED LIEF_INCLUDE_DIR) if(EXISTS "${LIEF_INCLUDE_DIR}/LIEF/version.h") file(STRINGS "${LIEF_INCLUDE_DIR}/LIEF/version.h" LIEF_H REGEX "^#define LIEF_VERSION \"[^\"]*\"$") string(REGEX REPLACE "^.*LIEF_VERSION \"([0-9]+).*$" "\\1" LIEF_VERSION_MAJOR "${LIEF_H}") string(REGEX REPLACE "^.*LIEF_VERSION \"[0-9]+\\.([0-9]+).*$" "\\1" LIEF_VERSION_MINOR "${LIEF_H}") string(REGEX REPLACE "^.*LIEF_VERSION \"[0-9]+\\.[0-9]+\\.([0-9]+).*$" "\\1" LIEF_VERSION_PATCH "${LIEF_H}") set(LIEF_VERSION_STRING "${LIEF_VERSION_MAJOR}.${LIEF_VERSION_MINOR}.${LIEF_VERSION_PATCH}") set(LIEF_MAJOR_VERSION "${LIEF_VERSION_MAJOR}") set(LIEF_MINOR_VERSION "${LIEF_VERSION_MINOR}") set(LIEF_PATCH_VERSION "${LIEF_VERSION_PATCH}") endif() endif() LIEF-0.13.1/cmake/LIEFDependencies.cmake000066400000000000000000000237021443457337100174420ustar00rootroot00000000000000if(__add_lief_dependencies) return() endif() set(__add_lief_dependencies ON) # Json # ---- if(LIEF_ENABLE_JSON) if(NOT LIEF_OPT_NLOHMANN_JSON_EXTERNAL) set(LIBJSON_VERSION 3.11.2) set(LIBJSON_SHA256 SHA256=62b1d12b8c7e4afcf96827d05426ca6d9184b9eefdfac512dd533726b98ad8f7) set(LIBJSON_URL "${THIRD_PARTY_DIRECTORY}/json-${LIBJSON_VERSION}.zip" CACHE STRING "URL to the JSON lib repo") ExternalProject_Add(lief_libjson URL ${LIBJSON_URL} URL_HASH ${LIBJSON_SHA256} UPDATE_COMMAND "" CONFIGURE_COMMAND "" BUILD_COMMAND "" INSTALL_COMMAND "") ExternalProject_get_property(lief_libjson SOURCE_DIR) set(LIBJSON_SOURCE_DIR "${SOURCE_DIR}") endif() message(STATUS "Enable JSON support") set(ENABLE_JSON_SUPPORT 1) else() message(STATUS "Disable JSON support") set(ENABLE_JSON_SUPPORT 0) endif() # mbed TLS # -------- if(NOT LIEF_OPT_MBEDTLS_EXTERNAL) set(MBED_TLS_VERSION 3.2.1) set(MBED_TLS_SHA256 SHA256=efeac7fb687d19a7c7dc60f5e60265edd528244856cf3db2e2aecacece08b23f) set(MBED_TLS_URL "${THIRD_PARTY_DIRECTORY}/mbedtls-${MBED_TLS_VERSION}.zip" CACHE STRING "URL to MbedTLS") set(MBED_TLS_PREFIX "${CMAKE_CURRENT_BINARY_DIR}/mbed_tls") ExternalProject_Add(lief_mbed_tls PREFIX ${MBED_TLS_PREFIX} CONFIGURE_COMMAND "" BUILD_COMMAND "" INSTALL_COMMAND "" URL ${MBED_TLS_URL} URL_HASH ${MBED_TLS_SHA256} UPDATE_COMMAND "" # repetitive update are a pain BUILD_BYPRODUCTS ${MBED_TLS_PREFIX}) ExternalProject_get_property(lief_mbed_tls SOURCE_DIR) set(MBEDTLS_SOURCE_DIR "${SOURCE_DIR}") set(MBEDTLS_INCLUDE_DIRS "${MBEDTLS_SOURCE_DIR}/include") set(mbedtls_src_crypto "${MBEDTLS_SOURCE_DIR}/library/aes.c" "${MBEDTLS_SOURCE_DIR}/library/aesni.c" "${MBEDTLS_SOURCE_DIR}/library/aria.c" "${MBEDTLS_SOURCE_DIR}/library/asn1parse.c" "${MBEDTLS_SOURCE_DIR}/library/asn1write.c" "${MBEDTLS_SOURCE_DIR}/library/base64.c" "${MBEDTLS_SOURCE_DIR}/library/bignum.c" "${MBEDTLS_SOURCE_DIR}/library/camellia.c" "${MBEDTLS_SOURCE_DIR}/library/ccm.c" "${MBEDTLS_SOURCE_DIR}/library/chacha20.c" "${MBEDTLS_SOURCE_DIR}/library/chachapoly.c" "${MBEDTLS_SOURCE_DIR}/library/cipher.c" "${MBEDTLS_SOURCE_DIR}/library/cipher_wrap.c" "${MBEDTLS_SOURCE_DIR}/library/constant_time.c" "${MBEDTLS_SOURCE_DIR}/library/cmac.c" "${MBEDTLS_SOURCE_DIR}/library/ctr_drbg.c" "${MBEDTLS_SOURCE_DIR}/library/des.c" "${MBEDTLS_SOURCE_DIR}/library/dhm.c" "${MBEDTLS_SOURCE_DIR}/library/ecdh.c" "${MBEDTLS_SOURCE_DIR}/library/ecdsa.c" "${MBEDTLS_SOURCE_DIR}/library/ecjpake.c" "${MBEDTLS_SOURCE_DIR}/library/ecp.c" "${MBEDTLS_SOURCE_DIR}/library/ecp_curves.c" "${MBEDTLS_SOURCE_DIR}/library/entropy.c" "${MBEDTLS_SOURCE_DIR}/library/entropy_poll.c" "${MBEDTLS_SOURCE_DIR}/library/error.c" "${MBEDTLS_SOURCE_DIR}/library/gcm.c" "${MBEDTLS_SOURCE_DIR}/library/hkdf.c" "${MBEDTLS_SOURCE_DIR}/library/hmac_drbg.c" "${MBEDTLS_SOURCE_DIR}/library/md.c" "${MBEDTLS_SOURCE_DIR}/library/md5.c" "${MBEDTLS_SOURCE_DIR}/library/memory_buffer_alloc.c" "${MBEDTLS_SOURCE_DIR}/library/mps_reader.c" "${MBEDTLS_SOURCE_DIR}/library/mps_trace.c" "${MBEDTLS_SOURCE_DIR}/library/nist_kw.c" "${MBEDTLS_SOURCE_DIR}/library/oid.c" "${MBEDTLS_SOURCE_DIR}/library/padlock.c" "${MBEDTLS_SOURCE_DIR}/library/pem.c" "${MBEDTLS_SOURCE_DIR}/library/pk.c" "${MBEDTLS_SOURCE_DIR}/library/pk_wrap.c" "${MBEDTLS_SOURCE_DIR}/library/pkcs12.c" "${MBEDTLS_SOURCE_DIR}/library/pkcs5.c" "${MBEDTLS_SOURCE_DIR}/library/pkparse.c" "${MBEDTLS_SOURCE_DIR}/library/pkwrite.c" "${MBEDTLS_SOURCE_DIR}/library/platform.c" "${MBEDTLS_SOURCE_DIR}/library/platform_util.c" "${MBEDTLS_SOURCE_DIR}/library/poly1305.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_aead.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_cipher.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_client.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_driver_wrappers.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_ecp.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_hash.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_mac.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_rsa.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_se.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_slot_management.c" "${MBEDTLS_SOURCE_DIR}/library/psa_crypto_storage.c" "${MBEDTLS_SOURCE_DIR}/library/psa_its_file.c" "${MBEDTLS_SOURCE_DIR}/library/ripemd160.c" "${MBEDTLS_SOURCE_DIR}/library/rsa.c" "${MBEDTLS_SOURCE_DIR}/library/rsa_alt_helpers.c" "${MBEDTLS_SOURCE_DIR}/library/sha1.c" "${MBEDTLS_SOURCE_DIR}/library/sha256.c" "${MBEDTLS_SOURCE_DIR}/library/sha512.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_debug_helpers_generated.c" "${MBEDTLS_SOURCE_DIR}/library/threading.c" "${MBEDTLS_SOURCE_DIR}/library/timing.c" "${MBEDTLS_SOURCE_DIR}/library/version.c" "${MBEDTLS_SOURCE_DIR}/library/version_features.c" ) set(mbedtls_src_x509 #"${MBEDTLS_SOURCE_DIR}/library/certs.c" #"${MBEDTLS_SOURCE_DIR}/library/pkcs11.c" "${MBEDTLS_SOURCE_DIR}/library/x509.c" "${MBEDTLS_SOURCE_DIR}/library/x509_create.c" "${MBEDTLS_SOURCE_DIR}/library/x509_crl.c" "${MBEDTLS_SOURCE_DIR}/library/x509_crt.c" "${MBEDTLS_SOURCE_DIR}/library/x509_csr.c" "${MBEDTLS_SOURCE_DIR}/library/x509write_crt.c" "${MBEDTLS_SOURCE_DIR}/library/x509write_csr.c" ) set(mbedtls_src_tls "${MBEDTLS_SOURCE_DIR}/library/debug.c" "${MBEDTLS_SOURCE_DIR}/library/net_sockets.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_cache.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_ciphersuites.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_client.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_cookie.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_msg.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_ticket.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_tls.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_tls12_client.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_tls12_server.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_tls13_keys.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_tls13_server.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_tls13_client.c" "${MBEDTLS_SOURCE_DIR}/library/ssl_tls13_generic.c" ) endif() add_library(lief_spdlog INTERFACE) if(LIEF_EXTERNAL_SPDLOG) find_package(spdlog REQUIRED) list(APPEND CMAKE_MODULE_PATH "${SPDLOG_DIR}/cmake") target_link_libraries(lief_spdlog INTERFACE spdlog::spdlog) get_target_property(SPDLOG_INC_DIR spdlog::spdlog INTERFACE_INCLUDE_DIRECTORIES) target_include_directories(lief_spdlog SYSTEM INTERFACE ${SPDLOG_INC_DIR}) else() set(SPDLOG_VERSION 1.11.0) set(SPDLOG_SHA256 SHA256=33f83c6b86ec0fbbd0eb0f4e980da6767494dc0ad063900bcfae8bc3e9c75f21) set(SPDLOG_URL "${THIRD_PARTY_DIRECTORY}/spdlog-${SPDLOG_VERSION}.zip" CACHE STRING "URL to the spdlog source") ExternalProject_Add(lief_spdlog_project URL ${SPDLOG_URL} URL_HASH ${SPDLOG_SHA256} CONFIGURE_COMMAND "" BUILD_COMMAND "" UPDATE_COMMAND "" INSTALL_COMMAND "") ExternalProject_get_property(lief_spdlog_project SOURCE_DIR) set(SPDLOG_SOURCE_DIR "${SOURCE_DIR}") add_dependencies(lief_spdlog lief_spdlog_project) target_include_directories(lief_spdlog SYSTEM INTERFACE "$") endif() # Frozen # ------ set(LIEF_FROZEN_ENABLED 0) if (LIEF_SUPPORT_CXX14 AND NOT LIEF_DISABLE_FROZEN) message(STATUS "Enable Frozen (C++14 support)") set(LIEF_FROZEN_ENABLED 1) if (NOT LIEF_OPT_FROZEN_EXTERNAL) set(FROZEN_VERSION f6dbec6) set(FROZEN_SHA256 SHA256=f961ec0f403d7720da12ec25a39790211d0bcecc342177838f3dd1fa6adb8ac3) set(FROZEN_URL "${THIRD_PARTY_DIRECTORY}/frozen-${FROZEN_VERSION}.zip" CACHE STRING "URL to Frozen") ExternalProject_Add(lief_frozen URL ${FROZEN_URL} URL_HASH ${FROZEN_SHA256} CONFIGURE_COMMAND "" BUILD_COMMAND "" UPDATE_COMMAND "" INSTALL_COMMAND "") ExternalProject_get_property(lief_frozen SOURCE_DIR) set(FROZEN_INCLUDE_DIR "${SOURCE_DIR}/include") endif() endif() # Boost leaf # ---------- if(NOT LIEF_EXTERNAL_LEAF) set(LEAF_VERSION 1.81.0) set(LEAF_SHA256 SHA256=7974ad4d440114e1affd40067166a319cb5ea7309e03bf6622f20bc012ec46fc) set(LEAF_URL "${THIRD_PARTY_DIRECTORY}/leaf-${LEAF_VERSION}.zip" CACHE STRING "URL to Leaf") ExternalProject_Add(lief_leaf # :) URL ${LEAF_URL} URL_HASH ${LEAF_SHA256} CONFIGURE_COMMAND "" BUILD_COMMAND "" UPDATE_COMMAND "" INSTALL_COMMAND "") ExternalProject_get_property(lief_leaf SOURCE_DIR) set(LEAF_SRC_DIR "${SOURCE_DIR}") endif() # utfcpp # ------ if(NOT LIEF_OPT_UTFCPP_EXTERNAL) set(UTFCPP_VERSION 3.2.1) set(UTFCPP_SHA256 SHA256=04dacc4717d1ef9741f8254d1c56faf57a514684923ec35b2b98378ef016b87a) set(UTFCPP_URL "${THIRD_PARTY_DIRECTORY}/utfcpp-${UTFCPP_VERSION}.zip" CACHE STRING "URL to UTFCPP") ExternalProject_Add(lief_utfcpp URL ${UTFCPP_URL} URL_HASH ${UTFCPP_SHA256} CONFIGURE_COMMAND "" BUILD_COMMAND "" UPDATE_COMMAND "" INSTALL_COMMAND "") ExternalProject_get_property(lief_utfcpp SOURCE_DIR) set(UTFCPP_INCLUDE_DIR "${SOURCE_DIR}/source") endif() # https://github.com/tcbrindle/span # --------------------------------- if(NOT LIEF_EXTERNAL_SPAN) set(TCB_SPAN_VERSION d6c6e30) set(TCB_SPAN_SHA256 SHA256=c31fed99ea01526af28f26bb9b77a86d21e8964748708d57cf55a8813e883fe3) set(TCB_SPAN_URL "${THIRD_PARTY_DIRECTORY}/tcb-span-${TCB_SPAN_VERSION}.zip" CACHE STRING "URL to tcb/span") ExternalProject_Add(lief_span URL ${TCB_SPAN_URL} URL_HASH ${TCB_SPAN_SHA256} CONFIGURE_COMMAND "" BUILD_COMMAND "" UPDATE_COMMAND "" INSTALL_COMMAND "") ExternalProject_get_property(lief_span SOURCE_DIR) set(TCB_SPAN_SRC_DIR "${SOURCE_DIR}") endif() LIEF-0.13.1/cmake/LIEFGit.cmake000066400000000000000000000037641443457337100156050ustar00rootroot00000000000000if(__add_lief_git) return() endif() set(__add_lief_git ON) execute_process( COMMAND ${GIT_EXECUTABLE} log -1 --format=%h WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} OUTPUT_VARIABLE LIEF_COMMIT_HASH OUTPUT_STRIP_TRAILING_WHITESPACE ) execute_process( COMMAND ${GIT_EXECUTABLE} rev-list --count ${LIEF_COMMIT_HASH} WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} OUTPUT_VARIABLE LIEF_COMMIT_COUNT OUTPUT_STRIP_TRAILING_WHITESPACE ) execute_process( COMMAND ${GIT_EXECUTABLE} describe --abbrev=0 --tags HEAD --always WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} OUTPUT_VARIABLE LIEF_GIT_TAG OUTPUT_STRIP_TRAILING_WHITESPACE ) execute_process( COMMAND ${GIT_EXECUTABLE} tag --list --points-at=HEAD WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} OUTPUT_VARIABLE LIEF_GIT_COMMIT_TAGGED OUTPUT_STRIP_TRAILING_WHITESPACE ) execute_process( COMMAND ${GIT_EXECUTABLE} rev-parse --abbrev-ref HEAD WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} OUTPUT_VARIABLE LIEF_GIT_BRANCH OUTPUT_STRIP_TRAILING_WHITESPACE ) string(COMPARE NOTEQUAL "${LIEF_GIT_COMMIT_TAGGED}" "" LIEF_IS_TAGGED) string(REGEX MATCHALL "([0-9]+)" VERSION_STRING "${LIEF_GIT_TAG}") message(STATUS "Tagged: ${LIEF_IS_TAGGED}") if (${LIEF_IS_TAGGED}) message(STATUS "Tag: ${LIEF_GIT_TAG}") else() if(LIEF_GIT_BRANCH MATCHES "^release-") string(REGEX MATCHALL "([0-9]+)" VERSION_STRING "${LIEF_GIT_BRANCH}") message(STATUS "${VERSION_STRING}") endif() endif() message(STATUS "Current branch: ${LIEF_GIT_BRANCH}") if (VERSION_STRING) list(GET VERSION_STRING 0 LIEF_VERSION_MAJOR) list(GET VERSION_STRING 1 LIEF_VERSION_MINOR) list(GET VERSION_STRING 2 LIEF_VERSION_PATCH) if (NOT ${LIEF_IS_TAGGED}) if(LIEF_GIT_BRANCH MATCHES "^release-") message(STATUS "Release branch") else() MATH(EXPR LIEF_VERSION_MINOR "${LIEF_VERSION_MINOR}+1") set(LIEF_VERSION_PATCH 0) endif() endif() else() set(LIEF_VERSION_MAJOR 0) set(LIEF_VERSION_MINOR 0) set(LIEF_VERSION_PATCH 0) endif() LIEF-0.13.1/cmake/LIEFOptions.cmake000066400000000000000000000125461443457337100165130ustar00rootroot00000000000000if(__add_lief_options) return() endif() set(__add_lief_options ON) include(CMakeDependentOption) option(LIEF_TESTS "Enable tests" OFF) option(LIEF_DOC "Enable documentation" OFF) option(LIEF_PYTHON_API "Enable Python Bindings" OFF) option(LIEF_C_API "C API" ON) option(LIEF_EXAMPLES "Build LIEF C++ examples" ON) option(LIEF_FORCE32 "Force build LIEF 32 bits version" OFF) option(LIEF_COVERAGE "Perform code coverage" OFF) option(LIEF_USE_CCACHE "Use ccache to speed up compilation" ON) option(LIEF_EXTRA_WARNINGS "Enable extra warning from the compiler" OFF) option(LIEF_LOGGING "Enable logging" ON) option(LIEF_LOGGING_DEBUG "Enable debug logging" ON) option(LIEF_ENABLE_JSON "Enable JSON-related APIs" ON) option(LIEF_OPT_NLOHMANN_JSON_EXTERNAL "Use nlohmann/json externaly" OFF) option(LIEF_FORCE_API_EXPORTS "Force exports of API symbols" OFF) option(LIEF_DISABLE_FROZEN "Disable Frozen even if it is supported" OFF) option(LIEF_ELF "Build LIEF with ELF module" ON) option(LIEF_PE "Build LIEF with PE module" ON) option(LIEF_MACHO "Build LIEF with MachO module" ON) option(LIEF_DEX "Build LIEF with DEX module" ON) option(LIEF_ART "Build LIEF with ART module" ON) # OAT support relies on the ELF and DEX format. # Therefore, these options must be enabled to support use this format cmake_dependent_option(LIEF_OAT "Build LIEF with OAT module" ON "LIEF_ELF;LIEF_DEX" OFF) # VDEX format depends on the DEX module cmake_dependent_option(LIEF_VDEX "Build LIEF with VDEX module" ON "LIEF_DEX" OFF) # Sanitizer option(LIEF_ASAN "Enable Address sanitizer" OFF) option(LIEF_LSAN "Enable Leak sanitizer" OFF) option(LIEF_TSAN "Enable Thread sanitizer" OFF) option(LIEF_USAN "Enable undefined sanitizer" OFF) # Fuzzer option(LIEF_FUZZING "Fuzz LIEF" OFF) # Profiling option(LIEF_PROFILING "Enable performance profiling" OFF) # Install options cmake_dependent_option(LIEF_INSTALL_COMPILED_EXAMPLES "Install LIEF Compiled examples" OFF "LIEF_EXAMPLES" OFF) # Use a user-provided version of spdlog # It can be useful to reduce compile time option(LIEF_EXTERNAL_SPDLOG OFF) # This option enables to provide an external # version of Boost Leaf (e.g. present on the system) option(LIEF_OPT_EXTERNAL_LEAF OFF) set(LIEF_EXTERNAL_LEAF_DIR ) # This option enables to provide an external version of utf8cpp option(LIEF_OPT_UTFCPP_EXTERNAL OFF) # This option enables to provide an external version of MbedTLS option(LIEF_OPT_MBEDTLS_EXTERNAL OFF) # This option enables to provide an external version of pybind11 option(LIEF_OPT_PYBIND11_EXTERNAL OFF) # This option enables to provide an external # version of https://github.com/tcbrindle/span (e.g. present on the system) option(LIEF_OPT_EXTERNAL_SPAN OFF) set(LIEF_EXTERNAL_SPAN_DIR ) # This option enables to provide an external version of Frozen set(_LIEF_USE_FROZEN ON) if(LIEF_DISABLE_FROZEN) set(_LIEF_USE_FROZEN OFF) endif() cmake_dependent_option(LIEF_OPT_FROZEN_EXTERNAL "Use an external provided version of Frozen" OFF "_LIEF_USE_FROZEN" OFF) # This option enables the install target in the cmake option(LIEF_INSTALL "Generate the install target." ON) set(LIEF_ELF_SUPPORT 0) set(LIEF_PE_SUPPORT 0) set(LIEF_MACHO_SUPPORT 0) set(LIEF_OAT_SUPPORT 0) set(LIEF_DEX_SUPPORT 0) set(LIEF_VDEX_SUPPORT 0) set(LIEF_ART_SUPPORT 0) set(LIEF_JSON_SUPPORT 0) set(LIEF_NLOHMANN_JSON_EXTERNAL 0) set(LIEF_LOGGING_SUPPORT 0) set(LIEF_LOGGING_DEBUG_SUPPORT 0) set(LIEF_FROZEN_ENABLED 0) set(LIEF_EXTERNAL_FROZEN 0) set(LIEF_EXTERNAL_LEAF 0) set(LIEF_EXTERNAL_UTF8CPP 0) set(LIEF_EXTERNAL_MBEDTLS 0) set(LIEF_EXTERNAL_SPAN 0) if(LIEF_ELF) set(LIEF_ELF_SUPPORT 1) endif() if(LIEF_PE) set(LIEF_PE_SUPPORT 1) endif() if(LIEF_MACHO) set(LIEF_MACHO_SUPPORT 1) endif() if(LIEF_OAT) set(LIEF_OAT_SUPPORT 1) endif() if(LIEF_DEX) set(LIEF_DEX_SUPPORT 1) endif() if(LIEF_VDEX) set(LIEF_VDEX_SUPPORT 1) endif() if(LIEF_ART) set(LIEF_ART_SUPPORT 1) endif() if(LIEF_ENABLE_JSON) set(LIEF_JSON_SUPPORT 1) if(LIEF_OPT_NLOHMANN_JSON_EXTERNAL) set(LIEF_NLOHMANN_JSON_EXTERNAL 1) endif() endif() if(LIEF_LOGGING) set(LIEF_LOGGING_SUPPORT 1) if(LIEF_LOGGING_DEBUG) set(LIEF_LOGGING_DEBUG_SUPPORT 1) else() set(LIEF_LOGGING_DEBUG_SUPPORT 0) endif() endif() if(NOT LIEF_DISABLE_FROZEN) set(LIEF_FROZEN_ENABLED 1) if(LIEF_OPT_FROZEN_EXTERNAL) set(LIEF_EXTERNAL_FROZEN 1) endif() endif() if(LIEF_OPT_EXTERNAL_LEAF) set(LIEF_EXTERNAL_LEAF 1) endif() if(LIEF_OPT_UTFCPP_EXTERNAL) set(LIEF_EXTERNAL_UTF8CPP 1) endif() if(LIEF_OPT_MBEDTLS_EXTERNAL) set(LIEF_EXTERNAL_MBEDTLS 1) endif() if(LIEF_OPT_EXTERNAL_SPAN) set(LIEF_EXTERNAL_SPAN 1) endif() if(LIEF_PYTHON_API) if(LIEF_OPT_PYBIND11_EXTERNAL) set(LIEF_EXTERNAL_PYBIND11 1) endif() endif() LIEF-0.13.1/cmake/cpack.config.cmake000066400000000000000000000002501443457337100167320ustar00rootroot00000000000000include("static-release/CPackConfig.cmake") set(CPACK_INSTALL_CMAKE_PROJECTS ${CPACK_INSTALL_CMAKE_PROJECTS} shared-release LIEF ALL / static-release LIEF ALL / ) LIEF-0.13.1/cmake/ios.toolchain.cmake000066400000000000000000000771331443457337100171740ustar00rootroot00000000000000# This file is part of the ios-cmake project. It was retrieved from # https://github.com/gerstrong/ios-cmake.git which is a fork of # https://github.com/cristeab/ios-cmake.git, which again is a fork of # https://code.google.com/p/ios-cmake/. Which in turn is based off of # the Platform/Darwin.cmake and Platform/UnixPaths.cmake files which # are included with CMake 2.8.4 # # The ios-cmake project is licensed under the new BSD license. # # Copyright (c) 2014, Bogdan Cristea and LTE Engineering Software, # Kitware, Inc., Insight Software Consortium. All rights reserved. # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # # 3. Neither the name of the copyright holder nor the names of its # contributors may be used to endorse or promote products derived from # this software without specific prior written permission. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE # COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, # INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, # BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER # CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN # ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # # This file is based off of the Platform/Darwin.cmake and # Platform/UnixPaths.cmake files which are included with CMake 2.8.4 # It has been altered for iOS development. # # Updated by Alex Stewart (alexs.mac@gmail.com) # # ***************************************************************************** # Now maintained by Alexander Widerberg (widerbergaren [at] gmail.com) # under the BSD-3-Clause license # https://github.com/leetal/ios-cmake # ***************************************************************************** # # INFORMATION / HELP # # The following arguments control the behaviour of this toolchain: # # PLATFORM: (default "OS") # OS = Build for iPhoneOS. # OS64 = Build for arm64 iphoneOS. # OS64COMBINED = Build for arm64 x86_64 iphoneOS. Combined into FAT STATIC lib (supported on 3.14+ of CMakewith "-G Xcode" argument ONLY) # SIMULATOR = Build for x86 i386 iphoneOS Simulator. # SIMULATOR64 = Build for x86_64 iphoneOS Simulator. # TVOS = Build for arm64 tvOS. # TVOSCOMBINED = Build for arm64 x86_64 tvOS. Combined into FAT STATIC lib (supported on 3.14+ of CMake with "-G Xcode" argument ONLY) # SIMULATOR_TVOS = Build for x86_64 tvOS Simulator. # WATCHOS = Build for armv7k arm64_32 for watchOS. # WATCHOSCOMBINED = Build for armv7k arm64_32 x86_64 watchOS. Combined into FAT STATIC lib (supported on 3.14+ of CMake with "-G Xcode" argument ONLY) # SIMULATOR_WATCHOS = Build for x86_64 for watchOS Simulator. # # CMAKE_OSX_SYSROOT: Path to the SDK to use. By default this is # automatically determined from PLATFORM and xcodebuild, but # can also be manually specified (although this should not be required). # # CMAKE_DEVELOPER_ROOT: Path to the Developer directory for the platform # being compiled for. By default this is automatically determined from # CMAKE_OSX_SYSROOT, but can also be manually specified (although this should # not be required). # # DEPLOYMENT_TARGET: Minimum SDK version to target. Default 2.0 on watchOS and 9.0 on tvOS+iOS # # ENABLE_BITCODE: (1|0) Enables or disables bitcode support. Default 1 (true) # # ENABLE_ARC: (1|0) Enables or disables ARC support. Default 1 (true, ARC enabled by default) # # ENABLE_VISIBILITY: (1|0) Enables or disables symbol visibility support. Default 0 (false, visibility hidden by default) # # ENABLE_STRICT_TRY_COMPILE: (1|0) Enables or disables strict try_compile() on all Check* directives (will run linker # to actually check if linking is possible). Default 0 (false, will set CMAKE_TRY_COMPILE_TARGET_TYPE to STATIC_LIBRARY) # # ARCHS: (armv7 armv7s armv7k arm64 arm64_32 i386 x86_64) If specified, will override the default architectures for the given PLATFORM # OS = armv7 armv7s arm64 (if applicable) # OS64 = arm64 (if applicable) # SIMULATOR = i386 # SIMULATOR64 = x86_64 # TVOS = arm64 # SIMULATOR_TVOS = x86_64 (i386 has since long been deprecated) # WATCHOS = armv7k arm64_32 (if applicable) # SIMULATOR_WATCHOS = x86_64 (i386 has since long been deprecated) # # This toolchain defines the following variables for use externally: # # XCODE_VERSION: Version number (not including Build version) of Xcode detected. # SDK_VERSION: Version of SDK being used. # CMAKE_OSX_ARCHITECTURES: Architectures being compiled for (generated from PLATFORM). # APPLE_TARGET_TRIPLE: Used by autoconf build systems. NOTE: If "ARCHS" are overridden, this will *NOT* be set! # # This toolchain defines the following macros for use externally: # # set_xcode_property (TARGET XCODE_PROPERTY XCODE_VALUE XCODE_VARIANT) # A convenience macro for setting xcode specific properties on targets. # Available variants are: All, Release, RelWithDebInfo, Debug, MinSizeRel # example: set_xcode_property (myioslib IPHONEOS_DEPLOYMENT_TARGET "3.1" "all"). # # find_host_package (PROGRAM ARGS) # A macro used to find executable programs on the host system, not within the # environment. Thanks to the android-cmake project for providing the # command. # # ******************************** DEPRECATIONS ******************************* # # IOS_DEPLOYMENT_TARGET: (Deprecated) Alias to DEPLOYMENT_TARGET # CMAKE_IOS_DEVELOPER_ROOT: (Deprecated) Alias to CMAKE_DEVELOPER_ROOT # IOS_PLATFORM: (Deprecated) Alias to PLATFORM # IOS_ARCH: (Deprecated) Alias to ARCHS # # ***************************************************************************** # # Fix for PThread library not in path set(CMAKE_THREAD_LIBS_INIT "-lpthread") set(CMAKE_HAVE_THREADS_LIBRARY 1) set(CMAKE_USE_WIN32_THREADS_INIT 0) set(CMAKE_USE_PTHREADS_INIT 1) # Cache what generator is used set(USED_CMAKE_GENERATOR "${CMAKE_GENERATOR}" CACHE STRING "Expose CMAKE_GENERATOR" FORCE) if(${CMAKE_VERSION} VERSION_GREATER_EQUAL "3.14") set(MODERN_CMAKE YES) endif() # Get the Xcode version being used. execute_process(COMMAND xcodebuild -version OUTPUT_VARIABLE XCODE_VERSION ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) string(REGEX MATCH "Xcode [0-9\\.]+" XCODE_VERSION "${XCODE_VERSION}") string(REGEX REPLACE "Xcode ([0-9\\.]+)" "\\1" XCODE_VERSION "${XCODE_VERSION}") # Assuming that xcode 12.0 is installed you most probably have ios sdk 14.2 or later installed (tested on Big Sur) # if you don't set a deployment target it will be set the way you only get 64-bit builds if(NOT DEFINED DEPLOYMENT_TARGET AND XCODE_VERSION VERSION_GREATER 12.0) option(DROP_32_BIT "Will make drop 32-bit support universally. On later sdks you won't be able to build 32-bit apps" yes) # Temporarily fix the arm64 issues in CMake install-combined by excluding arm64 for simulator builds (needed for Apple Silicon...) set(CMAKE_XCODE_ATTRIBUTE_EXCLUDED_ARCHS[sdk=iphonesimulator*] "arm64") endif() ######## ALIASES (DEPRECATION WARNINGS) if(DEFINED IOS_PLATFORM) set(PLATFORM ${IOS_PLATFORM}) message(DEPRECATION "IOS_PLATFORM argument is DEPRECATED. Consider using the new PLATFORM argument instead.") endif() if(DEFINED IOS_DEPLOYMENT_TARGET) set(DEPLOYMENT_TARGET ${IOS_DEPLOYMENT_TARGET}) message(DEPRECATION "IOS_DEPLOYMENT_TARGET argument is DEPRECATED. Consider using the new DEPLOYMENT_TARGET argument instead.") endif() if(DEFINED CMAKE_IOS_DEVELOPER_ROOT) set(CMAKE_DEVELOPER_ROOT ${CMAKE_IOS_DEVELOPER_ROOT}) message(DEPRECATION "CMAKE_IOS_DEVELOPER_ROOT argument is DEPRECATED. Consider using the new CMAKE_DEVELOPER_ROOT argument instead.") endif() if(DEFINED IOS_ARCH) set(ARCHS ${IOS_ARCH}) message(DEPRECATION "IOS_ARCH argument is DEPRECATED. Consider using the new ARCHS argument instead.") endif() ######## END ALIASES # Unset the FORCE on cache variables if in try_compile() set(FORCE_CACHE FORCE) get_property(_CMAKE_IN_TRY_COMPILE GLOBAL PROPERTY IN_TRY_COMPILE) if(_CMAKE_IN_TRY_COMPILE) unset(FORCE_CACHE) endif() # Default to building for iPhoneOS if not specified otherwise, and we cannot # determine the platform from the CMAKE_OSX_ARCHITECTURES variable. The use # of CMAKE_OSX_ARCHITECTURES is such that try_compile() projects can correctly # determine the value of PLATFORM from the root project, as # CMAKE_OSX_ARCHITECTURES is propagated to them by CMake. if(NOT DEFINED PLATFORM) if (CMAKE_OSX_ARCHITECTURES) if(CMAKE_OSX_ARCHITECTURES MATCHES "arm64" AND CMAKE_OSX_SYSROOT MATCHES ".*iphoneos.*") set(PLATFORM "OS64") elseif(CMAKE_OSX_ARCHITECTURES MATCHES ".*arm.*" AND CMAKE_OSX_SYSROOT MATCHES ".*iphoneos.*") set(PLATFORM "OS") elseif(CMAKE_OSX_ARCHITECTURES MATCHES "i386" AND CMAKE_OSX_SYSROOT MATCHES ".*iphonesimulator.*") set(PLATFORM "SIMULATOR") elseif(CMAKE_OSX_ARCHITECTURES MATCHES "x86_64" AND CMAKE_OSX_SYSROOT MATCHES ".*iphonesimulator.*") set(PLATFORM "SIMULATOR64") elseif(CMAKE_OSX_ARCHITECTURES MATCHES "arm64" AND CMAKE_OSX_SYSROOT MATCHES ".*appletvos.*") set(PLATFORM "TVOS") elseif(CMAKE_OSX_ARCHITECTURES MATCHES "x86_64" AND CMAKE_OSX_SYSROOT MATCHES ".*appletvsimulator.*") set(PLATFORM "SIMULATOR_TVOS") elseif(CMAKE_OSX_ARCHITECTURES MATCHES ".*armv7k.*" AND CMAKE_OSX_SYSROOT MATCHES ".*watchos.*") set(PLATFORM "WATCHOS") elseif(CMAKE_OSX_ARCHITECTURES MATCHES "i386" AND CMAKE_OSX_SYSROOT MATCHES ".*watchsimulator.*") set(PLATFORM "SIMULATOR_WATCHOS") endif() endif() if (NOT PLATFORM) if(DROP_32_BIT) set(PLATFORM "OS64") else() set(PLATFORM "OS") endif() endif() endif() set(PLATFORM_INT "${PLATFORM}" CACHE STRING "Type of platform for which the build targets.") # Handle the case where we are targeting iOS and a version above 10.3.4 (32-bit support dropped officially) if(PLATFORM_INT STREQUAL "OS" AND DEPLOYMENT_TARGET VERSION_GREATER_EQUAL 10.3.4) set(PLATFORM_INT "OS64") message(STATUS "Targeting minimum SDK version ${DEPLOYMENT_TARGET}. Dropping 32-bit support.") elseif(PLATFORM_INT STREQUAL "SIMULATOR" AND DEPLOYMENT_TARGET VERSION_GREATER_EQUAL 10.3.4) set(PLATFORM_INT "SIMULATOR64") message(STATUS "Targeting minimum SDK version ${DEPLOYMENT_TARGET}. Dropping 32-bit support.") endif() # Determine the platform name and architectures for use in xcodebuild commands # from the specified PLATFORM name. if(PLATFORM_INT STREQUAL "OS") set(SDK_NAME iphoneos) if(NOT ARCHS) set(ARCHS armv7 armv7s arm64) set(APPLE_TARGET_TRIPLE_INT arm-apple-ios) endif() elseif(PLATFORM_INT STREQUAL "OS64") set(SDK_NAME iphoneos) if(NOT ARCHS) if (XCODE_VERSION VERSION_GREATER 10.0) set(ARCHS arm64) # Add arm64e when Apple have fixed the integration issues with it, libarclite_iphoneos.a is currently missung bitcode markers for example else() set(ARCHS arm64) endif() set(APPLE_TARGET_TRIPLE_INT aarch64-apple-ios) endif() elseif(PLATFORM_INT STREQUAL "OS64COMBINED") set(SDK_NAME iphoneos) if(MODERN_CMAKE) if(NOT ARCHS) if (XCODE_VERSION VERSION_GREATER 10.0) set(ARCHS arm64 x86_64) # Add arm64e when Apple have fixed the integration issues with it, libarclite_iphoneos.a is currently missung bitcode markers for example else() set(ARCHS arm64 x86_64) endif() set(APPLE_TARGET_TRIPLE_INT aarch64-x86_64-apple-ios) endif() else() message(FATAL_ERROR "Please make sure that you are running CMake 3.14+ to make the OS64COMBINED setting work") endif() elseif(PLATFORM_INT STREQUAL "SIMULATOR") set(SDK_NAME iphonesimulator) if(NOT ARCHS) set(ARCHS i386) set(APPLE_TARGET_TRIPLE_INT i386-apple-ios) endif() message(DEPRECATION "SIMULATOR IS DEPRECATED. Consider using SIMULATOR64 instead.") elseif(PLATFORM_INT STREQUAL "SIMULATOR64") set(SDK_NAME iphonesimulator) if(NOT ARCHS) set(ARCHS x86_64) set(APPLE_TARGET_TRIPLE_INT x86_64-apple-ios) endif() elseif(PLATFORM_INT STREQUAL "TVOS") set(SDK_NAME appletvos) if(NOT ARCHS) set(ARCHS arm64) set(APPLE_TARGET_TRIPLE_INT aarch64-apple-tvos) endif() elseif (PLATFORM_INT STREQUAL "TVOSCOMBINED") set(SDK_NAME appletvos) if(MODERN_CMAKE) if(NOT ARCHS) set(ARCHS arm64 x86_64) set(APPLE_TARGET_TRIPLE_INT aarch64-x86_64-apple-tvos) endif() else() message(FATAL_ERROR "Please make sure that you are running CMake 3.14+ to make the TVOSCOMBINED setting work") endif() elseif(PLATFORM_INT STREQUAL "SIMULATOR_TVOS") set(SDK_NAME appletvsimulator) if(NOT ARCHS) set(ARCHS x86_64) set(APPLE_TARGET_TRIPLE_INT x86_64-apple-tvos) endif() elseif(PLATFORM_INT STREQUAL "WATCHOS") set(SDK_NAME watchos) if(NOT ARCHS) if (XCODE_VERSION VERSION_GREATER 10.0) set(ARCHS armv7k arm64_32) set(APPLE_TARGET_TRIPLE_INT aarch64_32-apple-watchos) else() set(ARCHS armv7k) set(APPLE_TARGET_TRIPLE_INT arm-apple-watchos) endif() endif() elseif(PLATFORM_INT STREQUAL "WATCHOSCOMBINED") set(SDK_NAME watchos) if(MODERN_CMAKE) if(NOT ARCHS) if (XCODE_VERSION VERSION_GREATER 10.0) set(ARCHS armv7k arm64_32 i386) set(APPLE_TARGET_TRIPLE_INT aarch64_32-i386-apple-watchos) else() set(ARCHS armv7k i386) set(APPLE_TARGET_TRIPLE_INT arm-i386-apple-watchos) endif() endif() else() message(FATAL_ERROR "Please make sure that you are running CMake 3.14+ to make the WATCHOSCOMBINED setting work") endif() elseif(PLATFORM_INT STREQUAL "SIMULATOR_WATCHOS") set(SDK_NAME watchsimulator) if(NOT ARCHS) set(ARCHS i386) set(APPLE_TARGET_TRIPLE_INT i386-apple-watchos) endif() else() message(FATAL_ERROR "Invalid PLATFORM: ${PLATFORM_INT}") endif() if(MODERN_CMAKE AND PLATFORM_INT MATCHES ".*COMBINED" AND NOT USED_CMAKE_GENERATOR MATCHES "Xcode") message(FATAL_ERROR "The COMBINED options only work with Xcode generator, -G Xcode") endif() # If user did not specify the SDK root to use, then query xcodebuild for it. execute_process(COMMAND xcodebuild -version -sdk ${SDK_NAME} Path OUTPUT_VARIABLE CMAKE_OSX_SYSROOT_INT ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) if (NOT DEFINED CMAKE_OSX_SYSROOT_INT AND NOT DEFINED CMAKE_OSX_SYSROOT) message(SEND_ERROR "Please make sure that Xcode is installed and that the toolchain" "is pointing to the correct path. Please run:" "sudo xcode-select -s /Applications/Xcode.app/Contents/Developer" "and see if that fixes the problem for you.") message(FATAL_ERROR "Invalid CMAKE_OSX_SYSROOT: ${CMAKE_OSX_SYSROOT} " "does not exist.") elseif(DEFINED CMAKE_OSX_SYSROOT_INT) set(CMAKE_OSX_SYSROOT "${CMAKE_OSX_SYSROOT_INT}" CACHE INTERNAL "") endif() # Set Xcode property for SDKROOT as well if Xcode generator is used if(USED_CMAKE_GENERATOR MATCHES "Xcode") set(CMAKE_OSX_SYSROOT "${SDK_NAME}" CACHE INTERNAL "") if(NOT DEFINED CMAKE_XCODE_ATTRIBUTE_DEVELOPMENT_TEAM) set(CMAKE_XCODE_ATTRIBUTE_DEVELOPMENT_TEAM "123456789A") endif() endif() # Specify minimum version of deployment target. if(NOT DEFINED DEPLOYMENT_TARGET) if (PLATFORM_INT STREQUAL "WATCHOS" OR PLATFORM_INT STREQUAL "SIMULATOR_WATCHOS") # Unless specified, SDK version 2.0 is used by default as minimum target version (watchOS). set(DEPLOYMENT_TARGET "2.0" CACHE STRING "Minimum SDK version to build for." ) else() # Unless specified, SDK version 9.0 is used by default as minimum target version (iOS, tvOS). set(DEPLOYMENT_TARGET "9.0" CACHE STRING "Minimum SDK version to build for." ) endif() message(STATUS "Using the default min-version since DEPLOYMENT_TARGET not provided!") endif() # Use bitcode or not if(NOT DEFINED ENABLE_BITCODE AND NOT ARCHS MATCHES "((^|;|, )(i386|x86_64))+") # Unless specified, enable bitcode support by default message(STATUS "Enabling bitcode support by default. ENABLE_BITCODE not provided!") set(ENABLE_BITCODE TRUE) elseif(NOT DEFINED ENABLE_BITCODE) message(STATUS "Disabling bitcode support by default on simulators. ENABLE_BITCODE not provided for override!") set(ENABLE_BITCODE FALSE) endif() set(ENABLE_BITCODE_INT ${ENABLE_BITCODE} CACHE BOOL "Whether or not to enable bitcode" ${FORCE_CACHE}) # Use ARC or not if(NOT DEFINED ENABLE_ARC) # Unless specified, enable ARC support by default set(ENABLE_ARC TRUE) message(STATUS "Enabling ARC support by default. ENABLE_ARC not provided!") endif() set(ENABLE_ARC_INT ${ENABLE_ARC} CACHE BOOL "Whether or not to enable ARC" ${FORCE_CACHE}) # Use hidden visibility or not if(NOT DEFINED ENABLE_VISIBILITY) # Unless specified, disable symbols visibility by default set(ENABLE_VISIBILITY FALSE) message(STATUS "Hiding symbols visibility by default. ENABLE_VISIBILITY not provided!") endif() set(ENABLE_VISIBILITY_INT ${ENABLE_VISIBILITY} CACHE BOOL "Whether or not to hide symbols (-fvisibility=hidden)" ${FORCE_CACHE}) # Set strict compiler checks or not if(NOT DEFINED ENABLE_STRICT_TRY_COMPILE) # Unless specified, disable strict try_compile() set(ENABLE_STRICT_TRY_COMPILE FALSE) message(STATUS "Using NON-strict compiler checks by default. ENABLE_STRICT_TRY_COMPILE not provided!") endif() set(ENABLE_STRICT_TRY_COMPILE_INT ${ENABLE_STRICT_TRY_COMPILE} CACHE BOOL "Whether or not to use strict compiler checks" ${FORCE_CACHE}) # Get the SDK version information. execute_process(COMMAND xcodebuild -sdk ${CMAKE_OSX_SYSROOT} -version SDKVersion OUTPUT_VARIABLE SDK_VERSION ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) # Find the Developer root for the specific iOS platform being compiled for # from CMAKE_OSX_SYSROOT. Should be ../../ from SDK specified in # CMAKE_OSX_SYSROOT. There does not appear to be a direct way to obtain # this information from xcrun or xcodebuild. if (NOT DEFINED CMAKE_DEVELOPER_ROOT AND NOT USED_CMAKE_GENERATOR MATCHES "Xcode") get_filename_component(PLATFORM_SDK_DIR ${CMAKE_OSX_SYSROOT} PATH) get_filename_component(CMAKE_DEVELOPER_ROOT ${PLATFORM_SDK_DIR} PATH) if (NOT DEFINED CMAKE_DEVELOPER_ROOT) message(FATAL_ERROR "Invalid CMAKE_DEVELOPER_ROOT: " "${CMAKE_DEVELOPER_ROOT} does not exist.") endif() endif() # Find the C & C++ compilers for the specified SDK. if(NOT CMAKE_C_COMPILER) execute_process(COMMAND xcrun -sdk ${CMAKE_OSX_SYSROOT} -find clang OUTPUT_VARIABLE CMAKE_C_COMPILER ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) message(STATUS "Using C compiler: ${CMAKE_C_COMPILER}") endif() if(NOT CMAKE_CXX_COMPILER) execute_process(COMMAND xcrun -sdk ${CMAKE_OSX_SYSROOT} -find clang++ OUTPUT_VARIABLE CMAKE_CXX_COMPILER ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) message(STATUS "Using CXX compiler: ${CMAKE_CXX_COMPILER}") endif() # Find (Apple's) libtool. execute_process(COMMAND xcrun -sdk ${CMAKE_OSX_SYSROOT} -find libtool OUTPUT_VARIABLE BUILD_LIBTOOL ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) message(STATUS "Using libtool: ${BUILD_LIBTOOL}") # Configure libtool to be used instead of ar + ranlib to build static libraries. # This is required on Xcode 7+, but should also work on previous versions of # Xcode. set(CMAKE_C_CREATE_STATIC_LIBRARY "${BUILD_LIBTOOL} -static -o ") set(CMAKE_CXX_CREATE_STATIC_LIBRARY "${BUILD_LIBTOOL} -static -o ") # Find the toolchain's provided install_name_tool if none is found on the host if(NOT CMAKE_INSTALL_NAME_TOOL) execute_process(COMMAND xcrun -sdk ${CMAKE_OSX_SYSROOT} -find install_name_tool OUTPUT_VARIABLE CMAKE_INSTALL_NAME_TOOL_INT ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) set(CMAKE_INSTALL_NAME_TOOL ${CMAKE_INSTALL_NAME_TOOL_INT} CACHE STRING "" ${FORCE_CACHE}) endif() # Get the version of Darwin (OS X) of the host. execute_process(COMMAND uname -r OUTPUT_VARIABLE CMAKE_HOST_SYSTEM_VERSION ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) if(SDK_NAME MATCHES "iphone") set(CMAKE_SYSTEM_NAME iOS CACHE INTERNAL "" ${FORCE_CACHE}) endif() # CMake 3.14+ support building for iOS, watchOS and tvOS out of the box. if(MODERN_CMAKE) if(SDK_NAME MATCHES "appletv") set(CMAKE_SYSTEM_NAME tvOS CACHE INTERNAL "" ${FORCE_CACHE}) elseif(SDK_NAME MATCHES "watch") set(CMAKE_SYSTEM_NAME watchOS CACHE INTERNAL "" ${FORCE_CACHE}) endif() # Provide flags for a combined FAT library build on newer CMake versions if(PLATFORM_INT MATCHES ".*COMBINED") set(CMAKE_XCODE_ATTRIBUTE_ONLY_ACTIVE_ARCH "NO") set(CMAKE_IOS_INSTALL_COMBINED YES CACHE INTERNAL "" ${FORCE_CACHE}) message(STATUS "Will combine built (static) artifacts into FAT lib...") endif() elseif(${CMAKE_VERSION} VERSION_GREATER_EQUAL "3.10") # Legacy code path prior to CMake 3.14 or fallback if no SDK_NAME specified set(CMAKE_SYSTEM_NAME iOS CACHE INTERNAL "" ${FORCE_CACHE}) else() # Legacy code path prior to CMake 3.14 or fallback if no SDK_NAME specified set(CMAKE_SYSTEM_NAME Darwin CACHE INTERNAL "" ${FORCE_CACHE}) endif() # Standard settings. set(CMAKE_SYSTEM_VERSION ${SDK_VERSION} CACHE INTERNAL "") set(UNIX TRUE CACHE BOOL "") set(APPLE TRUE CACHE BOOL "") set(IOS TRUE CACHE BOOL "") set(CMAKE_AR ar CACHE FILEPATH "" FORCE) set(CMAKE_RANLIB ranlib CACHE FILEPATH "" FORCE) set(CMAKE_STRIP strip CACHE FILEPATH "" FORCE) # Set the architectures for which to build. set(CMAKE_OSX_ARCHITECTURES ${ARCHS} CACHE STRING "Build architecture for iOS") # Change the type of target generated for try_compile() so it'll work when cross-compiling, weak compiler checks if(ENABLE_STRICT_TRY_COMPILE_INT) message(STATUS "Using strict compiler checks (default in CMake).") else() set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY) endif() # All iOS/Darwin specific settings - some may be redundant. set(CMAKE_MACOSX_BUNDLE YES) set(CMAKE_XCODE_ATTRIBUTE_CODE_SIGNING_REQUIRED "NO") set(CMAKE_SHARED_LIBRARY_PREFIX "lib") set(CMAKE_SHARED_LIBRARY_SUFFIX ".dylib") set(CMAKE_SHARED_MODULE_PREFIX "lib") set(CMAKE_SHARED_MODULE_SUFFIX ".so") set(CMAKE_C_COMPILER_ABI ELF) set(CMAKE_CXX_COMPILER_ABI ELF) set(CMAKE_C_HAS_ISYSROOT 1) set(CMAKE_CXX_HAS_ISYSROOT 1) set(CMAKE_MODULE_EXISTS 1) set(CMAKE_DL_LIBS "") set(CMAKE_C_OSX_COMPATIBILITY_VERSION_FLAG "-compatibility_version ") set(CMAKE_C_OSX_CURRENT_VERSION_FLAG "-current_version ") set(CMAKE_CXX_OSX_COMPATIBILITY_VERSION_FLAG "${CMAKE_C_OSX_COMPATIBILITY_VERSION_FLAG}") set(CMAKE_CXX_OSX_CURRENT_VERSION_FLAG "${CMAKE_C_OSX_CURRENT_VERSION_FLAG}") if(ARCHS MATCHES "((^|;|, )(arm64|arm64e|x86_64))+") set(CMAKE_C_SIZEOF_DATA_PTR 8) set(CMAKE_CXX_SIZEOF_DATA_PTR 8) if(ARCHS MATCHES "((^|;|, )(arm64|arm64e))+") set(CMAKE_SYSTEM_PROCESSOR "aarch64") else() set(CMAKE_SYSTEM_PROCESSOR "x86_64") endif() else() set(CMAKE_C_SIZEOF_DATA_PTR 4) set(CMAKE_CXX_SIZEOF_DATA_PTR 4) set(CMAKE_SYSTEM_PROCESSOR "arm") endif() # Note that only Xcode 7+ supports the newer more specific: # -m${SDK_NAME}-version-min flags, older versions of Xcode use: # -m(ios/ios-simulator)-version-min instead. if(${CMAKE_VERSION} VERSION_LESS "3.11") if(PLATFORM_INT STREQUAL "OS" OR PLATFORM_INT STREQUAL "OS64") if(XCODE_VERSION VERSION_LESS 7.0) set(SDK_NAME_VERSION_FLAGS "-mios-version-min=${DEPLOYMENT_TARGET}") else() # Xcode 7.0+ uses flags we can build directly from SDK_NAME. set(SDK_NAME_VERSION_FLAGS "-m${SDK_NAME}-version-min=${DEPLOYMENT_TARGET}") endif() elseif(PLATFORM_INT STREQUAL "TVOS") set(SDK_NAME_VERSION_FLAGS "-mtvos-version-min=${DEPLOYMENT_TARGET}") elseif(PLATFORM_INT STREQUAL "SIMULATOR_TVOS") set(SDK_NAME_VERSION_FLAGS "-mtvos-simulator-version-min=${DEPLOYMENT_TARGET}") elseif(PLATFORM_INT STREQUAL "WATCHOS") set(SDK_NAME_VERSION_FLAGS "-mwatchos-version-min=${DEPLOYMENT_TARGET}") elseif(PLATFORM_INT STREQUAL "SIMULATOR_WATCHOS") set(SDK_NAME_VERSION_FLAGS "-mwatchos-simulator-version-min=${DEPLOYMENT_TARGET}") else() # SIMULATOR or SIMULATOR64 both use -mios-simulator-version-min. set(SDK_NAME_VERSION_FLAGS "-mios-simulator-version-min=${DEPLOYMENT_TARGET}") endif() else() # Newer versions of CMake sets the version min flags correctly set(CMAKE_OSX_DEPLOYMENT_TARGET ${DEPLOYMENT_TARGET} CACHE STRING "Set CMake deployment target" ${FORCE_CACHE}) endif() if(DEFINED APPLE_TARGET_TRIPLE_INT) set(APPLE_TARGET_TRIPLE ${APPLE_TARGET_TRIPLE_INT} CACHE STRING "Autoconf target triple compatible variable" ${FORCE_CACHE}) endif() if(ENABLE_BITCODE_INT) set(BITCODE "-fembed-bitcode") set(CMAKE_XCODE_ATTRIBUTE_BITCODE_GENERATION_MODE "bitcode") set(CMAKE_XCODE_ATTRIBUTE_ENABLE_BITCODE "YES") else() set(BITCODE "") set(CMAKE_XCODE_ATTRIBUTE_ENABLE_BITCODE "NO") endif() if(ENABLE_ARC_INT) set(FOBJC_ARC "-fobjc-arc") set(CMAKE_XCODE_ATTRIBUTE_CLANG_ENABLE_OBJC_ARC "YES") else() set(FOBJC_ARC "-fno-objc-arc") set(CMAKE_XCODE_ATTRIBUTE_CLANG_ENABLE_OBJC_ARC "NO") endif() if(NOT ENABLE_VISIBILITY_INT) set(VISIBILITY "-fvisibility=hidden") set(CMAKE_XCODE_ATTRIBUTE_GCC_SYMBOLS_PRIVATE_EXTERN "YES") else() set(VISIBILITY "") set(CMAKE_XCODE_ATTRIBUTE_GCC_SYMBOLS_PRIVATE_EXTERN "NO") endif() if(NOT IOS_TOOLCHAIN_HAS_RUN) #Check if Xcode generator is used, since that will handle these flags automagically if(USED_CMAKE_GENERATOR MATCHES "Xcode") message(STATUS "Not setting any manual command-line buildflags, since Xcode is selected as generator.") else() set(CMAKE_C_FLAGS "${SDK_NAME_VERSION_FLAGS} ${BITCODE} -fobjc-abi-version=2 ${FOBJC_ARC} ${CMAKE_C_FLAGS}") # Hidden visibilty is required for C++ on iOS. set(CMAKE_CXX_FLAGS "${SDK_NAME_VERSION_FLAGS} ${BITCODE} ${VISIBILITY} -fvisibility-inlines-hidden -fobjc-abi-version=2 ${FOBJC_ARC} ${CMAKE_CXX_FLAGS}") set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS} -O0 -g ${CMAKE_CXX_FLAGS_DEBUG}") set(CMAKE_CXX_FLAGS_MINSIZEREL "${CMAKE_CXX_FLAGS} -DNDEBUG -Os -ffast-math ${CMAKE_CXX_FLAGS_MINSIZEREL}") set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS} -DNDEBUG -O2 -g -ffast-math ${CMAKE_CXX_FLAGS_RELWITHDEBINFO}") set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS} -DNDEBUG -O3 -ffast-math ${CMAKE_CXX_FLAGS_RELEASE}") set(CMAKE_C_LINK_FLAGS "${SDK_NAME_VERSION_FLAGS} -Wl,-search_paths_first ${CMAKE_C_LINK_FLAGS}") set(CMAKE_CXX_LINK_FLAGS "${SDK_NAME_VERSION_FLAGS} -Wl,-search_paths_first ${CMAKE_CXX_LINK_FLAGS}") set(CMAKE_ASM_FLAGS "${CFLAGS} -x assembler-with-cpp -arch ${CMAKE_OSX_ARCHITECTURES}") # In order to ensure that the updated compiler flags are used in try_compile() # tests, we have to forcibly set them in the CMake cache, not merely set them # in the local scope. set(VARS_TO_FORCE_IN_CACHE CMAKE_C_FLAGS CMAKE_CXX_FLAGS CMAKE_CXX_FLAGS_DEBUG CMAKE_CXX_FLAGS_RELWITHDEBINFO CMAKE_CXX_FLAGS_MINSIZEREL CMAKE_CXX_FLAGS_RELEASE CMAKE_C_LINK_FLAGS CMAKE_CXX_LINK_FLAGS) foreach(VAR_TO_FORCE ${VARS_TO_FORCE_IN_CACHE}) set(${VAR_TO_FORCE} "${${VAR_TO_FORCE}}" CACHE STRING "" ${FORCE_CACHE}) endforeach() endif() ## Print status messages to inform of the current state message(STATUS "Configuring ${SDK_NAME} build for platform: ${PLATFORM_INT}, architecture(s): ${ARCHS}") message(STATUS "Using SDK: ${CMAKE_OSX_SYSROOT_INT}") if(DEFINED APPLE_TARGET_TRIPLE) message(STATUS "Autoconf target triple: ${APPLE_TARGET_TRIPLE}") endif() message(STATUS "Using minimum deployment version: ${DEPLOYMENT_TARGET}" " (SDK version: ${SDK_VERSION})") if(MODERN_CMAKE) message(STATUS "Merging integrated CMake 3.14+ iOS,tvOS,watchOS,macOS toolchain(s) with this toolchain!") endif() if(USED_CMAKE_GENERATOR MATCHES "Xcode") message(STATUS "Using Xcode version: ${XCODE_VERSION}") endif() if(DEFINED SDK_NAME_VERSION_FLAGS) message(STATUS "Using version flags: ${SDK_NAME_VERSION_FLAGS}") endif() message(STATUS "Using a data_ptr size of: ${CMAKE_CXX_SIZEOF_DATA_PTR}") message(STATUS "Using install_name_tool: ${CMAKE_INSTALL_NAME_TOOL}") if(ENABLE_BITCODE_INT) message(STATUS "Enabling bitcode support.") else() message(STATUS "Disabling bitcode support.") endif() if(ENABLE_ARC_INT) message(STATUS "Enabling ARC support.") else() message(STATUS "Disabling ARC support.") endif() if(NOT ENABLE_VISIBILITY_INT) message(STATUS "Hiding symbols (-fvisibility=hidden).") endif() endif() set(CMAKE_PLATFORM_HAS_INSTALLNAME 1) set(CMAKE_SHARED_LINKER_FLAGS "-rpath @executable_path/Frameworks -rpath @loader_path/Frameworks") set(CMAKE_SHARED_LIBRARY_CREATE_C_FLAGS "-dynamiclib -Wl,-headerpad_max_install_names") set(CMAKE_SHARED_MODULE_CREATE_C_FLAGS "-bundle -Wl,-headerpad_max_install_names") set(CMAKE_SHARED_MODULE_LOADER_C_FLAG "-Wl,-bundle_loader,") set(CMAKE_SHARED_MODULE_LOADER_CXX_FLAG "-Wl,-bundle_loader,") set(CMAKE_FIND_LIBRARY_SUFFIXES ".tbd" ".dylib" ".so" ".a") set(CMAKE_SHARED_LIBRARY_SONAME_C_FLAG "-install_name") # Set the find root to the iOS developer roots and to user defined paths. set(CMAKE_FIND_ROOT_PATH ${CMAKE_OSX_SYSROOT_INT} ${CMAKE_PREFIX_PATH} CACHE STRING "Root path that will be prepended to all search paths") # Default to searching for frameworks first. set(CMAKE_FIND_FRAMEWORK FIRST) # Set up the default search directories for frameworks. set(CMAKE_FRAMEWORK_PATH ${CMAKE_DEVELOPER_ROOT}/Library/PrivateFrameworks ${CMAKE_OSX_SYSROOT_INT}/System/Library/Frameworks ${CMAKE_FRAMEWORK_PATH} CACHE STRING "Frameworks search paths" ${FORCE_CACHE}) set(IOS_TOOLCHAIN_HAS_RUN TRUE CACHE BOOL "Has the CMake toolchain run already?" ${FORCE_CACHE}) # By default, search both the specified iOS SDK and the remainder of the host filesystem. if(NOT CMAKE_FIND_ROOT_PATH_MODE_PROGRAM) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM BOTH CACHE STRING "" ${FORCE_CACHE}) endif() if(NOT CMAKE_FIND_ROOT_PATH_MODE_LIBRARY) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH CACHE STRING "" ${FORCE_CACHE}) endif() if(NOT CMAKE_FIND_ROOT_PATH_MODE_INCLUDE) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH CACHE STRING "" ${FORCE_CACHE}) endif() if(NOT CMAKE_FIND_ROOT_PATH_MODE_PACKAGE) set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE BOTH CACHE STRING "" ${FORCE_CACHE}) endif() # # Some helper-macros below to simplify and beautify the CMakeFile # # This little macro lets you set any Xcode specific property. macro(set_xcode_property TARGET XCODE_PROPERTY XCODE_VALUE XCODE_RELVERSION) set(XCODE_RELVERSION_I "${XCODE_RELVERSION}") if(XCODE_RELVERSION_I STREQUAL "All") set_property(TARGET ${TARGET} PROPERTY XCODE_ATTRIBUTE_${XCODE_PROPERTY} "${XCODE_VALUE}") else() set_property(TARGET ${TARGET} PROPERTY XCODE_ATTRIBUTE_${XCODE_PROPERTY}[variant=${XCODE_RELVERSION_I}] "${XCODE_VALUE}") endif() endmacro(set_xcode_property) # This macro lets you find executable programs on the host system. macro(find_host_package) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE NEVER) set(IOS FALSE) find_package(${ARGN}) set(IOS TRUE) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM BOTH) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY BOTH) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE BOTH) set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE BOTH) endmacro(find_host_package) LIEF-0.13.1/cmake/strip.cmake000066400000000000000000000001651443457337100155530ustar00rootroot00000000000000execute_process(COMMAND ${CMAKE_STRIP} --discard-all --discard-locals --strip-all --strip-unneeded ${TARGET_FILE}) LIEF-0.13.1/doc/000077500000000000000000000000001443457337100130735ustar00rootroot00000000000000LIEF-0.13.1/doc/CMakeLists.txt000066400000000000000000000052211443457337100156330ustar00rootroot00000000000000find_package(Doxygen) find_package(Sphinx) if(NOT DOXYGEN_FOUND) message(STATUS "Doc disabled: doxygen not found") elseif(NOT SPHINX_FOUND) message(FATAL "Doc disabled: sphinx-build not found") elseif(${CMAKE_CURRENT_SOURCE_DIR} STREQUAL ${CMAKE_CURRENT_BINARY_DIR}) message(STATUS "You have to build the doc in another directory !") else() message(STATUS "Sphinx: ${SPHINX_EXECUTABLE}") add_custom_target(lief-doxygen COMMAND ${CMAKE_COMMAND} -E env "LIEF_VERSION=${LIEF_VERSION_MAJOR}.${LIEF_VERSION_MINOR}.${LIEF_VERSION_PATCH}-${LIEF_COMMIT_HASH}" "LIEF_INPUT=${CMAKE_SOURCE_DIR}/src ${CMAKE_SOURCE_DIR}/include ${CMAKE_BINARY_DIR}/include/LIEF ${CMAKE_SOURCE_DIR}/api/c/include ${CMAKE_SOURCE_DIR}/doc/doxygen/" "LIEF_EXCLUDE=${CMAKE_BINARY_DIR}/include/LIEF/third-party" "LIEF_INCLUDE_PATH=${CMAKE_BINARY_DIR}/include ${CMAKE_SOURCE_DIR}/include" "LIEF_DOXYGEN_WARN_FILE=${CMAKE_BINARY_DIR}/doxygen-warn.log" ${DOXYGEN_EXECUTABLE} ${CMAKE_SOURCE_DIR}/doc/doxygen/Doxyfile WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} COMMENT "Generating Doxygen documentation" VERBATIM) add_custom_target(lief-sphinx COMMAND ${CMAKE_COMMAND} -E env "PYTHONPATH=${CMAKE_SOURCE_DIR}:${CMAKE_BINARY_DIR}/../:${CMAKE_BINARY_DIR}/api/python:$ENV{PYTHONPATH}" "LIEF_DOXYGEN_XML=${CMAKE_CURRENT_BINARY_DIR}/doxygen/xml/" ${SPHINX_EXECUTABLE} -a -E -j4 -w ${CMAKE_BINARY_DIR}/sphinx-warn.log ${CMAKE_SOURCE_DIR}/doc/sphinx sphinx-doc DEPENDS pyLIEF lief-doxygen WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} COMMENT "Generating Sphinx Documentation" VERBATIM) add_custom_target(lief-doc ALL DEPENDS lief-sphinx lief-doxygen WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} COMMENT "Generating documentation with Doxygen and Sphinx" VERBATIM) add_custom_target(lief-quick-sphinx COMMAND ${CMAKE_COMMAND} -E env "PYTHONPATH=${CMAKE_SOURCE_DIR}:${CMAKE_BINARY_DIR}/../:${CMAKE_BINARY_DIR}/api/python:$ENV{PYTHONPATH}" "LIEF_DOXYGEN_XML=${CMAKE_CURRENT_BINARY_DIR}/doxygen/xml/" "FORCE_RTD_THEME=0" ${SPHINX_EXECUTABLE} -j4 -w ${CMAKE_BINARY_DIR}/sphinx-warn.log ${CMAKE_SOURCE_DIR}/doc/sphinx sphinx-doc WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} COMMENT "Generating Sphinx documentation quickly" VERBATIM) install( DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/doxygen/html/ DESTINATION share/LIEF/doc/doxygen COMPONENT doc) install( DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/sphinx-doc/ DESTINATION share/LIEF/doc/sphinx COMPONENT doc) endif() LIEF-0.13.1/doc/doxygen/000077500000000000000000000000001443457337100145505ustar00rootroot00000000000000LIEF-0.13.1/doc/doxygen/Doxyfile000066400000000000000000003332211443457337100162620ustar00rootroot00000000000000# Doxyfile 1.8.20 # This file describes the settings to be used by the documentation system # doxygen (www.doxygen.org) for a project. # # All text after a double hash (##) is considered a comment and is placed in # front of the TAG it is preceding. # # All text after a single hash (#) is considered a comment and will be ignored. # The format is: # TAG = value [value, ...] # For lists, items can also be appended using: # TAG += value [value, ...] # Values that contain spaces should be placed between quotes (\" \"). #--------------------------------------------------------------------------- # Project related configuration options #--------------------------------------------------------------------------- # This tag specifies the encoding used for all characters in the configuration # file that follow. The default is UTF-8 which is also the encoding used for all # text before the first occurrence of this tag. Doxygen uses libiconv (or the # iconv built into libc) for the transcoding. See # https://www.gnu.org/software/libiconv/ for the list of possible encodings. # The default value is: UTF-8. DOXYFILE_ENCODING = UTF-8 # The PROJECT_NAME tag is a single word (or a sequence of words surrounded by # double-quotes, unless you are using Doxywizard) that should identify the # project for which the documentation is generated. This name is used in the # title of most generated pages and in a few other places. # The default value is: My Project. PROJECT_NAME = "LIEF: Library to Instrument Executable Formats" # The PROJECT_NUMBER tag can be used to enter a project or revision number. This # could be handy for archiving the generated documentation or if some version # control system is used. PROJECT_NUMBER = "Version $(LIEF_VERSION)" # Using the PROJECT_BRIEF tag one can provide an optional one line description # for a project that appears at the top of each page and should give viewer a # quick idea about the purpose of the project. Keep the description short. PROJECT_BRIEF = # With the PROJECT_LOGO tag one can specify a logo or an icon that is included # in the documentation. The maximum height of the logo should not exceed 55 # pixels and the maximum width should not exceed 200 pixels. Doxygen will copy # the logo to the output directory. PROJECT_LOGO = $(LIEF_LOGO) # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path # into which the generated documentation will be written. If a relative path is # entered, it will be relative to the location where doxygen was started. If # left blank the current directory will be used. OUTPUT_DIRECTORY = ./doxygen # If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub- # directories (in 2 levels) under the output directory of each output format and # will distribute the generated files over these directories. Enabling this # option can be useful when feeding doxygen a huge amount of source files, where # putting all generated files in the same directory would otherwise causes # performance problems for the file system. # The default value is: NO. CREATE_SUBDIRS = NO # If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII # characters to appear in the names of generated files. If set to NO, non-ASCII # characters will be escaped, for example _xE3_x81_x84 will be used for Unicode # U+3044. # The default value is: NO. ALLOW_UNICODE_NAMES = NO # The OUTPUT_LANGUAGE tag is used to specify the language in which all # documentation generated by doxygen is written. Doxygen will use this # information to generate all constant output in the proper language. # Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese, # Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States), # Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian, # Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages), # Korean, Korean-en (Korean with English messages), Latvian, Lithuanian, # Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian, # Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish, # Ukrainian and Vietnamese. # The default value is: English. OUTPUT_LANGUAGE = English # If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member # descriptions after the members that are listed in the file and class # documentation (similar to Javadoc). Set to NO to disable this. # The default value is: YES. BRIEF_MEMBER_DESC = YES # If the REPEAT_BRIEF tag is set to YES, doxygen will prepend the brief # description of a member or function before the detailed description # # Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the # brief descriptions will be completely suppressed. # The default value is: YES. REPEAT_BRIEF = YES # This tag implements a quasi-intelligent brief description abbreviator that is # used to form the text in various listings. Each string in this list, if found # as the leading text of the brief description, will be stripped from the text # and the result, after processing the whole list, is used as the annotated # text. Otherwise, the brief description is used as-is. If left blank, the # following values are used ($name is automatically replaced with the name of # the entity):The $name class, The $name widget, The $name file, is, provides, # specifies, contains, represents, a, an and the. ABBREVIATE_BRIEF = "The $name class" \ "The $name widget" \ "The $name file" \ is \ provides \ specifies \ contains \ represents \ a \ an \ the # If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then # doxygen will generate a detailed section even if there is only a brief # description. # The default value is: NO. ALWAYS_DETAILED_SEC = NO # If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all # inherited members of a class in the documentation of that class as if those # members were ordinary class members. Constructors, destructors and assignment # operators of the base classes will not be shown. # The default value is: NO. INLINE_INHERITED_MEMB = NO # If the FULL_PATH_NAMES tag is set to YES, doxygen will prepend the full path # before files name in the file list and in the header files. If set to NO the # shortest path that makes the file name unique will be used # The default value is: YES. FULL_PATH_NAMES = NO # The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path. # Stripping is only done if one of the specified strings matches the left-hand # part of the path. The tag can be used to show relative paths in the file list. # If left blank the directory from which doxygen is run is used as the path to # strip. # # Note that you can specify absolute paths here, but also relative paths, which # will be relative from the directory where doxygen is started. # This tag requires that the tag FULL_PATH_NAMES is set to YES. STRIP_FROM_PATH = # The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the # path mentioned in the documentation of a class, which tells the reader which # header file to include in order to use a class. If left blank only the name of # the header file containing the class definition is used. Otherwise one should # specify the list of include paths that are normally passed to the compiler # using the -I flag. STRIP_FROM_INC_PATH = # If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but # less readable) file names. This can be useful is your file systems doesn't # support long names like on DOS, Mac, or CD-ROM. # The default value is: NO. SHORT_NAMES = NO # If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the # first line (until the first dot) of a Javadoc-style comment as the brief # description. If set to NO, the Javadoc-style will behave just like regular Qt- # style comments (thus requiring an explicit @brief command for a brief # description.) # The default value is: NO. JAVADOC_AUTOBRIEF = NO # If the JAVADOC_BANNER tag is set to YES then doxygen will interpret a line # such as # /*************** # as being the beginning of a Javadoc-style comment "banner". If set to NO, the # Javadoc-style will behave just like regular comments and it will not be # interpreted by doxygen. # The default value is: NO. JAVADOC_BANNER = NO # If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first # line (until the first dot) of a Qt-style comment as the brief description. If # set to NO, the Qt-style will behave just like regular Qt-style comments (thus # requiring an explicit \brief command for a brief description.) # The default value is: NO. QT_AUTOBRIEF = NO # The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a # multi-line C++ special comment block (i.e. a block of //! or /// comments) as # a brief description. This used to be the default behavior. The new default is # to treat a multi-line C++ comment block as a detailed description. Set this # tag to YES if you prefer the old behavior instead. # # Note that setting this tag to YES also means that rational rose comments are # not recognized any more. # The default value is: NO. MULTILINE_CPP_IS_BRIEF = YES # By default Python docstrings are displayed as preformatted text and doxygen's # special commands cannot be used. By setting PYTHON_DOCSTRING to NO the # doxygen's special commands can be used and the contents of the docstring # documentation blocks is shown as doxygen documentation. # The default value is: YES. PYTHON_DOCSTRING = YES # If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the # documentation from any documented member that it re-implements. # The default value is: YES. INHERIT_DOCS = YES # If the SEPARATE_MEMBER_PAGES tag is set to YES then doxygen will produce a new # page for each member. If set to NO, the documentation of a member will be part # of the file/class/namespace that contains it. # The default value is: NO. SEPARATE_MEMBER_PAGES = NO # The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen # uses this value to replace tabs by spaces in code fragments. # Minimum value: 1, maximum value: 16, default value: 4. TAB_SIZE = 4 # This tag can be used to specify a number of aliases that act as commands in # the documentation. An alias has the form: # name=value # For example adding # "sideeffect=@par Side Effects:\n" # will allow you to put the command \sideeffect (or @sideeffect) in the # documentation, which will result in a user-defined paragraph with heading # "Side Effects:". You can put \n's in the value part of an alias to insert # newlines (in the resulting output). You can put ^^ in the value part of an # alias to insert a newline as if a physical newline was in the original file. # When you need a literal { or } or , in the value part of an alias you have to # escape them by means of a backslash (\), this can lead to conflicts with the # commands \{ and \} for these it is advised to use the version @{ and @} or use # a double escape (\\{ and \\}) ALIASES = # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources # only. Doxygen will then generate output that is more tailored for C. For # instance, some of the names that are used will be different. The list of all # members will be omitted, etc. # The default value is: NO. OPTIMIZE_OUTPUT_FOR_C = NO # Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or # Python sources only. Doxygen will then generate output that is more tailored # for that language. For instance, namespaces will be presented as packages, # qualified scopes will look different, etc. # The default value is: NO. OPTIMIZE_OUTPUT_JAVA = NO # Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran # sources. Doxygen will then generate output that is tailored for Fortran. # The default value is: NO. OPTIMIZE_FOR_FORTRAN = NO # Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL # sources. Doxygen will then generate output that is tailored for VHDL. # The default value is: NO. OPTIMIZE_OUTPUT_VHDL = NO # Set the OPTIMIZE_OUTPUT_SLICE tag to YES if your project consists of Slice # sources only. Doxygen will then generate output that is more tailored for that # language. For instance, namespaces will be presented as modules, types will be # separated into more groups, etc. # The default value is: NO. OPTIMIZE_OUTPUT_SLICE = NO # Doxygen selects the parser to use depending on the extension of the files it # parses. With this tag you can assign which parser to use for a given # extension. Doxygen has a built-in mapping, but you can override or extend it # using this tag. The format is ext=language, where ext is a file extension, and # language is one of the parsers supported by doxygen: IDL, Java, JavaScript, # Csharp (C#), C, C++, D, PHP, md (Markdown), Objective-C, Python, Slice, VHDL, # Fortran (fixed format Fortran: FortranFixed, free formatted Fortran: # FortranFree, unknown formatted Fortran: Fortran. In the later case the parser # tries to guess whether the code is fixed or free formatted code, this is the # default for Fortran type files). For instance to make doxygen treat .inc files # as Fortran files (default is PHP), and .f files as C (default is Fortran), # use: inc=Fortran f=C. # # Note: For files without extension you can use no_extension as a placeholder. # # Note that for custom extensions you also need to set FILE_PATTERNS otherwise # the files are not read by doxygen. EXTENSION_MAPPING = # If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments # according to the Markdown format, which allows for more readable # documentation. See https://daringfireball.net/projects/markdown/ for details. # The output of markdown processing is further processed by doxygen, so you can # mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in # case of backward compatibilities issues. # The default value is: YES. MARKDOWN_SUPPORT = YES # When the TOC_INCLUDE_HEADINGS tag is set to a non-zero value, all headings up # to that level are automatically included in the table of contents, even if # they do not have an id attribute. # Note: This feature currently applies only to Markdown headings. # Minimum value: 0, maximum value: 99, default value: 5. # This tag requires that the tag MARKDOWN_SUPPORT is set to YES. TOC_INCLUDE_HEADINGS = 5 # When enabled doxygen tries to link words that correspond to documented # classes, or namespaces to their corresponding documentation. Such a link can # be prevented in individual cases by putting a % sign in front of the word or # globally by setting AUTOLINK_SUPPORT to NO. # The default value is: YES. AUTOLINK_SUPPORT = YES # If you use STL classes (i.e. std::string, std::vector, etc.) but do not want # to include (a tag file for) the STL sources as input, then you should set this # tag to YES in order to let doxygen match functions declarations and # definitions whose arguments contain STL classes (e.g. func(std::string); # versus func(std::string) {}). This also make the inheritance and collaboration # diagrams that involve STL classes more complete and accurate. # The default value is: NO. BUILTIN_STL_SUPPORT = NO # If you use Microsoft's C++/CLI language, you should set this option to YES to # enable parsing support. # The default value is: NO. CPP_CLI_SUPPORT = NO # Set the SIP_SUPPORT tag to YES if your project consists of sip (see: # https://www.riverbankcomputing.com/software/sip/intro) sources only. Doxygen # will parse them like normal C++ but will assume all classes use public instead # of private inheritance when no explicit protection keyword is present. # The default value is: NO. SIP_SUPPORT = NO # For Microsoft's IDL there are propget and propput attributes to indicate # getter and setter methods for a property. Setting this option to YES will make # doxygen to replace the get and set methods by a property in the documentation. # This will only work if the methods are indeed getting or setting a simple # type. If this is not the case, or you want to show the methods anyway, you # should set this option to NO. # The default value is: YES. IDL_PROPERTY_SUPPORT = YES # If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC # tag is set to YES then doxygen will reuse the documentation of the first # member in the group (if any) for the other members of the group. By default # all members of a group must be documented explicitly. # The default value is: NO. DISTRIBUTE_GROUP_DOC = NO # If one adds a struct or class to a group and this option is enabled, then also # any nested class or struct is added to the same group. By default this option # is disabled and one has to add nested compounds explicitly via \ingroup. # The default value is: NO. GROUP_NESTED_COMPOUNDS = NO # Set the SUBGROUPING tag to YES to allow class member groups of the same type # (for instance a group of public functions) to be put as a subgroup of that # type (e.g. under the Public Functions section). Set it to NO to prevent # subgrouping. Alternatively, this can be done per class using the # \nosubgrouping command. # The default value is: YES. SUBGROUPING = YES # When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions # are shown inside the group in which they are included (e.g. using \ingroup) # instead of on a separate page (for HTML and Man pages) or section (for LaTeX # and RTF). # # Note that this feature does not work in combination with # SEPARATE_MEMBER_PAGES. # The default value is: NO. INLINE_GROUPED_CLASSES = NO # When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions # with only public data fields or simple typedef fields will be shown inline in # the documentation of the scope in which they are defined (i.e. file, # namespace, or group documentation), provided this scope is documented. If set # to NO, structs, classes, and unions are shown on a separate page (for HTML and # Man pages) or section (for LaTeX and RTF). # The default value is: NO. INLINE_SIMPLE_STRUCTS = NO # When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or # enum is documented as struct, union, or enum with the name of the typedef. So # typedef struct TypeS {} TypeT, will appear in the documentation as a struct # with name TypeT. When disabled the typedef will appear as a member of a file, # namespace, or class. And the struct will be named TypeS. This can typically be # useful for C code in case the coding convention dictates that all compound # types are typedef'ed and only the typedef is referenced, never the tag name. # The default value is: NO. TYPEDEF_HIDES_STRUCT = NO # The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This # cache is used to resolve symbols given their name and scope. Since this can be # an expensive process and often the same symbol appears multiple times in the # code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small # doxygen will become slower. If the cache is too large, memory is wasted. The # cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range # is 0..9, the default is 0, corresponding to a cache size of 2^16=65536 # symbols. At the end of a run doxygen will report the cache usage and suggest # the optimal cache size from a speed point of view. # Minimum value: 0, maximum value: 9, default value: 0. LOOKUP_CACHE_SIZE = 0 # The NUM_PROC_THREADS specifies the number threads doxygen is allowed to use # during processing. When set to 0 doxygen will based this on the number of # cores available in the system. You can set it explicitly to a value larger # than 0 to get more control over the balance between CPU load and processing # speed. At this moment only the input processing can be done using multiple # threads. Since this is still an experimental feature the default is set to 1, # which efficively disables parallel processing. Please report any issues you # encounter. Generating dot graphs in parallel is controlled by the # DOT_NUM_THREADS setting. # Minimum value: 0, maximum value: 32, default value: 1. NUM_PROC_THREADS = 8 #--------------------------------------------------------------------------- # Build related configuration options #--------------------------------------------------------------------------- # If the EXTRACT_ALL tag is set to YES, doxygen will assume all entities in # documentation are documented, even if no documentation was available. Private # class members and static file members will be hidden unless the # EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES. # Note: This will also disable the warnings about undocumented members that are # normally produced when WARNINGS is set to YES. # The default value is: NO. EXTRACT_ALL = NO # If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will # be included in the documentation. # The default value is: NO. EXTRACT_PRIVATE = NO # If the EXTRACT_PRIV_VIRTUAL tag is set to YES, documented private virtual # methods of a class will be included in the documentation. # The default value is: NO. EXTRACT_PRIV_VIRTUAL = NO # If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal # scope will be included in the documentation. # The default value is: NO. EXTRACT_PACKAGE = NO # If the EXTRACT_STATIC tag is set to YES, all static members of a file will be # included in the documentation. # The default value is: NO. EXTRACT_STATIC = YES # If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined # locally in source files will be included in the documentation. If set to NO, # only classes defined in header files are included. Does not have any effect # for Java sources. # The default value is: YES. EXTRACT_LOCAL_CLASSES = YES # This flag is only useful for Objective-C code. If set to YES, local methods, # which are defined in the implementation section but not in the interface are # included in the documentation. If set to NO, only methods in the interface are # included. # The default value is: NO. EXTRACT_LOCAL_METHODS = NO # If this flag is set to YES, the members of anonymous namespaces will be # extracted and appear in the documentation as a namespace called # 'anonymous_namespace{file}', where file will be replaced with the base name of # the file that contains the anonymous namespace. By default anonymous namespace # are hidden. # The default value is: NO. EXTRACT_ANON_NSPACES = NO # If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all # undocumented members inside documented classes or files. If set to NO these # members will be included in the various overviews, but no documentation # section is generated. This option has no effect if EXTRACT_ALL is enabled. # The default value is: NO. HIDE_UNDOC_MEMBERS = NO # If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all # undocumented classes that are normally visible in the class hierarchy. If set # to NO, these classes will be included in the various overviews. This option # has no effect if EXTRACT_ALL is enabled. # The default value is: NO. HIDE_UNDOC_CLASSES = NO # If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend # declarations. If set to NO, these declarations will be included in the # documentation. # The default value is: NO. HIDE_FRIEND_COMPOUNDS = YES # If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any # documentation blocks found inside the body of a function. If set to NO, these # blocks will be appended to the function's detailed documentation block. # The default value is: NO. HIDE_IN_BODY_DOCS = NO # The INTERNAL_DOCS tag determines if documentation that is typed after a # \internal command is included. If the tag is set to NO then the documentation # will be excluded. Set it to YES to include the internal documentation. # The default value is: NO. INTERNAL_DOCS = NO # If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file # names in lower-case letters. If set to YES, upper-case letters are also # allowed. This is useful if you have classes or files whose names only differ # in case and if your file system supports case sensitive file names. Windows # (including Cygwin) and Mac users are advised to set this option to NO. # The default value is: system dependent. CASE_SENSE_NAMES = YES # If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with # their full class and namespace scopes in the documentation. If set to YES, the # scope will be hidden. # The default value is: NO. HIDE_SCOPE_NAMES = NO # If the HIDE_COMPOUND_REFERENCE tag is set to NO (default) then doxygen will # append additional text to a page's title, such as Class Reference. If set to # YES the compound reference will be hidden. # The default value is: NO. HIDE_COMPOUND_REFERENCE= NO # If the SHOW_HEADERFILE tag is set to YES then the documentation for a class # will show which file needs to be included to use the class. # The default value is: YES. SHOW_HEADERFILE = YES # If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of # the files that are included by a file in the documentation of that file. # The default value is: YES. SHOW_INCLUDE_FILES = YES # If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each # grouped member an include statement to the documentation, telling the reader # which file to include in order to use the member. # The default value is: NO. SHOW_GROUPED_MEMB_INC = NO # If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include # files with double quotes in the documentation rather than with sharp brackets. # The default value is: NO. FORCE_LOCAL_INCLUDES = NO # If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the # documentation for inline members. # The default value is: YES. INLINE_INFO = YES # If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the # (detailed) documentation of file and class members alphabetically by member # name. If set to NO, the members will appear in declaration order. # The default value is: YES. SORT_MEMBER_DOCS = YES # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief # descriptions of file, namespace and class members alphabetically by member # name. If set to NO, the members will appear in declaration order. Note that # this will also influence the order of the classes in the class list. # The default value is: NO. SORT_BRIEF_DOCS = NO # If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the # (brief and detailed) documentation of class members so that constructors and # destructors are listed first. If set to NO the constructors will appear in the # respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS. # Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief # member documentation. # Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting # detailed member documentation. # The default value is: NO. SORT_MEMBERS_CTORS_1ST = NO # If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy # of group names into alphabetical order. If set to NO the group names will # appear in their defined order. # The default value is: NO. SORT_GROUP_NAMES = NO # If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by # fully-qualified names, including namespaces. If set to NO, the class list will # be sorted only by class name, not including the namespace part. # Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. # Note: This option applies only to the class list, not to the alphabetical # list. # The default value is: NO. SORT_BY_SCOPE_NAME = NO # If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper # type resolution of all parameters of a function it will reject a match between # the prototype and the implementation of a member function even if there is # only one candidate or it is obvious which candidate to choose by doing a # simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still # accept a match between prototype and implementation in such cases. # The default value is: NO. STRICT_PROTO_MATCHING = NO # The GENERATE_TODOLIST tag can be used to enable (YES) or disable (NO) the todo # list. This list is created by putting \todo commands in the documentation. # The default value is: YES. GENERATE_TODOLIST = YES # The GENERATE_TESTLIST tag can be used to enable (YES) or disable (NO) the test # list. This list is created by putting \test commands in the documentation. # The default value is: YES. GENERATE_TESTLIST = YES # The GENERATE_BUGLIST tag can be used to enable (YES) or disable (NO) the bug # list. This list is created by putting \bug commands in the documentation. # The default value is: YES. GENERATE_BUGLIST = YES # The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or disable (NO) # the deprecated list. This list is created by putting \deprecated commands in # the documentation. # The default value is: YES. GENERATE_DEPRECATEDLIST= YES # The ENABLED_SECTIONS tag can be used to enable conditional documentation # sections, marked by \if ... \endif and \cond # ... \endcond blocks. ENABLED_SECTIONS = # The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the # initial value of a variable or macro / define can have for it to appear in the # documentation. If the initializer consists of more lines than specified here # it will be hidden. Use a value of 0 to hide initializers completely. The # appearance of the value of individual variables and macros / defines can be # controlled using \showinitializer or \hideinitializer command in the # documentation regardless of this setting. # Minimum value: 0, maximum value: 10000, default value: 30. MAX_INITIALIZER_LINES = 30 # Set the SHOW_USED_FILES tag to NO to disable the list of files generated at # the bottom of the documentation of classes and structs. If set to YES, the # list will mention the files that were used to generate the documentation. # The default value is: YES. SHOW_USED_FILES = YES # Set the SHOW_FILES tag to NO to disable the generation of the Files page. This # will remove the Files entry from the Quick Index and from the Folder Tree View # (if specified). # The default value is: YES. SHOW_FILES = YES # Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces # page. This will remove the Namespaces entry from the Quick Index and from the # Folder Tree View (if specified). # The default value is: YES. SHOW_NAMESPACES = YES # The FILE_VERSION_FILTER tag can be used to specify a program or script that # doxygen should invoke to get the current version for each file (typically from # the version control system). Doxygen will invoke the program by executing (via # popen()) the command command input-file, where command is the value of the # FILE_VERSION_FILTER tag, and input-file is the name of an input file provided # by doxygen. Whatever the program writes to standard output is used as the file # version. For an example see the documentation. FILE_VERSION_FILTER = # The LAYOUT_FILE tag can be used to specify a layout file which will be parsed # by doxygen. The layout file controls the global structure of the generated # output files in an output format independent way. To create the layout file # that represents doxygen's defaults, run doxygen with the -l option. You can # optionally specify a file name after the option, if omitted DoxygenLayout.xml # will be used as the name of the layout file. # # Note that if you run doxygen from a directory containing a file called # DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE # tag is left empty. LAYOUT_FILE = # The CITE_BIB_FILES tag can be used to specify one or more bib files containing # the reference definitions. This must be a list of .bib files. The .bib # extension is automatically appended if omitted. This requires the bibtex tool # to be installed. See also https://en.wikipedia.org/wiki/BibTeX for more info. # For LaTeX the style of the bibliography can be controlled using # LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the # search path. See also \cite for info how to create references. CITE_BIB_FILES = #--------------------------------------------------------------------------- # Configuration options related to warning and progress messages #--------------------------------------------------------------------------- # The QUIET tag can be used to turn on/off the messages that are generated to # standard output by doxygen. If QUIET is set to YES this implies that the # messages are off. # The default value is: NO. QUIET = NO # The WARNINGS tag can be used to turn on/off the warning messages that are # generated to standard error (stderr) by doxygen. If WARNINGS is set to YES # this implies that the warnings are on. # # Tip: Turn warnings on while writing the documentation. # The default value is: YES. WARNINGS = YES # If the WARN_IF_UNDOCUMENTED tag is set to YES then doxygen will generate # warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag # will automatically be disabled. # The default value is: YES. WARN_IF_UNDOCUMENTED = NO # If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for # potential errors in the documentation, such as not documenting some parameters # in a documented function, or documenting parameters that don't exist or using # markup commands wrongly. # The default value is: YES. WARN_IF_DOC_ERROR = YES # This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that # are documented, but have no documentation for their parameters or return # value. If set to NO, doxygen will only warn about wrong or incomplete # parameter documentation, but not about the absence of documentation. If # EXTRACT_ALL is set to YES then this flag will automatically be disabled. # The default value is: NO. WARN_NO_PARAMDOC = NO # If the WARN_AS_ERROR tag is set to YES then doxygen will immediately stop when # a warning is encountered. # The default value is: NO. WARN_AS_ERROR = NO # The WARN_FORMAT tag determines the format of the warning messages that doxygen # can produce. The string should contain the $file, $line, and $text tags, which # will be replaced by the file and line number from which the warning originated # and the warning text. Optionally the format may contain $version, which will # be replaced by the version of the file (if it could be obtained via # FILE_VERSION_FILTER) # The default value is: $file:$line: $text. WARN_FORMAT = "$file:$line: $text" # The WARN_LOGFILE tag can be used to specify a file to which warning and error # messages should be written. If left blank the output is written to standard # error (stderr). WARN_LOGFILE = $(LIEF_DOXYGEN_WARN_FILE) #--------------------------------------------------------------------------- # Configuration options related to the input files #--------------------------------------------------------------------------- # The INPUT tag is used to specify the files and/or directories that contain # documented source files. You may enter file names like myfile.cpp or # directories like /usr/src/myproject. Separate the files or directories with # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING # Note: If this tag is empty the current directory is searched. INPUT = $(LIEF_INPUT) # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses # libiconv (or the iconv built into libc) for the transcoding. See the libiconv # documentation (see: https://www.gnu.org/software/libiconv/) for the list of # possible encodings. # The default value is: UTF-8. INPUT_ENCODING = UTF-8 # If the value of the INPUT tag contains directories, you can use the # FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and # *.h) to filter out the source-files in the directories. # # Note that for custom extensions or not directly supported extensions you also # need to set EXTENSION_MAPPING for the extension otherwise the files are not # read by doxygen. # # If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp, # *.c++, *.java, *.ii, *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, # *.hh, *.hxx, *.hpp, *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, # *.m, *.markdown, *.md, *.mm, *.dox (to be provided as doxygen C comment), # *.doc (to be provided as doxygen C comment), *.txt (to be provided as doxygen # C comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f18, *.f, *.for, *.vhd, # *.vhdl, *.ucf, *.qsf and *.ice. FILE_PATTERNS = *.c \ *.cc \ *.cxx \ *.cpp \ *.c++ \ *.java \ *.ii \ *.ixx \ *.ipp \ *.i++ \ *.inl \ *.idl \ *.ddl \ *.def \ *.odl \ *.h \ *.hh \ *.hxx \ *.hpp \ *.h++ \ *.cs \ *.d \ *.php \ *.php4 \ *.php5 \ *.phtml \ *.inc \ *.m \ *.markdown \ *.md \ *.mm \ *.dox \ *.doc \ *.txt \ *.py \ *.pyw \ *.tcc \ *.f90 \ *.f95 \ *.f03 \ *.f08 \ *.f18 \ *.f \ *.for \ *.vhd \ *.vhdl \ *.ucf \ *.qsf \ *.ice # The RECURSIVE tag can be used to specify whether or not subdirectories should # be searched for input files as well. # The default value is: NO. RECURSIVE = YES # The EXCLUDE tag can be used to specify files and/or directories that should be # excluded from the INPUT source files. This way you can easily exclude a # subdirectory from a directory tree whose root is specified with the INPUT tag. # # Note that relative paths are relative to the directory from which doxygen is # run. EXCLUDE = $(LIEF_EXCLUDE) # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or # directories that are symbolic links (a Unix file system feature) are excluded # from the input. # The default value is: NO. EXCLUDE_SYMLINKS = NO # If the value of the INPUT tag contains directories, you can use the # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude # certain files from those directories. # # Note that the wildcards are matched against the file with absolute path, so to # exclude all test directories for example use the pattern */test/* EXCLUDE_PATTERNS = # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names # (namespaces, classes, functions, etc.) that should be excluded from the # output. The symbol name can be a fully qualified name, a word, or if the # wildcard * is used, a substring. Examples: ANamespace, AClass, # AClass::ANamespace, ANamespace::*Test # # Note that the wildcards are matched against the file with absolute path, so to # exclude all test directories use the pattern */test/* EXCLUDE_SYMBOLS = # The EXAMPLE_PATH tag can be used to specify one or more files or directories # that contain example code fragments that are included (see the \include # command). EXAMPLE_PATH = # If the value of the EXAMPLE_PATH tag contains directories, you can use the # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and # *.h) to filter out the source-files in the directories. If left blank all # files are included. EXAMPLE_PATTERNS = * # If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be # searched for input files to be used with the \include or \dontinclude commands # irrespective of the value of the RECURSIVE tag. # The default value is: NO. EXAMPLE_RECURSIVE = NO # The IMAGE_PATH tag can be used to specify one or more files or directories # that contain images that are to be included in the documentation (see the # \image command). IMAGE_PATH = # The INPUT_FILTER tag can be used to specify a program that doxygen should # invoke to filter for each input file. Doxygen will invoke the filter program # by executing (via popen()) the command: # # # # where is the value of the INPUT_FILTER tag, and is the # name of an input file. Doxygen will then use the output that the filter # program writes to standard output. If FILTER_PATTERNS is specified, this tag # will be ignored. # # Note that the filter must not add or remove lines; it is applied before the # code is scanned, but not when the output code is generated. If lines are added # or removed, the anchors will not be placed correctly. # # Note that for custom extensions or not directly supported extensions you also # need to set EXTENSION_MAPPING for the extension otherwise the files are not # properly processed by doxygen. INPUT_FILTER = # The FILTER_PATTERNS tag can be used to specify filters on a per file pattern # basis. Doxygen will compare the file name with each pattern and apply the # filter if there is a match. The filters are a list of the form: pattern=filter # (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how # filters are used. If the FILTER_PATTERNS tag is empty or if none of the # patterns match the file name, INPUT_FILTER is applied. # # Note that for custom extensions or not directly supported extensions you also # need to set EXTENSION_MAPPING for the extension otherwise the files are not # properly processed by doxygen. FILTER_PATTERNS = # If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using # INPUT_FILTER) will also be used to filter the input files that are used for # producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES). # The default value is: NO. FILTER_SOURCE_FILES = NO # The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file # pattern. A pattern will override the setting for FILTER_PATTERN (if any) and # it is also possible to disable source filtering for a specific pattern using # *.ext= (so without naming a filter). # This tag requires that the tag FILTER_SOURCE_FILES is set to YES. FILTER_SOURCE_PATTERNS = # If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that # is part of the input, its contents will be placed on the main page # (index.html). This can be useful if you have a project on for instance GitHub # and want to reuse the introduction page also for the doxygen output. USE_MDFILE_AS_MAINPAGE = doxygen_index.md #--------------------------------------------------------------------------- # Configuration options related to source browsing #--------------------------------------------------------------------------- # If the SOURCE_BROWSER tag is set to YES then a list of source files will be # generated. Documented entities will be cross-referenced with these sources. # # Note: To get rid of all source code in the generated output, make sure that # also VERBATIM_HEADERS is set to NO. # The default value is: NO. SOURCE_BROWSER = NO # Setting the INLINE_SOURCES tag to YES will include the body of functions, # classes and enums directly into the documentation. # The default value is: NO. INLINE_SOURCES = NO # Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any # special comment blocks from generated source code fragments. Normal C, C++ and # Fortran comments will always remain visible. # The default value is: YES. STRIP_CODE_COMMENTS = YES # If the REFERENCED_BY_RELATION tag is set to YES then for each documented # entity all documented functions referencing it will be listed. # The default value is: NO. REFERENCED_BY_RELATION = NO # If the REFERENCES_RELATION tag is set to YES then for each documented function # all documented entities called/used by that function will be listed. # The default value is: NO. REFERENCES_RELATION = NO # If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set # to YES then the hyperlinks from functions in REFERENCES_RELATION and # REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will # link to the documentation. # The default value is: YES. REFERENCES_LINK_SOURCE = YES # If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the # source code will show a tooltip with additional information such as prototype, # brief description and links to the definition and documentation. Since this # will make the HTML file larger and loading of large files a bit slower, you # can opt to disable this feature. # The default value is: YES. # This tag requires that the tag SOURCE_BROWSER is set to YES. SOURCE_TOOLTIPS = YES # If the USE_HTAGS tag is set to YES then the references to source code will # point to the HTML generated by the htags(1) tool instead of doxygen built-in # source browser. The htags tool is part of GNU's global source tagging system # (see https://www.gnu.org/software/global/global.html). You will need version # 4.8.6 or higher. # # To use it do the following: # - Install the latest version of global # - Enable SOURCE_BROWSER and USE_HTAGS in the configuration file # - Make sure the INPUT points to the root of the source tree # - Run doxygen as normal # # Doxygen will invoke htags (and that will in turn invoke gtags), so these # tools must be available from the command line (i.e. in the search path). # # The result: instead of the source browser generated by doxygen, the links to # source code will now point to the output of htags. # The default value is: NO. # This tag requires that the tag SOURCE_BROWSER is set to YES. USE_HTAGS = NO # If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a # verbatim copy of the header file for each class for which an include is # specified. Set to NO to disable this. # See also: Section \class. # The default value is: YES. VERBATIM_HEADERS = YES #--------------------------------------------------------------------------- # Configuration options related to the alphabetical class index #--------------------------------------------------------------------------- # If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all # compounds will be generated. Enable this if the project contains a lot of # classes, structs, unions or interfaces. # The default value is: YES. ALPHABETICAL_INDEX = YES # In case all classes in a project start with a common prefix, all classes will # be put under the same header in the alphabetical index. The IGNORE_PREFIX tag # can be used to specify a prefix (or a list of prefixes) that should be ignored # while generating the index headers. # This tag requires that the tag ALPHABETICAL_INDEX is set to YES. IGNORE_PREFIX = #--------------------------------------------------------------------------- # Configuration options related to the HTML output #--------------------------------------------------------------------------- # If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output # The default value is: YES. GENERATE_HTML = YES # The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of # it. # The default directory is: html. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_OUTPUT = html # The HTML_FILE_EXTENSION tag can be used to specify the file extension for each # generated HTML page (for example: .htm, .php, .asp). # The default value is: .html. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_FILE_EXTENSION = .html # The HTML_HEADER tag can be used to specify a user-defined HTML header file for # each generated HTML page. If the tag is left blank doxygen will generate a # standard header. # # To get valid HTML the header file that includes any scripts and style sheets # that doxygen needs, which is dependent on the configuration options used (e.g. # the setting GENERATE_TREEVIEW). It is highly recommended to start with a # default header using # doxygen -w html new_header.html new_footer.html new_stylesheet.css # YourConfigFile # and then modify the file new_header.html. See also section "Doxygen usage" # for information on how to generate the default header that doxygen normally # uses. # Note: The header is subject to change so you typically have to regenerate the # default header when upgrading to a newer version of doxygen. For a description # of the possible markers and block names see the documentation. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_HEADER = # The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each # generated HTML page. If the tag is left blank doxygen will generate a standard # footer. See HTML_HEADER for more information on how to generate a default # footer and what special commands can be used inside the footer. See also # section "Doxygen usage" for information on how to generate the default footer # that doxygen normally uses. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_FOOTER = # The HTML_STYLESHEET tag can be used to specify a user-defined cascading style # sheet that is used by each HTML page. It can be used to fine-tune the look of # the HTML output. If left blank doxygen will generate a default style sheet. # See also section "Doxygen usage" for information on how to generate the style # sheet that doxygen normally uses. # Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as # it is more robust and this tag (HTML_STYLESHEET) will in the future become # obsolete. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_STYLESHEET = # The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined # cascading style sheets that are included after the standard style sheets # created by doxygen. Using this option one can overrule certain style aspects. # This is preferred over using HTML_STYLESHEET since it does not replace the # standard style sheet and is therefore more robust against future updates. # Doxygen will copy the style sheet files to the output directory. # Note: The order of the extra style sheet files is of importance (e.g. the last # style sheet in the list overrules the setting of the previous ones in the # list). For an example see the documentation. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_EXTRA_STYLESHEET = # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or # other source files which should be copied to the HTML output directory. Note # that these files will be copied to the base HTML output directory. Use the # $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these # files. In the HTML_STYLESHEET file, use the file name only. Also note that the # files will be copied as-is; there are no commands or markers available. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_EXTRA_FILES = # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen # will adjust the colors in the style sheet and background images according to # this color. Hue is specified as an angle on a colorwheel, see # https://en.wikipedia.org/wiki/Hue for more information. For instance the value # 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300 # purple, and 360 is red again. # Minimum value: 0, maximum value: 359, default value: 220. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_COLORSTYLE_HUE = 220 # The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors # in the HTML output. For a value of 0 the output will use grayscales only. A # value of 255 will produce the most vivid colors. # Minimum value: 0, maximum value: 255, default value: 100. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_COLORSTYLE_SAT = 100 # The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the # luminance component of the colors in the HTML output. Values below 100 # gradually make the output lighter, whereas values above 100 make the output # darker. The value divided by 100 is the actual gamma applied, so 80 represents # a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not # change the gamma. # Minimum value: 40, maximum value: 240, default value: 80. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_COLORSTYLE_GAMMA = 80 # If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML # page will contain the date and time when the page was generated. Setting this # to YES can help to show when doxygen was last run and thus if the # documentation is up to date. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_TIMESTAMP = NO # If the HTML_DYNAMIC_MENUS tag is set to YES then the generated HTML # documentation will contain a main index with vertical navigation menus that # are dynamically created via JavaScript. If disabled, the navigation index will # consists of multiple levels of tabs that are statically embedded in every HTML # page. Disable this option to support browsers that do not have JavaScript, # like the Qt help browser. # The default value is: YES. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_DYNAMIC_MENUS = YES # If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML # documentation will contain sections that can be hidden and shown after the # page has loaded. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_DYNAMIC_SECTIONS = NO # With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries # shown in the various tree structured indices initially; the user can expand # and collapse entries dynamically later on. Doxygen will expand the tree to # such a level that at most the specified number of entries are visible (unless # a fully collapsed tree already exceeds this amount). So setting the number of # entries 1 will produce a full collapsed tree by default. 0 is a special value # representing an infinite number of entries and will result in a full expanded # tree by default. # Minimum value: 0, maximum value: 9999, default value: 100. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_INDEX_NUM_ENTRIES = 100 # If the GENERATE_DOCSET tag is set to YES, additional index files will be # generated that can be used as input for Apple's Xcode 3 integrated development # environment (see: https://developer.apple.com/xcode/), introduced with OSX # 10.5 (Leopard). To create a documentation set, doxygen will generate a # Makefile in the HTML output directory. Running make will produce the docset in # that directory and running make install will install the docset in # ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at # startup. See https://developer.apple.com/library/archive/featuredarticles/Doxy # genXcode/_index.html for more information. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. GENERATE_DOCSET = NO # This tag determines the name of the docset feed. A documentation feed provides # an umbrella under which multiple documentation sets from a single provider # (such as a company or product suite) can be grouped. # The default value is: Doxygen generated docs. # This tag requires that the tag GENERATE_DOCSET is set to YES. DOCSET_FEEDNAME = "Doxygen generated docs" # This tag specifies a string that should uniquely identify the documentation # set bundle. This should be a reverse domain-name style string, e.g. # com.mycompany.MyDocSet. Doxygen will append .docset to the name. # The default value is: org.doxygen.Project. # This tag requires that the tag GENERATE_DOCSET is set to YES. DOCSET_BUNDLE_ID = org.doxygen.Project # The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify # the documentation publisher. This should be a reverse domain-name style # string, e.g. com.mycompany.MyDocSet.documentation. # The default value is: org.doxygen.Publisher. # This tag requires that the tag GENERATE_DOCSET is set to YES. DOCSET_PUBLISHER_ID = org.doxygen.Publisher # The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher. # The default value is: Publisher. # This tag requires that the tag GENERATE_DOCSET is set to YES. DOCSET_PUBLISHER_NAME = Publisher # If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three # additional HTML index files: index.hhp, index.hhc, and index.hhk. The # index.hhp is a project file that can be read by Microsoft's HTML Help Workshop # (see: https://www.microsoft.com/en-us/download/details.aspx?id=21138) on # Windows. # # The HTML Help Workshop contains a compiler that can convert all HTML output # generated by doxygen into a single compiled HTML file (.chm). Compiled HTML # files are now used as the Windows 98 help format, and will replace the old # Windows help format (.hlp) on all Windows platforms in the future. Compressed # HTML files also contain an index, a table of contents, and you can search for # words in the documentation. The HTML workshop also contains a viewer for # compressed HTML files. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. GENERATE_HTMLHELP = NO # The CHM_FILE tag can be used to specify the file name of the resulting .chm # file. You can add a path in front of the file if the result should not be # written to the html output directory. # This tag requires that the tag GENERATE_HTMLHELP is set to YES. CHM_FILE = # The HHC_LOCATION tag can be used to specify the location (absolute path # including file name) of the HTML help compiler (hhc.exe). If non-empty, # doxygen will try to run the HTML help compiler on the generated index.hhp. # The file has to be specified with full path. # This tag requires that the tag GENERATE_HTMLHELP is set to YES. HHC_LOCATION = # The GENERATE_CHI flag controls if a separate .chi index file is generated # (YES) or that it should be included in the main .chm file (NO). # The default value is: NO. # This tag requires that the tag GENERATE_HTMLHELP is set to YES. GENERATE_CHI = NO # The CHM_INDEX_ENCODING is used to encode HtmlHelp index (hhk), content (hhc) # and project file content. # This tag requires that the tag GENERATE_HTMLHELP is set to YES. CHM_INDEX_ENCODING = # The BINARY_TOC flag controls whether a binary table of contents is generated # (YES) or a normal table of contents (NO) in the .chm file. Furthermore it # enables the Previous and Next buttons. # The default value is: NO. # This tag requires that the tag GENERATE_HTMLHELP is set to YES. BINARY_TOC = NO # The TOC_EXPAND flag can be set to YES to add extra items for group members to # the table of contents of the HTML help documentation and to the tree view. # The default value is: NO. # This tag requires that the tag GENERATE_HTMLHELP is set to YES. TOC_EXPAND = NO # If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and # QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that # can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help # (.qch) of the generated HTML documentation. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. GENERATE_QHP = NO # If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify # the file name of the resulting .qch file. The path specified is relative to # the HTML output folder. # This tag requires that the tag GENERATE_QHP is set to YES. QCH_FILE = lief.qch # The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help # Project output. For more information please see Qt Help Project / Namespace # (see: https://doc.qt.io/archives/qt-4.8/qthelpproject.html#namespace). # The default value is: org.doxygen.Project. # This tag requires that the tag GENERATE_QHP is set to YES. QHP_NAMESPACE = org.lief # The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt # Help Project output. For more information please see Qt Help Project / Virtual # Folders (see: https://doc.qt.io/archives/qt-4.8/qthelpproject.html#virtual- # folders). # The default value is: doc. # This tag requires that the tag GENERATE_QHP is set to YES. QHP_VIRTUAL_FOLDER = liefdoc # If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom # filter to add. For more information please see Qt Help Project / Custom # Filters (see: https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom- # filters). # This tag requires that the tag GENERATE_QHP is set to YES. QHP_CUST_FILTER_NAME = # The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the # custom filter to add. For more information please see Qt Help Project / Custom # Filters (see: https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom- # filters). # This tag requires that the tag GENERATE_QHP is set to YES. QHP_CUST_FILTER_ATTRS = # The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this # project's filter section matches. Qt Help Project / Filter Attributes (see: # https://doc.qt.io/archives/qt-4.8/qthelpproject.html#filter-attributes). # This tag requires that the tag GENERATE_QHP is set to YES. QHP_SECT_FILTER_ATTRS = # The QHG_LOCATION tag can be used to specify the location of Qt's # qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the # generated .qhp file. # This tag requires that the tag GENERATE_QHP is set to YES. QHG_LOCATION = # If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be # generated, together with the HTML files, they form an Eclipse help plugin. To # install this plugin and make it available under the help contents menu in # Eclipse, the contents of the directory containing the HTML and XML files needs # to be copied into the plugins directory of eclipse. The name of the directory # within the plugins directory should be the same as the ECLIPSE_DOC_ID value. # After copying Eclipse needs to be restarted before the help appears. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. GENERATE_ECLIPSEHELP = NO # A unique identifier for the Eclipse help plugin. When installing the plugin # the directory name containing the HTML and XML files should also have this # name. Each documentation set should have its own identifier. # The default value is: org.doxygen.Project. # This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES. ECLIPSE_DOC_ID = org.doxygen.Project # If you want full control over the layout of the generated HTML pages it might # be necessary to disable the index and replace it with your own. The # DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top # of each HTML page. A value of NO enables the index and the value YES disables # it. Since the tabs in the index contain the same information as the navigation # tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. DISABLE_INDEX = NO # The GENERATE_TREEVIEW tag is used to specify whether a tree-like index # structure should be generated to display hierarchical information. If the tag # value is set to YES, a side panel will be generated containing a tree-like # index structure (just like the one that is generated for HTML Help). For this # to work a browser that supports JavaScript, DHTML, CSS and frames is required # (i.e. any modern browser). Windows users are probably better off using the # HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can # further fine-tune the look of the index. As an example, the default style # sheet generated by doxygen has an example that shows how to put an image at # the root of the tree instead of the PROJECT_NAME. Since the tree basically has # the same information as the tab index, you could consider setting # DISABLE_INDEX to YES when enabling this option. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. GENERATE_TREEVIEW = NO # The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that # doxygen will group on one line in the generated HTML documentation. # # Note that a value of 0 will completely suppress the enum values from appearing # in the overview section. # Minimum value: 0, maximum value: 20, default value: 4. # This tag requires that the tag GENERATE_HTML is set to YES. ENUM_VALUES_PER_LINE = 4 # If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used # to set the initial width (in pixels) of the frame in which the tree is shown. # Minimum value: 0, maximum value: 1500, default value: 250. # This tag requires that the tag GENERATE_HTML is set to YES. TREEVIEW_WIDTH = 250 # If the EXT_LINKS_IN_WINDOW option is set to YES, doxygen will open links to # external symbols imported via tag files in a separate window. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. EXT_LINKS_IN_WINDOW = NO # If the HTML_FORMULA_FORMAT option is set to svg, doxygen will use the pdf2svg # tool (see https://github.com/dawbarton/pdf2svg) or inkscape (see # https://inkscape.org) to generate formulas as SVG images instead of PNGs for # the HTML output. These images will generally look nicer at scaled resolutions. # Possible values are: png (the default) and svg (looks nicer but requires the # pdf2svg or inkscape tool). # The default value is: png. # This tag requires that the tag GENERATE_HTML is set to YES. HTML_FORMULA_FORMAT = png # Use this tag to change the font size of LaTeX formulas included as images in # the HTML documentation. When you change the font size after a successful # doxygen run you need to manually remove any form_*.png images from the HTML # output directory to force them to be regenerated. # Minimum value: 8, maximum value: 50, default value: 10. # This tag requires that the tag GENERATE_HTML is set to YES. FORMULA_FONTSIZE = 10 # Use the FORMULA_TRANSPARENT tag to determine whether or not the images # generated for formulas are transparent PNGs. Transparent PNGs are not # supported properly for IE 6.0, but are supported on all modern browsers. # # Note that when changing this option you need to delete any form_*.png files in # the HTML output directory before the changes have effect. # The default value is: YES. # This tag requires that the tag GENERATE_HTML is set to YES. FORMULA_TRANSPARENT = YES # The FORMULA_MACROFILE can contain LaTeX \newcommand and \renewcommand commands # to create new LaTeX commands to be used in formulas as building blocks. See # the section "Including formulas" for details. FORMULA_MACROFILE = # Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see # https://www.mathjax.org) which uses client side JavaScript for the rendering # instead of using pre-rendered bitmaps. Use this if you do not have LaTeX # installed or if you want to formulas look prettier in the HTML output. When # enabled you may also need to install MathJax separately and configure the path # to it using the MATHJAX_RELPATH option. # The default value is: NO. # This tag requires that the tag GENERATE_HTML is set to YES. USE_MATHJAX = NO # When MathJax is enabled you can set the default output format to be used for # the MathJax output. See the MathJax site (see: # http://docs.mathjax.org/en/latest/output.html) for more details. # Possible values are: HTML-CSS (which is slower, but has the best # compatibility), NativeMML (i.e. MathML) and SVG. # The default value is: HTML-CSS. # This tag requires that the tag USE_MATHJAX is set to YES. MATHJAX_FORMAT = HTML-CSS # When MathJax is enabled you need to specify the location relative to the HTML # output directory using the MATHJAX_RELPATH option. The destination directory # should contain the MathJax.js script. For instance, if the mathjax directory # is located at the same level as the HTML output directory, then # MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax # Content Delivery Network so you can quickly see the result without installing # MathJax. However, it is strongly recommended to install a local copy of # MathJax from https://www.mathjax.org before deployment. # The default value is: https://cdn.jsdelivr.net/npm/mathjax@2. # This tag requires that the tag USE_MATHJAX is set to YES. MATHJAX_RELPATH = https://cdn.jsdelivr.net/npm/mathjax@2 # The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax # extension names that should be enabled during MathJax rendering. For example # MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols # This tag requires that the tag USE_MATHJAX is set to YES. MATHJAX_EXTENSIONS = # The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces # of code that will be used on startup of the MathJax code. See the MathJax site # (see: http://docs.mathjax.org/en/latest/output.html) for more details. For an # example see the documentation. # This tag requires that the tag USE_MATHJAX is set to YES. MATHJAX_CODEFILE = # When the SEARCHENGINE tag is enabled doxygen will generate a search box for # the HTML output. The underlying search engine uses javascript and DHTML and # should work on any modern browser. Note that when using HTML help # (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET) # there is already a search function so this one should typically be disabled. # For large projects the javascript based search engine can be slow, then # enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to # search using the keyboard; to jump to the search box use + S # (what the is depends on the OS and browser, but it is typically # , /