blob: 473eb78ced2d43d21662a640a9bade6b476e90df [file] [log] [blame]
Index: config.h
===================================================================
--- config.h (revision 0)
+++ config.h (revision 0)
@@ -0,0 +1,211 @@
+/* config.h. Generated from config.h.in by configure. */
+/* config.h.in. Generated from configure.ac by autoheader. */
+
+/* Define if building universal (internal helper macro) */
+/* #undef AC_APPLE_UNIVERSAL_BUILD */
+
+/* Define to 1 if you have the <arpa/inet.h> header file. */
+#define HAVE_ARPA_INET_H 1
+
+/* Define to 1 if you have the `basename' function. */
+#define HAVE_BASENAME 1
+
+/* Define to 1 if you have the <byteswap.h> header file. */
+#define HAVE_BYTESWAP_H 1
+
+/* Define to 1 if you have the <ctype.h> header file. */
+#define HAVE_CTYPE_H 1
+
+/* Define to 1 if you have the <dlfcn.h> header file. */
+#define HAVE_DLFCN_H 1
+
+/* Define to 1 if you have the <errno.h> header file. */
+#define HAVE_ERRNO_H 1
+
+/* Define to 1 if you have the <fcntl.h> header file. */
+#define HAVE_FCNTL_H 1
+
+/* Define to 1 if you have the <getopt.h> header file. */
+#define HAVE_GETOPT_H 1
+
+/* Define if you have the iconv() function and it works. */
+#define HAVE_ICONV 1
+
+/* Define to 1 if you have the <inttypes.h> header file. */
+#define HAVE_INTTYPES_H 1
+
+/* Define to 1 if you have the <langinfo.h> header file. */
+#define HAVE_LANGINFO_H 1
+
+/* Define to 1 if you have the `gcrypt' library (-lgcrypt). */
+#define HAVE_LIBGCRYPT 1
+
+/* Define to 1 if you have the <libgen.h> header file. */
+#define HAVE_LIBGEN_H 1
+
+/* Have libusb 0.x */
+/* #undef HAVE_LIBUSB0 */
+
+/* Have libusb 1.0 */
+#define HAVE_LIBUSB1 /**/
+
+/* Define to 1 if you have the <limits.h> header file. */
+#define HAVE_LIMITS_H 1
+
+/* Define to 1 if you have the <locale.h> header file. */
+#define HAVE_LOCALE_H 1
+
+/* Define to 1 if your system has a GNU libc compatible `malloc' function, and
+ to 0 otherwise. */
+#define HAVE_MALLOC 1
+
+/* Define to 1 if you have the <memory.h> header file. */
+#define HAVE_MEMORY_H 1
+
+/* Define to 1 if you have the `memset' function. */
+#define HAVE_MEMSET 1
+
+/* Define to 1 if you have the `mkstemp' function. */
+#define HAVE_MKSTEMP 1
+
+/* Have libopenusb 1.0 */
+/* #undef HAVE_OPENUSB */
+
+/* Define to 1 if you have the `select' function. */
+#define HAVE_SELECT 1
+
+/* Define to 1 if `stat' has the bug that it succeeds when given the
+ zero-length file name argument. */
+/* #undef HAVE_STAT_EMPTY_STRING_BUG */
+
+/* Define to 1 if you have the <stdint.h> header file. */
+#define HAVE_STDINT_H 1
+
+/* Define to 1 if you have the <stdio.h> header file. */
+#define HAVE_STDIO_H 1
+
+/* Define to 1 if you have the <stdlib.h> header file. */
+#define HAVE_STDLIB_H 1
+
+/* Define to 1 if you have the `strdup' function. */
+#define HAVE_STRDUP 1
+
+/* Define to 1 if you have the `strerror' function. */
+#define HAVE_STRERROR 1
+
+/* Define to 1 if you have the <strings.h> header file. */
+#define HAVE_STRINGS_H 1
+
+/* Define to 1 if you have the <string.h> header file. */
+#define HAVE_STRING_H 1
+
+/* Define to 1 if you have the `strndup' function. */
+#define HAVE_STRNDUP 1
+
+/* Define to 1 if you have the `strrchr' function. */
+#define HAVE_STRRCHR 1
+
+/* Define to 1 if you have the `strtoul' function. */
+#define HAVE_STRTOUL 1
+
+/* Define to 1 if `st_blksize' is a member of `struct stat'. */
+#define HAVE_STRUCT_STAT_ST_BLKSIZE 1
+
+/* Define to 1 if your `struct stat' has `st_blksize'. Deprecated, use
+ `HAVE_STRUCT_STAT_ST_BLKSIZE' instead. */
+#define HAVE_ST_BLKSIZE 1
+
+/* Define to 1 if you have the <sys/stat.h> header file. */
+#define HAVE_SYS_STAT_H 1
+
+/* Define to 1 if you have the <sys/time.h> header file. */
+#define HAVE_SYS_TIME_H 1
+
+/* Define to 1 if you have the <sys/types.h> header file. */
+#define HAVE_SYS_TYPES_H 1
+
+/* Define to 1 if you have the <sys/uio.h> header file. */
+#define HAVE_SYS_UIO_H 1
+
+/* Define to 1 if you have the <unistd.h> header file. */
+#define HAVE_UNISTD_H 1
+
+/* Define to 1 if you have the `usleep' function. */
+#define HAVE_USLEEP 1
+
+/* Define as const if the declaration of iconv() needs const. */
+#define ICONV_CONST
+
+/* Define to 1 if `lstat' dereferences a symlink specified with a trailing
+ slash. */
+#define LSTAT_FOLLOWS_SLASHED_SYMLINK 1
+
+/* Define to the sub-directory in which libtool stores uninstalled libraries.
+ */
+#define LT_OBJDIR ".libs/"
+
+/* Name of package */
+#define PACKAGE "libmtp"
+
+/* Define to the address where bug reports for this package should be sent. */
+#define PACKAGE_BUGREPORT "libmtp-discuss@lists.sourceforge.net"
+
+/* Define to the full name of this package. */
+#define PACKAGE_NAME "libmtp"
+
+/* Define to the full name and version of this package. */
+#define PACKAGE_STRING "libmtp 1.1.5"
+
+/* Define to the one symbol short name of this package. */
+#define PACKAGE_TARNAME "libmtp"
+
+/* Define to the home page for this package. */
+#define PACKAGE_URL ""
+
+/* Define to the version of this package. */
+#define PACKAGE_VERSION "1.1.5"
+
+/* Define as the return type of signal handlers (`int' or `void'). */
+#define RETSIGTYPE void
+
+/* Define to 1 if you have the ANSI C header files. */
+#define STDC_HEADERS 1
+
+/* Define to 1 if you can safely include both <sys/time.h> and <time.h>. */
+#define TIME_WITH_SYS_TIME 1
+
+/* Enable MTPZ functionality */
+/* #undef USE_MTPZ */
+
+/* Version number of package */
+#define VERSION "1.1.5"
+
+/* Define WORDS_BIGENDIAN to 1 if your processor stores words with the most
+ significant byte first (like Motorola and SPARC, unlike Intel). */
+#if defined AC_APPLE_UNIVERSAL_BUILD
+# if defined __BIG_ENDIAN__
+# define WORDS_BIGENDIAN 1
+# endif
+#else
+# ifndef WORDS_BIGENDIAN
+/* # undef WORDS_BIGENDIAN */
+# endif
+#endif
+
+/* Number of bits in a file offset, on hosts where this is settable. */
+/* #undef _FILE_OFFSET_BITS */
+
+/* Define for large files, on AIX-style hosts. */
+/* #undef _LARGE_FILES */
+
+/* Define to empty if `const' does not conform to ANSI C. */
+/* #undef const */
+
+/* Define to rpl_malloc if the replacement function should be used. */
+/* #undef malloc */
+
+/* Define to `long int' if <sys/types.h> does not define. */
+/* #undef off_t */
+
+/* Define to `unsigned int' if <sys/types.h> does not define. */
+/* #undef size_t */
Property changes on: config.h
___________________________________________________________________
Added: svn:eol-style
+ LF
Index: libmtp.gyp
===================================================================
--- libmtp.gyp (revision 0)
+++ libmtp.gyp (revision 0)
@@ -0,0 +1,71 @@
+# Copyright (c) 2012 The Chromium Authors. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+{
+ 'variables': {
+ 'use_system_libmtp%': 0,
+ },
+ 'conditions': [
+ ['use_system_libmtp==0', {
+ 'targets': [
+ {
+ 'target_name': 'libmtp',
+ 'type': 'shared_library',
+ 'product_name': 'mtp',
+ 'dependencies': [
+ '../../third_party/libusb/libusb.gyp:libusb',
+ ],
+ 'sources': [
+ 'src/libmtp.c',
+ 'src/libusb1-glue.c',
+ 'src/ptp.c',
+ 'src/unicode.c',
+ 'src/util.c',
+ ],
+ 'cflags!': ['-fvisibility=hidden'],
+ 'include_dirs': [
+ '.',
+ 'src',
+ ],
+ 'direct_dependent_settings': {
+ 'include_dirs': [
+ 'src',
+ ],
+ },
+ },
+ ],
+ }, { # use_system_libmtp==1
+ 'conditions': [
+ ['sysroot!=""', {
+ 'variables': {
+ 'pkg-config': '../../build/linux/pkg-config-wrapper "<(sysroot)" "<(target_arch)"',
+ },
+ }, {
+ 'variables': {
+ 'pkg-config': 'pkg-config'
+ },
+ }],
+ ],
+ 'targets': [
+ {
+ 'target_name': 'libmtp',
+ 'type': 'none',
+ 'direct_dependent_settings': {
+ 'cflags': [
+ '<!@(<(pkg-config) --cflags libmtp)',
+ ],
+ },
+ 'link_settings': {
+ 'ldflags': [
+ '<!@(<(pkg-config) --libs-only-L --libs-only-other libmtp)',
+ ],
+ 'libraries': [
+ '<!@(<(pkg-config) --libs-only-l libmtp)',
+ ],
+ },
+ }
+ ],
+ }],
+ ]
+}
Property changes on: libmtp.gyp
___________________________________________________________________
Added: svn:eol-style
+ LF
Index: src/gphoto2-endian.h
===================================================================
--- src/gphoto2-endian.h (revision 0)
+++ src/gphoto2-endian.h (revision 0)
@@ -0,0 +1,124 @@
+/* This file is generated automatically by configure */
+/* It is valid only for the system type x86_64-unknown-linux-gnu */
+
+#ifndef __BYTEORDER_H
+#define __BYTEORDER_H
+
+/* ntohl and relatives live here */
+#include <arpa/inet.h>
+
+/* Define generic byte swapping functions */
+#include <byteswap.h>
+#define swap16(x) bswap_16(x)
+#define swap32(x) bswap_32(x)
+#define swap64(x) bswap_64(x)
+
+/* The byte swapping macros have the form: */
+/* EENN[a]toh or htoEENN[a] where EE is be (big endian) or */
+/* le (little-endian), NN is 16 or 32 (number of bits) and a, */
+/* if present, indicates that the endian side is a pointer to an */
+/* array of uint8_t bytes instead of an integer of the specified length. */
+/* h refers to the host's ordering method. */
+
+/* So, to convert a 32-bit integer stored in a buffer in little-endian */
+/* format into a uint32_t usable on this machine, you could use: */
+/* uint32_t value = le32atoh(&buf[3]); */
+/* To put that value back into the buffer, you could use: */
+/* htole32a(&buf[3], value); */
+
+/* Define aliases for the standard byte swapping macros */
+/* Arguments to these macros must be properly aligned on natural word */
+/* boundaries in order to work properly on all architectures */
+#ifndef htobe16
+# define htobe16(x) htons(x)
+#endif
+#ifndef htobe32
+# define htobe32(x) htonl(x)
+#endif
+#ifndef be16toh
+# define be16toh(x) ntohs(x)
+#endif
+#ifndef be32toh
+# define be32toh(x) ntohl(x)
+#endif
+
+#define HTOBE16(x) (x) = htobe16(x)
+#define HTOBE32(x) (x) = htobe32(x)
+#define BE32TOH(x) (x) = be32toh(x)
+#define BE16TOH(x) (x) = be16toh(x)
+
+/* On little endian machines, these macros are null */
+#ifndef htole16
+# define htole16(x) (x)
+#endif
+#ifndef htole32
+# define htole32(x) (x)
+#endif
+#ifndef htole64
+# define htole64(x) (x)
+#endif
+#ifndef le16toh
+# define le16toh(x) (x)
+#endif
+#ifndef le32toh
+# define le32toh(x) (x)
+#endif
+#ifndef le64toh
+# define le64toh(x) (x)
+#endif
+
+#define HTOLE16(x) (void) (x)
+#define HTOLE32(x) (void) (x)
+#define HTOLE64(x) (void) (x)
+#define LE16TOH(x) (void) (x)
+#define LE32TOH(x) (void) (x)
+#define LE64TOH(x) (void) (x)
+
+/* These don't have standard aliases */
+#ifndef htobe64
+# define htobe64(x) swap64(x)
+#endif
+#ifndef be64toh
+# define be64toh(x) swap64(x)
+#endif
+
+#define HTOBE64(x) (x) = htobe64(x)
+#define BE64TOH(x) (x) = be64toh(x)
+
+/* Define the C99 standard length-specific integer types */
+#include <_stdint.h>
+
+/* Here are some macros to create integers from a byte array */
+/* These are used to get and put integers from/into a uint8_t array */
+/* with a specific endianness. This is the most portable way to generate */
+/* and read messages to a network or serial device. Each member of a */
+/* packet structure must be handled separately. */
+
+/* Non-optimized but portable macros */
+#define be16atoh(x) ((uint16_t)(((x)[0]<<8)|(x)[1]))
+#define be32atoh(x) ((uint32_t)(((x)[0]<<24)|((x)[1]<<16)|((x)[2]<<8)|(x)[3]))
+#define be64atoh_x(x,off,shift) (((uint64_t)((x)[off]))<<shift)
+#define be64atoh(x) ((uint64_t)(be64atoh_x(x,0,56)|be64atoh_x(x,1,48)|be64atoh_x(x,2,40)| \
+ be64atoh_x(x,3,32)|be64atoh_x(x,4,24)|be64atoh_x(x,5,16)|be64atoh_x(x,6,8)|((x)[7])))
+#define le16atoh(x) ((uint16_t)(((x)[1]<<8)|(x)[0]))
+#define le32atoh(x) ((uint32_t)(((x)[3]<<24)|((x)[2]<<16)|((x)[1]<<8)|(x)[0]))
+#define le64atoh_x(x,off,shift) (((uint64_t)(x)[off])<<shift)
+#define le64atoh(x) ((uint64_t)(le64atoh_x(x,7,56)|le64atoh_x(x,6,48)|le64atoh_x(x,5,40)| \
+ le64atoh_x(x,4,32)|le64atoh_x(x,3,24)|le64atoh_x(x,2,16)|le64atoh_x(x,1,8)|((x)[0])))
+
+#define htobe16a(a,x) (a)[0]=(uint8_t)((x)>>8), (a)[1]=(uint8_t)(x)
+#define htobe32a(a,x) (a)[0]=(uint8_t)((x)>>24), (a)[1]=(uint8_t)((x)>>16), \
+ (a)[2]=(uint8_t)((x)>>8), (a)[3]=(uint8_t)(x)
+#define htobe64a(a,x) (a)[0]=(uint8_t)((x)>>56), (a)[1]=(uint8_t)((x)>>48), \
+ (a)[2]=(uint8_t)((x)>>40), (a)[3]=(uint8_t)((x)>>32), \
+ (a)[4]=(uint8_t)((x)>>24), (a)[5]=(uint8_t)((x)>>16), \
+ (a)[6]=(uint8_t)((x)>>8), (a)[7]=(uint8_t)(x)
+#define htole16a(a,x) (a)[1]=(uint8_t)((x)>>8), (a)[0]=(uint8_t)(x)
+#define htole32a(a,x) (a)[3]=(uint8_t)((x)>>24), (a)[2]=(uint8_t)((x)>>16), \
+ (a)[1]=(uint8_t)((x)>>8), (a)[0]=(uint8_t)(x)
+#define htole64a(a,x) (a)[7]=(uint8_t)((x)>>56), (a)[6]=(uint8_t)((x)>>48), \
+ (a)[5]=(uint8_t)((x)>>40), (a)[4]=(uint8_t)((x)>>32), \
+ (a)[3]=(uint8_t)((x)>>24), (a)[2]=(uint8_t)((x)>>16), \
+ (a)[1]=(uint8_t)((x)>>8), (a)[0]=(uint8_t)(x)
+
+#endif /*__BYTEORDER_H*/
Property changes on: src/gphoto2-endian.h
___________________________________________________________________
Added: svn:eol-style
+ LF
Index: src/libmtp.h
===================================================================
--- src/libmtp.h (revision 0)
+++ src/libmtp.h (revision 0)
@@ -0,0 +1,1026 @@
+/**
+ * \file libmtp.h
+ * Interface to the Media Transfer Protocol library.
+ *
+ * Copyright (C) 2005-2012 Linus Walleij <triad@df.lth.se>
+ * Copyright (C) 2005-2008 Richard A. Low <richard@wentnet.com>
+ * Copyright (C) 2007 Ted Bullock <tbullock@canada.com>
+ * Copyright (C) 2008 Florent Mertens <flomertens@gmail.com>
+ *
+ * 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 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., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ *
+ * <code>
+ * #include <libmtp.h>
+ * </code>
+ */
+#ifndef LIBMTP_H_INCLUSION_GUARD
+#define LIBMTP_H_INCLUSION_GUARD
+
+#define LIBMTP_VERSION 1.1.5
+#define LIBMTP_VERSION_STRING "1.1.5"
+
+/* This handles MSVC pecularities */
+#ifdef _MSC_VER
+#include <windows.h>
+#define __WIN32__
+#define snprintf _snprintf
+#define ssize_t SSIZE_T
+/*
+ * Types that do not exist in Windows
+ * sys/types.h, but they exist in mingw32
+ * sys/types.h.
+ */
+typedef char int8_t;
+typedef unsigned char uint8_t;
+typedef __int16 int16_t;
+typedef unsigned __int16 uint16_t;
+typedef __int32 int32_t;
+typedef unsigned __int32 uint32_t;
+typedef unsigned __int64 uint64_t;
+#endif
+
+#include <stdio.h>
+#include <stdint.h>
+/* We use time_t */
+#include <time.h>
+
+/**
+ * @defgroup types libmtp global type definitions
+ * @{
+ */
+
+/**
+ * The debug flags defined here are the external flags used
+ * by the libmtp library interface.
+ *
+ * Please keep this list in sync with libmtp.c.
+ */
+#define LIBMTP_DEBUG_NONE 0x00
+#define LIBMTP_DEBUG_PTP 0x01
+#define LIBMTP_DEBUG_PLST 0x02
+#define LIBMTP_DEBUG_USB 0x04
+#define LIBMTP_DEBUG_DATA 0x08
+#define LIBMTP_DEBUG_ALL 0xFF
+
+
+/**
+ * The filetypes defined here are the external types used
+ * by the libmtp library interface. The types used internally
+ * as PTP-defined enumerator types is something different.
+ */
+typedef enum {
+ LIBMTP_FILETYPE_FOLDER,
+ LIBMTP_FILETYPE_WAV,
+ LIBMTP_FILETYPE_MP3,
+ LIBMTP_FILETYPE_WMA,
+ LIBMTP_FILETYPE_OGG,
+ LIBMTP_FILETYPE_AUDIBLE,
+ LIBMTP_FILETYPE_MP4,
+ LIBMTP_FILETYPE_UNDEF_AUDIO,
+ LIBMTP_FILETYPE_WMV,
+ LIBMTP_FILETYPE_AVI,
+ LIBMTP_FILETYPE_MPEG,
+ LIBMTP_FILETYPE_ASF,
+ LIBMTP_FILETYPE_QT,
+ LIBMTP_FILETYPE_UNDEF_VIDEO,
+ LIBMTP_FILETYPE_JPEG,
+ LIBMTP_FILETYPE_JFIF,
+ LIBMTP_FILETYPE_TIFF,
+ LIBMTP_FILETYPE_BMP,
+ LIBMTP_FILETYPE_GIF,
+ LIBMTP_FILETYPE_PICT,
+ LIBMTP_FILETYPE_PNG,
+ LIBMTP_FILETYPE_VCALENDAR1,
+ LIBMTP_FILETYPE_VCALENDAR2,
+ LIBMTP_FILETYPE_VCARD2,
+ LIBMTP_FILETYPE_VCARD3,
+ LIBMTP_FILETYPE_WINDOWSIMAGEFORMAT,
+ LIBMTP_FILETYPE_WINEXEC,
+ LIBMTP_FILETYPE_TEXT,
+ LIBMTP_FILETYPE_HTML,
+ LIBMTP_FILETYPE_FIRMWARE,
+ LIBMTP_FILETYPE_AAC,
+ LIBMTP_FILETYPE_MEDIACARD,
+ LIBMTP_FILETYPE_FLAC,
+ LIBMTP_FILETYPE_MP2,
+ LIBMTP_FILETYPE_M4A,
+ LIBMTP_FILETYPE_DOC,
+ LIBMTP_FILETYPE_XML,
+ LIBMTP_FILETYPE_XLS,
+ LIBMTP_FILETYPE_PPT,
+ LIBMTP_FILETYPE_MHT,
+ LIBMTP_FILETYPE_JP2,
+ LIBMTP_FILETYPE_JPX,
+ LIBMTP_FILETYPE_ALBUM,
+ LIBMTP_FILETYPE_PLAYLIST,
+ LIBMTP_FILETYPE_UNKNOWN
+} LIBMTP_filetype_t;
+
+/**
+ * \def LIBMTP_FILETYPE_IS_AUDIO
+ * Audio filetype test.
+ *
+ * For filetypes that can be either audio
+ * or video, use LIBMTP_FILETYPE_IS_AUDIOVIDEO
+ */
+#define LIBMTP_FILETYPE_IS_AUDIO(a)\
+(a == LIBMTP_FILETYPE_WAV ||\
+ a == LIBMTP_FILETYPE_MP3 ||\
+ a == LIBMTP_FILETYPE_MP2 ||\
+ a == LIBMTP_FILETYPE_WMA ||\
+ a == LIBMTP_FILETYPE_OGG ||\
+ a == LIBMTP_FILETYPE_FLAC ||\
+ a == LIBMTP_FILETYPE_AAC ||\
+ a == LIBMTP_FILETYPE_M4A ||\
+ a == LIBMTP_FILETYPE_AUDIBLE ||\
+ a == LIBMTP_FILETYPE_UNDEF_AUDIO)
+
+/**
+ * \def LIBMTP_FILETYPE_IS_VIDEO
+ * Video filetype test.
+ *
+ * For filetypes that can be either audio
+ * or video, use LIBMTP_FILETYPE_IS_AUDIOVIDEO
+ */
+#define LIBMTP_FILETYPE_IS_VIDEO(a)\
+(a == LIBMTP_FILETYPE_WMV ||\
+ a == LIBMTP_FILETYPE_AVI ||\
+ a == LIBMTP_FILETYPE_MPEG ||\
+ a == LIBMTP_FILETYPE_UNDEF_VIDEO)
+
+/**
+ * \def LIBMTP_FILETYPE_IS_AUDIOVIDEO
+ * Audio and&slash;or video filetype test.
+ */
+#define LIBMTP_FILETYPE_IS_AUDIOVIDEO(a)\
+(a == LIBMTP_FILETYPE_MP4 ||\
+ a == LIBMTP_FILETYPE_ASF ||\
+ a == LIBMTP_FILETYPE_QT)
+
+/**
+ * \def LIBMTP_FILETYPE_IS_TRACK
+ * Test if filetype is a track.
+ * Use this to determine if the File API or Track API
+ * should be used to upload or download an object.
+ */
+#define LIBMTP_FILETYPE_IS_TRACK(a)\
+(LIBMTP_FILETYPE_IS_AUDIO(a) ||\
+ LIBMTP_FILETYPE_IS_VIDEO(a) ||\
+ LIBMTP_FILETYPE_IS_AUDIOVIDEO(a))
+
+/**
+ * \def LIBMTP_FILETYPE_IS_IMAGE
+ * Image filetype test
+ */
+#define LIBMTP_FILETYPE_IS_IMAGE(a)\
+(a == LIBMTP_FILETYPE_JPEG ||\
+a == LIBMTP_FILETYPE_JFIF ||\
+a == LIBMTP_FILETYPE_TIFF ||\
+a == LIBMTP_FILETYPE_BMP ||\
+a == LIBMTP_FILETYPE_GIF ||\
+a == LIBMTP_FILETYPE_PICT ||\
+a == LIBMTP_FILETYPE_PNG ||\
+a == LIBMTP_FILETYPE_JP2 ||\
+a == LIBMTP_FILETYPE_JPX ||\
+a == LIBMTP_FILETYPE_WINDOWSIMAGEFORMAT)
+
+/**
+ * \def LIBMTP_FILETYPE_IS_ADDRESSBOOK
+ * Addressbook and Business card filetype test
+ */
+#define LIBMTP_FILETYPE_IS_ADDRESSBOOK(a)\
+(a == LIBMTP_FILETYPE_VCARD2 ||\
+a == LIBMTP_FILETYPE_VCARD3)
+
+/**
+ * \def LIBMTP_FILETYPE_IS_CALENDAR
+ * Calendar and Appointment filetype test
+ */
+#define LIBMTP_FILETYPE_IS_CALENDAR(a)\
+(a == LIBMTP_FILETYPE_VCALENDAR1 ||\
+a == LIBMTP_FILETYPE_VCALENDAR2)
+
+/**
+ * The properties defined here are the external types used
+ * by the libmtp library interface.
+ */
+typedef enum {
+ LIBMTP_PROPERTY_StorageID,
+ LIBMTP_PROPERTY_ObjectFormat,
+ LIBMTP_PROPERTY_ProtectionStatus,
+ LIBMTP_PROPERTY_ObjectSize,
+ LIBMTP_PROPERTY_AssociationType,
+ LIBMTP_PROPERTY_AssociationDesc,
+ LIBMTP_PROPERTY_ObjectFileName,
+ LIBMTP_PROPERTY_DateCreated,
+ LIBMTP_PROPERTY_DateModified,
+ LIBMTP_PROPERTY_Keywords,
+ LIBMTP_PROPERTY_ParentObject,
+ LIBMTP_PROPERTY_AllowedFolderContents,
+ LIBMTP_PROPERTY_Hidden,
+ LIBMTP_PROPERTY_SystemObject,
+ LIBMTP_PROPERTY_PersistantUniqueObjectIdentifier,
+ LIBMTP_PROPERTY_SyncID,
+ LIBMTP_PROPERTY_PropertyBag,
+ LIBMTP_PROPERTY_Name,
+ LIBMTP_PROPERTY_CreatedBy,
+ LIBMTP_PROPERTY_Artist,
+ LIBMTP_PROPERTY_DateAuthored,
+ LIBMTP_PROPERTY_Description,
+ LIBMTP_PROPERTY_URLReference,
+ LIBMTP_PROPERTY_LanguageLocale,
+ LIBMTP_PROPERTY_CopyrightInformation,
+ LIBMTP_PROPERTY_Source,
+ LIBMTP_PROPERTY_OriginLocation,
+ LIBMTP_PROPERTY_DateAdded,
+ LIBMTP_PROPERTY_NonConsumable,
+ LIBMTP_PROPERTY_CorruptOrUnplayable,
+ LIBMTP_PROPERTY_ProducerSerialNumber,
+ LIBMTP_PROPERTY_RepresentativeSampleFormat,
+ LIBMTP_PROPERTY_RepresentativeSampleSize,
+ LIBMTP_PROPERTY_RepresentativeSampleHeight,
+ LIBMTP_PROPERTY_RepresentativeSampleWidth,
+ LIBMTP_PROPERTY_RepresentativeSampleDuration,
+ LIBMTP_PROPERTY_RepresentativeSampleData,
+ LIBMTP_PROPERTY_Width,
+ LIBMTP_PROPERTY_Height,
+ LIBMTP_PROPERTY_Duration,
+ LIBMTP_PROPERTY_Rating,
+ LIBMTP_PROPERTY_Track,
+ LIBMTP_PROPERTY_Genre,
+ LIBMTP_PROPERTY_Credits,
+ LIBMTP_PROPERTY_Lyrics,
+ LIBMTP_PROPERTY_SubscriptionContentID,
+ LIBMTP_PROPERTY_ProducedBy,
+ LIBMTP_PROPERTY_UseCount,
+ LIBMTP_PROPERTY_SkipCount,
+ LIBMTP_PROPERTY_LastAccessed,
+ LIBMTP_PROPERTY_ParentalRating,
+ LIBMTP_PROPERTY_MetaGenre,
+ LIBMTP_PROPERTY_Composer,
+ LIBMTP_PROPERTY_EffectiveRating,
+ LIBMTP_PROPERTY_Subtitle,
+ LIBMTP_PROPERTY_OriginalReleaseDate,
+ LIBMTP_PROPERTY_AlbumName,
+ LIBMTP_PROPERTY_AlbumArtist,
+ LIBMTP_PROPERTY_Mood,
+ LIBMTP_PROPERTY_DRMStatus,
+ LIBMTP_PROPERTY_SubDescription,
+ LIBMTP_PROPERTY_IsCropped,
+ LIBMTP_PROPERTY_IsColorCorrected,
+ LIBMTP_PROPERTY_ImageBitDepth,
+ LIBMTP_PROPERTY_Fnumber,
+ LIBMTP_PROPERTY_ExposureTime,
+ LIBMTP_PROPERTY_ExposureIndex,
+ LIBMTP_PROPERTY_DisplayName,
+ LIBMTP_PROPERTY_BodyText,
+ LIBMTP_PROPERTY_Subject,
+ LIBMTP_PROPERTY_Priority,
+ LIBMTP_PROPERTY_GivenName,
+ LIBMTP_PROPERTY_MiddleNames,
+ LIBMTP_PROPERTY_FamilyName,
+ LIBMTP_PROPERTY_Prefix,
+ LIBMTP_PROPERTY_Suffix,
+ LIBMTP_PROPERTY_PhoneticGivenName,
+ LIBMTP_PROPERTY_PhoneticFamilyName,
+ LIBMTP_PROPERTY_EmailPrimary,
+ LIBMTP_PROPERTY_EmailPersonal1,
+ LIBMTP_PROPERTY_EmailPersonal2,
+ LIBMTP_PROPERTY_EmailBusiness1,
+ LIBMTP_PROPERTY_EmailBusiness2,
+ LIBMTP_PROPERTY_EmailOthers,
+ LIBMTP_PROPERTY_PhoneNumberPrimary,
+ LIBMTP_PROPERTY_PhoneNumberPersonal,
+ LIBMTP_PROPERTY_PhoneNumberPersonal2,
+ LIBMTP_PROPERTY_PhoneNumberBusiness,
+ LIBMTP_PROPERTY_PhoneNumberBusiness2,
+ LIBMTP_PROPERTY_PhoneNumberMobile,
+ LIBMTP_PROPERTY_PhoneNumberMobile2,
+ LIBMTP_PROPERTY_FaxNumberPrimary,
+ LIBMTP_PROPERTY_FaxNumberPersonal,
+ LIBMTP_PROPERTY_FaxNumberBusiness,
+ LIBMTP_PROPERTY_PagerNumber,
+ LIBMTP_PROPERTY_PhoneNumberOthers,
+ LIBMTP_PROPERTY_PrimaryWebAddress,
+ LIBMTP_PROPERTY_PersonalWebAddress,
+ LIBMTP_PROPERTY_BusinessWebAddress,
+ LIBMTP_PROPERTY_InstantMessengerAddress,
+ LIBMTP_PROPERTY_InstantMessengerAddress2,
+ LIBMTP_PROPERTY_InstantMessengerAddress3,
+ LIBMTP_PROPERTY_PostalAddressPersonalFull,
+ LIBMTP_PROPERTY_PostalAddressPersonalFullLine1,
+ LIBMTP_PROPERTY_PostalAddressPersonalFullLine2,
+ LIBMTP_PROPERTY_PostalAddressPersonalFullCity,
+ LIBMTP_PROPERTY_PostalAddressPersonalFullRegion,
+ LIBMTP_PROPERTY_PostalAddressPersonalFullPostalCode,
+ LIBMTP_PROPERTY_PostalAddressPersonalFullCountry,
+ LIBMTP_PROPERTY_PostalAddressBusinessFull,
+ LIBMTP_PROPERTY_PostalAddressBusinessLine1,
+ LIBMTP_PROPERTY_PostalAddressBusinessLine2,
+ LIBMTP_PROPERTY_PostalAddressBusinessCity,
+ LIBMTP_PROPERTY_PostalAddressBusinessRegion,
+ LIBMTP_PROPERTY_PostalAddressBusinessPostalCode,
+ LIBMTP_PROPERTY_PostalAddressBusinessCountry,
+ LIBMTP_PROPERTY_PostalAddressOtherFull,
+ LIBMTP_PROPERTY_PostalAddressOtherLine1,
+ LIBMTP_PROPERTY_PostalAddressOtherLine2,
+ LIBMTP_PROPERTY_PostalAddressOtherCity,
+ LIBMTP_PROPERTY_PostalAddressOtherRegion,
+ LIBMTP_PROPERTY_PostalAddressOtherPostalCode,
+ LIBMTP_PROPERTY_PostalAddressOtherCountry,
+ LIBMTP_PROPERTY_OrganizationName,
+ LIBMTP_PROPERTY_PhoneticOrganizationName,
+ LIBMTP_PROPERTY_Role,
+ LIBMTP_PROPERTY_Birthdate,
+ LIBMTP_PROPERTY_MessageTo,
+ LIBMTP_PROPERTY_MessageCC,
+ LIBMTP_PROPERTY_MessageBCC,
+ LIBMTP_PROPERTY_MessageRead,
+ LIBMTP_PROPERTY_MessageReceivedTime,
+ LIBMTP_PROPERTY_MessageSender,
+ LIBMTP_PROPERTY_ActivityBeginTime,
+ LIBMTP_PROPERTY_ActivityEndTime,
+ LIBMTP_PROPERTY_ActivityLocation,
+ LIBMTP_PROPERTY_ActivityRequiredAttendees,
+ LIBMTP_PROPERTY_ActivityOptionalAttendees,
+ LIBMTP_PROPERTY_ActivityResources,
+ LIBMTP_PROPERTY_ActivityAccepted,
+ LIBMTP_PROPERTY_Owner,
+ LIBMTP_PROPERTY_Editor,
+ LIBMTP_PROPERTY_Webmaster,
+ LIBMTP_PROPERTY_URLSource,
+ LIBMTP_PROPERTY_URLDestination,
+ LIBMTP_PROPERTY_TimeBookmark,
+ LIBMTP_PROPERTY_ObjectBookmark,
+ LIBMTP_PROPERTY_ByteBookmark,
+ LIBMTP_PROPERTY_LastBuildDate,
+ LIBMTP_PROPERTY_TimetoLive,
+ LIBMTP_PROPERTY_MediaGUID,
+ LIBMTP_PROPERTY_TotalBitRate,
+ LIBMTP_PROPERTY_BitRateType,
+ LIBMTP_PROPERTY_SampleRate,
+ LIBMTP_PROPERTY_NumberOfChannels,
+ LIBMTP_PROPERTY_AudioBitDepth,
+ LIBMTP_PROPERTY_ScanDepth,
+ LIBMTP_PROPERTY_AudioWAVECodec,
+ LIBMTP_PROPERTY_AudioBitRate,
+ LIBMTP_PROPERTY_VideoFourCCCodec,
+ LIBMTP_PROPERTY_VideoBitRate,
+ LIBMTP_PROPERTY_FramesPerThousandSeconds,
+ LIBMTP_PROPERTY_KeyFrameDistance,
+ LIBMTP_PROPERTY_BufferSize,
+ LIBMTP_PROPERTY_EncodingQuality,
+ LIBMTP_PROPERTY_EncodingProfile,
+ LIBMTP_PROPERTY_BuyFlag,
+ LIBMTP_PROPERTY_UNKNOWN
+} LIBMTP_property_t;
+
+/**
+ * These are the data types
+ */
+typedef enum {
+ LIBMTP_DATATYPE_INT8,
+ LIBMTP_DATATYPE_UINT8,
+ LIBMTP_DATATYPE_INT16,
+ LIBMTP_DATATYPE_UINT16,
+ LIBMTP_DATATYPE_INT32,
+ LIBMTP_DATATYPE_UINT32,
+ LIBMTP_DATATYPE_INT64,
+ LIBMTP_DATATYPE_UINT64,
+} LIBMTP_datatype_t;
+
+/**
+ * These are the numbered error codes. You can also
+ * get string representations for errors.
+ */
+typedef enum {
+ LIBMTP_ERROR_NONE,
+ LIBMTP_ERROR_GENERAL,
+ LIBMTP_ERROR_PTP_LAYER,
+ LIBMTP_ERROR_USB_LAYER,
+ LIBMTP_ERROR_MEMORY_ALLOCATION,
+ LIBMTP_ERROR_NO_DEVICE_ATTACHED,
+ LIBMTP_ERROR_STORAGE_FULL,
+ LIBMTP_ERROR_CONNECTING,
+ LIBMTP_ERROR_CANCELLED
+} LIBMTP_error_number_t;
+
+typedef struct LIBMTP_device_entry_struct LIBMTP_device_entry_t; /**< @see LIBMTP_device_entry_struct */
+typedef struct LIBMTP_raw_device_struct LIBMTP_raw_device_t; /**< @see LIBMTP_raw_device_struct */
+typedef struct LIBMTP_error_struct LIBMTP_error_t; /**< @see LIBMTP_error_struct */
+typedef struct LIBMTP_allowed_values_struct LIBMTP_allowed_values_t; /**< @see LIBMTP_allowed_values_struct */
+typedef struct LIBMTP_device_extension_struct LIBMTP_device_extension_t; /** < @see LIBMTP_device_extension_struct */
+typedef struct LIBMTP_mtpdevice_struct LIBMTP_mtpdevice_t; /**< @see LIBMTP_mtpdevice_struct */
+typedef struct LIBMTP_file_struct LIBMTP_file_t; /**< @see LIBMTP_file_struct */
+typedef struct LIBMTP_track_struct LIBMTP_track_t; /**< @see LIBMTP_track_struct */
+typedef struct LIBMTP_playlist_struct LIBMTP_playlist_t; /**< @see LIBMTP_playlist_struct */
+typedef struct LIBMTP_album_struct LIBMTP_album_t; /**< @see LIBMTP_album_struct */
+typedef struct LIBMTP_folder_struct LIBMTP_folder_t; /**< @see LIBMTP_folder_t */
+typedef struct LIBMTP_object_struct LIBMTP_object_t; /**< @see LIBMTP_object_t */
+typedef struct LIBMTP_filesampledata_struct LIBMTP_filesampledata_t; /**< @see LIBMTP_filesample_t */
+typedef struct LIBMTP_devicestorage_struct LIBMTP_devicestorage_t; /**< @see LIBMTP_devicestorage_t */
+
+/**
+ * The callback type definition. Notice that a progress percentage ratio
+ * is easy to calculate by dividing <code>sent</code> by
+ * <code>total</code>.
+ * @param sent the number of bytes sent so far
+ * @param total the total number of bytes to send
+ * @param data a user-defined dereferencable pointer
+ * @return if anything else than 0 is returned, the current transfer will be
+ * interrupted / cancelled.
+ */
+typedef int (* LIBMTP_progressfunc_t) (uint64_t const sent, uint64_t const total,
+ void const * const data);
+
+/**
+ * Callback function for get by handler function
+ * @param params the device parameters
+ * @param priv a user-defined dereferencable pointer
+ * @param wantlen the number of bytes wanted
+ * @param data a buffer to write the data to
+ * @param gotlen pointer to the number of bytes actually written
+ * to data
+ * @return LIBMTP_HANDLER_RETURN_OK if successful,
+ * LIBMTP_HANDLER_RETURN_ERROR on error or
+ * LIBMTP_HANDLER_RETURN_CANCEL to cancel the transfer
+ */
+typedef uint16_t (* MTPDataGetFunc) (void* params, void* priv,
+ uint32_t wantlen, unsigned char *data, uint32_t *gotlen);
+
+/**
+ * Callback function for put by handler function
+ * @param params the device parameters
+ * @param priv a user-defined dereferencable pointer
+ * @param sendlen the number of bytes available
+ * @param data a buffer to read the data from
+ * @param putlen pointer to the number of bytes actually read
+ * from data
+ * @return LIBMTP_HANDLER_RETURN_OK if successful,
+ * LIBMTP_HANDLER_RETURN_ERROR on error or
+ * LIBMTP_HANDLER_RETURN_CANCEL to cancel the transfer
+ */
+typedef uint16_t (* MTPDataPutFunc) (void* params, void* priv,
+ uint32_t sendlen, unsigned char *data, uint32_t *putlen);
+
+/**
+ * The return codes for the get/put functions
+ */
+#define LIBMTP_HANDLER_RETURN_OK 0
+#define LIBMTP_HANDLER_RETURN_ERROR 1
+#define LIBMTP_HANDLER_RETURN_CANCEL 2
+
+/**
+ * @}
+ * @defgroup structar libmtp data structures
+ * @{
+ */
+
+/**
+ * A data structure to hold MTP device entries.
+ */
+struct LIBMTP_device_entry_struct {
+ char *vendor; /**< The vendor of this device */
+ uint16_t vendor_id; /**< Vendor ID for this device */
+ char *product; /**< The product name of this device */
+ uint16_t product_id; /**< Product ID for this device */
+ uint32_t device_flags; /**< Bugs, device specifics etc */
+};
+
+/**
+ * A data structure to hold a raw MTP device connected
+ * to the bus.
+ */
+struct LIBMTP_raw_device_struct {
+ LIBMTP_device_entry_t device_entry; /**< The device entry for this raw device */
+ uint32_t bus_location; /**< Location of the bus, if device available */
+ uint8_t devnum; /**< Device number on the bus, if device available */
+};
+
+/**
+ * A data structure to hold errors from the library.
+ */
+struct LIBMTP_error_struct {
+ LIBMTP_error_number_t errornumber;
+ char *error_text;
+ LIBMTP_error_t *next;
+};
+
+/**
+ * A data structure to hold allowed ranges of values
+ */
+struct LIBMTP_allowed_values_struct {
+ uint8_t u8max;
+ uint8_t u8min;
+ uint8_t u8step;
+ uint8_t* u8vals;
+ int8_t i8max;
+ int8_t i8min;
+ int8_t i8step;
+ int8_t* i8vals;
+ uint16_t u16max;
+ uint16_t u16min;
+ uint16_t u16step;
+ uint16_t* u16vals;
+ int16_t i16max;
+ int16_t i16min;
+ int16_t i16step;
+ int16_t* i16vals;
+ uint32_t u32max;
+ uint32_t u32min;
+ uint32_t u32step;
+ uint32_t* u32vals;
+ int32_t i32max;
+ int32_t i32min;
+ int32_t i32step;
+ int32_t* i32vals;
+ uint64_t u64max;
+ uint64_t u64min;
+ uint64_t u64step;
+ uint64_t* u64vals;
+ int64_t i64max;
+ int64_t i64min;
+ int64_t i64step;
+ int64_t* i64vals;
+ /**
+ * Number of entries in the vals array
+ */
+ uint16_t num_entries;
+ /**
+ * The datatype specifying which of the above is used
+ */
+ LIBMTP_datatype_t datatype;
+ /**
+ * Non zero for range, 0 for enum
+ */
+ int is_range;
+};
+
+/**
+ * MTP device extension holder struct
+ */
+struct LIBMTP_device_extension_struct {
+ /**
+ * Name of extension e.g. "foo.com"
+ */
+ char *name;
+ /**
+ * Major revision of extension
+ */
+ int major;
+ /**
+ * Minor revision of extension
+ */
+ int minor;
+ /**
+ * Pointer to the next extension or NULL if this is the
+ * last extension.
+ */
+ LIBMTP_device_extension_t *next;
+};
+
+/**
+ * Main MTP device object struct
+ */
+struct LIBMTP_mtpdevice_struct {
+ /**
+ * Object bitsize, typically 32 or 64.
+ */
+ uint8_t object_bitsize;
+ /**
+ * Parameters for this device, must be cast into
+ * \c (PTPParams*) before internal use.
+ */
+ void *params;
+ /**
+ * USB device for this device, must be cast into
+ * \c (PTP_USB*) before internal use.
+ */
+ void *usbinfo;
+ /**
+ * The storage for this device, do not use strings in here without
+ * copying them first, and beware that this list may be rebuilt at
+ * any time.
+ * @see LIBMTP_Get_Storage()
+ */
+ LIBMTP_devicestorage_t *storage;
+ /**
+ * The error stack. This shall be handled using the error getting
+ * and clearing functions, not by dereferencing this list.
+ */
+ LIBMTP_error_t *errorstack;
+ /** The maximum battery level for this device */
+ uint8_t maximum_battery_level;
+ /** Default music folder */
+ uint32_t default_music_folder;
+ /** Default playlist folder */
+ uint32_t default_playlist_folder;
+ /** Default picture folder */
+ uint32_t default_picture_folder;
+ /** Default video folder */
+ uint32_t default_video_folder;
+ /** Default organizer folder */
+ uint32_t default_organizer_folder;
+ /** Default ZENcast folder (only Creative devices...) */
+ uint32_t default_zencast_folder;
+ /** Default Album folder */
+ uint32_t default_album_folder;
+ /** Default Text folder */
+ uint32_t default_text_folder;
+ /** Per device iconv() converters, only used internally */
+ void *cd;
+ /** Extension list */
+ LIBMTP_device_extension_t *extensions;
+ /** Whether the device uses caching, only used internally */
+ int cached;
+
+ /** Pointer to next device in linked list; NULL if this is the last device */
+ LIBMTP_mtpdevice_t *next;
+};
+
+/**
+ * MTP file struct
+ */
+struct LIBMTP_file_struct {
+ uint32_t item_id; /**< Unique item ID */
+ uint32_t parent_id; /**< ID of parent folder */
+ uint32_t storage_id; /**< ID of storage holding this file */
+ char *filename; /**< Filename of this file */
+ uint64_t filesize; /**< Size of file in bytes */
+ time_t modificationdate; /**< Date of last alteration of the file */
+ LIBMTP_filetype_t filetype; /**< Filetype used for the current file */
+ LIBMTP_file_t *next; /**< Next file in list or NULL if last file */
+};
+
+/**
+ * MTP track struct
+ */
+struct LIBMTP_track_struct {
+ uint32_t item_id; /**< Unique item ID */
+ uint32_t parent_id; /**< ID of parent folder */
+ uint32_t storage_id; /**< ID of storage holding this track */
+ char *title; /**< Track title */
+ char *artist; /**< Name of recording artist */
+ char *composer; /**< Name of recording composer */
+ char *genre; /**< Genre name for track */
+ char *album; /**< Album name for track */
+ char *date; /**< Date of original recording as a string */
+ char *filename; /**< Original filename of this track */
+ uint16_t tracknumber; /**< Track number (in sequence on recording) */
+ uint32_t duration; /**< Duration in milliseconds */
+ uint32_t samplerate; /**< Sample rate of original file, min 0x1f80 max 0xbb80 */
+ uint16_t nochannels; /**< Number of channels in this recording 0 = unknown, 1 or 2 */
+ uint32_t wavecodec; /**< FourCC wave codec name */
+ uint32_t bitrate; /**< (Average) bitrate for this file min=1 max=0x16e360 */
+ uint16_t bitratetype; /**< 0 = unused, 1 = constant, 2 = VBR, 3 = free */
+ uint16_t rating; /**< User rating 0-100 (0x00-0x64) */
+ uint32_t usecount; /**< Number of times used/played */
+ uint64_t filesize; /**< Size of track file in bytes */
+ time_t modificationdate; /**< Date of last alteration of the track */
+ LIBMTP_filetype_t filetype; /**< Filetype used for the current track */
+ LIBMTP_track_t *next; /**< Next track in list or NULL if last track */
+};
+
+/**
+ * MTP Playlist structure
+ */
+struct LIBMTP_playlist_struct {
+ uint32_t playlist_id; /**< Unique playlist ID */
+ uint32_t parent_id; /**< ID of parent folder */
+ uint32_t storage_id; /**< ID of storage holding this playlist */
+ char *name; /**< Name of playlist */
+ uint32_t *tracks; /**< The tracks in this playlist */
+ uint32_t no_tracks; /**< The number of tracks in this playlist */
+ LIBMTP_playlist_t *next; /**< Next playlist or NULL if last playlist */
+};
+
+/**
+ * MTP Album structure
+ */
+struct LIBMTP_album_struct {
+ uint32_t album_id; /**< Unique playlist ID */
+ uint32_t parent_id; /**< ID of parent folder */
+ uint32_t storage_id; /**< ID of storage holding this album */
+ char *name; /**< Name of album */
+ char *artist; /**< Name of album artist */
+ char *composer; /**< Name of recording composer */
+ char *genre; /**< Genre of album */
+ uint32_t *tracks; /**< The tracks in this album */
+ uint32_t no_tracks; /**< The number of tracks in this album */
+ LIBMTP_album_t *next; /**< Next album or NULL if last album */
+};
+
+/**
+ * MTP Folder structure
+ */
+struct LIBMTP_folder_struct {
+ uint32_t folder_id; /**< Unique folder ID */
+ uint32_t parent_id; /**< ID of parent folder */
+ uint32_t storage_id; /**< ID of storage holding this folder */
+ char *name; /**< Name of folder */
+ LIBMTP_folder_t *sibling; /**< Next folder at same level or NULL if no more */
+ LIBMTP_folder_t *child; /**< Child folder or NULL if no children */
+};
+
+/**
+ * LIBMTP Object RepresentativeSampleData Structure
+ */
+struct LIBMTP_filesampledata_struct {
+ uint32_t width; /**< Width of sample if it is an image */
+ uint32_t height; /**< Height of sample if it is an image */
+ uint32_t duration; /**< Duration in milliseconds if it is audio */
+ LIBMTP_filetype_t filetype; /**< Filetype used for the sample */
+ uint64_t size; /**< Size of sample data in bytes */
+ char *data; /**< Sample data */
+};
+
+/**
+ * LIBMTP Device Storage structure
+ */
+struct LIBMTP_devicestorage_struct {
+ uint32_t id; /**< Unique ID for this storage */
+ uint16_t StorageType; /**< Storage type */
+ uint16_t FilesystemType; /**< Filesystem type */
+ uint16_t AccessCapability; /**< Access capability */
+ uint64_t MaxCapacity; /**< Maximum capability */
+ uint64_t FreeSpaceInBytes; /**< Free space in bytes */
+ uint64_t FreeSpaceInObjects; /**< Free space in objects */
+ char *StorageDescription; /**< A brief description of this storage */
+ char *VolumeIdentifier; /**< A volume identifier */
+ LIBMTP_devicestorage_t *next; /**< Next storage, follow this link until NULL */
+ LIBMTP_devicestorage_t *prev; /**< Previous storage */
+};
+
+/**
+ * LIBMTP Event structure
+ * TODO: add all externally visible events here
+ */
+enum LIBMTP_event_enum {
+ LIBMTP_EVENT_NONE,
+ LIBMTP_EVENT_STORE_ADDED,
+};
+typedef enum LIBMTP_event_enum LIBMTP_event_t;
+
+/** @} */
+
+/* Make functions available for C++ */
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern int LIBMTP_debug;
+
+/**
+ * @defgroup internals The libmtp internals API.
+ * @{
+ */
+void LIBMTP_Set_Debug(int);
+void LIBMTP_Init(void);
+int LIBMTP_Get_Supported_Devices_List(LIBMTP_device_entry_t ** const, int * const);
+/**
+ * @}
+ * @defgroup basic The basic device management API.
+ * @{
+ */
+LIBMTP_error_number_t LIBMTP_Detect_Raw_Devices(LIBMTP_raw_device_t **, int *);
+int LIBMTP_Check_Specific_Device(int busno, int devno);
+LIBMTP_mtpdevice_t *LIBMTP_Open_Raw_Device(LIBMTP_raw_device_t *);
+LIBMTP_mtpdevice_t *LIBMTP_Open_Raw_Device_Uncached(LIBMTP_raw_device_t *);
+/* Begin old, legacy interface */
+LIBMTP_mtpdevice_t *LIBMTP_Get_First_Device(void);
+LIBMTP_error_number_t LIBMTP_Get_Connected_Devices(LIBMTP_mtpdevice_t **);
+uint32_t LIBMTP_Number_Devices_In_List(LIBMTP_mtpdevice_t *);
+void LIBMTP_Release_Device_List(LIBMTP_mtpdevice_t*);
+/* End old, legacy interface */
+void LIBMTP_Release_Device(LIBMTP_mtpdevice_t*);
+void LIBMTP_Dump_Device_Info(LIBMTP_mtpdevice_t*);
+int LIBMTP_Reset_Device(LIBMTP_mtpdevice_t*);
+char *LIBMTP_Get_Manufacturername(LIBMTP_mtpdevice_t*);
+char *LIBMTP_Get_Modelname(LIBMTP_mtpdevice_t*);
+char *LIBMTP_Get_Serialnumber(LIBMTP_mtpdevice_t*);
+char *LIBMTP_Get_Deviceversion(LIBMTP_mtpdevice_t*);
+char *LIBMTP_Get_Friendlyname(LIBMTP_mtpdevice_t*);
+int LIBMTP_Set_Friendlyname(LIBMTP_mtpdevice_t*, char const * const);
+char *LIBMTP_Get_Syncpartner(LIBMTP_mtpdevice_t*);
+int LIBMTP_Set_Syncpartner(LIBMTP_mtpdevice_t*, char const * const);
+int LIBMTP_Get_Batterylevel(LIBMTP_mtpdevice_t *,
+ uint8_t * const,
+ uint8_t * const);
+int LIBMTP_Get_Secure_Time(LIBMTP_mtpdevice_t *, char ** const);
+int LIBMTP_Get_Device_Certificate(LIBMTP_mtpdevice_t *, char ** const);
+int LIBMTP_Get_Supported_Filetypes(LIBMTP_mtpdevice_t *, uint16_t ** const, uint16_t * const);
+LIBMTP_error_t *LIBMTP_Get_Errorstack(LIBMTP_mtpdevice_t*);
+void LIBMTP_Clear_Errorstack(LIBMTP_mtpdevice_t*);
+void LIBMTP_Dump_Errorstack(LIBMTP_mtpdevice_t*);
+
+#define LIBMTP_STORAGE_SORTBY_NOTSORTED 0
+#define LIBMTP_STORAGE_SORTBY_FREESPACE 1
+#define LIBMTP_STORAGE_SORTBY_MAXSPACE 2
+
+int LIBMTP_Get_Storage(LIBMTP_mtpdevice_t *, int const);
+int LIBMTP_Format_Storage(LIBMTP_mtpdevice_t *, LIBMTP_devicestorage_t *);
+
+/**
+ * Get/set arbitrary properties. These do not update the cache; should only be used on
+ * properties not stored in structs
+ */
+char *LIBMTP_Get_String_From_Object(LIBMTP_mtpdevice_t *, uint32_t const, LIBMTP_property_t const);
+uint64_t LIBMTP_Get_u64_From_Object(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, uint64_t const);
+uint32_t LIBMTP_Get_u32_From_Object(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, uint32_t const);
+uint16_t LIBMTP_Get_u16_From_Object(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, uint16_t const);
+uint8_t LIBMTP_Get_u8_From_Object(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, uint8_t const);
+int LIBMTP_Set_Object_String(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, char const * const);
+int LIBMTP_Set_Object_u32(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, uint32_t const);
+int LIBMTP_Set_Object_u16(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, uint16_t const);
+int LIBMTP_Set_Object_u8(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_property_t const, uint8_t const);
+char const * LIBMTP_Get_Property_Description(LIBMTP_property_t inproperty);
+int LIBMTP_Is_Property_Supported(LIBMTP_mtpdevice_t*, LIBMTP_property_t const,
+ LIBMTP_filetype_t const);
+int LIBMTP_Get_Allowed_Property_Values(LIBMTP_mtpdevice_t*, LIBMTP_property_t const,
+ LIBMTP_filetype_t const, LIBMTP_allowed_values_t*);
+void LIBMTP_destroy_allowed_values_t(LIBMTP_allowed_values_t*);
+
+/**
+ * @}
+ * @defgroup files The file management API.
+ * @{
+ */
+LIBMTP_file_t *LIBMTP_new_file_t(void);
+void LIBMTP_destroy_file_t(LIBMTP_file_t*);
+char const * LIBMTP_Get_Filetype_Description(LIBMTP_filetype_t);
+LIBMTP_file_t *LIBMTP_Get_Filelisting(LIBMTP_mtpdevice_t *);
+LIBMTP_file_t *LIBMTP_Get_Filelisting_With_Callback(LIBMTP_mtpdevice_t *,
+ LIBMTP_progressfunc_t const, void const * const);
+LIBMTP_file_t * LIBMTP_Get_Files_And_Folders(LIBMTP_mtpdevice_t *,
+ uint32_t const,
+ uint32_t const);
+LIBMTP_file_t *LIBMTP_Get_Filemetadata(LIBMTP_mtpdevice_t *, uint32_t const);
+int LIBMTP_Get_File_To_File(LIBMTP_mtpdevice_t*, uint32_t, char const * const,
+ LIBMTP_progressfunc_t const, void const * const);
+int LIBMTP_Get_File_To_File_Descriptor(LIBMTP_mtpdevice_t*,
+ uint32_t const,
+ int const,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Get_File_To_Handler(LIBMTP_mtpdevice_t *,
+ uint32_t const,
+ MTPDataPutFunc,
+ void *,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Send_File_From_File(LIBMTP_mtpdevice_t *,
+ char const * const,
+ LIBMTP_file_t * const,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Send_File_From_File_Descriptor(LIBMTP_mtpdevice_t *,
+ int const,
+ LIBMTP_file_t * const,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Send_File_From_Handler(LIBMTP_mtpdevice_t *,
+ MTPDataGetFunc, void *,
+ LIBMTP_file_t * const,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Set_File_Name(LIBMTP_mtpdevice_t *,
+ LIBMTP_file_t *,
+ const char *);
+LIBMTP_filesampledata_t *LIBMTP_new_filesampledata_t(void);
+void LIBMTP_destroy_filesampledata_t(LIBMTP_filesampledata_t *);
+int LIBMTP_Get_Representative_Sample_Format(LIBMTP_mtpdevice_t *,
+ LIBMTP_filetype_t const,
+ LIBMTP_filesampledata_t **);
+int LIBMTP_Send_Representative_Sample(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_filesampledata_t *);
+int LIBMTP_Get_Representative_Sample(LIBMTP_mtpdevice_t *, uint32_t const,
+ LIBMTP_filesampledata_t *);
+int LIBMTP_Get_Thumbnail(LIBMTP_mtpdevice_t *, uint32_t const,
+ unsigned char **data, unsigned int *size);
+
+/**
+ * @}
+ * @defgroup tracks The track management API.
+ * @{
+ */
+LIBMTP_track_t *LIBMTP_new_track_t(void);
+void LIBMTP_destroy_track_t(LIBMTP_track_t*);
+LIBMTP_track_t *LIBMTP_Get_Tracklisting(LIBMTP_mtpdevice_t*);
+LIBMTP_track_t *LIBMTP_Get_Tracklisting_With_Callback(LIBMTP_mtpdevice_t*,
+ LIBMTP_progressfunc_t const, void const * const);
+LIBMTP_track_t *LIBMTP_Get_Tracklisting_With_Callback_For_Storage(LIBMTP_mtpdevice_t*, uint32_t const,
+ LIBMTP_progressfunc_t const, void const * const);
+LIBMTP_track_t *LIBMTP_Get_Trackmetadata(LIBMTP_mtpdevice_t*, uint32_t const);
+int LIBMTP_Get_Track_To_File(LIBMTP_mtpdevice_t*, uint32_t, char const * const,
+ LIBMTP_progressfunc_t const, void const * const);
+int LIBMTP_Get_Track_To_File_Descriptor(LIBMTP_mtpdevice_t*, uint32_t const, int const,
+ LIBMTP_progressfunc_t const, void const * const);
+int LIBMTP_Get_Track_To_Handler(LIBMTP_mtpdevice_t *, uint32_t const, MTPDataPutFunc,
+ void *, LIBMTP_progressfunc_t const, void const * const);
+int LIBMTP_Send_Track_From_File(LIBMTP_mtpdevice_t *,
+ char const * const, LIBMTP_track_t * const,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Send_Track_From_File_Descriptor(LIBMTP_mtpdevice_t *,
+ int const, LIBMTP_track_t * const,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Send_Track_From_Handler(LIBMTP_mtpdevice_t *,
+ MTPDataGetFunc, void *, LIBMTP_track_t * const,
+ LIBMTP_progressfunc_t const,
+ void const * const);
+int LIBMTP_Update_Track_Metadata(LIBMTP_mtpdevice_t *,
+ LIBMTP_track_t const * const);
+int LIBMTP_Track_Exists(LIBMTP_mtpdevice_t *, uint32_t const);
+int LIBMTP_Set_Track_Name(LIBMTP_mtpdevice_t *, LIBMTP_track_t *, const char *);
+/** @} */
+
+/**
+ * @}
+ * @defgroup folders The folder management API.
+ * @{
+ */
+LIBMTP_folder_t *LIBMTP_new_folder_t(void);
+void LIBMTP_destroy_folder_t(LIBMTP_folder_t*);
+LIBMTP_folder_t *LIBMTP_Get_Folder_List(LIBMTP_mtpdevice_t*);
+LIBMTP_folder_t *LIBMTP_Get_Folder_List_For_Storage(LIBMTP_mtpdevice_t*,
+ uint32_t const);
+LIBMTP_folder_t *LIBMTP_Find_Folder(LIBMTP_folder_t*, uint32_t const);
+uint32_t LIBMTP_Create_Folder(LIBMTP_mtpdevice_t*, char *, uint32_t, uint32_t);
+int LIBMTP_Set_Folder_Name(LIBMTP_mtpdevice_t *, LIBMTP_folder_t *, const char *);
+/** @} */
+
+#if 0
+/**
+ * @}
+ * @defgroup playlists The audio/video playlist management API.
+ * @{
+ */
+LIBMTP_playlist_t *LIBMTP_new_playlist_t(void);
+void LIBMTP_destroy_playlist_t(LIBMTP_playlist_t *);
+LIBMTP_playlist_t *LIBMTP_Get_Playlist_List(LIBMTP_mtpdevice_t *);
+LIBMTP_playlist_t *LIBMTP_Get_Playlist(LIBMTP_mtpdevice_t *, uint32_t const);
+int LIBMTP_Create_New_Playlist(LIBMTP_mtpdevice_t *, LIBMTP_playlist_t * const);
+int LIBMTP_Update_Playlist(LIBMTP_mtpdevice_t *, LIBMTP_playlist_t * const);
+int LIBMTP_Set_Playlist_Name(LIBMTP_mtpdevice_t *, LIBMTP_playlist_t *, const char *);
+#endif
+
+/**
+ * @}
+ * @defgroup albums The audio/video album management API.
+ * @{
+ */
+LIBMTP_album_t *LIBMTP_new_album_t(void);
+void LIBMTP_destroy_album_t(LIBMTP_album_t *);
+LIBMTP_album_t *LIBMTP_Get_Album_List(LIBMTP_mtpdevice_t *);
+LIBMTP_album_t *LIBMTP_Get_Album_List_For_Storage(LIBMTP_mtpdevice_t *, uint32_t const);
+LIBMTP_album_t *LIBMTP_Get_Album(LIBMTP_mtpdevice_t *, uint32_t const);
+int LIBMTP_Create_New_Album(LIBMTP_mtpdevice_t *, LIBMTP_album_t * const);
+int LIBMTP_Update_Album(LIBMTP_mtpdevice_t *, LIBMTP_album_t const * const);
+int LIBMTP_Set_Album_Name(LIBMTP_mtpdevice_t *, LIBMTP_album_t *, const char *);
+
+/**
+ * @}
+ * @defgroup objects The object management API.
+ * @{
+ */
+int LIBMTP_Delete_Object(LIBMTP_mtpdevice_t *, uint32_t);
+int LIBMTP_Set_Object_Filename(LIBMTP_mtpdevice_t *, uint32_t , char *);
+
+/**
+ * @}
+ * @defgroup files The events API.
+ * @{
+ */
+int LIBMTP_Read_Event(LIBMTP_mtpdevice_t *, LIBMTP_event_t *, uint32_t *);
+
+
+/** @} */
+
+/* End of C++ exports */
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* LIBMTP_H_INCLUSION_GUARD */
Property changes on: src/libmtp.h
___________________________________________________________________
Added: svn:eol-style
+ LF
Index: src/_stdint.h
===================================================================
--- src/_stdint.h (revision 0)
+++ src/_stdint.h (revision 0)
@@ -0,0 +1,2 @@
+/* This file is generated automatically by configure */
+#include <stdint.h>
Property changes on: src/_stdint.h
___________________________________________________________________
Added: svn:eol-style
+ LF