]> git.openfabrics.org - ~shefty/ibacm.git/commitdiff
Add the ability to preload the destination GID and LID caches
authorHal Rosenstock <hal@mellanox.com>
Thu, 27 Jun 2013 13:48:24 +0000 (16:48 +0300)
committerSean Hefty <sean.hefty@intel.com>
Fri, 28 Jun 2013 17:13:34 +0000 (10:13 -0700)
Preloading of these caches is supported via a file which is
produced by OpenSM by the dump_pr plugin which contains
sufficient SA PathRecord information. Details on this
file format and configuring OpenSM for this are found in
dump_pr_notes.txt in dump_pr.

File format is specified in ibacm_opts.cfg as follows:
path_rec_fmt full_opensm_v1

File format defaults to none which means no preload of ACM cache.

Signed-off-by: Hal Rosenstock <hal@mellanox.com>
Signed-off-by: Sean Hefty <sean.hefty@intel.com>
linux/osd.h
man/ibacm.1
src/acm.c
src/acme.c

index c8278aa175ccb80723aa90fb47586c6bd49b7d76..fe61c0c2a640164dfeeb368cbf0a4e7c38a9760d 100644 (file)
@@ -1,8 +1,9 @@
-/*\r
- * Copyright (c) 2009 Intel Corporation.  All rights reserved.\r
- *\r
- * This software is available to you under the OpenFabrics.org BSD license\r
- * below:\r
+/*
+ * Copyright (c) 2009 Intel Corporation.  All rights reserved.
+ * Copyright (c) 2013 Mellanox Technologies LTD. All rights reserved.
+ *
+ * This software is available to you under the OpenFabrics.org BSD license
+ * below:
  *\r
  *     Redistribution and use in source and binary forms, with or\r
  *     without modification, are permitted provided that the following\r
 #ifndef RDMADIR\r
 #define RDMADIR "rdma"\r
 #endif\r
-#define ACM_CONF_DIR  SYSCONFDIR "/" RDMADIR\r
-#define ACM_ADDR_FILE "ibacm_addr.cfg"\r
-#define ACM_OPTS_FILE "ibacm_opts.cfg"\r
-\r
-#define LIB_DESTRUCTOR __attribute__((destructor))\r
-#define CDECL_FUNC\r
+#define ACM_CONF_DIR  SYSCONFDIR "/" RDMADIR
+#define ACM_ADDR_FILE "ibacm_addr.cfg"
+#define ACM_OPTS_FILE "ibacm_opts.cfg"
+
+#define LIB_DESTRUCTOR __attribute__((destructor))
+#define CDECL_FUNC
 \r
 #define container_of(ptr, type, field) \\r
        ((type *) ((void *) ptr - offsetof(type, field)))\r
index 35b79c6646b40d5f06cf90921f1fa196d160dbbf..9df6062be1c8b2577d3027deedaad8e474e847db 100644 (file)
@@ -1,4 +1,4 @@
-.TH "ibacm" 1 "2013-06-15" "ibacm" "ibacm" ibacm
+.TH "ibacm" 1 "2013-06-18" "ibacm" "ibacm" ibacm
 .SH NAME
 ibacm \- address and route resolution services for InfiniBand.
 .SH SYNOPSIS
@@ -145,5 +145,16 @@ request is received from a different QPN than a cached request.
 limited to 4.
 .P
 - The number of multicast groups that an endpoint can support is limited to 2.
+.P
+The ibacm contains several internal caches.  These include caches for GID
+and LID destination addresses.  These caches can be optionally
+preloaded. ibacm supports the OpenSM dump_pr plugin "full" PathRecord
+format which is used to preload these caches.
+The file format is specified in the ibacm_opts.cfg file via the
+path_rec_fmt parameter which should be set to full_opensm_v1 for this file
+format.  Default is none which does not preload these caches.
+See dump_pr.notes.txt in dump_pr for more information on the
+full_opensm_v1 file format and how to configure OpenSM to
+generate this file.
 .SH "SEE ALSO"
 ibacm(7), ib_acme(1), rdma_cm(7)
index e956b09e5b0a454127d19ed77d463622e275c1c7..d37056cdb90b581ed5e2051473f8749502f07eeb 100644 (file)
--- a/src/acm.c
+++ b/src/acm.c
@@ -1,5 +1,6 @@
 /*
  * Copyright (c) 2009-2012 Intel Corporation. All rights reserved.
+ * Copyright (c) 2013 Mellanox Technologies LTD. All rights reserved.
  *
  * This software is available to you under the OpenIB.org BSD license
  * below:
@@ -49,6 +50,8 @@
 
 #define src_out     data[0]
 
+#define IB_LID_MCAST_START 0xc000
+
 #define MAX_EP_ADDR 4
 #define MAX_EP_MC   2
 
@@ -74,6 +77,11 @@ enum acm_loopback_prot {
        ACM_LOOPBACK_PROT_LOCAL
 };
 
+enum acm_route_preload {
+       ACM_ROUTE_PRELOAD_NONE,
+       ACM_ROUTE_PRELOAD_OSM_FULL_V1
+};
+
 /*
  * Nested locking order: dest -> ep, dest -> port
  */
