2.3.82. NAMETRANSLATE

The NAMETRANSLATE command manipulates the host/target name translation list.

Syntax

NAMETRANSLATE [,qualifier] [=name-translation, ...]

where:

qualifier

If specified, must be one of the following:

replace

The current name translation list is to be replaced by the list specified in this command.

delete

The current name translation list is to be deleted.

If you do not supply a qualifier, the name translation list specified in this command is appended to the current name translation list.

name_translation

A list of name translations. The format is:

"hname=tname"

where hname is the filename on the host and tname is the filename on the target. Both hname and tname can be a comma-separated list.

Each translation must be enclosed in double quotes.

Description

The NAMETRANSLATE command extends, replaces, or deletes the name translation list. Name translation enables a host filename to be different from a target filename.

If you supply no arguments, the NAMETRANSLATE command prompts you to enter a name translation for the current board:

  • If you enter this command in the Cmd tab of the RealView Debugger GUI, a prompt dialog is displayed and shows any existing translation.

  • If you enter this command in the headless debugger, you can press Enter to show the current name translation.

If translating from host name to target name, the first target name in the list is used. If translating from target name to host name, the first host name in the list is used.

Examples

The following examples show how to use NAMETRANSLATE:

nametranslate "hostfile1=targetfile1","hostfile2=targetfile2"
nametranslate "hostfile1,hostfile2,hostfile3=targetfile1,targetfile2"

See also

The following commands provide similar or related functionality:

Copyright © 2005, 2006 ARM Limited. All rights reserved.ARM DUI 0284C
Non-Confidential