1 /* RxRPC recvmsg() implementation
3 * Copyright (C) 2007 Red Hat, Inc. All Rights Reserved.
4 * Written by David Howells (dhowells@redhat.com)
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
12 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
14 #include <linux/net.h>
15 #include <linux/skbuff.h>
16 #include <linux/export.h>
18 #include <net/af_rxrpc.h>
19 #include "ar-internal.h"
22 * Post a call for attention by the socket or kernel service. Further
23 * notifications are suppressed by putting recvmsg_link on a dummy queue.
25 void rxrpc_notify_socket(struct rxrpc_call *call)
27 struct rxrpc_sock *rx;
30 _enter("%d", call->debug_id);
32 if (!list_empty(&call->recvmsg_link))
37 rx = rcu_dereference(call->socket);
39 if (rx && sk->sk_state < RXRPC_CLOSE) {
40 if (call->notify_rx) {
41 call->notify_rx(sk, call, call->user_call_ID);
43 write_lock_bh(&rx->recvmsg_lock);
44 if (list_empty(&call->recvmsg_link)) {
45 rxrpc_get_call(call, rxrpc_call_got);
46 list_add_tail(&call->recvmsg_link, &rx->recvmsg_q);
48 write_unlock_bh(&rx->recvmsg_lock);
50 if (!sock_flag(sk, SOCK_DEAD)) {
51 _debug("call %ps", sk->sk_data_ready);
52 sk->sk_data_ready(sk);
62 * Pass a call terminating message to userspace.
64 static int rxrpc_recvmsg_term(struct rxrpc_call *call, struct msghdr *msg)
69 switch (call->completion) {
70 case RXRPC_CALL_SUCCEEDED:
72 if (rxrpc_is_service_call(call))
73 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_ACK, 0, &tmp);
75 case RXRPC_CALL_REMOTELY_ABORTED:
76 tmp = call->abort_code;
77 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_ABORT, 4, &tmp);
79 case RXRPC_CALL_LOCALLY_ABORTED:
80 tmp = call->abort_code;
81 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_ABORT, 4, &tmp);
83 case RXRPC_CALL_NETWORK_ERROR:
85 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_NET_ERROR, 4, &tmp);
87 case RXRPC_CALL_LOCAL_ERROR:
89 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_LOCAL_ERROR, 4, &tmp);
92 pr_err("Invalid terminal call state %u\n", call->state);
97 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_terminal, call->rx_hard_ack,
98 call->rx_pkt_offset, call->rx_pkt_len, ret);
103 * Pass back notification of a new call. The call is added to the
104 * to-be-accepted list. This means that the next call to be accepted might not
105 * be the last call seen awaiting acceptance, but unless we leave this on the
106 * front of the queue and block all other messages until someone gives us a
107 * user_ID for it, there's not a lot we can do.
109 static int rxrpc_recvmsg_new_call(struct rxrpc_sock *rx,
110 struct rxrpc_call *call,
111 struct msghdr *msg, int flags)
115 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_NEW_CALL, 0, &tmp);
117 if (ret == 0 && !(flags & MSG_PEEK)) {
118 _debug("to be accepted");
119 write_lock_bh(&rx->recvmsg_lock);
120 list_del_init(&call->recvmsg_link);
121 write_unlock_bh(&rx->recvmsg_lock);
123 rxrpc_get_call(call, rxrpc_call_got);
124 write_lock(&rx->call_lock);
125 list_add_tail(&call->accept_link, &rx->to_be_accepted);
126 write_unlock(&rx->call_lock);
129 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_to_be_accepted, 1, 0, 0, ret);
134 * End the packet reception phase.
136 static void rxrpc_end_rx_phase(struct rxrpc_call *call)
138 _enter("%d,%s", call->debug_id, rxrpc_call_states[call->state]);
140 trace_rxrpc_receive(call, rxrpc_receive_end, 0, call->rx_top);
141 ASSERTCMP(call->rx_hard_ack, ==, call->rx_top);
143 if (call->state == RXRPC_CALL_CLIENT_RECV_REPLY) {
144 rxrpc_propose_ACK(call, RXRPC_ACK_IDLE, 0, 0, true, false);
145 rxrpc_send_call_packet(call, RXRPC_PACKET_TYPE_ACK);
147 rxrpc_propose_ACK(call, RXRPC_ACK_IDLE, 0, 0, false, false);
150 write_lock_bh(&call->state_lock);
152 switch (call->state) {
153 case RXRPC_CALL_CLIENT_RECV_REPLY:
154 __rxrpc_call_completed(call);
157 case RXRPC_CALL_SERVER_RECV_REQUEST:
158 call->tx_phase = true;
159 call->state = RXRPC_CALL_SERVER_ACK_REQUEST;
165 write_unlock_bh(&call->state_lock);
169 * Discard a packet we've used up and advance the Rx window by one.
171 static void rxrpc_rotate_rx_window(struct rxrpc_call *call)
173 struct rxrpc_skb_priv *sp;
175 rxrpc_serial_t serial;
176 rxrpc_seq_t hard_ack, top;
180 _enter("%d", call->debug_id);
182 hard_ack = call->rx_hard_ack;
183 top = smp_load_acquire(&call->rx_top);
184 ASSERT(before(hard_ack, top));
187 ix = hard_ack & RXRPC_RXTX_BUFF_MASK;
188 skb = call->rxtx_buffer[ix];
189 rxrpc_see_skb(skb, rxrpc_skb_rx_rotated);
191 flags = sp->hdr.flags;
192 serial = sp->hdr.serial;
193 if (call->rxtx_annotations[ix] & RXRPC_RX_ANNO_JUMBO)
194 serial += (call->rxtx_annotations[ix] & RXRPC_RX_ANNO_JUMBO) - 1;
196 call->rxtx_buffer[ix] = NULL;
197 call->rxtx_annotations[ix] = 0;
198 /* Barrier against rxrpc_input_data(). */
199 smp_store_release(&call->rx_hard_ack, hard_ack);
201 rxrpc_free_skb(skb, rxrpc_skb_rx_freed);
203 _debug("%u,%u,%02x", hard_ack, top, flags);
204 trace_rxrpc_receive(call, rxrpc_receive_rotate, serial, hard_ack);
205 if (flags & RXRPC_LAST_PACKET)
206 rxrpc_end_rx_phase(call);
210 * Decrypt and verify a (sub)packet. The packet's length may be changed due to
211 * padding, but if this is the case, the packet length will be resident in the
212 * socket buffer. Note that we can't modify the master skb info as the skb may
213 * be the home to multiple subpackets.
215 static int rxrpc_verify_packet(struct rxrpc_call *call, struct sk_buff *skb,
217 unsigned int offset, unsigned int len)
219 struct rxrpc_skb_priv *sp = rxrpc_skb(skb);
220 rxrpc_seq_t seq = sp->hdr.seq;
221 u16 cksum = sp->hdr.cksum;
225 /* For all but the head jumbo subpacket, the security checksum is in a
226 * jumbo header immediately prior to the data.
228 if ((annotation & RXRPC_RX_ANNO_JUMBO) > 1) {
230 if (skb_copy_bits(skb, offset - 2, &tmp, 2) < 0)
233 seq += (annotation & RXRPC_RX_ANNO_JUMBO) - 1;
236 return call->conn->security->verify_packet(call, skb, offset, len,
241 * Locate the data within a packet. This is complicated by:
243 * (1) An skb may contain a jumbo packet - so we have to find the appropriate
246 * (2) The (sub)packets may be encrypted and, if so, the encrypted portion
247 * contains an extra header which includes the true length of the data,
248 * excluding any encrypted padding.
250 static int rxrpc_locate_data(struct rxrpc_call *call, struct sk_buff *skb,
252 unsigned int *_offset, unsigned int *_len)
254 struct rxrpc_skb_priv *sp = rxrpc_skb(skb);
255 unsigned int offset = *_offset;
256 unsigned int len = *_len;
258 u8 annotation = *_annotation;
260 /* Locate the subpacket */
262 len = skb->len - sp->offset;
263 if ((annotation & RXRPC_RX_ANNO_JUMBO) > 0) {
264 offset += (((annotation & RXRPC_RX_ANNO_JUMBO) - 1) *
265 RXRPC_JUMBO_SUBPKTLEN);
266 len = (annotation & RXRPC_RX_ANNO_JLAST) ?
267 skb->len - offset : RXRPC_JUMBO_SUBPKTLEN;
270 if (!(annotation & RXRPC_RX_ANNO_VERIFIED)) {
271 ret = rxrpc_verify_packet(call, skb, annotation, offset, len);
274 *_annotation |= RXRPC_RX_ANNO_VERIFIED;
279 call->conn->security->locate_data(call, skb, _offset, _len);
284 * Deliver messages to a call. This keeps processing packets until the buffer
285 * is filled and we find either more DATA (returns 0) or the end of the DATA
286 * (returns 1). If more packets are required, it returns -EAGAIN.
288 static int rxrpc_recvmsg_data(struct socket *sock, struct rxrpc_call *call,
289 struct msghdr *msg, struct iov_iter *iter,
290 size_t len, int flags, size_t *_offset)
292 struct rxrpc_skb_priv *sp;
294 rxrpc_seq_t hard_ack, top, seq;
297 unsigned int rx_pkt_offset, rx_pkt_len;
298 int ix, copy, ret = -EAGAIN, ret2;
300 rx_pkt_offset = call->rx_pkt_offset;
301 rx_pkt_len = call->rx_pkt_len;
303 if (call->state >= RXRPC_CALL_SERVER_ACK_REQUEST) {
304 seq = call->rx_hard_ack;
309 /* Barriers against rxrpc_input_data(). */
310 hard_ack = call->rx_hard_ack;
311 top = smp_load_acquire(&call->rx_top);
312 for (seq = hard_ack + 1; before_eq(seq, top); seq++) {
313 ix = seq & RXRPC_RXTX_BUFF_MASK;
314 skb = call->rxtx_buffer[ix];
316 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_hole, seq,
317 rx_pkt_offset, rx_pkt_len, 0);
321 rxrpc_see_skb(skb, rxrpc_skb_rx_seen);
324 if (!(flags & MSG_PEEK))
325 trace_rxrpc_receive(call, rxrpc_receive_front,
326 sp->hdr.serial, seq);
329 sock_recv_timestamp(msg, sock->sk, skb);
331 if (rx_pkt_offset == 0) {
332 ret2 = rxrpc_locate_data(call, skb,
333 &call->rxtx_annotations[ix],
334 &rx_pkt_offset, &rx_pkt_len);
335 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_next, seq,
336 rx_pkt_offset, rx_pkt_len, ret2);
342 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_cont, seq,
343 rx_pkt_offset, rx_pkt_len, 0);
346 /* We have to handle short, empty and used-up DATA packets. */
347 remain = len - *_offset;
352 ret2 = skb_copy_datagram_iter(skb, rx_pkt_offset, iter,
359 /* handle piecemeal consumption of data packets */
360 rx_pkt_offset += copy;
365 if (rx_pkt_len > 0) {
366 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_full, seq,
367 rx_pkt_offset, rx_pkt_len, 0);
368 ASSERTCMP(*_offset, ==, len);
373 /* The whole packet has been transferred. */
374 last = sp->hdr.flags & RXRPC_LAST_PACKET;
375 if (!(flags & MSG_PEEK))
376 rxrpc_rotate_rx_window(call);
381 ASSERTCMP(seq, ==, READ_ONCE(call->rx_top));
388 if (!(flags & MSG_PEEK)) {
389 call->rx_pkt_offset = rx_pkt_offset;
390 call->rx_pkt_len = rx_pkt_len;
393 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_data_return, seq,
394 rx_pkt_offset, rx_pkt_len, ret);
399 * Receive a message from an RxRPC socket
400 * - we need to be careful about two or more threads calling recvmsg
403 int rxrpc_recvmsg(struct socket *sock, struct msghdr *msg, size_t len,
406 struct rxrpc_call *call;
407 struct rxrpc_sock *rx = rxrpc_sk(sock->sk);
415 trace_rxrpc_recvmsg(NULL, rxrpc_recvmsg_enter, 0, 0, 0, 0);
417 if (flags & (MSG_OOB | MSG_TRUNC))
420 timeo = sock_rcvtimeo(&rx->sk, flags & MSG_DONTWAIT);
425 /* Return immediately if a client socket has no outstanding calls */
426 if (RB_EMPTY_ROOT(&rx->calls) &&
427 list_empty(&rx->recvmsg_q) &&
428 rx->sk.sk_state != RXRPC_SERVER_LISTENING) {
429 release_sock(&rx->sk);
433 if (list_empty(&rx->recvmsg_q)) {
440 release_sock(&rx->sk);
442 /* Wait for something to happen */
443 prepare_to_wait_exclusive(sk_sleep(&rx->sk), &wait,
445 ret = sock_error(&rx->sk);
449 if (list_empty(&rx->recvmsg_q)) {
450 if (signal_pending(current))
451 goto wait_interrupted;
452 trace_rxrpc_recvmsg(NULL, rxrpc_recvmsg_wait,
454 timeo = schedule_timeout(timeo);
456 finish_wait(sk_sleep(&rx->sk), &wait);
460 /* Find the next call and dequeue it if we're not just peeking. If we
461 * do dequeue it, that comes with a ref that we will need to release.
463 write_lock_bh(&rx->recvmsg_lock);
464 l = rx->recvmsg_q.next;
465 call = list_entry(l, struct rxrpc_call, recvmsg_link);
466 if (!(flags & MSG_PEEK))
467 list_del_init(&call->recvmsg_link);
469 rxrpc_get_call(call, rxrpc_call_got);
470 write_unlock_bh(&rx->recvmsg_lock);
472 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_dequeue, 0, 0, 0, 0);
474 if (test_bit(RXRPC_CALL_RELEASED, &call->flags))
477 if (test_bit(RXRPC_CALL_HAS_USERID, &call->flags)) {
478 if (flags & MSG_CMSG_COMPAT) {
479 unsigned int id32 = call->user_call_ID;
481 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_USER_CALL_ID,
482 sizeof(unsigned int), &id32);
484 ret = put_cmsg(msg, SOL_RXRPC, RXRPC_USER_CALL_ID,
485 sizeof(unsigned long),
486 &call->user_call_ID);
493 size_t len = sizeof(call->conn->params.peer->srx);
494 memcpy(msg->msg_name, &call->conn->params.peer->srx, len);
495 msg->msg_namelen = len;
498 switch (call->state) {
499 case RXRPC_CALL_SERVER_ACCEPTING:
500 ret = rxrpc_recvmsg_new_call(rx, call, msg, flags);
502 case RXRPC_CALL_CLIENT_RECV_REPLY:
503 case RXRPC_CALL_SERVER_RECV_REQUEST:
504 case RXRPC_CALL_SERVER_ACK_REQUEST:
505 ret = rxrpc_recvmsg_data(sock, call, msg, &msg->msg_iter, len,
510 if (after(call->rx_top, call->rx_hard_ack) &&
511 call->rxtx_buffer[(call->rx_hard_ack + 1) & RXRPC_RXTX_BUFF_MASK])
512 rxrpc_notify_socket(call);
522 if (call->state == RXRPC_CALL_COMPLETE) {
523 ret = rxrpc_recvmsg_term(call, msg);
526 if (!(flags & MSG_PEEK))
527 rxrpc_release_call(rx, call);
528 msg->msg_flags |= MSG_EOR;
533 msg->msg_flags |= MSG_MORE;
535 msg->msg_flags &= ~MSG_MORE;
539 rxrpc_put_call(call, rxrpc_call_put);
541 release_sock(&rx->sk);
542 trace_rxrpc_recvmsg(call, rxrpc_recvmsg_return, 0, 0, 0, ret);
546 ret = sock_intr_errno(timeo);
548 finish_wait(sk_sleep(&rx->sk), &wait);
554 * rxrpc_kernel_recv_data - Allow a kernel service to receive data/info
555 * @sock: The socket that the call exists on
556 * @call: The call to send data through
557 * @buf: The buffer to receive into
558 * @size: The size of the buffer, including data already read
559 * @_offset: The running offset into the buffer.
560 * @want_more: True if more data is expected to be read
561 * @_abort: Where the abort code is stored if -ECONNABORTED is returned
563 * Allow a kernel service to receive data and pick up information about the
564 * state of a call. Returns 0 if got what was asked for and there's more
565 * available, 1 if we got what was asked for and we're at the end of the data
566 * and -EAGAIN if we need more data.
568 * Note that we may return -EAGAIN to drain empty packets at the end of the
569 * data, even if we've already copied over the requested data.
571 * This function adds the amount it transfers to *_offset, so this should be
572 * precleared as appropriate. Note that the amount remaining in the buffer is
573 * taken to be size - *_offset.
575 * *_abort should also be initialised to 0.
577 int rxrpc_kernel_recv_data(struct socket *sock, struct rxrpc_call *call,
578 void *buf, size_t size, size_t *_offset,
579 bool want_more, u32 *_abort)
581 struct iov_iter iter;
585 _enter("{%d,%s},%zu/%zu,%d",
586 call->debug_id, rxrpc_call_states[call->state],
587 *_offset, size, want_more);
589 ASSERTCMP(*_offset, <=, size);
590 ASSERTCMP(call->state, !=, RXRPC_CALL_SERVER_ACCEPTING);
592 iov.iov_base = buf + *_offset;
593 iov.iov_len = size - *_offset;
594 iov_iter_kvec(&iter, ITER_KVEC | READ, &iov, 1, size - *_offset);
598 switch (call->state) {
599 case RXRPC_CALL_CLIENT_RECV_REPLY:
600 case RXRPC_CALL_SERVER_RECV_REQUEST:
601 case RXRPC_CALL_SERVER_ACK_REQUEST:
602 ret = rxrpc_recvmsg_data(sock, call, NULL, &iter, size, 0,
607 /* We can only reach here with a partially full buffer if we
608 * have reached the end of the data. We must otherwise have a
609 * full buffer or have been given -EAGAIN.
615 goto read_phase_complete;
624 case RXRPC_CALL_COMPLETE:
635 release_sock(sock->sk);
636 _leave(" = %d [%zu,%d]", ret, *_offset, *_abort);
646 *_abort = call->abort_code;
648 if (call->completion == RXRPC_CALL_SUCCEEDED) {
655 EXPORT_SYMBOL(rxrpc_kernel_recv_data);