ruby-magic 0.2.0 → 0.3.0

data/ext/magic/functions.h

@@ -1,23 +1,3 @@
-/* :enddoc: */
-
-/*
- * functions.h
- *
- * Copyright 2013-2015 Krzysztof Wilczynski
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
 #if !defined(_FUNCTIONS_H)
 #define _FUNCTIONS_H 1
 
@@ -27,78 +7,56 @@ extern "C" {
 
 #include "common.h"
 
-#if defined(HAVE_BROKEN_MAGIC)
-# define OVERRIDE_LOCALE(f, r, ...)           \
-    do {                                      \
-        save_t __l_##f;                       \
-        override_current_locale(&(__l_##f));  \
-        r = f(__VA_ARGS__);                   \
-        restore_current_locale(&(__l_##f));   \
-    } while(0)
-#else
-# define OVERRIDE_LOCALE(f, r, ...) \
-    do {                            \
-        r = f(__VA_ARGS__);         \
-    } while(0)
-#endif
-
-#define SUPPRESS_EVERYTHING(f, r, ...)      \
-    do {                                    \
-        save_t __e_##f;                     \
-        suppress_error_output(&(__e_##f));  \
-        OVERRIDE_LOCALE(f, r, __VA_ARGS__); \
-        restore_error_output(&(__e_##f));   \
-    } while(0)
-
-#define MAGIC_FUNCTION(f, r, x, ...)                \
-     do {                                           \
-        if ((x) & MAGIC_ERROR) {                    \
-            OVERRIDE_LOCALE(f, r, __VA_ARGS__);     \
-        }                                           \
-        else {                                      \
-            SUPPRESS_EVERYTHING(f, r, __VA_ARGS__); \
-        }                                           \
-     } while(0)
-
-struct file_data {
-    int old_fd;
-    int new_fd;
-    fpos_t position;
-};
-
-typedef struct file_data file_data_t;
-
-struct locale_data {
-#if defined(HAVE_SAFE_LOCALE)
-    locale_t old_locale;
-    locale_t new_locale;
-#else
-    char *old_locale;
-#endif
-};
+#define MAGIC_FUNCTION(f, r, x, ...)			 \
+	do {						 \
+		if ((x) & MAGIC_DEBUG)			 \
+			r = f(__VA_ARGS__);		 \
+		else {					 \
+			save_t __##f;			 \
+			override_error_output(&(__##f)); \
+			r = f(__VA_ARGS__);		 \
+			restore_error_output(&(__##f));  \
+		}					 \
+	} while(0)
+
+typedef struct file_data {
+	fpos_t position;
+	int old_fd;
+	int new_fd;
+} file_data_t;
+
+typedef struct save {
+	file_data_t file;
+	int status;
+} save_t;
+
+extern magic_t magic_open_wrapper(int flags);
+extern void magic_close_wrapper(magic_t magic);
+
+extern const char* magic_error_wrapper(magic_t magic);
+extern int magic_errno_wrapper(magic_t magic);
 
-typedef struct locale_data locale_data_t;
+extern const char* magic_getpath_wrapper(void);
 
-struct save {
-    int status;
-    union {
-        file_data_t file;
-        locale_data_t locale;
-    } data;
-};
+extern int magic_getparam_wrapper(magic_t magic, int parameter, void *value);
+extern int magic_setparam_wrapper(magic_t magic, int parameter,
+				  const void *value);
 
-typedef struct save save_t;
+extern int magic_getflags_wrapper(magic_t magic);
+extern int magic_setflags_wrapper(magic_t magic, int flags);
 
-extern const char* magic_getpath_wrapper(void);
+extern int magic_load_wrapper(magic_t magic, const char *magic_file, int flags);
+extern int magic_load_buffers_wrapper(magic_t magic, void **buffers,
+				      size_t *sizes, size_t count, int flags);
 
-extern int magic_setflags_wrapper(struct magic_set *ms, int flags);
-extern int magic_load_wrapper(struct magic_set *ms, const char *magicfile, int flags);
-extern int magic_compile_wrapper(struct magic_set *ms, const char *magicfile, int flags);
-extern int magic_check_wrapper(struct magic_set *ms, const char *magicfile, int flags);
+extern int magic_compile_wrapper(magic_t magic, const char *magic_file, int flags);
+extern int magic_check_wrapper(magic_t magic, const char *magic_file, int flags);
 
-extern const char* magic_file_wrapper(struct magic_set *ms, const char *filename, int flags);
-extern const char* magic_buffer_wrapper(struct magic_set *ms, const void *buffer, size_t size, int flags);
-extern const char* magic_descriptor_wrapper(struct magic_set *ms, int fd, int flags);
+extern const char* magic_file_wrapper(magic_t magic, const char *filename,
+				      int flags);
+extern const char* magic_buffer_wrapper(magic_t magic, const void *buffer,
+					size_t size, int flags);
+extern const char* magic_descriptor_wrapper(magic_t magic, int fd, int flags);
 
 extern int magic_version_wrapper(void);
 
@@ -107,5 +65,3 @@ extern int magic_version_wrapper(void);
 #endif
 
 #endif /* _FUNCTIONS_H */
-
-/* vim: set ts=8 sw=4 sts=2 et : */

data/ext/magic/ruby-magic.c

@@ -1,48 +1,39 @@
-/* :stopdoc: */
-
-/*
- * ruby-magic.c
- *
- * Copyright 2013-2015 Krzysztof Wilczynski
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
 #if defined(__cplusplus)
 extern "C" {
 #endif
 
 #include "ruby-magic.h"
 
-ID id_at_flags, id_at_path, id_at_mutex;
+static int rb_mgc_do_not_auto_load;
+static int rb_mgc_do_not_stop_on_error;
+static int rb_mgc_warning;
+
+ID id_at_flags;
+ID id_at_paths;
 
-VALUE rb_cMagic = Qnil;
+VALUE rb_cMagic = Qundef;
 
-VALUE rb_mgc_eError = Qnil;
-VALUE rb_mgc_eMagicError = Qnil;
-VALUE rb_mgc_eLibraryError = Qnil;
-VALUE rb_mgc_eFlagsError = Qnil;
-VALUE rb_mgc_eNotImplementedError = Qnil;
+VALUE rb_mgc_eError = Qundef;
+VALUE rb_mgc_eMagicError = Qundef;
+VALUE rb_mgc_eLibraryError = Qundef;
+VALUE rb_mgc_eParameterError = Qundef;
+VALUE rb_mgc_eFlagsError = Qundef;
+VALUE rb_mgc_eNotImplementedError = Qundef;
 
 void Init_magic(void);
 
-static VALUE magic_close_internal(void *data);
+static VALUE magic_get_parameter_internal(void *data);
+static VALUE magic_set_parameter_internal(void *data);
+static VALUE magic_get_flags_internal(void *data);
+static VALUE magic_set_flags_internal(void *data);
 static VALUE magic_load_internal(void *data);
+static VALUE magic_load_buffers_internal(void *data);
 static VALUE magic_compile_internal(void *data);
 static VALUE magic_check_internal(void *data);
 static VALUE magic_file_internal(void *data);
 static VALUE magic_buffer_internal(void *data);
 static VALUE magic_descriptor_internal(void *data);
+static VALUE magic_close_internal(void *data);
 
 static void* nogvl_magic_load(void *data);
 static void* nogvl_magic_compile(void *data);
@@ -51,937 +42,1554 @@ static void* nogvl_magic_file(void *data);
 static void* nogvl_magic_descriptor(void *data);
 
 static VALUE magic_allocate(VALUE klass);
+static void magic_mark(void *data);
 static void magic_free(void *data);
-
 static VALUE magic_exception_wrapper(VALUE value);
 static VALUE magic_exception(void *data);
-
+static void magic_library_close(void *data);
 static VALUE magic_library_error(VALUE klass, void *data);
 static VALUE magic_generic_error(VALUE klass, int magic_errno,
-        const char *magic_error);
-
-static VALUE magic_lock(VALUE object, VALUE (*function)(ANYARGS), void *data);
+				 const char *magic_error);
+static VALUE magic_lock(VALUE object, VALUE (*function)(ANYARGS),
+			void *data);
 static VALUE magic_unlock(VALUE object);
+static VALUE magic_return(void *data);
+static int magic_flags(VALUE object);
+static int magic_set_flags(VALUE object, VALUE value);
+static VALUE magic_set_paths(VALUE object, VALUE value);
 
-static VALUE magic_return(VALUE value, void *data);
+/*
+ * call-seq:
+ *    Magic.do_not_auto_load -> boolean
+ *
+ * Returns +true+ if the global +do_not_auto_load+ flag is set, or +false+
+ * otherwise.
+ *
+ * Example:
+ *
+ *    Magic.do_not_auto_load        #=> false
+ *    Magic.do_not_auto_load = true #=> true
+ *    Magic.do_not_auto_load        #=> true
+ *
+ * See also: Magic::new, Magic#loaded?, Magic#load and Magic#load_buffers
+ */
+VALUE
+rb_mgc_get_do_not_auto_load_global(RB_UNUSED_VAR(VALUE object))
+{
+	return CBOOL2RVAL(rb_mgc_do_not_auto_load);
+}
 
