Hello Helge,
On 22 May 2018 at 15:14, Helge Deller <deller@xxxxxx> wrote:
> The parisc gateway page currently only exports 3 functions:
> The lws_entry for CAS operations (at 0xb0), the set_thread_pointer
> function for usage in glibc (at 0xe0) and the linux syscall entry (at
> 0x100).
>
> All other symbols in the manpage are internal labels and shouldn't be
> used directly by userspace or glibc, so drop them from the man page
> documentation.
Can I clarify a point here. You say they are "internal labels that
shouldn't be used". This seems a little contradictory. Am I correct to
understand that what you mean is that those symbols are actually
visible but should be used? If yes, maybe some words need to be added
to the text to bring this point across.
Thanks,
Michael
>
> Signed-off-by: Helge Deller <deller@xxxxxx>
>
> diff --git a/man7/vdso.7 b/man7/vdso.7
> index 6eec351e5..6ee64ed4b 100644
> --- a/man7/vdso.7
> +++ b/man7/vdso.7
> @@ -322,7 +322,7 @@ set_tid_address
> .SS parisc (hppa) functions
> .\" See linux/arch/parisc/kernel/syscall.S
> .\" See linux/Documentation/parisc/registers
> -The parisc port has a code page full of utility functions
> +The parisc port has a code page with utility functions
> called a gateway page.
> Rather than use the normal ELF auxiliary vector approach,
> it passes the address of
> @@ -344,21 +344,9 @@ for example:
> l l.
> offset function
> _
> -00b0 lws_entry
> -00e0 set_thread_pointer
> +00b0 lws_entry (CAS operations)
> +00e0 set_thread_pointer (used by glibc)
> 0100 linux_gateway_entry (syscall)
> -0268 syscall_nosys
> -0274 tracesys
> -0324 tracesys_next
> -0368 tracesys_exit
> -03a0 tracesys_sigexit
> -03b8 lws_start
> -03dc lws_exit_nosys
> -03e0 lws_exit
> -03e4 lws_compare_and_swap64
> -03e8 lws_compare_and_swap
> -0404 cas_wouldblock
> -0410 cas_action
> .TE
> .if t \{\
> .in
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
