summaryrefslogtreecommitdiffstats
path: root/daemon/daemon.h
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2009-06-20 15:30:39 +0100
committerRichard W.M. Jones <rjones@redhat.com>2009-06-20 15:30:39 +0100
commit3ab8336db394683dad5f485388461e9146ac04ad (patch)
tree4ab5c033b6cdcb14c3422015ac957bb123a97b8b /daemon/daemon.h
parent3c5b447efd42b03c24104bdc1f3260e879bb1d25 (diff)
downloadlibguestfs-3ab8336db394683dad5f485388461e9146ac04ad.tar.gz
libguestfs-3ab8336db394683dad5f485388461e9146ac04ad.tar.xz
libguestfs-3ab8336db394683dad5f485388461e9146ac04ad.zip
Add strong note about deprecation of functions which take either device names or filenames.
Diffstat (limited to 'daemon/daemon.h')
-rw-r--r--daemon/daemon.h6
1 files changed, 6 insertions, 0 deletions
diff --git a/daemon/daemon.h b/daemon/daemon.h
index c3b91209..115db093 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 { \