diff options
Diffstat (limited to 'static/plan9-4e/man2/getcallerpc.2')
| -rw-r--r-- | static/plan9-4e/man2/getcallerpc.2 | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/static/plan9-4e/man2/getcallerpc.2 b/static/plan9-4e/man2/getcallerpc.2 new file mode 100644 index 00000000..f7505ce5 --- /dev/null +++ b/static/plan9-4e/man2/getcallerpc.2 @@ -0,0 +1,38 @@ +.TH GETCALLERPC 2 +.SH NAME +getcallerpc \- fetch return PC of current function +.SH SYNOPSIS +.br +.B #include <u.h> +.br +.B #include <libc.h> +.PP +.B ulong getcallerpc(void *firstarg) +.SH DESCRIPTION +.I Getcallerpc +is a portable way to discover the PC to which the current function will return. +.I Firstarg +should be a pointer to the first argument to the function in question. +.SH EXAMPLE +.IP +.EX +void +printpc(ulong arg) +{ + print("Called from %.8lux\en", getcallerpc(&arg)); +} + +void +main(int argc, char *argv[]) +{ + printpc(0); + printpc(0); + printpc(0); +} +.EE +.SH SOURCE +.B /sys/src/libc/$objtype/getcallerpc.[cs] +.SH BUGS +The +.I firstarg +parameter should not be necessary. |