@@ -205,11 +213,12 @@ PER_THREAD char log_data[ACM_MAX_ADDRESS];
 static atomic_t counter[ACM_MAX_COUNTER];
 
 /*
- * Service options - may be set through acm_opts file.
+ * Service options - may be set through ibacm_opts.cfg file.
  */
 static char *acme = BINDIR "/ib_acme -A";
 static char *opts_file = ACM_CONF_DIR "/" ACM_OPTS_FILE;
 static char *addr_file = ACM_CONF_DIR "/" ACM_ADDR_FILE;
+static char route_data_file[128] = ACM_CONF_DIR "/ibacm_route.data";
 static char log_file[128] = "/var/log/ibacm.log";
 static int log_level = 0;
 static char lock_file[128] = "/var/run/ibacm.pid";
@@ -227,6 +236,7 @@ static int send_depth = 1;
 static int recv_depth = 1024;
 static uint8_t min_mtu = IBV_MTU_2048;
 static uint8_t min_rate = IBV_RATE_10_GBPS;
+static enum acm_route_preload route_preload;
 
 #define acm_log(level, format, ...) \
        acm_write(level, "%s: "format, __func__, ## __VA_ARGS__)
@@ -2444,6 +2454,16 @@ static enum acm_loopback_prot acm_convert_loopback_prot(char *param)
        return loopback_prot;
 }
 