-/* :startdoc: */
+/*
+ * call-seq:
+ *    Magic.do_not_auto_load= ( boolean ) -> boolean
+ *
+ * Sets the global +do_not_auto_load+ flag for the Magic object and each of the
+ * Magic object instances. This flag can be used to disable automatic loading of
+ * the Magic database files.
+ *
+ * Returns +true+ if the global +do_not_auto_load+ flag is set, or +false+
+ * otherwise.
+ *
+ * Example:
+ *
+ *    Magic.do_not_auto_load        #=> false
+ *    Magic.do_not_auto_load = true #=> true
+ *    Magic.do_not_auto_load        #=> true
+ *
+ * Example:
+ *
+ *    Magic.do_not_auto_load = true                          #=> true
+ *    magic = Magic.new
+ *    magic.loaded?                                          #=> false
+ *    magic.load_buffers(File.read(magic.paths[0] + ".mgc")) #=> nil
+ *    magic.loaded?                                          #=> true
+ *
+ * See also: Magic::new, Magic#loaded?, Magic#load and Magic#load_buffers
+ */
+VALUE
+rb_mgc_set_do_not_auto_load_global(RB_UNUSED_VAR(VALUE object), VALUE value)
+{
+	rb_mgc_do_not_auto_load = RVAL2CBOOL(value);
+	return value;
+}
 
 /*
  * call-seq:
- *    Magic.new              -> self
- *    Magic.new( path, ... ) -> self
- *    Magic.new( array )     -> self
+ *    Magic.do_not_stop_on_error -> boolean
  *
- * Opens the underlying _Magic_ database and returns a new _Magic_.
+ * Returns +true+ if the global +do_not_stop_on_error+ flag is set, or +false+
+ * otherwise.
+ *
+ * Example:
+ *
+ *    Magic.do_not_stop_on_error        #=> false
+ *    Magic.do_not_stop_on_error = true #=> true
+ *    Magic.do_not_stop_on_error        #=> true
+ *
+ * See also: Magic::new, Magic::open and Magic#do_not_stop_on_error
+ */
+VALUE
+rb_mgc_get_do_not_stop_on_error_global(RB_UNUSED_VAR(VALUE object))
+{
+	return CBOOL2RVAL(rb_mgc_do_not_stop_on_error);
+}
+
+/*
+ * call-seq:
+ *    Magic.do_not_stop_on_error= (boolean) -> boolean
  *
  * Example:
  *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
+ *    Magic.do_not_stop_on_error        #=> false
+ *    Magic.do_not_stop_on_error = true #=> true
+ *    Magic.do_not_stop_on_error        #=> true
+ *
+ * See also: Magic::new, Magic::open and Magic#do_not_stop_on_error
+ */
+VALUE
+rb_mgc_set_do_not_stop_on_error_global(RB_UNUSED_VAR(VALUE object), VALUE value)
+{
+	rb_mgc_do_not_stop_on_error = RVAL2CBOOL(value);
+	return value;
+}
+
+/*
+ * call-seq:
+ *    Magic.new                -> self
+ *    Magic.new( string, ... ) -> self
+ *    Magic.new( array )       -> self
+ *
+ * Opens the underlying _Magic_ database and returns a new _Magic_.
+ *
+ * Example:
  *
- * Will raise <i>Magic::LibraryError</i> exception if, or
- * <i>Magic::MagicError</i> exception if
+ *    magic = Magic.new
+ *    magic.class       #=> Magic
  *
  * See also: Magic::open, Magic::mime, Magic::type, Magic::encoding, Magic::compile and Magic::check
  */
 VALUE
 rb_mgc_initialize(VALUE object, VALUE arguments)
 {
-    VALUE mutex = Qnil;
-
-    magic_arguments_t ma;
-    const char *klass = NULL;
+	magic_object_t *mo;
+	const char *klass = "Magic";
 
-    if (rb_block_given_p()) {
-        klass = "Magic";
+	if (!NIL_P(object))
+		klass = rb_obj_classname(object);
 
-        if (!NIL_P(object)) {
-            klass = rb_class2name(CLASS_OF(object));
-        }
+	if (rb_block_given_p())
+		MAGIC_WARNING(0, "%s::new() does not take block; use %s::open() instead",
+				 klass, klass);
 
-        rb_warn("%s::new() does not take block; use %s::open() instead",
-                klass, klass);
-    }
+	if(RTEST(rb_eval_string("ENV['MAGIC_DO_NOT_STOP_ON_ERROR']")))
+		rb_mgc_do_not_stop_on_error = 1;
 
-    mutex = rb_class_new_instance(0, 0, rb_const_get(rb_cObject,
-                rb_intern("Mutex")));
+	if(RTEST(rb_eval_string("ENV['MAGIC_DO_NOT_AUTOLOAD']")))
+		rb_mgc_do_not_auto_load = 1;
 
-    rb_ivar_set(object, id_at_mutex, mutex);
+	MAGIC_OBJECT(mo);
+	mo->stop_on_errors = 1;
+	if (rb_mgc_do_not_stop_on_error)
+		mo->stop_on_errors = 0;
 
-    MAGIC_COOKIE(ma.cookie);
+	mo->mutex = rb_class_new_instance(0, 0, rb_const_get(rb_cObject,
+					  rb_intern("Mutex")));
 
-    ma.flags = MAGIC_NONE;
-    ma.data.file.path = NULL;
+	magic_set_flags(object, INT2NUM(MAGIC_NONE));
+	magic_set_paths(object, RARRAY_EMPTY);
 
-    rb_ivar_set(object, id_at_flags, INT2NUM(ma.flags));
-    rb_mgc_load(object, arguments);
+	if (rb_mgc_do_not_auto_load) {
+		if (!RARRAY_EMPTY_P(arguments))
+			MAGIC_WARNING(1, "%s::do_not_auto_load is set; using %s#new() to load "
+					 "Magic database from a file will have no effect",
+					 klass, klass);
+		return object;
+	}
 
-    return object;
+	rb_mgc_load(object, arguments);
+	return object;
 }
 
 /*
  * call-seq:
- *    magic.close -> nil
- *
- * Closes the underlying _Magic_ database.
- *
- * Example:
- *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
- *    magic.close         #=> nil
+ *    magic.do_not_stop_on_error -> boolean
  *
- * See also: Magic#closed?
+ * See also: Magic::new, Magic::open and Magic::do_not_stop_on_error
  */
 VALUE
-rb_mgc_close(VALUE object)
+rb_mgc_get_do_not_stop_on_error(VALUE object)
 {
-    magic_t cookie;
+	magic_object_t *mo;
+
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_OBJECT(mo);
 
-    MAGIC_COOKIE(cookie);
+	return CBOOL2RVAL(!mo->stop_on_errors);
+}
 
-    if (cookie) {
-        MAGIC_SYNCHRONIZED(magic_close_internal, cookie);
+/*
+ * call-seq:
+ *    magic.do_not_stop_on_error= ( boolean ) -> boolean
+ *
+ * See also: Magic::new, Magic::open and Magic::do_not_stop_on_error
+ */
+VALUE
+rb_mgc_set_do_not_stop_on_error(VALUE object, VALUE value)
+{
+	magic_object_t *mo;
 
-        if (DATA_P(object)) {
-            DATA_PTR(object) = NULL;
-        }
-    }
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_OBJECT(mo);
 
-    return Qnil;
+	mo->stop_on_errors = !RVAL2CBOOL(value);
+	return value;
 }
 
 /*
  * call-seq:
- *    magic.closed? -> true or false
+ *    magic.open? -> true or false
  *
  * Returns +true+ if the underlying _Magic_ database is open,
  * or +false+ otherwise.
  *
  * Example:
  *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
- *    magic.closed?       #=> false
- *    magic.close         #=> nil
- *    magic.closed?       #=> true
+ *    magic = Magic.new
+ *    magic.open?       #=> true
+ *    magic.close       #=> nil
+ *    magic.open?       #=> false
  *
- * See also: Magic#close
+ * See also: Magic#close?, Magic#close and Magic#new
  */
 VALUE
-rb_mgc_closed(VALUE object)
+rb_mgc_open_p(VALUE object)
 {
-    magic_t cookie;
-
-    MAGIC_COOKIE(cookie);
-
-    if (DATA_P(object) && DATA_PTR(object) && cookie) {
-        return Qfalse;
-    }
-
-    return Qtrue;
+	return MAGIC_CLOSED_P(object) ? Qfalse : Qtrue;
 }
 
 /*
  * call-seq:
- *    magic.path -> array
+ *    magic.close -> nil
  *
- * Returns an +array+
+ * Closes the underlying _Magic_ database.
  *
  * Example:
  *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
- *    magic.path          #=> ["/etc/magic", "/usr/share/misc/magic"]
+ *    magic = Magic.new
+ *    magic.close       #=> nil
  *
- * Will raise <i>Magic::LibraryError</i> exception if
+ * See also: Magic#closed?, Magic#open? and Magic#new
  */
 VALUE
-rb_mgc_get_path(VALUE object)
+rb_mgc_close(VALUE object)
 {
-    VALUE value = Qnil;
-    const char *cstring = NULL;
+	magic_object_t *mo;
 
-    CHECK_MAGIC_OPEN(object);
+	if (MAGIC_CLOSED_P(object))
+		return Qnil;
 
-    value = rb_ivar_get(object, id_at_path);
-    if (!NIL_P(value) && !RARRAY_EMPTY_P(value) && !getenv("MAGIC")) {
-        return value;
-    }
+	MAGIC_OBJECT(mo);
+	if (mo) {
+		MAGIC_SYNCHRONIZED(magic_close_internal, mo);
+		if (DATA_P(object))
+			DATA_PTR(object) = NULL;
+	}
 
-    cstring = magic_getpath_wrapper();
-    value = magic_split(CSTR2RVAL(cstring), CSTR2RVAL(":"));
-
-    return rb_ivar_set(object, id_at_path, value);
+	return Qnil;
 }
 
 /*
  * call-seq:
- *    magic.flags -> integer
+ *    magic.closed? -> true or false
  *
- * Returns
+ * Returns +true+ if the underlying _Magic_ database is closed,
+ * or +false+ otherwise.
  *
  * Example:
  *
- *    magic = Magic.new           #=> #<Magic:0x007f8fdc012e58>
- *    magic.flags                 #=> 0
- *    magic.flags = Magic::MIME   #=> 1040
- *    magic.flags                 #=> 1040
+ *    magic = Magic.new
+ *    magic.closed?     #=> false
+ *    magic.close       #=> nil
+ *    magic.closed?     #=> true
  *
- * See also: Magic#flags_to_a
+ * See also: Magic#close, Magic#open? and #Magic#new
  */
 VALUE
-rb_mgc_get_flags(VALUE object)
+rb_mgc_close_p(VALUE object)
 {
-    CHECK_MAGIC_OPEN(object);
-    return rb_ivar_get(object, id_at_flags);
+	magic_object_t *mo;
+	magic_t cookie = NULL;
+
+	MAGIC_OBJECT(mo);
+	if (mo)
+		cookie = mo->cookie;
+
+	if (DATA_P(object) && cookie)
+		return Qfalse;
+
+	return Qtrue;
 }
 
 /*
  * call-seq:
- *    magic.flags= (integer) -> integer
+ *    magic.paths -> array
  *
  * Example:
  *
- *    magic = Magic.new                #=> #<Magic:0x007f8fdc012e58>
- *    magic.flags = Magic::MIME        #=> 1040
- *    magic.flags = Magic::MIME_TYPE   #=> 16
+ *    magic = Magic.new
+ *    magic.paths       #=> ["/etc/magic", "/usr/share/misc/magic"]
  *
- * Will raise <i>Magic::FlagsError</i> exception if, or
- * <i>Magic::LibraryError</i> exception if, or
- * <i>Magic::NotImplementedError</i> exception if, or
  */
 VALUE
