• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4 
5 #include "dbus/message.h"
6 
7 #include <string>
8 
9 #include "base/basictypes.h"
10 #include "base/format_macros.h"
11 #include "base/logging.h"
12 #include "base/strings/string_util.h"
13 #include "base/strings/stringprintf.h"
14 #include "dbus/object_path.h"
15 
16 #if defined(USE_SYSTEM_PROTOBUF)
17 #include <google/protobuf/message_lite.h>
18 #else
19 #include "third_party/protobuf/src/google/protobuf/message_lite.h"
20 #endif
21 
22 namespace {
23 
24 // Appends the header name and the value to |output|, if the value is
25 // not empty.
AppendStringHeader(const std::string & header_name,const std::string & header_value,std::string * output)26 void AppendStringHeader(const std::string& header_name,
27                         const std::string& header_value,
28                         std::string* output) {
29   if (!header_value.empty()) {
30     *output += header_name + ": " + header_value + "\n";
31   }
32 }
33 
34 // Appends the header name and the value to |output|, if the value is
35 // nonzero.
AppendUint32Header(const std::string & header_name,uint32 header_value,std::string * output)36 void AppendUint32Header(const std::string& header_name,
37                         uint32 header_value,
38                         std::string* output) {
39   if (header_value != 0) {
40     *output += (header_name + ": " + base::StringPrintf("%u", header_value) +
41                 "\n");
42   }
43 }
44 
45 }  // namespace
46 
47 namespace dbus {
48 
IsDBusTypeUnixFdSupported()49 bool IsDBusTypeUnixFdSupported() {
50   int major = 0, minor = 0, micro = 0;
51   dbus_get_version(&major, &minor, &micro);
52   return major >= 1 && minor >= 4;
53 }
54 
Message()55 Message::Message()
56     : raw_message_(NULL) {
57 }
58 
~Message()59 Message::~Message() {
60   if (raw_message_)
61     dbus_message_unref(raw_message_);
62 }
63 
Init(DBusMessage * raw_message)64 void Message::Init(DBusMessage* raw_message) {
65   DCHECK(!raw_message_);
66   raw_message_ = raw_message;
67 }
68 
GetMessageType()69 Message::MessageType Message::GetMessageType() {
70   if (!raw_message_)
71     return MESSAGE_INVALID;
72   const int type = dbus_message_get_type(raw_message_);
73   return static_cast<Message::MessageType>(type);
74 }
75 
GetMessageTypeAsString()76 std::string Message::GetMessageTypeAsString() {
77   switch (GetMessageType()) {
78     case MESSAGE_INVALID:
79       return "MESSAGE_INVALID";
80     case MESSAGE_METHOD_CALL:
81       return "MESSAGE_METHOD_CALL";
82     case MESSAGE_METHOD_RETURN:
83       return "MESSAGE_METHOD_RETURN";
84     case MESSAGE_SIGNAL:
85       return "MESSAGE_SIGNAL";
86     case MESSAGE_ERROR:
87       return "MESSAGE_ERROR";
88   }
89   NOTREACHED();
90   return std::string();
91 }
92 
ToStringInternal(const std::string & indent,MessageReader * reader)93 std::string Message::ToStringInternal(const std::string& indent,
94                                       MessageReader* reader) {
95   const char* kBrokenMessage = "[broken message]";
96   std::string output;
97   while (reader->HasMoreData()) {
98     const DataType type = reader->GetDataType();
99     switch (type) {
100       case BYTE: {
101         uint8 value = 0;
102         if (!reader->PopByte(&value))
103           return kBrokenMessage;
104         output += indent + "byte " + base::StringPrintf("%d", value) + "\n";
105         break;
106       }
107       case BOOL: {
108         bool value = false;
109         if (!reader->PopBool(&value))
110           return kBrokenMessage;
111         output += indent + "bool " + (value ? "true" : "false") + "\n";
112         break;
113       }
114       case INT16: {
115         int16 value = 0;
116         if (!reader->PopInt16(&value))
117           return kBrokenMessage;
118         output += indent + "int16 " + base::StringPrintf("%d", value) + "\n";
119         break;
120       }
121       case UINT16: {
122         uint16 value = 0;
123         if (!reader->PopUint16(&value))
124           return kBrokenMessage;
125         output += indent + "uint16 " + base::StringPrintf("%d", value) + "\n";
126         break;
127       }
128       case INT32: {
129         int32 value = 0;
130         if (!reader->PopInt32(&value))
131           return kBrokenMessage;
132         output += indent + "int32 " + base::StringPrintf("%d", value) + "\n";
133         break;
134       }
135       case UINT32: {
136         uint32 value = 0;
137         if (!reader->PopUint32(&value))
138           return kBrokenMessage;
139         output += indent + "uint32 " + base::StringPrintf("%u", value) + "\n";
140         break;
141       }
142       case INT64: {
143         int64 value = 0;
144         if (!reader->PopInt64(&value))
145           return kBrokenMessage;
146         output += (indent + "int64 " +
147                    base::StringPrintf("%" PRId64, value) + "\n");
148         break;
149       }
150       case UINT64: {
151         uint64 value = 0;
152         if (!reader->PopUint64(&value))
153           return kBrokenMessage;
154         output += (indent + "uint64 " +
155                    base::StringPrintf("%" PRIu64, value) + "\n");
156         break;
157       }
158       case DOUBLE: {
159         double value = 0;
160         if (!reader->PopDouble(&value))
161           return kBrokenMessage;
162         output += indent + "double " + base::StringPrintf("%f", value) + "\n";
163         break;
164       }
165       case STRING: {
166         std::string value;
167         if (!reader->PopString(&value))
168           return kBrokenMessage;
169         // Truncate if the string is longer than the limit.
170         const size_t kTruncateLength = 100;
171         if (value.size() < kTruncateLength) {
172           output += indent + "string \"" + value + "\"\n";
173         } else {
174           std::string truncated;
175           base::TruncateUTF8ToByteSize(value, kTruncateLength, &truncated);
176           base::StringAppendF(&truncated, "... (%" PRIuS " bytes in total)",
177                               value.size());
178           output += indent + "string \"" + truncated + "\"\n";
179         }
180         break;
181       }
182       case OBJECT_PATH: {
183         ObjectPath value;
184         if (!reader->PopObjectPath(&value))
185           return kBrokenMessage;
186         output += indent + "object_path \"" + value.value() + "\"\n";
187         break;
188       }
189       case ARRAY: {
190         MessageReader sub_reader(this);
191         if (!reader->PopArray(&sub_reader))
192           return kBrokenMessage;
193         output += indent + "array [\n";
194         output += ToStringInternal(indent + "  ", &sub_reader);
195         output += indent + "]\n";
196         break;
197       }
198       case STRUCT: {
199         MessageReader sub_reader(this);
200         if (!reader->PopStruct(&sub_reader))
201           return kBrokenMessage;
202         output += indent + "struct {\n";
203         output += ToStringInternal(indent + "  ", &sub_reader);
204         output += indent + "}\n";
205         break;
206       }
207       case DICT_ENTRY: {
208         MessageReader sub_reader(this);
209         if (!reader->PopDictEntry(&sub_reader))
210           return kBrokenMessage;
211         output += indent + "dict entry {\n";
212         output += ToStringInternal(indent + "  ", &sub_reader);
213         output += indent + "}\n";
214         break;
215       }
216       case VARIANT: {
217         MessageReader sub_reader(this);
218         if (!reader->PopVariant(&sub_reader))
219           return kBrokenMessage;
220         output += indent + "variant ";
221         output += ToStringInternal(indent + "  ", &sub_reader);
222         break;
223       }
224       case UNIX_FD: {
225         CHECK(IsDBusTypeUnixFdSupported());
226 
227         FileDescriptor file_descriptor;
228         if (!reader->PopFileDescriptor(&file_descriptor))
229           return kBrokenMessage;
230         output += indent + "fd#" +
231                   base::StringPrintf("%d", file_descriptor.value()) + "\n";
232         break;
233       }
234       default:
235         LOG(FATAL) << "Unknown type: " << type;
236     }
237   }
238   return output;
239 }
240 
241 // The returned string consists of message headers such as
242 // destination if any, followed by a blank line, and the message
243 // payload. For example, a MethodCall's ToString() will look like:
244 //
245 // destination: com.example.Service
246 // path: /com/example/Object
247 // interface: com.example.Interface
248 // member: SomeMethod
249 //
250 // string \"payload\"
251 // ...
ToString()252 std::string Message::ToString() {
253   if (!raw_message_)
254     return std::string();
255 
256   // Generate headers first.
257   std::string headers;
258   AppendStringHeader("message_type", GetMessageTypeAsString(), &headers);
259   AppendStringHeader("destination", GetDestination(), &headers);
260   AppendStringHeader("path", GetPath().value(), &headers);
261   AppendStringHeader("interface", GetInterface(), &headers);
262   AppendStringHeader("member", GetMember(), &headers);
263   AppendStringHeader("error_name", GetErrorName(), &headers);
264   AppendStringHeader("sender", GetSender(), &headers);
265   AppendStringHeader("signature", GetSignature(), &headers);
266   AppendUint32Header("serial", GetSerial(), &headers);
267   AppendUint32Header("reply_serial", GetReplySerial(), &headers);
268 
269   // Generate the payload.
270   MessageReader reader(this);
271   return headers + "\n" + ToStringInternal(std::string(), &reader);
272 }
273 
SetDestination(const std::string & destination)274 bool Message::SetDestination(const std::string& destination) {
275   return dbus_message_set_destination(raw_message_, destination.c_str());
276 }
277 
SetPath(const ObjectPath & path)278 bool Message::SetPath(const ObjectPath& path) {
279   return dbus_message_set_path(raw_message_, path.value().c_str());
280 }
281 
SetInterface(const std::string & interface)282 bool Message::SetInterface(const std::string& interface) {
283   return dbus_message_set_interface(raw_message_, interface.c_str());
284 }
285 
SetMember(const std::string & member)286 bool Message::SetMember(const std::string& member) {
287   return dbus_message_set_member(raw_message_, member.c_str());
288 }
289 
SetErrorName(const std::string & error_name)290 bool Message::SetErrorName(const std::string& error_name) {
291   return dbus_message_set_error_name(raw_message_, error_name.c_str());
292 }
293 
SetSender(const std::string & sender)294 bool Message::SetSender(const std::string& sender) {
295   return dbus_message_set_sender(raw_message_, sender.c_str());
296 }
297 
SetSerial(uint32 serial)298 void Message::SetSerial(uint32 serial) {
299   dbus_message_set_serial(raw_message_, serial);
300 }
301 
SetReplySerial(uint32 reply_serial)302 void Message::SetReplySerial(uint32 reply_serial) {
303   dbus_message_set_reply_serial(raw_message_, reply_serial);
304 }
305 
GetDestination()306 std::string Message::GetDestination() {
307   const char* destination = dbus_message_get_destination(raw_message_);
308   return destination ? destination : "";
309 }
310 
GetPath()311 ObjectPath Message::GetPath() {
312   const char* path = dbus_message_get_path(raw_message_);
313   return ObjectPath(path ? path : "");
314 }
315 
GetInterface()316 std::string Message::GetInterface() {
317   const char* interface = dbus_message_get_interface(raw_message_);
318   return interface ? interface : "";
319 }
320 
GetMember()321 std::string Message::GetMember() {
322   const char* member = dbus_message_get_member(raw_message_);
323   return member ? member : "";
324 }
325 
GetErrorName()326 std::string Message::GetErrorName() {
327   const char* error_name = dbus_message_get_error_name(raw_message_);
328   return error_name ? error_name : "";
329 }
330 
GetSender()331 std::string Message::GetSender() {
332   const char* sender = dbus_message_get_sender(raw_message_);
333   return sender ? sender : "";
334 }
335 
GetSignature()336 std::string Message::GetSignature() {
337   const char* signature = dbus_message_get_signature(raw_message_);
338   return signature ? signature : "";
339 }
340 
GetSerial()341 uint32 Message::GetSerial() {
342   return dbus_message_get_serial(raw_message_);
343 }
344 
GetReplySerial()345 uint32 Message::GetReplySerial() {
346   return dbus_message_get_reply_serial(raw_message_);
347 }
348 
349 //
350 // MethodCall implementation.
351 //
352 
MethodCall(const std::string & interface_name,const std::string & method_name)353 MethodCall::MethodCall(const std::string& interface_name,
354                        const std::string& method_name)
355     : Message() {
356   Init(dbus_message_new(DBUS_MESSAGE_TYPE_METHOD_CALL));
357 
358   CHECK(SetInterface(interface_name));
359   CHECK(SetMember(method_name));
360 }
361 
MethodCall()362 MethodCall::MethodCall() : Message() {
363 }
364 
FromRawMessage(DBusMessage * raw_message)365 MethodCall* MethodCall::FromRawMessage(DBusMessage* raw_message) {
366   DCHECK_EQ(DBUS_MESSAGE_TYPE_METHOD_CALL, dbus_message_get_type(raw_message));
367 
368   MethodCall* method_call = new MethodCall;
369   method_call->Init(raw_message);
370   return method_call;
371 }
372 
373 //
374 // Signal implementation.
375 //
Signal(const std::string & interface_name,const std::string & method_name)376 Signal::Signal(const std::string& interface_name,
377                const std::string& method_name)
378     : Message() {
379   Init(dbus_message_new(DBUS_MESSAGE_TYPE_SIGNAL));
380 
381   CHECK(SetInterface(interface_name));
382   CHECK(SetMember(method_name));
383 }
384 
Signal()385 Signal::Signal() : Message() {
386 }
387 
FromRawMessage(DBusMessage * raw_message)388 Signal* Signal::FromRawMessage(DBusMessage* raw_message) {
389   DCHECK_EQ(DBUS_MESSAGE_TYPE_SIGNAL, dbus_message_get_type(raw_message));
390 
391   Signal* signal = new Signal;
392   signal->Init(raw_message);
393   return signal;
394 }
395 
396 //
397 // Response implementation.
398 //
399 
Response()400 Response::Response() : Message() {
401 }
402 
FromRawMessage(DBusMessage * raw_message)403 scoped_ptr<Response> Response::FromRawMessage(DBusMessage* raw_message) {
404   DCHECK_EQ(DBUS_MESSAGE_TYPE_METHOD_RETURN,
405             dbus_message_get_type(raw_message));
406 
407   scoped_ptr<Response> response(new Response);
408   response->Init(raw_message);
409   return response.Pass();
410 }
411 
FromMethodCall(MethodCall * method_call)412 scoped_ptr<Response> Response::FromMethodCall(MethodCall* method_call) {
413   scoped_ptr<Response> response(new Response);
414   response->Init(dbus_message_new_method_return(method_call->raw_message()));
415   return response.Pass();
416 }
417 
CreateEmpty()418 scoped_ptr<Response> Response::CreateEmpty() {
419   scoped_ptr<Response> response(new Response);
420   response->Init(dbus_message_new(DBUS_MESSAGE_TYPE_METHOD_RETURN));
421   return response.Pass();
422 }
423 
424 //
425 // ErrorResponse implementation.
426 //
427 
ErrorResponse()428 ErrorResponse::ErrorResponse() : Response() {
429 }
430 
FromRawMessage(DBusMessage * raw_message)431 scoped_ptr<ErrorResponse> ErrorResponse::FromRawMessage(
432     DBusMessage* raw_message) {
433   DCHECK_EQ(DBUS_MESSAGE_TYPE_ERROR, dbus_message_get_type(raw_message));
434 
435   scoped_ptr<ErrorResponse> response(new ErrorResponse);
436   response->Init(raw_message);
437   return response.Pass();
438 }
439 
FromMethodCall(MethodCall * method_call,const std::string & error_name,const std::string & error_message)440 scoped_ptr<ErrorResponse> ErrorResponse::FromMethodCall(
441     MethodCall* method_call,
442     const std::string& error_name,
443     const std::string& error_message) {
444   scoped_ptr<ErrorResponse> response(new ErrorResponse);
445   response->Init(dbus_message_new_error(method_call->raw_message(),
446                                         error_name.c_str(),
447                                         error_message.c_str()));
448   return response.Pass();
449 }
450 
451 //
452 // MessageWriter implementation.
453 //
454 
MessageWriter(Message * message)455 MessageWriter::MessageWriter(Message* message)
456     : message_(message),
457       container_is_open_(false) {
458   memset(&raw_message_iter_, 0, sizeof(raw_message_iter_));
459   if (message)
460     dbus_message_iter_init_append(message_->raw_message(), &raw_message_iter_);
461 }
462 
~MessageWriter()463 MessageWriter::~MessageWriter() {
464 }
465 
AppendByte(uint8 value)466 void MessageWriter::AppendByte(uint8 value) {
467   AppendBasic(DBUS_TYPE_BYTE, &value);
468 }
469 
AppendBool(bool value)470 void MessageWriter::AppendBool(bool value) {
471   // The size of dbus_bool_t and the size of bool are different. The
472   // former is always 4 per dbus-types.h, whereas the latter is usually 1.
473   // dbus_message_iter_append_basic() used in AppendBasic() expects four
474   // bytes for DBUS_TYPE_BOOLEAN, so we must pass a dbus_bool_t, instead
475   // of a bool, to AppendBasic().
476   dbus_bool_t dbus_value = value;
477   AppendBasic(DBUS_TYPE_BOOLEAN, &dbus_value);
478 }
479 
AppendInt16(int16 value)480 void MessageWriter::AppendInt16(int16 value) {
481   AppendBasic(DBUS_TYPE_INT16, &value);
482 }
483 
AppendUint16(uint16 value)484 void MessageWriter::AppendUint16(uint16 value) {
485   AppendBasic(DBUS_TYPE_UINT16, &value);
486 }
487 
AppendInt32(int32 value)488 void MessageWriter::AppendInt32(int32 value) {
489   AppendBasic(DBUS_TYPE_INT32, &value);
490 }
491 
AppendUint32(uint32 value)492 void MessageWriter::AppendUint32(uint32 value) {
493   AppendBasic(DBUS_TYPE_UINT32, &value);
494 }
495 
AppendInt64(int64 value)496 void MessageWriter::AppendInt64(int64 value) {
497   AppendBasic(DBUS_TYPE_INT64, &value);
498 }
499 
AppendUint64(uint64 value)500 void MessageWriter::AppendUint64(uint64 value) {
501   AppendBasic(DBUS_TYPE_UINT64, &value);
502 }
503 
AppendDouble(double value)504 void MessageWriter::AppendDouble(double value) {
505   AppendBasic(DBUS_TYPE_DOUBLE, &value);
506 }
507 
AppendString(const std::string & value)508 void MessageWriter::AppendString(const std::string& value) {
509   // D-Bus Specification (0.19) says a string "must be valid UTF-8".
510   CHECK(IsStringUTF8(value));
511   const char* pointer = value.c_str();
512   AppendBasic(DBUS_TYPE_STRING, &pointer);
513   // TODO(satorux): It may make sense to return an error here, as the
514   // input string can be large. If needed, we could add something like
515   // bool AppendStringWithErrorChecking().
516 }
517 
AppendObjectPath(const ObjectPath & value)518 void MessageWriter::AppendObjectPath(const ObjectPath& value) {
519   CHECK(value.IsValid());
520   const char* pointer = value.value().c_str();
521   AppendBasic(DBUS_TYPE_OBJECT_PATH, &pointer);
522 }
523 
524 // Ideally, client shouldn't need to supply the signature string, but
525 // the underlying D-Bus library requires us to supply this before
526 // appending contents to array and variant. It's technically possible
527 // for us to design API that doesn't require the signature but it will
528 // complicate the implementation so we decided to have the signature
529 // parameter. Hopefully, variants are less used in request messages from
530 // client side than response message from server side, so this should
531 // not be a big issue.
OpenArray(const std::string & signature,MessageWriter * writer)532 void MessageWriter::OpenArray(const std::string& signature,
533                               MessageWriter* writer) {
534   DCHECK(!container_is_open_);
535 
536   const bool success = dbus_message_iter_open_container(
537       &raw_message_iter_,
538       DBUS_TYPE_ARRAY,
539       signature.c_str(),
540       &writer->raw_message_iter_);
541   CHECK(success) << "Unable to allocate memory";
542   container_is_open_ = true;
543 }
544 
OpenVariant(const std::string & signature,MessageWriter * writer)545 void MessageWriter::OpenVariant(const std::string& signature,
546                                 MessageWriter* writer) {
547   DCHECK(!container_is_open_);
548 
549   const bool success = dbus_message_iter_open_container(
550       &raw_message_iter_,
551       DBUS_TYPE_VARIANT,
552       signature.c_str(),
553       &writer->raw_message_iter_);
554   CHECK(success) << "Unable to allocate memory";
555   container_is_open_ = true;
556 }
557 
OpenStruct(MessageWriter * writer)558 void MessageWriter::OpenStruct(MessageWriter* writer) {
559   DCHECK(!container_is_open_);
560 
561   const bool success = dbus_message_iter_open_container(
562       &raw_message_iter_,
563       DBUS_TYPE_STRUCT,
564       NULL,  // Signature should be NULL.
565       &writer->raw_message_iter_);
566   CHECK(success) << "Unable to allocate memory";
567   container_is_open_ = true;
568 }
569 
OpenDictEntry(MessageWriter * writer)570 void MessageWriter::OpenDictEntry(MessageWriter* writer) {
571   DCHECK(!container_is_open_);
572 
573   const bool success = dbus_message_iter_open_container(
574       &raw_message_iter_,
575       DBUS_TYPE_DICT_ENTRY,
576       NULL,  // Signature should be NULL.
577       &writer->raw_message_iter_);
578   CHECK(success) << "Unable to allocate memory";
579   container_is_open_ = true;
580 }
581 
CloseContainer(MessageWriter * writer)582 void MessageWriter::CloseContainer(MessageWriter* writer) {
583   DCHECK(container_is_open_);
584 
585   const bool success = dbus_message_iter_close_container(
586       &raw_message_iter_, &writer->raw_message_iter_);
587   CHECK(success) << "Unable to allocate memory";
588   container_is_open_ = false;
589 }
590 
AppendArrayOfBytes(const uint8 * values,size_t length)591 void MessageWriter::AppendArrayOfBytes(const uint8* values, size_t length) {
592   DCHECK(!container_is_open_);
593   MessageWriter array_writer(message_);
594   OpenArray("y", &array_writer);
595   const bool success = dbus_message_iter_append_fixed_array(
596       &(array_writer.raw_message_iter_),
597       DBUS_TYPE_BYTE,
598       &values,
599       static_cast<int>(length));
600   CHECK(success) << "Unable to allocate memory";
601   CloseContainer(&array_writer);
602 }
603 
AppendArrayOfStrings(const std::vector<std::string> & strings)604 void MessageWriter::AppendArrayOfStrings(
605     const std::vector<std::string>& strings) {
606   DCHECK(!container_is_open_);
607   MessageWriter array_writer(message_);
608   OpenArray("s", &array_writer);
609   for (size_t i = 0; i < strings.size(); ++i) {
610     array_writer.AppendString(strings[i]);
611   }
612   CloseContainer(&array_writer);
613 }
614 
AppendArrayOfObjectPaths(const std::vector<ObjectPath> & object_paths)615 void MessageWriter::AppendArrayOfObjectPaths(
616     const std::vector<ObjectPath>& object_paths) {
617   DCHECK(!container_is_open_);
618   MessageWriter array_writer(message_);
619   OpenArray("o", &array_writer);
620   for (size_t i = 0; i < object_paths.size(); ++i) {
621     array_writer.AppendObjectPath(object_paths[i]);
622   }
623   CloseContainer(&array_writer);
624 }
625 
AppendProtoAsArrayOfBytes(const google::protobuf::MessageLite & protobuf)626 bool MessageWriter::AppendProtoAsArrayOfBytes(
627     const google::protobuf::MessageLite& protobuf) {
628   std::string serialized_proto;
629   if (!protobuf.SerializeToString(&serialized_proto)) {
630     LOG(ERROR) << "Unable to serialize supplied protocol buffer";
631     return false;
632   }
633   AppendArrayOfBytes(reinterpret_cast<const uint8*>(serialized_proto.data()),
634                      serialized_proto.size());
635   return true;
636 }
637 
AppendVariantOfByte(uint8 value)638 void MessageWriter::AppendVariantOfByte(uint8 value) {
639   AppendVariantOfBasic(DBUS_TYPE_BYTE, &value);
640 }
641 
AppendVariantOfBool(bool value)642 void MessageWriter::AppendVariantOfBool(bool value) {
643   // See the comment at MessageWriter::AppendBool().
644   dbus_bool_t dbus_value = value;
645   AppendVariantOfBasic(DBUS_TYPE_BOOLEAN, &dbus_value);
646 }
647 
AppendVariantOfInt16(int16 value)648 void MessageWriter::AppendVariantOfInt16(int16 value) {
649   AppendVariantOfBasic(DBUS_TYPE_INT16, &value);
650 }
651 
AppendVariantOfUint16(uint16 value)652 void MessageWriter::AppendVariantOfUint16(uint16 value) {
653   AppendVariantOfBasic(DBUS_TYPE_UINT16, &value);
654 }
655 
AppendVariantOfInt32(int32 value)656 void MessageWriter::AppendVariantOfInt32(int32 value) {
657   AppendVariantOfBasic(DBUS_TYPE_INT32, &value);
658 }
659 
AppendVariantOfUint32(uint32 value)660 void MessageWriter::AppendVariantOfUint32(uint32 value) {
661   AppendVariantOfBasic(DBUS_TYPE_UINT32, &value);
662 }
663 
AppendVariantOfInt64(int64 value)664 void MessageWriter::AppendVariantOfInt64(int64 value) {
665   AppendVariantOfBasic(DBUS_TYPE_INT64, &value);
666 }
667 
AppendVariantOfUint64(uint64 value)668 void MessageWriter::AppendVariantOfUint64(uint64 value) {
669   AppendVariantOfBasic(DBUS_TYPE_UINT64, &value);
670 }
671 
AppendVariantOfDouble(double value)672 void MessageWriter::AppendVariantOfDouble(double value) {
673   AppendVariantOfBasic(DBUS_TYPE_DOUBLE, &value);
674 }
675 
AppendVariantOfString(const std::string & value)676 void MessageWriter::AppendVariantOfString(const std::string& value) {
677   const char* pointer = value.c_str();
678   AppendVariantOfBasic(DBUS_TYPE_STRING, &pointer);
679 }
680 
AppendVariantOfObjectPath(const ObjectPath & value)681 void MessageWriter::AppendVariantOfObjectPath(const ObjectPath& value) {
682   const char* pointer = value.value().c_str();
683   AppendVariantOfBasic(DBUS_TYPE_OBJECT_PATH, &pointer);
684 }
685 
AppendBasic(int dbus_type,const void * value)686 void MessageWriter::AppendBasic(int dbus_type, const void* value) {
687   DCHECK(!container_is_open_);
688 
689   const bool success = dbus_message_iter_append_basic(
690       &raw_message_iter_, dbus_type, value);
691   // dbus_message_iter_append_basic() fails only when there is not enough
692   // memory. We don't return this error as there is nothing we can do when
693   // it fails to allocate memory for a byte etc.
694   CHECK(success) << "Unable to allocate memory";
695 }
696 
AppendVariantOfBasic(int dbus_type,const void * value)697 void MessageWriter::AppendVariantOfBasic(int dbus_type, const void* value) {
698   const std::string signature = base::StringPrintf("%c", dbus_type);
699   MessageWriter variant_writer(message_);
700   OpenVariant(signature, &variant_writer);
701   variant_writer.AppendBasic(dbus_type, value);
702   CloseContainer(&variant_writer);
703 }
704 
AppendFileDescriptor(const FileDescriptor & value)705 void MessageWriter::AppendFileDescriptor(const FileDescriptor& value) {
706   CHECK(IsDBusTypeUnixFdSupported());
707 
708   if (!value.is_valid()) {
709     // NB: sending a directory potentially enables sandbox escape
710     LOG(FATAL) << "Attempt to pass invalid file descriptor";
711   }
712   int fd = value.value();
713   AppendBasic(DBUS_TYPE_UNIX_FD, &fd);
714 }
715 
716 //
717 // MessageReader implementation.
718 //
719 
MessageReader(Message * message)720 MessageReader::MessageReader(Message* message)
721     : message_(message) {
722   memset(&raw_message_iter_, 0, sizeof(raw_message_iter_));
723   if (message)
724     dbus_message_iter_init(message_->raw_message(), &raw_message_iter_);
725 }
726 
727 
~MessageReader()728 MessageReader::~MessageReader() {
729 }
730 
HasMoreData()731 bool MessageReader::HasMoreData() {
732   const int dbus_type = dbus_message_iter_get_arg_type(&raw_message_iter_);
733   return dbus_type != DBUS_TYPE_INVALID;
734 }
735 
PopByte(uint8 * value)736 bool MessageReader::PopByte(uint8* value) {
737   return PopBasic(DBUS_TYPE_BYTE, value);
738 }
739 
PopBool(bool * value)740 bool MessageReader::PopBool(bool* value) {
741   // Like MessageWriter::AppendBool(), we should copy |value| to
742   // dbus_bool_t, as dbus_message_iter_get_basic() used in PopBasic()
743   // expects four bytes for DBUS_TYPE_BOOLEAN.
744   dbus_bool_t dbus_value = FALSE;
745   const bool success = PopBasic(DBUS_TYPE_BOOLEAN, &dbus_value);
746   *value = static_cast<bool>(dbus_value);
747   return success;
748 }
749 
PopInt16(int16 * value)750 bool MessageReader::PopInt16(int16* value) {
751   return PopBasic(DBUS_TYPE_INT16, value);
752 }
753 
PopUint16(uint16 * value)754 bool MessageReader::PopUint16(uint16* value) {
755   return PopBasic(DBUS_TYPE_UINT16, value);
756 }
757 
PopInt32(int32 * value)758 bool MessageReader::PopInt32(int32* value) {
759   return PopBasic(DBUS_TYPE_INT32, value);
760 }
761 
PopUint32(uint32 * value)762 bool MessageReader::PopUint32(uint32* value) {
763   return PopBasic(DBUS_TYPE_UINT32, value);
764 }
765 
PopInt64(int64 * value)766 bool MessageReader::PopInt64(int64* value) {
767   return PopBasic(DBUS_TYPE_INT64, value);
768 }
769 
PopUint64(uint64 * value)770 bool MessageReader::PopUint64(uint64* value) {
771   return PopBasic(DBUS_TYPE_UINT64, value);
772 }
773 
PopDouble(double * value)774 bool MessageReader::PopDouble(double* value) {
775   return PopBasic(DBUS_TYPE_DOUBLE, value);
776 }
777 
PopString(std::string * value)778 bool MessageReader::PopString(std::string* value) {
779   char* tmp_value = NULL;
780   const bool success = PopBasic(DBUS_TYPE_STRING, &tmp_value);
781   if (success)
782     value->assign(tmp_value);
783   return success;
784 }
785 
PopObjectPath(ObjectPath * value)786 bool MessageReader::PopObjectPath(ObjectPath* value) {
787   char* tmp_value = NULL;
788   const bool success = PopBasic(DBUS_TYPE_OBJECT_PATH, &tmp_value);
789   if (success)
790     *value = ObjectPath(tmp_value);
791   return success;
792 }
793 
PopArray(MessageReader * sub_reader)794 bool MessageReader::PopArray(MessageReader* sub_reader) {
795   return PopContainer(DBUS_TYPE_ARRAY, sub_reader);
796 }
797 
PopStruct(MessageReader * sub_reader)798 bool MessageReader::PopStruct(MessageReader* sub_reader) {
799   return PopContainer(DBUS_TYPE_STRUCT, sub_reader);
800 }
801 
PopDictEntry(MessageReader * sub_reader)802 bool MessageReader::PopDictEntry(MessageReader* sub_reader) {
803   return PopContainer(DBUS_TYPE_DICT_ENTRY, sub_reader);
804 }
805 
PopVariant(MessageReader * sub_reader)806 bool MessageReader::PopVariant(MessageReader* sub_reader) {
807   return PopContainer(DBUS_TYPE_VARIANT, sub_reader);
808 }
809 
PopArrayOfBytes(uint8 ** bytes,size_t * length)810 bool MessageReader::PopArrayOfBytes(uint8** bytes, size_t* length) {
811   MessageReader array_reader(message_);
812   if (!PopArray(&array_reader))
813       return false;
814   // An empty array is allowed.
815   if (!array_reader.HasMoreData()) {
816     *length = 0;
817     *bytes = NULL;
818     return true;
819   }
820   if (!array_reader.CheckDataType(DBUS_TYPE_BYTE))
821     return false;
822   int int_length = 0;
823   dbus_message_iter_get_fixed_array(&array_reader.raw_message_iter_,
824                                     bytes,
825                                     &int_length);
826   *length = static_cast<int>(int_length);
827   return true;
828 }
829 
PopArrayOfStrings(std::vector<std::string> * strings)830 bool MessageReader::PopArrayOfStrings(
831     std::vector<std::string> *strings) {
832   MessageReader array_reader(message_);
833   if (!PopArray(&array_reader))
834       return false;
835   while (array_reader.HasMoreData()) {
836     std::string string;
837     if (!array_reader.PopString(&string))
838       return false;
839     strings->push_back(string);
840   }
841   return true;
842 }
843 
PopArrayOfObjectPaths(std::vector<ObjectPath> * object_paths)844 bool MessageReader::PopArrayOfObjectPaths(
845     std::vector<ObjectPath> *object_paths) {
846   MessageReader array_reader(message_);
847   if (!PopArray(&array_reader))
848       return false;
849   while (array_reader.HasMoreData()) {
850     ObjectPath object_path;
851     if (!array_reader.PopObjectPath(&object_path))
852       return false;
853     object_paths->push_back(object_path);
854   }
855   return true;
856 }
857 
PopArrayOfBytesAsProto(google::protobuf::MessageLite * protobuf)858 bool MessageReader::PopArrayOfBytesAsProto(
859     google::protobuf::MessageLite* protobuf) {
860   DCHECK(protobuf != NULL);
861   char* serialized_buf = NULL;
862   size_t buf_size = 0;
863   if (!PopArrayOfBytes(reinterpret_cast<uint8**>(&serialized_buf), &buf_size)) {
864     LOG(ERROR) << "Error reading array of bytes";
865     return false;
866   }
867   if (!protobuf->ParseFromArray(serialized_buf, buf_size)) {
868     LOG(ERROR) << "Failed to parse protocol buffer from array";
869     return false;
870   }
871   return true;
872 }
873 
PopVariantOfByte(uint8 * value)874 bool MessageReader::PopVariantOfByte(uint8* value) {
875   return PopVariantOfBasic(DBUS_TYPE_BYTE, value);
876 }
877 
PopVariantOfBool(bool * value)878 bool MessageReader::PopVariantOfBool(bool* value) {
879   // See the comment at MessageReader::PopBool().
880   dbus_bool_t dbus_value = FALSE;
881   const bool success = PopVariantOfBasic(DBUS_TYPE_BOOLEAN, &dbus_value);
882   *value = static_cast<bool>(dbus_value);
883   return success;
884 }
885 
PopVariantOfInt16(int16 * value)886 bool MessageReader::PopVariantOfInt16(int16* value) {
887   return PopVariantOfBasic(DBUS_TYPE_INT16, value);
888 }
889 
PopVariantOfUint16(uint16 * value)890 bool MessageReader::PopVariantOfUint16(uint16* value) {
891   return PopVariantOfBasic(DBUS_TYPE_UINT16, value);
892 }
893 
PopVariantOfInt32(int32 * value)894 bool MessageReader::PopVariantOfInt32(int32* value) {
895   return PopVariantOfBasic(DBUS_TYPE_INT32, value);
896 }
897 
PopVariantOfUint32(uint32 * value)898 bool MessageReader::PopVariantOfUint32(uint32* value) {
899   return PopVariantOfBasic(DBUS_TYPE_UINT32, value);
900 }
901 
PopVariantOfInt64(int64 * value)902 bool MessageReader::PopVariantOfInt64(int64* value) {
903   return PopVariantOfBasic(DBUS_TYPE_INT64, value);
904 }
905 
PopVariantOfUint64(uint64 * value)906 bool MessageReader::PopVariantOfUint64(uint64* value) {
907   return PopVariantOfBasic(DBUS_TYPE_UINT64, value);
908 }
909 
PopVariantOfDouble(double * value)910 bool MessageReader::PopVariantOfDouble(double* value) {
911   return PopVariantOfBasic(DBUS_TYPE_DOUBLE, value);
912 }
913 
PopVariantOfString(std::string * value)914 bool MessageReader::PopVariantOfString(std::string* value) {
915   char* tmp_value = NULL;
916   const bool success = PopVariantOfBasic(DBUS_TYPE_STRING, &tmp_value);
917   if (success)
918     value->assign(tmp_value);
919   return success;
920 }
921 
PopVariantOfObjectPath(ObjectPath * value)922 bool MessageReader::PopVariantOfObjectPath(ObjectPath* value) {
923   char* tmp_value = NULL;
924   const bool success = PopVariantOfBasic(DBUS_TYPE_OBJECT_PATH, &tmp_value);
925   if (success)
926     *value = ObjectPath(tmp_value);
927   return success;
928 }
929 
GetDataType()930 Message::DataType MessageReader::GetDataType() {
931   const int dbus_type = dbus_message_iter_get_arg_type(&raw_message_iter_);
932   return static_cast<Message::DataType>(dbus_type);
933 }
934 
CheckDataType(int dbus_type)935 bool MessageReader::CheckDataType(int dbus_type) {
936   const int actual_type = dbus_message_iter_get_arg_type(&raw_message_iter_);
937   if (actual_type != dbus_type) {
938     VLOG(1) << "Type " << dbus_type  << " is expected but got "
939             << actual_type;
940     return false;
941   }
942   return true;
943 }
944 
PopBasic(int dbus_type,void * value)945 bool MessageReader::PopBasic(int dbus_type, void* value) {
946   if (!CheckDataType(dbus_type))
947     return false;
948   // dbus_message_iter_get_basic() here should always work, as we have
949   // already checked the next item's data type in CheckDataType(). Note
950   // that dbus_message_iter_get_basic() is a void function.
951   dbus_message_iter_get_basic(&raw_message_iter_, value);
952   DCHECK(value);
953   dbus_message_iter_next(&raw_message_iter_);
954   return true;
955 }
956 
PopContainer(int dbus_type,MessageReader * sub_reader)957 bool MessageReader::PopContainer(int dbus_type, MessageReader* sub_reader) {
958   DCHECK_NE(this, sub_reader);
959 
960   if (!CheckDataType(dbus_type))
961     return false;
962   dbus_message_iter_recurse(&raw_message_iter_,
963                             &sub_reader->raw_message_iter_);
964   dbus_message_iter_next(&raw_message_iter_);
965   return true;
966 }
967 
PopVariantOfBasic(int dbus_type,void * value)968 bool MessageReader::PopVariantOfBasic(int dbus_type, void* value) {
969   MessageReader variant_reader(message_);
970   if (!PopVariant(&variant_reader))
971     return false;
972   return variant_reader.PopBasic(dbus_type, value);
973 }
974 
PopFileDescriptor(FileDescriptor * value)975 bool MessageReader::PopFileDescriptor(FileDescriptor* value) {
976   CHECK(IsDBusTypeUnixFdSupported());
977 
978   int fd = -1;
979   const bool success = PopBasic(DBUS_TYPE_UNIX_FD, &fd);
980   if (!success)
981     return false;
982 
983   value->PutValue(fd);
984   // NB: the caller must check validity before using the value
985   return true;
986 }
987 
988 }  // namespace dbus
989