[patch] getcontext.3: Exemplar structure should use 'ucontext_t'.

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



getcontext.3: Exemplar structure should use 'ucontext_t'.

In glibc we just finished a round of purging 'struct ucontext' which
is not in the POSIX reserved namespace of *_t tags. This has some
consequences to applications using the non-standard struct ucontext:
https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
but it also fixes a namespace conformance issue which is always a longterm
pain for large portable programs.

It was noted by Peter Maydell (https://sourceware.org/bugzilla/show_bug.cgi?id=21457)
that the linux man pages still had references to 'struct ucontext' but only in
the form of an exemplar structure.

The following patch fixes the exemplar to match what is in glibc and therefore
it won't ever suggest users can use 'struct ucontext'.

Applies to master.

Please apply.

Signed-off-by: Carlos O'Donell <carlos@xxxxxxxxxx>
---
diff --git a/man3/getcontext.3 b/man3/getcontext.3
index c31a46b..de54d12 100644
--- a/man3/getcontext.3
+++ b/man3/getcontext.3
@@ -57,11 +57,11 @@ the following fields:
 .in +4
 .nf
 
-typedef struct ucontext {
-    struct ucontext *uc_link;
-    sigset_t         uc_sigmask;
-    stack_t          uc_stack;
-    mcontext_t       uc_mcontext;
+typedef struct ucontext_t {
+    struct ucontext_t *uc_link;
+    sigset_t          uc_sigmask;
+    stack_t           uc_stack;
+    mcontext_t        uc_mcontext;
     ...
 } ucontext_t;
 
-- 
Cheers,
Carlos.
--
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



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux