1. Find the package with autotest tests:

emerge --search autotest | grep tests

2. Dry emerge it and look for your test in the output:

emerge-lumpy -pv chromeos-base/autotest-tests

    Two things to note:

    a. The first line will say something like: “chromeos-base/autotest-tests-0.0.1-r3531“

     This means it’s emerging the r3531 ebuild. 

       Since we would like it to use our local bits, we need to cros_workon the package.

    b. You will not find kernel_HdParmBasic in the output.

3. cros_workon the appropriate package:

    cros_workon --board=<board name> start <package name>

    eg: cros_workon --board=lumpy start autotest-tests

    emerge the package: emerge-<board name> <package name>

    eg: emerge-lumpy -pv chromeos-base/autotest-tests

    Two things to note:

    a. The first line will say something like:

“chromeos-base/autotest-tests-9999”

This is good, it means it’s pulling local bits.

    b. You still will not find kernel_HdParmBasic in the output.

This is because your new test hasn’t been added to the ebuild yet.

4. Edit the ebuild to include your test:

Find the ebuild file: find -iname “autotest-tests-9999.ebuild” from src/third_party/. 

      a. It will most probably point you to:

            third_party/chromiumos-overlay/chromeos-base/autotest-tests/autotest-tests-9999.ebuild. 

      b. open this file and add “+test_kernel_HdParmBasic” in the IUSE_TESTS section.

     a. Make sure you’re cros_working on the right packages:

        cros_workon --board=lumpy list

        should show autotest_tests

     b. Make sure the emerge will touch kernel_HdParmBasic:

        emerge-lumpy -pv chromeos-base/autotest-tests | grep kernel_HdParmBasic

     c. Actual emerge:

        emerge-lumpy chromeos-base/autotest-tests

6. Check the staging area for your new test:

      eg: ls /build/lumpy/usr/local/autotest/client/site_tests/kernel_HdParmBasic

7. Re-run the run_remote command and look for the results directory:

    you should see a line like:

        >>> Details stored under /tmp/run_remote_tests.KTQ4
    Alternatively, you can specify your own results directory using ‘--results_dir_root’.

Some common ebuilds to cros_workon and emerge:

• autotest-all (Meta ebuild for all packages providing tests),
• autotest-factory (Autotest Factory tests),
• autotest-chrome (Autotest tests that require chrome_test or pyauto deps),
• autotest-tests (Pure Autotest tests),  
• autotest (Autotest scripts and tools).