The from argument is mandatory and must refer to an existing readable file on the host system.
The to argument is optional and without it the agent handle's current working directory will be used. If provided, the destination directory path is taken relative to the handle's current working directory, unless the path is absolute. The destination directory must exist on the target and the user must have write permission in it.
When the -executable flag is given, the file mode bits will be updated so that all users who have read access to the file will also gain executable access to it.
With the -flush flag, the Simics Agent will immediately commit each piece of data to the storage media before requesting the next piece of data to be transmitted. This allows readers of the destination file to read the data as each piece is transferred, at the expense of performance.
The -overwrite flag is required to overwrite any existing destination file on the target system. Otherwise, the command will fail if the destination file already exists.
Note: The Simics Agent must have permissions to create and write files in the destination directory on the target system. The uploaded contents will be given ownership and the access permissions of the user who is running the Simics Agent.