>From 7e38738b50c7f16b6bc28c6db0f6413fe371e062 Mon Sep 17 00:00:00 2001 From: Julian Andres Klode Date: Tue, 1 Dec 2009 20:09:43 +0100 Subject: [PATCH] Add libarchive bindings. Bind libarchive(3) to a large extent; excluding the ACL functions which are severily underdocumented. --- vapi/libarchive.deps | 1 + vapi/libarchive.vapi | 367 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 368 insertions(+), 0 deletions(-) create mode 100644 vapi/libarchive.deps create mode 100644 vapi/libarchive.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..b11c8bf --- /dev/null +++ b/vapi/libarchive.vapi @@ -0,0 +1,367 @@ +/* libarchive.vapi - Bindings for libarchive(3) (version 2). + * + * Copyright (C) 2009 Julian Andres Klode + * + * 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 + * + */ + + +[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 (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 (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); + } + } +} -- 1.6.5.3