Fuzzing in Docker

Instructions

  1. Build a fuzzer in order to use it. Follow the instructions at Build SOF with docker, Build topology and tools with Docker.

  2. Enter the Docker container:

    #To be run from sof/ directory
    ./scripts/docker-run.sh bash
    

    A container is created from the sof Docker image. We are provided with a shell prompt. Let’s call this Terminal #1.

  3. Connect to the container’s shell from another terminal.

    To do this, you must first know the container ID.

    docker ps
    
    #Sample output
    CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
    1c383e3c08ae        sof                 "bash"              4 minutes ago       Up 4 minutes                            objective_kilby
    

    The first column of the output gives you the container ID.

    To connect to the container’s shell, do the following:

    docker exec -i -t container_id bash
    

    This opens a shell prompt. Let’s call this Terminal #2.

  4. Run the QEMU DSP VM in Terminal #1 by following instructions from Using the QEMU DSP emulator.

  5. Run the sof-fuzzer built from Step 1. Run this in Terminal #2.

    When you see FW boot complete in Terminal #2, the setup is complete.

Important notes

  1. The platform should be the same for the QEMU DSP VM and the fuzzer.

    Ex: If you run your QEMU DSP VM with the ‘byt’ platform, use the same platform when you run your fuzzer.

  2. Make sure that you pass your kernel using the ‘-k’ flag in the QEMU DSP VM.

  3. You must run the fuzzer and the QEMU DSP VM in the same container; otherwise they can’t communicate with each other!