Updated: April 19, 2023 |
Micro-embedded shell (QNX Neutrino)
uesh [script_file]
QNX Neutrino
The uesh utility provides a subset of the functionality found in the standard embedded shell, esh. You should find uesh useful for situations where memory requirements are limited. For example, you could use it to run a simple system initialization file for an embedded system.
The micro-embedded shell has some very significant limitations:
For applications that require greater functionality, use esh or the full shell, sh.
Command-line format
In uesh, command lines take this form:
command arg1 arg2 ... [redir-op file] [&]
Where:
Specifying: | Will: |
---|---|
<file | Redirect standard input from this file. |
>file | Redirect standard output to this file. If the file exists, it's overwritten; if the file doesn't exist, it's created. |
>>file | Redirect standard output to this file. If the file exists, the information is appended to the end of the file; if the file doesn't exist, it's created. |
2>file | Do the same as >file, but for standard error. |
2>>file | Do the same as >>file, but for standard error. |
& | If a command contains an unquoted &, then uesh doesn't wait for the command to complete execution but immediately moves on to process the next command. The standard input of the command is redirected from /dev/null, and SIGINT and SIGQUIT are ignored. |
Filename expansion
The uesh shell doesn't support filename expansion. Such shorthands as *.c for all files ended in .c don't work.
Quoting
The following characters have a special meaning in uesh:
& \ " [ space
To suppress the special meaning of these characters and keep their literal meaning, use quoting.
To quote a sequence of characters or sequence of words, enclose the sequence in double quotes. To quote a single character, use double quotes or precede it with the escape character (\).
"ab cd"
represents a single, five-character argument.
You can keep the literal meaning of a double quote with the \ character. For example:
ab\"cd
represents the single, five-character argument ab"cd.
Builtin commands
The following commands are built into uesh (that is, uesh interprets and executes them internally):
cd command
cd [directory]
Change the working directory of the current execution environment. If directory isn't specified, the value of the HOME environment variable becomes the new working directory.
emount command (QNX Momentics 6.3.0 Service Pack 2 or later)
emount special directory [fs_type]
Mount a special device. The arguments are:
type: | Filesystem or manager: |
---|---|
cd | fs-udf.so |
cifs | fs-cifs |
dos | fs-dos.so |
mac | fs-mac.so |
nfs | fs-nfs3 |
nt | fs-nt.so |
qnx6 | fs-qnx6.so (Power-Safe filesystem) |
udf | fs-udf.so |
The default is qnx6.
ewaitfor command (QNX Momentics 6.3.0 Service Pack 2 or later)
ewaitfor path [max_seconds [delay]]
Wait until the given path exists. The arguments are:
exec command
exec [command [argument...]]
Execute a command and/or manipulate file descriptors.
The exec command opens, closes, or copies file descriptors as specified by any I/O redirections given as part of argument. If a command is specified, that command is spawned as a replacement for uesh. Any specified arguments are passed to the spawned process.
exit command
exit [n]
Cause uesh to exit with the exit status specified by n. If you don't specify n, uesh exits with the status of the last command executed.
export command
export name[=word]... export -p
Mark environment variables for export, which causes them to be in the environment of subsequently executed commands. If you specify the -p option, the names and values of all exported variables are written to standard output.
Invoke uesh:
uesh
If PATH isn't in the existing environment when uesh is invoked, it's set to /bin:/usr/bin. For more information on setting PATH, see Setting PATH and LD_LIBRARY_PATH in the Configuring Your Environment chapter of the QNX Neutrino User's Guide.