-rb_mgc_set_flags(VALUE object, VALUE value)
+rb_mgc_get_paths(VALUE object)
 {
-    int local_errno;
-    magic_t cookie;
+	const char *cstring = NULL;
+	VALUE value = Qundef;
 
-    Check_Type(value, T_FIXNUM);
+	MAGIC_CHECK_OPEN(object);
 
-    CHECK_MAGIC_OPEN(object);
-    MAGIC_COOKIE(cookie);
+	value = rb_ivar_get(object, id_at_paths);
+	if (!NIL_P(value) && !RARRAY_EMPTY_P(value) && !getenv("MAGIC"))
+		return value;
 
-    if (magic_setflags_wrapper(cookie, NUM2INT(value)) < 0) {
-        local_errno = errno;
+	cstring = magic_getpath_wrapper();
+	value = magic_split(CSTR2RVAL(cstring), CSTR2RVAL(":"));
+	RB_GC_GUARD(value);
 
-        switch (local_errno) {
-            case EINVAL:
-                MAGIC_GENERIC_ERROR(rb_mgc_eFlagsError, EINVAL,
-                        error(E_FLAG_INVALID_VALUE));
-                break;
-            case ENOSYS:
-                MAGIC_GENERIC_ERROR(rb_mgc_eNotImplementedError, ENOSYS,
-                        error(E_FLAG_NOT_IMPLEMENTED));
-                break;
-            default:
-                MAGIC_LIBRARY_ERROR(cookie);
-                break;
-        }
-    }
-
-    return rb_ivar_set(object, id_at_flags, value);
+	return value;
 }
 
 /*
  * call-seq:
- *    magic.load              -> array
- *    magic.load( path, ... ) -> array
- *    magic.load( array )     -> array
- *
- * Example:
- *
- *    magic = Magic.new                                   #=> #<Magic:0x007f8fdc012e58>
- *    magic.load                                          #=> ["/etc/magic", "/usr/share/misc/magic"]
- *    magic.load("/usr/share/misc/magic", "/etc/magic")   #=> ["/usr/share/misc/magic", "/etc/magic"]
- *    magic.load                                          #=> ["/etc/magic", "/usr/share/misc/magic"]
- *
- * Will raise <i>Magic::LibraryError</i> exception if, or
- *
- * See also: Magic#check, Magic#compile, Magic::check and Magic::compile
+ *    magic.get_parameter( integer ) -> integer
  */
 VALUE
-rb_mgc_load(VALUE object, VALUE arguments)
+rb_mgc_get_parameter(VALUE object, VALUE tag)
 {
-    magic_arguments_t ma;
-    VALUE value = Qnil;
+	int local_errno;
+	magic_object_t *mo;
+	magic_arguments_t ma;
 
-    CHECK_MAGIC_OPEN(object);
-    MAGIC_COOKIE(ma.cookie);
+	MAGIC_CHECK_INTEGER_TYPE(tag);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
 
-    if (!RARRAY_EMPTY_P(arguments) && !NIL_P(RARRAY_FIRST(arguments))) {
-        value = magic_join(arguments, CSTR2RVAL(":"));
-        ma.data.file.path = RVAL2CSTR(value);
-    }
-    else {
-        ma.data.file.path = magic_getpath_wrapper();
-    }
+	ma.type.parameter.tag = NUM2INT(tag);
 
-    ma.flags = NUM2INT(rb_mgc_get_flags(object));
+	MAGIC_SYNCHRONIZED(magic_get_parameter_internal, &ma);
+	local_errno = errno;
 
-    if (!MAGIC_SYNCHRONIZED(magic_load_internal, &ma)) {
-        MAGIC_LIBRARY_ERROR(ma.cookie);
-    }
+	if (ma.status < 0)  {
+		if (local_errno == EINVAL)
+			MAGIC_GENERIC_ERROR(rb_mgc_eParameterError,
+					    local_errno,
+					    E_PARAM_INVALID_TYPE);
 
-    value = magic_split(CSTR2RVAL(ma.data.file.path), CSTR2RVAL(":"));
+		MAGIC_LIBRARY_ERROR(ma.cookie);
+	}
 
-    return rb_ivar_set(object, id_at_path, value);
+	return SIZET2NUM(ma.type.parameter.value);
 }
 
 /*
  * call-seq:
- *    magic.compile              -> true
- *    magic.compile( path, ... ) -> true
- *    magic.compile( array )     -> true
+ *    magic.set_parameter( integer, integer ) -> nil
+ */
+VALUE
+rb_mgc_set_parameter(VALUE object, VALUE tag, VALUE value)
+{
+	int local_errno;
+	magic_object_t *mo;
+	magic_arguments_t ma;
+
+	MAGIC_CHECK_INTEGER_TYPE(tag);
+	MAGIC_CHECK_INTEGER_TYPE(value);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
+
+	ma.type.parameter.tag = NUM2INT(tag);
+	ma.type.parameter.value = NUM2SIZET(value);
+
+	MAGIC_SYNCHRONIZED(magic_set_parameter_internal, &ma);
+	local_errno = errno;
+
+	if (ma.status < 0)  {
+		switch (local_errno) {
+		case EINVAL:
+			MAGIC_GENERIC_ERROR(rb_mgc_eParameterError,
+					    local_errno,
+					    E_PARAM_INVALID_TYPE);
+		case EOVERFLOW:
+			MAGIC_GENERIC_ERROR(rb_mgc_eParameterError,
+					    local_errno,
+					    E_PARAM_INVALID_VALUE);
+		}
+		MAGIC_LIBRARY_ERROR(ma.cookie);
+	}
+
+	return Qnil;
+}
+
+/*
+ * call-seq:
+ *    magic.flags -> integer
  *
  * Example:
  *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
+ *    magic = Magic.new
+ *    magic.flags               #=> 0
+ *    magic.flags = Magic::MIME #=> 1040
+ *    magic.flags               #=> 1040
  *
- * Will raise <i>Magic::LibraryError</i> exception if, or
- *
- * See also: Magic#check, Magic::check and Magic::compile
+ * See also: Magic#flags_to_a
  */
 VALUE
-rb_mgc_compile(VALUE object, VALUE arguments)
+rb_mgc_get_flags(VALUE object)
 {
-    magic_arguments_t ma;
-    VALUE value = Qnil;
+	int local_errno;
+	magic_object_t *mo;
+	magic_arguments_t ma;
 
-    CHECK_MAGIC_OPEN(object);
-    MAGIC_COOKIE(ma.cookie);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
 
-    if (!RARRAY_EMPTY_P(arguments)) {
-        value = magic_join(arguments, CSTR2RVAL(":"));
-    }
-    else {
-        value = magic_join(rb_mgc_get_path(object), CSTR2RVAL(":"));
-    }
+	MAGIC_SYNCHRONIZED(magic_get_flags_internal, &ma);
+	local_errno = errno;
 
-    ma.flags = NUM2INT(rb_mgc_get_flags(object));
-    ma.data.file.path = RVAL2CSTR(value);
+	if (ma.flags < 0 && local_errno == ENOSYS)
+		return rb_ivar_get(object, id_at_flags);
 
-    if (!MAGIC_SYNCHRONIZED(magic_compile_internal, &ma)) {
-        MAGIC_LIBRARY_ERROR(ma.cookie);
-    }
-
-    return Qtrue;
+	return INT2NUM(ma.flags);
 }
 
 /*
  * call-seq:
- *    magic.check              -> true or false
- *    magic.check( path, ... ) -> true or false
- *    magic.check( array )     -> true or false
+ *    magic.flags= ( integer ) -> integer
  *
  * Example:
  *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
+ *    magic = Magic.new
+ *    magic.flags = Magic::MIME      #=> 1040
+ *    magic.flags = Magic::MIME_TYPE #=> 16
+ */
+VALUE
+rb_mgc_set_flags(VALUE object, VALUE value)
+{
+	int local_errno;
+	magic_object_t *mo;
+	magic_arguments_t ma;
+
+	MAGIC_CHECK_INTEGER_TYPE(value);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
+
+	ma.flags = NUM2INT(value);
+
+	MAGIC_SYNCHRONIZED(magic_set_flags_internal, &ma);
+	local_errno = errno;
+
+	if (ma.status < 0)  {
+		switch (local_errno) {
+		case EINVAL:
+			MAGIC_GENERIC_ERROR(rb_mgc_eFlagsError,
+					    local_errno,
+					    E_FLAG_INVALID_TYPE);
+		case ENOSYS:
+			MAGIC_GENERIC_ERROR(rb_mgc_eNotImplementedError,
+					    local_errno,
+					    E_FLAG_NOT_IMPLEMENTED);
+		}
+		MAGIC_LIBRARY_ERROR(ma.cookie);
+	}
+
+	return rb_ivar_set(object, id_at_flags, INT2NUM(ma.flags));
+}
+
+/*
+ * call-seq:
+ *    magic.load                -> nil
+ *    magic.load( string, ... ) -> nil
+ *    magic.load( array )       -> nil
  *
- * Will raise <i>Magic::LibraryError</i> exception if, or
+ * Example:
  *
- * See also: Magic#compile, Magic::compile and Magic::check
+ * See also: Magic#check, Magic#compile, Magic::check and Magic::compile
  */
 VALUE
