|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Micro-embedded shell (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:
- no script files
- no pipes
- no aliases
- no filename- or command-completion
- no set command
In uesh, command lines take this form:
command arg1 arg2 ... [redir-op file] [&]
- The command to be executed. If it doesn't start with a slash, the command follows the path set by the PATH environment variable.
- redir-op file
- A redirection operator. When a command is invoked, three standard files
are set up in its environment. These files, standard input,
standard output, and standard error output
(stdin, stdout, stderr), are usually
attached to the active terminal. You can redirect a command's standard
input, standard output, and standard error as follows:
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.
The uesh shell doesn't support filename expansion. Such shorthands as *.c for all files ended in .c don't work.
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 (\).
- Escape character (backslash)
- The escape character (\) preserves the literal meaning of the next character. You can't obtain a single backslash by quoting \ with double quotes. To obtain a backslash, enter \\ instead.
- Double quotes
- Enclosing characters and words in double quotes ("")
preserves the literal meaning of all characters within double quotes,
with the exception of the \ character. For example:
represents a single, five-character argument.
You can keep the literal meaning of a double quote with the \ character. For example:
represents the single, five-character argument ab"cd.
The following commands are built into uesh (that is, uesh interprets and executes them internally):
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 special directory [fs_type]
Mount a special device. The arguments are:
- The name of the special device.
- Where to mount the device on your system.
- The type of filesystem or manager to mount:
type: Filesystem or manager: cd fs-cd.so cifs fs-cifs dos fs-dos.so ext2 fs-ext2.so nfs fs-nfs2, fs-nfs3 qnx4 fs-qnx4.so qnx6 fs-qnx6.so udf fs-udf.so
The default is qnx4.
|The emount command was implemented in QNX Momentics 6.3.0 Service Pack 2.|
ewaitfor path [max_seconds [delay]]
Wait until the given path exists. The arguments are:
- The path to test.
- The maximum number of seconds to wait for the file to appear. The default is 1 second.
- The number of milliseconds to wait between attempts. The default is 100 ms.
|The ewaitfor command was implemented in QNX Momentics 6.3.0 Service Pack 2.|
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.
Cause uesh to exit with the exit status specified by n. If n isn't specified, uesh exits with the status of the last command executed.
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 the standard output.
- The pathname of the user's home directory
- The user's login name.
- The directory search path used by uesh for locating executable programs.
To change PATH, you must
use the export command.
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 Neutrino User's Guide.
- The pathname of the user's preferred shell.
- The terminal type.
- The pathname of a directory where utilities can create temporary files.
- The timezone setting.
"Setting PATH and LD_LIBRARY_PATH" in the Configuring Your Environment chapter of the Neutrino User's Guide