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

NAME

6       function::user_string_n_quoted - Retrieves and quotes string from user
7       space
8

SYNOPSIS

10       1) user_string_n_quoted:string(addr:long,n:long)
11
12       2) user_string_n_quoted:string(addr:long,inlen:long,outlen:long)
13

ARGUMENTS

15       addr
16           the user space address to retrieve the string from
17
18       n
19           the maximum length of the string (if not null terminated)
20
21       inlen
22           the maximum length of the string to read (if not null terminated)
23
24       outlen
25           the maximum length of the output string
26

DESCRIPTION

28       1) Returns up to n characters of a C string from the given user space
29       memory address where any ASCII characters that are not printable are
30       replaced by the corresponding escape sequence in the returned string.
31       Note that the string will be surrounded by double quotes. On the rare
32       cases when userspace data is not accessible at the given address, the
33       address itself is returned as a string, without double quotes.
34
35       2) Reads up to inlen characters of a C string from the given user space
36       memory address, and returns up to outlen characters, where any ASCII
37       characters that are not printable are replaced by the corresponding
38       escape sequence in the returned string. Note that the string will be
39       surrounded by double quotes. On the rare cases when userspace data is
40       not accessible at the given address, the address itself is returned as
41       a string, without double quotes.
42

SEE ALSO

44       tapset::uconversions(3stap)
45
46
47
48SystemTap Tapset Reference        April 2023       FUNCTION::USER_STRIN(3stap)
Impressum