glaurung

Record your work

glaurung rename

Give a recovered function a new name.

writes files or project state 2 worked examples

use it for

Manual names outrank automatic names. Use --by only when a script is recording a non-manual source such as dwarf, flirt, or auto.

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

input
A project, a function name or VA, and the new canonical name.
output
A project name with provenance plus an undo-log entry.
mode
writes state. Updates the function name and undo history.

command shape

syntax

short form 
$ glaurung rename PROJECT FUNCTION NAME [--binary PATH]

The installed parser is authoritative: glaurung rename --help

before the examples

project setup

The examples use the checked-in hello-c-clang-debug fixture and a project named hello.glaurung. 

$ glaurung kickoff samples/binaries/platforms/linux/amd64/export/native/clang/debug/hello-c-clang-debug --db hello.glaurung

run it

examples

Accept a name you verified

Manual names outrank automatic ones. Use one only after the surrounding instructions support it.

run

from the engine checkout 
$ glaurung rename hello.glaurung 0x1150 program_main --binary samples/binaries/platforms/linux/amd64/export/native/clang/debug/hello-c-clang-debug

output

captured result captured 2026-08-31 
0x1150 -> program_main  [manual]

captured 2026-08-31.

Read the result: The bracketed source is provenance. undo can restore the previous canonical name.

Record an imported symbol source

Automation should identify itself instead of claiming an analyst made the decision.

run

from the engine checkout 
$ glaurung rename hello.glaurung 0x11d0 print_sum --binary samples/binaries/platforms/linux/amd64/export/native/clang/debug/hello-c-clang-debug --by dwarf

output

captured result captured fixture output, 2026-08-31 
0x11d0 -> print_sum  [dwarf]

captured fixture output, 2026-08-31.

Read the result: The name already matches the fixture symbol, but the recorded provenance is now dwarf. Provenance matters when later imports or analyst names compete.

used above

important options

--binary PATH
Select the binary in a multi-binary project.
--by SOURCE
Record non-manual provenance such as dwarf, pdb, flirt, or auto.
--json
Print the resulting name record as JSON.

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

before you rely on it

checks

keep working

related commands

← all 40 commands