diff mbox

[v2,2/2] osdep: warn if opening a file O_DIRECT on tmpfs fails

Message ID 1377090999-18217-3-git-send-email-stefanha@redhat.com
State New
Headers show

Commit Message

Stefan Hajnoczi Aug. 21, 2013, 1:16 p.m. UTC
Print a warning when opening a file O_DIRECT on tmpfs fails.  This saves
users a lot of time trying to figure out the EINVAL error.

Daniel P. Berrange <berrange@redhat.com> suggested opening the file
without O_DIRECT as a portable way to check whether the file system
supports O_DIRECT.  That gets messy when flags contains O_CREAT since
we'd create a file but return an error - or a race condition if we try
to unlink the file.  It's simpler to check the file system type.

Reported-by: Deepak C Shetty <deepakcs@linux.vnet.ibm.com>
Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
---
 util/osdep.c | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

Comments

Markus Armbruster Aug. 21, 2013, 2:08 p.m. UTC | #1
Stefan Hajnoczi <stefanha@redhat.com> writes:

> Print a warning when opening a file O_DIRECT on tmpfs fails.  This saves

Only when it fails with EINVAL, actually.  Suggest "on tmpfs fails with
EINVAL."

> users a lot of time trying to figure out the EINVAL error.
>
> Daniel P. Berrange <berrange@redhat.com> suggested opening the file
> without O_DIRECT as a portable way to check whether the file system
> supports O_DIRECT.  That gets messy when flags contains O_CREAT since
> we'd create a file but return an error - or a race condition if we try
> to unlink the file.  It's simpler to check the file system type.
>
> Reported-by: Deepak C Shetty <deepakcs@linux.vnet.ibm.com>
> Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
> ---
>  util/osdep.c | 19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)
>
> diff --git a/util/osdep.c b/util/osdep.c
> index 685c8ae..446a1dc 100644
> --- a/util/osdep.c
> +++ b/util/osdep.c
> @@ -30,6 +30,11 @@
>  #include <unistd.h>
>  #include <fcntl.h>
>  
> +#ifdef __linux__
> +#include <sys/vfs.h>
> +#include <linux/magic.h>
> +#endif
> +
>  /* Needed early for CONFIG_BSD etc. */
>  #include "config-host.h"
>  
> @@ -207,6 +212,20 @@ int qemu_open(const char *name, int flags, ...)
>      }
>  #endif
>  
> +#ifdef __linux__
> +    /* It is not possible to open files O_DIRECT on tmpfs.  Provide a hint that
> +     * this may be the case (of course it could change in future kernel
> +     * versions).
> +     */
> +    if (ret == -1 && errno == EINVAL && (flags & O_DIRECT)) {
> +        struct statfs st;
> +        if (statfs(name, &st) == 0 && st.f_type == TMPFS_MAGIC) {
> +            error_report("tmpfs file systems may not support O_DIRECT");
> +        }
> +        errno = EINVAL; /* in case it was clobbered */
> +    }
> +#endif /* __linux__ */
> +
>      return ret;
>  }

In theory, the warning could be misleading, because we can get EINVAL
for reasons not related to flags & O_DIRECT.  In practice, the warning
probably does much more good than harm.
Eric Blake Aug. 21, 2013, 3:13 p.m. UTC | #2
On 08/21/2013 07:16 AM, Stefan Hajnoczi wrote:
> Print a warning when opening a file O_DIRECT on tmpfs fails.  This saves
> users a lot of time trying to figure out the EINVAL error.
> 
> Daniel P. Berrange <berrange@redhat.com> suggested opening the file
> without O_DIRECT as a portable way to check whether the file system
> supports O_DIRECT.  That gets messy when flags contains O_CREAT since
> we'd create a file but return an error - or a race condition if we try
> to unlink the file.  It's simpler to check the file system type.
> 
> Reported-by: Deepak C Shetty <deepakcs@linux.vnet.ibm.com>
> Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
> ---
>  util/osdep.c | 19 +++++++++++++++++++
>  1 file changed, 19 insertions(+)

Reviewed-by: Eric Blake <eblake@redhat.com>
Eric Blake Aug. 21, 2013, 7:04 p.m. UTC | #3
On 08/21/2013 07:16 AM, Stefan Hajnoczi wrote:
> Print a warning when opening a file O_DIRECT on tmpfs fails.  This saves
> users a lot of time trying to figure out the EINVAL error.
> 
> Daniel P. Berrange <berrange@redhat.com> suggested opening the file
> without O_DIRECT as a portable way to check whether the file system
> supports O_DIRECT.  That gets messy when flags contains O_CREAT since
> we'd create a file but return an error - or a race condition if we try
> to unlink the file.  It's simpler to check the file system type.

An alternative to this is as follows:

