[openssl-commits] [web] master update

[Rich Salz]

The branch master has been updated
       via  61526bce1d7fd854574a8c3ea7d6ffbb56a2e7c7 (commit)
      from  874c514e441cbc491ee6d419dff1536572008853 (commit)


- Log -----------------------------------------------------------------
commit 61526bce1d7fd854574a8c3ea7d6ffbb56a2e7c7
Author: Rich Salz <rsalz at akamai.com>
Date:   Mon Jan 1 11:43:50 2018 -0500

    Issue #19; FAQ for opaque structures

-----------------------------------------------------------------------

Summary of changes:
 docs/faq-3-prog.txt | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/faq-3-prog.txt b/docs/faq-3-prog.txt
index 8665b0a..d1bb9c9 100644
--- a/docs/faq-3-prog.txt
+++ b/docs/faq-3-prog.txt
@@ -15,6 +15,18 @@ the CRYPTO_THREADID_set... API's.  See the OpenSSL threads manpage for
 details and "note on multi-threading" in the INSTALL file in the source
 distribution.
 
+* My code gets "undefined structure" when building with 1.1.0 or later.
+
+In 1.1.0 we made most of the structures opaque. This means that you can
+no longer access the fields directly, but must use settor and accessor
+functions. You can also no longer have direct instances of the objects,
+but can only use pointers to them.
+For example, the first line below is wrong; the second is correct:
+<PRE>
+    RSA r; /* wrong */
+    RSA *r; /* right */
+</PRE>
+
 * I've compiled a program under Windows and it crashes: why?
 
 This is usually because you've missed the comment in INSTALL.W32.