documentation/common_mmh.pod
changeset 69 849a0b46c767
parent 68 6a26ca985d90
child 80 562156073bab
equal deleted inserted replaced
68:6a26ca985d90 69:849a0b46c767
    38 
    38 
    39 Kern::DynamicDfcQCreate API is present. Also used to guard TDfc::RawAdd.
    39 Kern::DynamicDfcQCreate API is present. Also used to guard TDfc::RawAdd.
    40 
    40 
    41 =item FSHELL_REPLACE_ECONS
    41 =item FSHELL_REPLACE_ECONS
    42 
    42 
    43 buildrom macro (on platforms that support it) to say that iosrv should replace econs.DLL with its own implementation.
    43 buildrom macro to say that iosrv should replace econs.DLL with its own implementation.
    44 
    44 
    45 =item FSHELL_PLATFORM_S60
    45 =item FSHELL_PLATFORM_S60
    46 
    46 
    47 S60 platform (value of this is either 3 or 5, for 3rd edition or 5th edition, or > 5 for foundation). Various UI code uses this to decide whether to build or not.
    47 S60 platform (value of this is either 3 or 5, for 3rd edition or 5th edition, or > 5 for foundation). Various UI code uses this to decide whether to build or not.
    48 
    48 
    49 =item FSHELL_PLATFORM_FOUNDATION
    49 =item FSHELL_PLATFORM_FOUNDATION
    50 
    50 
    51 Symbian Foundation platform (value of this is n, where n is Symbian^n).
    51 Symbian Foundation platform (value of this is n, where n is Symbian^n). Currently 3 is used for Symbian^3 or greater.
    52 
    52 
    53 =item FSHELL_PLATFORM_SYMTB
    53 =item FSHELL_PLATFORM_SYMTB
    54 
    54 
    55 Symbian Timebox release (value can be 92 or 101).
    55 Symbian Timebox release (value can be 92 or 101).
    56 
    56 
    62 
    62 
    63 All capabilities are available (platform.mmh must define either this macro or the specific C<FSHELL_CAP_xxx> that are supported)
    63 All capabilities are available (platform.mmh must define either this macro or the specific C<FSHELL_CAP_xxx> that are supported)
    64 
    64 
    65 =item FSHELL_PROTECTED_UIDS
    65 =item FSHELL_PROTECTED_UIDS
    66 
    66 
    67 Protected uids (0x10xxxxxx) should be used, as opposed to unprotected (0xE0xxxxxx), for exe and dll UID3. The UIDs themselves are all defined at the bottom of common.mmh so nothing else uses this macro directly. Unprotected UIDs should only be specified if the platform produces an unsigned sis file.
    67 Protected uids (0x10xxxxxx) should be used, as opposed to unprotected (0xE0xxxxxx), for exe and dll UID3. The UIDs themselves are all defined at the bottom of common.mmh so nothing else uses this macro directly. Unprotected UIDs should only be specified if the platform produces an unsigned or self-signed sis file.
       
    68 
       
    69 =item FSHELL_OPEN_SIGNED
       
    70 
       
    71 Shorthand for defining the set of capabilties supported by Symbian Open Signing. For more information see https://www.symbiansigned.com/app/page/public/openSignedOnline.do . FSHELL_PROTECTED_UIDS must not be defined if open signing is being used. 
    68 
    72 
    69 =item FSHELL_BASE_ROM
    73 =item FSHELL_BASE_ROM
    70 
    74 
    71 Configure IBYs for base 'rom' command rather than 'buildrom' style.
    75 Configure IBYs for base 'rom' command rather than 'buildrom' style.
    72 
    76 
   118 
   122 
   119 Create a launch icon for running fshell remotely via Bluetooth.
   123 Create a launch icon for running fshell remotely via Bluetooth.
   120 
   124 
   121 =item FSHELL_CORE_SUPPORT_USB_ICON
   125 =item FSHELL_CORE_SUPPORT_USB_ICON
   122 
   126 
   123 Create a launch icon for running fshell remotely via USB. The value of the macro is the port name to use (eg C<"ACM::1">).
   127 Create a launch icon for running fshell remotely via USB. The value of the macro is the console-title arguments to use (eg C<"port=ACM::1">).
   124 
   128 
   125 =item FSHELL_CORE_SUPPORT_SERIAL_ICON
   129 =item FSHELL_CORE_SUPPORT_SERIAL_ICON
   126 
   130 
   127 Create a launch icon for running fshell remotely via Serial. The value of the macro is the console-title arguments to use (eg C<"port=COMM::1,rate=115200">).
   131 Create a launch icon for running fshell remotely via Serial. The value of the macro is the console-title arguments to use (eg C<"port=COMM::1,rate=115200">).
   128 
   132 
   138 
   142 
   139 Samping profiler (profiler.h) is present. (foundation forgot to include it in S^2).
   143 Samping profiler (profiler.h) is present. (foundation forgot to include it in S^2).
   140 
   144 
   141 =item FSHELL_CLOGGER_REPLACE_FLOGGER
   145 =item FSHELL_CLOGGER_REPLACE_FLOGGER
   142 
   146 
   143 Put "FLOGGER_clogger_stub.DLL" into the ROM file as "flogger.dll". Probably won't work for SIS install.
   147 Put "FLOGGER_clogger_stub.DLL" into the ROM file as "flogger.dll". Should only be specified at rombuild time (ie not in the platform.mmh).
   144 
   148 
   145 =item FSHELL_CLOGGER_REPLACE_CDU
   149 =item FSHELL_CLOGGER_REPLACE_CDU
   146 
   150 
   147 Put "COMSDBGUTIL_clogger_stub.DLL" into the ROM file as "comsdbgutil.dll". Probably won't work for SIS install.
   151 Put "COMSDBGUTIL_clogger_stub.DLL" into the ROM file as "comsdbgutil.dll". Should only be specified at rombuild time (ie not in the platform.mmh).
   148 
   152 
   149 =item FSHELL_ROM_INCLUDE(ibyname)
   153 =item FSHELL_ROM_INCLUDE(ibyname)
   150 
   154 
   151 Optional function-like macro, can be defined to override default IBY export path. Only a few platforms need to override this.
   155 Optional function-like macro, can be defined to override default IBY export path. Only a few platforms need to override this.
   152 
   156