function::user_string_n_warn(3stap)

function::user_string_n_warn3stap

Retrieves string from user space

Usage

1) user_string_n_warn:string(addr:long,n:long)
2) user_string_n_warn:string(addr:long,n:long,warn_msg:string)

Arguments

addr

the user space address to retrieve the string from

n

the maximum length of the string (if not null terminated)

warn_msg

the warning message to return when data isn't available

Overview

1) Returns up to n characters of a C string from a given user space memory address. Reports“<unknown>” on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.

2) Returns up to n characters of a C string from a given user space memory address. Reports the given warning message on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.

See ALSO0

tapset::uconversions(3stap)

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 7 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13

From systemtap-doc 5.1-5 in Debian 13 (Trixie). Parsed by carta from the page's man source.