From: Richard W.M. Jones <rjones@redhat.com>
Date: Sat, 20 Jun 2009 14:30:39 +0000 (+0100)
Subject: Add strong note about deprecation of functions which take either device names or... 
X-Git-Tag: 1.0.50~7
X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=commitdiff_plain;h=3ab8336db394683dad5f485388461e9146ac04ad;hp=3c5b447efd42b03c24104bdc1f3260e879bb1d25

Add strong note about deprecation of functions which take either device names or filenames.
---

diff --git a/daemon/daemon.h b/daemon/daemon.h
index c3b9120..115db09 100644
--- a/daemon/daemon.h
+++ b/daemon/daemon.h
@@ -139,7 +139,13 @@ extern void reply (xdrproc_t xdrp, char *ret);
 
 /* Helper for functions which need either an absolute path in the
  * mounted filesystem, OR a /dev/ device which exists.
+ *
  * NB. Cannot be used for FileIn functions.
+ *
+ * NB #2: Functions which mix filenames and device paths should be
+ * avoided, and existing functions should be deprecated.  This is
+ * because we intend in future to make device parameters a distinct
+ * type from filenames.
  */
 #define NEED_ROOT_OR_IS_DEVICE(path,errcode) \
   do {									\