if the user passes in O_CREAT|O_DIRECT (but not O_EXCL), we _first_ try
O_CREAT|O_DIRECT|O_EXCL.  If that succeeds, O_DIRECT works and we
created the file, nothing further to do.  If it fails with EINVAL,
O_DIRECT is unsupported.  If it fails with EEXIST, the file already
exists, and we retry open(O_DIRECT) (no O_CREAT, because the file
already exists), and get our answer that way.  (It would be possible to
audit whether the kernel favors EINVAL vs. EEXIST in the case where both
errors are possible [ie. the file exists and O_DIRECT is unsupported],
to slightly optimize this code; but I'm not sure it's worth it).  If the
user passes in O_DIRECT but not O_CREAT, then you jump straight to the
middle case (since they didn't want creation in the first place).

That way, you can detect O_DIRECT failure on more than just tmpfs, and
without needing an #if __linux__, and with no nasty races in unlinking a
just-created file.  I'm starting to think Dan's suggestion has merit
after all, if done correctly.
Doug Goldstein Aug. 21, 2013, 7:48 p.m. UTC | #4
On Wed, Aug 21, 2013 at 9:08 AM, Markus Armbruster <armbru@redhat.com>wrote:

> Stefan Hajnoczi <stefanha@redhat.com> writes:
>
> > Print a warning when opening a file O_DIRECT on tmpfs fails.  This saves
>
> Only when it fails with EINVAL, actually.  Suggest "on tmpfs fails with
> EINVAL."
>
> > users a lot of time trying to figure out the EINVAL error.
> >
> > Daniel P. Berrange <berrange@redhat.com> suggested opening the file
> > without O_DIRECT as a portable way to check whether the file system
> > supports O_DIRECT.  That gets messy when flags contains O_CREAT since
> > we'd create a file but return an error - or a race condition if we try
> > to unlink the file.  It's simpler to check the file system type.
> >
> > Reported-by: Deepak C Shetty <deepakcs@linux.vnet.ibm.com>
> > Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
> > ---
> >  util/osdep.c | 19 +++++++++++++++++++
> >  1 file changed, 19 insertions(+)
> >
> > diff --git a/util/osdep.c b/util/osdep.c
> > index 685c8ae..446a1dc 100644
> > --- a/util/osdep.c
> > +++ b/util/osdep.c
> > @@ -30,6 +30,11 @@
> >  #include <unistd.h>
> >  #include <fcntl.h>
> >
> > +#ifdef __linux__
> > +#include <sys/vfs.h>
> > +#include <linux/magic.h>
> > +#endif
> > +
> >  /* Needed early for CONFIG_BSD etc. */
> >  #include "config-host.h"
> >
> > @@ -207,6 +212,20 @@ int qemu_open(const char *name, int flags, ...)
> >      }
> >  #endif
> >
> > +#ifdef __linux__
> > +    /* It is not possible to open files O_DIRECT on tmpfs.  Provide a
> hint that
> > +     * this may be the case (of course it could change in future kernel
> > +     * versions).
> > +     */
> > +    if (ret == -1 && errno == EINVAL && (flags & O_DIRECT)) {
> > +        struct statfs st;
> > +        if (statfs(name, &st) == 0 && st.f_type == TMPFS_MAGIC) {
> > +            error_report("tmpfs file systems may not support O_DIRECT");
> > +        }
> > +        errno = EINVAL; /* in case it was clobbered */
> > +    }
> > +#endif /* __linux__ */
> > +
> >      return ret;
> >  }
>
> In theory, the warning could be misleading, because we can get EINVAL
> for reasons not related to flags & O_DIRECT.  In practice, the warning
> probably does much more good than harm.
>
>
Actually EINVAL is only for O_DIRECT with open(). There are other
filesystems that will return this other than tmpfs as well, but we were
discussing /var/run so the assumption was tmpfs [1]. The code that performs
the check to see if EINVAL should be returned checks to see if the
direct_IO address space op is defined [2] (or get_xip_mem but that's
another story).

[1] https://www.redhat.com/archives/libvir-list/2013-August/msg00768.html
[2] http://lxr.linux.no/#linux+v3.10.9/fs/open.c#L651
diff mbox

Patch

diff --git a/util/osdep.c b/util/osdep.c
index 685c8ae..446a1dc 100644
--- a/util/osdep.c
+++ b/util/osdep.c
@@ -30,6 +30,11 @@ 
 #include <unistd.h>
 #include <fcntl.h>
 
+#ifdef __linux__
+#include <sys/vfs.h>
+#include <linux/magic.h>
+#endif
+
 /* Needed early for CONFIG_BSD etc. */
 #include "config-host.h"
 
@@ -207,6 +212,20 @@  int qemu_open(const char *name, int flags, ...)
     }
 #endif
 
+#ifdef __linux__
+    /* It is not possible to open files O_DIRECT on tmpfs.  Provide a hint that
+     * this may be the case (of course it could change in future kernel
+     * versions).
+     */
+    if (ret == -1 && errno == EINVAL && (flags & O_DIRECT)) {
+        struct statfs st;
+        if (statfs(name, &st) == 0 && st.f_type == TMPFS_MAGIC) {
+            error_report("tmpfs file systems may not support O_DIRECT");
+        }
+        errno = EINVAL; /* in case it was clobbered */
+    }
+#endif /* __linux__ */
+
     return ret;
 }