+static enum acm_route_preload acm_convert_route_preload(char *param)
+{
+       if (!stricmp("none", param) || !stricmp("no", param))
+               return ACM_ROUTE_PRELOAD_NONE;
+       else if (!stricmp("opensm_full_v1", param))
+               return ACM_ROUTE_PRELOAD_OSM_FULL_V1;
+
+       return route_preload;
+}
+
 static enum ibv_rate acm_get_rate(uint8_t width, uint8_t speed)
 {
        switch (width) {
@@ -2553,6 +2573,221 @@ static FILE *acm_open_addr_file(void)
        return fopen(addr_file, "r");
 }
 
+/* Parse "opensm full v1" file to build LID to GUID table */
+static void acm_parse_osm_fullv1_lid2guid(FILE *f, uint64_t *lid2guid)
+{
+       char s[128];
+       char *p, *ptr, *p_guid, *p_lid;
+       uint64_t guid;
+       uint16_t lid;
+
+       while (fgets(s, sizeof s, f)) {
+               if (s[0] == '#')
+                       continue;
+               if (!(p = strtok_r(s, " \n", &ptr)))
+                       continue;       /* ignore blank lines */
+
+               if (strncmp(p, "Switch", sizeof("Switch") - 1) &&
+                   strncmp(p, "Channel", sizeof("Channel") - 1) &&
+                   strncmp(p, "Router", sizeof("Router") - 1))
+                       continue;
+
+               if (!strncmp(p, "Channel", sizeof("Channel") - 1)) {
+                       p = strtok_r(NULL, " ", &ptr); /* skip 'Adapter' */
+                       if (!p)
+                               continue;
+               }
+
+               p_guid = strtok_r(NULL, ",", &ptr);
+               if (!p_guid)
+                       continue;
+
+               guid = (uint64_t) strtoull(p_guid, NULL, 16);
+
+               ptr = strstr(ptr, "base LID");
+               if (!ptr)
+                       continue;
+               ptr += sizeof("base LID");
+               p_lid = strtok_r(NULL, ",", &ptr);
+               if (!p_lid)
+                       continue;
+
+               lid = (uint16_t) strtoul(p_lid, NULL, 0);
+               if (lid >= IB_LID_MCAST_START)
+                       continue;
+               if (lid2guid[lid])
+                       acm_log(0, "ERROR - duplicate lid %u\n", lid);
+               else
+                       lid2guid[lid] = htonll(guid);
+       }
+}
+
+/* Parse 'opensm full v1' file to populate PR cache */
+static int acm_parse_osm_fullv1_paths(FILE *f, uint64_t *lid2guid, struct acm_ep *ep)
+{
+       union ibv_gid sgid, dgid;
+       struct ibv_port_attr attr = { 0 };
+       struct acm_dest *dest;
+       char s[128];
+       char *p, *ptr, *p_guid, *p_lid;
+       uint64_t guid;
+       uint16_t lid, dlid;
+       int sl, mtu, rate;
+       int ret = 1, i;
+       uint8_t addr[ACM_MAX_ADDRESS];
+       uint8_t addr_type;
+
+       ibv_query_gid(ep->port->dev->verbs, ep->port->port_num, 0, &sgid);
+
+       /* Search for endpoint's SLID */
+       while (fgets(s, sizeof s, f)) {
+               if (s[0] == '#')
+                       continue;
+               if (!(p = strtok_r(s, " \n", &ptr)))
+                       continue;       /* ignore blank lines */
+
+               if (strncmp(p, "Switch", sizeof("Switch") - 1) &&
+                   strncmp(p, "Channel", sizeof("Channel") - 1) &&
+                   strncmp(p, "Router", sizeof("Router") - 1))
+                       continue;
+
+               if (!strncmp(p, "Channel", sizeof("Channel") - 1)) {
+                       p = strtok_r(NULL, " ", &ptr); /* skip 'Adapter' */
+                       if (!p)
+                               continue;
+               }
+
+               p_guid = strtok_r(NULL, ",", &ptr);
+               if (!p_guid)
+                       continue;
+
+               guid = (uint64_t) strtoull(p_guid, NULL, 16);
+               if (guid != ntohll(sgid.global.interface_id))
+                       continue;
+
+               ptr = strstr(ptr, "base LID");
+               if (!ptr)
+                       continue;
+               ptr += sizeof("base LID");
+               p_lid = strtok_r(NULL, ",", &ptr);
+               if (!p_lid)
+                       continue;
+
+               lid = (uint16_t) strtoul(p_lid, NULL, 0);
+               if (lid != ep->port->lid)
+                       continue;
+
+               ibv_query_port(ep->port->dev->verbs, ep->port->port_num, &attr);
+               ret = 0;
+               break;
+       }
+
+       while (fgets(s, sizeof s, f)) {
+               if (s[0] == '#')
+                       continue;
+               if (!(p = strtok_r(s, " \n", &ptr)))
+                       continue;       /* ignore blank lines */
+
+               if (!strncmp(p, "Switch", sizeof("Switch") - 1) ||
+                   !strncmp(p, "Channel", sizeof("Channel") - 1) ||
+                   !strncmp(p, "Router", sizeof("Router") - 1))
+                       break;
+
+               dlid = strtoul(p, NULL, 0);
+
+               p = strtok_r(NULL, ":", &ptr);
+               if (!p)
+                       continue;
+               if (strcmp(p, "UNREACHABLE") == 0)
+                       continue;
+               sl = atoi(p);
+
+               p = strtok_r(NULL, ":", &ptr);
+               if (!p)
+                       continue;
+               mtu = atoi(p);
+
+               p = strtok_r(NULL, ":", &ptr);
+               if (!p)
+                       continue;
+               rate = atoi(p);
+
+               if (!lid2guid[dlid]) {
+                       acm_log(0, "ERROR - dlid %u not found in lid2guid table\n", dlid);
+                       continue;
+               }
+
+               dgid.global.subnet_prefix = sgid.global.subnet_prefix;
+               dgid.global.interface_id = lid2guid[dlid];
+
+               for (i = 0; i < 2; i++) {
+                       memset(addr, 0, ACM_MAX_ADDRESS);
+                       if (i == 0) {
+                               addr_type = ACM_ADDRESS_LID;
+                               *((uint16_t *) addr) = htons(dlid);
+                       } else {
+                               addr_type = ACM_ADDRESS_GID;
+                               memcpy(addr, &dgid, sizeof(dgid));
+                       }
+                       dest = acm_acquire_dest(ep, addr_type, addr);
+                       if (!dest) {
+                               acm_log(0, "ERROR - unable to create dest\n");
+                               break;
+                       }
+
+                       dest->path.sgid = sgid;
+                       dest->path.slid = htons(ep->port->lid);
+                       dest->path.dgid = dgid;
+                       dest->path.dlid = htons(dlid);
+                       dest->path.reversible_numpath = IBV_PATH_RECORD_REVERSIBLE;
+                       dest->path.pkey = htons(ep->pkey);
+                       dest->path.mtu = (uint8_t) mtu;
+                       dest->path.rate = (uint8_t) rate;
+                       dest->path.qosclass_sl = htons((uint16_t) sl & 0xF);
+                       if (dlid == ep->port->lid) {
+                               dest->path.packetlifetime = 0;
+                               dest->addr_timeout = (uint64_t)~0ULL;
+                               dest->route_timeout = (uint64_t)~0ULL;
+                       } else {
+                               dest->path.packetlifetime = attr.subnet_timeout;
+                               dest->addr_timeout = time_stamp_min() + (unsigned) addr_timeout;
+                               dest->route_timeout = time_stamp_min() + (unsigned) route_timeout;
+                       }
+                       dest->remote_qpn = 1;
+                       dest->state = ACM_READY;
+                       acm_put_dest(dest);
+                       acm_log(1, "added cached dest %s\n", dest->name);
+               }
+       }
+       return ret;
+}
+
+static int acm_parse_osm_fullv1(struct acm_ep *ep)
+{
+       FILE *f;
+       uint64_t *lid2guid;
+       int ret = 1;
+
+       if (!(f = fopen(route_data_file, "r"))) {
+               acm_log(0, "ERROR - couldn't open %s\n", route_data_file);
+               return ret;
+       }
+
+       lid2guid = calloc(IB_LID_MCAST_START, sizeof(*lid2guid));
+       if (!lid2guid) {
+               acm_log(0, "ERROR - no memory for path record parsing\n");
+               goto err;
+       }
+
+       acm_parse_osm_fullv1_lid2guid(f, lid2guid);
+       rewind(f);
+       ret = acm_parse_osm_fullv1_paths(f, lid2guid, ep);
+       free(lid2guid);
+err:
+       fclose(f);
+       return ret;
+}
+
 static int acm_assign_ep_names(struct acm_ep *ep)
 {
        FILE *faddr;
@@ -2621,6 +2856,18 @@ static int acm_assign_ep_names(struct acm_ep *ep)
        return !index;
 }
 
+static void acm_ep_preload(struct acm_ep *ep)
+{
+       switch (route_preload) {
+       case ACM_ROUTE_PRELOAD_OSM_FULL_V1:
+               if (acm_parse_osm_fullv1(ep))
+                       acm_log(0, "ERROR - failed to preload EP\n");
+               break;
+       default:
+               break;
+       }
+}
+
 static int acm_init_ep_loopback(struct acm_ep *ep)
 {
        struct acm_dest *dest;
@@ -2802,6 +3049,7 @@ static void acm_ep_up(struct acm_port *port, uint16_t pkey_index)
        lock_acquire(&port->lock);
        DListInsertHead(&ep->entry, &port->ep_list);
        lock_release(&port->lock);
+       acm_ep_preload(ep);
        return;
 
 err2:
@@ -3114,6 +3362,10 @@ static void acm_set_options(void)
                        min_mtu = acm_convert_mtu(atoi(value));
                else if (!stricmp("min_rate", opt))
                        min_rate = acm_convert_rate(atoi(value));
+               else if (!stricmp("route_preload", opt))
+                       route_preload = acm_convert_route_preload(value);
+               else if (!stricmp("route_data_file", opt))
+                       strcpy(route_data_file, value);
        }
 
        fclose(f);
@@ -3137,6 +3389,8 @@ static void acm_log_options(void)
        acm_log(0, "receive depth %d\n", recv_depth);
        acm_log(0, "minimum mtu %d\n", min_mtu);
        acm_log(0, "minimum rate %d\n", min_rate);
+       acm_log(0, "route preload %d\n", route_preload);
+       acm_log(0, "route data file %s\n", route_data_file);
 }
 
 static FILE *acm_open_log(void)
