QNX Technical Articles

Date of this edition: March 21, 2007

Target OS: QNX^® Neutrino^® 6.3.0 SP3 with or without the Core OS 6.3.2A

Host OS: Microsoft Windows Vista

This note includes the following topics:

• Installation procedure
• Structure of this patch
• Applying the patch
• Technical support

Installation procedure

This patch provides you with Windows Vista support for the QNX win32 SDK. It includes an updated version of the core file cygwin1.dll, uname.exe, and bash.exe.

---

Before you continue with the installation procedure, see the Known Issues topic in the release notes for important information.

---

1. Log in as root (or with system administrator privileges on Windows).
2. Open a web browser, go to our website, www.qnx.com, and log on to your myQNX account.
3. Click Download Center-->Products & Updates-->QNX Momentics-->QNX Momentics 6.3.x-->QNX Momentics 6.3.0 Service Pack 2 and related downloads-->QNX Momentics 6.3.0 Service Pack 2 Patches and Updates.
4. Download the patch-630SP3-0522-vista.zip archive to your host environment.
5. Determine the base directory of your QNX Momentics installation by opening a command shell and using the qconfig command. For example:

   $ qconfig
   QNX Installations
   
   Installation Name: QNX Momentics 6.3.0 Service Pack 3
   Version: 6.3.0 SP3
   Base Directory: C:/QNX630
   QNX_HOST: C:/QNX630/host/win32/x86
   QNX_TARGET: C:/QNX630/target/qnx6
     

   The base directory in this example is C:/QNX630, but it could be different on your machine, depending on your host and where you installed QNX Momentics.

6. Make sure that there are no QNX Momentics applications currently running, and that bash is not running in any command prompt window.
7. Open Windows Explorer, navigate to the folder where you downloaded the patch, right-click on the folder called patch-630SP3-0522-vista and select Extract all.
8. Browse to your base installation directory (for example, C:\QNX630) and select it as the destination location for the extraction.

   After you extract the files from patch-630SP3-0522-vista.zip, the extraction process creates the following directory structure:

   base_dir/patches/630SP3-0522/

Next, continue with the instructions for Applying the patch to copy the directory structure under base_dir/patches/630SP3-0522/ to your base_dir.

Structure of this patch

This patch includes the following files:

• bash.exe

  This file was updated from version 2.03.0 to 2.05b.0.

• cygwin1.dll

  This file contains an updated version of the Cygwin DLL that provides Windows Vista support for the QNX win32 SDK. The version of your current cygwin1.dll file is 1005.20.0.0. After you apply this patch, the version of the cygwin1.dll file will be updated to 1005.26.0.0.

• inst_coretools_patch522.html

  This file contains important information about applying this patch.

• rel_coretools_patch522.html

  This file contains important release note information.

• uname.exe

  This file was updated to include support for Windows Vista.

Applying the patch

Next, you want to make a backup copy of the files that will be overwritten (uname.exe, bash.exe and cygwin1.dll), and then you want to replace these files with the ones from the patch.

Creating a backup

To create a backup:

1. Navigate to the base_dir\host\win32\x86\bin.
2. Right-click in the Windows Explorer list window, select New-->Compressed (zipped) Folder, and then rename it to 630SP3-0522-backup.
3. Drag and drop uname.exe, bash.exe and cygwin1.dll into the compressed folder 630SP3-0522-backup.
4. Move the compressed folder 630SP3-0522-backup to base_dir\patches.

Next, you must replace the files on your development host with the files included in this patch (currently located in the backup folder called 630SP3-0522-backup).

Copying the files

To copy the files:

1. Go to base_dir\patches\630SP3-0522\host\win32\x86\usr\bin, select uname.exe, bash.exe and cygwin1.dll, right-click and select Copy.
2. To paste the files, go to base_dir\host\win32\x86\usr\bin, right-click and select Paste.
3. When prompted to resolve the conflict, select Copy and Replace for all three files.

Now, the application of this patch is complete.

Technical support

If you have any questions, comments, or problems with a QNX product, please contact Technical Support. For more information, see the How to Get Help chapter of the Welcome to QNX Momentics guide or visit our website, www.qnx.com.