Share via


Configuration Properties: Build Options (Compact 2013)

3/26/2014

Enables you to set build options. The options that are available will depend on the type of OS you have designed.

Every build option value is Yes or No. Platform Builder shows the options in a list in the left-hand column of the dialog box. In the right-hand column it shows current value of each option and, in parentheses, the corresponding value of the environment variable that determines the option value. For instance, for the build option “Buffer tracked events in RAM”, Platform Builder displays Yes, (IMGOSCAPTURE=1) when the option value is Yes, and No, (IMGOSCAPTURE=) when the option value is No.

You double-click the value to toggle it from Yes to No or from No or Yes. Following is a list of the options.

  • Buffer tracked events in RAM
    Set to Yes to buffer events tracked by OSCapture.exe in RAM.

    Note

    Do not include CeLog on a shipping device because the logging that CeLog performs can reduce system performance. Also, omitting CeLog reduces the attack surface through which a malicious user could try to compromise the system.

  • Enable CE Log event tracking during boot (CELog.dll)
    Set to Yes to start the event-tracking subsystem.

    Note

    Do not include CeLog on a shipping device because the logging that CeLog performs can reduce system performance. Also, omitting CeLog reduces the attack surface through which a malicious user could try to compromise the system.

  • Enable eboot space in memory
    Set to Yes to reserve memory space in the Config.bib file. This allows the boot loader to save data that the OS can read at boot time.
  • Enable hardware-assisted debugging support
    Set to Yes to support hardware-assisted debugging. This variable is automatically enabled if you define the Watson sysgen variables to support Windows Error Reporting.
  • Enable kernel debugger
    Set to Yes (before building the run-time image) to direct the debugger to pass debugging information from the target device to the host device.
  • Enable Kernel Independent Transport Layer (KITL)
    Set to Yes to enable KITL, which allows communication between the development computer and the device.
  • Enable kernel profiling
    Set to Yes to enable kernel (KCall) profiling. Kernel profiling is automatically enabled (and this option is ignored) if you use Monte Carlo or system call profiling in combination with CeLog.
  • Enable kernel Symmetric Multi-Processor (SMP)
    Set to Yes to enable kernel symmetric multiprocessing (SMP) support in the kernel, if the device is an SMP hardware platform.
  • Enable ship build
    Set to Yes to specify that the build is intended for shipping, not testing.
  • Flush tracked events to release directory
    Set to Yes to flush events to the release directory and turn on event tracking.

    Note

    Do not include CeLog on a shipping device because the logging that CeLog performs can reduce system performance. Also, omitting CeLog reduces the attack surface through which a malicious user could try to compromise the system.

  • Include CE Log performance testing (CEPerf.dll)
    Set to Yes to include the module CEPerf.dll in the OS image. This supports performance testing.
  • Optimize run-time image size and speed
    Set to Yes to enable compiler optimization; that is, to direct the compiler to generate smaller and faster OS images. Use this option to override the default optimization of the build configuration for your OS design. By default, optimization is disabled when the configuration is Debug, and enabled when the configuration is Release or Checked. Debugging may be easier with optimization disabled.
  • Write run-time image to flash memory
    Set to Yes to cause the run-time image to be written to flash memory after download.

See Also

Reference

OS Design Property Pages Dialog Box

Concepts

Platform Builder User Interface

Other Resources

IMG Environment Variables