Files
trailofbits-skills/plugins/c-review/prompts/linux-userspace/signal-handler-finder.md
T
Paweł Płatek 870955f1af C review (#156)
* init c review

* lsp

* agents -> prompts

* wip

* add windows, update judges

* improve

* upgrade

* size update

* rm toon format, improve workflow, cluster agents/prompts by issue type, improve prompt cache

* improve general workflow, fix bugs

* sarif via script, cluster manifest

* fix bugs

* fix workflow2

* workflow updates

* more fixes

* more fixes

* improvements

* update readme

* update codeowners

* update codeowners2

* fix small inconsistencies

* Address review feedback on c-review plugin

Critical:
- Move SKILL.md into named skill subdirectory (plugins/c-review/skills/c-review/)
  so plugin discovery and the Codex validator find it; add .codex/skills/c-review
  symlink.
- Convert allowed-tools in SKILL.md from YAML list to space-delimited string
  (spec compliance per #139).
- Fix parse_scalar in generate_sarif.py to respect quoted strings when splitting
  inline lists; ["a,b", c] no longer corrupts to ['"a', 'b"', 'c'].
- Fix location_parts trailing-colon handling so 'src/foo.c:' resolves to
  ('src/foo.c', 1) instead of keeping the colon in the filename.

Important:
- Convert agent tools: from YAML list to comma-separated string in worker,
  dedup-judge, fp-judge.
- Refactor build_run_plan.py main() (131 → 77 lines) by extracting
  _validate_run_inputs / _render_workers / _print_summary helpers.
- Fix ty possibly-missing-attribute warning by typing workers list explicitly.
- Add PEP 723 inline metadata + plugins/c-review/scripts/pyproject.toml.
- Rewrite SKILL.md description as scenario-based; add When to Use /
  When NOT to Use section headers.
- Add Usage section to README.
- Resolve Tier 2 contradiction in dedup-judge: unparseable/multi findings
  now skip Tier 2 and go straight to Tier 3.
- Standardize placeholder convention in fp-judge ({var} not <var>).
- Fix "Widthness Overflows" → "Width Truncation" in integer-overflow-finder.
- Standardize "Bug Patterns to Find" heading in signal-handler and
  thread-safety finders.
- Replace ls -1 glob in worker shard-write with find for shell portability.
- Bump version 1.1.0 → 1.1.1 in plugin.json + marketplace.json.

Verification: codex validator passes (73 plugin skills); ruff + ty clean;
main() 77 lines (limit 100); SARIF generator runtime tests pass; end-to-end
build_run_plan.py produces all 11 clusters with cache primer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Address claude[bot] review feedback on c-review

- Phase 1 is_posix/is_windows probes in SKILL.md now include C++ extensions
  (.cpp, .cxx, .cc, .hpp, .hh) in their --include lists. A pure C++ POSIX
  daemon was silently dropping ~17 POSIX-gated passes plus all is_windows
  clusters because pthread.h / windows.h includes only in .cpp/.hpp files
  failed both --include='*.c' --include='*.h' filters.
- generate_sarif.py informationUri points at trailofbits/skills (the actual
  repo) instead of trailofbits/tob-skills (404).
- CODEOWNERS: add @dguido co-owner to /plugins/c-review/ and move it to the
  top of the c* alphabetical group (- < l < o < u under ASCII collation).
- README.md: move c-review row after burpsuite-project-parser (b < c).
- Bump version 1.1.1 → 1.1.2.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Dan Guido <dan@trailofbits.com>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-03 15:59:55 -04:00

1.3 KiB

name, description
name description
signal-handler-finder Finds async-signal-unsafe function calls

Finding ID Prefix: SIGNAL (e.g., SIGNAL-001, SIGNAL-002)

Bug Patterns to Find (async-signal-unsafe operations):

  1. Memory Allocation

    • malloc, free, realloc, calloc
    • new, delete
  2. Standard I/O

    • printf, fprintf, sprintf
    • fopen, fclose, fread, fwrite
  3. Other Unsafe Functions

    • strtok, strerror
    • getpwnam, getgrnam
    • localtime, gmtime
  4. errno Modification

    • Any function that sets errno
    • errno not saved/restored in handler

Safe Functions (async-signal-safe):

  • write, read (raw syscalls)
  • _exit, abort
  • signal, sigaction (careful)
  • open, close (file descriptors)

Common False Positives to Avoid:

  • Handler only sets flag: Handler just sets volatile sig_atomic_t flag
  • Self-pipe trick: Handler writes to pipe, processing done elsewhere
  • signalfd used: Using signalfd for synchronous signal handling
  • Signals blocked: Unsafe code runs with signals blocked
  • errno saved/restored: Handler properly saves and restores errno

Search Patterns:

signal\s*\(|sigaction\s*\(|sighandler_t
SIG[A-Z]+\s*,|SIGINT|SIGTERM|SIGHUP|SIGUSR
malloc\s*\(|free\s*\(|printf\s*\(|fprintf\s*\(
errno\s*=|errno\s*$