From 71ea998616b1385f171e4bfd183f09d1c091b702 Mon Sep 17 00:00:00 2001
From: Jason Gerfen <jas@php.net>
Date: Fri, 4 Apr 2014 11:56:55 +0000
Subject: [PATCH] Updated example usage to include <keygen> element

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@333257 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../openssl-spki-export-challenge.xml         | 14 ++++++++++++++
 .../openssl/functions/openssl-spki-export.xml | 19 +++++++++++++++++++
 .../openssl/functions/openssl-spki-verify.xml | 18 ++++++++++++++++++
 3 files changed, 51 insertions(+)

diff --git a/reference/openssl/functions/openssl-spki-export-challenge.xml b/reference/openssl/functions/openssl-spki-export-challenge.xml
index e1cb0d42cb..8d872e3327 100644
--- a/reference/openssl/functions/openssl-spki-export-challenge.xml
+++ b/reference/openssl/functions/openssl-spki-export-challenge.xml
@@ -61,6 +61,20 @@ $pkey = openssl_pkey_new('secret password');
 $spkac = openssl_spki_new($pkey, 'challenge string');
 $challenge = openssl_spki_export_challenge(preg_replace('/SPKAC=/', '', $spkac));
 ?>
+]]>
+   </programlisting>
+  </example>
+  <example xml:id="openssl_spki_export_challenge.example.keygen">
+   <title><function>openssl_spki_export_challenge</function> example from &lt;keygen&gt;</title>
+   <para>
+      Extracts the associated challenge string or NULL on failure 
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$challenge = openssl_spki_export_challenge(preg_replace('/SPKAC=/, '', $_POST['spkac']));
+?>
+<keygen name="spkac" challenge="challenge string" keytype="RSA">
 ]]>
    </programlisting>
   </example>
diff --git a/reference/openssl/functions/openssl-spki-export.xml b/reference/openssl/functions/openssl-spki-export.xml
index b978beed7c..bf24c6ef59 100644
--- a/reference/openssl/functions/openssl-spki-export.xml
+++ b/reference/openssl/functions/openssl-spki-export.xml
@@ -65,6 +65,25 @@ if ($pubKey) {
     echo $pubKey;
 }
 ?>
+]]>
+   </programlisting>
+  </example>
+  <example xml:id="openssl_spki_export.example.keygen">
+   <title><function>openssl_spki_export</function> example from &lt;keygen&gt;</title>
+   <para>
+      Extracts the associated PEM formatted public key or NULL on failure 
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$spkac = openssl_spki_export(preg_replace('/SPKAC=/, '', $_POST['spkac']));
+if ($spkac != NULL) {
+    echo $spkac;
+} else {
+    echo "Extraction of pub key failed";
+}
+?>
+<keygen name="spkac" challenge="challenge string" keytype="RSA">
 ]]>
    </programlisting>
   </example>
diff --git a/reference/openssl/functions/openssl-spki-verify.xml b/reference/openssl/functions/openssl-spki-verify.xml
index 2051d4b196..67f51e2338 100644
--- a/reference/openssl/functions/openssl-spki-verify.xml
+++ b/reference/openssl/functions/openssl-spki-verify.xml
@@ -66,6 +66,24 @@ if (openssl_spki_verify(preg_replace('/SPKAC=/', '', $spkac))) {
     echo "SPKAC validation failed";
 }
 ?>
+]]>
+   </programlisting>
+  </example>
+  <example xml:id="openssl_spki_verify.example.keygen">
+   <title><function>openssl_spki_verify</function> example from &lt;keygen&gt;</title>
+   <para>
+      Validates an existing signed public key and challenge issued from the 
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+if (openssl_spki_verify(preg_replace('/SPKAC=/', '', $_POST['spkac']))) {
+    echo $spkac;
+} else {
+    echo "SPKAC validation failed";
+}
+?>
+<keygen name="spkac" challenge="challenge string" keytype="RSA">
 ]]>
    </programlisting>
   </example>