Next: Miscellaneous commands, Previous: Command file commands, Up: Monitor [Contents][Index]

### 12.9 Label commands

`add_label <address> <label>`
`al <address> <label>`

  Map a given address to a label. This label can be used when entering assembly code and is shown during disassembly. Additionally, it can be used whenever an address must be specified.

  <label> is the name of the label; it must start with a dot (".") in order for the monitor to recognize it as a label.

`delete_label [<address_space>] <label>`
`dl [<address_space>] <label>`

  Remove the specified label from the label tables. If no address space is checked, all tables are checked.

`load_labels [<address_space>] "<filename>"`
`ll [<address_space>] "<filename>"`

  Load a file containing a mapping of labels to addresses. If no address space is specified, the default readspace is used.

  The file must contain commands the monitor understands, e.g. add_label. The compiler cc65 can create such label files.

  Vice can also load label files created by the Acme assembler. Their syntax is e.g. "labelname = $1234 ; Maybe a comment". A dot will be added automatically to label names assigned in this way to fit to the Vice label syntax. Normally the semicolon seperates commands but after an assignment of this kind it may be used to start a comment to end of line, so unchanged Acme label files can be fed into Vice.

`save_labels [<address_space>] "<filename>"`
`sl [<address_space>] "<filename>"`

  Save labels to a file. If no address space is specified, all of the labels are saved.

`show_labels [<address_space>]`
`shl [<address_space>]`

  Display current label mappings. If no address space is specified, show all labels from default address space.

`clear_labels [<address_space>]`
`cl [<address_space>]`

  Clear current label mappings. If no address space is specified, clear all labels from default address space.

Next: Miscellaneous commands, Previous: Command file commands, Up: Monitor [Contents][Index]