libblkid: add blkit_[un]ref() to TODO

Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/TODO b/TODO
index 93a59f63b4395ec6487dd96f58f6179e538e7296..27e2b3229835c592d696adbdd2556a6521b7121a 100644 (file)
--- a/TODO
+++ b/TODO
@@ -19,11 +19,15 @@ libblkid
 
        FSSIZE   -- filesystem size (klibc requirement)
 
-       SBOFFSET -- superblock offset; offset where SB was detected 
-                    (swapon requirement to check details from swap header)
+ - add reference counters to the binary interfaces. Currently, all chain 
+   data are allocated in blkid_probe and cannot be used independently on 
+   the probing stuff.
 
-        MAGIC    -- magic string
-       MAGICLEN -- length of magic string
+       blkid_topology tp = blkdi_probe_get_topology(pr)
+
+       blkid_ref(tp);
+       ...
+       blkid_unref(tp);
 
 fdisk(s)
 --------

diff --git a/shlibs/blkid/src/partitions/partitions.c b/shlibs/blkid/src/partitions/partitions.c
index aa70df638ab993bf94d4104b991cefb5fefdabee..82861a5b362d7574cc3bc375d11b1e54e37e1195 100644 (file)
--- a/shlibs/blkid/src/partitions/partitions.c
+++ b/shlibs/blkid/src/partitions/partitions.c
@@ -258,6 +258,14 @@ int blkid_probe_filter_partitions_type(blkid_probe pr, int flag, char *names[])
  * This function is independent on blkid_do_[safe,full]probe() and
  * blkid_probe_enable_partitions() calls.
  *
+ * WARNING: the returned object will be overwritten by the next
+ *          blkid_probe_get_partitions() call for the same @pr. If you want to
+ *          use more blkid_partlist objects in the same time you have to create
+ *          more blkid_probe handlers (see blkid_new_probe()).
+ *
+ * TODO:    add blkid_ref() and blkid_unref() to allows to use blkid_partlist
+ *          independently on libblkid probing stuff.
+ *
  * Returns: list of partitions, or NULL in case of error.
  */
 blkid_partlist blkid_probe_get_partitions(blkid_probe pr)

diff --git a/shlibs/blkid/src/topology/topology.c b/shlibs/blkid/src/topology/topology.c
index f4cd3219187124a8ec562f5ee4819352381f5498..80499005faccba01b47650b8477daa1ac6d74e0a 100644 (file)
--- a/shlibs/blkid/src/topology/topology.c
+++ b/shlibs/blkid/src/topology/topology.c
@@ -108,6 +108,14 @@ int blkid_probe_enable_topology(blkid_probe pr, int enable)
  * This function is independent on blkid_do_[safe,full]probe() and
  * blkid_probe_enable_topology() calls.
  *
+ * WARNING: the returned object will be overwritten by the next
+ *          blkid_probe_get_topology() call for the same @pr. If you want to
+ *          use more blkid_tolopogy objects in the same time you have to create
+ *          more blkid_probe handlers (see blkid_new_probe()).
+ *
+ * TODO:    add blkid_ref() and blkid_unref() to allows to use blkid_topology
+ *          independently on libblkid probing stuff.
+ *
  * Returns: blkid_tolopogy, or NULL in case of error.
  */
 blkid_topology blkid_probe_get_topology(blkid_probe pr)