Starting the Host Shell from the Command Prompt Setting Your Environment Before launching the host shell, you must use the command wrenv to set up your environment. If you do not set your environment, the prompt returns the following error:

WIND_FOUNDATION_PATH must be set to start the Host Shell

To set your environment, enter the following command from your installation directory:

  %wrenv -p target_OS_version

For example, if you are using VxWorks 6.x , enter

  %wrenv -p vxworks-6.x

If you are using Wind River Linux 1.x , enter

  %wrenv -p wrlinux-1.x

Starting the Target Server To start a target server, use the tgtsvr command. For example, to start a target server called myTgtsvr on a target with the IP address 123.456.78.90, enter the following command from your installation directory:

  % tgtsvr 123.456.78.90 -n myTgtsvr

To see all available options for the tgtsvr command, enter tgtsvr -h. Note that you must set up your environment with the wrenv command before using the tgtsvr command.

Starting the Host Shell Once you have attached a target server to the target, start the host shell using the hostShell command. To start the host shell, type the following:

  %hostShell [options ] target_server

NOTE: For former users of Tornado: the Tornado procedure of stating the host shell with the windsh command is deprecated and may not be supported in future versions.

Starting the Host Shell from an Existing Connection If you are using an OCD connection, or if you have already established a target connection using Workbench, then you can start the host shell with the hostShell command, indicating the name of the target connection to use and the backend server to use. To start the host shell, type the following:

  % hostShell [options ] -dt target_connection -ds backend_server_session

If you do not know the names of your target connection and backend server session, type hostShell with no arguments and follow the options presented.

Host Shell Startup Options Table 2-1 summarizes startup options. For example, to connect to a running simulator, type the following:

  %hostShell vxsim0@hostname

NOTE: When you start the host shell, a second shell window appears, running the Debug server. You can minimize this second window to reclaim screen space, but do not close it.

You may run as many different host shells attached to the same target as you wish. The output from a function called in a particular shell appears in the window from which it was called, unless you change the shell defaults using shConfig (see 2.4 Setting Shell Environment Variables).

Host Shell Startup Options

tgtsvr