1 /* RxRPC kernel service interface definitions
2  *
3  * Copyright (C) 2007 Red Hat, Inc. All Rights Reserved.
4  * Written by David Howells (dhowells@redhat.com)
5  *
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.
10  */
11 
12 #ifndef _NET_RXRPC_H
13 #define _NET_RXRPC_H
14 
15 #include <linux/rxrpc.h>
16 
17 struct key;
18 struct sock;
19 struct socket;
20 struct rxrpc_call;
21 
22 /*
23  * Call completion condition (state == RXRPC_CALL_COMPLETE).
24  */
25 enum rxrpc_call_completion {
26 	RXRPC_CALL_SUCCEEDED,		/* - Normal termination */
27 	RXRPC_CALL_REMOTELY_ABORTED,	/* - call aborted by peer */
28 	RXRPC_CALL_LOCALLY_ABORTED,	/* - call aborted locally on error or close */
29 	RXRPC_CALL_LOCAL_ERROR,		/* - call failed due to local error */
30 	RXRPC_CALL_NETWORK_ERROR,	/* - call terminated by network error */
31 	NR__RXRPC_CALL_COMPLETIONS
32 };
33 
34 /*
35  * Debug ID counter for tracing.
36  */
37 extern atomic_t rxrpc_debug_id;
38 
39 typedef void (*rxrpc_notify_rx_t)(struct sock *, struct rxrpc_call *,
40 				  unsigned long);
41 typedef void (*rxrpc_notify_end_tx_t)(struct sock *, struct rxrpc_call *,
42 				      unsigned long);
43 typedef void (*rxrpc_notify_new_call_t)(struct sock *, struct rxrpc_call *,
44 					unsigned long);
45 typedef void (*rxrpc_discard_new_call_t)(struct rxrpc_call *, unsigned long);
46 typedef void (*rxrpc_user_attach_call_t)(struct rxrpc_call *, unsigned long);
47 
48 void rxrpc_kernel_new_call_notification(struct socket *,
49 					rxrpc_notify_new_call_t,
50 					rxrpc_discard_new_call_t);
51 struct rxrpc_call *rxrpc_kernel_begin_call(struct socket *,
52 					   struct sockaddr_rxrpc *,
53 					   struct key *,
54 					   unsigned long,
55 					   s64,
56 					   gfp_t,
57 					   rxrpc_notify_rx_t,
58 					   bool,
59 					   unsigned int);
60 int rxrpc_kernel_send_data(struct socket *, struct rxrpc_call *,
61 			   struct msghdr *, size_t,
62 			   rxrpc_notify_end_tx_t);
63 int rxrpc_kernel_recv_data(struct socket *, struct rxrpc_call *,
64 			   struct iov_iter *, bool, u32 *, u16 *);
65 bool rxrpc_kernel_abort_call(struct socket *, struct rxrpc_call *,
66 			     u32, int, const char *);
67 void rxrpc_kernel_end_call(struct socket *, struct rxrpc_call *);
68 void rxrpc_kernel_get_peer(struct socket *, struct rxrpc_call *,
69 			   struct sockaddr_rxrpc *);
70 u64 rxrpc_kernel_get_rtt(struct socket *, struct rxrpc_call *);
71 int rxrpc_kernel_charge_accept(struct socket *, rxrpc_notify_rx_t,
72 			       rxrpc_user_attach_call_t, unsigned long, gfp_t,
73 			       unsigned int);
74 void rxrpc_kernel_set_tx_length(struct socket *, struct rxrpc_call *, s64);
75 int rxrpc_kernel_retry_call(struct socket *, struct rxrpc_call *,
76 			    struct sockaddr_rxrpc *, struct key *);
77 int rxrpc_kernel_check_call(struct socket *, struct rxrpc_call *,
78 			    enum rxrpc_call_completion *, u32 *);
79 u32 rxrpc_kernel_check_life(struct socket *, struct rxrpc_call *);
80 
81 #endif /* _NET_RXRPC_H */
82