
स्रोत कोड के ग्राफ डेटाबेस प्रतिनिधित्व का निर्माण और क्वेरी करें
# Trailmark
[](https://github.com/trailofbits/trailmark/actions/workflows/ci.yml)
[](https://github.com/trailofbits/trailmark/actions/workflows/mutation.yml)
Trailmark स्रोत कोड को फ़ंक्शन, टाइप, कॉल और अन्य संबंधों के ग्राफ़ में पार्स करता है, और फिर आपको इसके बारे में संरचनात्मक प्रश्न पूछने देता है:
- कौन से एंट्रीपॉइंट इस फ़ंक्शन तक पहुँच सकते हैं, और किन कॉल पथों से?
- दो कमिट्स के बीच अटैक सरफ़ेस में क्या बदला?
- कौन से फ़ंक्शन इस Solidity स्टोरेज वेरिएबल को लिखते हैं?
- कॉल रिज़ॉल्यूशन कहाँ रुका, जिससे रीचेबिलिटी परिणाम अपूर्ण हैं?
यह [समर्थित भाषाओं](https://github.com/trailofbits/trailmark#supported-languages) को
[tree-sitter](https://tree-sitter.github.io/) के माध्यम से पार्स करता है,
ग्राफ़ को [rustworkx](https://www.rustworkx.org/) में संग्रहीत करता है, और इसे
एक कमांड-लाइन टूल और एक Python API के माध्यम से उजागर करता है। Trailmark को सुरक्षा
समीक्षा के लिए बनाया गया था: प्रत्येक एज रिकॉर्ड करता है कि वह सीधे सिंटैक्स से आया है या
किसी ह्यूरिस्टिक से, और जिन कॉल्स को यह रिज़ॉल्व नहीं कर सका वे ग्राफ़ में बने रहते हैं।
दीर्घकालिक दृष्टि इस ग्राफ़ को म्यूटेशन टेस्टिंग और कवरेज-गाइडेड फ़ज़िंग के साथ जोड़कर
उन अंतरालों की पहचान करना है जो मान्यताओं और टेस्ट कवरेज के बीच हैं और जो उपयोगकर्ता इनपुट
से पहुँच योग्य हैं।
## विशेषताएँ
- **कोड ग्राफ़।** फ़ंक्शन, मेथड, क्लास, स्ट्रक्ट, ट्रेट, कॉन्ट्रैक्ट और
मॉड्यूल, जो कॉल, इनहेरिटेंस, कंटेनमेंट और टाइप उपयोग द्वारा जुड़े होते हैं।
`--language auto` किसी ट्री में समर्थित प्रत्येक भाषा को एक ही ग्राफ़ में मिला देता है।
- **अटैक सरफ़ेस।** फ़्रेमवर्क-जागरूक एंट्रीपॉइंट डिटेक्शन (Flask, FastAPI,
Spring, ASP.NET Core, actix-web, NestJS, Elysia HTTP रजिस्ट्रेशन, Solidity विज़िबिलिटी, और अधिक), प्रत्येक
ट्रस्ट लेवल और एसेट वैल्यू के साथ टैग किया गया। `.trailmark/entrypoints.toml` के साथ डिटेक्शन को ओवरराइड या विस्तारित करें।
- **एंट्रीपॉइंट साक्ष्य।** सोर्स प्रोवेनेंस के साथ कॉलेबल और डिक्लेरेटिव रेफ़रेंस, निष्पादन योग्य
फ़ाइल बॉडी, और अनसुलझे उम्मीदवारों का निरीक्षण करें। रेफ़रेंस निष्पादन से
अलग रहते हैं। स्पष्ट अपवर्जन के साथ अतिरिक्त सोर्स रूट चुनें।
- **रीचेबिलिटी।** प्रत्यक्ष कॉलर और कैली, ट्रांज़िटिव स्लाइस, और एंट्रीपॉइंट से किसी लक्ष्य तक
सीमित कॉल पाथ।
- **स्ट्रक्चरल डिफ़।** दो डायरेक्टरी या git ref की तुलना करें और जोड़े या
हटाए गए डिक्लेरेशन, सिग्नेचर और टाइप परिवर्तन, कॉल-एज कॉन्फ़िडेंस परिवर्तन,
और एंट्रीपॉइंट की रिपोर्ट करें।
- **डायग्राम।** Mermaid कॉल ग्राफ़, क्लास पदानुक्रम, मॉड्यूल निर्भरताएँ,
कंटेनमेंट व्यू, कॉम्प्लेक्सिटी मैप, और एंट्रीपॉइंट-से-लक्ष्य फ़्लो।
- **ग्राफ़ पर फ़ाइंडिंग्स।** SARIF और weAudit परिणाम आयात करें, अपने स्वयं के
एनोटेशन संलग्न करें, और प्रीएनालिसिस पास (ब्लास्ट रेडियस, प्रिविलेज बाउंड्रीज़,
कॉर्स टेन्ट) चलाएँ जो अपने परिणाम एनोटेशन और नामित सबग्राफ़ के रूप में संग्रहीत करते हैं।
- **दृश्यमान अंतराल।** जिन कॉल को सुलझाया नहीं जा सकता, वे गायब होने के बजाय
प्रॉक्सी नोड बन जाते हैं, और `trailmark analyze --resolution` उन्हें गिनता है।
- **अपवाद साक्ष्य।** `exception_events()` के साथ सोर्स-स्थित throws, rethrows, handlers और
cleanup सिंटैक्स का निरीक्षण करें; अज्ञात थ्रोन ऑपरेंड दृश्यमान रहते हैं। फ़्रंटएंड कवरेज और इस सिंटैक्स साक्ष्य की सीमाओं के लिए
[ग्राफ़ मॉडल](https://github.com/trailofbits/trailmark/blob/main/docs/graph-model.md#exception-evidence) देखें।
- **वे लिंक जो Trailmark नहीं देख सकता।** `.trailmark/links.toml` में RPC, FFI, और सबप्रोसेस एज
घोषित करें, या किसी बाइनरी-विश्लेषण टूल द्वारा उत्पादित कॉल ग्राफ़ आयात करें।
- **कंपाइल्ड बाइनरी साक्ष्य।** लिंक्ड ELF,
Mach-O, और PE इमेज का स्पष्ट रूप से निरीक्षण करें, सोर्स फ़ंक्शन और लाइनों को कंपाइल्ड रेंज से जोड़ें,
बाइनरी कॉल और अनुमानित टेल ट्रांसफ़र पुनःप्राप्त करें, और 15 आर्किटेक्चर/मोड केसों में
सीमित डिसअसेम्बली क्वेरी करें। इसमें स्ट्रिप्ड-कोड मैपिंग, यूनिवर्सल
स्लाइस, सत्यापित लोकल डीबग साथी, फ़ोल्डेड उपनाम, और नामित इम्पोर्ट
एंट्री शामिल हैं। वैकल्पिक `trailmark[binary]` एक्स्ट्रा और होस्ट-टूल आवश्यकताओं के लिए
[बाइनरी साक्ष्य](https://github.com/trailofbits/trailmark/blob/main/docs/binaries.md) देखें।
- **Solidity स्टोरेज एक्सेस।** फ़ंक्शन और उनके द्वारा स्पर्श किए जाने वाले
कॉन्ट्रैक्ट स्टेट वेरिएबल के बीच `reads` और `writes` एज।
## इंस्टॉल
```bash
uv tool install trailmark # the CLI
uv add trailmark # the library, in a uv-managed project
```
Python ≥ 3.12 आवश्यक है। CI, Python 3.12 से 3.15 तक का परीक्षण करता है।
Nix के साथ, `nix run github:trailofbits/trailmark` CLI को सीधे चलाता है।
यह README और गाइड `main` ब्रांच को ट्रैक करते हैं।
[changelog](https://github.com/trailofbits/trailmark/blob/main/CHANGELOG.md)
सूचीबद्ध करता है कि प्रत्येक प्रकाशित रिलीज़ में क्या शामिल है, और CLI तथा Python API गाइड
उस संस्करण को नोट करते हैं जिसने प्रत्येक नए फ़ीचर को जोड़ा।
अधिकांश grammars पहले उपयोग पर डाउनलोड और कैश किए जाते हैं। Bundled grammars
पहले उपयोग पर संकलित किए जाते हैं, जिसके लिए C कंपाइलर आवश्यक है। ऑफ़लाइन मशीनों,
TLS-निरीक्षण करने वाले proxies, और checkout से बिल्ड करने के लिए
[Installation](https://github.com/trailofbits/trailmark/blob/main/docs/installation.md) देखें।
Skills integrators: schema, identity, state, और reachability जाँचों के लिए
[v0.7 compatibility](https://github.com/trailofbits/trailmark/blob/main/docs/skills-compatibility.md) देखें।
## त्वरित शुरुआत
```bash
# Node and edge counts for a Python project (Python is the default language)
trailmark analyze --summary path/to/project
# The same summary as JSON, including source-file counts per language (v0.7+)
trailmark analyze --summary --json --language auto path/to/project
# Full JSON graph of every supported language in the tree
trailmark analyze --language auto path/to/project > graph.json
# Detected entrypoints with trust level and asset value
trailmark entrypoints --language auto path/to/project
# How the attack surface changed between two git refs
trailmark diff --repo . main HEAD
# Mermaid call graph around one function
trailmark diagram -t path/to/project -T call-graph -f handle_request
# How many call sites could not be resolved, grouped by callee name
trailmark analyze --language rust --resolution path/to/project
```
डायरेक्टरी विश्लेषण अनुपस्थित रूट्स और शून्य मिलान वाली स्रोत फ़ाइलों को अस्वीकार करता है। सारांश में चयनित भाषाएँ और निरीक्षित फ़ाइल गणनाएँ शामिल हैं; जानबूझकर खाली इनपुट के लिए `--allow-empty` का उपयोग करें।
ग्राफ़ JSON में निर्यात करने वाला Trailmark संस्करण और एक निर्यात स्कीमा संस्करण (v0.7+) शामिल है; समान Trailmark संस्करण और भाषाओं के साथ बनाए गए स्नैपशॉट की तुलना करें।
Python से वही प्रश्न:
```python
from trailmark.query.api import QueryEngine
engine = QueryEngine.from_directory("path/to/project", language="auto")
engine.attack_surface() # entrypoints and their trust levels
engine.callers_of("verify_signature") # direct callers
engine.ancestors_of("verify_signature") # everything that can reach it
engine.entrypoint_paths_to("verify_signature")
engine.complexity_hotspots(10) # cyclomatic complexity >= 10
```
नाम बेयर (`verify_signature`), क्वालिफाइड (`Auth.verify`), या पूर्ण नोड
ID (`auth:Auth.verify`) हो सकते हैं। क्वेरी परिणाम सादे dict और list होते हैं जो
सीधे JSON में सीरियलाइज़ होते हैं।
## यह कैसे काम करता है
```mermaid
flowchart LR
A["Source files"] --> B["tree-sitter parsers"]
B --> C["CodeGraph"]
C --> D["GraphStore (rustworkx)"]
D --> E["QueryEngine"]
E --> F["CLI / Python API"]
classDef src fill:#007bff26,stroke:#007bff,color:#007bff
classDef parse fill:#28a74526,stroke:#28a745,color:#28a745
classDef data fill:#6f42c126,stroke:#6f42c1,color:#6f42c1
classDef query fill:#ffc10726,stroke:#e6a817,color:#e6a817
class A src
class B parse
class C,D data
class E,F query
```
1. **पार्स करें।** प्रत्येक भाषा के लिए एक पार्सर निर्देशिका में चलता है और नोड्स
(फ़ंक्शन, प्रकार, मॉड्यूल), एज (कॉल, इनहेरिटेंस, कंटेनमेंट, इत्यादि),
और मेटाडेटा (पैरामीटर, रिटर्न प्रकार, ब्रांच, साइक्लोमैटिक कॉम्प्लेक्सिटी,
डॉकस्ट्रिंग्स, उठाए गए अपवाद) निकालता है। फिर एक लिंकिंग पास
फ़ाइलों के बीच कॉल्स को हल करता है, प्रकारों को उनके घोषणापत्रों से जोड़ता है, और `.trailmark/links.toml` लागू करता है।
2. **इंडेक्स करें।** `GraphStore` ग्राफ़ को तेज़ ट्रैवर्सल के लिए एक rustworkx निर्देशित ग्राफ़ में लोड करता है। `QueryEngine.from_directory()` एंट्रीपॉइंट डिटेक्शन भी चलाता है।
3. **क्वेरी करें।** `QueryEngine` नामों को नोड ID में हल करता है, ट्रैवर्सल चलाता है, और
JSON-सीरियलाइज़ेबल परिणाम लौटाता है।
### उदाहरण
`app.py` दिया गया है:
```python
class Auth:
def verify(self, token):
return self._check_sig(token)
def _check_sig(self, token): ...
def handle_request(req):
auth = Auth()
if auth.verify(req.token):
return process(req)
return deny()
def process(req): ...
def deny(): ...
```
Trailmark यह ग्राफ़ उत्पन्न करता है (मॉड्यूल कंटेनमेंट एज छोड़े गए हैं):
```mermaid
graph TD
HR["app:handle_request"] -->|calls| A["app:Auth"]
HR -->|calls| PV["proxy.unresolved:auth.verify"]
HR -->|calls| P["app:process"]
HR -->|calls| D["app:deny"]
AV["app:Auth.verify"] -->|calls| CS["app:Auth._check_sig"]
A -->|contains| AV
A -->|contains| CS
classDef fn fill:#007bff26,stroke:#007bff,color:#007bff
classDef cls fill:#6f42c126,stroke:#6f42c1,color:#6f42c1
classDef proxy fill:#dc354526,stroke:#dc3545,color:#dc3545
class HR,P,D fn
class A,AV,CS cls
class PV proxy
```
`self._check_sig(...)` इसलिए हल हो जाता है क्योंकि `self` संलग्न क्लास का नाम है।
`auth.verify(...)` नहीं होता, क्योंकि Trailmark यह अनुमान नहीं लगाता कि स्थानीय
वेरिएबल `auth` में एक `Auth` है। कॉल को हटाने के बजाय एक प्रॉक्सी नोड के रूप में रखा जाता है। परिणामस्वरूप, `engine.ancestors_of("Auth._check_sig")` केवल
`app:Auth.verify` लौटाता है, और `engine.unresolved_calls("handle_request")` उस सटीक कॉल साइट को दिखाता है जहाँ पथ खो गया था। प्रत्येक नोड प्रकार, एज प्रकार, और ID नियम के लिए
[Graph model](https://github.com/trailofbits/trailmark/blob/main/docs/graph-model.md)
देखें, और प्रॉक्सी के साथ काम करने के लिए
[Call resolution](https://github.com/trailofbits/trailmark/blob/main/docs/call-resolution.md)
देखें।
## समर्थित भाषाएँ
| भाषा | एक्सटेंशन | `--language` | निकालता है |
| --- | --- | --- | --- |
| Python | `.py` | `python` | फ़ंक्शन, क्लास, मेथड |
| R | `.r` | `r` | नामित/अनाम फ़ंक्शन, क्लोज़र, डिफ़ॉल्ट, शाखाएँ, कॉल, पैकेज/स्रोत निर्भरताएँ |
| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | `javascript` | फ़ंक्शन, क्लास, एरो फ़ंक्शन |
| TypeScript | `.ts`, `.tsx` | `typescript` | फ़ंक्शन, क्लास, इंटरफ़ेस, एनम |
| PHP | `.php`, `.phtml` | `php` | फ़ंक्शन, क्लास, इंटरफ़ेस, ट्रेट, स्क्रिप्ट/टेम्पलेट बॉडी, पाइप कॉल और आंशिक कॉलेबल संदर्भ |
| Perl | `.pl`, `.pm` | `perl` | पैकेज, सबरूटीन, सिग्नेचर/प्रोटोटाइप, अनाम सब, स्क्रिप्ट कॉल, इम्पोर्ट |
| Ruby | `.rb` | `ruby` | मेथड, क्लास, मॉड्यूल |
| Lua | `.lua` | `lua` | लोकल/ग्लोबल फ़ंक्शन, टेबल मेथड, अनाम फ़ंक्शन, चंक, इम्पोर्ट, सीधी कॉल |
| C | `.c`, `.h` | `c` | फ़ंक्शन, स्ट्रक्ट, एनम |
| Bash | `.sh`, `.bash` | `bash` | फ़ंक्शन, स्क्रिप्ट निष्पादन, शाखाएँ, कमांड, लिटरल स्रोत निर्भरताएँ |
| C++ | `.cpp`, `.cc`, `.cxx`, `.hpp`, `.hh`, `.hxx` | `cpp` | फ़ंक्शन, क्लास, स्ट्रक्ट, नेमस्पेस |
| C# | `.cs` | `c_sharp` | मेथड, क्लास, इंटरफ़ेस, स्ट्रक्ट, एनम, नेमस्पेस |
| PowerShell | `.ps1`, `.psm1` | `powershell` | फ़ंक्शन, फ़िल्टर, क्लास, मेथड, स्क्रिप्ट ब्लॉक, पैरामीटर, कमांड कॉल, इम्पोर्ट |
| Java | `.java` | `java` | मेथड, क्लास, इंटरफ़ेस, एनम |
| VB.NET | `.vb` | `vb` | नेमस्पेस, मॉड्यूल, टाइप, मेथड, कंस्ट्रक्टर/एक्सेसर, लैम्ब्डा, ओवरलोड, सीधी कॉल |
| Go | `.go` | `go` | फ़ंक्शन, मेथड, स्ट्रक्ट, इंटरफ़ेस |
| Rust | `.rs` | `rust` | फ़ंक्शन, स्ट्रक्ट, ट्रेट, एनम, impl ब्लॉक, `verus!` ब्लॉक |
| Solidity | `.sol` | `solidity` | कॉन्ट्रैक्ट, इंटरफ़ेस, लाइब्रेरी, फ़ंक्शन, मॉडिफ़ायर, स्ट्रक्ट, एनम, स्टेट वेरिएबल |
| Aiken | `.ak` | `aiken` | वैलिडेटर, हैंडलर, हेल्पर फ़ंक्शन, कस्टम टाइप, इम्पोर्ट, सीधी और पाइपलाइन कॉल |
| Cairo | `.cairo` | `cairo` | फ़ंक्शन, ट्रेट, स्ट्रक्ट, एनम, impl ब्लॉक, StarkNet कॉन्ट्रैक्ट |
| Circom | `.circom` | `circom` | टेम्पलेट, फ़ंक्शन, सिग्नल, कंपोनेंट |
| Haskell | `.hs` | `haskell` | फ़ंक्शन, डेटा टाइप, टाइप क्लास, इंस्टेंस |
| Lean 4 | `.lean` | `lean` | परिभाषाएँ, प्रमेय, नेमस्पेस, स्ट्रक्चर, क्लास, इंडक्टिव टाइप, इम्पोर्ट, टर्म एप्लिकेशन, स्पष्ट सिंबल और टाइप्ड फ़ील्ड संदर्भ |
| Dafny | `.dfy` | `dafny` | मॉड्यूल, क्लास, डेटाटाइप, फ़ंक्शन, मेथड, लेम्मा, कॉन्ट्रैक्ट और स्पष्ट संदर्भ |
| F* | `.fst`, `.fsti` | `fstar` | डिक्लेरेशन, इंटरफ़ेस, रिफ़ाइनमेंट, मॉड्यूल इम्पोर्ट, स्पष्ट संदर्भ और कम्प्यूटेशनल एप्लिकेशन |
| Rocq/Coq | `.v` | `rocq` | Gallina डिक्लेरेशन, मॉड्यूल, अनुमान, प्रमेय कथन और स्पष्ट संदर्भ; `rocq` को स्पष्ट रूप से चुनें |
| WhyML | `.mlw`, `.why` | `whyml` | मॉड्यूल और अंतर्निहित फ़ाइल मॉड्यूल, प्रोग्राम, ऐरे, घोस्ट कोड, कॉन्ट्रैक्ट और स्पष्ट संदर्भ (आंशिक सिंटैक्स कवरेज) |
| TLA+ | `.tla` | `tlaplus` | मॉड्यूल, स्टेट वेरिएबल, ऑपरेटर, अनुमान, प्रमेय और स्पेसिफ़िकेशन संदर्भ |
| Tamarin | `.spthy` | `tamarin` | नियम, फ़ंक्शन और फ़ैक्ट सिंबल, मैक्रो, प्रेडिकेट, इन्क्लूड, कंडीशनल और स्पेसिफ़िकेशन संदर्भ |
| ProVerif | `.pv`, `.pvl` | `proverif` | टाइप्ड pi-calculus फ़ंक्शन, इवेंट, प्रोसेस, क्वेरी और सिंबॉलिक संदर्भ |
| Julia | `.jl` | `julia` | मॉड्यूल, टाइप, लंबे/छोटे फ़ंक्शन, क्लोज़र, सिग्नेचर, शाखाएँ, इम्पोर्ट, रूढ़िवादी लोकल कॉल |
| Erlang | `.erl` | `erlang` | फ़ंक्शन, रिकॉर्ड, बिहेवियर, मॉड्यूल |
| Miden Assembly | `.masm` | `masm` | प्रोसीजर, एंट्रीपॉइंट, कॉन्स्टेंट, इन्वोकेशन |
| Swift | `.swift` | `swift` | फ़ंक्शन, क्लास, स्ट्रक्ट, एनम, प्रोटोकॉल, एक्सटेंशन |
| Objective-C | `.m`, `.mm`, `.h` | `objc` | C फ़ंक्शन, क्लास, मेथड (सेलेक्टर-आधारित नामकरण) |
| Kotlin | `.kt`, `.kts` | `kotlin` | फ़ंक्शन, क्लास, इंटरफ़ेस, डेटा क्लास, ऑब्जेक्ट, मेथड |
| Dart | `.dart` | `dart` | फ़ंक्शन, क्लास, एब्सट्रैक्ट क्लास, मेथड, कंस्ट्रक्टर |
| Move | `.move` | `move` | मॉड्यूल, फ़ंक्शन, इम्पोर्ट, सीधे कॉल |
| Tact | `.tact` | `tact` | कॉन्ट्रैक्ट, स्ट्रक्ट, रिसीवर, फ़ंक्शन |
| Func | `.fc`, `.func` | `func` | फ़ंक्शन, इन्क्लूड, सीधे कॉल |
| Sway | `.sw` | `sway` | ABI इंटरफ़ेस, स्ट्रक्ट, impl मेथड, फ़ंक्शन |
| Zig | `.zig` | `zig` | फ़ंक्शन, नामित स्ट्रक्ट/एनम/यूनियन, कंटेनर मेथड, इम्पोर्ट, सीधे कॉल |
| Rego | `.rego` | `rego` | पैकेज, इम्पोर्ट, पॉलिसी नियम, नियम कॉल |
| Proto | `.proto` | `proto` | सेवाएँ, RPC, संदेश, फ़ील्ड, एनम |
| Thrift | `.thrift` | `thrift` | सेवाएँ, फ़ंक्शन, स्ट्रक्ट, फ़ील्ड, एनम |
| GraphQL | `.graphql`, `.gql`, `.graphqls` | `graphql` | ऑब्जेक्ट प्रकार, रूट ऑपरेशन, फ़ील्ड, एनम |
| SQL | `.sql` | `sql` | स्कीमा, टेबल, व्यू, फ़ंक्शन, प्रोसीजर |
भाषाओं का पता लगाने के लिए `--language auto` पास करें, या कॉमा से अलग की गई सूची जैसे
`--language python,rust`। [भाषा नोट्स](https://github.com/trailofbits/trailmark/blob/main/docs/languages.md)
Rust और Verus स्कोपिंग, Solidity स्टोरेज एक्सेस, हेडर हैंडलिंग, और
अन्य प्रति-भाषा व्यवहार को कवर करता है।
## दस्तावेज़ीकरण
| गाइड | यह क्या कवर करता है |
| --- | --- |
| [CLI संदर्भ](https://github.com/trailofbits/trailmark/blob/main/docs/cli.md) | प्रत्येक सबकमांड, फ़्लैग, और आउटपुट फ़ॉर्मेट |
| [Python API](https://github.com/trailofbits/trailmark/blob/main/docs/python-api.md) | `QueryEngine` मेथड्स, नाम लुकअप, पाथ क्वेरीज़, केवल-पार्स API |
| [ग्राफ़ मॉडल](https://github.com/trailofbits/trailmark/blob/main/docs/graph-model.md) | नोड और एज प्रकार, कॉन्फ़िडेंस, नोड ID, प्रॉक्सी, डायरेक्टरी वॉकिंग |
| [एंट्रीपॉइंट्स](https://github.com/trailofbits/trailmark/blob/main/docs/entrypoints.md) | डिटेक्शन लेयर्स, फ़्रेमवर्क कवरेज, `.trailmark/entrypoints.toml` |
| [क्रॉस-लैंग्वेज लिंक्स](https://github.com/trailofbits/trailmark/blob/main/docs/links.md) | RPC, FFI, और बाहरी एज के लिए `.trailmark/links.toml` |
| [फ़ाइंडिंग्स और प्रीएनालिसिस](https://github.com/trailofbits/trailmark/blob/main/docs/augmenting.md) | SARIF, weAudit, बाइनरी कॉल ग्राफ़, एनोटेशन, प्रीएनालिसिस पासेस |
| [कॉल रिज़ॉल्यूशन](https://github.com/trailofbits/trailmark/blob/main/docs/call-resolution.md) | अनरिज़ॉल्व्ड कॉल्स को मापना और रीचेबिलिटी के लिए उनका क्या अर्थ है |
| [भाषा नोट्स](https://github.com/trailofbits/trailmark/blob/main/docs/languages.md) | Rust और Verus, Solidity स्टेट, TypeScript, SQL, C-फ़ैमिली हेडर्स |
| [पार्सर कवरेज](https://github.com/trailofbits/trailmark/blob/main/docs/parser-coverage.md) | कॉलेबल ओनरशिप, डिक्लेरेशन आइडेंटिटी और ग्रामर सीमाएँ |
| [इंस्टॉलेशन](https://github.com/trailofbits/trailmark/blob/main/docs/installation.md) | ग्रामर कैशेस, ऑफ़लाइन इंस्टॉल, बंडल किए गए ग्रामर, Nix, चेकआउट्स |
| [चेंजलॉग](https://github.com/trailofbits/trailmark/blob/main/CHANGELOG.md) | प्रत्येक रिलीज़ में क्या बदला |
## एजेंट स्किल्स
[Trailmark प्लगइन](https://github.com/trailofbits/skills/tree/main/plugins/trailmark)
Trailmark वर्कफ़्लोज़ को एजेंट स्किल्स के रूप में पैकेज करता है, जिनमें कॉल-ग्राफ़
सारांश, डायग्राम जनरेशन, फ़ाइंडिंग ट्रायाज, और डिफ़रेंशियल रिव्यू शामिल हैं।
## सीमाएँ
Trailmark अपना ग्राफ़ सिंटैक्स और नामकरण से बनाता है। यह कोड को कंपाइल नहीं करता, इसलिए:
- पाथ कॉल-ग्राफ़ रीचेबिलिटी हैं, हमलावर-नियंत्रित डेटा फ़्लो नहीं।
प्रीएनालिसिस टेंट एक मोटा, अलग सिग्नल है।
- डायनामिक डिस्पैच, ऐसे ओवरलोड्स जिन्हें आर्ग्युमेंट प्रकार चाहिए, और ऐसे
रिसीवर्स के माध्यम से कॉल्स जिनका प्रकार अनुमानित करना पड़ेगा, अनरिज़ॉल्व्ड रहते हैं।
- मैक्रो हैंडलिंग आंशिक है: सीमित C डिक्लेरेशन रैपर्स को विस्तारित किया जा सकता है,
जबकि मनमाना प्रीप्रोसेसिंग और डिस्ट्रक्टर्स जैसी अंतर्निहित कॉल्स को मॉडल नहीं किया जाता।
- अनुपस्थित एज इस बात का प्रमाण नहीं है कि कोई कॉल या स्टोरेज एक्सेस नहीं हो सकता।
---
[Read more](https://github.com/trailofbits/trailmark)