ssystem - Maple Programming Help

# Online Help

###### All Products    Maple    MapleSim

Home : Support : Online Help : System : External Functions : ssystem

ssystem

invoke a command in the host operating system

 Calling Sequence ssystem(command) ssystem(command, timeout)

Parameters

 command - Maple string timeout - integer

Description

 • The function ssystem passes command to the host operating system which performs the appropriate function.
 • If timeout is specified, the command is given at most that many seconds of CPU time in which to execute.  Note: The timeout parameter to ssystem may be ignored on some operating systems.
 • ssystem returns a 2 element list.  The first element is the return code of the command, which is operating system dependent, but usually 0 indicates success and any other value indicates failure.  This return code is the same as would be generated by system. The second element is the result of the command, in a Maple string.
 • If the command is terminated because of exceeding the time limit, the following list is returned

$\left[-1,"\left(Timeout\right)"\right]$

 • The behavior of ssystem is exactly the same as that of system, except that in the case of ssystem, the result is returned to Maple so that it can be used in the session.
 • Invoking interactive commands via system or ssystem can result in undefined behavior.
 • Some operating system commands may not be accessible via this mechanism.

Thread Safety

 • The ssystem command is thread-safe as of Maple 15.
 • For more information on thread safety, see index/threadsafe.

Examples

 > $\mathrm{ssystem}\left("ls -ld /u*"\right)$
 > $\mathrm{ssystem}\left("sleep 5",2\right)$
 > $\mathrm{ssystem}\left("sleep 5",6\right)$
 > $\mathrm{ssystem}\left("grep foo .profile"\right)$
 > $\mathrm{ssystem}\left("grep HOME .profile"\right)$

 See Also

## Was this information helpful?

 Please add your Comment (Optional) E-mail Address (Optional) What is ? This question helps us to combat spam