lnet/klnds/ralnd/ralnd.h

   1 /*
   2  * GPL HEADER START
   3  *
   4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 only,
   8  * as published by the Free Software Foundation.
   9  *
  10  * This program is distributed in the hope that it will be useful, but
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * General Public License version 2 for more details (a copy is included
  14  * in the LICENSE file that accompanied this code).
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * version 2 along with this program; If not, see
  18  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
  19  *
  20  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  21  * CA 95054 USA or visit www.sun.com if you need additional information or
  22  * have any questions.
  23  *
  24  * GPL HEADER END
  25  */
  26 /*
  27  * Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved.
  28  * Use is subject to license terms.
  29  */
  30 /*
  31  * This file is part of Lustre, http://www.lustre.org/
  32  * Lustre is a trademark of Sun Microsystems, Inc.
  33  *
  34  * lnet/klnds/ralnd/ralnd.h
  35  *
  36  * Author: Eric Barton <eric@bartonsoftware.com>
  37  */
  38
  39 #ifndef AUTOCONF_INCLUDED
  40 #include <linux/config.h>
  41 #endif
  42 #include <linux/module.h>
  43 #include <linux/kernel.h>
  44 #include <linux/mm.h>
  45 #include <linux/string.h>
  46 #include <linux/stat.h>
  47 #include <linux/errno.h>
  48 #include <linux/smp_lock.h>
  49 #include <linux/unistd.h>
  50 #include <linux/uio.h>
  51
  52 #include <asm/system.h>
  53 #include <asm/uaccess.h>
  54 #include <asm/io.h>
  55
  56 #include <linux/init.h>
  57 #include <linux/fs.h>
  58 #include <linux/file.h>
  59 #include <linux/stat.h>
  60 #include <linux/list.h>
  61 #include <linux/kmod.h>
  62 #include <linux/sysctl.h>
  63
  64 #include <net/sock.h>
  65 #include <linux/in.h>
  66
  67 #define DEBUG_SUBSYSTEM S_LND
  68
  69 #include <libcfs/libcfs.h>
  70 #include <lnet/lnet.h>
  71 #include <lnet/lib-lnet.h>
  72 #include <lnet/lnet-sysctl.h>
  73
  74 #include <rapl.h>
  75
  76 /* tunables determined at compile time */
  77 #define RANAL_RESCHED             100           /* # scheduler loops before reschedule */
  78
  79 #define RANAL_PEER_HASH_SIZE      101           /* # peer lists */
  80 #define RANAL_CONN_HASH_SIZE      101           /* # conn lists */
  81
  82 #define RANAL_MIN_TIMEOUT         5             /* minimum timeout interval (seconds) */
  83 #define RANAL_TIMEOUT2KEEPALIVE(t) (((t)+1)/2)  /* timeout -> keepalive interval */
  84
  85 /* fixed constants */
  86 #define RANAL_MAXDEVS             2             /* max # devices RapidArray supports */
  87 #define RANAL_FMA_MAX_PREFIX      232           /* max bytes in FMA "Prefix" we can use */
  88 #define RANAL_FMA_MAX_DATA        ((7<<10)-256) /* Max FMA MSG is 7K including prefix */
  89
  90
  91 typedef struct
  92 {
  93         int              *kra_n_connd;          /* # connection daemons */
  94         int              *kra_min_reconnect_interval; /* first failed connection retry... */
  95         int              *kra_max_reconnect_interval; /* ...exponentially increasing to this */
  96         int              *kra_ntx;              /* # tx descs */
  97         int              *kra_credits;          /* # concurrent sends */
  98         int              *kra_peercredits;      /* # concurrent sends to 1 peer */
  99         int              *kra_fma_cq_size;      /* # entries in receive CQ */
 100         int              *kra_timeout;          /* comms timeout (seconds) */
 101         int              *kra_max_immediate;    /* immediate payload breakpoint */
 102
 103 #if CONFIG_SYSCTL && !CFS_SYSFS_MODULE_PARM
 104         cfs_sysctl_table_header_t *kra_sysctl;  /* sysctl interface */
 105 #endif
 106 } kra_tunables_t;
 107
 108 typedef struct
 109 {
 110         RAP_PVOID              rad_handle;    /* device handle */
 111         RAP_PVOID              rad_fma_cqh;   /* FMA completion queue handle */
 112         RAP_PVOID              rad_rdma_cqh;  /* rdma completion queue handle */
 113         int                    rad_id;        /* device id */
 114         int                    rad_idx;       /* index in kra_devices */
 115         int                    rad_ready;     /* set by device callback */
 116         cfs_list_t             rad_ready_conns;/* connections ready to tx/rx */
 117         cfs_list_t             rad_new_conns; /* new connections to complete */
 118         cfs_waitq_t            rad_waitq;     /* scheduler waits here */
 119         cfs_spinlock_t         rad_lock;      /* serialise */
 120         void                  *rad_scheduler; /* scheduling thread */
 121         unsigned int           rad_nphysmap;  /* # phys mappings */
 122         unsigned int           rad_nppphysmap;/* # phys pages mapped */
 123         unsigned int           rad_nvirtmap;  /* # virt mappings */
 124         unsigned long          rad_nobvirtmap;/* # virt bytes mapped */
 125 } kra_device_t;
 126
 127 typedef struct
 128 {
 129         int               kra_init;            /* initialisation state */
 130         int               kra_shutdown;        /* shut down? */
 131         cfs_atomic_t      kra_nthreads;        /* # live threads */
 132         lnet_ni_t        *kra_ni;              /* _the_ nal instance */
 133
 134         kra_device_t      kra_devices[RANAL_MAXDEVS]; /* device/ptag/cq */
 135         int               kra_ndevs;           /* # devices */
 136
 137         cfs_rwlock_t      kra_global_lock;     /* stabilize peer/conn ops */
 138
 139         cfs_list_t       *kra_peers;           /* hash table of all my known peers */
 140         int               kra_peer_hash_size;  /* size of kra_peers */
 141         cfs_atomic_t      kra_npeers;          /* # peers extant */
 142         int               kra_nonewpeers;      /* prevent new peers */
 143
 144         cfs_list_t       *kra_conns;           /* conns hashed by cqid */
 145         int               kra_conn_hash_size;  /* size of kra_conns */
 146         __u64             kra_peerstamp;       /* when I started up */
 147         __u64             kra_connstamp;       /* conn stamp generator */
 148         int               kra_next_cqid;       /* cqid generator */
 149         cfs_atomic_t      kra_nconns;          /* # connections extant */
 150
 151         long              kra_new_min_timeout; /* minimum timeout on any new conn */
 152         cfs_waitq_t       kra_reaper_waitq;    /* reaper sleeps here */
 153         cfs_spinlock_t    kra_reaper_lock;     /* serialise */
 154
 155         cfs_list_t        kra_connd_peers;     /* peers waiting for a connection */
 156         cfs_list_t        kra_connd_acceptq;   /* accepted sockets to handshake */
 157         cfs_waitq_t       kra_connd_waitq;     /* connection daemons sleep here */
 158         cfs_spinlock_t    kra_connd_lock;      /* serialise */
 159
 160         cfs_list_t        kra_idle_txs;        /* idle tx descriptors */
 161         __u64             kra_next_tx_cookie;  /* RDMA completion cookie */
 162         cfs_spinlock_t    kra_tx_lock;         /* serialise */
 163 } kra_data_t;
 164
 165 #define RANAL_INIT_NOTHING         0
 166 #define RANAL_INIT_DATA            1
 167 #define RANAL_INIT_ALL             2
 168
 169 typedef struct kra_acceptsock             /* accepted socket queued for connd */
 170 {
 171         cfs_list_t           ras_list;          /* queue for attention */
 172         struct socket       *ras_sock;          /* the accepted socket */
 173 } kra_acceptsock_t;
 174
 175 /************************************************************************
 176  * Wire message structs.  These are sent in sender's byte order
 177  * (i.e. receiver checks magic and flips if required).
 178  */
 179
 180 typedef struct kra_connreq                      /* connection request/response */
 181 {                                               /* (sent via socket) */
 182         __u32             racr_magic;           /* I'm an ranal connreq */
 183         __u16             racr_version;         /* this is my version number */
 184         __u16             racr_devid;           /* sender's device ID */
 185         __u64             racr_srcnid;          /* sender's NID */
 186         __u64             racr_dstnid;          /* who sender expects to listen */
 187         __u64             racr_peerstamp;       /* sender's instance stamp */
 188         __u64             racr_connstamp;       /* sender's connection stamp */
 189         __u32             racr_timeout;         /* sender's timeout */
 190         RAP_RI_PARAMETERS racr_riparams;        /* sender's endpoint info */
 191 } kra_connreq_t;
 192
 193 typedef struct
 194 {
 195         RAP_MEM_KEY       rard_key;
 196         RAP_PVOID64       rard_addr;
 197         RAP_UINT32        rard_nob;
 198 } kra_rdma_desc_t;
 199
 200 typedef struct
 201 {
 202         lnet_hdr_t        raim_hdr;             /* portals header */
 203         /* Portals payload is in FMA "Message Data" */
 204 } kra_immediate_msg_t;
 205
 206 typedef struct
 207 {
 208         lnet_hdr_t        raprm_hdr;            /* portals header */
 209         __u64             raprm_cookie;         /* opaque completion cookie */
 210 } kra_putreq_msg_t;
 211
 212 typedef struct
 213 {
 214         __u64             rapam_src_cookie;     /* reflected completion cookie */
 215         __u64             rapam_dst_cookie;     /* opaque completion cookie */
 216         kra_rdma_desc_t   rapam_desc;           /* sender's sink buffer */
 217 } kra_putack_msg_t;
 218
 219 typedef struct
 220 {
 221         lnet_hdr_t        ragm_hdr;             /* portals header */
 222         __u64             ragm_cookie;          /* opaque completion cookie */
 223         kra_rdma_desc_t   ragm_desc;            /* sender's sink buffer */
 224 } kra_get_msg_t;
 225
 226 typedef struct
 227 {
 228         __u64             racm_cookie;          /* reflected completion cookie */
 229 } kra_completion_msg_t;
 230
 231 typedef struct                                  /* NB must fit in FMA "Prefix" */
 232 {
 233         __u32             ram_magic;            /* I'm an ranal message */
 234         __u16             ram_version;          /* this is my version number */
 235         __u16             ram_type;             /* msg type */
 236         __u64             ram_srcnid;           /* sender's NID */
 237         __u64             ram_connstamp;        /* sender's connection stamp */
 238         union {
 239                 kra_immediate_msg_t   immediate;
 240                 kra_putreq_msg_t      putreq;
 241                 kra_putack_msg_t      putack;
 242                 kra_get_msg_t         get;
 243                 kra_completion_msg_t  completion;
 244         }                    ram_u;
 245         __u32             ram_seq;              /* incrementing sequence number */
 246 } kra_msg_t;
 247
 248 #define RANAL_MSG_MAGIC     LNET_PROTO_RA_MAGIC /* unique magic */
 249 #define RANAL_MSG_VERSION              1        /* current protocol version */
 250
 251 #define RANAL_MSG_FENCE             0x80        /* fence RDMA */
 252
 253 #define RANAL_MSG_NONE              0x00        /* illegal message */
 254 #define RANAL_MSG_NOOP              0x01        /* empty ram_u (keepalive) */
 255 #define RANAL_MSG_IMMEDIATE         0x02        /* ram_u.immediate */
 256 #define RANAL_MSG_PUT_REQ           0x03        /* ram_u.putreq (src->sink) */
 257 #define RANAL_MSG_PUT_NAK           0x04        /* ram_u.completion (no PUT match: sink->src) */
 258 #define RANAL_MSG_PUT_ACK           0x05        /* ram_u.putack (PUT matched: sink->src) */
 259 #define RANAL_MSG_PUT_DONE          0x86        /* ram_u.completion (src->sink) */
 260 #define RANAL_MSG_GET_REQ           0x07        /* ram_u.get (sink->src) */
 261 #define RANAL_MSG_GET_NAK           0x08        /* ram_u.completion (no GET match: src->sink) */
 262 #define RANAL_MSG_GET_DONE          0x89        /* ram_u.completion (src->sink) */
 263 #define RANAL_MSG_CLOSE             0x8a        /* empty ram_u */
 264
 265 /***********************************************************************/
 266
 267 typedef struct kra_tx                           /* message descriptor */
 268 {
 269         cfs_list_t            tx_list;      /* queue on idle_txs/rac_sendq/rac_waitq */
 270         struct kra_conn      *tx_conn;      /* owning conn */
 271         lnet_msg_t           *tx_lntmsg[2]; /* ptl msgs to finalize on completion */
 272         unsigned long         tx_qtime;     /* when tx started to wait for something (jiffies) */
 273         int                   tx_nob;       /* # bytes of payload */
 274         int                   tx_buftype;   /* payload buffer type */
 275         void                 *tx_buffer;    /* source/sink buffer */
 276         int                   tx_phys_offset; /* first page offset (if phys) */
 277         int                   tx_phys_npages; /* # physical pages */
 278         RAP_PHYS_REGION      *tx_phys;      /* page descriptors */
 279         RAP_MEM_KEY           tx_map_key;   /* mapping key */
 280         RAP_RDMA_DESCRIPTOR   tx_rdma_desc; /* rdma descriptor */
 281         __u64                 tx_cookie;    /* identify this tx to peer */
 282         kra_msg_t             tx_msg;       /* FMA message buffer */
 283 } kra_tx_t;
 284
 285 #define RANAL_BUF_NONE           0              /* buffer type not set */
 286 #define RANAL_BUF_IMMEDIATE      1              /* immediate data */
 287 #define RANAL_BUF_PHYS_UNMAPPED  2              /* physical: not mapped yet */
 288 #define RANAL_BUF_PHYS_MAPPED    3              /* physical: mapped already */
 289 #define RANAL_BUF_VIRT_UNMAPPED  4              /* virtual: not mapped yet */
 290 #define RANAL_BUF_VIRT_MAPPED    5              /* virtual: mapped already */
 291
 292 typedef struct kra_conn
 293 {
 294         struct kra_peer    *rac_peer;           /* owning peer */
 295         cfs_list_t          rac_list;          /* stash on peer's conn list */
 296         cfs_list_t          rac_hashlist;      /* stash in connection hash table */
 297         cfs_list_t          rac_schedlist;     /* schedule (on rad_???_conns) for attention */
 298         cfs_list_t          rac_fmaq;          /* txs queued for FMA */
 299         cfs_list_t          rac_rdmaq;         /* txs awaiting RDMA completion */
 300         cfs_list_t          rac_replyq;        /* txs awaiting replies */
 301         __u64               rac_peerstamp;     /* peer's unique stamp */
 302         __u64               rac_peer_connstamp;/* peer's unique connection stamp */
 303         __u64               rac_my_connstamp;  /* my unique connection stamp */
 304         unsigned long       rac_last_tx;       /* when I last sent an FMA message (jiffies) */
 305         unsigned long       rac_last_rx;       /* when I last received an FMA messages (jiffies) */
 306         long                rac_keepalive;     /* keepalive interval (seconds) */
 307         long                rac_timeout;       /* infer peer death if no rx for this many seconds */
 308         __u32               rac_cqid;          /* my completion callback id (non-unique) */
 309         __u32               rac_tx_seq;        /* tx msg sequence number */
 310         __u32               rac_rx_seq;        /* rx msg sequence number */
 311         cfs_atomic_t        rac_refcount;      /* # users */
 312         unsigned int        rac_close_sent;    /* I've sent CLOSE */
 313         unsigned int        rac_close_recvd;   /* I've received CLOSE */
 314         unsigned int        rac_state;         /* connection state */
 315         unsigned int        rac_scheduled;     /* being attented to */
 316         cfs_spinlock_t      rac_lock;          /* serialise */
 317         kra_device_t       *rac_device;        /* which device */
 318         RAP_PVOID           rac_rihandle;      /* RA endpoint */
 319         kra_msg_t          *rac_rxmsg;         /* incoming message (FMA prefix) */
 320         kra_msg_t           rac_msg;           /* keepalive/CLOSE message buffer */
 321 } kra_conn_t;
 322
 323 #define RANAL_CONN_ESTABLISHED     0
 324 #define RANAL_CONN_CLOSING         1
 325 #define RANAL_CONN_CLOSED          2
 326
 327 typedef struct kra_peer
 328 {
 329         cfs_list_t          rap_list;         /* stash on global peer list */
 330         cfs_list_t          rap_connd_list;   /* schedule on kra_connd_peers */
 331         cfs_list_t          rap_conns;        /* all active connections */
 332         cfs_list_t          rap_tx_queue;     /* msgs waiting for a conn */
 333         lnet_nid_t          rap_nid;          /* who's on the other end(s) */
 334         __u32               rap_ip;           /* IP address of peer */
 335         int                 rap_port;         /* port on which peer listens */
 336         cfs_atomic_t        rap_refcount;     /* # users */
 337         int                 rap_persistence;  /* "known" peer refs */
 338         int                 rap_connecting;   /* connection forming */
 339         unsigned long       rap_reconnect_time; /* CURRENT_SECONDS when reconnect OK */
 340         unsigned long       rap_reconnect_interval; /* exponential backoff */
 341 } kra_peer_t;
 342
 343 extern kra_data_t      kranal_data;
 344 extern kra_tunables_t  kranal_tunables;
 345
 346 extern void kranal_destroy_peer(kra_peer_t *peer);
 347 extern void kranal_destroy_conn(kra_conn_t *conn);
 348
 349 static inline void
 350 kranal_peer_addref(kra_peer_t *peer)
 351 {
 352         CDEBUG(D_NET, "%p->%s\n", peer, libcfs_nid2str(peer->rap_nid));
 353         LASSERT(cfs_atomic_read(&peer->rap_refcount) > 0);
 354         cfs_atomic_inc(&peer->rap_refcount);
 355 }
 356
 357 static inline void
 358 kranal_peer_decref(kra_peer_t *peer)
 359 {
 360         CDEBUG(D_NET, "%p->%s\n", peer, libcfs_nid2str(peer->rap_nid));
 361         LASSERT(cfs_atomic_read(&peer->rap_refcount) > 0);
 362         if (cfs_atomic_dec_and_test(&peer->rap_refcount))
 363                 kranal_destroy_peer(peer);
 364 }
 365
 366 static inline cfs_list_t *
 367 kranal_nid2peerlist (lnet_nid_t nid)
 368 {
 369         unsigned int hash = ((unsigned int)nid) % kranal_data.kra_peer_hash_size;
 370
 371         return (&kranal_data.kra_peers[hash]);
 372 }
 373
 374 static inline int
 375 kranal_peer_active(kra_peer_t *peer)
 376 {
 377         /* Am I in the peer hash table? */
 378         return (!cfs_list_empty(&peer->rap_list));
 379 }
 380
 381 static inline void
 382 kranal_conn_addref(kra_conn_t *conn)
 383 {
 384         CDEBUG(D_NET, "%p->%s\n", conn,
 385                libcfs_nid2str(conn->rac_peer->rap_nid));
 386         LASSERT(cfs_atomic_read(&conn->rac_refcount) > 0);
 387         cfs_atomic_inc(&conn->rac_refcount);
 388 }
 389
 390 static inline void
 391 kranal_conn_decref(kra_conn_t *conn)
 392 {
 393         CDEBUG(D_NET, "%p->%s\n", conn,
 394                libcfs_nid2str(conn->rac_peer->rap_nid));
 395         LASSERT(cfs_atomic_read(&conn->rac_refcount) > 0);
 396         if (cfs_atomic_dec_and_test(&conn->rac_refcount))
 397                 kranal_destroy_conn(conn);
 398 }
 399
 400 static inline cfs_list_t *
 401 kranal_cqid2connlist (__u32 cqid)
 402 {
 403         unsigned int hash = cqid % kranal_data.kra_conn_hash_size;
 404
 405         return (&kranal_data.kra_conns [hash]);
 406 }
 407
 408 static inline kra_conn_t *
 409 kranal_cqid2conn_locked (__u32 cqid)
 410 {
 411         cfs_list_t       *conns = kranal_cqid2connlist(cqid);
 412         cfs_list_t       *tmp;
 413         kra_conn_t       *conn;
 414
 415         cfs_list_for_each(tmp, conns) {
 416                 conn = cfs_list_entry(tmp, kra_conn_t, rac_hashlist);
 417
 418                 if (conn->rac_cqid == cqid)
 419                         return conn;
 420         }
 421
 422         return NULL;
 423 }
 424
 425 static inline int
 426 kranal_tx_mapped (kra_tx_t *tx)
 427 {
 428         return (tx->tx_buftype == RANAL_BUF_VIRT_MAPPED ||
 429                 tx->tx_buftype == RANAL_BUF_PHYS_MAPPED);
 430 }
 431
 432 int kranal_startup (lnet_ni_t *ni);
 433 void kranal_shutdown (lnet_ni_t *ni);
 434 int kranal_ctl(lnet_ni_t *ni, unsigned int cmd, void *arg);
 435 int kranal_send (lnet_ni_t *ni, void *private, lnet_msg_t *lntmsg);
 436 int kranal_eager_recv(lnet_ni_t *ni, void *private,
 437                       lnet_msg_t *lntmsg, void **new_private);
 438 int kranal_recv(lnet_ni_t *ni, void *private, lnet_msg_t *lntmsg,
 439                 int delayed, unsigned int niov,
 440                 struct iovec *iov, lnet_kiov_t *kiov,
 441                 unsigned int offset, unsigned int mlen, unsigned int rlen);
 442 int kranal_accept(lnet_ni_t *ni, struct socket *sock);
 443
 444 extern void kranal_free_acceptsock (kra_acceptsock_t *ras);
 445 extern int kranal_listener_procint (cfs_sysctl_table_t *table,
 446                                     int write, struct file *filp,
 447                                     void *buffer, size_t *lenp);
 448 extern void kranal_update_reaper_timeout (long timeout);
 449 extern void kranal_tx_done (kra_tx_t *tx, int completion);
 450 extern void kranal_unlink_peer_locked (kra_peer_t *peer);
 451 extern void kranal_schedule_conn (kra_conn_t *conn);
 452 extern int kranal_create_peer (kra_peer_t **peerp, lnet_nid_t nid);
 453 extern int kranal_add_persistent_peer (lnet_nid_t nid, __u32 ip, int port);
 454 extern kra_peer_t *kranal_find_peer_locked (lnet_nid_t nid);
 455 extern void kranal_post_fma (kra_conn_t *conn, kra_tx_t *tx);
 456 extern int kranal_del_peer (lnet_nid_t nid);
 457 extern void kranal_device_callback (RAP_INT32 devid, RAP_PVOID arg);
 458 extern int kranal_thread_start (int(*fn)(void *arg), void *arg);
 459 extern int kranal_connd (void *arg);
 460 extern int kranal_reaper (void *arg);
 461 extern int kranal_scheduler (void *arg);
 462 extern void kranal_close_conn_locked (kra_conn_t *conn, int error);
 463 extern void kranal_close_conn (kra_conn_t *conn, int error);
 464 extern void kranal_terminate_conn_locked (kra_conn_t *conn);
 465 extern void kranal_connect (kra_peer_t *peer);
 466 extern int kranal_conn_handshake (struct socket *sock, kra_peer_t *peer);
 467 extern int kranal_tunables_init(void);
 468 extern void kranal_tunables_fini(void);
 469 extern void kranal_init_msg(kra_msg_t *msg, int type);