Running the Checkv4 Utility (Windows Embedded CE 6.0)

  • Article

1/6/2010

The Microsoft Checkv4 utility enables you to find potentially conversion-sensitive code in your application's socket-level programming. This utility identifies potential issues, highlights code that could benefit from IPv6-capable functions or structures, and recommends a method for resolving the issues.

Note

Most Windows Sockets (Winsock) 2.2 functions support IPv6 addresses. Checkv4 identifies those that do not support IPv6.

The Checkv4 utility documentation includes tips about the order in which to address IPv6-enabling issues. This is the order in which to approach the conversion process in your applications.

As an example, in this procedure, you will use the IPv4-only Client Code as shown in IPv4-only Client Code.

You can obtain the Checkv4 utility from the IPv6 Technology Preview, available for download at this Microsoft Web site. For more information about using the Checkv4 utility, see this Microsoft Web site.

To run the Checkv4 utility

  1. Obtain the Checkv4 utility.

  2. On your development workstation, put the Checkv4 utility in the same directory as your application, %_WINCEROOT%\PBWorkspaces\<OS design name>\<SimpleClient or Simple Server>.

  3. In Platform Builder, on the Build menu, choose Open Release Directory in Build Window.

  4. At the command prompt, navigate to %_WINCEROOT%\OSDesigns\<OS design name>\<SimpleClient or SimpleServer>.

  5. At the command prompt, type one of the following:

    Checkv4 CeClientApp.cpp>ch4client.txt

    Checkv4 CeServerApp.cpp>ch4server.txt

    Checkv4 parses the information into the file (ch4client.txt or chrserver.txt).

  6. To view the checkv4 output for the file, at the command prompt, type one of the following:

    notepad ch4client.txt

    notepad ch4server.txt

    Notepad displays Checkv4 output that contains IPv6 conversion issues. You will use this information to change your code to support IPv6.

Next, you must change your code to support IPv6 as described in Changing the Application Source Code to Support IPv6.

See Also

Tasks

How to Convert an Application from IPv4 to IPv4/IPv6

Other Resources

How to Develop an Application for a CEPC