1. Manuals
  2. Tumbleweed
  3. systemtap-docs
  4. function::user_string_n_warn(3stap)

Scroll to navigation

FUNCTION::USER_STRIN(3stap) String and data retrieving fun FUNCTION::USER_STRIN(3stap)

NAME

function::user_string_n_warn - Retrieves string from user space

SYNOPSIS

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

DESCRIPTION

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)

April 2024 SystemTap Tapset Reference