From 4f1439de0f0dbe97c129202be86b6b41457d5af9 Mon Sep 17 00:00:00 2001
From: Michael Wallner <mike@php.net>
Date: Tue, 5 Nov 2013 12:14:13 +0100
Subject: [PATCH] flush

---
 raphf.md                          | 18 +++++++++++++++
 raphf/clean_persistent_handles.md | 14 ++++++++++++
 raphf/stat_persistent_handles.md  | 37 +++++++++++++++++++++++++++++++
 3 files changed, 69 insertions(+)
 create mode 100644 raphf.md
 create mode 100644 raphf/clean_persistent_handles.md
 create mode 100644 raphf/stat_persistent_handles.md

diff --git a/raphf.md b/raphf.md
new file mode 100644
index 0000000..5b112a2
--- /dev/null
+++ b/raphf.md
@@ -0,0 +1,18 @@
+# pecl/raphf
+
+## About:
+
+The **"Resource and Persistent Handle Factory"** extension provides facilities to manage those in a convenient manner.
+
+> **Note:** This extension mostly only provides infrastructure for other extensions.
+
+## Installation:
+
+This extension is hosted at PECL (<http://pecl.php.net>) and can be installed eith PEAR's pecl command:
+
+    # pecl install raphf
+
+## INI Directives:
+
+* raphf.persistent_handle.limit = -1  
+  The per process/thread persistent handle limit.
diff --git a/raphf/clean_persistent_handles.md b/raphf/clean_persistent_handles.md
new file mode 100644
index 0000000..ad8a8ac
--- /dev/null
+++ b/raphf/clean_persistent_handles.md
@@ -0,0 +1,14 @@
+# void raphf\clean_persistent_handles([string name = NULL[, string $ident]])
+
+Clean persistent handles whith id $name->$ident.
+
+## Params
+
+* Optional string $name = NULL  
+  The persistent handle id.
+* Optional string $ident = NULL  
+  The unique identifier within the persistent handle id.
+
+## Example:
+
+    raphf\clean_persistent_handles("http\\Client\\Curl\\Request", "php.net:80");
diff --git a/raphf/stat_persistent_handles.md b/raphf/stat_persistent_handles.md
new file mode 100644
index 0000000..7764187
--- /dev/null
+++ b/raphf/stat_persistent_handles.md
@@ -0,0 +1,37 @@
+# object raphf\stat_persistent_handles()
+
+Retrieve statistics about current process'/thread's persistent handles.
+
+## Params:
+
+None.
+
+## Returns:
+
+* object, stdClass instance
+
+
+## Example:
+
+    var_dump(raphf\stat_persistent_handles());
+
+Yields:
+
+    object(stdClass)#6 (3) {
+        ["http\Client\Curl"]=>
+        array(0) {
+        }
+        ["http\Client\Curl\Request"]=>
+        array(1) {
+        ["php.net:80"]=>
+        array(2) {
+          ["used"]=>
+          int(2)
+          ["free"]=>
+          int(1)
+        }
+        }
+        ["pq\Connection"]=>
+        array(0) {
+        }
+    }
-- 
2.30.2