glaurung

Record your work

glaurung label

Name and type data at a virtual address.

writes files or project state 2 worked examples

use it for

Labels are for data addresses. Omit the name to inspect the current label; use --delete to remove it.

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

input
A project, data VA, optional name, and optional C type and size.
output
A named data address stored with provenance and undo history.
mode
writes state. Adding, changing, or deleting a label updates the project.

command shape

syntax

short form 
$ glaurung label PROJECT VA [NAME] [--type C_TYPE] [--size N]

The installed parser is authoritative: glaurung label --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

Name a string address

0x2004 is the greeting string in the checked-in fixture.

run

from the engine checkout 
$ glaurung label hello.glaurung 0x2004 greeting_format --type 'char[22]' --size 22 --binary samples/binaries/platforms/linux/amd64/export/native/clang/debug/hello-c-clang-debug

output

captured result captured 2026-08-31 
0x2004 -> greeting_format  [manual]

captured 2026-08-31.

Read the result: The name and type now reach project-aware views. The raw bytes remain the source of truth.

Inspect the stored label

Leave out the name to read without changing project state.

run

from the engine checkout 
$ glaurung label hello.glaurung 0x2004

output

captured result captured from a fresh kickoff project, 2026-08-31 
(no label at 0x2004)

captured from a fresh kickoff project, 2026-08-31.

Read the result: A fresh kickoff project has no analyst label here. Run the preceding write example first, then this lookup will return greeting_format and its type.

used above

important options

--type C_TYPE
Attach a C type to the data address.
--size N
Record the object's size in bytes.
--delete
Remove the label.
--by SOURCE
Record where the label came from.

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

before you rely on it

checks

keep working

related commands

← all 40 commands