tracetronic: RemoteCommandLinux¶

Legacy/internal identifier: REMOTE-COMMAND-LINUX

Vendor information

Vendor	Web page	Product name	Version
tracetronic GmbH	https://www.tracetronic.de	RemoteCommandLinux

Operating system	Support
Windows
Linux	✓

Specifics¶

RemoteCommandLinux provides system access to the host of Tool Server. For example, files can be transferred from or to the tool host or applications can be executed by using this tool.

For security reasons, RemoteCommandLinux can only be used locally or if the ecu.test Tool Server communication has been secured (SSL client certificate).

Properties 🛈¶

Name	Available if	Default value	Valid values	Type	Description
Timeout for tool call ❲in sec.❳		‘600’		string	Timeout after which a tool call is aborted.

Jobs 🛈¶

DeleteFile¶

Deletes a file from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
remotepath				string	Remote file name with path

DeleteFolder¶

Deletes a directory from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
recursive		False	[False, True]	bool	delete non-empty folder including content
remotepath				string	Remote path

DownloadDirRecursive¶

Copies a subdirectory from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local directory
remotepath				string	Remote directory

DownloadFile¶

Copies a file from the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local file
remotepath				string	Remote file

ExecuteCommand¶

Executes a command

Parameter

Name	Default value	Valid values	Type	Description
args	[]		object	Argument list incl. program name
creationflags	0		int	creationflags
cwd			string	Execute inside directory
delay	0		int	Time to wait before requesting results in asynchronous execution
encoding	‘utf-8’		string	Character set for decoding of read characters. Set None for not decoded bytes.
env			object	Alternative environment variables
executeInShell	False	[False, True]	bool	Execute inside a command shell (cmd.exe)
inputtext			string	Text to be send to stdi
startupinfo			object	StartupInfo
sync	True	[False, True]	bool	Synchronous execution

Return value

Name	Available if	Default value	Valid values	Type	Description
ProcessResult				object	Tuple (return code, stdout content, stderr content)

HttpGet¶

Retrieves a document via HTTP or HTTPS

Parameter

Name	Available if	Default value	Valid values	Type	Description
url				string	URL

Return value

Name	Available if	Default value	Valid values	Type	Description
httpDocument				string	Content of the retrieved document

ListDir¶

Lists a directory recursively

Parameter

Name	Available if	Default value	Valid values	Type	Description
directory				string	The directory to be listed

Return value

Name	Available if	Default value	Valid values	Type	Description
directoryContent				object	Directory tree - each entry as a triple (name, path, isDir)

Ping¶

Pings the specified host

Parameter

Name	Available if	Default value	Valid values	Type	Description
ipAddressOrHostName				string	IP address or host name

Return value

Name	Available if	Default value	Valid values	Type	Description
pingResult		☐		bool	True, if the host is available, else False

UploadDirRecursive¶

Copies a subdirectory to the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local directory
remotepath				string	Remote directory

UploadFile¶

Copies a file to the remote host

Parameter

Name	Available if	Default value	Valid values	Type	Description
localpath				string	Local file
remotepath				string	Remote file