Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 1 | // Copyright (c) 2012 The Chromium OS Authors. All rights reserved. |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 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 "shill/rtnl_message.h" |
| 6 | |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 7 | #include <sys/socket.h> |
| 8 | #include <linux/netlink.h> |
| 9 | #include <linux/rtnetlink.h> |
| 10 | |
Christopher Wiley | b691efd | 2012-08-09 13:51:51 -0700 | [diff] [blame] | 11 | #include "shill/logging.h" |
| 12 | |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 13 | namespace shill { |
| 14 | |
| 15 | struct RTNLHeader { |
| 16 | RTNLHeader() { |
| 17 | memset(this, 0, sizeof(*this)); |
| 18 | } |
| 19 | struct nlmsghdr hdr; |
| 20 | union { |
| 21 | struct ifinfomsg ifi; |
| 22 | struct ifaddrmsg ifa; |
| 23 | struct rtmsg rtm; |
| 24 | struct rtgenmsg gen; |
| 25 | }; |
| 26 | }; |
| 27 | |
| 28 | RTNLMessage::RTNLMessage() |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 29 | : type_(kTypeUnknown), |
| 30 | mode_(kModeUnknown), |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 31 | flags_(0), |
Darin Petkov | e636c69 | 2012-05-31 10:22:17 +0200 | [diff] [blame] | 32 | seq_(0), |
| 33 | pid_(0), |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 34 | interface_index_(0), |
Paul Stewart | 7355ce1 | 2011-09-02 10:47:01 -0700 | [diff] [blame] | 35 | family_(IPAddress::kFamilyUnknown) {} |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 36 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 37 | RTNLMessage::RTNLMessage(Type type, |
| 38 | Mode mode, |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 39 | unsigned int flags, |
| 40 | uint32 seq, |
| 41 | uint32 pid, |
| 42 | int interface_index, |
| 43 | IPAddress::Family family) |
| 44 | : type_(type), |
| 45 | mode_(mode), |
| 46 | flags_(flags), |
| 47 | seq_(seq), |
| 48 | pid_(pid), |
| 49 | interface_index_(interface_index), |
| 50 | family_(family) {} |
| 51 | |
| 52 | bool RTNLMessage::Decode(const ByteString &msg) { |
| 53 | bool ret = DecodeInternal(msg); |
| 54 | if (!ret) { |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 55 | Reset(); |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 56 | } |
| 57 | return ret; |
| 58 | } |
| 59 | |
| 60 | bool RTNLMessage::DecodeInternal(const ByteString &msg) { |
| 61 | const RTNLHeader *hdr = |
| 62 | reinterpret_cast<const RTNLHeader *>(msg.GetConstData()); |
| 63 | |
| 64 | if (msg.GetLength() < sizeof(hdr->hdr) || |
| 65 | msg.GetLength() < hdr->hdr.nlmsg_len) |
| 66 | return false; |
| 67 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 68 | Mode mode = kModeUnknown; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 69 | switch (hdr->hdr.nlmsg_type) { |
| 70 | case RTM_NEWLINK: |
| 71 | case RTM_NEWADDR: |
| 72 | case RTM_NEWROUTE: |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 73 | mode = kModeAdd; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 74 | break; |
| 75 | |
| 76 | case RTM_DELLINK: |
| 77 | case RTM_DELADDR: |
| 78 | case RTM_DELROUTE: |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 79 | mode = kModeDelete; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 80 | break; |
| 81 | |
| 82 | default: |
| 83 | return false; |
| 84 | } |
| 85 | |
| 86 | rtattr *attr_data = NULL; |
| 87 | int attr_length = 0; |
| 88 | |
| 89 | switch (hdr->hdr.nlmsg_type) { |
| 90 | case RTM_NEWLINK: |
| 91 | case RTM_DELLINK: |
| 92 | if (!DecodeLink(hdr, mode, &attr_data, &attr_length)) |
| 93 | return false; |
| 94 | break; |
| 95 | |
| 96 | case RTM_NEWADDR: |
| 97 | case RTM_DELADDR: |
| 98 | if (!DecodeAddress(hdr, mode, &attr_data, &attr_length)) |
| 99 | return false; |
| 100 | break; |
| 101 | |
| 102 | case RTM_NEWROUTE: |
| 103 | case RTM_DELROUTE: |
| 104 | if (!DecodeRoute(hdr, mode, &attr_data, &attr_length)) |
| 105 | return false; |
| 106 | break; |
| 107 | |
| 108 | default: |
| 109 | NOTREACHED(); |
| 110 | } |
| 111 | |
| 112 | flags_ = hdr->hdr.nlmsg_flags; |
| 113 | seq_ = hdr->hdr.nlmsg_seq; |
| 114 | pid_ = hdr->hdr.nlmsg_pid; |
| 115 | |
| 116 | while (attr_data && RTA_OK(attr_data, attr_length)) { |
| 117 | SetAttribute( |
| 118 | attr_data->rta_type, |
| 119 | ByteString(reinterpret_cast<unsigned char *>(RTA_DATA(attr_data)), |
| 120 | RTA_PAYLOAD(attr_data))); |
| 121 | attr_data = RTA_NEXT(attr_data, attr_length); |
| 122 | } |
| 123 | |
| 124 | if (attr_length) { |
Julius Werner | 87fc23e | 2012-10-18 14:21:33 -0700 | [diff] [blame] | 125 | // temporary debug output |
| 126 | // TODO(jwerner@chromium.org): Remove after gathering data (crosbug 35479) |
| 127 | if (hdr->hdr.nlmsg_type == RTM_NEWLINK) |
| 128 | LOG(INFO) << "Broken RTM_NEWLINK attributes: " << ByteString((char *) |
| 129 | IFLA_RTA(NLMSG_DATA(&hdr->hdr)), IFLA_PAYLOAD(&hdr->hdr)).HexEncode(); |
| 130 | |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 131 | // We hit a parse error while going through the attributes |
| 132 | attributes_.clear(); |
| 133 | return false; |
| 134 | } |
| 135 | |
| 136 | return true; |
| 137 | } |
| 138 | |
| 139 | bool RTNLMessage::DecodeLink(const RTNLHeader *hdr, |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 140 | Mode mode, |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 141 | rtattr **attr_data, |
| 142 | int *attr_length) { |
| 143 | if (hdr->hdr.nlmsg_len < NLMSG_LENGTH(sizeof(hdr->ifi))) { |
| 144 | return false; |
| 145 | } |
| 146 | |
| 147 | mode_ = mode; |
| 148 | *attr_data = IFLA_RTA(NLMSG_DATA(&hdr->hdr)); |
| 149 | *attr_length = IFLA_PAYLOAD(&hdr->hdr); |
| 150 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 151 | type_ = kTypeLink; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 152 | family_ = hdr->ifi.ifi_family; |
| 153 | interface_index_ = hdr->ifi.ifi_index; |
| 154 | set_link_status(LinkStatus(hdr->ifi.ifi_type, |
| 155 | hdr->ifi.ifi_flags, |
| 156 | hdr->ifi.ifi_change)); |
| 157 | return true; |
| 158 | } |
| 159 | |
| 160 | bool RTNLMessage::DecodeAddress(const RTNLHeader *hdr, |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 161 | Mode mode, |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 162 | rtattr **attr_data, |
| 163 | int *attr_length) { |
| 164 | if (hdr->hdr.nlmsg_len < NLMSG_LENGTH(sizeof(hdr->ifa))) { |
| 165 | return false; |
| 166 | } |
| 167 | mode_ = mode; |
| 168 | *attr_data = IFA_RTA(NLMSG_DATA(&hdr->hdr)); |
| 169 | *attr_length = IFA_PAYLOAD(&hdr->hdr); |
| 170 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 171 | type_ = kTypeAddress; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 172 | family_ = hdr->ifa.ifa_family; |
| 173 | interface_index_ = hdr->ifa.ifa_index; |
| 174 | set_address_status(AddressStatus(hdr->ifa.ifa_prefixlen, |
| 175 | hdr->ifa.ifa_flags, |
| 176 | hdr->ifa.ifa_scope)); |
| 177 | return true; |
| 178 | } |
| 179 | |
| 180 | bool RTNLMessage::DecodeRoute(const RTNLHeader *hdr, |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 181 | Mode mode, |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 182 | rtattr **attr_data, |
| 183 | int *attr_length) { |
| 184 | if (hdr->hdr.nlmsg_len < NLMSG_LENGTH(sizeof(hdr->rtm))) { |
| 185 | return false; |
| 186 | } |
| 187 | mode_ = mode; |
| 188 | *attr_data = RTM_RTA(NLMSG_DATA(&hdr->hdr)); |
| 189 | *attr_length = RTM_PAYLOAD(&hdr->hdr); |
| 190 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 191 | type_ = kTypeRoute; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 192 | family_ = hdr->rtm.rtm_family; |
| 193 | set_route_status(RouteStatus(hdr->rtm.rtm_dst_len, |
| 194 | hdr->rtm.rtm_src_len, |
| 195 | hdr->rtm.rtm_table, |
| 196 | hdr->rtm.rtm_protocol, |
| 197 | hdr->rtm.rtm_scope, |
| 198 | hdr->rtm.rtm_type, |
| 199 | hdr->rtm.rtm_flags)); |
| 200 | return true; |
| 201 | } |
| 202 | |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 203 | ByteString RTNLMessage::Encode() const { |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 204 | if (type_ != kTypeLink && |
| 205 | type_ != kTypeAddress && |
| 206 | type_ != kTypeRoute) { |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 207 | return ByteString(); |
| 208 | } |
| 209 | |
| 210 | RTNLHeader hdr; |
| 211 | hdr.hdr.nlmsg_flags = flags_; |
| 212 | hdr.hdr.nlmsg_seq = seq_; |
| 213 | hdr.hdr.nlmsg_pid = pid_; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 214 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 215 | if (mode_ == kModeGet) { |
| 216 | if (type_ == kTypeLink) { |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 217 | hdr.hdr.nlmsg_type = RTM_GETLINK; |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 218 | } else if (type_ == kTypeAddress) { |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 219 | hdr.hdr.nlmsg_type = RTM_GETADDR; |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 220 | } else if (type_ == kTypeRoute) { |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 221 | hdr.hdr.nlmsg_type = RTM_GETROUTE; |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 222 | } else { |
| 223 | NOTIMPLEMENTED(); |
| 224 | return ByteString(); |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 225 | } |
| 226 | hdr.hdr.nlmsg_len = NLMSG_LENGTH(sizeof(hdr.gen)); |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 227 | hdr.hdr.nlmsg_flags = NLM_F_REQUEST | NLM_F_DUMP; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 228 | hdr.gen.rtgen_family = family_; |
| 229 | } else { |
| 230 | switch (type_) { |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 231 | case kTypeLink: |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 232 | if (!EncodeLink(&hdr)) { |
| 233 | return ByteString(); |
| 234 | } |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 235 | break; |
| 236 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 237 | case kTypeAddress: |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 238 | if (!EncodeAddress(&hdr)) { |
| 239 | return ByteString(); |
| 240 | } |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 241 | break; |
| 242 | |
Paul Stewart | 9a90808 | 2011-08-31 12:18:48 -0700 | [diff] [blame] | 243 | case kTypeRoute: |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 244 | if (!EncodeRoute(&hdr)) { |
| 245 | return ByteString(); |
| 246 | } |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 247 | break; |
| 248 | |
| 249 | default: |
| 250 | NOTREACHED(); |
| 251 | } |
| 252 | } |
| 253 | |
| 254 | size_t header_length = hdr.hdr.nlmsg_len; |
| 255 | ByteString attributes; |
| 256 | |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 257 | base::hash_map<uint16, ByteString>::const_iterator attr; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 258 | for (attr = attributes_.begin(); attr != attributes_.end(); ++attr) { |
| 259 | size_t len = RTA_LENGTH(attr->second.GetLength()); |
| 260 | hdr.hdr.nlmsg_len = NLMSG_ALIGN(hdr.hdr.nlmsg_len) + RTA_ALIGN(len); |
| 261 | |
Han Shen | b970b8f | 2012-07-18 15:57:19 -0700 | [diff] [blame] | 262 | struct rtattr rt_attr = { static_cast<unsigned short>(len), attr->first }; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 263 | ByteString attr_header(reinterpret_cast<unsigned char *>(&rt_attr), |
| 264 | sizeof(rt_attr)); |
| 265 | attr_header.Resize(RTA_ALIGN(attr_header.GetLength())); |
| 266 | attributes.Append(attr_header); |
| 267 | |
| 268 | ByteString attr_data(attr->second); |
| 269 | attr_data.Resize(RTA_ALIGN(attr_data.GetLength())); |
| 270 | attributes.Append(attr_data); |
| 271 | } |
| 272 | |
| 273 | ByteString packet(reinterpret_cast<unsigned char *>(&hdr), header_length); |
| 274 | packet.Append(attributes); |
| 275 | |
| 276 | return packet; |
| 277 | } |
| 278 | |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 279 | bool RTNLMessage::EncodeLink(RTNLHeader *hdr) const { |
| 280 | switch (mode_) { |
| 281 | case kModeAdd: |
| 282 | hdr->hdr.nlmsg_type = RTM_NEWLINK; |
| 283 | break; |
| 284 | case kModeDelete: |
| 285 | hdr->hdr.nlmsg_type = RTM_DELLINK; |
| 286 | break; |
| 287 | case kModeQuery: |
| 288 | hdr->hdr.nlmsg_type = RTM_GETLINK; |
| 289 | break; |
| 290 | default: |
| 291 | NOTIMPLEMENTED(); |
| 292 | return false; |
| 293 | } |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 294 | hdr->hdr.nlmsg_len = NLMSG_LENGTH(sizeof(hdr->ifi)); |
| 295 | hdr->ifi.ifi_family = family_; |
Paul Stewart | cba0f7f | 2012-02-29 16:33:05 -0800 | [diff] [blame] | 296 | hdr->ifi.ifi_index = interface_index_; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 297 | hdr->ifi.ifi_type = link_status_.type; |
| 298 | hdr->ifi.ifi_flags = link_status_.flags; |
| 299 | hdr->ifi.ifi_change = link_status_.change; |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 300 | return true; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 301 | } |
| 302 | |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 303 | bool RTNLMessage::EncodeAddress(RTNLHeader *hdr) const { |
| 304 | switch (mode_) { |
| 305 | case kModeAdd: |
| 306 | hdr->hdr.nlmsg_type = RTM_NEWADDR; |
| 307 | break; |
| 308 | case kModeDelete: |
| 309 | hdr->hdr.nlmsg_type = RTM_DELADDR; |
| 310 | break; |
| 311 | case kModeQuery: |
| 312 | hdr->hdr.nlmsg_type = RTM_GETADDR; |
| 313 | break; |
| 314 | default: |
| 315 | NOTIMPLEMENTED(); |
| 316 | return false; |
| 317 | } |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 318 | hdr->hdr.nlmsg_len = NLMSG_LENGTH(sizeof(hdr->ifa)); |
| 319 | hdr->ifa.ifa_family = family_; |
| 320 | hdr->ifa.ifa_prefixlen = address_status_.prefix_len; |
| 321 | hdr->ifa.ifa_flags = address_status_.flags; |
| 322 | hdr->ifa.ifa_scope = address_status_.scope; |
| 323 | hdr->ifa.ifa_index = interface_index_; |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 324 | return true; |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 325 | } |
| 326 | |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 327 | bool RTNLMessage::EncodeRoute(RTNLHeader *hdr) const { |
| 328 | switch (mode_) { |
| 329 | case kModeAdd: |
| 330 | hdr->hdr.nlmsg_type = RTM_NEWROUTE; |
| 331 | break; |
| 332 | case kModeDelete: |
| 333 | hdr->hdr.nlmsg_type = RTM_DELROUTE; |
| 334 | break; |
| 335 | case kModeQuery: |
| 336 | hdr->hdr.nlmsg_type = RTM_GETROUTE; |
| 337 | break; |
| 338 | default: |
| 339 | NOTIMPLEMENTED(); |
| 340 | return false; |
| 341 | } |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 342 | hdr->hdr.nlmsg_len = NLMSG_LENGTH(sizeof(hdr->rtm)); |
| 343 | hdr->rtm.rtm_family = family_; |
| 344 | hdr->rtm.rtm_dst_len = route_status_.dst_prefix; |
| 345 | hdr->rtm.rtm_src_len = route_status_.src_prefix; |
| 346 | hdr->rtm.rtm_table = route_status_.table; |
| 347 | hdr->rtm.rtm_protocol = route_status_.protocol; |
| 348 | hdr->rtm.rtm_scope = route_status_.scope; |
| 349 | hdr->rtm.rtm_type = route_status_.type; |
| 350 | hdr->rtm.rtm_flags = route_status_.flags; |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 351 | return true; |
| 352 | } |
| 353 | |
| 354 | void RTNLMessage::Reset() { |
| 355 | mode_ = kModeUnknown; |
| 356 | type_ = kTypeUnknown; |
| 357 | flags_ = 0; |
| 358 | seq_ = 0; |
Darin Petkov | e636c69 | 2012-05-31 10:22:17 +0200 | [diff] [blame] | 359 | pid_ = 0; |
Paul Stewart | f748a36 | 2012-03-07 12:01:20 -0800 | [diff] [blame] | 360 | interface_index_ = 0; |
| 361 | family_ = IPAddress::kFamilyUnknown; |
| 362 | link_status_ = LinkStatus(); |
| 363 | address_status_ = AddressStatus(); |
| 364 | route_status_ = RouteStatus(); |
| 365 | attributes_.clear(); |
Paul Stewart | dd7df79 | 2011-07-15 11:09:50 -0700 | [diff] [blame] | 366 | } |
| 367 | |
| 368 | } // namespace shill |