-rb_mgc_check(VALUE object, VALUE arguments)
+rb_mgc_load(VALUE object, VALUE arguments)
 {
-    magic_arguments_t ma;
-    VALUE value = Qnil;
-
-    CHECK_MAGIC_OPEN(object);
-    MAGIC_COOKIE(ma.cookie);
-
-    if (!RARRAY_EMPTY_P(arguments)) {
-        value = magic_join(arguments, CSTR2RVAL(":"));
-    }
-    else {
-        value = magic_join(rb_mgc_get_path(object), CSTR2RVAL(":"));
-    }
-
-    ma.flags = NUM2INT(rb_mgc_get_flags(object));
-    ma.data.file.path = RVAL2CSTR(value);
-
-    if (!MAGIC_SYNCHRONIZED(magic_check_internal, &ma)) {
-        return Qfalse;
-    }
+	magic_object_t *mo;
+	magic_arguments_t ma;
+	const char *klass = "Magic";
+	VALUE value = Qundef;
+
+	if (ARRAY_P(RARRAY_FIRST(arguments)))
+		arguments = magic_flatten(arguments);
+
+	MAGIC_CHECK_ARRAY_OF_STRINGS(arguments);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
+
+	if (rb_mgc_do_not_auto_load) {
+		if (!NIL_P(object))
+			klass = rb_obj_classname(object);
+
+		MAGIC_WARNING(2, "%s::do_not_auto_load is set; using %s#load "
+				  "will load Magic database from a file",
+				  klass, klass);
+	}
+
+	ma.flags = magic_flags(object);
+
+	if (!RARRAY_EMPTY_P(arguments)) {
+		value = magic_join(arguments, CSTR2RVAL(":"));
+		ma.type.file.path = RVAL2CSTR(value);
+	}
+	else
+		ma.type.file.path = magic_getpath_wrapper();
+
+	magic_set_paths(object, RARRAY_EMPTY);
+
+	MAGIC_SYNCHRONIZED(magic_load_internal, &ma);
+	if (ma.status < 0) {
+		mo->database_loaded = 0;
+		MAGIC_LIBRARY_ERROR(ma.cookie);
+	}
+	mo->database_loaded = 1;
+
+	value = magic_split(CSTR2RVAL(ma.type.file.path), CSTR2RVAL(":"));
+	magic_set_paths(object, value);
+	RB_GC_GUARD(value);
+
+	return Qnil;
+}
 
-    return Qtrue;
+/*
+ * call-seq:
+ *    magic.load_buffers( string, ... ) -> nil
+ *    magic.load_buffers( array )       -> nil
+ *
+ * See also: Magic#load and Magic::do_not_auto_load
+ */
+VALUE
+rb_mgc_load_buffers(VALUE object, VALUE arguments)
+{
+	size_t count;
+	int local_errno;
+	magic_object_t *mo;
+	magic_arguments_t ma;
+	void **pointers = NULL;
+	size_t *sizes = NULL;
+	VALUE value = Qundef;
+
+	count = (size_t)RARRAY_LEN(arguments);
+	MAGIC_CHECK_ARGUMENT_MISSING(count, 1);
+
+	if (ARRAY_P(RARRAY_FIRST(arguments))) {
+		arguments = magic_flatten(arguments);
+		count = (size_t)RARRAY_LEN(arguments);
+	}
+
+	MAGIC_CHECK_ARRAY_EMPTY(arguments);
+	MAGIC_CHECK_ARRAY_OF_STRINGS(arguments);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
+
+	pointers = ALLOC_N(void *, count);
+	if (!pointers) {
+		local_errno = ENOMEM;
+		goto error;
+	}
+
+	sizes = ALLOC_N(size_t, count);
+	if (!sizes) {
+		ruby_xfree(pointers);
+		local_errno = ENOMEM;
+		goto error;
+	}
+
+	for (size_t i = 0; i < count; i++) {
+		value = RARRAY_AREF(arguments, (long)i);
+		pointers[i] = (void *)RSTRING_PTR(value);
+		sizes[i] = (size_t)RSTRING_LEN(value);
+	}
+
+	ma.flags = magic_flags(object);
+	ma.type.buffers.count = count;
+	ma.type.buffers.pointers = pointers;
+	ma.type.buffers.sizes = sizes;
+
+	magic_set_paths(object, RARRAY_EMPTY);
+
+	MAGIC_SYNCHRONIZED(magic_load_buffers_internal, &ma);
+	if (ma.status < 0) {
+		local_errno = errno;
+		ruby_xfree(pointers);
+		ruby_xfree(sizes);
+		goto error;
+	}
+	mo->database_loaded = 1;
+
+	ruby_xfree(pointers);
+	ruby_xfree(sizes);
+
+	return Qnil;
+error:
+	mo->database_loaded = 0;
+
+	if (local_errno == ENOMEM)
+		MAGIC_GENERIC_ERROR(rb_mgc_eLibraryError,
+				    local_errno,
+				    E_NOT_ENOUGH_MEMORY);
+
+	MAGIC_LIBRARY_ERROR(ma.cookie);
 }
 
 /*
  * call-seq:
- *    magic.file( path ) -> string or array
+ *    magic.loaded? -> true or false
  *
- * Returns
+ * Returns +true+ if at least a single Magic database file had been loaded, or
+ * +false+ otherwise. Magic database files can be loaded from a file or from an
+ * in-memory buffer.
  *
  * Example:
  *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
+ *    magic = Magic.new
+ *    magic.loaded?     #=> true
  *
- * Will raise <i>Magic::LibraryError</i> exception if, or
+ * Example:
  *
- * See also: Magic#buffer and Magic#descriptor
+ *    Magic.do_not_auto_load = true #=> true
+ *    magic = Magic.new
+ *    magic.loaded?                 #=> false
+ *
+ * See also: Magic#load and Magic#load_buffers
  */
 VALUE
-rb_mgc_file(VALUE object, VALUE value)
+rb_mgc_load_p(VALUE object)
 {
-    int rv;
-    magic_arguments_t ma;
-    const char *cstring = NULL;
-    const char *empty = "(null)";
+	magic_object_t *mo;
 
-    Check_Type(value, T_STRING);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_OBJECT(mo);
 
-    CHECK_MAGIC_OPEN(object);
-    MAGIC_COOKIE(ma.cookie);
+	return CBOOL2RVAL(mo->database_loaded);
+}
 
