diff options
| author | eteo <eteo> | 2008-03-21 14:35:25 +0000 |
|---|---|---|
| committer | eteo <eteo> | 2008-03-21 14:35:25 +0000 |
| commit | ef56478712cf797380b3057ddeca13dcec064656 (patch) | |
| tree | d650d8a70668873fec72cc874245336ee74a0a79 /stapfuncs.5.in | |
| parent | 4a99c075363ddf2e745f28c847cce7e4aa6cc9f7 (diff) | |
| download | systemtap-steved-ef56478712cf797380b3057ddeca13dcec064656.tar.gz systemtap-steved-ef56478712cf797380b3057ddeca13dcec064656.tar.xz systemtap-steved-ef56478712cf797380b3057ddeca13dcec064656.zip | |
2008-03-21 Eugene Teo <eugeneteo@kernel.sg>
PR 5528
* tapset/conversions.stp (user_string_n, user_string_n2,
user_string_n_warn, user_string_n_quoted, user_short, user_short_warn,
user_int, user_int_warn, user_long, user_long_warn, user_char,
user_char_warn): New user_* functions.
* stapfuncs.5.in: Documented the new functions.
* testsuite/systemtap.stress/conversions.stp: Test new functions.
* testsuite/buildok/conversions.stp: Test new functions.
* testsuite/buildok/conversions-embedded.stp: Test new functions.
Diffstat (limited to 'stapfuncs.5.in')
| -rw-r--r-- | stapfuncs.5.in | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/stapfuncs.5.in b/stapfuncs.5.in index 85a00b37..9bca845d 100644 --- a/stapfuncs.5.in +++ b/stapfuncs.5.in @@ -92,6 +92,60 @@ fault, return instead the err_msg value. user_string_warn:string (addr:long) Copy a string from user space at given address. If the access would fault, signal a warning and return "<unknown>". +.TP +user_string_quoted:string (addr:long) +Copy a string from user space at given address. Any ASCII characters +that are not printable are replaced by the corresponding escape +sequence in the returned string. +.TP +user_string_n:string (addr:long, n:long) +Copy a string of n bytes from user space at given address. If the access +would fault, return "<unknown>". +.TP +user_string_n2:string (addr:long, n:long, err_msg:string) +Copy a string of n bytes from user space at given address. If the access +would fault, return the err_msg value. +.TP +user_string_n_warn:string (addr:long, n:long) +Copy a string of n bytes from user space at given address. If the access +would fault, signal a warning and return "<unknown>". +.TP +user_string_n_quoted:string (addr:long, n:long) +Copy a string of n bytes from user space at given address. Any ASCII +characters that are not printable are replaced by the corresponding escape +sequence in the returned string. If the access would fault, return "<unknown>". +.TP +user_short:long (addr:long) +Copy a short from user space at given address. If the access would fault, +return 0. +.TP +user_short_warn:long (addr:long) +Copy a short from user space at given address. If the access would fault, +signal a warning and return 0. +.TP +user_int:long (addr:long) +Copy an int from user space at given address. If the access would fault, +return 0. +.TP +user_int_warn:long (addr:long) +Copy an int from user space at given address. If the access would fault, +signal a warning and return 0. +.TP +user_long:long (addr:long) +Copy a long from user space at given address. If the access would fault, +return 0. +.TP +user_long_warn:long (addr:long) +Copy a long from user space at given address. If the access would fault, +signal a warning and return 0. +.TP +user_char:long (addr:long) +Copy a char from user space at given address. If the access would fault, +return 0. +.TP +user_char_warn:long (addr:long) +Copy a char from user space at given address. If the access would fault, +signal a warning and return 0. .SS STRING .TP strlen:long (str:string) |