treewide: remove redundant IS_ERR() before error code check
[linux/fpc-iii.git] / drivers / soc / qcom / qmi_interface.c
blobf9e309f0acd32debbb44cb116386ed8bc9fc3093
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Copyright (C) 2017 Linaro Ltd.
4 */
5 #include <linux/kernel.h>
6 #include <linux/module.h>
7 #include <linux/device.h>
8 #include <linux/qrtr.h>
9 #include <linux/net.h>
10 #include <linux/completion.h>
11 #include <linux/idr.h>
12 #include <linux/string.h>
13 #include <net/sock.h>
14 #include <linux/workqueue.h>
15 #include <linux/soc/qcom/qmi.h>
17 static struct socket *qmi_sock_create(struct qmi_handle *qmi,
18 struct sockaddr_qrtr *sq);
20 /**
21 * qmi_recv_new_server() - handler of NEW_SERVER control message
22 * @qmi: qmi handle
23 * @service: service id of the new server
24 * @instance: instance id of the new server
25 * @node: node of the new server
26 * @port: port of the new server
28 * Calls the new_server callback to inform the client about a newly registered
29 * server matching the currently registered service lookup.
31 static void qmi_recv_new_server(struct qmi_handle *qmi,
32 unsigned int service, unsigned int instance,
33 unsigned int node, unsigned int port)
35 struct qmi_ops *ops = &qmi->ops;
36 struct qmi_service *svc;
37 int ret;
39 if (!ops->new_server)
40 return;
42 /* Ignore EOF marker */
43 if (!node && !port)
44 return;
46 svc = kzalloc(sizeof(*svc), GFP_KERNEL);
47 if (!svc)
48 return;
50 svc->service = service;
51 svc->version = instance & 0xff;
52 svc->instance = instance >> 8;
53 svc->node = node;
54 svc->port = port;
56 ret = ops->new_server(qmi, svc);
57 if (ret < 0)
58 kfree(svc);
59 else
60 list_add(&svc->list_node, &qmi->lookup_results);
63 /**
64 * qmi_recv_del_server() - handler of DEL_SERVER control message
65 * @qmi: qmi handle
66 * @node: node of the dying server, a value of -1 matches all nodes
67 * @port: port of the dying server, a value of -1 matches all ports
69 * Calls the del_server callback for each previously seen server, allowing the
70 * client to react to the disappearing server.
72 static void qmi_recv_del_server(struct qmi_handle *qmi,
73 unsigned int node, unsigned int port)
75 struct qmi_ops *ops = &qmi->ops;
76 struct qmi_service *svc;
77 struct qmi_service *tmp;
79 list_for_each_entry_safe(svc, tmp, &qmi->lookup_results, list_node) {
80 if (node != -1 && svc->node != node)
81 continue;
82 if (port != -1 && svc->port != port)
83 continue;
85 if (ops->del_server)
86 ops->del_server(qmi, svc);
88 list_del(&svc->list_node);
89 kfree(svc);
93 /**
94 * qmi_recv_bye() - handler of BYE control message
95 * @qmi: qmi handle
96 * @node: id of the dying node
98 * Signals the client that all previously registered services on this node are
99 * now gone and then calls the bye callback to allow the client client further
100 * cleaning up resources associated with this remote.
102 static void qmi_recv_bye(struct qmi_handle *qmi,
103 unsigned int node)
105 struct qmi_ops *ops = &qmi->ops;
107 qmi_recv_del_server(qmi, node, -1);
109 if (ops->bye)
110 ops->bye(qmi, node);
114 * qmi_recv_del_client() - handler of DEL_CLIENT control message
115 * @qmi: qmi handle
116 * @node: node of the dying client
117 * @port: port of the dying client
119 * Signals the client about a dying client, by calling the del_client callback.
121 static void qmi_recv_del_client(struct qmi_handle *qmi,
122 unsigned int node, unsigned int port)
124 struct qmi_ops *ops = &qmi->ops;
126 if (ops->del_client)
127 ops->del_client(qmi, node, port);
130 static void qmi_recv_ctrl_pkt(struct qmi_handle *qmi,
131 const void *buf, size_t len)
133 const struct qrtr_ctrl_pkt *pkt = buf;
135 if (len < sizeof(struct qrtr_ctrl_pkt)) {
136 pr_debug("ignoring short control packet\n");
137 return;
140 switch (le32_to_cpu(pkt->cmd)) {
141 case QRTR_TYPE_BYE:
142 qmi_recv_bye(qmi, le32_to_cpu(pkt->client.node));
143 break;
144 case QRTR_TYPE_NEW_SERVER:
145 qmi_recv_new_server(qmi,
146 le32_to_cpu(pkt->server.service),
147 le32_to_cpu(pkt->server.instance),
148 le32_to_cpu(pkt->server.node),
149 le32_to_cpu(pkt->server.port));
150 break;
151 case QRTR_TYPE_DEL_SERVER:
152 qmi_recv_del_server(qmi,
153 le32_to_cpu(pkt->server.node),
154 le32_to_cpu(pkt->server.port));
155 break;
156 case QRTR_TYPE_DEL_CLIENT:
157 qmi_recv_del_client(qmi,
158 le32_to_cpu(pkt->client.node),
159 le32_to_cpu(pkt->client.port));
160 break;
164 static void qmi_send_new_lookup(struct qmi_handle *qmi, struct qmi_service *svc)
166 struct qrtr_ctrl_pkt pkt;
167 struct sockaddr_qrtr sq;
168 struct msghdr msg = { };
169 struct kvec iv = { &pkt, sizeof(pkt) };
170 int ret;
172 memset(&pkt, 0, sizeof(pkt));
173 pkt.cmd = cpu_to_le32(QRTR_TYPE_NEW_LOOKUP);
174 pkt.server.service = cpu_to_le32(svc->service);
175 pkt.server.instance = cpu_to_le32(svc->version | svc->instance << 8);
177 sq.sq_family = qmi->sq.sq_family;
178 sq.sq_node = qmi->sq.sq_node;
179 sq.sq_port = QRTR_PORT_CTRL;
181 msg.msg_name = &sq;
182 msg.msg_namelen = sizeof(sq);
184 mutex_lock(&qmi->sock_lock);
185 if (qmi->sock) {
186 ret = kernel_sendmsg(qmi->sock, &msg, &iv, 1, sizeof(pkt));
187 if (ret < 0)
188 pr_err("failed to send lookup registration: %d\n", ret);
190 mutex_unlock(&qmi->sock_lock);
194 * qmi_add_lookup() - register a new lookup with the name service
195 * @qmi: qmi handle
196 * @service: service id of the request
197 * @instance: instance id of the request
198 * @version: version number of the request
200 * Registering a lookup query with the name server will cause the name server
201 * to send NEW_SERVER and DEL_SERVER control messages to this socket as
202 * matching services are registered.
204 * Return: 0 on success, negative errno on failure.
206 int qmi_add_lookup(struct qmi_handle *qmi, unsigned int service,
207 unsigned int version, unsigned int instance)
209 struct qmi_service *svc;
211 svc = kzalloc(sizeof(*svc), GFP_KERNEL);
212 if (!svc)
213 return -ENOMEM;
215 svc->service = service;
216 svc->version = version;
217 svc->instance = instance;
219 list_add(&svc->list_node, &qmi->lookups);
221 qmi_send_new_lookup(qmi, svc);
223 return 0;
225 EXPORT_SYMBOL(qmi_add_lookup);
227 static void qmi_send_new_server(struct qmi_handle *qmi, struct qmi_service *svc)
229 struct qrtr_ctrl_pkt pkt;
230 struct sockaddr_qrtr sq;
231 struct msghdr msg = { };
232 struct kvec iv = { &pkt, sizeof(pkt) };
233 int ret;
235 memset(&pkt, 0, sizeof(pkt));
236 pkt.cmd = cpu_to_le32(QRTR_TYPE_NEW_SERVER);
237 pkt.server.service = cpu_to_le32(svc->service);
238 pkt.server.instance = cpu_to_le32(svc->version | svc->instance << 8);
239 pkt.server.node = cpu_to_le32(qmi->sq.sq_node);
240 pkt.server.port = cpu_to_le32(qmi->sq.sq_port);
242 sq.sq_family = qmi->sq.sq_family;
243 sq.sq_node = qmi->sq.sq_node;
244 sq.sq_port = QRTR_PORT_CTRL;
246 msg.msg_name = &sq;
247 msg.msg_namelen = sizeof(sq);
249 mutex_lock(&qmi->sock_lock);
250 if (qmi->sock) {
251 ret = kernel_sendmsg(qmi->sock, &msg, &iv, 1, sizeof(pkt));
252 if (ret < 0)
253 pr_err("send service registration failed: %d\n", ret);
255 mutex_unlock(&qmi->sock_lock);
259 * qmi_add_server() - register a service with the name service
260 * @qmi: qmi handle
261 * @service: type of the service
262 * @instance: instance of the service
263 * @version: version of the service
265 * Register a new service with the name service. This allows clients to find
266 * and start sending messages to the client associated with @qmi.
268 * Return: 0 on success, negative errno on failure.
270 int qmi_add_server(struct qmi_handle *qmi, unsigned int service,
271 unsigned int version, unsigned int instance)
273 struct qmi_service *svc;
275 svc = kzalloc(sizeof(*svc), GFP_KERNEL);
276 if (!svc)
277 return -ENOMEM;
279 svc->service = service;
280 svc->version = version;
281 svc->instance = instance;
283 list_add(&svc->list_node, &qmi->services);
285 qmi_send_new_server(qmi, svc);
287 return 0;
289 EXPORT_SYMBOL(qmi_add_server);
292 * qmi_txn_init() - allocate transaction id within the given QMI handle
293 * @qmi: QMI handle
294 * @txn: transaction context
295 * @ei: description of how to decode a matching response (optional)
296 * @c_struct: pointer to the object to decode the response into (optional)
298 * This allocates a transaction id within the QMI handle. If @ei and @c_struct
299 * are specified any responses to this transaction will be decoded as described
300 * by @ei into @c_struct.
302 * A client calling qmi_txn_init() must call either qmi_txn_wait() or
303 * qmi_txn_cancel() to free up the allocated resources.
305 * Return: Transaction id on success, negative errno on failure.
307 int qmi_txn_init(struct qmi_handle *qmi, struct qmi_txn *txn,
308 struct qmi_elem_info *ei, void *c_struct)
310 int ret;
312 memset(txn, 0, sizeof(*txn));
314 mutex_init(&txn->lock);
315 init_completion(&txn->completion);
316 txn->qmi = qmi;
317 txn->ei = ei;
318 txn->dest = c_struct;
320 mutex_lock(&qmi->txn_lock);
321 ret = idr_alloc_cyclic(&qmi->txns, txn, 0, U16_MAX, GFP_KERNEL);
322 if (ret < 0)
323 pr_err("failed to allocate transaction id\n");
325 txn->id = ret;
326 mutex_unlock(&qmi->txn_lock);
328 return ret;
330 EXPORT_SYMBOL(qmi_txn_init);
333 * qmi_txn_wait() - wait for a response on a transaction
334 * @txn: transaction handle
335 * @timeout: timeout, in jiffies
337 * If the transaction is decoded by the means of @ei and @c_struct the return
338 * value will be the returned value of qmi_decode_message(), otherwise it's up
339 * to the specified message handler to fill out the result.
341 * Return: the transaction response on success, negative errno on failure.
343 int qmi_txn_wait(struct qmi_txn *txn, unsigned long timeout)
345 struct qmi_handle *qmi = txn->qmi;
346 int ret;
348 ret = wait_for_completion_timeout(&txn->completion, timeout);
350 mutex_lock(&qmi->txn_lock);
351 mutex_lock(&txn->lock);
352 idr_remove(&qmi->txns, txn->id);
353 mutex_unlock(&txn->lock);
354 mutex_unlock(&qmi->txn_lock);
356 if (ret == 0)
357 return -ETIMEDOUT;
358 else
359 return txn->result;
361 EXPORT_SYMBOL(qmi_txn_wait);
364 * qmi_txn_cancel() - cancel an ongoing transaction
365 * @txn: transaction id
367 void qmi_txn_cancel(struct qmi_txn *txn)
369 struct qmi_handle *qmi = txn->qmi;
371 mutex_lock(&qmi->txn_lock);
372 mutex_lock(&txn->lock);
373 idr_remove(&qmi->txns, txn->id);
374 mutex_unlock(&txn->lock);
375 mutex_unlock(&qmi->txn_lock);
377 EXPORT_SYMBOL(qmi_txn_cancel);
380 * qmi_invoke_handler() - find and invoke a handler for a message
381 * @qmi: qmi handle
382 * @sq: sockaddr of the sender
383 * @txn: transaction object for the message
384 * @buf: buffer containing the message
385 * @len: length of @buf
387 * Find handler and invoke handler for the incoming message.
389 static void qmi_invoke_handler(struct qmi_handle *qmi, struct sockaddr_qrtr *sq,
390 struct qmi_txn *txn, const void *buf, size_t len)
392 const struct qmi_msg_handler *handler;
393 const struct qmi_header *hdr = buf;
394 void *dest;
395 int ret;
397 if (!qmi->handlers)
398 return;
400 for (handler = qmi->handlers; handler->fn; handler++) {
401 if (handler->type == hdr->type &&
402 handler->msg_id == hdr->msg_id)
403 break;
406 if (!handler->fn)
407 return;
409 dest = kzalloc(handler->decoded_size, GFP_KERNEL);
410 if (!dest)
411 return;
413 ret = qmi_decode_message(buf, len, handler->ei, dest);
414 if (ret < 0)
415 pr_err("failed to decode incoming message\n");
416 else
417 handler->fn(qmi, sq, txn, dest);
419 kfree(dest);
423 * qmi_handle_net_reset() - invoked to handle ENETRESET on a QMI handle
424 * @qmi: the QMI context
426 * As a result of registering a name service with the QRTR all open sockets are
427 * flagged with ENETRESET and this function will be called. The typical case is
428 * the initial boot, where this signals that the local node id has been
429 * configured and as such any bound sockets needs to be rebound. So close the
430 * socket, inform the client and re-initialize the socket.
432 * For clients it's generally sufficient to react to the del_server callbacks,
433 * but server code is expected to treat the net_reset callback as a "bye" from
434 * all nodes.
436 * Finally the QMI handle will send out registration requests for any lookups
437 * and services.
439 static void qmi_handle_net_reset(struct qmi_handle *qmi)
441 struct sockaddr_qrtr sq;
442 struct qmi_service *svc;
443 struct socket *sock;
445 sock = qmi_sock_create(qmi, &sq);
446 if (IS_ERR(sock))
447 return;
449 mutex_lock(&qmi->sock_lock);
450 sock_release(qmi->sock);
451 qmi->sock = NULL;
452 mutex_unlock(&qmi->sock_lock);
454 qmi_recv_del_server(qmi, -1, -1);
456 if (qmi->ops.net_reset)
457 qmi->ops.net_reset(qmi);
459 mutex_lock(&qmi->sock_lock);
460 qmi->sock = sock;
461 qmi->sq = sq;
462 mutex_unlock(&qmi->sock_lock);
464 list_for_each_entry(svc, &qmi->lookups, list_node)
465 qmi_send_new_lookup(qmi, svc);
467 list_for_each_entry(svc, &qmi->services, list_node)
468 qmi_send_new_server(qmi, svc);
471 static void qmi_handle_message(struct qmi_handle *qmi,
472 struct sockaddr_qrtr *sq,
473 const void *buf, size_t len)
475 const struct qmi_header *hdr;
476 struct qmi_txn tmp_txn;
477 struct qmi_txn *txn = NULL;
478 int ret;
480 if (len < sizeof(*hdr)) {
481 pr_err("ignoring short QMI packet\n");
482 return;
485 hdr = buf;
487 /* If this is a response, find the matching transaction handle */
488 if (hdr->type == QMI_RESPONSE) {
489 mutex_lock(&qmi->txn_lock);
490 txn = idr_find(&qmi->txns, hdr->txn_id);
492 /* Ignore unexpected responses */
493 if (!txn) {
494 mutex_unlock(&qmi->txn_lock);
495 return;
498 mutex_lock(&txn->lock);
499 mutex_unlock(&qmi->txn_lock);
501 if (txn->dest && txn->ei) {
502 ret = qmi_decode_message(buf, len, txn->ei, txn->dest);
503 if (ret < 0)
504 pr_err("failed to decode incoming message\n");
506 txn->result = ret;
507 complete(&txn->completion);
508 } else {
509 qmi_invoke_handler(qmi, sq, txn, buf, len);
512 mutex_unlock(&txn->lock);
513 } else {
514 /* Create a txn based on the txn_id of the incoming message */
515 memset(&tmp_txn, 0, sizeof(tmp_txn));
516 tmp_txn.id = hdr->txn_id;
518 qmi_invoke_handler(qmi, sq, &tmp_txn, buf, len);
522 static void qmi_data_ready_work(struct work_struct *work)
524 struct qmi_handle *qmi = container_of(work, struct qmi_handle, work);
525 struct qmi_ops *ops = &qmi->ops;
526 struct sockaddr_qrtr sq;
527 struct msghdr msg = { .msg_name = &sq, .msg_namelen = sizeof(sq) };
528 struct kvec iv;
529 ssize_t msglen;
531 for (;;) {
532 iv.iov_base = qmi->recv_buf;
533 iv.iov_len = qmi->recv_buf_size;
535 mutex_lock(&qmi->sock_lock);
536 if (qmi->sock)
537 msglen = kernel_recvmsg(qmi->sock, &msg, &iv, 1,
538 iv.iov_len, MSG_DONTWAIT);
539 else
540 msglen = -EPIPE;
541 mutex_unlock(&qmi->sock_lock);
542 if (msglen == -EAGAIN)
543 break;
545 if (msglen == -ENETRESET) {
546 qmi_handle_net_reset(qmi);
548 /* The old qmi->sock is gone, our work is done */
549 break;
552 if (msglen < 0) {
553 pr_err("qmi recvmsg failed: %zd\n", msglen);
554 break;
557 if (sq.sq_node == qmi->sq.sq_node &&
558 sq.sq_port == QRTR_PORT_CTRL) {
559 qmi_recv_ctrl_pkt(qmi, qmi->recv_buf, msglen);
560 } else if (ops->msg_handler) {
561 ops->msg_handler(qmi, &sq, qmi->recv_buf, msglen);
562 } else {
563 qmi_handle_message(qmi, &sq, qmi->recv_buf, msglen);
568 static void qmi_data_ready(struct sock *sk)
570 struct qmi_handle *qmi = sk->sk_user_data;
573 * This will be NULL if we receive data while being in
574 * qmi_handle_release()
576 if (!qmi)
577 return;
579 queue_work(qmi->wq, &qmi->work);
582 static struct socket *qmi_sock_create(struct qmi_handle *qmi,
583 struct sockaddr_qrtr *sq)
585 struct socket *sock;
586 int ret;
588 ret = sock_create_kern(&init_net, AF_QIPCRTR, SOCK_DGRAM,
589 PF_QIPCRTR, &sock);
590 if (ret < 0)
591 return ERR_PTR(ret);
593 ret = kernel_getsockname(sock, (struct sockaddr *)sq);
594 if (ret < 0) {
595 sock_release(sock);
596 return ERR_PTR(ret);
599 sock->sk->sk_user_data = qmi;
600 sock->sk->sk_data_ready = qmi_data_ready;
601 sock->sk->sk_error_report = qmi_data_ready;
603 return sock;
607 * qmi_handle_init() - initialize a QMI client handle
608 * @qmi: QMI handle to initialize
609 * @recv_buf_size: maximum size of incoming message
610 * @ops: reference to callbacks for QRTR notifications
611 * @handlers: NULL-terminated list of QMI message handlers
613 * This initializes the QMI client handle to allow sending and receiving QMI
614 * messages. As messages are received the appropriate handler will be invoked.
616 * Return: 0 on success, negative errno on failure.
618 int qmi_handle_init(struct qmi_handle *qmi, size_t recv_buf_size,
619 const struct qmi_ops *ops,
620 const struct qmi_msg_handler *handlers)
622 int ret;
624 mutex_init(&qmi->txn_lock);
625 mutex_init(&qmi->sock_lock);
627 idr_init(&qmi->txns);
629 INIT_LIST_HEAD(&qmi->lookups);
630 INIT_LIST_HEAD(&qmi->lookup_results);
631 INIT_LIST_HEAD(&qmi->services);
633 INIT_WORK(&qmi->work, qmi_data_ready_work);
635 qmi->handlers = handlers;
636 if (ops)
637 qmi->ops = *ops;
639 /* Make room for the header */
640 recv_buf_size += sizeof(struct qmi_header);
641 /* Must also be sufficient to hold a control packet */
642 if (recv_buf_size < sizeof(struct qrtr_ctrl_pkt))
643 recv_buf_size = sizeof(struct qrtr_ctrl_pkt);
645 qmi->recv_buf_size = recv_buf_size;
646 qmi->recv_buf = kzalloc(recv_buf_size, GFP_KERNEL);
647 if (!qmi->recv_buf)
648 return -ENOMEM;
650 qmi->wq = alloc_workqueue("qmi_msg_handler", WQ_UNBOUND, 1);
651 if (!qmi->wq) {
652 ret = -ENOMEM;
653 goto err_free_recv_buf;
656 qmi->sock = qmi_sock_create(qmi, &qmi->sq);
657 if (IS_ERR(qmi->sock)) {
658 pr_err("failed to create QMI socket\n");
659 ret = PTR_ERR(qmi->sock);
660 goto err_destroy_wq;
663 return 0;
665 err_destroy_wq:
666 destroy_workqueue(qmi->wq);
667 err_free_recv_buf:
668 kfree(qmi->recv_buf);
670 return ret;
672 EXPORT_SYMBOL(qmi_handle_init);
675 * qmi_handle_release() - release the QMI client handle
676 * @qmi: QMI client handle
678 * This closes the underlying socket and stops any handling of QMI messages.
680 void qmi_handle_release(struct qmi_handle *qmi)
682 struct socket *sock = qmi->sock;
683 struct qmi_service *svc, *tmp;
685 sock->sk->sk_user_data = NULL;
686 cancel_work_sync(&qmi->work);
688 qmi_recv_del_server(qmi, -1, -1);
690 mutex_lock(&qmi->sock_lock);
691 sock_release(sock);
692 qmi->sock = NULL;
693 mutex_unlock(&qmi->sock_lock);
695 destroy_workqueue(qmi->wq);
697 idr_destroy(&qmi->txns);
699 kfree(qmi->recv_buf);
701 /* Free registered lookup requests */
702 list_for_each_entry_safe(svc, tmp, &qmi->lookups, list_node) {
703 list_del(&svc->list_node);
704 kfree(svc);
707 /* Free registered service information */
708 list_for_each_entry_safe(svc, tmp, &qmi->services, list_node) {
709 list_del(&svc->list_node);
710 kfree(svc);
713 EXPORT_SYMBOL(qmi_handle_release);
716 * qmi_send_message() - send a QMI message
717 * @qmi: QMI client handle
718 * @sq: destination sockaddr
719 * @txn: transaction object to use for the message
720 * @type: type of message to send
721 * @msg_id: message id
722 * @len: max length of the QMI message
723 * @ei: QMI message description
724 * @c_struct: object to be encoded
726 * This function encodes @c_struct using @ei into a message of type @type,
727 * with @msg_id and @txn into a buffer of maximum size @len, and sends this to
728 * @sq.
730 * Return: 0 on success, negative errno on failure.
732 static ssize_t qmi_send_message(struct qmi_handle *qmi,
733 struct sockaddr_qrtr *sq, struct qmi_txn *txn,
734 int type, int msg_id, size_t len,
735 struct qmi_elem_info *ei, const void *c_struct)
737 struct msghdr msghdr = {};
738 struct kvec iv;
739 void *msg;
740 int ret;
742 msg = qmi_encode_message(type,
743 msg_id, &len,
744 txn->id, ei,
745 c_struct);
746 if (IS_ERR(msg))
747 return PTR_ERR(msg);
749 iv.iov_base = msg;
750 iv.iov_len = len;
752 if (sq) {
753 msghdr.msg_name = sq;
754 msghdr.msg_namelen = sizeof(*sq);
757 mutex_lock(&qmi->sock_lock);
758 if (qmi->sock) {
759 ret = kernel_sendmsg(qmi->sock, &msghdr, &iv, 1, len);
760 if (ret < 0)
761 pr_err("failed to send QMI message\n");
762 } else {
763 ret = -EPIPE;
765 mutex_unlock(&qmi->sock_lock);
767 kfree(msg);
769 return ret < 0 ? ret : 0;
773 * qmi_send_request() - send a request QMI message
774 * @qmi: QMI client handle
775 * @sq: destination sockaddr
776 * @txn: transaction object to use for the message
777 * @msg_id: message id
778 * @len: max length of the QMI message
779 * @ei: QMI message description
780 * @c_struct: object to be encoded
782 * Return: 0 on success, negative errno on failure.
784 ssize_t qmi_send_request(struct qmi_handle *qmi, struct sockaddr_qrtr *sq,
785 struct qmi_txn *txn, int msg_id, size_t len,
786 struct qmi_elem_info *ei, const void *c_struct)
788 return qmi_send_message(qmi, sq, txn, QMI_REQUEST, msg_id, len, ei,
789 c_struct);
791 EXPORT_SYMBOL(qmi_send_request);
794 * qmi_send_response() - send a response QMI message
795 * @qmi: QMI client handle
796 * @sq: destination sockaddr
797 * @txn: transaction object to use for the message
798 * @msg_id: message id
799 * @len: max length of the QMI message
800 * @ei: QMI message description
801 * @c_struct: object to be encoded
803 * Return: 0 on success, negative errno on failure.
805 ssize_t qmi_send_response(struct qmi_handle *qmi, struct sockaddr_qrtr *sq,
806 struct qmi_txn *txn, int msg_id, size_t len,
807 struct qmi_elem_info *ei, const void *c_struct)
809 return qmi_send_message(qmi, sq, txn, QMI_RESPONSE, msg_id, len, ei,
810 c_struct);
812 EXPORT_SYMBOL(qmi_send_response);
815 * qmi_send_indication() - send an indication QMI message
816 * @qmi: QMI client handle
817 * @sq: destination sockaddr
818 * @msg_id: message id
819 * @len: max length of the QMI message
820 * @ei: QMI message description
821 * @c_struct: object to be encoded
823 * Return: 0 on success, negative errno on failure.
825 ssize_t qmi_send_indication(struct qmi_handle *qmi, struct sockaddr_qrtr *sq,
826 int msg_id, size_t len, struct qmi_elem_info *ei,
827 const void *c_struct)
829 struct qmi_txn txn;
830 ssize_t rval;
831 int ret;
833 ret = qmi_txn_init(qmi, &txn, NULL, NULL);
834 if (ret < 0)
835 return ret;
837 rval = qmi_send_message(qmi, sq, &txn, QMI_INDICATION, msg_id, len, ei,
838 c_struct);
840 /* We don't care about future messages on this txn */
841 qmi_txn_cancel(&txn);
843 return rval;
845 EXPORT_SYMBOL(qmi_send_indication);