1FUNCTION::USER_STRIN(3staSpt)ring and data retrieving fFuUnNCTION::USER_STRIN(3stap)
2
3
4

NAME

6       function::user_string_n_warn - Retrieves string from user space
7

SYNOPSIS

9       1) user_string_n_warn:string(addr:long,n:long)
10
11       2) user_string_n_warn:string(addr:long,n:long,warn_msg:string)
12

ARGUMENTS

14       addr
15           the user space address to retrieve the string from
16
17       n
18           the maximum length of the string (if not null terminated)
19
20       warn_msg
21           the warning message to return when data isn't available
22

DESCRIPTION

24       1) Returns up to n characters of a C string from a given user space
25       memory address. Reports“<unknown>” on the rare cases when userspace
26       data is not accessible and warns (but does not abort) about the
27       failure.
28
29       2) Returns up to n characters of a C string from a given user space
30       memory address. Reports the given warning message on the rare cases
31       when userspace data is not accessible and warns (but does not abort)
32       about the failure.
33

SEE ALSO

35       tapset::uconversions(3stap)
36
37
38
39SystemTap Tapset Reference         May 2021        FUNCTION::USER_STRIN(3stap)