Preparing the Build System for Debugging - Preparing the Build System for Debugging - 2026.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document_ID
UG1144
Release_Date
2026-06-23
Version
2026.1 English
  1. Change to the project directory:
    cd <plnx-proj-root>
  2. Run petalinux-config -c rootfs on the command console:
    petalinux-config -c rootfs
  3. Scroll down the Linux/RootFS configuration menu to file system packages.
    admin   ---> 
    audio   ---> 
    base   ---> 
    baseutils   ---> 
    benchmark   ---> 
    bootloader   ---> 
    console   ---> 
    devel   ---> 
    fonts   ---> 
    kernel   ---> 
    libs   ---> 
    misc   ---> 
    multimedia   ---> 
    net   ---> 
    network   ---> 
    optional   ---> 
    power management --->
    utils   ---> 
    x11   --->   
    
  4. Select misc submenu:
    admin   ---> 
    audio   ---> 
    base   ---> 
    baseutils   ---> 
    benchmark   ---> 
    bootloader   ---> 
    console   ---> 
    devel   ---> 
    fonts   ---> 
    kernel   ---> 
    libs   ---> 
    misc   ---> 
    multimedia   ---> 
    net   ---> 
    network   ---> 
    optional   ---> 
    power management --->
    utils   ---> 
    x11   --->   
    
  5. Packages are in alphabetical order. Navigate to the letter ‘t’, as follows:
    serf   --->                                        
    sysfsutils   --->                                  
    sysvinit-inittab   --->                            
    tbb   --->                                         
    tcf-agent ---> 
    texi2html   --->                                   
    tiff   --->                                        
    trace-cmd   --->                                   
    util-macros   --->                                 
    v4l-utils   ---> 
    
  6. Ensure that tcf-agent is enabled and gdbserver is disabled.
    [*] tcf-agent
    [ ] tcf-agent-dev
    [ ] tcf-agent-dbg
    
  7. Select console/network submenu, click dropbear submenu. Ensure "dropbear-openssh-sftp-server" is enabled.
    [*] dropbear
  8. Select console/network > openssh. Ensure that "openssh-sftp-server" is disabled.
  9. Exit the menu.
  10. Rebuild the target system image, including hello_linux.elf. For more information, see Building a System Image.