(** Mark objects as 'ancient' so they are taken out of the OCaml heap.
- * $Id: ancient.mli,v 1.4 2006-09-28 12:40:07 rich Exp $
+ * $Id: ancient.mli,v 1.6 2006-10-09 12:18:05 rich Exp $
*)
type 'a ancient
* Forgetting to delete an ancient object results in a memory leak.
*)
+val is_ancient : 'a -> bool
+ (** [is_ancient ptr] returns true if [ptr] is an object on the ancient
+ * heap.
+ *)
+
(** {6 Shared memory mappings} *)
type md
* file. See {!Ancient.attach}, {!Ancient.detach}.
*
* More than one object can be stored in a file. They are
- * indexed using integers in the range [0..1023] (the limit
+ * indexed using integers in the range [0..max_key] (the limit
* is hard-coded in [mmalloc/mmprivate.h]). The [key] parameter
* controls which object is written/overwritten by [share].
* If you do not wish to use this feature, just pass [0]
(** [get md key] returns the object indexed by [key] in the
* attached file.
*
- * The key is in the range [0..1023] (the limit is hard-coded in
+ * The key is in the range [0..max_key] (the limit is hard-coded in
* [mmalloc/mmprivate.h]). If you do not wish to use this feature,
* just pass [0] as the key when sharing / getting.
*
* You need to annotate the returned object with the correct
* type. As with the Marshal module, there is no type checking,
* and setting the wrong type will likely cause a segfault
- * or undefined behaviour.
+ * or undefined behaviour. Note that the returned object has
+ * type [sometype ancient], not just [sometype].
*
* @raises [Not_found] if no object is associated with the key.
*)
+
+val max_key : int