os/ossrv/glib/tsrc/readme.txt
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
     1 This readme describes the way to run glib test cases.
     2 
     3 When running the glib test cases please take care of the following:
     4 
     5 1. The hardware image must have the language variants dlls if the ATSINPUT is created using genatsmodules_locale_specific.bat.
     6 Language variant DLLs will not be flashed on to the device if we are using Engineering  English image. So we have to create our own customised image for testing the glib module.
     7 
     8 Steps to be followed to test glib module.
     9 a. Create a locale.iby file with following entries in the file.
    10 /*
    11 * ==============================================================================
    12 *  Name        : locale.iby
    13 *  Part of     : locale
    14 *  Description : IBY file for locale
    15 *  Version     : 
    16 *
    17 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
    18 *
    19 * This library is free software; you can redistribute it and/or
    20 * modify it under the terms of the GNU Lesser General Public
    21 * License as published by the Free Software Foundation; either
    22 * version 2 of the License, or (at your option) any later version.
    23 *
    24 * This library is distributed in the hope that it will be useful,
    25 * but WITHOUT ANY WARRANTY; without even the implied warranty of
    26 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    27 * Lesser General Public License for more details.
    28 *
    29 * You should have received a copy of the GNU Lesser General Public
    30 * License along with this library; if not, write to the
    31 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    32 * Boston, MA 02111-1307, USA.
    33 * ==============================================================================
    34 */
    35 
    36 
    37 
    38 #ifndef LOCALE_IBY
    39 #define LOCALE_IBY
    40 
    41 file=\epoc32\release\armv5\urel\elocl.01            SHARED_LIB_DIR\elocl.01
    42 file=\epoc32\release\armv5\urel\elocl.37            SHARED_LIB_DIR\elocl.37
    43 file=\epoc32\release\armv5\urel\elocl.42            SHARED_LIB_DIR\elocl.42
    44 file=\epoc32\release\armv5\urel\elocl.25            SHARED_LIB_DIR\elocl.25
    45 file=\epoc32\release\armv5\urel\elocl.07            SHARED_LIB_DIR\elocl.07
    46 file=\epoc32\release\armv5\urel\elocl.03            SHARED_LIB_DIR\elocl.03
    47 file=\epoc32\release\armv5\urel\elocl.54            SHARED_LIB_DIR\elocl.54
    48 file=\epoc32\release\armv5\urel\elocl.10            SHARED_LIB_DIR\elocl.10
    49 file=\epoc32\release\armv5\urel\elocl.04            SHARED_LIB_DIR\elocl.04
    50 file=\epoc32\release\armv5\urel\elocl.49            SHARED_LIB_DIR\elocl.49
    51 file=\epoc32\release\armv5\urel\elocl.09            SHARED_LIB_DIR\elocl.09
    52 file=\epoc32\release\armv5\urel\elocl.51            SHARED_LIB_DIR\elocl.51
    53 file=\epoc32\release\armv5\urel\elocl.02            SHARED_LIB_DIR\elocl.02
    54 file=\epoc32\release\armv5\urel\elocl.57            SHARED_LIB_DIR\elocl.57
    55 file=\epoc32\release\armv5\urel\elocl.45            SHARED_LIB_DIR\elocl.45
    56 file=\epoc32\release\armv5\urel\elocl.17            SHARED_LIB_DIR\elocl.17
    57 file=\epoc32\release\armv5\urel\elocl.59            SHARED_LIB_DIR\elocl.59
    58 file=\epoc32\release\armv5\urel\elocl.15            SHARED_LIB_DIR\elocl.15
    59 file=\epoc32\release\armv5\urel\elocl.05            SHARED_LIB_DIR\elocl.05
    60 file=\epoc32\release\armv5\urel\elocl.32            SHARED_LIB_DIR\elocl.32
    61 file=\epoc32\release\armv5\urel\elocl.68            SHARED_LIB_DIR\elocl.68
    62 file=\epoc32\release\armv5\urel\elocl.67            SHARED_LIB_DIR\elocl.67
    63 file=\epoc32\release\armv5\urel\elocl.70            SHARED_LIB_DIR\elocl.70
    64 file=\epoc32\release\armv5\urel\elocl.18            SHARED_LIB_DIR\elocl.18
    65 file=\epoc32\release\armv5\urel\elocl.08            SHARED_LIB_DIR\elocl.08
    66 file=\epoc32\release\armv5\urel\elocl.27            SHARED_LIB_DIR\elocl.27
    67 file=\epoc32\release\armv5\urel\elocl.76            SHARED_LIB_DIR\elocl.76
    68 file=\epoc32\release\armv5\urel\elocl.13            SHARED_LIB_DIR\elocl.13
    69 file=\epoc32\release\armv5\urel\elocl.78            SHARED_LIB_DIR\elocl.78
    70 file=\epoc32\release\armv5\urel\elocl.16            SHARED_LIB_DIR\elocl.16
    71 file=\epoc32\release\armv5\urel\elocl.26            SHARED_LIB_DIR\elocl.26
    72 file=\epoc32\release\armv5\urel\elocl.28            SHARED_LIB_DIR\elocl.28
    73 file=\epoc32\release\armv5\urel\elocl.79            SHARED_LIB_DIR\elocl.79
    74 file=\epoc32\release\armv5\urel\elocl.06            SHARED_LIB_DIR\elocl.06
    75 file=\epoc32\release\armv5\urel\elocl.33            SHARED_LIB_DIR\elocl.33
    76 file=\epoc32\release\armv5\urel\elocl.39            SHARED_LIB_DIR\elocl.39
    77 file=\epoc32\release\armv5\urel\elocl.14            SHARED_LIB_DIR\elocl.14
    78 file=\epoc32\release\armv5\urel\elocl.93            SHARED_LIB_DIR\elocl.93
    79 file=\epoc32\release\armv5\urel\elocl.96            SHARED_LIB_DIR\elocl.96
    80 file=\epoc32\release\armv5\urel\elocl.31            SHARED_LIB_DIR\elocl.31
    81 file=\epoc32\release\armv5\urel\elocl.30            SHARED_LIB_DIR\elocl.30
    82 
    83 file=\epoc32\release\armv5\urel\SHIFTJIS.DLL            SHARED_LIB_DIR\SHIFTJIS.DLL
    84 file=\epoc32\release\armv5\urel\EUCJP_PACKED.DLL      SHARED_LIB_DIR\EUCJP_PACKED.DLL
    85 
    86 #endif
    87 
    88 
    89 b.Place the locale.iby file in \EPOC32\rom\Include directory
    90 c.Open S60.iby file from  \EPOC32\rom\Include directory and make an entry in the file as given below
    91    #include <locale.iby>                      
    92 d. Give the following command to build the scarfe image
    93     isis_build.bat -rom -type=scarfe
    94  
    95 2. Ensure that locales.txt is present at \epoc32\winscw\c\resource on emulator and at c:\resource on Hardware. If not present, copy the same to the specified location.
    96 
    97 3. The following are manual test cases:
    98         a. tmanual - Prints instructions on screen. Please follow them. If nothing is printed it is considered as failed.
    99 
   100         b. log_manual1 - When the test case is executed, the getchar() API should not be executed. If it is executed the test case is considered as failed.
   101 
   102         c. log_test - prints the following message "test domain-message: test message printed successfully". If it does not print it, the test case is considered as failed.
   103 
   104         d. mem_profile_test - This will print memory profile on the screen. If it does not print the memory profile the test case is considered as failed.
   105         
   106         e. error_check_mutexes - This will terminate at some point inside error_check_mutexes function,if, in any case it creates result file then consider is as failed.
   107 
   108 4. To generate the ATS test drops for non locale specific APIs use the batch file "genatsmodules.bat" placed in glib\internal. This will generate the "ATSINPUT" folder. 
   109    For locale specfic APIs use genatsmodules_locale_specific.bat placed in glib\internal.
   110 
   111 5. At the end of the all the test cases a log file c:\logtests.txt will be generated which will describe the reason for failures if any.