net/rds/rds.h

   1 #ifndef _RDS_RDS_H
   2 #define _RDS_RDS_H
   3
   4 #include <net/sock.h>
   5 #include <linux/scatterlist.h>
   6 #include <linux/highmem.h>
   7 #include <rdma/rdma_cm.h>
   8 #include <linux/mutex.h>
   9 #include <linux/rds.h>
  10
  11 #include "info.h"
  12
  13 /*
  14  * RDS Network protocol version
  15  */
  16 #define RDS_PROTOCOL_3_0        0x0300
  17 #define RDS_PROTOCOL_3_1        0x0301
  18 #define RDS_PROTOCOL_VERSION    RDS_PROTOCOL_3_1
  19 #define RDS_PROTOCOL_MAJOR(v)   ((v) >> 8)
  20 #define RDS_PROTOCOL_MINOR(v)   ((v) & 255)
  21 #define RDS_PROTOCOL(maj, min)  (((maj) << 8) | min)
  22
  23 /*
  24  * XXX randomly chosen, but at least seems to be unused:
  25  * #               18464-18768 Unassigned
  26  * We should do better.  We want a reserved port to discourage unpriv'ed
  27  * userspace from listening.
  28  */
  29 #define RDS_PORT        18634
  30
  31 #ifdef ATOMIC64_INIT
  32 #define KERNEL_HAS_ATOMIC64
  33 #endif
  34
  35 #ifdef DEBUG
  36 #define rdsdebug(fmt, args...) pr_debug("%s(): " fmt, __func__ , ##args)
  37 #else
  38 /* sigh, pr_debug() causes unused variable warnings */
  39 static inline void __attribute__ ((format (printf, 1, 2)))
  40 rdsdebug(char *fmt, ...)
  41 {
  42 }
  43 #endif
  44
  45 /* XXX is there one of these somewhere? */
  46 #define ceil(x, y) \
  47         ({ unsigned long __x = (x), __y = (y); (__x + __y - 1) / __y; })
  48
  49 #define RDS_FRAG_SHIFT  12
  50 #define RDS_FRAG_SIZE   ((unsigned int)(1 << RDS_FRAG_SHIFT))
  51
  52 #define RDS_CONG_MAP_BYTES      (65536 / 8)
  53 #define RDS_CONG_MAP_LONGS      (RDS_CONG_MAP_BYTES / sizeof(unsigned long))
  54 #define RDS_CONG_MAP_PAGES      (PAGE_ALIGN(RDS_CONG_MAP_BYTES) / PAGE_SIZE)
  55 #define RDS_CONG_MAP_PAGE_BITS  (PAGE_SIZE * 8)
  56
  57 struct rds_cong_map {
  58         struct rb_node          m_rb_node;
  59         __be32                  m_addr;
  60         wait_queue_head_t       m_waitq;
  61         struct list_head        m_conn_list;
  62         unsigned long           m_page_addrs[RDS_CONG_MAP_PAGES];
  63 };
  64
  65
  66 /*
  67  * This is how we will track the connection state:
  68  * A connection is always in one of the following
  69  * states. Updates to the state are atomic and imply
  70  * a memory barrier.
  71  */
  72 enum {
  73         RDS_CONN_DOWN = 0,
  74         RDS_CONN_CONNECTING,
  75         RDS_CONN_DISCONNECTING,
  76         RDS_CONN_UP,
  77         RDS_CONN_ERROR,
  78 };
  79
  80 /* Bits for c_flags */
  81 #define RDS_LL_SEND_FULL        0
  82 #define RDS_RECONNECT_PENDING   1
  83
  84 struct rds_connection {
  85         struct hlist_node       c_hash_node;
  86         __be32                  c_laddr;
  87         __be32                  c_faddr;
  88         unsigned int            c_loopback:1;
  89         struct rds_connection   *c_passive;
  90
  91         struct rds_cong_map     *c_lcong;
  92         struct rds_cong_map     *c_fcong;
  93
  94         spinlock_t              c_send_lock;    /* protect send ring */
  95         atomic_t                c_send_generation;
  96         atomic_t                c_senders;
  97         struct rds_message      *c_xmit_rm;
  98         unsigned long           c_xmit_sg;
  99         unsigned int            c_xmit_hdr_off;
 100         unsigned int            c_xmit_data_off;
 101         unsigned int            c_xmit_atomic_sent;
 102         unsigned int            c_xmit_rdma_sent;
 103         unsigned int            c_xmit_data_sent;
 104
 105         spinlock_t              c_lock;         /* protect msg queues */
 106         u64                     c_next_tx_seq;
 107         struct list_head        c_send_queue;
 108         struct list_head        c_retrans;
 109
 110         u64                     c_next_rx_seq;
 111
 112         struct rds_transport    *c_trans;
 113         void                    *c_transport_data;
 114
 115         atomic_t                c_state;
 116         unsigned long           c_flags;
 117         unsigned long           c_reconnect_jiffies;
 118         struct delayed_work     c_send_w;
 119         struct delayed_work     c_recv_w;
 120         struct delayed_work     c_conn_w;
 121         struct work_struct      c_down_w;
 122         struct mutex            c_cm_lock;      /* protect conn state & cm */
 123
 124         struct list_head        c_map_item;
 125         unsigned long           c_map_queued;
 126
 127         unsigned int            c_unacked_packets;
 128         unsigned int            c_unacked_bytes;
 129
 130         /* Protocol version */
 131         unsigned int            c_version;
 132 };
 133
 134 #define RDS_FLAG_CONG_BITMAP    0x01
 135 #define RDS_FLAG_ACK_REQUIRED   0x02
 136 #define RDS_FLAG_RETRANSMITTED  0x04
 137 #define RDS_MAX_ADV_CREDIT      255
 138
 139 /*
 140  * Maximum space available for extension headers.
 141  */
 142 #define RDS_HEADER_EXT_SPACE    16
 143
 144 struct rds_header {
 145         __be64  h_sequence;
 146         __be64  h_ack;
 147         __be32  h_len;
 148         __be16  h_sport;
 149         __be16  h_dport;
 150         u8      h_flags;
 151         u8      h_credit;
 152         u8      h_padding[4];
 153         __sum16 h_csum;
 154
 155         u8      h_exthdr[RDS_HEADER_EXT_SPACE];
 156 };
 157
 158 /*
 159  * Reserved - indicates end of extensions
 160  */
 161 #define RDS_EXTHDR_NONE         0
 162
 163 /*
 164  * This extension header is included in the very
 165  * first message that is sent on a new connection,
 166  * and identifies the protocol level. This will help
 167  * rolling updates if a future change requires breaking
 168  * the protocol.
 169  * NB: This is no longer true for IB, where we do a version
 170  * negotiation during the connection setup phase (protocol
 171  * version information is included in the RDMA CM private data).
 172  */
 173 #define RDS_EXTHDR_VERSION      1
 174 struct rds_ext_header_version {
 175         __be32                  h_version;
 176 };
 177
 178 /*
 179  * This extension header is included in the RDS message
 180  * chasing an RDMA operation.
 181  */
 182 #define RDS_EXTHDR_RDMA         2
 183 struct rds_ext_header_rdma {
 184         __be32                  h_rdma_rkey;
 185 };
 186
 187 /*
 188  * This extension header tells the peer about the
 189  * destination <R_Key,offset> of the requested RDMA
 190  * operation.
 191  */
 192 #define RDS_EXTHDR_RDMA_DEST    3
 193 struct rds_ext_header_rdma_dest {
 194         __be32                  h_rdma_rkey;
 195         __be32                  h_rdma_offset;
 196 };
 197
 198 #define __RDS_EXTHDR_MAX        16 /* for now */
 199
 200 struct rds_incoming {
 201         atomic_t                i_refcount;
 202         struct list_head        i_item;
 203         struct rds_connection   *i_conn;
 204         struct rds_header       i_hdr;
 205         unsigned long           i_rx_jiffies;
 206         __be32                  i_saddr;
 207
 208         rds_rdma_cookie_t       i_rdma_cookie;
 209 };
 210
 211 struct rds_mr {
 212         struct rb_node          r_rb_node;
 213         atomic_t                r_refcount;
 214         u32                     r_key;
 215
 216         /* A copy of the creation flags */
 217         unsigned int            r_use_once:1;
 218         unsigned int            r_invalidate:1;
 219         unsigned int            r_write:1;
 220
 221         /* This is for RDS_MR_DEAD.
 222          * It would be nice & consistent to make this part of the above
 223          * bit field here, but we need to use test_and_set_bit.
 224          */
 225         unsigned long           r_state;
 226         struct rds_sock         *r_sock; /* back pointer to the socket that owns us */
 227         struct rds_transport    *r_trans;
 228         void                    *r_trans_private;
 229 };
 230
 231 /* Flags for mr->r_state */
 232 #define RDS_MR_DEAD             0
 233
 234 static inline rds_rdma_cookie_t rds_rdma_make_cookie(u32 r_key, u32 offset)
 235 {
 236         return r_key | (((u64) offset) << 32);
 237 }
 238
 239 static inline u32 rds_rdma_cookie_key(rds_rdma_cookie_t cookie)
 240 {
 241         return cookie;
 242 }
 243
 244 static inline u32 rds_rdma_cookie_offset(rds_rdma_cookie_t cookie)
 245 {
 246         return cookie >> 32;
 247 }
 248
 249 /* atomic operation types */
 250 #define RDS_ATOMIC_TYPE_CSWP            0
 251 #define RDS_ATOMIC_TYPE_FADD            1
 252
 253 /*
 254  * m_sock_item and m_conn_item are on lists that are serialized under
 255  * conn->c_lock.  m_sock_item has additional meaning in that once it is empty
 256  * the message will not be put back on the retransmit list after being sent.
 257  * messages that are canceled while being sent rely on this.
 258  *
 259  * m_inc is used by loopback so that it can pass an incoming message straight
 260  * back up into the rx path.  It embeds a wire header which is also used by
 261  * the send path, which is kind of awkward.
 262  *
 263  * m_sock_item indicates the message's presence on a socket's send or receive
 264  * queue.  m_rs will point to that socket.
 265  *
 266  * m_daddr is used by cancellation to prune messages to a given destination.
 267  *
 268  * The RDS_MSG_ON_SOCK and RDS_MSG_ON_CONN flags are used to avoid lock
 269  * nesting.  As paths iterate over messages on a sock, or conn, they must
 270  * also lock the conn, or sock, to remove the message from those lists too.
 271  * Testing the flag to determine if the message is still on the lists lets
 272  * us avoid testing the list_head directly.  That means each path can use
 273  * the message's list_head to keep it on a local list while juggling locks
 274  * without confusing the other path.
 275  *
 276  * m_ack_seq is an optional field set by transports who need a different
 277  * sequence number range to invalidate.  They can use this in a callback
 278  * that they pass to rds_send_drop_acked() to see if each message has been
 279  * acked.  The HAS_ACK_SEQ flag can be used to detect messages which haven't
 280  * had ack_seq set yet.
 281  */
 282 #define RDS_MSG_ON_SOCK         1
 283 #define RDS_MSG_ON_CONN         2
 284 #define RDS_MSG_HAS_ACK_SEQ     3
 285 #define RDS_MSG_ACK_REQUIRED    4
 286 #define RDS_MSG_RETRANSMITTED   5
 287 #define RDS_MSG_MAPPED          6
 288 #define RDS_MSG_PAGEVEC         7
 289
 290 struct rds_message {
 291         atomic_t                m_refcount;
 292         struct list_head        m_sock_item;
 293         struct list_head        m_conn_item;
 294         struct rds_incoming     m_inc;
 295         u64                     m_ack_seq;
 296         __be32                  m_daddr;
 297         unsigned long           m_flags;
 298
 299         /* Never access m_rs without holding m_rs_lock.
 300          * Lock nesting is
 301          *  rm->m_rs_lock
 302          *   -> rs->rs_lock
 303          */
 304         spinlock_t              m_rs_lock;
 305         wait_queue_head_t       m_flush_wait;
 306
 307         struct rds_sock         *m_rs;
 308
 309         /* cookie to send to remote, in rds header */
 310         rds_rdma_cookie_t       m_rdma_cookie;
 311
 312         unsigned int            m_used_sgs;
 313         unsigned int            m_total_sgs;
 314
 315         void                    *m_final_op;
 316
 317         struct {
 318                 struct rm_atomic_op {
 319                         int                     op_type;
 320                         uint64_t                op_swap_add;
 321                         uint64_t                op_compare;
 322
 323                         u32                     op_rkey;
 324                         u64                     op_remote_addr;
 325                         unsigned int            op_notify:1;
 326                         unsigned int            op_recverr:1;
 327                         unsigned int            op_mapped:1;
 328                         unsigned int            op_silent:1;
 329                         unsigned int            op_active:1;
 330                         struct scatterlist      *op_sg;
 331                         struct rds_notifier     *op_notifier;
 332
 333                         struct rds_mr           *op_rdma_mr;
 334                 } atomic;
 335                 struct rm_rdma_op {
 336                         u32                     op_rkey;
 337                         u64                     op_remote_addr;
 338                         unsigned int            op_write:1;
 339                         unsigned int            op_fence:1;
 340                         unsigned int            op_notify:1;
 341                         unsigned int            op_recverr:1;
 342                         unsigned int            op_mapped:1;
 343                         unsigned int            op_silent:1;
 344                         unsigned int            op_active:1;
 345                         unsigned int            op_bytes;
 346                         unsigned int            op_nents;
 347                         unsigned int            op_count;
 348                         struct scatterlist      *op_sg;
 349                         struct rds_notifier     *op_notifier;
 350
 351                         struct rds_mr           *op_rdma_mr;
 352                 } rdma;
 353                 struct rm_data_op {
 354                         unsigned int            op_active:1;
 355                         unsigned int            op_nents;
 356                         unsigned int            op_count;
 357                         struct scatterlist      *op_sg;
 358                 } data;
 359         };
 360 };
 361
 362 /*
 363  * The RDS notifier is used (optionally) to tell the application about
 364  * completed RDMA operations. Rather than keeping the whole rds message
 365  * around on the queue, we allocate a small notifier that is put on the
 366  * socket's notifier_list. Notifications are delivered to the application
 367  * through control messages.
 368  */
 369 struct rds_notifier {
 370         struct list_head        n_list;
 371         uint64_t                n_user_token;
 372         int                     n_status;
 373 };
 374
 375 /**
 376  * struct rds_transport -  transport specific behavioural hooks
 377  *
 378  * @xmit: .xmit is called by rds_send_xmit() to tell the transport to send
 379  *        part of a message.  The caller serializes on the send_sem so this
 380  *        doesn't need to be reentrant for a given conn.  The header must be
 381  *        sent before the data payload.  .xmit must be prepared to send a
 382  *        message with no data payload.  .xmit should return the number of
 383  *        bytes that were sent down the connection, including header bytes.
 384  *        Returning 0 tells the caller that it doesn't need to perform any
 385  *        additional work now.  This is usually the case when the transport has
 386  *        filled the sending queue for its connection and will handle
 387  *        triggering the rds thread to continue the send when space becomes
 388  *        available.  Returning -EAGAIN tells the caller to retry the send
 389  *        immediately.  Returning -ENOMEM tells the caller to retry the send at
 390  *        some point in the future.
 391  *
 392  * @conn_shutdown: conn_shutdown stops traffic on the given connection.  Once
 393  *                 it returns the connection can not call rds_recv_incoming().
 394  *                 This will only be called once after conn_connect returns
 395  *                 non-zero success and will The caller serializes this with
 396  *                 the send and connecting paths (xmit_* and conn_*).  The
 397  *                 transport is responsible for other serialization, including
 398  *                 rds_recv_incoming().  This is called in process context but
 399  *                 should try hard not to block.
 400  */
 401
 402 #define RDS_TRANS_IB    0
 403 #define RDS_TRANS_IWARP 1
 404 #define RDS_TRANS_TCP   2
 405 #define RDS_TRANS_COUNT 3
 406
 407 struct rds_transport {
 408         char                    t_name[TRANSNAMSIZ];
 409         struct list_head        t_item;
 410         struct module           *t_owner;
 411         unsigned int            t_prefer_loopback:1;
 412         unsigned int            t_type;
 413
 414         int (*laddr_check)(__be32 addr);
 415         int (*conn_alloc)(struct rds_connection *conn, gfp_t gfp);
 416         void (*conn_free)(void *data);
 417         int (*conn_connect)(struct rds_connection *conn);
 418         void (*conn_shutdown)(struct rds_connection *conn);
 419         void (*xmit_prepare)(struct rds_connection *conn);
 420         void (*xmit_complete)(struct rds_connection *conn);
 421         int (*xmit)(struct rds_connection *conn, struct rds_message *rm,
 422                     unsigned int hdr_off, unsigned int sg, unsigned int off);
 423         int (*xmit_rdma)(struct rds_connection *conn, struct rm_rdma_op *op);
 424         int (*xmit_atomic)(struct rds_connection *conn, struct rm_atomic_op *op);
 425         int (*recv)(struct rds_connection *conn);
 426         int (*inc_copy_to_user)(struct rds_incoming *inc, struct iovec *iov,
 427                                 size_t size);
 428         void (*inc_free)(struct rds_incoming *inc);
 429
 430         int (*cm_handle_connect)(struct rdma_cm_id *cm_id,
 431                                  struct rdma_cm_event *event);
 432         int (*cm_initiate_connect)(struct rdma_cm_id *cm_id);
 433         void (*cm_connect_complete)(struct rds_connection *conn,
 434                                     struct rdma_cm_event *event);
 435
 436         unsigned int (*stats_info_copy)(struct rds_info_iterator *iter,
 437                                         unsigned int avail);
 438         void (*exit)(void);
 439         void *(*get_mr)(struct scatterlist *sg, unsigned long nr_sg,
 440                         struct rds_sock *rs, u32 *key_ret);
 441         void (*sync_mr)(void *trans_private, int direction);
 442         void (*free_mr)(void *trans_private, int invalidate);
 443         void (*flush_mrs)(void);
 444 };
 445
 446 struct rds_sock {
 447         struct sock             rs_sk;
 448
 449         u64                     rs_user_addr;
 450         u64                     rs_user_bytes;
 451
 452         /*
 453          * bound_addr used for both incoming and outgoing, no INADDR_ANY
 454          * support.
 455          */
 456         struct hlist_node       rs_bound_node;
 457         __be32                  rs_bound_addr;
 458         __be32                  rs_conn_addr;
 459         __be16                  rs_bound_port;
 460         __be16                  rs_conn_port;
 461
 462         /*
 463          * This is only used to communicate the transport between bind and
 464          * initiating connections.  All other trans use is referenced through
 465          * the connection.
 466          */
 467         struct rds_transport    *rs_transport;
 468
 469         /*
 470          * rds_sendmsg caches the conn it used the last time around.
 471          * This helps avoid costly lookups.
 472          */
 473         struct rds_connection   *rs_conn;
 474
 475         /* flag indicating we were congested or not */
 476         int                     rs_congested;
 477         /* seen congestion (ENOBUFS) when sending? */
 478         int                     rs_seen_congestion;
 479
 480         /* rs_lock protects all these adjacent members before the newline */
 481         spinlock_t              rs_lock;
 482         struct list_head        rs_send_queue;
 483         u32                     rs_snd_bytes;
 484         int                     rs_rcv_bytes;
 485         struct list_head        rs_notify_queue;        /* currently used for failed RDMAs */
 486
 487         /* Congestion wake_up. If rs_cong_monitor is set, we use cong_mask
 488          * to decide whether the application should be woken up.
 489          * If not set, we use rs_cong_track to find out whether a cong map
 490          * update arrived.
 491          */
 492         uint64_t                rs_cong_mask;
 493         uint64_t                rs_cong_notify;
 494         struct list_head        rs_cong_list;
 495         unsigned long           rs_cong_track;
 496
 497         /*
 498          * rs_recv_lock protects the receive queue, and is
 499          * used to serialize with rds_release.
 500          */
 501         rwlock_t                rs_recv_lock;
 502         struct list_head        rs_recv_queue;
 503
 504         /* just for stats reporting */
 505         struct list_head        rs_item;
 506
 507         /* these have their own lock */
 508         spinlock_t              rs_rdma_lock;
 509         struct rb_root          rs_rdma_keys;
 510
 511         /* Socket options - in case there will be more */
 512         unsigned char           rs_recverr,
 513                                 rs_cong_monitor;
 514 };
 515
 516 static inline struct rds_sock *rds_sk_to_rs(const struct sock *sk)
 517 {
 518         return container_of(sk, struct rds_sock, rs_sk);
 519 }
 520 static inline struct sock *rds_rs_to_sk(struct rds_sock *rs)
 521 {
 522         return &rs->rs_sk;
 523 }
 524
 525 /*
 526  * The stack assigns sk_sndbuf and sk_rcvbuf to twice the specified value
 527  * to account for overhead.  We don't account for overhead, we just apply
 528  * the number of payload bytes to the specified value.
 529  */
 530 static inline int rds_sk_sndbuf(struct rds_sock *rs)
 531 {
 532         return rds_rs_to_sk(rs)->sk_sndbuf / 2;
 533 }
 534 static inline int rds_sk_rcvbuf(struct rds_sock *rs)
 535 {
 536         return rds_rs_to_sk(rs)->sk_rcvbuf / 2;
 537 }
 538
 539 struct rds_statistics {
 540         uint64_t        s_conn_reset;
 541         uint64_t        s_recv_drop_bad_checksum;
 542         uint64_t        s_recv_drop_old_seq;
 543         uint64_t        s_recv_drop_no_sock;
 544         uint64_t        s_recv_drop_dead_sock;
 545         uint64_t        s_recv_deliver_raced;
 546         uint64_t        s_recv_delivered;
 547         uint64_t        s_recv_queued;
 548         uint64_t        s_recv_immediate_retry;
 549         uint64_t        s_recv_delayed_retry;
 550         uint64_t        s_recv_ack_required;
 551         uint64_t        s_recv_rdma_bytes;
 552         uint64_t        s_recv_ping;
 553         uint64_t        s_send_queue_empty;
 554         uint64_t        s_send_queue_full;
 555         uint64_t        s_send_lock_contention;
 556         uint64_t        s_send_lock_queue_raced;
 557         uint64_t        s_send_immediate_retry;
 558         uint64_t        s_send_delayed_retry;
 559         uint64_t        s_send_drop_acked;
 560         uint64_t        s_send_ack_required;
 561         uint64_t        s_send_queued;
 562         uint64_t        s_send_rdma;
 563         uint64_t        s_send_rdma_bytes;
 564         uint64_t        s_send_pong;
 565         uint64_t        s_page_remainder_hit;
 566         uint64_t        s_page_remainder_miss;
 567         uint64_t        s_copy_to_user;
 568         uint64_t        s_copy_from_user;
 569         uint64_t        s_cong_update_queued;
 570         uint64_t        s_cong_update_received;
 571         uint64_t        s_cong_send_error;
 572         uint64_t        s_cong_send_blocked;
 573 };
 574
 575 /* af_rds.c */
 576 void rds_sock_addref(struct rds_sock *rs);
 577 void rds_sock_put(struct rds_sock *rs);
 578 void rds_wake_sk_sleep(struct rds_sock *rs);
 579 static inline void __rds_wake_sk_sleep(struct sock *sk)
 580 {
 581         wait_queue_head_t *waitq = sk_sleep(sk);
 582
 583         if (!sock_flag(sk, SOCK_DEAD) && waitq)
 584                 wake_up(waitq);
 585 }
 586 extern wait_queue_head_t rds_poll_waitq;
 587
 588
 589 /* bind.c */
 590 int rds_bind(struct socket *sock, struct sockaddr *uaddr, int addr_len);
 591 void rds_remove_bound(struct rds_sock *rs);
 592 struct rds_sock *rds_find_bound(__be32 addr, __be16 port);
 593
 594 /* cong.c */
 595 int rds_cong_get_maps(struct rds_connection *conn);
 596 void rds_cong_add_conn(struct rds_connection *conn);
 597 void rds_cong_remove_conn(struct rds_connection *conn);
 598 void rds_cong_set_bit(struct rds_cong_map *map, __be16 port);
 599 void rds_cong_clear_bit(struct rds_cong_map *map, __be16 port);
 600 int rds_cong_wait(struct rds_cong_map *map, __be16 port, int nonblock, struct rds_sock *rs);
 601 void rds_cong_queue_updates(struct rds_cong_map *map);
 602 void rds_cong_map_updated(struct rds_cong_map *map, uint64_t);
 603 int rds_cong_updated_since(unsigned long *recent);
 604 void rds_cong_add_socket(struct rds_sock *);
 605 void rds_cong_remove_socket(struct rds_sock *);
 606 void rds_cong_exit(void);
 607 struct rds_message *rds_cong_update_alloc(struct rds_connection *conn);
 608
 609 /* conn.c */
 610 int __init rds_conn_init(void);
 611 void rds_conn_exit(void);
 612 struct rds_connection *rds_conn_create(__be32 laddr, __be32 faddr,
 613                                        struct rds_transport *trans, gfp_t gfp);
 614 struct rds_connection *rds_conn_create_outgoing(__be32 laddr, __be32 faddr,
 615                                struct rds_transport *trans, gfp_t gfp);
 616 void rds_conn_shutdown(struct rds_connection *conn);
 617 void rds_conn_destroy(struct rds_connection *conn);
 618 void rds_conn_reset(struct rds_connection *conn);
 619 void rds_conn_drop(struct rds_connection *conn);
 620 void rds_for_each_conn_info(struct socket *sock, unsigned int len,
 621                           struct rds_info_iterator *iter,
 622                           struct rds_info_lengths *lens,
 623                           int (*visitor)(struct rds_connection *, void *),
 624                           size_t item_len);
 625 void __rds_conn_error(struct rds_connection *conn, const char *, ...)
 626                                 __attribute__ ((format (printf, 2, 3)));
 627 #define rds_conn_error(conn, fmt...) \
 628         __rds_conn_error(conn, KERN_WARNING "RDS: " fmt)
 629
 630 static inline int
 631 rds_conn_transition(struct rds_connection *conn, int old, int new)
 632 {
 633         return atomic_cmpxchg(&conn->c_state, old, new) == old;
 634 }
 635
 636 static inline int
 637 rds_conn_state(struct rds_connection *conn)
 638 {
 639         return atomic_read(&conn->c_state);
 640 }
 641
 642 static inline int
 643 rds_conn_up(struct rds_connection *conn)
 644 {
 645         return atomic_read(&conn->c_state) == RDS_CONN_UP;
 646 }
 647
 648 static inline int
 649 rds_conn_connecting(struct rds_connection *conn)
 650 {
 651         return atomic_read(&conn->c_state) == RDS_CONN_CONNECTING;
 652 }
 653
 654 /* message.c */
 655 struct rds_message *rds_message_alloc(unsigned int nents, gfp_t gfp);
 656 struct scatterlist *rds_message_alloc_sgs(struct rds_message *rm, int nents);
 657 int rds_message_copy_from_user(struct rds_message *rm, struct iovec *first_iov,
 658                                                size_t total_len);
 659 struct rds_message *rds_message_map_pages(unsigned long *page_addrs, unsigned int total_len);
 660 void rds_message_populate_header(struct rds_header *hdr, __be16 sport,
 661                                  __be16 dport, u64 seq);
 662 int rds_message_add_extension(struct rds_header *hdr,
 663                               unsigned int type, const void *data, unsigned int len);
 664 int rds_message_next_extension(struct rds_header *hdr,
 665                                unsigned int *pos, void *buf, unsigned int *buflen);
 666 int rds_message_add_version_extension(struct rds_header *hdr, unsigned int version);
 667 int rds_message_get_version_extension(struct rds_header *hdr, unsigned int *version);
 668 int rds_message_add_rdma_dest_extension(struct rds_header *hdr, u32 r_key, u32 offset);
 669 int rds_message_inc_copy_to_user(struct rds_incoming *inc,
 670                                  struct iovec *first_iov, size_t size);
 671 void rds_message_inc_free(struct rds_incoming *inc);
 672 void rds_message_addref(struct rds_message *rm);
 673 void rds_message_put(struct rds_message *rm);
 674 void rds_message_wait(struct rds_message *rm);
 675 void rds_message_unmapped(struct rds_message *rm);
 676
 677 static inline void rds_message_make_checksum(struct rds_header *hdr)
 678 {
 679         hdr->h_csum = 0;
 680         hdr->h_csum = ip_fast_csum((void *) hdr, sizeof(*hdr) >> 2);
 681 }
 682
 683 static inline int rds_message_verify_checksum(const struct rds_header *hdr)
 684 {
 685         return !hdr->h_csum || ip_fast_csum((void *) hdr, sizeof(*hdr) >> 2) == 0;
 686 }
 687
 688
 689 /* page.c */
 690 int rds_page_remainder_alloc(struct scatterlist *scat, unsigned long bytes,
 691                              gfp_t gfp);
 692 int rds_page_copy_user(struct page *page, unsigned long offset,
 693                        void __user *ptr, unsigned long bytes,
 694                        int to_user);
 695 #define rds_page_copy_to_user(page, offset, ptr, bytes) \
 696         rds_page_copy_user(page, offset, ptr, bytes, 1)
 697 #define rds_page_copy_from_user(page, offset, ptr, bytes) \
 698         rds_page_copy_user(page, offset, ptr, bytes, 0)
 699 void rds_page_exit(void);
 700
 701 /* recv.c */
 702 void rds_inc_init(struct rds_incoming *inc, struct rds_connection *conn,
 703                   __be32 saddr);
 704 void rds_inc_addref(struct rds_incoming *inc);
 705 void rds_inc_put(struct rds_incoming *inc);
 706 void rds_recv_incoming(struct rds_connection *conn, __be32 saddr, __be32 daddr,
 707                        struct rds_incoming *inc, gfp_t gfp, enum km_type km);
 708 int rds_recvmsg(struct kiocb *iocb, struct socket *sock, struct msghdr *msg,
 709                 size_t size, int msg_flags);
 710 void rds_clear_recv_queue(struct rds_sock *rs);
 711 int rds_notify_queue_get(struct rds_sock *rs, struct msghdr *msg);
 712 void rds_inc_info_copy(struct rds_incoming *inc,
 713                        struct rds_info_iterator *iter,
 714                        __be32 saddr, __be32 daddr, int flip);
 715
 716 /* send.c */
 717 int rds_sendmsg(struct kiocb *iocb, struct socket *sock, struct msghdr *msg,
 718                 size_t payload_len);
 719 void rds_send_reset(struct rds_connection *conn);
 720 int rds_send_xmit(struct rds_connection *conn);
 721 struct sockaddr_in;
 722 void rds_send_drop_to(struct rds_sock *rs, struct sockaddr_in *dest);
 723 typedef int (*is_acked_func)(struct rds_message *rm, uint64_t ack);
 724 void rds_send_drop_acked(struct rds_connection *conn, u64 ack,
 725                          is_acked_func is_acked);
 726 int rds_send_acked_before(struct rds_connection *conn, u64 seq);
 727 void rds_send_remove_from_sock(struct list_head *messages, int status);
 728 int rds_send_pong(struct rds_connection *conn, __be16 dport);
 729 struct rds_message *rds_send_get_message(struct rds_connection *,
 730                                          struct rm_rdma_op *);
 731
 732 /* rdma.c */
 733 void rds_rdma_unuse(struct rds_sock *rs, u32 r_key, int force);
 734 int rds_get_mr(struct rds_sock *rs, char __user *optval, int optlen);
 735 int rds_get_mr_for_dest(struct rds_sock *rs, char __user *optval, int optlen);
 736 int rds_free_mr(struct rds_sock *rs, char __user *optval, int optlen);
 737 void rds_rdma_drop_keys(struct rds_sock *rs);
 738 int rds_rdma_extra_size(struct rds_rdma_args *args);
 739 int rds_cmsg_rdma_args(struct rds_sock *rs, struct rds_message *rm,
 740                           struct cmsghdr *cmsg);
 741 int rds_cmsg_rdma_dest(struct rds_sock *rs, struct rds_message *rm,
 742                           struct cmsghdr *cmsg);
 743 int rds_cmsg_rdma_args(struct rds_sock *rs, struct rds_message *rm,
 744                           struct cmsghdr *cmsg);
 745 int rds_cmsg_rdma_map(struct rds_sock *rs, struct rds_message *rm,
 746                           struct cmsghdr *cmsg);
 747 void rds_rdma_free_op(struct rm_rdma_op *ro);
 748 void rds_atomic_free_op(struct rm_atomic_op *ao);
 749 void rds_rdma_send_complete(struct rds_message *rm, int wc_status);
 750 void rds_atomic_send_complete(struct rds_message *rm, int wc_status);
 751 int rds_cmsg_atomic(struct rds_sock *rs, struct rds_message *rm,
 752                     struct cmsghdr *cmsg);
 753
 754 extern void __rds_put_mr_final(struct rds_mr *mr);
 755 static inline void rds_mr_put(struct rds_mr *mr)
 756 {
 757         if (atomic_dec_and_test(&mr->r_refcount))
 758                 __rds_put_mr_final(mr);
 759 }
 760
 761 /* stats.c */
 762 DECLARE_PER_CPU_SHARED_ALIGNED(struct rds_statistics, rds_stats);
 763 #define rds_stats_inc_which(which, member) do {         \
 764         per_cpu(which, get_cpu()).member++;             \
 765         put_cpu();                                      \
 766 } while (0)
 767 #define rds_stats_inc(member) rds_stats_inc_which(rds_stats, member)
 768 #define rds_stats_add_which(which, member, count) do {          \
 769         per_cpu(which, get_cpu()).member += count;      \
 770         put_cpu();                                      \
 771 } while (0)
 772 #define rds_stats_add(member, count) rds_stats_add_which(rds_stats, member, count)
 773 int __init rds_stats_init(void);
 774 void rds_stats_exit(void);
 775 void rds_stats_info_copy(struct rds_info_iterator *iter,
 776                          uint64_t *values, const char *const *names,
 777                          size_t nr);
 778
 779 /* sysctl.c */
 780 int __init rds_sysctl_init(void);
 781 void rds_sysctl_exit(void);
 782 extern unsigned long rds_sysctl_sndbuf_min;
 783 extern unsigned long rds_sysctl_sndbuf_default;
 784 extern unsigned long rds_sysctl_sndbuf_max;
 785 extern unsigned long rds_sysctl_reconnect_min_jiffies;
 786 extern unsigned long rds_sysctl_reconnect_max_jiffies;
 787 extern unsigned int  rds_sysctl_max_unacked_packets;
 788 extern unsigned int  rds_sysctl_max_unacked_bytes;
 789 extern unsigned int  rds_sysctl_ping_enable;
 790 extern unsigned long rds_sysctl_trace_flags;
 791 extern unsigned int  rds_sysctl_trace_level;
 792
 793 /* threads.c */
 794 int __init rds_threads_init(void);
 795 void rds_threads_exit(void);
 796 extern struct workqueue_struct *rds_wq;
 797 void rds_queue_reconnect(struct rds_connection *conn);
 798 void rds_connect_worker(struct work_struct *);
 799 void rds_shutdown_worker(struct work_struct *);
 800 void rds_send_worker(struct work_struct *);
 801 void rds_recv_worker(struct work_struct *);
 802 void rds_connect_complete(struct rds_connection *conn);
 803
 804 /* transport.c */
 805 int rds_trans_register(struct rds_transport *trans);
 806 void rds_trans_unregister(struct rds_transport *trans);
 807 struct rds_transport *rds_trans_get_preferred(__be32 addr);
 808 unsigned int rds_trans_stats_info_copy(struct rds_info_iterator *iter,
 809                                        unsigned int avail);
 810 int __init rds_trans_init(void);
 811 void rds_trans_exit(void);
 812
 813 #endif