name-func command

use it for

The model receives recovered context and returns a suggestion. Record an accepted name with rename so its provenance and undo history live in the project.

Run glaurung name-func --help on your installed version before putting the command in a script. Glaurung is still pre-1.0.

input: A binary, one function name or VA, configured model credentials, and optional original-name context.
output: A suggested name, confidence, summary, rationale, and model identifier. It does not write a project.
mode: model + local tools. The examples leave the input unchanged.

command shape

syntax

short form

$ glaurung name-func PATH --func NAME|VA

The installed parser is authoritative: glaurung name-func --help

run it

examples

Request a name with its rationale

JSON keeps the proposed name separate from confidence and evidence summary.

run

from the engine checkout

$ glaurung name-func samples/binaries/platforms/linux/amd64/export/native/clang/debug/hello-c-clang-debug --func 0x1150 --json

output

captured result captured model output, 2026-08-31, shortened

{
  "entry_va": 4432,
  "suggested_name": "print_hello_world_and_sum_arg_lengths_1150",
  "confidence": 0.95,
  "summary": "Prints a hello-world message, sums argument lengths, then passes the total to a helper.",
  "model": "openai:gpt-5.4-mini"
}

captured model output, 2026-08-31, shortened.

Read the result: The suggested name is too long for daily use, but the summary points to claims you can check. Accept a shorter verified name with rename.

Cache repeat work

A cache avoids paying again when the binary hash, function, model, and original-name hint are unchanged.

run

from the engine checkout

$ glaurung name-func samples/binaries/platforms/linux/amd64/export/native/clang/debug/hello-c-clang-debug --func main --original main --cache-dir .cache/glaurung-names

output

captured result captured model output, 2026-08-31; rationale shortened

suggested name: print_hello_world_and_sum_lengths_1150
confidence:     0.95
summary:        Prints a hello-world message, iterates over argv strings to accumulate their total length, then passes the sum to another function.
rationale:      The function prints a fixed literal, calls strlen in a loop bounded by argc, then calls print_sum and a static helper.
model:          openai:gpt-5.4-mini

captured model output, 2026-08-31; rationale shortened.

Read the result: The cache key includes the binary and hint, so a repeat can reuse this record. The proposed name remains a suggestion; verify it and choose a shorter working name before writing the project.

used above

important options

--func NAME|VA: Select one recovered function.
--original NAME: Pass a mangled or partial original name as soft context.
--cache-dir DIR: Reuse append-only results keyed by binary hash, VA, version, model, and hint.
--json: Return every suggestion field as JSON.

These are the flags used by the examples. Run glaurung name-func --help for the complete parser help.

keep working

related commands

← all 40 commands