st-util(1)

st-util1

Run gdb server to interact with stm32 device

Usage

st-util [<ARGS> ...]

Overview

Start a GDB server to interact with a STM32 device Run the main binary of the local package (src/main.rs).

If a port number is not specified using the –listen_port option, the default 4242 port will be used.

Stlink version 2 is used by default unless the option –stlinkv1 is given.

Options

-h, --help

Print this message.

--version

Print version information

-v XX, --verbose=XX

Specify a specific verbosity level (0..99)

-v, --verbose

Specify generally verbose logging

-s X, --stlink_version=X

Choose what version of stlink to use, (defaults to 2)

-1, --stlinkv1

Force stlink version 1

-p 4242, --listen_port=1234

Set the gdb server listen port. (default port: 4242)

-m, --multi

Set gdb server to extended mode. st-util will continue listening for connections after disconnect.

-n, --no-reset

Do not reset board on connection.

--semihosting

Enable ARM Semihosting output on stdout

Examples

Run GDB server on port 4500 and connect to it

$ st-util -p 4500
$ gdb
(gdb) target extended-remote localhost:4500

Releases

5 releases since Debian 10 (Buster); the text changed 2 times.

  1. 10
  2. 11–12
  3. 13–Arch

From stlink 1.9.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.