-    ma.flags = NUM2INT(rb_mgc_get_flags(object));
-    ma.data.file.path = RVAL2CSTR(value);
+/*
+ * call-seq:
+ *    magic.compile( string ) -> nil
+ *    magic.compile( array )  -> nil
+ *
+ * See also: Magic#check, Magic::check and Magic::compile
+ */
+VALUE
+rb_mgc_compile(VALUE object, VALUE value)
+{
+	magic_object_t *mo;
+	magic_arguments_t ma;
 
-    cstring = (const char *)MAGIC_SYNCHRONIZED(magic_file_internal, &ma);
-    if (!cstring) {
-        rv = magic_version_wrapper();
+	MAGIC_CHECK_STRING_TYPE(value);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
 
-        if (ma.flags & MAGIC_ERROR) {
-            MAGIC_LIBRARY_ERROR(ma.cookie);
-        }
-        else if (rv < 515) {
-            (void)magic_errno(ma.cookie);
-            cstring = magic_error(ma.cookie);
-        }
-    }
+	ma.flags = magic_flags(object);
+	ma.type.file.path = RVAL2CSTR(value);
 
-    assert(cstring != NULL && "Must be a valid pointer to `const char' type");
-    assert(strncmp(cstring, empty, strlen(empty)) != 0 && \
-            "Empty or invalid result");
+	MAGIC_SYNCHRONIZED(magic_compile_internal, &ma);
+	if (ma.status < 0)
+		MAGIC_LIBRARY_ERROR(ma.cookie);
 
-    return magic_return(CSTR2RVAL(cstring), &ma);
+	return Qnil;
 }
 
 /*
  * call-seq:
- *    magic.buffer( string ) -> string or array
- *
- * Returns
- *
- * Example:
+ *    magic.check( string ) -> true or false
+ *    magic.check( array )  -> true or false
  *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
+ * See also: Magic#compile, Magic::compile and Magic::check
+ */
+VALUE
+rb_mgc_check(VALUE object, VALUE value)
+{
+	magic_object_t *mo;
+	magic_arguments_t ma;
+
+	MAGIC_CHECK_STRING_TYPE(value);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_COOKIE(mo, ma.cookie);
+
+	ma.flags = magic_flags(object);
+	ma.type.file.path = RVAL2CSTR(value);
+
+	MAGIC_SYNCHRONIZED(magic_check_internal, &ma);
+	return ma.status < 0 ? Qfalse : Qtrue;
+}
+
+/*
+ * call-seq:
+ *    magic.file( object ) -> string or array
+ *    magic.file( string ) -> string or array
  *
- * Will raise <i>Magic::LibraryError</i> exception if, or
+ * See also: Magic#buffer and Magic#descriptor
+ */
+VALUE
+rb_mgc_file(VALUE object, VALUE value)
+{
+	magic_object_t *mo;
+	magic_arguments_t ma;
+	const char *empty = "(null)";
+
+	if (NIL_P(value))
+		goto error;
+
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_CHECK_LOADED(object);
+	MAGIC_COOKIE(mo, ma.cookie);
+
+	if (rb_respond_to(value, rb_intern("to_io")))
+		return rb_mgc_descriptor(object, value);
+
+	value = magic_path(value);
+	if (NIL_P(value))
+		goto error;
+
+	ma.stop_on_errors = mo->stop_on_errors;
+	ma.flags = magic_flags(object);
+	ma.type.file.path = RVAL2CSTR(value);
+
+	MAGIC_SYNCHRONIZED(magic_file_internal, &ma);
+	if (!ma.result) {
+		/*
+		 * Handle the case when the "ERROR" flag is set regardless of the
+		 * current version of the underlying Magic library.
+		 *
+		 * Prior to version 5.15 the correct behavior that concerns the
+		 * following IEEE 1003.1 standards was broken:
+		 *
+		 * http://pubs.opengroup.org/onlinepubs/007904975/utilities/file.html
+		 * http://pubs.opengroup.org/onlinepubs/9699919799/utilities/file.html
+		 *
+		 * This is an attempt to mitigate the problem and correct it to achieve
+		 * the desired behavior as per the standards.
+		 */
+		if (mo->stop_on_errors || (ma.flags & MAGIC_ERROR))
+			MAGIC_LIBRARY_ERROR(ma.cookie);
+		else
+			ma.result = magic_error_wrapper(ma.cookie);
+	}
+	if (!ma.result)
+		MAGIC_GENERIC_ERROR(rb_mgc_eMagicError, EINVAL, E_UNKNOWN);
+
+	assert(ma.result != NULL && \
+	       "Must be a valid pointer to `const char' type");
+
+	/*
+	 * Depending on the version of the underlying Magic library the magic_file()
+	 * function can fail and either yield no results or return the "(null)"
+	 * string instead. Often this would indicate that an older version of the
+	 * Magic library is in use.
+	 */
+	assert(strncmp(ma.result, empty, strlen(empty)) != 0 && \
+		       "Empty or invalid result");
+
+	return magic_return(&ma);
+error:
+	MAGIC_ARGUMENT_TYPE_ERROR(value, "String or IO-like object");
+}
+
+/*
+ * call-seq:
+ *    magic.buffer( string ) -> string or array
  *
  * See also: Magic#file and Magic#descriptor
  */
 VALUE
 rb_mgc_buffer(VALUE object, VALUE value)
 {
-    magic_arguments_t ma;
-    const char *cstring = NULL;
+	magic_object_t *mo;
+	magic_arguments_t ma;
 
-    Check_Type(value, T_STRING);
+	MAGIC_CHECK_STRING_TYPE(value);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_CHECK_LOADED(object);
+	MAGIC_COOKIE(mo, ma.cookie);
 
-    CHECK_MAGIC_OPEN(object);
-    MAGIC_COOKIE(ma.cookie);
+	StringValue(value);
 
-    ma.flags = NUM2INT(rb_mgc_get_flags(object));
+	ma.flags = magic_flags(object);
+	ma.type.buffers.pointers = (void **)RSTRING_PTR(value);
+	ma.type.buffers.sizes = (size_t *)RSTRING_LEN(value);
 
-    ma.data.buffer.size = RSTRING_LEN(value);
-    ma.data.buffer.buffer = RVAL2CSTR(value);
+	MAGIC_SYNCHRONIZED(magic_buffer_internal, &ma);
+	if (!ma.result)
+		MAGIC_LIBRARY_ERROR(ma.cookie);
 
-    cstring = (const char *)MAGIC_SYNCHRONIZED(magic_buffer_internal, &ma);
-    if (!cstring) {
-        MAGIC_LIBRARY_ERROR(ma.cookie);
-    }
+	assert(ma.result != NULL && \
+	       "Must be a valid pointer to `const char' type");
 
-    return magic_return(CSTR2RVAL(cstring), &ma);
+	return magic_return(&ma);
 }
 
 /*
  * call-seq:
+ *    magic.descriptor( object )  -> string or array
  *    magic.descriptor( integer ) -> string or array
  *
- * Returns
- *
- * Example:
- *
- *    magic = Magic.new   #=> #<Magic:0x007f8fdc012e58>
- *
- * Will raise <i>Magic::LibraryError</i> exception if, or
- *
  * See also: Magic#file and Magic#buffer
  */
 VALUE
 rb_mgc_descriptor(VALUE object, VALUE value)
 {
-    magic_arguments_t ma;
-    const char *cstring = NULL;
+	int local_errno;
+	magic_object_t *mo;
+	magic_arguments_t ma;
+
+	if (rb_respond_to(value, rb_intern("to_io")))
+		value = INT2NUM(magic_fileno(value));
+
+	MAGIC_CHECK_INTEGER_TYPE(value);
+	MAGIC_CHECK_OPEN(object);
+	MAGIC_CHECK_LOADED(object);
+	MAGIC_COOKIE(mo, ma.cookie);
 
-    Check_Type(value, T_FIXNUM);
+	ma.flags = magic_flags(object);
+	ma.type.file.fd = NUM2INT(value);
 
-    CHECK_MAGIC_OPEN(object);
-    MAGIC_COOKIE(ma.cookie);
+	MAGIC_SYNCHRONIZED(magic_descriptor_internal, &ma);
+	local_errno = errno;
 
-    ma.flags = NUM2INT(rb_mgc_get_flags(object));
-    ma.data.file.fd = NUM2INT(value);
+	if (!ma.result) {
+		if (local_errno == EBADF)
+			rb_raise(rb_eIOError, "Bad file descriptor");
 
-    cstring = (const char *)MAGIC_SYNCHRONIZED(magic_descriptor_internal, &ma);
-    if (!cstring) {
-        MAGIC_LIBRARY_ERROR(ma.cookie);
-    }
+		MAGIC_LIBRARY_ERROR(ma.cookie);
+	}
 
-    return magic_return(CSTR2RVAL(cstring), &ma);
+	assert(ma.result != NULL && \
+	       "Must be a valid pointer to `const char' type");
+
+	return magic_return(&ma);
 }
 
 /*
  * call-seq:
  *    Magic.version -> integer
  *
- * Returns
- *
  * Example:
  *
- *    Magic.version   #=> 517
- *
- * Will raise <i>Magic::NotImplementedError</i> exception if, or
+ *    Magic.version #=> 517
  *
  * See also: Magic::version_to_a and Magic::version_to_s
  */
 VALUE
-rb_mgc_version(VALUE object)
+rb_mgc_version(RB_UNUSED_VAR(VALUE object))
 {
-    int rv;
-    int local_errno;
-
-    UNUSED(object);
-
-    rv = magic_version_wrapper();
-    local_errno = errno;
-
-    if (rv < 0 && local_errno == ENOSYS) {
-        MAGIC_GENERIC_ERROR(rb_mgc_eNotImplementedError, ENOSYS,
-                error(E_NOT_IMPLEMENTED));
-    }
-
-    return INT2NUM(rv);
+	return INT2NUM(magic_version_wrapper());
 }
 
-/* :stopdoc: */
-
 static inline void*
 nogvl_magic_load(void *data)
 {
-    int rv;
-    magic_arguments_t *ma = data;
+	magic_arguments_t *ma = data;
 
-    rv = magic_load_wrapper(ma->cookie, ma->data.file.path, ma->flags);
-    return rv < 0 ? NULL : data;
+	ma->status = magic_load_wrapper(ma->cookie,
+					ma->type.file.path,
+					ma->flags);
+	return NULL;
 }
 
 static inline void*
 nogvl_magic_compile(void *data)
 {
-    int rv;
-    magic_arguments_t *ma = data;
+	magic_arguments_t *ma = data;
 
-    rv = magic_compile_wrapper(ma->cookie, ma->data.file.path, ma->flags);
-    return rv < 0 ? NULL : data;
+	ma->status = magic_compile_wrapper(ma->cookie,
+					   ma->type.file.path,
+					   ma->flags);
+	return NULL;
 }
 
 static inline void*
 nogvl_magic_check(void *data)
 {
-    int rv;
-    magic_arguments_t *ma = data;
+	magic_arguments_t *ma = data;
 
-    rv = magic_check_wrapper(ma->cookie, ma->data.file.path, ma->flags);
-    return rv < 0 ? NULL : data;
+	ma->status = magic_check_wrapper(ma->cookie,
+					 ma->type.file.path,
+					 ma->flags);
+	return NULL;
 }
 
 static inline void*
 nogvl_magic_file(void *data)
 {
-    magic_arguments_t *ma = data;
-    return (void *)magic_file_wrapper(ma->cookie, ma->data.file.path, ma->flags);
+	magic_arguments_t *ma = data;
+
+	ma->result = magic_file_wrapper(ma->cookie,
+					ma->type.file.path,
+					ma->flags);
+	return NULL;
 }
 
 static inline void*
 nogvl_magic_descriptor(void *data)
 {
-    magic_arguments_t *ma = data;
-    return (void *)magic_descriptor_wrapper(ma->cookie, ma->data.file.fd, ma->flags);
+	magic_arguments_t *ma = data;
+
+	ma->result = magic_descriptor_wrapper(ma->cookie,
+					      ma->type.file.fd,
+					      ma->flags);
+	return NULL;
+}
+
+static inline VALUE
+magic_get_parameter_internal(void *data)
+{
+	size_t value;
+	magic_arguments_t *ma = data;
+
+	ma->status = magic_getparam_wrapper(ma->cookie,
+					    ma->type.parameter.tag,
+					    &value);
+	ma->type.parameter.value = value;
+	return (VALUE)NULL;
+}
+
+static inline VALUE
+magic_set_parameter_internal(void *data)
+{
+	size_t value;
+	magic_arguments_t *ma = data;
+
+	value = ma->type.parameter.value;
+	ma->status = magic_setparam_wrapper(ma->cookie,
+					    ma->type.parameter.tag,
+					    &value);
+	return (VALUE)NULL;
+}
+
+static inline VALUE
+magic_get_flags_internal(void *data)
+{
+	magic_arguments_t *ma = data;
+
+	ma->flags = magic_getflags_wrapper(ma->cookie);
+	return (VALUE)NULL;
+}
+
+static inline VALUE
+magic_set_flags_internal(void *data)
+{
+	magic_arguments_t *ma = data;
+
+	ma->status = magic_setflags_wrapper(ma->cookie, ma->flags);
+	return (VALUE)NULL;
 }
 
 static inline VALUE
 magic_close_internal(void *data)
 {
-    magic_free(data);
-    return Qnil;
+	magic_library_close(data);
+	return Qnil;
 }
 
 static inline VALUE
 magic_load_internal(void *data)
 {
-    return (VALUE)NOGVL(nogvl_magic_load, data);
+	return (VALUE)NOGVL(nogvl_magic_load, data);
+}
+
+static inline VALUE
+magic_load_buffers_internal(void *data)
+{
+	magic_arguments_t *ma = data;
+
+	ma->status = magic_load_buffers_wrapper(ma->cookie,
+						ma->type.buffers.pointers,
+						ma->type.buffers.sizes,
+						ma->type.buffers.count,
+						ma->flags);
+	return (VALUE)NULL;
 }
 
 static inline VALUE
 magic_compile_internal(void *data)
 {
-    return (VALUE)NOGVL(nogvl_magic_compile, data);
+	return (VALUE)NOGVL(nogvl_magic_compile, data);
 }
 
 static inline VALUE
 magic_check_internal(void *data)
 {
-    return (VALUE)NOGVL(nogvl_magic_check, data);
+	return (VALUE)NOGVL(nogvl_magic_check, data);
 }
 
