2 * Media Transfer Protocol implementation, backed by host filesystem.
4 * Copyright Red Hat, Inc 2014
7 * Gerd Hoffmann <kraxel@redhat.com>
9 * This code is licensed under the GPL v2 or later.
12 #include "qemu/osdep.h"
13 #include "qemu-common.h"
14 #include "qapi/error.h"
15 #include "qemu/error-report.h"
19 #include <sys/statvfs.h>
23 #include "qemu/module.h"
24 #include "qemu/filemonitor.h"
26 #include "hw/qdev-properties.h"
28 #include "migration/vmstate.h"
30 #include "qemu/units.h"
31 #include "qom/object.h"
33 /* ----------------------------------------------------------------------- */
35 enum mtp_container_type
{
42 /* MTP write stage, for internal use only */
43 enum mtp_write_status
{
51 CMD_GET_DEVICE_INFO
= 0x1001,
52 CMD_OPEN_SESSION
= 0x1002,
53 CMD_CLOSE_SESSION
= 0x1003,
54 CMD_GET_STORAGE_IDS
= 0x1004,
55 CMD_GET_STORAGE_INFO
= 0x1005,
56 CMD_GET_NUM_OBJECTS
= 0x1006,
57 CMD_GET_OBJECT_HANDLES
= 0x1007,
58 CMD_GET_OBJECT_INFO
= 0x1008,
59 CMD_GET_OBJECT
= 0x1009,
60 CMD_DELETE_OBJECT
= 0x100b,
61 CMD_SEND_OBJECT_INFO
= 0x100c,
62 CMD_SEND_OBJECT
= 0x100d,
63 CMD_GET_PARTIAL_OBJECT
= 0x101b,
64 CMD_GET_OBJECT_PROPS_SUPPORTED
= 0x9801,
65 CMD_GET_OBJECT_PROP_DESC
= 0x9802,
66 CMD_GET_OBJECT_PROP_VALUE
= 0x9803,
70 RES_GENERAL_ERROR
= 0x2002,
71 RES_SESSION_NOT_OPEN
= 0x2003,
72 RES_INVALID_TRANSACTION_ID
= 0x2004,
73 RES_OPERATION_NOT_SUPPORTED
= 0x2005,
74 RES_PARAMETER_NOT_SUPPORTED
= 0x2006,
75 RES_INCOMPLETE_TRANSFER
= 0x2007,
76 RES_INVALID_STORAGE_ID
= 0x2008,
77 RES_INVALID_OBJECT_HANDLE
= 0x2009,
78 RES_INVALID_OBJECT_FORMAT_CODE
= 0x200b,
79 RES_STORE_FULL
= 0x200c,
80 RES_STORE_READ_ONLY
= 0x200e,
81 RES_PARTIAL_DELETE
= 0x2012,
82 RES_STORE_NOT_AVAILABLE
= 0x2013,
83 RES_SPEC_BY_FORMAT_UNSUPPORTED
= 0x2014,
84 RES_INVALID_OBJECTINFO
= 0x2015,
85 RES_DESTINATION_UNSUPPORTED
= 0x2020,
86 RES_INVALID_PARENT_OBJECT
= 0x201a,
87 RES_INVALID_PARAMETER
= 0x201d,
88 RES_SESSION_ALREADY_OPEN
= 0x201e,
89 RES_INVALID_OBJECT_PROP_CODE
= 0xA801,
92 FMT_UNDEFINED_OBJECT
= 0x3000,
93 FMT_ASSOCIATION
= 0x3001,
96 EVT_CANCEL_TRANSACTION
= 0x4001,
97 EVT_OBJ_ADDED
= 0x4002,
98 EVT_OBJ_REMOVED
= 0x4003,
99 EVT_OBJ_INFO_CHANGED
= 0x4007,
101 /* object properties */
102 PROP_STORAGE_ID
= 0xDC01,
103 PROP_OBJECT_FORMAT
= 0xDC02,
104 PROP_OBJECT_COMPRESSED_SIZE
= 0xDC04,
105 PROP_PARENT_OBJECT
= 0xDC0B,
106 PROP_PERSISTENT_UNIQUE_OBJECT_IDENTIFIER
= 0xDC41,
111 DATA_TYPE_UINT16
= 0x0004,
112 DATA_TYPE_UINT32
= 0x0006,
113 DATA_TYPE_UINT64
= 0x0008,
114 DATA_TYPE_UINT128
= 0x000a,
115 DATA_TYPE_STRING
= 0xffff,
123 } QEMU_PACKED mtp_container
;
125 /* ----------------------------------------------------------------------- */
127 typedef struct MTPState MTPState
;
128 typedef struct MTPControl MTPControl
;
129 typedef struct MTPData MTPData
;
130 typedef struct MTPObject MTPObject
;
138 typedef struct MTPMonEntry MTPMonEntry
;
144 QTAILQ_ENTRY(MTPMonEntry
) next
;
162 /* Used for >4G file sizes */
165 uint8_t write_status
;
166 /* Internal pointer per every MTP_WRITE_BUF_SZ */
167 uint64_t data_offset
;
176 /* file monitor watch id */
180 QLIST_HEAD(, MTPObject
) children
;
181 QLIST_ENTRY(MTPObject
) list
;
183 QTAILQ_ENTRY(MTPObject
) next
;
196 uint32_t next_handle
;
199 QTAILQ_HEAD(, MTPObject
) objects
;
200 QFileMonitor
*file_monitor
;
201 QTAILQ_HEAD(, MTPMonEntry
) events
;
202 /* Responder is expecting a write operation */
205 uint32_t parent_handle
;
213 * ObjectInfo dataset received from initiator
214 * Fields we don't care about are ignored
217 uint32_t storage_id
; /*unused*/
219 uint16_t protection_status
; /*unused*/
221 uint16_t thumb_format
; /*unused*/
222 uint32_t thumb_comp_sz
; /*unused*/
223 uint32_t thumb_pix_width
; /*unused*/
224 uint32_t thumb_pix_height
; /*unused*/
225 uint32_t image_pix_width
; /*unused*/
226 uint32_t image_pix_height
; /*unused*/
227 uint32_t image_bit_depth
; /*unused*/
228 uint32_t parent
; /*unused*/
231 uint32_t seq_no
; /*unused*/
232 uint8_t length
; /*part of filename field*/
233 uint8_t filename
[0]; /* UTF-16 encoded */
234 char date_created
[0]; /*unused*/
235 char date_modified
[0]; /*unused*/
236 char keywords
[0]; /*unused*/
237 /* string and other data follows */
238 } QEMU_PACKED ObjectInfo
;
240 #define TYPE_USB_MTP "usb-mtp"
241 OBJECT_DECLARE_SIMPLE_TYPE(MTPState
, USB_MTP
)
243 #define QEMU_STORAGE_ID 0x00010001
245 #define MTP_FLAG_WRITABLE 0
247 #define FLAG_SET(_mtp, _flag) ((_mtp)->flags & (1 << (_flag)))
249 /* ----------------------------------------------------------------------- */
251 #define MTP_MANUFACTURER "QEMU"
252 #define MTP_PRODUCT "QEMU filesharing"
253 #define MTP_WRITE_BUF_SZ (512 * KiB)
256 STR_MANUFACTURER
= 1,
265 static const USBDescStrings desc_strings
= {
266 [STR_MANUFACTURER
] = MTP_MANUFACTURER
,
267 [STR_PRODUCT
] = MTP_PRODUCT
,
268 [STR_SERIALNUMBER
] = "34617",
270 [STR_CONFIG_FULL
] = "Full speed config (usb 1.1)",
271 [STR_CONFIG_HIGH
] = "High speed config (usb 2.0)",
272 [STR_CONFIG_SUPER
] = "Super speed config (usb 3.0)",
275 static const USBDescIface desc_iface_full
= {
276 .bInterfaceNumber
= 0,
278 .bInterfaceClass
= USB_CLASS_STILL_IMAGE
,
279 .bInterfaceSubClass
= 0x01,
280 .bInterfaceProtocol
= 0x01,
281 .iInterface
= STR_MTP
,
282 .eps
= (USBDescEndpoint
[]) {
284 .bEndpointAddress
= USB_DIR_IN
| EP_DATA_IN
,
285 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
286 .wMaxPacketSize
= 64,
288 .bEndpointAddress
= USB_DIR_OUT
| EP_DATA_OUT
,
289 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
290 .wMaxPacketSize
= 64,
292 .bEndpointAddress
= USB_DIR_IN
| EP_EVENT
,
293 .bmAttributes
= USB_ENDPOINT_XFER_INT
,
294 .wMaxPacketSize
= 64,
300 static const USBDescDevice desc_device_full
= {
302 .bMaxPacketSize0
= 8,
303 .bNumConfigurations
= 1,
304 .confs
= (USBDescConfig
[]) {
307 .bConfigurationValue
= 1,
308 .iConfiguration
= STR_CONFIG_FULL
,
309 .bmAttributes
= USB_CFG_ATT_ONE
| USB_CFG_ATT_WAKEUP
,
312 .ifs
= &desc_iface_full
,
317 static const USBDescIface desc_iface_high
= {
318 .bInterfaceNumber
= 0,
320 .bInterfaceClass
= USB_CLASS_STILL_IMAGE
,
321 .bInterfaceSubClass
= 0x01,
322 .bInterfaceProtocol
= 0x01,
323 .iInterface
= STR_MTP
,
324 .eps
= (USBDescEndpoint
[]) {
326 .bEndpointAddress
= USB_DIR_IN
| EP_DATA_IN
,
327 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
328 .wMaxPacketSize
= 512,
330 .bEndpointAddress
= USB_DIR_OUT
| EP_DATA_OUT
,
331 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
332 .wMaxPacketSize
= 512,
334 .bEndpointAddress
= USB_DIR_IN
| EP_EVENT
,
335 .bmAttributes
= USB_ENDPOINT_XFER_INT
,
336 .wMaxPacketSize
= 64,
342 static const USBDescDevice desc_device_high
= {
344 .bMaxPacketSize0
= 64,
345 .bNumConfigurations
= 1,
346 .confs
= (USBDescConfig
[]) {
349 .bConfigurationValue
= 1,
350 .iConfiguration
= STR_CONFIG_HIGH
,
351 .bmAttributes
= USB_CFG_ATT_ONE
| USB_CFG_ATT_WAKEUP
,
354 .ifs
= &desc_iface_high
,
359 static const USBDescMSOS desc_msos
= {
360 .CompatibleID
= "MTP",
361 .SelectiveSuspendEnabled
= true,
364 static const USBDesc desc
= {
366 .idVendor
= 0x46f4, /* CRC16() of "QEMU" */
369 .iManufacturer
= STR_MANUFACTURER
,
370 .iProduct
= STR_PRODUCT
,
371 .iSerialNumber
= STR_SERIALNUMBER
,
373 .full
= &desc_device_full
,
374 .high
= &desc_device_high
,
379 /* ----------------------------------------------------------------------- */
381 static MTPObject
*usb_mtp_object_alloc(MTPState
*s
, uint32_t handle
,
382 MTPObject
*parent
, const char *name
)
384 MTPObject
*o
= g_new0(MTPObject
, 1);
386 if (name
[0] == '.') {
393 o
->name
= g_strdup(name
);
394 if (parent
== NULL
) {
395 o
->path
= g_strdup(name
);
397 o
->path
= g_strdup_printf("%s/%s", parent
->path
, name
);
400 if (lstat(o
->path
, &o
->stat
) != 0) {
403 if (S_ISREG(o
->stat
.st_mode
)) {
404 o
->format
= FMT_UNDEFINED_OBJECT
;
405 } else if (S_ISDIR(o
->stat
.st_mode
)) {
406 o
->format
= FMT_ASSOCIATION
;
411 if (access(o
->path
, R_OK
) != 0) {
415 trace_usb_mtp_object_alloc(s
->dev
.addr
, o
->handle
, o
->path
);
417 QTAILQ_INSERT_TAIL(&s
->objects
, o
, next
);
427 static void usb_mtp_object_free(MTPState
*s
, MTPObject
*o
)
435 trace_usb_mtp_object_free(s
->dev
.addr
, o
->handle
, o
->path
);
437 if (o
->watchid
!= -1 && s
->file_monitor
) {
438 qemu_file_monitor_remove_watch(s
->file_monitor
, o
->path
, o
->watchid
);
441 QTAILQ_REMOVE(&s
->objects
, o
, next
);
443 QLIST_REMOVE(o
, list
);
444 o
->parent
->nchildren
--;
447 while (!QLIST_EMPTY(&o
->children
)) {
448 iter
= QLIST_FIRST(&o
->children
);
449 usb_mtp_object_free(s
, iter
);
456 static MTPObject
*usb_mtp_object_lookup(MTPState
*s
, uint32_t handle
)
460 QTAILQ_FOREACH(o
, &s
->objects
, next
) {
461 if (o
->handle
== handle
) {
468 static MTPObject
*usb_mtp_add_child(MTPState
*s
, MTPObject
*o
,
472 usb_mtp_object_alloc(s
, s
->next_handle
++, o
, name
);
475 trace_usb_mtp_add_child(s
->dev
.addr
, child
->handle
, child
->path
);
476 QLIST_INSERT_HEAD(&o
->children
, child
, list
);
479 if (child
->format
== FMT_ASSOCIATION
) {
480 QLIST_INIT(&child
->children
);
487 static MTPObject
*usb_mtp_object_lookup_name(MTPObject
*parent
,
488 const char *name
, int len
)
496 QLIST_FOREACH(iter
, &parent
->children
, list
) {
497 if (strncmp(iter
->name
, name
, len
) == 0) {
505 static MTPObject
*usb_mtp_object_lookup_id(MTPState
*s
, int64_t id
)
509 QTAILQ_FOREACH(iter
, &s
->objects
, next
) {
510 if (iter
->watchid
== id
) {
518 static void file_monitor_event(int64_t id
,
519 QFileMonitorEvent ev
,
523 MTPState
*s
= opaque
;
524 MTPObject
*parent
= usb_mtp_object_lookup_id(s
, id
);
525 MTPMonEntry
*entry
= NULL
;
533 case QFILE_MONITOR_EVENT_CREATED
:
534 if (usb_mtp_object_lookup_name(parent
, name
, -1)) {
535 /* Duplicate create event */
538 entry
= g_new0(MTPMonEntry
, 1);
539 entry
->handle
= s
->next_handle
;
540 entry
->event
= EVT_OBJ_ADDED
;
541 o
= usb_mtp_add_child(s
, parent
, name
);
546 trace_usb_mtp_file_monitor_event(s
->dev
.addr
, name
, "Obj Added");
549 case QFILE_MONITOR_EVENT_DELETED
:
551 * The kernel issues a IN_IGNORED event
552 * when a dir containing a watchpoint is
553 * deleted, so we don't have to delete the
556 o
= usb_mtp_object_lookup_name(parent
, name
, -1);
560 entry
= g_new0(MTPMonEntry
, 1);
561 entry
->handle
= o
->handle
;
562 entry
->event
= EVT_OBJ_REMOVED
;
563 trace_usb_mtp_file_monitor_event(s
->dev
.addr
, o
->path
, "Obj Deleted");
564 usb_mtp_object_free(s
, o
);
567 case QFILE_MONITOR_EVENT_MODIFIED
:
568 o
= usb_mtp_object_lookup_name(parent
, name
, -1);
572 entry
= g_new0(MTPMonEntry
, 1);
573 entry
->handle
= o
->handle
;
574 entry
->event
= EVT_OBJ_INFO_CHANGED
;
575 trace_usb_mtp_file_monitor_event(s
->dev
.addr
, o
->path
, "Obj Modified");
578 case QFILE_MONITOR_EVENT_IGNORED
:
579 trace_usb_mtp_file_monitor_event(s
->dev
.addr
, parent
->path
,
580 "Obj parent dir ignored");
583 case QFILE_MONITOR_EVENT_ATTRIBUTES
:
587 g_assert_not_reached();
591 QTAILQ_INSERT_HEAD(&s
->events
, entry
, next
);
595 static void usb_mtp_file_monitor_cleanup(MTPState
*s
)
599 QTAILQ_FOREACH_SAFE(e
, &s
->events
, next
, p
) {
600 QTAILQ_REMOVE(&s
->events
, e
, next
);
604 qemu_file_monitor_free(s
->file_monitor
);
605 s
->file_monitor
= NULL
;
609 static void usb_mtp_object_readdir(MTPState
*s
, MTPObject
*o
)
611 struct dirent
*entry
;
616 if (o
->have_children
) {
619 o
->have_children
= true;
621 fd
= open(o
->path
, O_DIRECTORY
| O_CLOEXEC
| O_NOFOLLOW
);
631 if (s
->file_monitor
) {
632 int64_t id
= qemu_file_monitor_add_watch(s
->file_monitor
, o
->path
, NULL
,
633 file_monitor_event
, s
, &err
);
635 error_reportf_err(err
,
636 "usb-mtp: failed to add watch for %s: ",
639 trace_usb_mtp_file_monitor_event(s
->dev
.addr
, o
->path
,
645 while ((entry
= readdir(dir
)) != NULL
) {
646 usb_mtp_add_child(s
, o
, entry
->d_name
);
651 /* ----------------------------------------------------------------------- */
653 static MTPData
*usb_mtp_data_alloc(MTPControl
*c
)
655 MTPData
*data
= g_new0(MTPData
, 1);
657 data
->code
= c
->code
;
658 data
->trans
= c
->trans
;
664 static void usb_mtp_data_free(MTPData
*data
)
669 if (data
->fd
!= -1) {
676 static void usb_mtp_realloc(MTPData
*data
, uint32_t bytes
)
678 if (data
->length
+ bytes
<= data
->alloc
) {
681 data
->alloc
= (data
->length
+ bytes
+ 0xff) & ~0xff;
682 data
->data
= g_realloc(data
->data
, data
->alloc
);
685 static void usb_mtp_add_u8(MTPData
*data
, uint8_t val
)
687 usb_mtp_realloc(data
, 1);
688 data
->data
[data
->length
++] = val
;
691 static void usb_mtp_add_u16(MTPData
*data
, uint16_t val
)
693 usb_mtp_realloc(data
, 2);
694 data
->data
[data
->length
++] = (val
>> 0) & 0xff;
695 data
->data
[data
->length
++] = (val
>> 8) & 0xff;
698 static void usb_mtp_add_u32(MTPData
*data
, uint32_t val
)
700 usb_mtp_realloc(data
, 4);
701 data
->data
[data
->length
++] = (val
>> 0) & 0xff;
702 data
->data
[data
->length
++] = (val
>> 8) & 0xff;
703 data
->data
[data
->length
++] = (val
>> 16) & 0xff;
704 data
->data
[data
->length
++] = (val
>> 24) & 0xff;
707 static void usb_mtp_add_u64(MTPData
*data
, uint64_t val
)
709 usb_mtp_realloc(data
, 8);
710 data
->data
[data
->length
++] = (val
>> 0) & 0xff;
711 data
->data
[data
->length
++] = (val
>> 8) & 0xff;
712 data
->data
[data
->length
++] = (val
>> 16) & 0xff;
713 data
->data
[data
->length
++] = (val
>> 24) & 0xff;
714 data
->data
[data
->length
++] = (val
>> 32) & 0xff;
715 data
->data
[data
->length
++] = (val
>> 40) & 0xff;
716 data
->data
[data
->length
++] = (val
>> 48) & 0xff;
717 data
->data
[data
->length
++] = (val
>> 56) & 0xff;
720 static void usb_mtp_add_u16_array(MTPData
*data
, uint32_t len
,
721 const uint16_t *vals
)
725 usb_mtp_add_u32(data
, len
);
726 for (i
= 0; i
< len
; i
++) {
727 usb_mtp_add_u16(data
, vals
[i
]);
731 static void usb_mtp_add_u32_array(MTPData
*data
, uint32_t len
,
732 const uint32_t *vals
)
736 usb_mtp_add_u32(data
, len
);
737 for (i
= 0; i
< len
; i
++) {
738 usb_mtp_add_u32(data
, vals
[i
]);
742 static void usb_mtp_add_wstr(MTPData
*data
, const wchar_t *str
)
744 uint32_t len
= wcslen(str
);
748 len
++; /* include terminating L'\0' */
751 usb_mtp_add_u8(data
, len
);
752 for (i
= 0; i
< len
; i
++) {
753 usb_mtp_add_u16(data
, str
[i
]);
757 static void usb_mtp_add_str(MTPData
*data
, const char *str
)
759 uint32_t len
= strlen(str
)+1;
760 wchar_t *wstr
= g_new(wchar_t, len
);
763 ret
= mbstowcs(wstr
, str
, len
);
765 usb_mtp_add_wstr(data
, L
"Oops");
767 usb_mtp_add_wstr(data
, wstr
);
773 static void usb_mtp_add_time(MTPData
*data
, time_t time
)
778 gmtime_r(&time
, &tm
);
779 strftime(buf
, sizeof(buf
), "%Y%m%dT%H%M%S", &tm
);
780 usb_mtp_add_str(data
, buf
);
783 /* ----------------------------------------------------------------------- */
785 static void usb_mtp_queue_result(MTPState
*s
, uint16_t code
, uint32_t trans
,
786 int argc
, uint32_t arg0
, uint32_t arg1
,
789 MTPControl
*c
= g_new0(MTPControl
, 1);
804 assert(s
->result
== NULL
);
808 /* ----------------------------------------------------------------------- */
810 static MTPData
*usb_mtp_get_device_info(MTPState
*s
, MTPControl
*c
)
812 static const uint16_t ops
[] = {
817 CMD_GET_STORAGE_INFO
,
819 CMD_GET_OBJECT_HANDLES
,
822 CMD_SEND_OBJECT_INFO
,
825 CMD_GET_PARTIAL_OBJECT
,
826 CMD_GET_OBJECT_PROPS_SUPPORTED
,
827 CMD_GET_OBJECT_PROP_DESC
,
828 CMD_GET_OBJECT_PROP_VALUE
,
830 static const uint16_t fmt
[] = {
831 FMT_UNDEFINED_OBJECT
,
834 MTPData
*d
= usb_mtp_data_alloc(c
);
836 trace_usb_mtp_op_get_device_info(s
->dev
.addr
);
838 usb_mtp_add_u16(d
, 100);
839 usb_mtp_add_u32(d
, 0x00000006);
840 usb_mtp_add_u16(d
, 0x0064);
841 usb_mtp_add_wstr(d
, L
"");
842 usb_mtp_add_u16(d
, 0x0000);
844 usb_mtp_add_u16_array(d
, ARRAY_SIZE(ops
), ops
);
845 usb_mtp_add_u16_array(d
, 0, NULL
);
846 usb_mtp_add_u16_array(d
, 0, NULL
);
847 usb_mtp_add_u16_array(d
, 0, NULL
);
848 usb_mtp_add_u16_array(d
, ARRAY_SIZE(fmt
), fmt
);
850 usb_mtp_add_wstr(d
, L
"" MTP_MANUFACTURER
);
851 usb_mtp_add_wstr(d
, L
"" MTP_PRODUCT
);
852 usb_mtp_add_wstr(d
, L
"0.1");
853 usb_mtp_add_wstr(d
, L
"0123456789abcdef0123456789abcdef");
858 static MTPData
*usb_mtp_get_storage_ids(MTPState
*s
, MTPControl
*c
)
860 static const uint32_t ids
[] = {
863 MTPData
*d
= usb_mtp_data_alloc(c
);
865 trace_usb_mtp_op_get_storage_ids(s
->dev
.addr
);
867 usb_mtp_add_u32_array(d
, ARRAY_SIZE(ids
), ids
);
872 static MTPData
*usb_mtp_get_storage_info(MTPState
*s
, MTPControl
*c
)
874 MTPData
*d
= usb_mtp_data_alloc(c
);
878 trace_usb_mtp_op_get_storage_info(s
->dev
.addr
);
880 if (FLAG_SET(s
, MTP_FLAG_WRITABLE
)) {
881 usb_mtp_add_u16(d
, 0x0003);
882 usb_mtp_add_u16(d
, 0x0002);
883 usb_mtp_add_u16(d
, 0x0000);
885 usb_mtp_add_u16(d
, 0x0001);
886 usb_mtp_add_u16(d
, 0x0002);
887 usb_mtp_add_u16(d
, 0x0001);
890 rc
= statvfs(s
->root
, &buf
);
892 usb_mtp_add_u64(d
, (uint64_t)buf
.f_frsize
* buf
.f_blocks
);
893 usb_mtp_add_u64(d
, (uint64_t)buf
.f_bavail
* buf
.f_blocks
);
894 usb_mtp_add_u32(d
, buf
.f_ffree
);
896 usb_mtp_add_u64(d
, 0xffffffff);
897 usb_mtp_add_u64(d
, 0xffffffff);
898 usb_mtp_add_u32(d
, 0xffffffff);
901 usb_mtp_add_str(d
, s
->desc
);
902 usb_mtp_add_wstr(d
, L
"123456789abcdef");
906 static MTPData
*usb_mtp_get_object_handles(MTPState
*s
, MTPControl
*c
,
909 MTPData
*d
= usb_mtp_data_alloc(c
);
911 g_autofree
uint32_t *handles
= g_new(uint32_t, o
->nchildren
);
914 trace_usb_mtp_op_get_object_handles(s
->dev
.addr
, o
->handle
, o
->path
);
916 QLIST_FOREACH(iter
, &o
->children
, list
) {
917 handles
[i
++] = iter
->handle
;
919 assert(i
== o
->nchildren
);
920 usb_mtp_add_u32_array(d
, o
->nchildren
, handles
);
925 static MTPData
*usb_mtp_get_object_info(MTPState
*s
, MTPControl
*c
,
928 MTPData
*d
= usb_mtp_data_alloc(c
);
930 trace_usb_mtp_op_get_object_info(s
->dev
.addr
, o
->handle
, o
->path
);
932 usb_mtp_add_u32(d
, QEMU_STORAGE_ID
);
933 usb_mtp_add_u16(d
, o
->format
);
934 usb_mtp_add_u16(d
, 0);
936 if (o
->stat
.st_size
> 0xFFFFFFFF) {
937 usb_mtp_add_u32(d
, 0xFFFFFFFF);
939 usb_mtp_add_u32(d
, o
->stat
.st_size
);
942 usb_mtp_add_u16(d
, 0);
943 usb_mtp_add_u32(d
, 0);
944 usb_mtp_add_u32(d
, 0);
945 usb_mtp_add_u32(d
, 0);
946 usb_mtp_add_u32(d
, 0);
947 usb_mtp_add_u32(d
, 0);
948 usb_mtp_add_u32(d
, 0);
951 usb_mtp_add_u32(d
, o
->parent
->handle
);
953 usb_mtp_add_u32(d
, 0);
955 if (o
->format
== FMT_ASSOCIATION
) {
956 usb_mtp_add_u16(d
, 0x0001);
957 usb_mtp_add_u32(d
, 0x00000001);
958 usb_mtp_add_u32(d
, 0);
960 usb_mtp_add_u16(d
, 0);
961 usb_mtp_add_u32(d
, 0);
962 usb_mtp_add_u32(d
, 0);
965 usb_mtp_add_str(d
, o
->name
);
966 usb_mtp_add_time(d
, o
->stat
.st_ctime
);
967 usb_mtp_add_time(d
, o
->stat
.st_mtime
);
968 usb_mtp_add_wstr(d
, L
"");
973 static MTPData
*usb_mtp_get_object(MTPState
*s
, MTPControl
*c
,
976 MTPData
*d
= usb_mtp_data_alloc(c
);
978 trace_usb_mtp_op_get_object(s
->dev
.addr
, o
->handle
, o
->path
);
980 d
->fd
= open(o
->path
, O_RDONLY
| O_CLOEXEC
| O_NOFOLLOW
);
982 usb_mtp_data_free(d
);
985 d
->length
= o
->stat
.st_size
;
987 d
->data
= g_malloc(d
->alloc
);
991 static MTPData
*usb_mtp_get_partial_object(MTPState
*s
, MTPControl
*c
,
1000 trace_usb_mtp_op_get_partial_object(s
->dev
.addr
, o
->handle
, o
->path
,
1001 c
->argv
[1], c
->argv
[2]);
1003 d
= usb_mtp_data_alloc(c
);
1004 d
->fd
= open(o
->path
, O_RDONLY
| O_CLOEXEC
| O_NOFOLLOW
);
1006 usb_mtp_data_free(d
);
1010 offset
= c
->argv
[1];
1011 if (offset
> o
->stat
.st_size
) {
1012 offset
= o
->stat
.st_size
;
1014 if (lseek(d
->fd
, offset
, SEEK_SET
) < 0) {
1015 usb_mtp_data_free(d
);
1019 d
->length
= c
->argv
[2];
1020 if (d
->length
> o
->stat
.st_size
- offset
) {
1021 d
->length
= o
->stat
.st_size
- offset
;
1027 static MTPData
*usb_mtp_get_object_props_supported(MTPState
*s
, MTPControl
*c
)
1029 static const uint16_t props
[] = {
1032 PROP_OBJECT_COMPRESSED_SIZE
,
1034 PROP_PERSISTENT_UNIQUE_OBJECT_IDENTIFIER
,
1037 MTPData
*d
= usb_mtp_data_alloc(c
);
1038 usb_mtp_add_u16_array(d
, ARRAY_SIZE(props
), props
);
1043 static MTPData
*usb_mtp_get_object_prop_desc(MTPState
*s
, MTPControl
*c
)
1045 MTPData
*d
= usb_mtp_data_alloc(c
);
1046 switch (c
->argv
[0]) {
1047 case PROP_STORAGE_ID
:
1048 usb_mtp_add_u16(d
, PROP_STORAGE_ID
);
1049 usb_mtp_add_u16(d
, DATA_TYPE_UINT32
);
1050 usb_mtp_add_u8(d
, 0x00);
1051 usb_mtp_add_u32(d
, 0x00000000);
1052 usb_mtp_add_u32(d
, 0x00000000);
1053 usb_mtp_add_u8(d
, 0x00);
1055 case PROP_OBJECT_FORMAT
:
1056 usb_mtp_add_u16(d
, PROP_OBJECT_FORMAT
);
1057 usb_mtp_add_u16(d
, DATA_TYPE_UINT16
);
1058 usb_mtp_add_u8(d
, 0x00);
1059 usb_mtp_add_u16(d
, 0x0000);
1060 usb_mtp_add_u32(d
, 0x00000000);
1061 usb_mtp_add_u8(d
, 0x00);
1063 case PROP_OBJECT_COMPRESSED_SIZE
:
1064 usb_mtp_add_u16(d
, PROP_OBJECT_COMPRESSED_SIZE
);
1065 usb_mtp_add_u16(d
, DATA_TYPE_UINT64
);
1066 usb_mtp_add_u8(d
, 0x00);
1067 usb_mtp_add_u64(d
, 0x0000000000000000);
1068 usb_mtp_add_u32(d
, 0x00000000);
1069 usb_mtp_add_u8(d
, 0x00);
1071 case PROP_PARENT_OBJECT
:
1072 usb_mtp_add_u16(d
, PROP_PARENT_OBJECT
);
1073 usb_mtp_add_u16(d
, DATA_TYPE_UINT32
);
1074 usb_mtp_add_u8(d
, 0x00);
1075 usb_mtp_add_u32(d
, 0x00000000);
1076 usb_mtp_add_u32(d
, 0x00000000);
1077 usb_mtp_add_u8(d
, 0x00);
1079 case PROP_PERSISTENT_UNIQUE_OBJECT_IDENTIFIER
:
1080 usb_mtp_add_u16(d
, PROP_PERSISTENT_UNIQUE_OBJECT_IDENTIFIER
);
1081 usb_mtp_add_u16(d
, DATA_TYPE_UINT128
);
1082 usb_mtp_add_u8(d
, 0x00);
1083 usb_mtp_add_u64(d
, 0x0000000000000000);
1084 usb_mtp_add_u64(d
, 0x0000000000000000);
1085 usb_mtp_add_u32(d
, 0x00000000);
1086 usb_mtp_add_u8(d
, 0x00);
1089 usb_mtp_add_u16(d
, PROP_NAME
);
1090 usb_mtp_add_u16(d
, DATA_TYPE_STRING
);
1091 usb_mtp_add_u8(d
, 0x00);
1092 usb_mtp_add_u8(d
, 0x00);
1093 usb_mtp_add_u32(d
, 0x00000000);
1094 usb_mtp_add_u8(d
, 0x00);
1097 usb_mtp_data_free(d
);
1104 static MTPData
*usb_mtp_get_object_prop_value(MTPState
*s
, MTPControl
*c
,
1107 MTPData
*d
= usb_mtp_data_alloc(c
);
1108 switch (c
->argv
[1]) {
1109 case PROP_STORAGE_ID
:
1110 usb_mtp_add_u32(d
, QEMU_STORAGE_ID
);
1112 case PROP_OBJECT_FORMAT
:
1113 usb_mtp_add_u16(d
, o
->format
);
1115 case PROP_OBJECT_COMPRESSED_SIZE
:
1116 usb_mtp_add_u64(d
, o
->stat
.st_size
);
1118 case PROP_PARENT_OBJECT
:
1119 if (o
->parent
== NULL
) {
1120 usb_mtp_add_u32(d
, 0x00000000);
1122 usb_mtp_add_u32(d
, o
->parent
->handle
);
1125 case PROP_PERSISTENT_UNIQUE_OBJECT_IDENTIFIER
:
1126 /* Should be persistent between sessions,
1127 * but using our objedt ID is "good enough"
1129 usb_mtp_add_u64(d
, 0x0000000000000000);
1130 usb_mtp_add_u64(d
, o
->handle
);
1133 usb_mtp_add_str(d
, o
->name
);
1136 usb_mtp_data_free(d
);
1144 * Return values when object @o is deleted.
1145 * If at least one of the deletions succeeded,
1146 * DELETE_SUCCESS is set and if at least one
1147 * of the deletions failed, DELETE_FAILURE is
1148 * set. Both bits being set (DELETE_PARTIAL)
1149 * signifies a RES_PARTIAL_DELETE being sent
1150 * back to the initiator.
1153 DELETE_SUCCESS
= (1 << 0),
1154 DELETE_FAILURE
= (1 << 1),
1155 DELETE_PARTIAL
= (DELETE_FAILURE
| DELETE_SUCCESS
),
1158 static int usb_mtp_deletefn(MTPState
*s
, MTPObject
*o
, uint32_t trans
)
1160 MTPObject
*iter
, *iter2
;
1164 * TODO: Add support for Protection Status
1167 QLIST_FOREACH(iter
, &o
->children
, list
) {
1168 if (iter
->format
== FMT_ASSOCIATION
) {
1169 QLIST_FOREACH(iter2
, &iter
->children
, list
) {
1170 ret
|= usb_mtp_deletefn(s
, iter2
, trans
);
1175 if (o
->format
== FMT_UNDEFINED_OBJECT
) {
1176 if (remove(o
->path
)) {
1177 ret
|= DELETE_FAILURE
;
1179 usb_mtp_object_free(s
, o
);
1180 ret
|= DELETE_SUCCESS
;
1182 } else if (o
->format
== FMT_ASSOCIATION
) {
1183 if (rmdir(o
->path
)) {
1184 ret
|= DELETE_FAILURE
;
1186 usb_mtp_object_free(s
, o
);
1187 ret
|= DELETE_SUCCESS
;
1194 static void usb_mtp_object_delete(MTPState
*s
, uint32_t handle
,
1195 uint32_t format_code
, uint32_t trans
)
1200 /* Return error if store is read-only */
1201 if (!FLAG_SET(s
, MTP_FLAG_WRITABLE
)) {
1202 usb_mtp_queue_result(s
, RES_STORE_READ_ONLY
,
1207 if (format_code
!= 0) {
1208 usb_mtp_queue_result(s
, RES_SPEC_BY_FORMAT_UNSUPPORTED
,
1213 if (handle
== 0xFFFFFFF) {
1214 o
= QTAILQ_FIRST(&s
->objects
);
1216 o
= usb_mtp_object_lookup(s
, handle
);
1219 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1224 ret
= usb_mtp_deletefn(s
, o
, trans
);
1226 case DELETE_SUCCESS
:
1227 usb_mtp_queue_result(s
, RES_OK
, trans
,
1230 case DELETE_FAILURE
:
1231 usb_mtp_queue_result(s
, RES_PARTIAL_DELETE
,
1234 case DELETE_PARTIAL
:
1235 usb_mtp_queue_result(s
, RES_PARTIAL_DELETE
,
1239 g_assert_not_reached();
1245 static void usb_mtp_command(MTPState
*s
, MTPControl
*c
)
1247 MTPData
*data_in
= NULL
;
1248 MTPObject
*o
= NULL
;
1249 uint32_t nres
= 0, res0
= 0;
1253 if (c
->code
>= CMD_CLOSE_SESSION
&& s
->session
== 0) {
1254 usb_mtp_queue_result(s
, RES_SESSION_NOT_OPEN
,
1255 c
->trans
, 0, 0, 0, 0);
1259 /* process commands */
1261 case CMD_GET_DEVICE_INFO
:
1262 data_in
= usb_mtp_get_device_info(s
, c
);
1264 case CMD_OPEN_SESSION
:
1266 usb_mtp_queue_result(s
, RES_SESSION_ALREADY_OPEN
,
1267 c
->trans
, 1, s
->session
, 0, 0);
1270 if (c
->argv
[0] == 0) {
1271 usb_mtp_queue_result(s
, RES_INVALID_PARAMETER
,
1272 c
->trans
, 0, 0, 0, 0);
1275 trace_usb_mtp_op_open_session(s
->dev
.addr
);
1276 s
->session
= c
->argv
[0];
1277 usb_mtp_object_alloc(s
, s
->next_handle
++, NULL
, s
->root
);
1279 s
->file_monitor
= qemu_file_monitor_new(&err
);
1281 error_reportf_err(err
,
1282 "usb-mtp: file monitoring init failed: ");
1284 QTAILQ_INIT(&s
->events
);
1287 case CMD_CLOSE_SESSION
:
1288 trace_usb_mtp_op_close_session(s
->dev
.addr
);
1291 usb_mtp_file_monitor_cleanup(s
);
1292 usb_mtp_object_free(s
, QTAILQ_FIRST(&s
->objects
));
1293 assert(QTAILQ_EMPTY(&s
->objects
));
1295 case CMD_GET_STORAGE_IDS
:
1296 data_in
= usb_mtp_get_storage_ids(s
, c
);
1298 case CMD_GET_STORAGE_INFO
:
1299 if (c
->argv
[0] != QEMU_STORAGE_ID
&&
1300 c
->argv
[0] != 0xffffffff) {
1301 usb_mtp_queue_result(s
, RES_INVALID_STORAGE_ID
,
1302 c
->trans
, 0, 0, 0, 0);
1305 data_in
= usb_mtp_get_storage_info(s
, c
);
1307 case CMD_GET_NUM_OBJECTS
:
1308 case CMD_GET_OBJECT_HANDLES
:
1309 if (c
->argv
[0] != QEMU_STORAGE_ID
&&
1310 c
->argv
[0] != 0xffffffff) {
1311 usb_mtp_queue_result(s
, RES_INVALID_STORAGE_ID
,
1312 c
->trans
, 0, 0, 0, 0);
1315 if (c
->argv
[1] != 0x00000000) {
1316 usb_mtp_queue_result(s
, RES_SPEC_BY_FORMAT_UNSUPPORTED
,
1317 c
->trans
, 0, 0, 0, 0);
1320 if (c
->argv
[2] == 0x00000000 ||
1321 c
->argv
[2] == 0xffffffff) {
1322 o
= QTAILQ_FIRST(&s
->objects
);
1324 o
= usb_mtp_object_lookup(s
, c
->argv
[2]);
1327 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1328 c
->trans
, 0, 0, 0, 0);
1331 if (o
->format
!= FMT_ASSOCIATION
) {
1332 usb_mtp_queue_result(s
, RES_INVALID_PARENT_OBJECT
,
1333 c
->trans
, 0, 0, 0, 0);
1336 usb_mtp_object_readdir(s
, o
);
1337 if (c
->code
== CMD_GET_NUM_OBJECTS
) {
1338 trace_usb_mtp_op_get_num_objects(s
->dev
.addr
, o
->handle
, o
->path
);
1340 res0
= o
->nchildren
;
1342 data_in
= usb_mtp_get_object_handles(s
, c
, o
);
1345 case CMD_GET_OBJECT_INFO
:
1346 o
= usb_mtp_object_lookup(s
, c
->argv
[0]);
1348 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1349 c
->trans
, 0, 0, 0, 0);
1352 data_in
= usb_mtp_get_object_info(s
, c
, o
);
1354 case CMD_GET_OBJECT
:
1355 o
= usb_mtp_object_lookup(s
, c
->argv
[0]);
1357 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1358 c
->trans
, 0, 0, 0, 0);
1361 if (o
->format
== FMT_ASSOCIATION
) {
1362 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1363 c
->trans
, 0, 0, 0, 0);
1366 data_in
= usb_mtp_get_object(s
, c
, o
);
1367 if (data_in
== NULL
) {
1368 usb_mtp_queue_result(s
, RES_GENERAL_ERROR
,
1369 c
->trans
, 0, 0, 0, 0);
1373 case CMD_DELETE_OBJECT
:
1374 usb_mtp_object_delete(s
, c
->argv
[0], c
->argv
[1], c
->trans
);
1376 case CMD_GET_PARTIAL_OBJECT
:
1377 o
= usb_mtp_object_lookup(s
, c
->argv
[0]);
1379 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1380 c
->trans
, 0, 0, 0, 0);
1383 if (o
->format
== FMT_ASSOCIATION
) {
1384 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1385 c
->trans
, 0, 0, 0, 0);
1388 data_in
= usb_mtp_get_partial_object(s
, c
, o
);
1389 if (data_in
== NULL
) {
1390 usb_mtp_queue_result(s
, RES_GENERAL_ERROR
,
1391 c
->trans
, 0, 0, 0, 0);
1395 res0
= data_in
->length
;
1397 case CMD_SEND_OBJECT_INFO
:
1398 /* Return error if store is read-only */
1399 if (!FLAG_SET(s
, MTP_FLAG_WRITABLE
)) {
1400 usb_mtp_queue_result(s
, RES_STORE_READ_ONLY
,
1401 c
->trans
, 0, 0, 0, 0);
1402 } else if (c
->argv
[0] && (c
->argv
[0] != QEMU_STORAGE_ID
)) {
1403 /* First parameter points to storage id or is 0 */
1404 usb_mtp_queue_result(s
, RES_STORE_NOT_AVAILABLE
, c
->trans
,
1406 } else if (c
->argv
[1] && !c
->argv
[0]) {
1407 /* If second parameter is specified, first must also be specified */
1408 usb_mtp_queue_result(s
, RES_DESTINATION_UNSUPPORTED
, c
->trans
,
1411 uint32_t handle
= c
->argv
[1];
1412 if (handle
== 0xFFFFFFFF || handle
== 0) {
1414 o
= QTAILQ_FIRST(&s
->objects
);
1416 o
= usb_mtp_object_lookup(s
, handle
);
1419 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
, c
->trans
,
1421 } else if (o
->format
!= FMT_ASSOCIATION
) {
1422 usb_mtp_queue_result(s
, RES_INVALID_PARENT_OBJECT
, c
->trans
,
1427 s
->dataset
.parent_handle
= o
->handle
;
1429 s
->data_out
= usb_mtp_data_alloc(c
);
1431 case CMD_SEND_OBJECT
:
1432 if (!FLAG_SET(s
, MTP_FLAG_WRITABLE
)) {
1433 usb_mtp_queue_result(s
, RES_STORE_READ_ONLY
,
1434 c
->trans
, 0, 0, 0, 0);
1437 if (!s
->write_pending
) {
1438 usb_mtp_queue_result(s
, RES_INVALID_OBJECTINFO
,
1439 c
->trans
, 0, 0, 0, 0);
1442 s
->data_out
= usb_mtp_data_alloc(c
);
1444 case CMD_GET_OBJECT_PROPS_SUPPORTED
:
1445 if (c
->argv
[0] != FMT_UNDEFINED_OBJECT
&&
1446 c
->argv
[0] != FMT_ASSOCIATION
) {
1447 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_FORMAT_CODE
,
1448 c
->trans
, 0, 0, 0, 0);
1451 data_in
= usb_mtp_get_object_props_supported(s
, c
);
1453 case CMD_GET_OBJECT_PROP_DESC
:
1454 if (c
->argv
[1] != FMT_UNDEFINED_OBJECT
&&
1455 c
->argv
[1] != FMT_ASSOCIATION
) {
1456 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_FORMAT_CODE
,
1457 c
->trans
, 0, 0, 0, 0);
1460 data_in
= usb_mtp_get_object_prop_desc(s
, c
);
1461 if (data_in
== NULL
) {
1462 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_PROP_CODE
,
1463 c
->trans
, 0, 0, 0, 0);
1467 case CMD_GET_OBJECT_PROP_VALUE
:
1468 o
= usb_mtp_object_lookup(s
, c
->argv
[0]);
1470 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_HANDLE
,
1471 c
->trans
, 0, 0, 0, 0);
1474 data_in
= usb_mtp_get_object_prop_value(s
, c
, o
);
1475 if (data_in
== NULL
) {
1476 usb_mtp_queue_result(s
, RES_INVALID_OBJECT_PROP_CODE
,
1477 c
->trans
, 0, 0, 0, 0);
1482 trace_usb_mtp_op_unknown(s
->dev
.addr
, c
->code
);
1483 usb_mtp_queue_result(s
, RES_OPERATION_NOT_SUPPORTED
,
1484 c
->trans
, 0, 0, 0, 0);
1488 /* return results on success */
1490 assert(s
->data_in
== NULL
);
1491 s
->data_in
= data_in
;
1493 usb_mtp_queue_result(s
, RES_OK
, c
->trans
, nres
, res0
, 0, 0);
1496 /* ----------------------------------------------------------------------- */
1498 static void usb_mtp_handle_reset(USBDevice
*dev
)
1500 MTPState
*s
= USB_MTP(dev
);
1502 trace_usb_mtp_reset(s
->dev
.addr
);
1504 usb_mtp_file_monitor_cleanup(s
);
1505 usb_mtp_object_free(s
, QTAILQ_FIRST(&s
->objects
));
1507 usb_mtp_data_free(s
->data_in
);
1509 usb_mtp_data_free(s
->data_out
);
1515 static void usb_mtp_handle_control(USBDevice
*dev
, USBPacket
*p
,
1516 int request
, int value
, int index
,
1517 int length
, uint8_t *data
)
1520 MTPState
*s
= USB_MTP(dev
);
1521 uint16_t *event
= (uint16_t *)data
;
1524 case ClassInterfaceOutRequest
| 0x64:
1525 if (*event
== EVT_CANCEL_TRANSACTION
) {
1528 usb_mtp_data_free(s
->data_in
);
1530 if (s
->write_pending
) {
1531 g_free(s
->dataset
.filename
);
1532 s
->write_pending
= false;
1533 s
->dataset
.size
= 0;
1535 usb_mtp_data_free(s
->data_out
);
1538 p
->status
= USB_RET_STALL
;
1542 ret
= usb_desc_handle_control(dev
, p
, request
,
1543 value
, index
, length
, data
);
1549 trace_usb_mtp_stall(dev
->addr
, "unknown control request");
1552 static void usb_mtp_cancel_packet(USBDevice
*dev
, USBPacket
*p
)
1554 /* we don't use async packets, so this should never be called */
1555 fprintf(stderr
, "%s\n", __func__
);
1558 static char *utf16_to_str(uint8_t len
, uint8_t *str16
)
1560 wchar_t *wstr
= g_new0(wchar_t, len
+ 1);
1564 for (count
= 0; count
< len
; count
++) {
1565 /* FIXME: not working for surrogate pairs */
1566 wstr
[count
] = lduw_le_p(str16
+ (count
* 2));
1570 dlen
= wcstombs(NULL
, wstr
, 0) + 1;
1571 dest
= g_malloc(dlen
);
1572 wcstombs(dest
, wstr
, dlen
);
1577 /* Wrapper around write, returns 0 on failure */
1578 static uint64_t write_retry(int fd
, void *buf
, uint64_t size
, off_t offset
)
1582 if (lseek(fd
, offset
, SEEK_SET
) < 0) {
1586 ret
= qemu_write_full(fd
, buf
, size
);
1592 static int usb_mtp_update_object(MTPObject
*parent
, char *name
)
1597 usb_mtp_object_lookup_name(parent
, name
, strlen(name
));
1600 ret
= lstat(o
->path
, &o
->stat
);
1606 static void usb_mtp_write_data(MTPState
*s
, uint32_t handle
)
1608 MTPData
*d
= s
->data_out
;
1610 usb_mtp_object_lookup(s
, s
->dataset
.parent_handle
);
1618 switch (d
->write_status
) {
1620 if (!parent
|| !s
->write_pending
) {
1621 usb_mtp_queue_result(s
, RES_INVALID_OBJECTINFO
, d
->trans
,
1626 if (s
->dataset
.filename
) {
1627 path
= g_strdup_printf("%s/%s", parent
->path
, s
->dataset
.filename
);
1628 if (s
->dataset
.format
== FMT_ASSOCIATION
) {
1629 ret
= mkdir(path
, mask
);
1631 usb_mtp_queue_result(s
, RES_OK
, d
->trans
, 3,
1633 s
->dataset
.parent_handle
,
1640 d
->fd
= open(path
, O_CREAT
| O_WRONLY
|
1641 O_CLOEXEC
| O_NOFOLLOW
, mask
);
1647 /* Return success if initiator sent 0 sized data */
1648 if (!s
->dataset
.size
) {
1651 if (d
->length
!= MTP_WRITE_BUF_SZ
&& !d
->pending
) {
1652 d
->write_status
= WRITE_END
;
1656 case WRITE_CONTINUE
:
1658 rc
= write_retry(d
->fd
, d
->data
, d
->data_offset
,
1659 d
->offset
- d
->data_offset
);
1660 if (rc
!= d
->data_offset
) {
1664 if (d
->write_status
!= WRITE_END
) {
1669 * Return an incomplete transfer if file size doesn't match
1670 * for < 4G file or if lstat fails which will result in an incorrect
1673 if ((s
->dataset
.size
!= 0xFFFFFFFF &&
1674 d
->offset
!= s
->dataset
.size
) ||
1675 usb_mtp_update_object(parent
, s
->dataset
.filename
)) {
1676 usb_mtp_queue_result(s
, RES_INCOMPLETE_TRANSFER
, d
->trans
,
1685 usb_mtp_queue_result(s
, RES_STORE_FULL
, d
->trans
,
1688 usb_mtp_queue_result(s
, RES_OK
, d
->trans
,
1693 * The write dataset is kept around and freed only
1694 * on success or if another write request comes in
1700 g_free(s
->dataset
.filename
);
1701 s
->dataset
.size
= 0;
1703 s
->write_pending
= false;
1706 static void usb_mtp_write_metadata(MTPState
*s
, uint64_t dlen
)
1708 MTPData
*d
= s
->data_out
;
1709 ObjectInfo
*dataset
= (ObjectInfo
*)d
->data
;
1712 MTPObject
*p
= usb_mtp_object_lookup(s
, s
->dataset
.parent_handle
);
1713 uint32_t next_handle
= s
->next_handle
;
1714 size_t filename_chars
= dlen
- offsetof(ObjectInfo
, filename
);
1717 * filename is utf-16. We're intentionally doing
1718 * integer division to truncate if malicious guest
1719 * sent an odd number of bytes.
1721 filename_chars
/= 2;
1723 assert(!s
->write_pending
);
1726 filename
= utf16_to_str(MIN(dataset
->length
, filename_chars
),
1729 if (strchr(filename
, '/')) {
1730 usb_mtp_queue_result(s
, RES_PARAMETER_NOT_SUPPORTED
, d
->trans
,
1736 o
= usb_mtp_object_lookup_name(p
, filename
, -1);
1738 next_handle
= o
->handle
;
1741 s
->dataset
.filename
= filename
;
1742 s
->dataset
.format
= dataset
->format
;
1743 s
->dataset
.size
= dataset
->size
;
1744 s
->write_pending
= true;
1746 if (s
->dataset
.format
== FMT_ASSOCIATION
) {
1747 usb_mtp_write_data(s
, next_handle
);
1749 usb_mtp_queue_result(s
, RES_OK
, d
->trans
, 3, QEMU_STORAGE_ID
,
1750 s
->dataset
.parent_handle
, next_handle
);
1754 static void usb_mtp_get_data(MTPState
*s
, mtp_container
*container
,
1757 MTPData
*d
= s
->data_out
;
1759 uint32_t data_len
= p
->iov
.size
;
1763 usb_mtp_queue_result(s
, RES_INVALID_OBJECTINFO
, 0,
1768 /* Total length of incoming data */
1769 total_len
= cpu_to_le32(container
->length
) - sizeof(mtp_container
);
1770 /* Length of data in this packet */
1771 data_len
-= sizeof(mtp_container
);
1772 if (total_len
< MTP_WRITE_BUF_SZ
) {
1773 usb_mtp_realloc(d
, total_len
);
1774 d
->length
+= total_len
;
1776 usb_mtp_realloc(d
, MTP_WRITE_BUF_SZ
- sizeof(mtp_container
));
1777 d
->length
+= MTP_WRITE_BUF_SZ
- sizeof(mtp_container
);
1783 d
->write_status
= WRITE_START
;
1787 memset(d
->data
, 0, d
->length
);
1788 if (d
->length
!= MTP_WRITE_BUF_SZ
) {
1789 usb_mtp_realloc(d
, MTP_WRITE_BUF_SZ
- d
->length
);
1790 d
->length
+= (MTP_WRITE_BUF_SZ
- d
->length
);
1793 d
->write_status
= WRITE_CONTINUE
;
1797 if (d
->length
- d
->data_offset
> data_len
) {
1800 dlen
= d
->length
- d
->data_offset
;
1804 case CMD_SEND_OBJECT_INFO
:
1805 usb_packet_copy(p
, d
->data
+ d
->data_offset
, dlen
);
1807 d
->data_offset
+= dlen
;
1808 if (d
->data_offset
== d
->length
) {
1809 /* The operation might have already failed */
1811 usb_mtp_write_metadata(s
, dlen
);
1813 usb_mtp_data_free(s
->data_out
);
1818 case CMD_SEND_OBJECT
:
1819 usb_packet_copy(p
, d
->data
+ d
->data_offset
, dlen
);
1821 d
->data_offset
+= dlen
;
1822 if ((p
->iov
.size
% 64) || !p
->iov
.size
) {
1823 assert((s
->dataset
.size
== 0xFFFFFFFF) ||
1824 (s
->dataset
.size
== d
->offset
));
1826 if (d
->length
== MTP_WRITE_BUF_SZ
) {
1827 d
->write_status
= WRITE_END
;
1829 d
->write_status
= WRITE_START
;
1831 usb_mtp_write_data(s
, 0);
1832 usb_mtp_data_free(s
->data_out
);
1836 if (d
->data_offset
== d
->length
) {
1838 usb_mtp_write_data(s
, 0);
1842 p
->status
= USB_RET_STALL
;
1847 static void usb_mtp_handle_data(USBDevice
*dev
, USBPacket
*p
)
1849 MTPState
*s
= USB_MTP(dev
);
1851 mtp_container container
;
1853 uint16_t container_type
;
1856 switch (p
->ep
->nr
) {
1858 if (s
->data_out
!= NULL
) {
1860 trace_usb_mtp_stall(s
->dev
.addr
, "awaiting data-out");
1861 p
->status
= USB_RET_STALL
;
1864 if (p
->iov
.size
< sizeof(container
)) {
1865 trace_usb_mtp_stall(s
->dev
.addr
, "packet too small");
1866 p
->status
= USB_RET_STALL
;
1869 if (s
->data_in
!= NULL
) {
1870 MTPData
*d
= s
->data_in
;
1871 uint64_t dlen
= d
->length
- d
->offset
;
1873 trace_usb_mtp_data_in(s
->dev
.addr
, d
->trans
, d
->length
);
1874 if (d
->length
+ sizeof(container
) > 0xFFFFFFFF) {
1875 container
.length
= cpu_to_le32(0xFFFFFFFF);
1878 cpu_to_le32(d
->length
+ sizeof(container
));
1880 container
.type
= cpu_to_le16(TYPE_DATA
);
1881 container
.code
= cpu_to_le16(d
->code
);
1882 container
.trans
= cpu_to_le32(d
->trans
);
1883 usb_packet_copy(p
, &container
, sizeof(container
));
1885 if (dlen
> p
->iov
.size
- sizeof(container
)) {
1886 dlen
= p
->iov
.size
- sizeof(container
);
1889 if (dlen
> p
->iov
.size
) {
1894 usb_packet_copy(p
, d
->data
+ d
->offset
, dlen
);
1896 if (d
->alloc
< p
->iov
.size
) {
1897 d
->alloc
= p
->iov
.size
;
1898 d
->data
= g_realloc(d
->data
, d
->alloc
);
1900 rc
= read(d
->fd
, d
->data
, dlen
);
1902 memset(d
->data
, 0, dlen
);
1903 s
->result
->code
= RES_INCOMPLETE_TRANSFER
;
1905 usb_packet_copy(p
, d
->data
, dlen
);
1908 if (d
->offset
== d
->length
) {
1909 usb_mtp_data_free(s
->data_in
);
1912 } else if (s
->result
!= NULL
) {
1913 MTPControl
*r
= s
->result
;
1914 int length
= sizeof(container
) + r
->argc
* sizeof(uint32_t);
1915 if (r
->code
== RES_OK
) {
1916 trace_usb_mtp_success(s
->dev
.addr
, r
->trans
,
1917 (r
->argc
> 0) ? r
->argv
[0] : 0,
1918 (r
->argc
> 1) ? r
->argv
[1] : 0);
1920 trace_usb_mtp_error(s
->dev
.addr
, r
->code
, r
->trans
,
1921 (r
->argc
> 0) ? r
->argv
[0] : 0,
1922 (r
->argc
> 1) ? r
->argv
[1] : 0);
1924 container
.length
= cpu_to_le32(length
);
1925 container
.type
= cpu_to_le16(TYPE_RESPONSE
);
1926 container
.code
= cpu_to_le16(r
->code
);
1927 container
.trans
= cpu_to_le32(r
->trans
);
1928 for (i
= 0; i
< r
->argc
; i
++) {
1929 params
[i
] = cpu_to_le32(r
->argv
[i
]);
1931 usb_packet_copy(p
, &container
, sizeof(container
));
1932 usb_packet_copy(p
, ¶ms
, length
- sizeof(container
));
1938 if (p
->iov
.size
< sizeof(container
)) {
1939 trace_usb_mtp_stall(s
->dev
.addr
, "packet too small");
1940 p
->status
= USB_RET_STALL
;
1943 if ((s
->data_out
!= NULL
) && !s
->data_out
->first
) {
1944 container_type
= TYPE_DATA
;
1946 usb_packet_copy(p
, &container
, sizeof(container
));
1947 container_type
= le16_to_cpu(container
.type
);
1949 switch (container_type
) {
1951 if (s
->data_in
|| s
->data_out
|| s
->result
) {
1952 trace_usb_mtp_stall(s
->dev
.addr
, "transaction inflight");
1953 p
->status
= USB_RET_STALL
;
1956 cmd
.code
= le16_to_cpu(container
.code
);
1957 cmd
.argc
= (le32_to_cpu(container
.length
) - sizeof(container
))
1959 cmd
.trans
= le32_to_cpu(container
.trans
);
1960 if (cmd
.argc
> ARRAY_SIZE(cmd
.argv
)) {
1961 cmd
.argc
= ARRAY_SIZE(cmd
.argv
);
1963 if (p
->iov
.size
< sizeof(container
) + cmd
.argc
* sizeof(uint32_t)) {
1964 trace_usb_mtp_stall(s
->dev
.addr
, "packet too small");
1965 p
->status
= USB_RET_STALL
;
1968 usb_packet_copy(p
, ¶ms
, cmd
.argc
* sizeof(uint32_t));
1969 for (i
= 0; i
< cmd
.argc
; i
++) {
1970 cmd
.argv
[i
] = le32_to_cpu(params
[i
]);
1972 trace_usb_mtp_command(s
->dev
.addr
, cmd
.code
, cmd
.trans
,
1973 (cmd
.argc
> 0) ? cmd
.argv
[0] : 0,
1974 (cmd
.argc
> 1) ? cmd
.argv
[1] : 0,
1975 (cmd
.argc
> 2) ? cmd
.argv
[2] : 0,
1976 (cmd
.argc
> 3) ? cmd
.argv
[3] : 0,
1977 (cmd
.argc
> 4) ? cmd
.argv
[4] : 0);
1978 usb_mtp_command(s
, &cmd
);
1981 /* One of the previous transfers has already errored but the
1982 * responder is still sending data associated with it
1984 if (s
->result
!= NULL
) {
1987 usb_mtp_get_data(s
, &container
, p
);
1990 /* not needed as long as the mtp device is read-only */
1991 p
->status
= USB_RET_STALL
;
1996 if (!QTAILQ_EMPTY(&s
->events
)) {
1997 struct MTPMonEntry
*e
= QTAILQ_LAST(&s
->events
);
1999 int len
= sizeof(container
) + sizeof(uint32_t);
2001 if (p
->iov
.size
< len
) {
2002 trace_usb_mtp_stall(s
->dev
.addr
,
2003 "packet too small to send event");
2004 p
->status
= USB_RET_STALL
;
2008 QTAILQ_REMOVE(&s
->events
, e
, next
);
2009 container
.length
= cpu_to_le32(len
);
2010 container
.type
= cpu_to_le32(TYPE_EVENT
);
2011 container
.code
= cpu_to_le16(e
->event
);
2012 container
.trans
= 0; /* no trans specific events */
2013 handle
= cpu_to_le32(e
->handle
);
2014 usb_packet_copy(p
, &container
, sizeof(container
));
2015 usb_packet_copy(p
, &handle
, sizeof(uint32_t));
2019 p
->status
= USB_RET_NAK
;
2022 trace_usb_mtp_stall(s
->dev
.addr
, "invalid endpoint");
2023 p
->status
= USB_RET_STALL
;
2027 if (p
->actual_length
== 0) {
2028 trace_usb_mtp_nak(s
->dev
.addr
, p
->ep
->nr
);
2029 p
->status
= USB_RET_NAK
;
2032 trace_usb_mtp_xfer(s
->dev
.addr
, p
->ep
->nr
, p
->actual_length
,
2038 static void usb_mtp_realize(USBDevice
*dev
, Error
**errp
)
2040 MTPState
*s
= USB_MTP(dev
);
2042 if ((s
->root
== NULL
) || !g_path_is_absolute(s
->root
)) {
2043 error_setg(errp
, "usb-mtp: rootdir must be configured and be an absolute path");
2047 if (access(s
->root
, R_OK
) != 0) {
2048 error_setg(errp
, "usb-mtp: rootdir does not exist/not readable");
2050 } else if (!s
->readonly
&& access(s
->root
, W_OK
) != 0) {
2051 error_setg(errp
, "usb-mtp: rootdir does not have write permissions");
2055 /* Mark store as RW */
2057 s
->flags
|= (1 << MTP_FLAG_WRITABLE
);
2060 if (s
->desc
== NULL
) {
2062 * This does not check if path exists
2063 * but we have the checks above
2065 s
->desc
= g_path_get_basename(s
->root
);
2068 usb_desc_create_serial(dev
);
2070 QTAILQ_INIT(&s
->objects
);
2074 static const VMStateDescription vmstate_usb_mtp
= {
2078 .minimum_version_id
= 1,
2079 .fields
= (VMStateField
[]) {
2080 VMSTATE_USB_DEVICE(dev
, MTPState
),
2081 VMSTATE_END_OF_LIST()
2085 static Property mtp_properties
[] = {
2086 DEFINE_PROP_STRING("rootdir", MTPState
, root
),
2087 DEFINE_PROP_STRING("desc", MTPState
, desc
),
2088 DEFINE_PROP_BOOL("readonly", MTPState
, readonly
, true),
2089 DEFINE_PROP_END_OF_LIST(),
2092 static void usb_mtp_class_initfn(ObjectClass
*klass
, void *data
)
2094 DeviceClass
*dc
= DEVICE_CLASS(klass
);
2095 USBDeviceClass
*uc
= USB_DEVICE_CLASS(klass
);
2097 uc
->realize
= usb_mtp_realize
;
2098 uc
->product_desc
= "QEMU USB MTP";
2099 uc
->usb_desc
= &desc
;
2100 uc
->cancel_packet
= usb_mtp_cancel_packet
;
2101 uc
->handle_attach
= usb_desc_attach
;
2102 uc
->handle_reset
= usb_mtp_handle_reset
;
2103 uc
->handle_control
= usb_mtp_handle_control
;
2104 uc
->handle_data
= usb_mtp_handle_data
;
2105 set_bit(DEVICE_CATEGORY_STORAGE
, dc
->categories
);
2106 dc
->desc
= "USB Media Transfer Protocol device";
2107 dc
->fw_name
= "mtp";
2108 dc
->vmsd
= &vmstate_usb_mtp
;
2109 device_class_set_props(dc
, mtp_properties
);
2112 static TypeInfo mtp_info
= {
2113 .name
= TYPE_USB_MTP
,
2114 .parent
= TYPE_USB_DEVICE
,
2115 .instance_size
= sizeof(MTPState
),
2116 .class_init
= usb_mtp_class_initfn
,
2119 static void usb_mtp_register_types(void)
2121 type_register_static(&mtp_info
);
2124 type_init(usb_mtp_register_types
)