[vala] Add libarchive bindings.

[Evan Nemerson <evann src gnome org>]

commit e8082b1ed4fedaf97f7d64672305d11b2f5a1453
Author: Julian Andres Klode <jak jak-linux org>
Date:   Wed Dec 2 12:11:03 2009 -0800

    Add libarchive bindings.
    
    Bind libarchive(3) to a large extent; excluding the ACL functions
    which are severely underdocumented.

 vapi/Makefile.am     |    2 +
 vapi/libarchive.deps |    1 +
 vapi/libarchive.vapi |  367 ++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 370 insertions(+), 0 deletions(-)
---
diff --git a/vapi/Makefile.am b/vapi/Makefile.am
index a15e990..b66ef4b 100644
--- a/vapi/Makefile.am
+++ b/vapi/Makefile.am
@@ -96,6 +96,8 @@ dist_vapi_DATA = \
 	hildon-fm-2.deps \
 	hildon-fm-2.vapi \
 	json-glib-1.0.vapi \
+	libarchive.deps \
+	libarchive.vapi \
 	libbonoboui-2.0.vapi \
 	libdaemon.vapi \
 	libepc-1.0.vapi \
diff --git a/vapi/libarchive.deps b/vapi/libarchive.deps
new file mode 100644
index 0000000..b3188f7
--- /dev/null
+++ b/vapi/libarchive.deps
@@ -0,0 +1 @@
+posix
diff --git a/vapi/libarchive.vapi b/vapi/libarchive.vapi
new file mode 100644
index 0000000..a1742e2
--- /dev/null
+++ b/vapi/libarchive.vapi
@@ -0,0 +1,367 @@
+/* libarchive.vapi - Bindings for libarchive(3) (version 2).
+ *
+ * Copyright (C) 2009 Julian Andres Klode <jak jak-linux org>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+ *
+ * Author:
+ * 	Julian Andres Klode <jak jak-linux org>
+ *
+ */
+
+
+[CCode (cprefix="ARCHIVE_", lower_case_cprefix="archive_", cheader_filename = "archive.h")]
+namespace Archive {
+	public const int VERSION_NUMBER;
+	public const string VERSION_STRING;
+	public int version_number ();
+	public unowned string version_string ();
+
+	[CCode (instance_pos = 1.9, cname="archive_read_callback")]
+	public delegate ssize_t ReadCallback (Archive archive, out void* buffer);
+	[CCode (instance_pos = 1.9, cname="archive_skip_callback")]
+	public delegate Posix.off_t SkipCallback (Archive archive, Posix.off_t request);
+	[CCode (instance_pos = 1.9, cname="archive_write_callback")]
+	public delegate ssize_t WriteCallback (Archive archive, void* buffer, size_t length);
+	[CCode (instance_pos = 1.9, cname="archive_open_callback")]
+	public delegate int OpenCallback (Archive archive);
+
+	[CCode (cname="archive_close_callback")]
+	public delegate int CloseCallback (Archive archive);
+
+	// In reality a "void (*_progress_func)(void *)" parameter without name.
+	public delegate void ExtractProgressCallback ();
+
+	[CCode (cprefix="ARCHIVE_", cname="int")]
+	public enum Result {
+		EOF,
+		OK,
+		RETRY,
+		WARN,
+		FAILED
+	}
+
+	[CCode (cname="int")]
+	public enum Compression {
+		NONE,
+		GZIP,
+		BZIP2,
+		COMPRESS,
+		PROGRAM,
+		LZMA
+	}
+
+	[CCode (cname="int")]
+	public enum Format {
+		BASE_MASK,
+		CPIO,
+		CPIO_POSIX,
+		CPIO_BIN_LE,
+		CPIO_BIN_BE,
+		CPIO_SVR4_NOCRC,
+		CPIO_SVR4_CRC,
+		SHAR,
+		SHAR_BASE,
+		SHAR_DUMP,
+		TAR,
+		TAR_USTAR,
+		TAR_PAX_INTERCHANGE,
+		TAR_PAX_RESTRICTED,
+		TAR_GNUTAR,
+		ISO9660,
+		ISO9660_ROCKRIDGE,
+		ZIP,
+		EMPTY,
+		AR,
+		AR_GNU,
+		AR_BSD,
+		MTREE
+	}
+
+	[CCode (cprefix="ARCHIVE_EXTRACT_", cname="int")]
+	public enum ExtractFlags {
+		OWNER,
+		PERM,
+		TIME,
+		NO_OVERWRITE,
+		UNLINK,
+		ACL,
+		FFLAGS,
+		XATTR,
+		SECURE_SYMLINKS,
+		SECURE_NODOTDOT,
+		NO_AUTODIR,
+		NO_OVERWRITE_NEWER,
+		SPARSE
+	}
+
+	[Compact]
+	[CCode (cname="struct archive", cprefix="archive_")]
+	public class Archive {
+		public int64 position_compressed ();
+		public int64 position_uncompressed ();
+
+		public Compression compression ();
+		public Format format ();
+		public unowned string compression_name ();
+		public unowned string format_name ();
+
+		public int errno ();
+		public unowned string error_string ();
+		public void clear_error ();
+		public void set_error (int err, string fmt, ...);
+		public void copy_error (Archive src);
+	}
+
+
+	[Compact]
+	[CCode (cname="struct archive", free_function="archive_read_finish")]
+	public class Read : Archive {
+		public Read ();
+		public Result support_compression_all ();
+		public Result support_compression_bzip2 ();
+		public Result support_compression_compress ();
+		public Result support_compression_gzip ();
+		public Result support_compression_lzma ();
+		public Result support_compression_none ();
+		public Result support_compression_program (string command);
+		public Result support_format_all ();
+		public Result support_format_ar ();
+		public Result support_format_cpio ();
+		public Result support_format_empty ();
+		public Result support_format_gnutar ();
+		public Result support_format_iso9660 ();
+		public Result support_format_mtree ();
+		public Result support_format_tar ();
+		public Result support_format_zip ();
+
+
+		public Result open (
+			[CCode (delegate_target_pos = 0.9)] OpenCallback ocb,
+			[CCode (delegate_target_pos = 0.9)] ReadCallback rcb,
+			[CCode (delegate_target_pos = 0.9)] CloseCallback ccb
+		);
+
+		public Result open2 (
+			[CCode (delegate_target_pos = 0.9)] OpenCallback ocb,
+			[CCode (delegate_target_pos = 0.9)] ReadCallback rcb,
+			[CCode (delegate_target_pos = 0.9)] SkipCallback scb,
+			[CCode (delegate_target_pos = 0.9)] CloseCallback ccb
+		);
+
+		public Result open_filename (string filename, size_t _block_size);
+		public Result open_memory (void* buff, size_t size);
+		public Result open_fd (int fd, size_t block_size);
+#if POSIX
+		public Result open_FILE (Posix.FILE file);
+#else
+		public Result open_FILE (GLib.FileStream file);
+#endif
+		public Result next_header (out unowned Entry entry);
+		public int64 header_position ();
+
+		[CCode (cname="archive_read_data")]
+		public ssize_t read_data (void* buffer, size_t size);
+		[CCode (cname="archive_read_block")]
+		public Result read_data_block (out void* buff, out size_t size, out Posix.off_t offset);
+		[CCode (cname="archive_read_data_skip")]
+		public Result read_data_skip ();
+		[CCode (cname="archive_read_data_into_buffer")]
+		public Result read_data_into_buffer (void* buffer, ssize_t len);
+		[CCode (cname="archive_read_data_into_fd")]
+		public Result read_data_into_fd (int fd);
+
+		public Result extract (Entry entry, ExtractFlags? flags=0);
+		public Result extract2 (Entry entry, Write dest);
+		public void extract_set_progress_callback (ExtractProgressCallback cb);
+		public void extract_set_skip_file (Posix.dev_t dev, Posix.ino_t ino);
+		public Result close ();
+	}
+
+	[CCode (cname = "struct archive", free_function="archive_write_finish")]
+	public class Write : Archive {
+		public Write ();
+		public Result set_compression_bzip2 ();
+		public Result set_compression_compress ();
+		public Result set_compression_gzip ();
+		public Result set_compression_none ();
+		public Result set_compression_program (string cmd);
+		public Result set_format (Format format);
+		public Result set_format_by_name (string name);
+		public Result set_format_ar_bsd ();
+		public Result set_format_ar_svr4 ();
+		public Result set_format_cpio ();
+		public Result set_format_cpio_newc ();
+		public Result set_format_mtree ();
+		public Result set_format_pax ();
+		public Result set_format_pax_restricted ();
+		public Result set_format_shar ();
+		public Result set_format_shar_dump ();
+		public Result set_format_ustar ();
+
+		public Result set_bytes_per_block (int bytes_per_block);
+		public int get_bytes_per_block ();
+		public Result set_bytes_in_last_block (int bytes_in_last_block);
+		public int get_bytes_in_last_block ();
+		public Result set_skip_file (Posix.dev_t dev, Posix.ino_t ino);
+
+		public Result open (
+			[CCode (delegate_target_pos = 0.9)] OpenCallback ocb,
+			[CCode (delegate_target_pos = 0.9)] WriteCallback rcb,
+			[CCode (delegate_target_pos = 0.9)] CloseCallback ccb
+		);
+		public Result open_fd (int fd);
+		public Result open_filename (string filename);
+#if POSIX
+		public Result open_FILE (Posix.FILE file);
+#else
+		public Result open_FILE (GLib.FileStream file);
+#endif
+		public Result open_memory (void* buffer, size_t buff_size, out size_t used);
+
+		[CCode (cname="archive_write_entry")]
+		public Result write_header (Entry entry);
+		[CCode (cname="archive_write_data")]
+		public ssize_t write_data (void* data, size_t size);
+		[CCode (cname="archive_write_data_block")]
+		public ssize_t write_data_block (void* data, size_t size, Posix.off_t offset);
+
+		public Result finish_entry ();
+		public Result close ();
+	}
+
+	[Compact]
+	[CCode (cname = "struct archive", free_function="archive_write_finish")]
+	public class WriteDisk : Write {
+		public WriteDisk ();
+
+		public Result set_skip_file (Posix.dev_t dev, Posix.ino_t ino);
+		public Result set_options (ExtractFlags flags);
+		public Result set_standard_lookup ();
+
+		// HACK, they have no name in C. May not work correctly.
+		[CCode (instance_pos = 0, cname="gid_t")]
+		public delegate Posix.gid_t GroupLookup (string group, Posix.gid_t gid);
+		[CCode (instance_pos = 0, cname="uid_t")]
+		public delegate Posix.uid_t UserLookup (string user, Posix.uid_t uid);
+		[CCode (instance_pos = 0, cname="void")]
+		public delegate void Cleanup ();
+
+		public Result set_group_lookup (
+			[CCode (delegate_target_pos = 0.9) ] GroupLookup lookup,
+			[CCode (delegate_target_pos = 0.9) ] Cleanup? cleanup = null
+		);
+
+		public Result set_user_lookup (
+			[CCode (delegate_target_pos = 0.9) ] UserLookup lookup,
+			[CCode (delegate_target_pos = 0.9) ] Cleanup? cleanup = null
+		);
+	}
+
+	[Compact]
+	[CCode (cname = "struct archive_entry", cheader_filename = "archive_entry.h")]
+	public class Entry {
+		public Entry ();
+		public time_t atime ();
+		public long atime_nsec ();
+		public bool atime_is_set ();
+		public time_t birthtime ();
+		public long birthtime_nsec ();
+		public bool birthtime_is_set ();
+		public time_t ctime ();
+		public long ctime_nsec ();
+		public bool ctime_is_set ();
+		public Posix.dev_t dev ();
+		public Posix.dev_t devmajor ();
+		public Posix.dev_t devminor ();
+		public Posix.mode_t filetype ();
+		public unowned string fflags_text ();
+		public Posix.gid_t gid ();
+		public unowned string gname ();
+		public unowned string hardlink ();
+		public Posix.ino_t ino ();
+		public Posix.mode_t mode ();
+		public time_t mtime ();
+		public long mtime_nsec ();
+		public bool mtime_is_set ();
+		public uint nlink ();
+		public unowned string pathname ();
+		public Posix.dev_t rdev ();
+		public Posix.dev_t rdevmajor ();
+		public Posix.dev_t rdevminor ();
+		public unowned string sourcepath ();
+		public int64 size ();
+		public bool size_is_set ();
+		public unowned string strmode ();
+		public unowned string symlink ();
+		public Posix.uid_t uid ();
+		public unowned string uname ();
+		public void set_atime (time_t atime, long blah);
+		public void unset_atime ();
+		public void set_birthtime (time_t birthtime, long blah);
+		public void unset_birthtime ();
+		public void set_ctime (time_t atime, long blah);
+		public void unset_ctime ();
+		public void set_dev (Posix.dev_t dev);
+		public void set_devmajor (Posix.dev_t major);
+		public void set_devminor (Posix.dev_t major);
+		public void set_filetype (uint filetype);
+		public void set_fflags (ulong set, ulong clear);
+		public unowned string copy_fflags_text (string text);
+		public void set_gid (Posix.gid_t gid);
+		public void set_gname (string gname);
+		public Result update_gname_utf8 (string gname);
+		public void set_hardlink (string link);
+		public void set_ino (ulong ino);
+		public void set_link (string link);
+		public Result update_link_utf8 (string link);
+		public void set_mode (Posix.mode_t mode);
+		public void set_mtime (time_t mtime, long blah);
+		public void unset_mtime ();
+		public void set_nlink (uint nlink);
+		public void set_pathname (string pathname);
+		public Result  update_pathname_utf8 (string pathname);
+		public void set_perm (Posix.mode_t mode);
+		public void set_rdev (Posix.dev_t dev);
+		public void set_rdevmajor (Posix.dev_t devmajor);
+		public void set_rdevminor (Posix.dev_t devminor);
+		public void set_size (int64 size);
+		public void unset_size ();
+		public void copy_sourcepath (string sourcepath);
+		public void set_symlink (string symlink);
+		public void set_uid (Posix.uid_t uid);
+		public void set_uname (string uname);
+		public Result update_uname_utf8 (string uname);
+
+		public unowned Posix.Stat stat ();
+		public void copy_stat (Posix.Stat stat);
+
+		public unowned Entry clear ();
+		public Entry clone ();
+
+		public void xattr_clear();
+		public void xattr_add_entry(string name, void* value, size_t size);
+		public int xattr_count();
+		public Result xattr_reset();
+		public Result xattr_next(out unowned string name, out void* value, out size_t size);
+
+		[Compact]
+		public class LinkResolver {
+			public LinkResolver ();
+			public void set_strategy (Format format_code);
+			public void linkify (Entry a, Entry b);
+		}
+	}
+}