This command immediately takes effect since it only sets the path property of this agent handle. Hence, the Simics Agent for this handle is not notified, and no other handles for the same agent are affected. Any following commands posted on a handle will run relative to its working directory, unless they specify an absolute path.
The target-path argument is an absolute path, or a path relative to this handle's current working directory. Without argument, on Linux the directory is changed to "/", and on other systems to its equivalent.
The target-path must exist on the target system but no effort is made to validate the path. Hence, an invalid path may cause following commands to fail.