-static inline VALUE
+static VALUE
 magic_file_internal(void *data)
 {
-    return (VALUE)NOGVL(nogvl_magic_file, data);
+	int local_errno;
+	int old_flags = 0;
+	int restore_flags = 0;
+	magic_arguments_t *ma = data;
+
+	if (ma->stop_on_errors) {
+		old_flags = ma->flags;
+		ma->flags |= MAGIC_ERROR;
+		restore_flags = 1;
+	}
+	if (ma->flags & MAGIC_CONTINUE) {
+		old_flags = ma->flags;
+		ma->flags |= MAGIC_RAW;
+		restore_flags = 1;
+	}
+	if (restore_flags && ma->flags)
+		magic_setflags_wrapper(ma->cookie, ma->flags);
+
+	NOGVL(nogvl_magic_file, ma);
+	local_errno = errno;
+	/*
+	 * The Magic library often does not correctly report errors,
+	 * especially when certain flags (such as e.g., MAGIC_EXTENSION,
+	 * etc.) are set. Attempt to obtain an error code first from the
+	 * Magic library itself, and if that does not work, then from
+	 * the saved errno value.
+	 */
+	if (magic_errno_wrapper(ma->cookie))
+		ma->status = -1;
+	else if (local_errno)
+		ma->status = -1;
+
+	if (restore_flags && old_flags)
+		magic_setflags_wrapper(ma->cookie, old_flags);
+
+	return (VALUE)NULL;
 }
 
-static inline VALUE
+static VALUE
 magic_buffer_internal(void *data)
 {
-    magic_arguments_t *ma = data;
-    return (VALUE)magic_buffer_wrapper(ma->cookie, ma->data.buffer.buffer,
-            ma->data.buffer.size, ma->flags);
+	int old_flags = 0;
+	int restore_flags = 0;
+	magic_arguments_t *ma = data;
+
+	if (ma->flags & MAGIC_CONTINUE) {
+		old_flags = ma->flags;
+		ma->flags |= MAGIC_RAW;
+		restore_flags = 1;
+	}
+	if (restore_flags && ma->flags)
+		magic_setflags_wrapper(ma->cookie, ma->flags);
+
+	ma->result = magic_buffer_wrapper(ma->cookie,
+					  (const void *)ma->type.buffers.pointers,
+					  (size_t)ma->type.buffers.sizes,
+					  ma->flags);
+	if (restore_flags && old_flags)
+		magic_setflags_wrapper(ma->cookie, old_flags);
+
+	return (VALUE)NULL;
 }
 
-static inline VALUE
+static VALUE
 magic_descriptor_internal(void *data)
 {
-    return (VALUE)NOGVL(nogvl_magic_descriptor, data);
+	int old_flags = 0;
+	int restore_flags = 0;
+	magic_arguments_t *ma = data;
+
+	if (ma->flags & MAGIC_CONTINUE) {
+		old_flags = ma->flags;
+		ma->flags |= MAGIC_RAW;
+		restore_flags = 1;
+	}
+	if (restore_flags && ma->flags)
+		magic_setflags_wrapper(ma->cookie, ma->flags);
+
+	NOGVL(nogvl_magic_descriptor, ma);
+
+	if (restore_flags && old_flags)
+		magic_setflags_wrapper(ma->cookie, old_flags);
+
+	return (VALUE)NULL;
 }
 
 static VALUE
 magic_allocate(VALUE klass)
 {
-    magic_t cookie;
+	int local_errno;
+	magic_object_t *mo;
+
+	mo = (magic_object_t *)ruby_xmalloc(sizeof(magic_object_t));
+	local_errno = ENOMEM;
+
+	if (!mo) {
+		errno = local_errno;
+		MAGIC_GENERIC_ERROR(rb_mgc_eLibraryError,
+				    local_errno,
+				    E_NOT_ENOUGH_MEMORY);
+	}
+
+	mo->cookie = NULL;
+	mo->mutex = Qundef;
+	mo->database_loaded = 0;
+	mo->stop_on_errors = 0;
+
+	mo->cookie = magic_open_wrapper(MAGIC_NONE);
+	local_errno = ENOMEM;
+
+	if (!mo->cookie) {
+		ruby_xfree(mo);
+		mo = NULL;
+		errno = local_errno;
+		MAGIC_GENERIC_ERROR(rb_mgc_eLibraryError,
+				    local_errno,
+				    E_MAGIC_LIBRARY_INITIALIZE);
+	}
+
+	return Data_Wrap_Struct(klass, magic_mark, magic_free, mo);
+}
+
+static inline void
+magic_library_close(void *data)
+{
+	magic_object_t *mo = data;
+
+	assert(mo != NULL && \
+	       "Must be a valid pointer to `magic_object_t' type");
+
+	if (mo->cookie)
+		magic_close_wrapper(mo->cookie);
+
+	mo->cookie = NULL;
+}
+
+static inline void
+magic_mark(void *data)
+{
+	magic_object_t *mo = data;
 
-    cookie = magic_open(MAGIC_NONE);
-    if (!cookie) {
-        MAGIC_GENERIC_ERROR(rb_mgc_eLibraryError, ENOMEM,
-                error(E_MAGIC_LIBRARY_INITIALIZE));
-    }
+	assert(mo != NULL && \
+	       "Must be a valid pointer to `magic_object_t' type");
 
-    return Data_Wrap_Struct(klass, NULL, magic_free, cookie);
+	rb_gc_mark(mo->mutex);
 }
 
-static void
+static inline void
 magic_free(void *data)
 {
-    magic_t cookie = data;
-    assert(cookie != NULL && "Must be a valid pointer to `magic_t' type");
+	magic_object_t *mo = data;
+
+	assert(mo != NULL && \
+	       "Must be a valid pointer to `magic_object_t' type");
 
-    if (cookie) {
-        magic_close(cookie);
-        cookie = NULL;
-    }
+	if (mo->cookie)
+		magic_library_close(data);
+
+	mo->cookie = NULL;
+	mo->mutex = Qundef;
+
+	ruby_xfree(mo);
 }
 
-static VALUE
+static inline VALUE
 magic_exception_wrapper(VALUE value)
 {
-    magic_exception_t *e = (struct magic_exception *)value;
-    return rb_exc_new2(e->klass, e->magic_error);
+	magic_exception_t *e = (struct magic_exception *)value;
+
+	return rb_exc_new2(e->klass, e->magic_error);
 }
 
 static VALUE
 magic_exception(void *data)
 {
-    int exception = 0;
-    VALUE object = Qnil;
+	magic_exception_t *e = data;
+	int exception = 0;
+	VALUE object = Qundef;
 
-    magic_exception_t *e = data;
-    assert(e != NULL && "Must be a valid pointer to `magic_exception_t' type");
+	assert(e != NULL && \
+	       "Must be a valid pointer to `magic_exception_t' type");
 
-    object = rb_protect(magic_exception_wrapper, (VALUE)e, &exception);
+	object = rb_protect(magic_exception_wrapper, (VALUE)e, &exception);
 
-    if (exception) {
-        rb_jump_tag(exception);
-    }
+	if (exception)
+		rb_jump_tag(exception);
 
-    rb_iv_set(object, "@errno", INT2NUM(e->magic_errno));
+	rb_iv_set(object, "@errno", INT2NUM(e->magic_errno));
+	RB_GC_GUARD(object);
 
-    return object;
+	return object;
 }
 
-static VALUE
+static inline VALUE
 magic_generic_error(VALUE klass, int magic_errno, const char *magic_error)
 {
-    magic_exception_t e;
+	magic_exception_t e;
 
-    e.magic_errno = magic_errno;
-    e.magic_error = magic_error;
-    e.klass = klass;
+	e.magic_errno = magic_errno;
+	e.magic_error = magic_error;
+	e.klass = klass;
 
-    return magic_exception(&e);
+	return magic_exception(&e);
 }
 
 static VALUE
 magic_library_error(VALUE klass, void *data)
 {
-    magic_exception_t e;
-    const char *message = NULL;
-    const char *empty = "(null)";
+	magic_exception_t e;
+	const char *message = NULL;
+	const char *empty = "(null)";
+	magic_t cookie = data;
 
-    magic_t cookie = data;
-    assert(cookie != NULL && "Must be a valid pointer to `magic_t' type");
+	assert(cookie != NULL && \
+	       "Must be a valid pointer to `magic_t' type");
 
-    e.magic_errno = -1;
-    e.magic_error = error(E_UNKNOWN);
-    e.klass = klass;
+	e.magic_errno = -1;
+	e.magic_error = error(E_UNKNOWN);
+	e.klass = klass;
 
-    message = magic_error(cookie);
-    if (message) {
-        e.magic_errno = magic_errno(cookie);
-        e.magic_error = message;
-    }
+	message = magic_error_wrapper(cookie);
+	if (message) {
+		e.magic_errno = magic_errno_wrapper(cookie);
+		e.magic_error = message;
+	}
 
-    assert(strncmp(e.magic_error, empty, strlen(empty)) != 0 && \
-            "Empty or invalid error message");
+	assert(strncmp(e.magic_error, empty, strlen(empty)) != 0 && \
+		       "Empty or invalid error message");
 
-    return magic_exception(&e);
+	return magic_exception(&e);
 }
 
 VALUE
 magic_lock(VALUE object, VALUE(*function)(ANYARGS), void *data)
 {
-    VALUE mutex = rb_ivar_get(object, id_at_mutex);
-    rb_funcall(mutex, rb_intern("lock"), 0);
-    return rb_ensure(function, (VALUE)data, magic_unlock, object);
+	magic_object_t *mo;
+
+	MAGIC_OBJECT(mo);
+	rb_funcall(mo->mutex, rb_intern("lock"), 0, Qundef);
+
+	return rb_ensure(function, (VALUE)data, magic_unlock, object);
 }
 
 VALUE
 magic_unlock(VALUE object)
 {
-    VALUE mutex = rb_ivar_get(object, id_at_mutex);
-    rb_funcall(mutex, rb_intern("unlock"), 0);
-    return Qnil;
+	magic_object_t *mo;
+
+	MAGIC_OBJECT(mo);
+	rb_funcall(mo->mutex, rb_intern("unlock"), 0, Qundef);
+
+	return Qnil;
 }
 
 static VALUE
