The name must be unique. If not given it defaults to 'maticN', where 'N' is an integer.
The identifier is a string that is used to filter for an agent. The first agent that matches the argument will be selected. If no agent is found, an agent_handle object is immediately returned and the command will finish when a match is found, if ever. Without argument, the first found agent is selected.
An identifier may take any of three forms and it is matched in this order:
The identifier may be an agent-id on the form 'agent-nameN', where 'N' is an integer. An underscore is inserted before N if the agent name ends with a digit. The 'agent-id' is generated by the agent manager when a new agent is found. This is the only unique identifier.
The identifier may be the agent-name with which the Simics Agent announces itself. By default that is the host name of the target system, but it can also be given as a command line argument when starting the Simics Agent on the target system.
The identifier may be any part of a hierarchical name that identifies where in the configuration the Simics Agent is running. For example, 'cpu0' may work, or maybe the longer 'viper0.mb.cpu0' is needed. Avoid being too specific about the processor core, since the operating system of the target system may schedule the agent differently.
See also: agent_manager and agent_handle.