@@ -3200,9 +3454,9 @@ static void show_usage(char *program)
        printf("   [-D]             - run as a daemon (default)\n");
        printf("   [-P]             - run as a standard process\n");
        printf("   [-A addr_file]   - address configuration file\n");
-       printf("                      (default %s/%s\n", ACM_CONF_DIR, ACM_ADDR_FILE);
+       printf("                      (default %s/%s)\n", ACM_CONF_DIR, ACM_ADDR_FILE);
        printf("   [-O option_file] - option configuration file\n");
-       printf("                      (default %s/%s\n", ACM_CONF_DIR, ACM_OPTS_FILE);
+       printf("                      (default %s/%s)\n", ACM_CONF_DIR, ACM_OPTS_FILE);
 }
 
 int CDECL_FUNC main(int argc, char **argv)
index 1abb644cb5096fdd13098fb80e858e961b7d0d71..a95260ae33ddb3e9a45ba31a5393f32ed260a909 100644 (file)
@@ -244,6 +244,22 @@ static void gen_opts_temp(FILE *f)
        fprintf(f, "\n");
        fprintf(f, "min_rate 10\n");
        fprintf(f, "\n");
+       fprintf(f, "# route_preload:\n");
+       fprintf(f, "# Specifies if the ACM routing cache should be preloaded, or built on demand.\n");
+       fprintf(f, "# If preloaded, indicates the method used to build the cache.\n");
+       fprintf(f, "# Supported preload values are:\n");
+       fprintf(f, "# none - The routing cache is not pre-built (default)\n");
+       fprintf(f, "# opensm_full_v1 - OpenSM 'full' path records dump file format (version 1)\n");
+       fprintf(f, "\n");
+       fprintf(f, "route_preload none\n");
+       fprintf(f, "\n");
+       fprintf(f, "# route_data_file:\n");
+       fprintf(f, "# Specifies the location of the route data file to use when preloading\n");
+       fprintf(f, "# the ACM cache.  This option is only valid if route_preload\n");
+       fprintf(f, "# indicates that routing data should be read from a file.\n");
+       fprintf(f, "# Default is ACM_CONF_DIR/ibacm_route.data\n");
+       fprintf(f, "# route_data_file /etc/rdma/ibacm_route.data\n");
+       fprintf(f, "\n");
 }
 
 static int open_dir(void)