-magic_return(VALUE value, void *data)
+magic_return(void *data)
 {
-    magic_arguments_t *ma = data;
-    VALUE array = Qnil;
+	magic_arguments_t *ma = data;
+	const char *unknown = "???";
+	VALUE separator = Qundef;
+	VALUE array = Qundef;
+	VALUE string = Qundef;
+
+	string = CSTR2RVAL(ma->result);
+	RB_GC_GUARD(string);
+
+	/*
+	 * The value below is a field separator that can be used to split results
+	 * when the CONTINUE flag is set causing all valid matches found by the
+	 * Magic library to be returned.
+	 */
+	if (ma->flags & MAGIC_CONTINUE)
+		separator = CSTR2RVAL(MAGIC_CONTINUE_SEPARATOR);
+
+	if (ma->flags & MAGIC_EXTENSION) {
+		/*
+		 * A possible I/O-related error has occurred, and there is very
+		 * little sense processing the results, so return string as-is.
+		 */
+		if (ma->status < 0)
+			return string;
+		/*
+		 * A number of Magic flags that support primarily files e.g.,
+		 * MAGIC_EXTENSION, etc., would not return a meaningful value for
+		 * directories and special files, and such. Thus, it's better to
+		 * return an empty string, to indicate lack of results, rather
+		 * than a confusing string consisting of three questions marks.
+		 */
+		if (strncmp(ma->result, unknown, strlen(unknown)) == 0)
+			return CSTR2RVAL("");
+
+		separator = CSTR2RVAL(MAGIC_EXTENSION_SEPARATOR);
+	}
+
+	if (ma->flags & (MAGIC_CONTINUE | MAGIC_EXTENSION)) {
+		array = magic_split(string, separator);
+		RB_GC_GUARD(array);
+		return (RARRAY_LEN(array) > 1) ? array : magic_shift(array);
+	}
+
+	return string;
+}
 
-    if (ma->flags & MAGIC_CONTINUE) {
-        array = magic_split(value, CSTR2RVAL("\x5c\x30\x31\x32\x2d\x20"));
-        return (NUM2INT(magic_size(array)) > 1) ? array : magic_shift(array);
-    }
+static inline int
+magic_flags(VALUE object)
+{
+	return NUM2INT(rb_ivar_get(object, id_at_flags));
+}
 
-    return value;
+static inline int
+magic_set_flags(VALUE object, VALUE value)
+{
+	return NUM2INT(rb_ivar_set(object, id_at_flags, value));
 }
 
