This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH v2] manual/probes.texi: Add documentation of setjmp/longjmp probes
- From: Roland McGrath <roland at hack dot frob dot com>
- To: Will Newton <will dot newton at linaro dot org>
- Cc: libc-alpha at sourceware dot org, patches at linaro dot org
- Date: Thu, 30 Jan 2014 12:42:32 -0800 (PST)
- Subject: Re: [PATCH v2] manual/probes.texi: Add documentation of setjmp/longjmp probes
- Authentication-results: sourceware.org; auth=none
- References: <1391078864-19422-1-git-send-email-will dot newton at linaro dot org>
> +These probes are used to signal calls to @code{setjmp}, @code{sigsetjmp}
> +or @code{longjmp}.
Also siglongjmp.
> +@deftp Probe longjmp (void *@var{$arg1}, int @var{$arg2}, void *@var{$arg3})
> +This probe is hit whenever @code{longjmp} is called. Argument @var{$arg1}
or @code{siglongjmp}. Two spaces between sentences.
> +The longjmp probe is hit at a point where the registers have not yet been
Put longjmp in @code or @samp.
> +@deftp Probe longjmp_target (void *@var{$arg1}, int @var{$arg2}, void *@var{$arg3})
> +This probe is hit whenever @code{longjmp} is called. Argument @var{$arg1}
Just say that it is the same as the longjmp probe, rather than repeating an
identical paragraph.
> +The longjmp_target probe is hit at a point where the registers have been
> +restored to the values in the @code{jmp_buf} and unwinding will show a
> +call stack including the caller of @code{setjmp} or @code{sigsetjmp}.
> +@end deftp
Put longjmp_target in @code or @samp.