[PATCH] vdso.7: update for MIPS

[PATCH] vdso.7: update for MIPS

[Zubair Lutfullah Kakakhel]

Document the symbols exported by the MIPS VDSO.
VDSO support was added from kernel 4.4 onwards.

See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso

Signed-off-by: Zubair Lutfullah Kakakhel <Zubair.Kakakhel-1AXoQHu6uovQT0dZR+AlfA@public.gmane.org>
---
 man7/vdso.7 | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/man7/vdso.7 b/man7/vdso.7
index 5eb885f..3c5f1a4 100644
--- a/man7/vdso.7
+++ b/man7/vdso.7
@@ -150,6 +150,7 @@ _
 aarch64	linux-vdso.so.1
 arm	linux-vdso.so.1
 ia64	linux-gate.so.1
+mips	linux-vdso.so.1
 ppc/32	linux-vdso32.so.1
 ppc/64	linux-vdso64.so.1
 s390	linux-vdso32.so.1
@@ -247,6 +248,27 @@ For information on this code page,
 it's best to refer to the public documentation:
 .br
 http://docs.blackfin.uclinux.org/doku.php?id=linux-kernel:fixed-code
+.SS mips functions
+.\" See linux/arch/mips/vdso/vdso.ld.S
+
+The table below lists the symbols exported by the vDSO.
+.if t \{\
+.ft CW
+\}
+.TS
+l l.
+symbol	version
+_
+__kernel_gettimeofday	LINUX_2.6 (exported since Linux 4.4)
+__kernel_clock_gettime	LINUX_2.6 (exported since Linux 4.4)
+.TE
+.if t \{\
+.in
+.ft P
+\}
+
+.br
+
 .SS ia64 (Itanium) functions
 .\" See linux/arch/ia64/kernel/gate.lds.S
 .\" Also linux/arch/ia64/kernel/fsys.S and linux/Documentation/ia64/fsys.txt
-- 
1.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] vdso.7: update for MIPS

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 368 bytes --]

On 05 Apr 2016 16:24, Zubair Lutfullah Kakakhel wrote:
> Document the symbols exported by the MIPS VDSO.
> VDSO support was added from kernel 4.4 onwards.
> 
> See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso

is there a reason for not exporting sigreturn/rt_sigreturn even though
it's included in the vdso image ?
-mike

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 819 bytes --]

[PATCHv2] vdso.7: update for MIPS

[Zubair Lutfullah Kakakhel]

Document the symbols exported by the MIPS VDSO.
VDSO support was added from kernel 4.4 onwards.

See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso

Signed-off-by: Zubair Lutfullah Kakakhel <Zubair.Kakakhel-1AXoQHu6uovQT0dZR+AlfA@public.gmane.org>
---
V2 -> V1
Added sigreturn/rt_sigreturn as well
---
 man7/vdso.7 | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/man7/vdso.7 b/man7/vdso.7
index 5eb885f..9a96df8 100644
--- a/man7/vdso.7
+++ b/man7/vdso.7
@@ -150,6 +150,7 @@ _
 aarch64	linux-vdso.so.1
 arm	linux-vdso.so.1
 ia64	linux-gate.so.1
+mips	linux-vdso.so.1
 ppc/32	linux-vdso32.so.1
 ppc/64	linux-vdso64.so.1
 s390	linux-vdso32.so.1
@@ -247,6 +248,29 @@ For information on this code page,
 it's best to refer to the public documentation:
 .br
 http://docs.blackfin.uclinux.org/doku.php?id=linux-kernel:fixed-code
+.SS mips functions
+.\" See linux/arch/mips/vdso/vdso.ld.S
+
+The table below lists the symbols exported by the vDSO.
+.if t \{\
+.ft CW
+\}
+.TS
+l l.
+symbol	version
+_
+__kernel_gettimeofday	LINUX_2.6 (exported since Linux 4.4)
+__kernel_clock_gettime	LINUX_2.6 (exported since Linux 4.4)
+__kernel_rt_sigreturn	LINUX_2.6 (exported since Linux 4.4)
+__kernel_sigreturn	LINUX_2.6 (exported since Linux 4.4)
+.TE
+.if t \{\
+.in
+.ft P
+\}
+
+.br
+
 .SS ia64 (Itanium) functions
 .\" See linux/arch/ia64/kernel/gate.lds.S
 .\" Also linux/arch/ia64/kernel/fsys.S and linux/Documentation/ia64/fsys.txt
-- 
1.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCHv2] vdso.7: update for MIPS

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 443 bytes --]

On 12 Apr 2016 09:13, Zubair Lutfullah Kakakhel wrote:
> +__kernel_rt_sigreturn	LINUX_2.6 (exported since Linux 4.4)
> +__kernel_sigreturn	LINUX_2.6 (exported since Linux 4.4)

are these actually exported ?  looking at vdso.lds.S, only the other two
are.  my question previously was more about the kernel behavior than it
was about the docs being incorrect.  your v1 looks fine to merge now (as
the 4.4 release is already out the door).
-mike

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 819 bytes --]

Re: [PATCHv2] vdso.7: update for MIPS

[Michael Kerrisk (man-pages)]

On 04/13/2016 03:08 AM, Mike Frysinger wrote:
> On 12 Apr 2016 09:13, Zubair Lutfullah Kakakhel wrote:
>> +__kernel_rt_sigreturn	LINUX_2.6 (exported since Linux 4.4)
>> +__kernel_sigreturn	LINUX_2.6 (exported since Linux 4.4)
> 
> are these actually exported ?  looking at vdso.lds.S, only the other two
> are.  my question previously was more about the kernel behavior than it
> was about the docs being incorrect.  your v1 looks fine to merge now (as
> the 4.4 release is already out the door).
> -mike

Thanks for noting this Mike.

Zubair, I've applied the v1 of your patch.

Cheers,

Michael


-- 
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-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html