-/* :startdoc: */
+static inline VALUE
+magic_set_paths(VALUE object, VALUE value)
+{
+	return rb_ivar_set(object, id_at_paths, value);
+}
 
 void
 Init_magic(void)
 {
-    id_at_path  = rb_intern("@path");
-    id_at_flags = rb_intern("@flags");
-    id_at_mutex = rb_intern("@mutex");
-
-    rb_cMagic = rb_define_class("Magic", rb_cObject);
-    rb_define_alloc_func(rb_cMagic, magic_allocate);
-
-    /*
-     * Raised when _Magic_ encounters an error.
-     */
-    rb_mgc_eError = rb_define_class_under(rb_cMagic, "Error", rb_eStandardError);
-
-    /*
-     * Stores current value of +errno+
-     */
-    rb_define_attr(rb_mgc_eError, "errno", 1, 0);
-
-    /*
-     * Raised when
-     */
-    rb_mgc_eMagicError = rb_define_class_under(rb_cMagic, "MagicError", rb_mgc_eError);
-
-    /*
-     * Raised when
-     */
-    rb_mgc_eLibraryError = rb_define_class_under(rb_cMagic, "LibraryError", rb_mgc_eError);
-
-    /*
-     * Raised when
-     */
-    rb_mgc_eFlagsError = rb_define_class_under(rb_cMagic, "FlagsError", rb_mgc_eError);
-
-    /*
-     * Raised when
-     */
-    rb_mgc_eNotImplementedError = rb_define_class_under(rb_cMagic, "NotImplementedError", rb_mgc_eError);
-
-    rb_define_method(rb_cMagic, "initialize", RUBY_METHOD_FUNC(rb_mgc_initialize), -2);
-
-    rb_define_method(rb_cMagic, "close", RUBY_METHOD_FUNC(rb_mgc_close), 0);
-    rb_define_method(rb_cMagic, "closed?", RUBY_METHOD_FUNC(rb_mgc_closed), 0);
-
-    rb_define_method(rb_cMagic, "path", RUBY_METHOD_FUNC(rb_mgc_get_path), 0);
-    rb_define_method(rb_cMagic, "flags", RUBY_METHOD_FUNC(rb_mgc_get_flags), 0);
-    rb_define_method(rb_cMagic, "flags=", RUBY_METHOD_FUNC(rb_mgc_set_flags), 1);
-
-    rb_define_method(rb_cMagic, "file", RUBY_METHOD_FUNC(rb_mgc_file), 1);
-    rb_define_method(rb_cMagic, "buffer", RUBY_METHOD_FUNC(rb_mgc_buffer), 1);
-    rb_define_method(rb_cMagic, "descriptor", RUBY_METHOD_FUNC(rb_mgc_descriptor), 1);
-
-    rb_define_method(rb_cMagic, "load", RUBY_METHOD_FUNC(rb_mgc_load), -2);
-    rb_define_method(rb_cMagic, "compile", RUBY_METHOD_FUNC(rb_mgc_compile), -2);
-    rb_define_method(rb_cMagic, "check", RUBY_METHOD_FUNC(rb_mgc_check), -2);
-
-    rb_alias(rb_cMagic, rb_intern("valid?"), rb_intern("check"));
-
-    rb_define_singleton_method(rb_cMagic, "version", RUBY_METHOD_FUNC(rb_mgc_version), 0);
-
-    /*
-     * No special handling and/or flags specified. Default behaviour.
-     */
-    rb_define_const(rb_cMagic, "NONE", INT2NUM(MAGIC_NONE));
-
-    /*
-     * Print debugging messages to standard error output.
-     */
-    rb_define_const(rb_cMagic, "DEBUG", INT2NUM(MAGIC_DEBUG));
-
-    /*
-     * If the file queried is a symbolic link, follow it.
-     */
-    rb_define_const(rb_cMagic, "SYMLINK", INT2NUM(MAGIC_SYMLINK));
-
-    /*
-     * If the file is compressed, unpack it and look at the contents.
-     */
-    rb_define_const(rb_cMagic, "COMPRESS", INT2NUM(MAGIC_COMPRESS));
-
-    /*
-     * If the file is a block or character special device, then open
-     * the device and try to look at the contents.
-     */
-    rb_define_const(rb_cMagic, "DEVICES", INT2NUM(MAGIC_DEVICES));
-
-    /*
-     * Return a MIME type string, instead of a textual description.
-     */
-    rb_define_const(rb_cMagic, "MIME_TYPE", INT2NUM(MAGIC_MIME_TYPE));
-
-    /*
-     * Return all matches, not just the first.
-     */
-    rb_define_const(rb_cMagic, "CONTINUE", INT2NUM(MAGIC_CONTINUE));
-
-    /*
-     * Check the Magic database for consistency and print warnings to
-     * standard error output.
-     */
-    rb_define_const(rb_cMagic, "CHECK", INT2NUM(MAGIC_CHECK));
-
-    /*
-     * Attempt to preserve access time (atime, utime or utimes) of the
-     * file queried on systems that support such system calls.
-     */
-    rb_define_const(rb_cMagic, "PRESERVE_ATIME", INT2NUM(MAGIC_PRESERVE_ATIME));
-
-    /*
-     * Do not translate unprintable characters to an octal representation.
-     */
-    rb_define_const(rb_cMagic, "RAW", INT2NUM(MAGIC_RAW));
-
-    /*
-     * Treat operating system errors while trying to open files and follow
-     * symbolic links as first class errors, instead of storing them in the
-     * Magic library error buffer for retrieval later.
-     */
-    rb_define_const(rb_cMagic, "ERROR", INT2NUM(MAGIC_ERROR));
-
-    /*
-     * Return a MIME encoding, instead of a textual description.
-     */
-    rb_define_const(rb_cMagic, "MIME_ENCODING", INT2NUM(MAGIC_MIME_ENCODING));
-
-    /*
-     * A shorthand for using MIME_TYPE and MIME_ENCODING flags together.
-     */
-    rb_define_const(rb_cMagic, "MIME", INT2NUM(MAGIC_MIME));
-
-    /*
-     * Return the Apple creator and type.
-     */
-    rb_define_const(rb_cMagic, "APPLE", INT2NUM(MAGIC_APPLE));
-
-    /*
-     * Do not look for, or inside compressed files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_COMPRESS", INT2NUM(MAGIC_NO_CHECK_COMPRESS));
-
-    /*
-     * Do not look for, or inside tar archive files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_TAR", INT2NUM(MAGIC_NO_CHECK_TAR));
-
-    /*
-     * Do not consult Magic files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_SOFT", INT2NUM(MAGIC_NO_CHECK_SOFT));
-
-    /*
-     * Check for EMX application type (only supported on EMX).
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_APPTYPE", INT2NUM(MAGIC_NO_CHECK_APPTYPE));
-
-    /*
-     * Do not check for ELF files (do not examine ELF file details).
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_ELF", INT2NUM(MAGIC_NO_CHECK_ELF));
-
-    /*
-     * Do not check for various types of text files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_TEXT", INT2NUM(MAGIC_NO_CHECK_TEXT));
-
-    /*
-     * Do not check for CDF files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_CDF", INT2NUM(MAGIC_NO_CHECK_CDF));
-
-    /*
-     * Do not look for known tokens inside ASCII files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_TOKENS", INT2NUM(MAGIC_NO_CHECK_TOKENS));
-
-    /*
-     * Return a MIME encoding, instead of a textual description.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_ENCODING", INT2NUM(MAGIC_NO_CHECK_ENCODING));
-
-    /*
-     * Do not use built-in tests; only consult the Magic file.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_BUILTIN", INT2NUM(MAGIC_NO_CHECK_BUILTIN));
-
-    /*
-     * Do not check for various types of text files, same as NO_CHECK_TEXT.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_ASCII", INT2NUM(MAGIC_NO_CHECK_ASCII));
-
-    /*
-     * Do not look for Fortran sequences inside ASCII files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_FORTRAN", INT2NUM(MAGIC_NO_CHECK_FORTRAN));
-
-    /*
-     * Do not look for troff sequences inside ASCII files.
-     */
-    rb_define_const(rb_cMagic, "NO_CHECK_TROFF", INT2NUM(MAGIC_NO_CHECK_TROFF));
-}
-
-/* :enddoc: */
+	id_at_paths = rb_intern("@paths");
+	id_at_flags = rb_intern("@flags");
+
+	rb_cMagic = rb_define_class("Magic", rb_cObject);
+	rb_define_alloc_func(rb_cMagic, magic_allocate);
+	/*
+	 * Raised when _Magic_ encounters an error.
+	 */
+	rb_mgc_eError = rb_define_class_under(rb_cMagic, "Error", rb_eStandardError);
+	/*
+	 * Stores current value of +errno+
+	 */
+	rb_define_attr(rb_mgc_eError, "errno", 1, 0);
+	/*
+	 * Raised when
+	 */
+	rb_mgc_eMagicError = rb_define_class_under(rb_cMagic, "MagicError", rb_mgc_eError);
+	/*
+	 * Raised when
+	 */
+	rb_mgc_eLibraryError = rb_define_class_under(rb_cMagic, "LibraryError", rb_mgc_eError);
+	/*
+	 * Raised when
+	 */
+	rb_mgc_eParameterError = rb_define_class_under(rb_cMagic, "ParameterError", rb_mgc_eError);
+	/*
+	 * Raised when
+	 */
+	rb_mgc_eFlagsError = rb_define_class_under(rb_cMagic, "FlagsError", rb_mgc_eError);
+	/*
+	 * Raised when
+	 */
+	rb_mgc_eNotImplementedError = rb_define_class_under(rb_cMagic, "NotImplementedError", rb_mgc_eError);
+
+	rb_define_singleton_method(rb_cMagic, "do_not_auto_load", RUBY_METHOD_FUNC(rb_mgc_get_do_not_auto_load_global), 0);
+	rb_define_singleton_method(rb_cMagic, "do_not_auto_load=", RUBY_METHOD_FUNC(rb_mgc_set_do_not_auto_load_global), 1);
+
+	rb_define_singleton_method(rb_cMagic, "do_not_stop_on_error", RUBY_METHOD_FUNC(rb_mgc_get_do_not_stop_on_error_global), 0);
+	rb_define_singleton_method(rb_cMagic, "do_not_stop_on_error=", RUBY_METHOD_FUNC(rb_mgc_set_do_not_stop_on_error_global), 1);
+
+	rb_define_singleton_method(rb_cMagic, "version", RUBY_METHOD_FUNC(rb_mgc_version), 0);
+
+	rb_define_method(rb_cMagic, "initialize", RUBY_METHOD_FUNC(rb_mgc_initialize), -2);
+
+	rb_define_method(rb_cMagic, "do_not_stop_on_error", RUBY_METHOD_FUNC(rb_mgc_get_do_not_stop_on_error), 0);
+	rb_define_method(rb_cMagic, "do_not_stop_on_error=", RUBY_METHOD_FUNC(rb_mgc_set_do_not_stop_on_error), 1);
+
+	rb_define_method(rb_cMagic, "open?", RUBY_METHOD_FUNC(rb_mgc_open_p), 0);
+	rb_define_method(rb_cMagic, "close", RUBY_METHOD_FUNC(rb_mgc_close), 0);
+	rb_define_method(rb_cMagic, "closed?", RUBY_METHOD_FUNC(rb_mgc_close_p), 0);
+
+	rb_define_method(rb_cMagic, "paths", RUBY_METHOD_FUNC(rb_mgc_get_paths), 0);
+
+	rb_define_method(rb_cMagic, "get_parameter", RUBY_METHOD_FUNC(rb_mgc_get_parameter), 1);
+	rb_define_method(rb_cMagic, "set_parameter", RUBY_METHOD_FUNC(rb_mgc_set_parameter), 2);
+
+	rb_define_method(rb_cMagic, "flags", RUBY_METHOD_FUNC(rb_mgc_get_flags), 0);
+	rb_define_method(rb_cMagic, "flags=", RUBY_METHOD_FUNC(rb_mgc_set_flags), 1);
+
+	rb_define_method(rb_cMagic, "file", RUBY_METHOD_FUNC(rb_mgc_file), 1);
+	rb_define_method(rb_cMagic, "buffer", RUBY_METHOD_FUNC(rb_mgc_buffer), 1);
+	rb_define_method(rb_cMagic, "descriptor", RUBY_METHOD_FUNC(rb_mgc_descriptor), 1);
+
+	rb_alias(rb_cMagic, rb_intern("fd"), rb_intern("descriptor"));
+
+	rb_define_method(rb_cMagic, "load", RUBY_METHOD_FUNC(rb_mgc_load), -2);
+	rb_define_method(rb_cMagic, "load_buffers", RUBY_METHOD_FUNC(rb_mgc_load_buffers), -2);
+	rb_define_method(rb_cMagic, "loaded?", RUBY_METHOD_FUNC(rb_mgc_load_p), 0);
+
+	rb_alias(rb_cMagic, rb_intern("load_files"), rb_intern("load"));
+
+	rb_define_method(rb_cMagic, "compile", RUBY_METHOD_FUNC(rb_mgc_compile), 1);
+	rb_define_method(rb_cMagic, "check", RUBY_METHOD_FUNC(rb_mgc_check), 1);
+
+	rb_alias(rb_cMagic, rb_intern("valid?"), rb_intern("check"));
+
+	/*
+	 * Controls how many levels of recursion will be followed for
+	 * indirect magic entries.
+	 */
+	MAGIC_DEFINE_PARAMETER(INDIR_MAX);
+	/*
+	 * Controls the maximum number of calls for name or use magic.
+	 */
+	MAGIC_DEFINE_PARAMETER(NAME_MAX);
+	/*
+	 * Controls how many ELF program sections will be processed.
+	 */
+	MAGIC_DEFINE_PARAMETER(ELF_PHNUM_MAX);
+	/*
+	 * Controls how many ELF sections will be processed.
+	 */
+	MAGIC_DEFINE_PARAMETER(ELF_SHNUM_MAX);
+	/*
+	 * Controls how many ELF notes will be processed.
+	 */
+	MAGIC_DEFINE_PARAMETER(ELF_NOTES_MAX);
+	/*
+	 * Controls the length limit for regular expression searches.
+	 */
+	MAGIC_DEFINE_PARAMETER(REGEX_MAX);
+	/*
+	 * Controls the maximum number of bytes to read from a file.
+	 */
+	MAGIC_DEFINE_PARAMETER(BYTES_MAX);
+	/*
+	 * No special handling and/or flags specified. Default behavior.
+	 */
+	MAGIC_DEFINE_FLAG(NONE);
+	/*
+	 * Print debugging messages to standard error output.
+	 */
+	MAGIC_DEFINE_FLAG(DEBUG);
+	/*
+	 * If the file queried is a symbolic link, follow it.
+	 */
+	MAGIC_DEFINE_FLAG(SYMLINK);
+	/*
+	 * If the file is compressed, unpack it and look at the contents.
+	 */
+	MAGIC_DEFINE_FLAG(COMPRESS);
+	/*
+	 * If the file is a block or character special device, then open
+	 * the device and try to look at the contents.
+	 */
+	MAGIC_DEFINE_FLAG(DEVICES);
+	/*
+	 * Return a MIME type string, instead of a textual description.
+	 */
+	MAGIC_DEFINE_FLAG(MIME_TYPE);
+	/*
+	 * Return all matches, not just the first.
+	 */
+	MAGIC_DEFINE_FLAG(CONTINUE);
+	/*
+	 * Check the Magic database for consistency and print warnings to
+	 * standard error output.
+	 */
+	MAGIC_DEFINE_FLAG(CHECK);
+	/*
+	 * Attempt to preserve access time (atime, utime or utimes) of the
+	 * file queried on systems that support such system calls.
+	 */
+	MAGIC_DEFINE_FLAG(PRESERVE_ATIME);
+	/*
+	 * Do not convert unprintable characters to an octal representation.
+	 */
+	MAGIC_DEFINE_FLAG(RAW);
+	/*
+	 * Treat operating system errors while trying to open files and follow
+	 * symbolic links as first class errors, instead of storing them in the
+	 * Magic library error buffer for retrieval later.
+	 */
+	MAGIC_DEFINE_FLAG(ERROR);
+	/*
+	 * Return a MIME encoding, instead of a textual description.
+	 */
+	MAGIC_DEFINE_FLAG(MIME_ENCODING);
+	/*
+	 * A shorthand for using MIME_TYPE and MIME_ENCODING flags together.
+	 */
+	MAGIC_DEFINE_FLAG(MIME);
+	/*
+	 * Return the Apple creator and type.
+	 */
+	MAGIC_DEFINE_FLAG(APPLE);
+	/*
+	 * Do not look for, or inside compressed files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_COMPRESS);
+	/*
+	 * Do not look for, or inside tar archive files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_TAR);
+	/*
+	 * Do not consult Magic files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_SOFT);
+	/*
+	 * Check for EMX application type (only supported on EMX).
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_APPTYPE);
+	/*
+	 * Do not check for ELF files (do not examine ELF file details).
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_ELF);
+	/*
+	 * Do not check for various types of text files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_TEXT);
+	/*
+	 * Do not check for CDF files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_CDF);
+	/*
+	 * Do not check for CSV files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_CSV);
+	/*
+	 * Do not look for known tokens inside ASCII files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_TOKENS);
+	/*
+	 * Return a MIME encoding, instead of a textual description.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_ENCODING);
+	/*
+	 * Do not check for JSON files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_JSON);
+	/*
+	 * Do not use built-in tests; only consult the Magic file.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_BUILTIN);
+	/*
+	 * Do not check for various types of text files, same as NO_CHECK_TEXT.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_ASCII);
+	/*
+	 * Do not look for Fortran sequences inside ASCII files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_FORTRAN);
+	/*
+	 * Do not look for troff sequences inside ASCII files.
+	 */
+	MAGIC_DEFINE_FLAG(NO_CHECK_TROFF);
+	/*
+	 * Return a slash-separated list of extensions for this file type.
+	 */
+	MAGIC_DEFINE_FLAG(EXTENSION);
+	/*
+	 * Do not report on compression, only report about the uncompressed data.
+	 */
+	MAGIC_DEFINE_FLAG(COMPRESS_TRANSP);
+}
 
 #if defined(__cplusplus)
 }
 #endif
-
-/* vim: set ts=8 sw=4 sts=2 et : */